CubeCOSにおけるワンクリック更新およびアップグレードのインストールガイド

このガイドでは、ファームウェアのアップグレードおよびフィックスパックの更新方法について説明します。 ファイルのアップロードやMD5検証から、自動ローリングアップグレードやVMの移行に至るまで、更新プロセス全体を網羅しています。 このガイドには、トラブルシューティングの手順やエラーコードの参照情報も含まれています。

前提条件

アップグレード／アップデートを開始する前に、以下の点を確認してください：

1. 新バージョンのリリースノートと変更履歴をご確認ください。
   • リリースノート: このリリースの新機能、既知の問題、および互換性についてご確認ください。
   • 変更履歴: 具体的なコードの修正やコンポーネントの更新内容の一覧を確認できます。
2. すべてのサービスが「正常」な状態であり、エラーがないことを確認してください。
3. 本番環境への影響を最小限に抑えるため、アップグレード／アップデートは利用の少ない時間帯に実施してください。
4. 詳細については、CubeCOS アップグレードガイドもご参照ください。

CubeCOSのファームウェアを更新する

ファームウェアのアップグレードは、システム全体を新しいベースバージョンに移行するために行われます。これにはノードのパーティション分割が含まれ、既存のフィックスパックデータはすべてリセットされます。

メモ

ファームウェアのアップグレード後、すべてのフィックスパックの履歴とパッケージはリセットされます。

1. ファームウェア一覧ページに移動してください。 ホーム > メンテナンス > 更新 > ファームウェア一覧 タブに移動します。

2. ファームウェアファイルとMD5チェックサムファイルをアップロードしてください。

   1. 「ファームウェアのアップロード」をクリックします。

   2. 「コンピュータからアップロード」をクリックし、ファームウェアファイルを選択してください。

   3. 「チェックサムを選択」をクリックして、チェックサムファイルをアップロードしてください

   4. ファイルを選択したら、アップロードを開始するには**[完了]**をクリックしてください。

      :::注

      アップロード時にMD5チェックサム検証に失敗した場合は、ファイルの整合性を確認してください。

      :::

3. アップグレードを開始するには、**[更新]**をクリックしてください。

4. クラスタのロールイングアップグレードをシステムに影響を与えずに実行するには、**「ロールイング更新」**チェックボックスをクリックしてください。

   警告

   これにより、ローリング方式によるクラスタのダウンタイムのない運用が可能になります。 これがないと、クラスタは同時に再起動します。

   • 各ノードは1つずつ更新されます。
   • システムは、サービスの中断を防ぐため、更新前にノードからVMを自動的に移動させます。

5. アップデートの状況を確認してください：システムは、すべてのノードで並列ファームウェア更新（パーティション分割フェーズ）を開始します。

   • ローリングアップグレードを選択すると、すべてのノードでパーティション分割フェーズが完了した後、ローリング手順が自動的に開始されます。
   • ノードに障害が発生した場合。 たとえば、VMの避難に失敗した場合、自動ローリングアップグレードは直ちに停止します。 この問題を解決するには、CubeCOSのログを確認して原因を特定してください。 続行しても問題ない場合は、**「とにかく続行」**をクリックしてください。

6. すべてのノードの更新が完了したら、**[完了]をクリックして[ファームウェア一覧]**ページに戻ります。

7. 表示されているバージョンが、アップロードされたバージョンと一致していることを確認してください。

CubeCOSのフィックスパックをインストールする

Fixpackは特定の問題に対するパッチを提供しており、システム全体のバージョンを変更することなくインストールやロールバックが可能です。

1. 修正パッチ一覧ページに移動してください。 ホーム > メンテナンス > 更新 > フィックスパック一覧 を選択します。

2. フィックスパックファイルとMD5チェックサムファイルをアップロードしてください。

   1. 「修正パックのアップロード」をクリックします。

   2. 「コンピュータからアップロード」をクリックし、フィックスパックファイルを選択してください。

   3. 「チェックサムを選択」をクリックして、チェックサムファイルをアップロードしてください

   4. ファイルを選択したら、アップロードを開始するには**[完了]**をクリックしてください。

      :::注

      アップロード時にMD5チェックサム検証に失敗した場合は、ファイルの整合性を確認してください。

      :::

3. インストール手順を開始してください。 「インストール」をクリックします。

   :::注

   最新のフィックスパックをインストールするには、まずそれ以前のすべての依存関係をインストールしておく必要があります。

   :::

4. フィックスパックの適用に再起動が必要な場合は、CubeCOSシステムを再起動してください。 「今すぐ再起動」をクリックしてください。

5. ロールバックの可能性を考慮して、フィックスパックをインストールしてください。

   • ロールバックに対応しているフィックスパックについて。
     1. 前のフィックスパックに戻すには、**「はい、ロールバック」**をクリックしてください。
     2. フィックスパックの適用に再起動が必要な場合は、チェックボックスを選択し、**「はい、インストール」**をクリックしてください。
   • ロールバックに対応していないフィックスパックについては、承諾を求めるプロンプトを表示する。 チェックボックスにチェックを入れ、「はい、インストール」をクリックしてください。

6. すべてのノードの更新が完了したら、**[完了]をクリックして、[Fixpack一覧]**ページに戻ります。

ロールバック

フィックスパックのインストールに失敗した場合（CubeCOS フィックスパックのインストール のセクションにある手順 4）、以前のバージョンにロールバックすることができます。 これは、インストール中にエラーが発生した場合にのみ必要です。

以前のバージョンに戻す

フィックスパックで問題が発生した場合は、以下の手順に従ってロールバックを行ってください。

1. 修正パッチ一覧で、削除したい修正パッチを探してください。
2. このフィックスパックにロールバックオプションが含まれていることを確認してください。
3. 「ロールバック」をクリックします。
4. 処理を完了するには、**「確認」**をクリックしてください。

トラブルシューティング

ノードに障害が発生した場合は、障害が発生したノードにログインし、次のコマンドを使用してログを確認してください：

journalctl -fu cube-cos-api

次の表は、ファームウェアのパーティション分割フェーズにおけるエラーコードと、各問題を解決するための推奨される対処法を示しています：

コード	メッセージ	推奨される対応
UPG1001	ノード node_name に接続できません	VIPノードとターゲットノード間のSSH接続を確認してください
UPG1002	ファームウェアパッケージをノード node_name に同期できませんでした	VIPノードとターゲットノードにファームウェアパッケージが存在するか確認してください
UPG2001	ファームウェアの更新に失敗しました。正常に分割されたノードは num_success/num_node のみです	CLI から更新コマンドを実行してください。
UPG2002	ターゲットパーティションが破損したため、ファームウェアの更新に失敗しました	障害が発生したノードで更新コマンドを実行してください。 それ以外の場合は、ファームウェアのソースを確認し、チェックサムとディスクの状態を検証してください
UPG2003	ファームウェアの更新が失敗し、原因不明のエラーが発生したため、調査が必要です	ファームウェアの更新が失敗し、原因不明のエラーが発生したため、調査が必要です

プレースホルダーの定義：

• num_success: パーティショニングフェーズを正常に完了したノードの数。
• num_node: クラスタ内のノードの総数。
• node-name: ノードのホスト名またはID。

情報

CLI を使用してアップデートコマンドを実行する方法の詳細については、CLI による手動アップグレード を参照してください。