4 AMCデプロイメントの管理

WKOおよびAMCのアップグレードと保守は、Containerized AMCを使用してシームレスに実行できます。

また、停止時間を最小限に抑え、サービスを継続しながら、コンテナ化されていないAMCをContainerized AMCに移行することもできます。

コンテナ化されていないAMCのContainerized AMCへの移行

コンテナ化されていないAMCからContainerized AMCへの移行には、既存のオンプレミスAMCデータベースのContainerized AMCとの接続の再利用が含まれます。つまり、オンプレミス(コンテナ化されていない)AMCに接続しているデータベースは切断され、Containerized AMCに接続されます。ただし、オンプレミスAMCのWebLogicドメイン構成は、Containerized AMCに移行されません。

オンプレミスAMCからContainerized AMCへの移行中に、同じバージョンまたはそれ以上のバージョンのAMCに移行できます。ただし、下位バージョンのAMCに移行することはできません。

ノート:

Advanced Management Consoleをバージョン2.17以上にアップグレードするときに、「エージェントの自動更新」オプションが有効になっている場合は、エージェント・マシンの署名証明書を手動で置き換える必要があります。詳細なステップは、Advanced Management Consoleエージェントの自動更新に関する項を参照してください。
オンプレミスAMCからContainerized AMCに移行する場合、次のいずれかを計画します:
  • オンプレミスAMCサーバー・アドレスの再利用: AMCサーバー・アドレスは、AMCの初期化時に設定したホスト名およびポート番号です。このアドレスは、オンプレミスAMCに接続されているすべてのエージェントによって使用されます。移行されたContainerized AMCに同じAMCサーバー・アドレスを保持できます。ただし、AMCサーバー・アドレスを再利用するには、サーバー・アドレスのフロント・エンドとして外部ロード・バランサを使用する必要があります。

    または

  • AMCサーバー・アドレスの変更: AMCサーバー・アドレスの変更による移行を計画します。

オンプレミスAMCサーバー・アドレスの再利用

移行を開始する前に、オンプレミスAMCが外部ロード・バランサ・アプリケーションを介してフロント・エンドされていることを確認します。

  1. オンプレミスのWebLogicクラスタまたはサーバーで、実行中のAMCアプリケーションを停止またはアンデプロイします。WebLogicサーバーまたはクラスタがAMCデプロイメントにのみ使用されている場合は、WebLogicサーバーまたはクラスタを停止することもできます。
  2. オンプレミスAMCで使用されていたデータベース接続プロパティを使用して、Containerized AMCをデプロイします。
  3. Containerized AMCデプロイメントのサービス・エンド・ポイント(つまり、サーバー・ホスト名またはIPアドレス、およびポート番号)を特定します。Containerized AMCへのアクセス」を参照してください。
  4. 外部ロード・バランサ・バックエンドをContainerized AMCサービス・エンドポイントで置き換え、ロード・バランサ・アプリケーションを再起動します。
  5. 上位バージョンのAMCにアップグレードする場合は、Containerized AMCデプロイメントのアップグレード」を参照してください。
次に、AMCサーバーのアドレスを変更せずにオンプレミスAMCをContainerized AMCに移行するためにHAプロキシ構成を変更する方法の例を示します:
-------------------------------------------------
 HA Proxy front ending on-premise AMC 
-------------------------------------------------
frontend AMCServer_001
bind *:8189 ssl crt /etc/haproxy/cert/server.pem
reqadd X-Forwarded-Proto:\ https
default_backend AMCServer_001_Back

backend AMCServer_001_Back
cookie JSESSIONID prefix nocache
server AMCServer_001_MS1 <onprem-managed-server1:port> cookie amc-cluster  ssl verify none
server AMCServer_001_MS2 <onprem-managed-server2:port> cookie amc-cluster  ssl verify none

-------------------------------------------------------
 HA Proxy front ending Containerized AMC 
-------------------------------------------------------

frontend AMCServer_001
bind *:8189 ssl crt /etc/haproxy/cert/server.pem
reqadd X-Forwarded-Proto:\ https
default_backend AMCServer_001_Back

backend AMCServer_001_Back
cookie JSESSIONID prefix nocache
server AMCServer_001_MS1 <cont-amc-server-host:port> cookie amc-cluster  ssl verify none

AMCサーバー・アドレスの変更

