アップグレード
アップグレードを実行する前に、データをバックアップしてください。
詳細については、 バックアップ/エクスポートを参照してください
へのアップグレード Transformation Advisor4.4 から 4.3
現在 4.0 をご利用の場合は、「 4.0 から 4.1 へのアップグレード」の指示に従ってください。ただし、代わりに 4.4 にアップグレードしてください。
にアップグレードするには Transformation Advisor4.4.0 にアップグレードするには、購読チャンネルを切り替える必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v4.3 チャネルをクリックして編集します。 オプションリストから v4.4 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor4.3 から 4.2
現在、 4.0 をご利用の場合は、「 4.0 から 4.1 へのアップグレード」の指示に従いますが、代わりに 4.3 にアップグレードしてください。
にアップグレードするには Transformation Advisor4.3.0 にアップグレードするには、購読チャンネルを切り替える必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v4.2 チャネルをクリックして編集します。 オプションリストから v4.3 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor4.2 から 4.1
現在、 4.0 をご利用の場合は、「 4.0 から 4.1 へのアップグレード」の指示に従いますが、代わりに 4.2 にアップグレードしてください。
にアップグレードするには Transformation Advisor4.2.0 にアップグレードするには、購読チャンネルを切り替える必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v4.1 チャネルをクリックして編集します。 オプションリストから v4.2 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor4.1 から 4.0
現在 4.0 をご利用の場合は、以下の手順に従ってください
- 以下のopensslコマンドを使用して新しい証明書を生成する。
openssl req -newkey rsa:2048 -nodes -keyout private.pem -x509 -days 730 -out public.crt -subj "/C=IE/ST=Cork/L=Cork/O=IBM/CN=internal.ta.ibm.com" -addext "subjectAltName=DNS:ta-couchdb.<namespace>.svc,DNS:*.ta-couchdb.<namespace>.svc,DNS:*.ta-couchdb.<namespace>.svc.cluster.local,DNS:ta-couchdb.<namespace>.svc.cluster.local - key.p12(combined KeystoreとTruststore)ファイルを作成します。
openssl pkcs12 -export -inkey private.pem -in public.crt -name default -out key.p12 -passout pass:plain-text-password - 新しく生成されたファイルを base64 フォーマットでエンコードする。
# base64 encode key.p12, private-base64, and public-base64 # on Linux base64 -w 0 ./key.p12 > key-base64 base64 -w 0 ./private.pem > private-base64 base64 -w 0 ./public.crt > public-base64 # on Mac base64 ./key.p12 > key-base64 base64 ./private.pem > private-base64 base64 ./public.crt > public-base64 - OCP UIを使用して、
transformation-advisor-secret内の private-base64 と public-base64 を置き換えます。Login to OCP -> Workloads -> Secrets -> select transformation-advisor-secret -> Edit Secret Replace ta_private_key with private-base64 value. Replace ta_public_key with public-base64 value. - key.p12 に以下のコマンドでパッチを適用します。
oc patch secret transformation-advisor-secret -p '{"data": {"key.p12": "'$(cat key-base64)'"}}' TAをアップグレードする 4.1
コピー
public.crtTransformation Advisor インスタンス。
Login to OCP -> Operators -> Installed Operators -> IBM Transformation Advisor -> Select Instance -> Edit TransAdv
Manually copy and paste public.crt value to authentication.tls.caCert.
Remember the indentation is important. There are 2 extra spaces for each line of the cert than the line of `caCert`.
すでに 4.1 にアップグレード済みで、サーバーログに以下のエラーが表示されている場合は、 step 6 以外の上記の手順をすべて実行し、すべてのポッドを再起動してください。
⁃ Caused by: javax.net.ssl.SSLPeerUnverifiedException: Hostname ta-couchdb.<namespace>.svc not verified:
⁃ certificate: sha256/M3BRjmy3Pvd1eqQbCzKyeNbXAoNIaat71QoHzaNWR2Y=
へのアップグレード Transformation Advisor4.0 3.X 以前から
へのアップグレードパスはない。 Transformation Advisor4.0. 既存のzipファイルを再度アップロードするか、ディスカバリーツールをダウンロードして再実行することをお勧めします。 にしか存在しない既存のデータがある場合は、データを移行することをお勧めします。 Transformation Advisor にしか存在しない既存のデータがある場合は、データを移行することをお勧めします。 データ移行の詳細については、 データ移行のセクションをご覧ください。 旧メジャーバージョンのアンインストールと新メジャーバージョンのインストールに関する詳細は、 2.5.x から 3.0.x への移行のセクションをご覧ください
へのアップグレード Transformation Advisor3.10.0 から 3.9.x
アップグレードする前にデータをバックアップします。 詳しくはバックアップ/エクスポートをご覧ください。
にアップグレードするには Transformation Advisor3.10.0 加入チャンネルを変更する必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v3.9 チャネルをクリックして編集します。 オプションリストから v3.10 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor3.9.0 から 3.8.x
アップグレードする前にデータをバックアップします。 詳しくはバックアップ/エクスポートをご覧ください。
にアップグレードするには Transformation Advisor3.9.0 加入チャンネルを変更する必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v3.8 チャネルをクリックして編集します。 オプションリストから v3.9 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor3.8.0 から 3.7.x
アップグレードする前にデータをバックアップします。 詳しくはバックアップ/エクスポートをご覧ください。
にアップグレードするには Transformation Advisor3.8.0 加入チャンネルを変更する必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v3.7 チャネルをクリックして編集します。 オプションリストから v3.8 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor3.7.0 から 3.6.x
アップグレードする前にデータをバックアップします。 詳しくはバックアップ/エクスポートをご覧ください。
にアップグレードするには Transformation Advisor3.7.0 加入チャンネルを変更する必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v3.6 チャネルをクリックして編集します。 オプションリストから v3.7 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor3.6.0 から 3.5.x
アップグレードする前にデータをバックアップします。 詳しくはバックアップ/エクスポートをご覧ください。
にアップグレードするには Transformation Advisor3.6.0 加入チャンネルを変更する必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v3.5 チャネルをクリックして編集します。 オプションリストから v3.6 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor3.5.0 から 3.4.x
アップグレードする前にデータをバックアップします。 詳しくはバックアップ/エクスポートをご覧ください。
にアップグレードするには Transformation Advisor3.5.0 加入チャンネルを変更する必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v3.4 チャネルをクリックして編集します。 オプションリストから v3.5 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor3.4.0 から 3.3.x
アップグレードする前にデータをバックアップします。 詳しくはバックアップ/エクスポートをご覧ください。
にアップグレードするには Transformation Advisor3.4.0 加入チャンネルを変更する必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v3.3 チャネルをクリックして編集します。 オプションリストから v3.4 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor3.3.0 から 3.2.x
アップグレードする前にデータをバックアップします。 詳しくはバックアップ/エクスポートをご覧ください。
にアップグレードするには Transformation Advisor3.3.0 加入チャンネルを変更する必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v3.2 チャネルをクリックして編集します。 オプションリストから v3.3 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor3.2.0 から 3.1.x
アップグレードする前にデータをバックアップします。 詳しくはバックアップ/エクスポートをご覧ください。
にアップグレードするには Transformation Advisor3.2.0 加入チャンネルを変更する必要があります。 OpenShift UIで Transformation Advisor に移動します。 サブスクリプション]タブをクリックし、[ チャネルの更新] 領域で v3.1 チャネルをクリックして編集します。 オプションリストから v3.2 チャンネルを選択する。 更新に Transformation Advisor 更新には数分かかります。
へのアップグレード Transformation Advisor3.1 から 3.0
アップグレードする前にデータをバックアップします。 詳しくはバックアップ/エクスポートをご覧ください。
アップグレード方法:
にアップグレードするには Transformation Advisor3.1.0 加入チャンネルを変更する必要があります。 これは、 IBM Transformation Advisor オペレーターページで行います。 チャンネル更新エリアの v3.0 をクリックし、 v3.1 を選択する。 製品は、チャネルの変更を保存した後に自動的にアップグレードされます。 更新に手動承認が必要な Transformation Advisor アップデートを手動で承認するようサブスクリプションを編集した場合は、アップグレードを確認する必要があります。
既知の問題:
EgressNetworkPoliciesをサポートしない OpenShift クラスターに変換がインストールされている場合に 3.0.0 から 3.1.0 にアップグレードすると、既知の問題が発生します。 IBM Cloud 上の OpenShift クラスターは、現時点 (執筆時点では正しい、2022 年 4 月) では EgressNetworkPoliciesをサポートしていません。 この場合、アップグレードは正常に完了しません。 この問題を回避するには、以下の手順に従ってください。
- 通常どおりにサブスクリプション・チャネルを変更して、アップグレードを実行します。
- オペレータがアップグレードした後 Transformation Advisor インスタンスのアップグレードは停止します。 オペレーター・ポッドのログを調べると、次のようなメッセージが表示されます。
... no matches for kind \"EgressNetworkPolicy\" ... - インスタンスに移動する。 Transformation Advisor 演算子をクリックし Transformation Advisor タブをクリックし、テーブルのインスタンスをクリックする)
- 「YAML」タブをクリックし、
networkPolicyセクションを更新して Egress ポリシーを無効にします。 更新が完了すると、networkPolicyは以下のようになります。networkPolicy: enabled: true egress: enabled: false - 更新を保存すると、アップグレードが自動的に続行され、成功します。
へのアップグレード Transformation Advisor3.0 2.5.X 以前から
へのアップグレードパスはない。 Transformation Advisor3.0. 既存のzipファイルを再度アップロードするか、ディスカバリーツールをダウンロードして再実行することをお勧めします。 にしか存在しない既存のデータがある場合は、データを移行することをお勧めします。 Transformation Advisor にしか存在しない既存のデータがある場合は、データを移行することをお勧めします。 データ移行の詳細については、 データ移行のセクションをご覧ください。 2.5.X のアンインストールと 3.0.X のインストールに関する詳細は、 2.5.x から 3.0.x への移行のセクションを参照してください。
へのアップグレード Transformation Advisor2.5.0 から 2.4.4
のチャンネルが異なるため、自動アップグレードではありません。 Transformation Advisor2.5.0 のチャンネルが 2.4.4 と異なるためです。 チャンネルの切り替えは、オペレーター・ページのサブスクリプション・タブを介して行われます。 Transformation Advisor オペレーターページ チャンネル更新エリアの v2.4 をクリックし、 v2.5 を選択する。 製品は、チャネルの変更を保存した後に自動的にアップグレードされます。 更新に手動承認が必要な Transformation Advisor アップデートを手動で承認するようサブスクリプションを編集した場合は、アップグレードを確認する必要があります。
へのアップグレード Transformation Advisor2.4.4 から 2.4.3
これは、デフォルトでは自動アップグレードです。 ただし Transformation Advisor サブスクリプションを編集してアップデートに手動承認を必要としない限り Transformation Advisor は自動的に 2.4.3 からバージョン 2.4.4 に更新されます。 サブスクリプションを Transformation Advisor サブスクリプションを編集してアップデートに手動承認が必要な場合は、 OpenShift UI で承認が必要なインストールプランを確認してください。
へのアップグレード Transformation Advisor2.4.3 から 2.4.2
これは、デフォルトでは自動アップグレードです。 ただし Transformation Advisor サブスクリプションを編集してアップデートに手動承認を必要としない限り Transformation Advisor は自動的に 2.4.2 からバージョン 2.4.3 に更新されます。 サブスクリプションを Transformation Advisor サブスクリプションを編集してアップデートに手動承認が必要な場合は、 OpenShift UI で承認が必要なインストールプランを確認してください。
2.4.3 へのアップグレードに関する既知の問題
バージョン Transformation Advisor バージョン 2.3.x からバージョン 2.4.2 へのアップグレードにバージョン 2.4.2 CASE のインストーラーを使用した場合、 2.4.3 へのアップグレードは機能しません。 OpenShift UI では、Operator アップグレードは、 Pending の状態で止まっているように見えます。 この問題が発生した場合、 2.3.4 からのアップグレードに 2.4.2 CASE インストーラーを使用した場合のみ、以下の手順で修正する必要があります。 Transformation Advisor :
を削除します。 Transformation Advisor サブスクリプション
oc delete subscription ibm-transformation-advisor -n <namespace>を削除します。 Transformation Advisor CSV
oc get csv -n <namespace>oc delete csv <csv-name1> <csv-name2> -n <namespace>インスタンス構成を Transformation Advisor インスタンス・コンフィギュレーションをライセンス・タイプでパッチする。 ご自分の設置場所に合った値を見つけるには、 この場所をご覧ください。
oc patch transadvs.ta.ibm.com/ta -p '{"spec":{"license":{"aLicenseType": "IBM Transformation Advisor 2.4.2 (Evaluation) - L-NHON-BYPFMS"}}}' --type=merge -n <namespace>サブスクリプションを再作成する。 Transformation Advisor サブスクリプション
a. 以下の yaml をファイルに保存します。 必要に応じて名前空間を更新します。
```bash {: codeblock} apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: ibm-transformation-advisor namespace: <namespace> spec: channel: v2.4 name: ibm-transformation-advisor installPlanApproval: Automatic source: ibm-transadv-catalog sourceNamespace: openshift-marketplace startingCSV: ta-operator.v2.4.3 ```b. サブスクリプションを適用します。
```bash {: codeblock} oc apply -f <subscriptionfile.yaml> ```
Installed Operators Openshift UIで、 2.4.3 が表示されるはずです。 Transformation Advisor オペレータが正常にインストールされ、数分後に 2.4.3 インスタンスが使用できるようになります。
へのアップグレード Transformation Advisor2.4.2 から 2.4.1
これは、デフォルトでは自動アップグレードです。 ただし Transformation Advisor サブスクリプションを編集してアップデートに手動承認を必要としない限り Transformation Advisor は自動的に 2.4.1 からバージョン 2.4.2 に更新されます。 サブスクリプションを Transformation Advisor サブスクリプションを編集してアップデートに手動承認が必要な場合は、 OpenShift UI で承認が必要なインストールプランを確認してください。
へのアップグレード Transformation Advisor2.4.1 から 2.4.0
これは、デフォルトでは自動アップグレードです。 ただし Transformation Advisor サブスクリプションを編集して更新に手動承認を必要としない限り Transformation Advisor は自動的に 2.4.0 から 2.4.1 に更新されます。 サブスクリプションを編集した場合 Transformation Advisor サブスクリプションを編集し、アップデートに手動承認が必要な場合は、 OpenShift UI で承認が必要なインストールプランを確認してください。
へのアップグレード Transformation Advisor2.4.X から 2.3.X
Transformation Advisor2.4.X は、 IBM Operator Catalogで配信されます。 詳しくは「 プランニング 」を参照。 Transformation Advisor2.3.X は Red Hat カタログで配信されたが、現在はカタログから削除されている。 そのため、アップグレードパスはありません。 Transformation Advisor2.4.X. から Transformation Advisor2.3.X から 2.4.X にアップグレードする場合、以下のオプションがあります:
オプション1:インスタンスにカスタマイズを加えず、データを保持する必要がない場合は、 をアンインストールし、 をインストールします。 Transformation Advisor インスタンスにカスタマイズがなく、データを保持する必要もない場合は、 2.3.X をアンインストールし、 2.4.X をインストール手順にしたがってインストールするだけです。
次のように、2.3.X を OpenShift UI でアンインストールできます。
- インストールされている Transformation Advisor 演算子を見つける。
- 演算子をクリックして Transformation Advisor 演算子をクリックしてインスタンスを見つける。 タブをクリックするとインスタンスが表示されます。 Transformation Advisor タブをクリックするとインスタンスが表示されます。
- インスタンスのケバブ・アイコンをクリックする。 Transformation Advisor インスタンスのケバブ・アイコンをクリックし、 Delete TransAdv を選択する。
- インストール済みオペレータ]ページに戻り、オペレータの[ケバブ]アイコンをクリックします。 Transformation Advisor をクリックし、[ Uninstall Operator(オペレータのアンインストール )]を選択します。
オプション2: CASE のインストーラーをダウンロードして Transformation Advisor をダウンロードし、
--upgradeオプションを使用して 2.4.X をインストールする。 これにより、2.3.X インスタンスへのカスタマイズと 2.3.X データがすべて保持されます。 詳細については、インストール・ドキュメントの CASE インストーラを使用したインストール・ セクションを参照してください。インストールで authentication.ocp.secretName 値を変更した場合、以下のスクリプトを使用してアップグレードを実行する前に、シークレットにパッチを適用する必要があります。
#!/bin/bash random_string(){ rand=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w ${1:-32} | head -n 1) echo -n $rand | openssl sha1 | sed 's/^.* //' } secret_name=<YOUR_SECRET_NAME>; NONADMINUSER=$( random_string | base64 ) NONADMINSECRET=$( random_string | base64 ) oc patch secret $secret_name -p '{"data":{"db_nonadmin_user": "'"$NONADMINUSER"'"}}' --type=merge oc patch secret $secret_name -p '{"data":{"db_nonadmin_secret": "'"$NONADMINSECRET"'"}}' --type=mergeオプション 3: ここで説明されている手動による手順により 2.3.X データを保持します。
以前にインストールしたバージョンのデータをバックアップします。 そのためのオプションについては、 「バックアップと復元」のドキュメントを参照してください。
をアンインストールできる。 Transformation Advisor2.3.x
PersistentVolumeClaimアンインストールすることができる。 そのPersistentVolumeClaim、新しいインストールで使用できる。 Transformation Advisor2.4.X をインストールします。 2.4.x にアップグレードする際にデータを保持するには、PersistentVolumeClaimを保持するのが最も簡単な方法です。**TO KEEP YOUR 2.3.X DATA BY PRESERVING THE `PersistentVolumeClaim`** follow the *Preserving the PersistentVolumeClaim* procedure outlined in [Backing up and Exporting Data](../gettingStarted/backingupData.html). When following this procedure, you must install <span data-key-file="/home/jenkins/workspace/workspace/dita-converter/git_repo/conrefs.yml" data-conkeyref="conrefs/keyword.ta_short" data-variable="keyword.ta_short" class="md-conref">keyword.ta_short</span> 2.4.X into the same namespace as the 2.3.x version. If you have other customizations to your <span data-key-file="/home/jenkins/workspace/workspace/dita-converter/git_repo/conrefs.yml" data-conkeyref="conrefs/keyword.ta_short" data-variable="keyword.ta_short" class="md-conref">keyword.ta_short</span> instance (i.e. if you have edited other values in the custom resource YAML when installing 2.3.X), you may also wish to keep or re-apply them. You can view your current <span data-key-file="/home/jenkins/workspace/workspace/dita-converter/git_repo/conrefs.yml" data-conkeyref="conrefs/keyword.ta_short" data-variable="keyword.ta_short" class="md-conref">keyword.ta_short</span> instance configuration with the following command: ```bash {: codeblock} kubectl get transadvs.charts.ta.cloud.ibm.com ta -n <NAMESPACE> -o yaml ```インストール時に
authentication.ocp.secretName値を変更した場合は、オプション 2 で提供されているスクリプトを実行します。2.4.X をインストールドキュメントに従ってインストールする。
PersistentVolumeClaimを保持した場合、2.4.X インストールに関するexistingClaimとして使用できます。