11 Oracle GoldenGate Marketplaceイメージのアップグレード

この章では、OCIスタック・アプローチを使用して、既存の(または旧バージョンの) Oracle GoldenGate Marketplaceスタックを最新のリリースにアップグレードする方法について説明します。

ノート:

19cスタックから21cリリースへのアップグレードは許可されていません。

アップグレードの前に、次のことを実行してください。

1. VMインスタンス内のすべてのOracle GoldenGateプロセスを停止します。
2. 失敗したアップグレード/更新のために将来元に戻す必要がある場合のみ、すべてのブロック・ストレージをバックアップします。

トピック:

• スタック
  
• スタックの取得
  Oracle GoldenGate Marketplaceをアップグレードする前に、最新のスタックを取得する必要があります。
• アップグレードするスタックのTerraformバージョンの識別
  
• Oracle Cloud Marketplaceイメージのアップグレード(別のTerraformバージョン)
  
• Oracle Cloud Marketplaceイメージの1.0.xへのアップグレード(同じTerraformバージョン)
  

スタック

スタックは、最新のTerraformコード・ベースを含むzipファイルです。これらのスタックにより、新しい計算ノードのプロビジョニングおよび既存のブロック・ストレージのアタッチが可能になります。このアプローチにより、Oracle GoldenGateで、環境に存在する関連データが失われることがなくなります。

スタックが使用可能な場合、Oracleオブジェクト・ストアを通じてアクセスできます。

スタックの取得

Oracle GoldenGate Marketplaceをアップグレードする前に、最新のスタックを取得する必要があります。

スタックを取得するには、次の手順を実行します。

1. マーケットプレイス・リストに移動します。
2. 「Version」ドロップダウン・リストからバージョンを選択します。これは、アップグレードに使用するマーケットプレイス・イメージです。
3. 「I have reviewed and accepted the Oracle Program Limited Use Promotional Terms」チェック・ボックスを選択します。
4. Downloadをクリックしてスタックzipファイルをダウンロードし、次のディレクトリのローカル・ドライブに保存します: BundlePatch19c。

アップグレードするスタックのTerraformバージョンの識別

アップグレードするスタックのTerraformバージョンを識別するには、次の手順を実行します。

1. Oracle Cloud Interface (OCI)コンソールにログインします。
2. Homeページの「Developer Services」で、「Resource Manager」をクリックし、「Stacks」をクリックします。
3. Terraformバージョンを識別する既存のスタックを選択します。
   「Stack Information」の「Terrafom version」フィールドに、スタックで使用されるTerraformバージョンがリストされます。

   ノート:

   アップグレードするスタックのTerraformバージョンと新しいスタックのバージョンが同じ場合は、「Oracle Cloud Marketplaceイメージの1.0.xへのアップグレード(同じTerraformバージョン)」のステップを実行します。バージョンが異なる場合は、「Oracle Cloud Marketplaceイメージのアップグレード(別のTerraformバージョン)」のステップに従います。

Oracle Cloud Marketplaceイメージのアップグレード(別のTerraformバージョン)

Oracle Cloud Marketplaceイメージをアップグレードすると、アップグレード前のスタックのTerraformバージョンが新しいスタックで別のTerraformバージョンに更新される場合にそれを行うには、次のタスクを実行します:

• アップグレードするスタックが最新であることを確認する方法
  
• 古いスタックからのTerraform構成およびTerraform状態ファイルのダウンロードおよび新しいスタックの作成
  
• Terraform v0.12からv1.0.xへのアップグレード
  

アップグレードするスタックが最新であることを確認する方法

1. アップグレードするスタックが最新であることを確認します。
2. 左側のパネルで、アップグレードする必要があるスタックを含むコンパートメントを選択します。
3. 右側のパネルで、アップグレードする必要があるスタックをクリックします。
4. 「Stack details」ページで、スタックが使用した変数を書き留めます。左側のパネルで「Variables」をクリックし、変数をテキスト・エディタにコピーします。これは必須です。最終的に同じコンパートメント、vcnまたはサブネットを使用する必要があるためです。
5. スタックで使用するタグを書き留めます。右側のパネルで、「Tags」ペインに切り替え、タグをテキスト・エディタにコピーします。
6. 「Terraform Actions」メニューで「Plan」操作をクリックして、スタックに保留中の変更がないことを確認します。
   ジョブの出力には「No changes」「Infrastructure is up-to-date」と表示される必要があります。