異なるAMCサーバー・アドレス(ホスト名またはIPアドレス、およびポート番号)を指定して、オンプレミスAMCをContainerized AMCに移行します。

  1. オンプレミスのWebLogicクラスタまたはサーバーで、実行中のAMCアプリケーションを停止またはアンデプロイします。WebLogicサーバーまたはクラスタがAMCデプロイメントにのみ使用されている場合は、WebLogicサーバーまたはクラスタを停止することもできます。
  2. オンプレミスAMCで使用されていたデータベース接続プロパティを使用して、Containerized AMCをデプロイします。
  3. Containerized AMCデプロイメントのサービス・エンド・ポイント(つまり、サーバー・ホスト名またはIP、およびポート番号)を特定します。
  4. 任意のデータベース・クライアント・アプリケーションからAMCデータベースに接続し、次のSQL文を使用してAMC構成表を更新し、変更をコミットします:
    update config set configvalue = '<cont-amc-service-host>' where configkey = 'hostname';
    update config set configvalue = '<cont-amc-service-port>' where configkey = 'amc_port';
    update amc2.config set configvalue = '203.0.113.10' where configkey = 'hostname';
    update amc2.config set configvalue = '6503' where configkey = 'amc_port' 
    
  5. すべてのエージェント・マシンで、AMC_AgentconfディレクトリにあるAMCServer.propertiesファイル(%AMC_DIR%\conf\AMCUser.properties)のプロパティserver.nameおよびserver.portを変更します。新しいデプロイメントによるエージェント管理の継続性を確保するには、すべてのエージェントのプロパティを更新します。
    server.name: <cont-amc-service-host>
    server.port: <cont-amc-service-port>
    server.protocol: https
    agentId: 3
    authCookieName: amc_auth
    authCookieValue: c78b2652-1d86-41b6-a673-c4b309d9ec06
  6. この変更後、すべてのエージェントを再起動します:
    • Windows: タスク・マネージャを介してAMCシステム・サービスを再起動します
    • macOSおよびLinux: 実行 - sudo bash ${AMC_DIR}/bin/AMCAgent.sh -restart

デプロイメントのアップグレード

upgradeコマンドを実行して、最新バージョンのWKO、AMCおよびHelmチャート値をフェッチします。

WKOデプロイメントのアップグレード

WKOデプロイメントをアップグレードするには、次のコマンドを使用します:
helm upgrade <release-name> weblogic-operator/weblogic-operator \
--set "javaLoggingLevel=FINE" -n <operator-namespace> \
--reuse-values
コマンド例:
$ helm upgrade wko weblogic-operator/weblogic-operator \
--set "javaLoggingLevel=FINE" -n wko-ns \
--reuse-values

WKOデプロイメントのアップグレード・ステップの詳細は、オペレータのアップグレードに関する項を参照してください。

Containerized AMCデプロイメントのアップグレード

次のいずれかのシナリオで、Containerized AMCをアップグレードできます:
  • 新しいバージョンのAMCコンテナ・イメージが使用可能です
  • 実行するポッドの数を増減させる必要がある場合(スケールインまたはスケールアウト)
  • WebLogicドメイン構成の変更
  • 異なるデータベース、メール・サーバーまたはLDAPサーバーへの切替え
構成値を更新するには、custom-values.yamlファイルを編集します。
次のコマンドを実行して、Containerized AMCデプロイメントをアップグレードします:
helm upgrade <release_name> <path to amc helm package> –-values custom-values.yaml --wait \   
-n <amc-namespace> --reuse-values 
説明:
  • custom-values.yamlは、ローカル・リポジトリまたはリモート・リポジトリの標準値を上書きするカスタム値です。
  • release_nameは、Containerized AMCデプロイメントの名前です。
  • path to amc helm packageは、標準AMC値を含むローカルHelmパッケージです。
  • amc-namespaceは、アップグレードされるAMCバージョンです。
  • waitは、すべてのポッドおよびサービスが準備完了状態になるまで出力を一時停止します。
  • reuse-valuesは、アップグレード中に最後のリリース値およびマージ・オーバーライド(存在する場合)を使用します。
コマンド例:
$ helm upgrade amc ./java-amc-1.0.0.tgz --values custom-values.yaml --wait \
   -n amc-ns   --reuse-values

デプロイメントのアンインストール

アンインストールすると、デプロイメント時に作成したすべてのリソースが削除されます。WKOをアンインストールする前に、Containerized AMCをアンインストールしてください。

AMCおよびWKOデプロイメントをアンインストールするには、次のコマンドを指定された順序で使用します:

Containerized AMCデプロイメントのアンインストール

ConfigMapの削除:
kubectl delete configmap <configmap-name> -n <amc-namespace>
AMCのデプロイメント中に作成されたシークレットの削除:
kubectl delete secret <secret-name> -n <amc-namespace>
AMCネームスペースの削除:
kubectl delete namespace <amc-namespace>
AMCデプロイメントの削除:
helm uninstall <release_name> -n <amc-namespace>

WKOデプロイメントのアンインストール

オペレータによって作成されたカスタム・リソース定義オブジェクトの削除:
kubectl delete customresourcedefinition domains.weblogic.oracle -n <operator-namespace>
オペレータのネームスペースの削除:
kubectl delete namespace <operator-namespace>
オペレータの削除:
helm unistall <release-name> -n <operator-namespace>
AMCおよびWKOデプロイメントを完全にアンインストールするために使用できるbashスクリプトの例を次に示します。
#!/bin/bash

kubectl delete configmap amc-keystore -n amc-ns
kubectl delete secret  amc-wls-credentials -n amc-ns
kubectl delete secret  amc-ds-credentials -n amc-ns
kubectl delete secret  amc-mail-credentials -n amc-ns
kubectl delete secret  amc-ldap-credentials -n amc-ns
kubectl delete secret  amc-jks-credentials -n amc-ns

helm uninstall amc -n amc-ns
helm uninstall wko -n wko-ns

kubectl delete customresourcedefinition domains.weblogic.oracle -n wko-ns


kubectl delete namespace amc-ns
kubectl delete namespace wko-ns