このトピックでは、Dataphin Manager で Dataphin をゼロダウンタイムでアップグレードする方法について説明します。
制限事項
ゼロダウンタイムアップグレードは、現在およびターゲットのバージョン番号の最初の 3 つのセグメントが同じ場合にのみサポートされます。たとえば、V5.1.2.02 から V5.1.2.04 にアップグレードできます。
前提条件
バージョンアップグレードの影響を理解していることを確認してください。詳細については、「バージョンアップグレードの影響」をご参照ください。
構成またはアップグレードが進行中ではないことを確認してください。アップグレードが進行中の場合は、完了するまで待機します。必要に応じて、進行中のアップグレードを強制的に停止してから、再試行できます。
背景情報
Dataphin をゼロダウンタイムでアップグレードするには、バージョンとアップグレードモードの選択、およびアップグレードの実行という 2 つの主要なステップがあります。アップグレード中、ユーザーは通常どおり Dataphin にログインできます。Dataphin アプリケーションは、ローリングアップグレードを使用してアップグレードされます。完全なフローを次の図に示します。
操作手順
ステップ 1: バージョンとアップグレードモードの選択
Dataphin ログイン URL に
/opsconsole/v2を追加して、Dataphin Manager ログインページを開きます。Dataphin Manager のログインページで、[ユーザー名] と [パスワード] を入力し、[ログイン] をクリックします。ユーザー名とパスワードを取得するには、Dataphin の運用・保守（O&M）担当者に連絡してください。
[アップグレード記録] ページで、[Dataphin のアップグレード] をクリックします。
Dataphin のアップグレードページで、バージョンとアップグレードモードを選択します。次の表にパラメーターを示します。
パラメーター
説明
ターゲットバージョン
バージョンリストからターゲットバージョンを選択します。
バージョンリストに対象バージョンが含まれていない場合は、[バージョン構成のアップロード] をクリックして対象バージョンの構成ファイルをアップロードします。
構成ファイルのアップロード後、システムは構成ファイルの検証を実行します。ファイルの内容が正しくない場合、検証に失敗し、システムは失敗理由とともにエラーを報告します。ファイルが検証に合格し、システムにこのバージョンの構成ファイルが含まれていない場合、アップロードはバージョン構成をインポートします。ファイルが検証に合格し、システムにこのバージョンの構成ファイルがすでに含まれている場合、アップロードはシステム構成を上書きします。
構成ファイル
標準構成: [ファイルのアップロード] をクリックして、YAML または ZIP フォーマットの構成ファイルをアップロードします。アップロード後、構成ファイルをダウンロードできます。
設定ファイルがアップロードされると、システムによって設定ファイルの検証が実行されます。ファイルにすべての設定項目が含まれていない場合は、エラーが報告されます。エラーメッセージの[詳細を表示]をクリックすると、[不足している設定項目]のリストが表示されます。
非標準構成：ファイルをアップロードする前に、Dataphin O&M チームに連絡して、必要な構成ファイル（ZIP 形式）を取得してください。 [ファイルのアップロード] をクリックして、取得したファイルをアップロードします。ファイルがアップロードされると、システムは自動的に以下のチェックを実行します：
構成ファイル内の標準バージョン構成テンプレート (product/dataphin/...) が、アップロードされたバージョン構成 (一貫した MD5 検証) と同じであるかどうかをチェックします。同じでない場合、ファイル内の構成テンプレートが選択されたバージョンと互換性がないことを示すメッセージが表示されます。アップグレードを続行する前に、Dataphin O&M チームと確認してください。
オーバーレイファイルと values.yaml ファイルが、標準バージョン構成テンプレート (product/dataphin/...) と互換性があるかどうかをチェックします。互換性がない場合、システムはアップグレードをブロックし、メッセージが表示されます。このメッセージは、ファイル内の構成情報が選択されたバージョンと互換性がなく、アップグレードを続行できないことを示します。Dataphin O&M チームと確認してください。
構成ファイル内の values.yaml ファイルが、現在のオンライン環境で実行されている values.yaml ファイルと一致しているかどうかをチェックします。一致しない場合、ファイル内の構成情報が現在の環境のオンライン構成と一致しないことを示すメッセージが表示されます。アップグレードは新しい構成ファイルを使用して続行されます。
説明必要がない限り、非標準構成を使用しないでください。
アップグレードモード
[ゼロダウンタイムアップグレード] を選択します。アップグレード中は、DataService がアクティブなままとなり、DataService API 呼び出し（同期および非同期呼び出しを含む）が利用可能のままとなります。
システムは、現在およびターゲットバージョンの互換性構成をチェックして、ゼロダウンタイムアップグレードがサポートされているかどうかを判断します。ゼロダウンタイムアップグレードがサポートされていない場合、ダウンタイムアップグレードがデフォルトで選択されます。
リスク免責事項のチェックボックスを選択し、次に [アップグレードを開始] をクリックします。
ステップ 2: アップグレードの開始
システムのアップグレード進捗状況は、プログレスバーに表示されます。アップグレード中に、[ログの表示] をクリックして、アップグレードのログの詳細を表示できます。