古いスタックからのTerraform構成およびTerraform状態ファイルのダウンロードおよび新しいスタックの作成

1. 古いバージョンのスタックからスタックのTerraform構成およびTerraform状態ファイルをダウンロードします(状態ファイルの名前をterraform.tfstateに変更します)。スタックの状態ファイルおよびTerraform構成のダウンロードの詳細は、スタックの状態ファイルの取得およびTerraform構成ファイルのダウンロードを参照してください。
2. Terraform構成およびTerraform状態ファイルをローカル・ワークスペースにコピーし、ファイルを解凍します。
3. 解凍後にocid*という名前のzipファイルを削除します。
4. Terraform_13 (hashicorpからダウンロードしてローカル・ホストのPATH変数に保存)を使用して、スタックのTerraform構成をアップグレードします。

   アップグレードを実行する前に、スタックにあるmain.tfファイルで、必要なTerraformバージョンを確認します。Terraformの必須バージョンがrequired_version = "~> 0.12"として定義されている場合は、required_version = ">= 0.12"に変更します。

5. 次に示すように、bashプロンプトでupgradeコマンドを実行します:
   bash-4.2$ terraform_13 0.13upgrade
6. 次のコード・スニペットに示すように、更新されたスタック構成の新しいzipファイルを作成します:
   bash-4.2$ zip -qr upgradeTF013_Oracle1923.zip *
   このスニペットでは、TF013_Oracle1923.zipが新しいzipファイルの名前です。

Terraform v0.12からv1.0.xへのアップグレード

Terraform v0.12を使用したOracle GoldenGate on Marketplaceから1.0.xへのアップグレードは、3つの部分からなるプロセスです:

1. Terraformスタックの0.12から0.13へのアップグレード

2. Terraformスタックの0.13から0.14へのアップグレード

3. Terraformスタックの0.14から1.0.xへのアップグレード

次の手順を使用して、Terraform v 0.12からv0.13、v0.13からv0.14、0.14から1.0.xにアップグレードします。

1. Oracle Cloud Interface (OCI)コンソールにログインします。
2. Oracle GoldenGateインスタンスにログインし、実行中のすべてのOracle GoldenGateプロセスを停止します。サービス・マネージャを含むすべてのMicroservices (管理サービス、分散サービス、レシーバ・サービスおよびパフォーマンス・メトリック・サービス)を停止してください。
3. 「Home」ページで左上隅のナビゲーション・メニューをクリックし、「Developer Services」で「Resource Manager」をクリックして、「Stacks」をクリックします。
4. 「古いスタックからのTerraform構成およびTerraform状態ファイルのダウンロードおよび新しいスタックの作成」で作成した新しいスタックを選択します。
5. トップ・メニューで「編集」をクリックします。
6. 新しいzip (terraform_13 upgraded zip)をアップロードします。
7. Terraformバージョンを0.13.xに更新し、「Save Changes」をクリックします。
8. インポート・ジョブを使用して、Terraform状態ファイルterraform.tfstateをスタックにインポートします。
9. 「Compute」に移動して、「Instances」を選択します。
10. アップグレードする必要がある既存のコンピュート・インスタンスを終了します。
11. 「Permanently delete the attached boot volume」オプションが選択されていることを確認します。
12. インスタンスの終了後、左側のナビゲーション・ペインで「Developer Services」を選択し、「Resource Manager」をクリックして、「Stack」をクリックします。
13. ステップ4で編集したスタックをアップグレードのために選択します。
14. 「Apply Job」をクリックします。ステップがエラーなしで実行されることを確認します。

    ジョブが完了するまで待機し、計算ノードが稼働しているかどうかを確認します。

