WebLogic Server for OCI 移行の手順

Transcript

1. WebLogic Server for OCI 移行の手順 WebLogic Deploy Toolingを用いたドメイン/アプリケーションの移行 日本オラクル株式会社 2023年2月
2. • 本資料では移行プロセスにおけるアプリケーションの再デプロイを解説 • セットアップとプロビジョニングは「WebLogic Server for OCIの汎用的な構成」資料にて解説 WebLogic Server for OCI 移行の大まかなプロセス Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 2 環境のセットアップ • コンパートメント • OCI Vault (Secret) • Network (VCN, Subnet) • Vault, Secret WebLogic Server for OCIのプロビジョニング • マーケットプレイス経 由でのプロビジョニン グ • 監視/管理の構成 アプリケーション移行 • 移行元からリソース を抽出 • WebLogic Server for OCIのドメインを 更新 本資料で主に解説
3. 移行に際しての留意点 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 3 移行元の管理サーバー/管理対象サーバー ⇒ 起動中/停止中に関わらず移行可能 移行先の管理サーバー/管理対象サーバー ⇒ 管理サーバーは起動中であることが必要 データベース ⇒ 起動中/停止中に関わらず移行可能
4. 移行フェーズ パラメータ 補足/注意点 環境のセットアップ WebLogicの管理パスワード OCI Vault で管理 プロビジョニング バージョン ノード数 管理サーバは1つ目のノードに配置 管理/管理対象サーバー名 <prefix>_adminserver <prefix>_server_<id> のように固定 ※<id>はノード数に応じて1, 2, 3 …のように連番 エディション リソース名プレフィクス ドメイン名は<prefix>_domain固定 WebLogic管理ユーザ名 アプリケーション移行 データベースのパスワード WebLogic Server for OCI 移行にまつわる主なパラメータ Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 4
5. 1. WDTを移行元ドメインにインストール 2. discoverDomainによるドメイン情報/リソースの抽出 3. 移行先ドメインにドメイン情報/リソースを移動 4. WDTを移行先ドメインにインストール 5. updateDomainの実行 WebLogic Deploy Toolingを用いた移行WebLogic Server for OCIへの移行 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 5 Source WebLogic Domain cluster JDBC #1 App #1 App #2 JDBC #1 source.properties source.zip source.yaml Discover Domain Target WebLogic Domain cluster MS1 AS MS2 JDBC #1 App #1 App #2 JDBC #1 WDT 既存のWebLogicドメイン 反映先のWebLogicドメイン MS1 AS MS2 Update Domain WDT 編集
6. 1. WDTの最新バージョンを確認 1. https://github.com/oracle/weblogic-deploy-tooling/releases/ 2. JAVA_HOMEが設定されているかを確認 3. WDTのダウンロードとunzip 4. スクリプトの権限変更 1. WDTを移行元のドメインにインストール Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 6 echo $JAVA_HOME wget -qO- https://github.com/oracle/weblogic-deploy- tooling/releases/download/release-<バージョン>/weblogic- deploy.zip | $JAVA_HOME/bin/jar xv chmod +x weblogic-deploy/bin/*.sh
7. 1. MW_HOMEディレクトリの設定(例: /u01/app/oracle/middleware) 2. DOMAIN_HOMEディレクトリの設定 3. DOMAIN_TYPEの設定 4. discoverDomainの実行 2. 移行元でdiscoverDomainコマンドの実行 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 7 MW_HOME=<MW_HOME> DOMAIN_HOME=<DOMAIN_HOME> DOMAIN_TYPE=<WLS/JRF> weblogic-deploy/bin/discoverDomain.sh ¥ -oracle_home $MW_HOME ¥ -domain_home $DOMAIN_HOME ¥ -archive_file source.zip ¥ -model_file source.yaml ¥ -variable_file source.properties ¥ -domain_type $DOMAIN_TYPE ▪ discoverDomainによる成果物 • source.zip • wlsdeploy/applications/<app-name>.war のようなディレクトリ構造 • source.yaml • ドメインのメタデータ • source.properties • source.yamlで利用する変数を記載 • 環境変数やパスワードなどに利用
8. source.properties, source.yaml, source.zipを移行先のサーバに移動する 推奨: WDTのインストールに用いたzipファイル(weblogic-deply.zip)も同時に移動 例) 以下はscpコマンドを利用する例 1. 移行元IPの指定 2. 移行先IPの指定 3. 踏台サーバIPの指定 4. scpコマンドの実行 3. 移行先の管理サーバへファイルを転送 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 8 SOURCE_IP=<移行元WLSサーバのIP> ADMIN_SERVER_IP=<OCI上の管理サーバIP> BASTION_IP=<OCI上の踏み台サーバIP> scp -o “ProxyCommand ssh -i <踏台サーバ秘密鍵のパス> opc@$BASTION_IP -W %h:%p" <移行元ユーザ >@${SOURCE_IP}:~/source.* opc@${ADMIN_SERVER_IP}:~/
9. • source.propertiesのJDBC.<データソース名>.PasswordEncryptedに データベースのパスワードを入力 • source.propertiesのJDBC.<データソース名>.user.valueにデータベースの ユーザ名を入力(変更が必要な場合) ※source.yaml内で利用しないので、ほかのフィールドは空白で良い 4. WDTモデルファイル(source.properties)の編集 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 9
10. resoucesとappDeploymentsフィールドのみを残す 1. domainInfoフィールドの全体を削除 2. topologyフィールドの全体を削除 ※ appDeploymentsのSourcePathはdicoverDomain時に 取得したsource.zip内のディレクトリ構造と同一 5. WDTモデルファイル(source.yaml)の編集 – resourcesとappDeployment Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 10 削除
11. t3sチャネルを新規作成する例 topologyフィールドを利用して、ネットワークチャネルなどの設定を行 うことができる 例えばt3sチャネルを追加する場合、キャプチャのように • 移行先管理サーバー名 • t3s通信に利用するポート • 移行先管理サーバーの内部FQDNアドレス • 移行先管理サーバーのIP(Privateでも可) を入力することで、新規チャネルを追加することができる 参考) topologyフィールドの活用 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 11
12. キャプチャの位置にStagingMode: stageの追加 ※これを追加しない場合、移行アプリケーションをサーバーそれぞれに 手動でデプロイを行う必要がある 6. WDTモデルファイルの編集 – StagingModeフィールドの追加 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 12
13. 移行先のWebLogicエディションに合わせTargetを編集 • Enterprise Edition • クラスター名を記述 • 例) <ドメイン接頭辞>_cluster • Standard Edition • 管理対象サーバー名を「,」で繋いで記述 • 例) “<ドメイン接頭辞>_server_0,<ドメイン接頭辞>_1” • 「”」もしくは「’」で囲う 7. WDTモデルファイルの編集 – Targetの編集 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 13
14. DBCS 接続先DBのURL / ユーザー名 / パスワードは必要に応 じて変更 ※@@PROP:<プロパティのキー>@@の形式で、propertiesファイル内の変数 を利用できる ATP • URLはDBCSの場合と異なり接続文字列に • Walletの配置先パスなど、Propertiesの値を必要に 応じて変更 8. WDTモデルファイル(source.yaml)の編集 – resources(JDBC) Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 14
15. resoucesフィールド以下にはSelfTunigフィールドとしてワークマネー ジャの情報が記載されている ターゲットのクラスタ名など、適宜移行先の環境に合わせて修正する 参考: ワーク・マネージャーの移行 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 15
16. 1. 移行先の管理サーバに接続 2. 所有者の変更 3. リソースの移動 4. oracleユーザにスイッチ 9. 移行リソースの所有者変更 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 16 sudo mv source.* /home/oracle/ sudo su - oracle sudo chown oracle:oracle source.*
17. ※「2. 移行元でdiscoverDomainコマンドの実行」 と同様の手順 ※「3. 移行先の管理サーバへファイルを転送」にてweblogic-deploy.zipも含めてファイルを移行した場合、unzipした後 に以下 3. の手順を行えばよい 1. JAVA_HOMEが設定されているかを確認 2. WDTのダウンロードとunzip 3. スクリプトの権限変更 10. 移行先の管理サーバにWDTをインストール Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 17 echo $JAVA_HOME wget -qO- https://github.com/oracle/weblogic-deploy- tooling/releases/download/release-<バージョン>/weblogic- deploy.zip | $JAVA_HOME/bin/jar xv chmod +x weblogic-deploy/bin/*.sh
18. 1. 環境変数の確認 2. updateDomainの実行 3. (任意) topologyセクションに変更を加える場合のみ再起動(restartDomainもしくはstop/startWebLogicの実行) が必要 11. updateDomain の実行 Copyright © 2023, Oracle and/or its affiliates. All rights reserved. 18 echo $DOMAIN_HOME echo $MW_HOME weblogic-deploy/bin/updateDomain.sh ¥ -oracle_home $MW_HOME ¥ -domain_home $DOMAIN_HOME ¥ -model_file source.yaml ¥ -variable_file source.properties ¥ -archive_file source.zip ¥ -admin_url t3://$(hostname -i):9071