バージョン: 3.1

CLI を使用して手動でアップグレードを実行する

手動アップグレードモードでは、コマンドラインから直接CubeCOSのアップグレードを制御できます。この方法では、リモートでノードにログインし、システムコマンドを実行して更新プロセスを管理します。

以下の場合にのみ手動アップグレードを行ってください：

ワンクリックアップグレードが失敗しました
特定のノードを正確に制御する必要があります
現在、CubeCOS バージョン 3.0.0 を実行しています

メモ

CubeCOS バージョン 3.1.0 以降をお使いの場合は、まずワンクリックアップグレードをお試しください。

前提条件

作業を開始する前に、ワンクリックアップグレードガイドの「前提条件」および「アップグレードの手順」のセクションを確認してください。

ファームウェアファイルをアップロードしてください

アップグレードを行う前に、クラスタの状態を確認し、必要なファイルをアップロードしてください。

クラスタの正常性を確認する

アップグレードを開始する前に、クラスタの健全性を確認し、すべてのサービスが正常に動作していることを確認してください。

クラスタ管理モードに入ります。
```
cluster
```
クラスタの正常性を確認する：
```
check
```
すべてのサービスのステータスが「ok」となっていることを確認してください。

すべてのノードが正常であることを確認する

CubeCOSのUIを開きます。
ホーム > ノード に移動します。
すべてのノードが「正常」の状態になっていることを確認してください。

ファームウェアファイルをアップロード

ローカルマシンから、ファームウェアとMD5チェックサムファイルを /var/update/ ディレクトリにアップロードしてください：
```
scp <local-file-path> <your-username>@<your-cluster-ip>:/var/update/
```
置換先：
- <local-file-path>: ファームウェアまたはチェックサムファイルへのローカルパス
- <your-username>: クラスタのユーザー名
- <your-cluster-ip>: クラスタのIPアドレス
プロンプトが表示されたら、SSHパスワードを入力してください。
クラスタ内のすべてのホストに対して、アップロード操作を繰り返してください。

アップロードされたファームウェアファイルを確認する

アップグレードを開始する前に、すべてのファームウェアファイルがクラスタ内の各ホストにアップロードされていることを確認してください。

更新管理モードに入ります。
```
update
```
アップロードされたファームウェアイメージの一覧：
```
list
```
プロンプトが表示されたら、local を選択してください。このオプションは、アップロードしたファイルの保存先を指定します。

ファームウェアをインストールする

クラスタ内のすべてのホストにファームウェアをインストールしてください。

更新管理モードに入ります。
```
update
```
対話型のインストールプロセスを開始します。
```
update
```
プロンプトが表示されたら、local を選択してください。このオプションは、アップロードしたファイルの保存先を指定します。
インストールしたい画像ファイルを選択してください。
インストールを確定するには、YES と入力してください。
インストール処理が完了するまでお待ちください。

再起動前にVMを移行する

サービスの継続性を確保するため、アップグレードおよび再起動を行う前に、そのノード上のすべての仮想マシン（VM）を他のノードへ移行してください。

危険

クラスタのアップグレードはパフォーマンスに影響を与える可能性があるため、この作業はメンテナンス時間帯に行うようにしてください。

以下のコマンドは、マスターノードでのみ実行してください。

IAAS管理モードに入ります。
```
iaas
```
コンピューティング管理へのアクセス：
```
compute
```
ノードからVMを削除する：
```
upgrade_host_evacuation
```

クラスタを再起動する

ファームウェアのアップデートには再起動が必要です。

:::warning[One [時間操作]

クラスタのマスターノードでは、手動での移行のみが必要です。後続のホストでは、VMが自動的に移行され、順次再起動が行われます。

:::

マスターノードで次のコマンドを実行してください：

マスターノードで以下のコマンドを実行し、クラスタ全体のローリング再起動操作を開始します。
```
reboot
```
マスターノードがブートストラップ処理を完了すると、2番目のノードは自動的に再起動します。
再起動の前に、VMは自動的に他のノードへ移行されます。再起動後、自動ブートストラップが自動的に実行されます。
これは、クラスタ内のすべてのノードに対して実行されます。

アップグレードの確認

アップグレード後は、クラスタの健全性を確認し、すべてのサービスが正常に稼働していることを確認してください。

クラスタ管理モードに入ります。
```
cluster
```
クラスタの稼働状況を確認してください。
```
check
```

健康状態が OK であることを確認してください。次の例は、期待される出力を示しています：

          Service  Status  Report
       IaasDb      ok  [ mysql(v) ]
    Baremetal      ok  [ ironic(v) ]
       K8SaaS      ok  [ rancher(v) ]
   ObjectStor      ok  [ swift(v) ]
... # output abbreviated

すべてのノードのファームウェアバージョンを確認する

アップグレード後、各ノードのファームウェアバージョンが、アップロードしたバージョンと一致しているか確認してください。

ファームウェア管理モードに入ります。
```
firmware
```
アクティブなファームウェアパーティションのバージョンを確認してください。
```
list
```

アクティブなファームウェアのバージョンが、アップロードしたバージョンと一致していることを確認してください。次の例は、期待される出力を示しています：

1: CUBE_3.1.0_20260203-2300_be0cb70 [ACTIVE]
Firmware Version: Cube Appliance 3.1.0
Installation Date: Feb  5, 2026 11:33:20 AM
Installation Type: Re-install USB
Last Boot: Feb  5, 2026 11:46:38 AM
Comment:
2: CUBE_3.1.0_20260203-2300_be0cb70
Firmware Version: Cube Appliance 3.1.0
Installation Date: Feb  5, 2026 11:35:05 AM
Installation Type: Re-install USB
Last Boot: Never
Comment:

アップグレード後にすべてのノードを確認する

すべてのノードのステータスを確認し、稼働中で正常な状態であることを確認してください。

CubeCOSのUIを開きます。
ホーム > ノード の順に選択します。
ノード一覧から、すべてのノードのステータスを確認してください。

すべてのVMのステータスを確認する

すべてのVMのステータスを確認し、すべてがアクティブであることを確認してください。

Skyline UI を開く。
ホーム > コンピュート > インスタンス の順に選択します。
VM一覧から、すべてのVMの状態を確認してください。

前提条件​

ファームウェアファイルをアップロードしてください​

クラスタの正常性を確認する​

すべてのノードが正常であることを確認する​

ファームウェアファイルをアップロード​

アップロードされたファームウェアファイルを確認する​

ファームウェアをインストールする​

再起動前にVMを移行する​

クラスタを再起動する​

アップグレードの確認​

すべてのノードのファームウェアバージョンを確認する​

アップグレード後にすべてのノードを確認する​

すべてのVMのステータスを確認する​