15. Terraform v0.13からv.14にアップグレードするには:

    1. リソース・マネージャから、0.13にアップグレードしたスタックを選択し、「Edit」をクリックします。

    2. スタック内のTerraformバージョンを0.14に更新し、「Next」をクリックします。

    3. 事前入力された詳細が正確であることを確認し、「Save Changes」をクリックします。

    4. 「Compute」に移動して、「Instances」を選択します。

    5. アップグレードする必要がある既存のコンピュート・インスタンスを終了します。

    6. 「Permanently delete the attached boot volume」オプションが選択されていることを確認します。

    7. インスタンスの終了後、左側のナビゲーション・ペインで「Developer Services」を選択し、「Resource Manager」をクリックして、「Stack」をクリックします。

    8. Terraformバージョンをアップグレードするスタックを選択します。

    9. 「Apply Job」をクリックします。ジョブが完了するまで待機し、計算ノードが稼働しているかどうかを確認します

16. Terraform v0.14に正常にアップグレードした後、「Oracle Cloud Marketplaceイメージの1.0.xへのアップグレード(同じTerraformバージョン)」に記載されているステップに従います。
17. Terraform v1.0.xへのアップグレードが正常に完了したら、~/.ssh/known_hostsファイルからコンピュート・インスタンスのIPアドレスを削除します。それにより、そのコンピュート・ノードにログインしてすべてのOracle GoldenGateプロセスを開始できるようになります。

Oracle Cloud Marketplaceイメージの1.0.xへのアップグレード(同じTerraformバージョン)

アップグレード・プロセスは、同じメジャー・バージョン内のアップグレードまたはパッチ適用に対してのみ有効です(v19cからv19cなど)。現在のマーケットプレイスでは、イメージ更新によるメジャー・バージョン・アップグレードはサポートされていません。

アップグレード前のスタックTerraformバージョンが新しいスタック・バージョンと同じ場合に、既存のOracle GoldenGate Marketplaceイメージをアップグレードするには、次のタスクを実行します:

ノート:

これらのステップは、Terraform v0.14から1.0.xに更新されるOracle GoldenGate Marketplaceでのみ適用可能です。

1. スタックの正しいバージョンをダウンロードします。
2. Oracle Cloud Interface (OCI)コンソールにログインします。
3. Oracle GoldenGateインスタンスにログインし、実行中のすべてのOracle GoldenGateプロセスを停止します。サービス・マネージャを含むすべてのMicroservices (管理サービス、分散サービス、レシーバ・サービスおよびパフォーマンス・メトリック・サービス)を停止してください。
4. 「Home」ページで左上隅のナビゲーション・メニューをクリックし、「Developer Services」で「Resource Manager」をクリックして、「Stacks」をクリックします。
5. アップグレードする既存のスタックを選択します。
6. トップ・メニューで「編集」をクリックします。
7. 「Browse」をクリックして、ダウンロードしたスタックを選択します。
8. 新しい.zipファイルをアップロードします。
9. スタックのterraformバージョンを1.0.xに更新し、「Next」をクリックします。
10. 事前入力された詳細が正確であることを確認し、「Save Changes」をクリックします。
11. 「Compute」に移動して、「Instances」を選択します。
12. アップグレードする必要がある既存のコンピュート・インスタンスを終了します。
13. 「Permanently delete the attached boot volume」オプションが選択されていることを確認します。
14. インスタンスの終了後、左側のナビゲーション・ペインで「Developer Services」を選択し、「Resource Manager」をクリックして、「Stack」をクリックします。
15. アップグレードのために、ステップ6で編集した「Stack」を選択します。
16. 「Apply Job」をクリックします。

    ジョブが完了するまで待機し、計算ノードが稼働しているかどうかを確認します。

17. アップグレード後、~/.ssh/known_hostsファイルからコンピュート・インスタンスのIPアドレスを削除します。それにより、そのコンピュート・ノードにログインしてすべてのOracle GoldenGateプロセスを開始できるようになります。