4 バージョン21へのアップグレード
アップグレード・プロセスを開始する前に、仮想マシン(VM)の現在の状態のスナップショットを作成します。バージョン21.1.2からのロールバックはサポートされていません。
Transport Layer Securityの有効化
Oracle Blockchain Platform Enterprise Editionバージョン21にバンドルされている組込みLDAPサーバーでは、ポート636でのTransport Layer Security (TLS)接続のみをサポートしています。
ノート:
現在、TLSを無効にして組込みLDAPサーバーを使用している場合は、バージョン21にアップグレードする前に、次のステップを実行してTLSを有効にする必要があります。- 「構成」タブを開きます。
- 認証サーバーで、「デフォルト」を選択し、「TLS有効」を「True」に設定します。
- 「テスト構成」をクリックして、設定が機能することを確認します。
- 「保存」、「アクティブに設定」の順にクリックします。
- 「インスタンス」タブを開きます。
- 組込みLDAPサーバーを使用するインスタンスごとに、インスタンス名をクリックして「インスタンスの詳細」ページを開きます。「アクション」メニューから、「更新」オプションを使用して認証サーバー構成の更新を選択し、更新を完了します。
v19.3.6へのパッチ適用
インスタンスにバージョン19.3.6のパッチを適用します。
バージョン21にアップグレードする前に、Blockchain Platform Managerと、ファウンダおよび参加者のすべてのインスタンスにバージョン19.3.6へのパッチを適用する中間ステップを完了する必要があります。詳細は、「v19.3.5以降へのインスタンスのパッチ適用」を参照してください。
バージョン21へのインスタンスのアップグレード
インスタンスにパッチを適用して、バージョン19からバージョン21にアップグレードします。ただし、パッチを登録した後、パッチを適用する前にスクリプトを実行する必要もあります。
バージョン21.1.2にアップグレードすると、すべてのカスタム登録が移行されますが、ユーザーと登録の関連付けは移行されません。インスタンスをバージョン21.1.2にアップグレードした後、コンソールからカスタム登録にユーザーの関連付けを追加する必要があります。
ユーザーをカスタム登録に再度関連付けるには、コンソールの「ノード」タブでrestproxyノードを見つけます。「アクション」メニューで、登録の表示または管理を選択します。登録管理ページで、「登録ID」の下の登録を選択し、新規ユーザーの関連付けを展開してユーザーIDを入力し、ユーザーを登録に追加します。すべてのユーザーを追加したら、「関連付け」をクリックします。
外部ロード・バランサのポート・マッピングの更新
外部ロード・バランサを使用するすべてのインスタンスは、バージョン21へのアップグレード後に再構成する必要があります。
バージョン21では、CAおよびRESTプロキシがコンソールと同じポートを共有するため、CAおよびRESTプロキシとPrometheusのポート・マッピングは不要になりました。また、オーダラのRaftポートはバージョン19のオーダラ問合せポートと同じですが、RaftポートはTLSに対して有効ではありません。外部ロード・バランサを使用する場合は、これらの変更を考慮して構成を更新する必要があります。
Raftコンセンサス・プロトコルの構成
バージョン21の製品では、Kafkaベースのオーダリングではなく、Raftベースのオーダリングが使用されています。チャネルおよびインスタンス情報を収集してスクリプトを実行することで、コンセンサス・タイプをKafkaからRaftに変更します。
すべてのファウンダおよび参加者インスタンスがバージョン21.1.2にアップグレードされた後にのみ、次のステップを実行します。
- Blockchain Platform Manager仮想マシン(VM)およびすべてのインスタンスVMで、
/u01/blockchain/cp/config/scripts-21.1.2
ディレクトリに移動し、rootアカウントからconfig-obplog.sh
スクリプトを実行してログを/var/log/messages
から/u01/obp-logs/
にリダイレクトします。 - すべてのインスタンスVMで、次のステップを実行します。
- すべての参加者インスタンスで、ファウンダ・インスタンスからオーダリング・サービス設定をインポートします。
- 各データ・プレーンVMで、
/u01/blockchain/cp/config/scripts-21.1.2
に移動し、sudoモードでsh patchUpdates.sh -VMType instance
コマンドを実行します。 - Blockchain Platform Managerの「インスタンス」タブを開き、アップグレードしたインスタンスごとにインスタンス名をクリックして「インスタンスの詳細」ページを開きます。
デフォルトでは、バージョン19の開発者インスタンスには2つのオーダラしか含まれていませんでした。バージョン21.1.2へのアップグレードとRaftコンセンサス・プロトコルの変更を完了したら、少なくとも3つのオーダラが使用できるように別のオーダラを追加します。詳細は、「インスタンスのスケール・インまたはスケール・アウト」を参照してください。