Oracle SOA Suiteドメイン・リリースのアップグレード

この項では、Oracle SOA Suiteドメインをリリース12.2.1.4から14.1.2.0にアップグレードする方法について説明します。

前提条件

自動ドメイン・アップグレード・プロセスを開始する前に、次のことを確認してください:

  • 管理およびコロケートされたすべての管理対象サーバーは、アップグレード・プロセスの前に停止されます。ドメイン内のサーバーを停止できることを確認します。
  • 影響を受けるデータがすべてバックアップされています。
  • ドメイン・ホームがバックアップされています。
  • Fusion Middlewareのアップグレードを行うデータベースのバージョンがOracleにより動作保証済
  • 動作保証およびシステム要件が満たされています。
  • アップグレード後に影響を受けるシナリオについては、ここを参照してください。

ドメイン・アップグレード・スクリプトを使用する準備

Oracle OracleSOASuiteドメインのドメイン・アップグレード(スキーマ・アップグレードおよびドメイン・ホーム・アップグレード)を自動化するためのサンプル・スクリプトは、${WORKDIR}/create-soa-domain/domain-upgradeにあります。

ドメイン・アップグレードの詳細を提供するために、domain-upgrade-inputs.yaml(またはそのコピー)を編集する必要があります。

このファイルに指定する必要がある情報を理解するには、次の構成パラメータを参照してください

構成パラメータ

入力ファイルには、次のパラメータを指定できます。

パラメータ 定義 デフォルト
domainHome OracleSOASuiteドメインのホーム・ディレクトリ。 /u01/oracle/user_projects/domains/soainfra
domainPVMountPath ドメイン永続ボリュームのマウント・パス。 /u01/oracle/user_projects
domainUID WebLogic Serverドメイン名 soainfra
image OracleSOASuite 14.1.2コンテナ・イメージ。 soasuite:release-version
imagePullPolicy OracleSOASuiteコンテナ・イメージ・プル・ポリシー。有効な値は、IfNotPresent、AlwaysおよびNeverです。 IfNotPresent
imagePullSecretName OracleSOASuiteコンテナ・イメージをプルするためにコンテナ・レジストリにアクセスするためのKubernetesシークレットの名前。このパラメータを指定すると、シークレットの存在が検証されます。  
namespace ドメインのKubernetesネームスペース。 soans
persistentVolumeClaimName ドメイン・ホームに使用される永続ボリューム要求の名前。 soainfra-domain-pvc
rcuSchemaPrefix スキーマ接頭辞。 SOA1
rcuDatabaseURL データベースURL。 oracle-db.default.svc.cluster.local:1521/devpdb.k8s
rcuCredentialsSecret データベース資格証明を含むKubernetesシークレット。 soainfra-rcu-credentials
secureEnabled ドメインに対してセキュアが有効かどうかを示すブール。 false

ドメイン・アップグレード・スクリプトの実行

ドメイン・アップグレード・スクリプトを実行し、入力ファイルと出力ディレクトリを指定して、生成されたアーティファクトを格納します:

$ cd domain-upgrade
$ ./domain-upgrade.sh \
  -i domain-upgrade-inputs.yaml \
  -o <path to output-directory>

このスクリプトは、次のステップを実行します:

  • ドメインを停止します
  • 14.1.2イメージと、ドメイン・アップグレードを実行するためにドメイン・ホームに使用される永続ボリューム要求を使用してポッドを作成します。
  • UAスキーマのアップグレードを実行します。
  • ドメイン・ホームのアップグレードを実行します。
  • 新しいWLS_RUNTIMEスキーマのデータベース値を設定します。
  • フラグsecureEnabledがtrueに設定されている場合、セキュア・ドメインを有効にします。
  • 14.1.2イメージでドメイン仕様を更新します。
  • ドメインを起動し、14.1.2イメージでドメインが起動して実行されるまで待機します。

イングレスのアップグレード

このステップは、ドメインのアップグレード中にsecureEnabledをtrueに有効にした場合に必要です。セキュア・ドメインでは、sslType=E2ESSLのみがサポートされています。たとえば、NGINXなどのE2ESSLをサポートしてイングレス・コントローラがインストールされていない場合は、それに応じてイングレス・コントローラを再作成します。次に、helm upgradeを実行して、--set wlsDomain.secureEnabled=trueを使用してingress-per-domainを更新します。コマンド例を次に示します:

$ cd $WORKDIR
$ helm install REPLACE-WITH-INGRESS-PER-DOMAIN-RELEASE-NAME charts/ingress-per-domain \
  --reuse-values --set wlsDomain.secureEnabled=true