メインコンテンツにスキップ
cubecos
バージョン: 3.0

CubeCOSのインストール

CubeCOSのインストールは、以下の手順で行います。

  1. イメージの復元（インストール）：エンドポイントの対象デバイスにCubeCOSを復元（インストール）します。
  2. ロールの設定：クラスタ構成に合わせてノードにロールを割り当て、ネットワーク情報を設定し、必要に応じて高可用性を設定します。
  3. クラスタの設定：インストールとノードの役割設定、SDSの初期化、およびCubeCOSのクラスタ設定サービスの完了後、クラスタはset_readyの状態になります。

CubeCOSのインストールに必要な前提条件​

情報

インストールを進める前に、ハードウェアおよびネットワークの要件が満たされていることを確認してください。

インストールファイルのダウンロード​

CubeCOS GitHub リポジトリ にアクセスし、選択したインストール方法に応じたインストールファイルをダウンロードしてください。

CubeCOSは、以下のインストール方法に対応しており、それぞれのインストールメディアを提供しています：

  • USBフラッシュドライブからのイメージ：USBデバイスから直接起動してインストールします。
  • 仮想メディアまたはDVD用のISO：インストールを行うには、仮想メディアを使用してISOをマウントするか、物理的なDVDに書き込んでください。
  • PXEサーバー経由のネットワークブート（IMG/ISO）：PXEサーバーを使用して、イメージまたはISO形式のファイルでネットワーク経由に展開します。

インストールプロセスを開始します​

選択したインストールメディアの準備が完了し、対象マシンをそこから起動したら、インストール手順に進んでください。

ログインしてCubeCOSを設定に復元する​

情報

セットアップを開始する前に、IPアドレスとIP CIDRの設定を確認してください。 以下の点を確認してください：

  • 割り当てられたIPアドレスは、正しいサブネットの範囲内にあります。
  • CIDR表記は、意図されたネットワークマスクを正確に反映しています（例：255.255.255.0の場合は/24）。
  • 対象ネットワーク内にはIPアドレスの競合はありません。
危険

復元操作を行うと、選択したディスク上のすべてのデータが消去されます。

作業を進める前に、重要なデータはすべてバックアップしてください。

  1. uefi-installer のログインプロンプトで、以下の認証情報を入力してください。

    1. ユーザー名: admin
    2. パスワード: admin

  2. インストールを開始するには、次のコマンドを実行してください：

    1. プロンプトが表示されたら、対象のパーティションを選択してください

    2. YES と入力して確認してください

      restore
    「画像が見つかりません」エラーの解決方法

    インストーラーから hex_install: Error: No images found というエラーが表示された場合は、「No images found」エラーの解決方法の手順に従って問題を解決してください。

  3. インストールが完了したら、次のコマンドでシステムを再起動してください：

    1. YES と入力して確認してください

      reboot
single-node-functions

CubeCOS コンソールからの開始​

restore プロセスが完了し、再起動すると、CubeCOS のセットアップ画面が表示されます。

セットアップを開始するには、F2 キーを押してください。

cubecos_3_0_console-image

インストールを開始するにはログインしてください​

デフォルトの認証情報を使用してログインしてください：

  • ユーザー名: admin
  • パスワード：admin

セットアップオプションを選択してください - ウィザード​

対話型セットアップウィザードを起動するには、1 を入力してください。

    First Time Setup Options:
    1: Wizard
    2: Advanced
    Enter index: 1

利用許諾契約書（EULA）をお読みの上、同意してください​

画面の指示に従って、利用規約を読み、同意してください。

    -- Welcome --
    Welcome to the Cube Appliance setup wizard.
    Using this setup wizard, you can:
    * View and accept the Software License Agreement
    * Set the appliance password
    * View and configure networking

    Press Enter to continue.

    -- Software License Agreement --
    Currently selected language: English
    1: Select language for license display
    2: Read Bigstack terms
    3: Read non-Bigstack terms
    4: Proceed to acceptance

    Select option: 4

    By choosing 'I agree,' you agree that (1) you have had the opportunity to
    review the terms of licenses presented above and (2) such terms govern this
    transaction. If you do not agree, choose 'I do not agree'.
    1: I agree
    2: I do not agree

    Select option: 1

パスワードを変更する​

デフォルトでは、CubeCOSはset_readyの実行後にパスワードを更新します。 形式は [email protected] であり、ここで xxx.xxx はクラスタのVIPの最後の2オクテットを表します。

メモ

クラスタのVIPが 192.168.100.100 の場合、更新後のデフォルトパスワードは次のようになります： [email protected]。

パスワードを手動で変更するには：

    -- Appliance Password --
    Password changes are applied immediately.
    Password has not been modified.
    1: Change password
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 1

    - Change Password -
    Enter old password: admin
    Enter new password:
    Confirm new password:
    Password successfully changed.

ホスト名を設定する​

警告

有効なホスト名は小文字で記述する必要があり、特殊文字（!@#$%^&*()）、アンダースコア（_）、またはスペースを含めることはできません。

有効なホスト名は、以下の条件を満たす必要があります：

  • 小文字（a-z）、数字（0-9）、およびハイフン（-）のみを含めること
  • 長さは64文字以内にしてください
  • ネットワークの中で独自の存在感を放つ
  • 必ず文字で始める必要があります
  • 完全に数値ではない
    -- Host Name Configuration --
    Host name: unconfigured
    1: Change the host name
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 1

    - Change the Host Name -
    Enter the new host name: control-converged

    -- Host Name Configuration --
    Host name: control-converged
    1: Change the host name
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

[オプション] ネットワークボンディングの設定​

ネットワークボンディングはオプションであり、ネットワークの冗長性が必要な環境でのみ必須となります。 ネットワーク設定のオプションや導入シナリオについて詳しく知りたい場合は、ネットワーク設定のセクションを参照してください。

ボンディングやVLANが不要な場合は、特定のインターフェースのIPアドレスを設定する へ進んでください。

情報

ネットワークケーブルが接続されている場合、[Speed] 列にリンクの状態（例：1000Mb/s、10Gb/s）が表示されます。 ケーブルが検出されない場合は、「N/A」と表示されます。

警告

ボンディングインターフェース名として、bond0、bond1、bondx、bd0 などのシステム予約名を指定しないでください。

    -- Network Bonding Settings --
    ---------------------------------------------------
       Label   BusID/Slaves     Driver  State    Speed
    ---------------------------------------------------
        IF.1   0000:04:00.0      r8169     UP    1000F
    ---------------------------------------------------
    1: Display policy
    2: Configure network bonding
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

[オプション] VLAN の設定​

VLANタグ付けが必要ない場合は、この手順をスキップしてください。

    -- VLAN Settings --
    ---------------------------------------------------
       Label   BusID/Slaves     Driver  State    Speed
    ---------------------------------------------------
        IF.1   0000:04:00.0      r8169     UP    1000F
    ---------------------------------------------------
    1: Display policy
    2: Configure vlan network
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

特定のインターフェースにIPアドレスを設定する​

プライマリインターフェースに静的なIPv4アドレス、サブネットマスク、およびデフォルトゲートウェイを割り当てます。 このガイドでは、IF.1 というラベルが付けられた単一のネットワークインターフェースを前提としています。

先に進む前に、以下の情報をご用意ください：

  • CubeCOS管理用VIPの固定IPアドレス
  • 管理ネットワークのサブネットマスク
  • サブネットのデフォルトゲートウェイ
  • 使用するDNSサーバーのIPアドレス
    -- Networking Settings --
    ---------------------------------------------------
       Label   BusID/Slaves     Driver  State    Speed
    ---------------------------------------------------
        IF.1   0000:04:00.0      r8169     UP    1000F
    ---------------------------------------------------
    1: Display device status
    2: Display policy
    3: Configure IF.1
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 3

    - Configure IF.1 -
    Enter the IPv4 address: <your-cluster-ip-address>
    Enter the IPv4 subnet mask: <your-subnet-mask>
    Enter the IPv4 default gateway: <your-gateway-address>

    -- Networking Settings --
    ---------------------------------------------------
    Label   BusID/Slaves     Driver  State    Speed
    ---------------------------------------------------
        IF.1   0000:04:00.0      r8169     UP    1000F
    ---------------------------------------------------
    1: Display device status
    2: Display policy
    3: Configure IF.1
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

DNS サーバーの設定​

CubeCOSが使用するDNSサーバーを入力してください。内部または外部のDNSリゾルバーを指定できます。 使用するDNSサーバーを最大3つまで設定してください。 以下の例は、外部DNSサーバーを1.1.1.1に設定するためのものです。

    -- DNS Configuration --
    No DNS servers configured.
    1: Set DNS server 1
    2: Set DNS server 2
    3: Set DNS server 3
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 1

    - Set DNS Server 1 -
    Enter the DNS server IP address: 1.1.1.1

タイムゾーンを設定する​

情報

クラスタ内のすべてのノードで同じタイムゾーンを設定してください。 正確な時刻管理は、サービスの調整、ログのタイムスタンプの正確性の確保、および同期の問題を回避するために不可欠です。

タイムゾーンを設定するには、オプション 1 を選択してください。

    -- Time Configuration --
    Time configuration changes are applied immediately.
    Time Zone: America/New_York
    Date: 05/29/2025
    Time: 14:00:37
    1: Change the time zone
    2: Change the date
    3: Change the time
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 1

CubeCOSノードの役割を設定する​

CubeCOSのアーキテクチャおよびノードの役割について詳しくは、アーキテクチャのセクション または 役割のセクション を参照してください。

    -- Cube Role --
    Current role: undef
    Current Management: IF.1
    Current Domain/Region: default/RegionOne
    Current Cube Secret Seed: N/A
    1: Change role
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 1

プロンプトが表示されたら、以下の値を入力してください：

警告

クラスタのシークレットシードは、暗号値の生成における入力変数として機能します。 クラスタ間の通信と暗号処理の安全性を確保するため、一意かつ強力な値を設定してください。

    - Change Role -
    Select a role:
    1: control
    2: compute
    3: storage
    4: control-converged
    5: edge-core
    6: moderator
    Enter index: 4                                          # Select the desired role, control-converged is selected for example
    Specify external IP/domain [optional]:                  # Leave blank
    Specify management interface: IF.1                      # Interface for control/API traffic
    Specify provider interface: IF.1                        # Interface for VM data and external traffic
    Specify overlay interface: IF.1                         # Interface used for internal SDN tunnel traffic
    Specify storage interface [frontend(,backend)]: IF.1    # Interface for Ceph traffic
    Specify region ("RegionOne"):                           # Keep default or customize as needed
    Specify cluster secret seed: <replace-with-your-secret> # Unique secret shared among nodes in the same cluster
    Specify management CIDR ("10.254.0.0/16"):              # (Optional) Change only if there is a subnet conflict, must be /16 subnet

高可用性の設定​

メモ

シングルノード環境では、高可用性（HA）はサポートされていません

HAを使用しない単一ノードでのデプロイを行う場合は、n キーを押して設定をスキップしてください。

3ノードのクラスタで高可用性を有効にし、フォールトトレランス機能を提供します。

オプション「1」を選択して、「HAの変更」を選択してください。 次に、高可用性キューブの有効化について「はい」と回答してください。

    -- Cube High Availability --
        Current HA setting: disabled
        1: Change HA
        x: Exit
        p: Previous screen
        n: Next screen

        Select option: 1

        - Change HA -
        High Available Cube:
        1: Yes
        2: No
        Enter index: 1

オプション n を選択して続行してください。

        Specify control virtual Hostname: <cluster-virtual-hostname>
        Specify control virtual IP: <cluster-virtual-ip>
        Specify control group hostname [HOST,HOST,...]: <control-node-hostname-1>,<control-node-hostname-2>,<control-node-hostname-3>
        Specify control group address [IP,IP,...]: <control-node-ip-1>, <control-node-ip-2>, <control-node-ip-3>

        -- Cube High Availability --
        Current HA setting: enabled
        Current Control Virtual Hostname: ccvip                                   # sample output
        Current Control Virtual IP: 10.32.2.230                                   # Sample output
        Current Control Group: cc1(10.32.2.231),cc2(10.32.2.232),cc3(10.32.2.233) # example output
        1: Change HA
        x: Exit
        p: Previous screen
        n: Next screen

        Select option: n

ポリシーの適用とクラスタの初期化を開始​

CubeCOSクラスタのデプロイメントでは、最初に初期化されたコントロールホストがマスターノードとなります。 このノードは、コアサービスの初期化を行い、クラスタのベース構成を適用する役割を担っています。

:::danger[Apply をクリックし、マスターノードポリシーアプリケーションを確認します。

最初の制御ノードがポリシーの適用を完了するまで、追加の制御ノードの処理を進めないでください。

マスターノードの処理が完了する前に他のノードを起動すると、次のような結果になる可能性があります：

  • サービスの登録に失敗しました
  • 構成のずれ
  • クラスタの不安定性または状態の不整合

:::

マスターノードの設定が完了し、「ポリシーの適用に成功しました（Policy changes were successfully applied）」というメッセージが表示されたら、残りの2つのコントロールノードでも安全に設定を受け入れることができます。

以下は、デプロイ時に使用される完全な設定例です。

    Summary
    Password has not been modified.
    Host name: control-converged
    IF.1
        Default interface.
        IPv4 Mode: Manual
        IPv4 Address: 10.32.2.231
        IPv4 Netmask: 255.255.0.0
        IPv4 Gateway: 10.32.0.254
        IPv6 Mode: Automatic
    DNS server 1: 1.1.1.1
    Time Zone: Asia/Taipei
    Date: 05/29/2025
    Time: 14:54:19
    Role: control-converged
    External IP/Domain: N/A
    Management: IF.1
    Provider: IF.1
    Overlay: IF.1
    Storage: IF.1
    Domain/Region: default/RegionOne
    Cube Secret Seed: bigstack
    Management CIDR: 10.254.0.0/16
    High Availability: enabled
    Control Virtual Hostname: ccvip
    Control Virtual IP: 10.32.2.230
    Control Group: cc1(10.32.2.231),cc2(10.32.2.232),cc3(10.32.2.233)
    High Availability: disabled
    1: Accept the configuration
    2: Cancel the configuration
    3: Modify the configuration

    Select option: 1

設定の適用にかかる時間は、システムのハードウェア性能によって異なる場合があります。

コンソールの出力を確認してください。 処理が正常に完了すると、確認メッセージが表示されます。

Verify コンソールでの成功

ポリシーの変更が正常に適用されました。

ポリシー変更を適用するには、一度ログアウトしてから再ログインしてください​

ポリシーが正常に適用されたら、コンソールから一度ログアウトし、再度ログインして、変更が有効になり、インターフェースに反映されていることを確認してください。

トラブルシューティング​

誤った設定を修正してください。​

設定に誤りがある場合、インストールは失敗し、エラーメッセージが表示されます。

:::caution[Reboot [必須]

再試行する前に、ノードが再起動するのを待ってください。 再起動後、設定内容を慎重に確認し、必要な修正を行った上で、インストールを再度試みてください。

:::

    Policy changes could not be applied. System must be rebooted.
    Press enter to continue:

「画像が見つかりません」エラーの解決方法​

restore コマンドが次のエラーを返す場合、インストーラはインストールメディアを検出できません：

uefi-installer> restore
hex_install: Error: No images found
Unexpected error
uefi-installer>

この問題を解決するには、以下の手順に従ってインストールメディアを手動でマウントしてください。

インストーラのCLIを終了し、rootシェルを開きます​

インストーラのCLIを終了し、rootとしてログインします：

uefi-installer> exit

ログインプロンプトで、以下の認証情報を入力してください：

  • ユーザー名: root
  • パスワード： admin
uefi-installer login: root
Password:
Last login: Mon Jul 11 06:49:03 on ttyS0
Welcome to the Cube Appliance Installer
#

lsblk コマンドでブロックデバイスを確認する​

lsblk を実行してブロックデバイスを特定し、インストールメディアがマウントされているか確認します：

# lsblk
lsblk-command

インストール用USBドライブ（例：sdd1）にマウントポイントが表示されていない場合は、次の手順に進んでください。

インストールメディアを手動でマウントする​

  1. インストールパーティションを /mnt/install にマウントします。

    mount /dev/sdd1 /mnt/install

  2. マウントの結果を確認してください。

    # lsblk
    NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
    sda      8:0    0 744.6G  0 disk
    ├─sda1   8:1    0  1000M  0 part
    ├─sda2   8:2    0     2G  0 part
    ├─sda5   8:5    0 357.4G  0 part
    ├─sda6   8:6    0 357.4G  0 part
    └─sda7   8:7    0  26.9G  0 part
    sdb      8:16   0   5.1T  0 disk
    ├─sdb1   8:17   0   400M  0 part
    ├─sdb2   8:18   0   400M  0 part
    ├─sdb3   8:19   0   2.6T  0 part
    └─sdb4   8:20   0   2.6T  0 part
    sdc      8:32   0   5.1T  0 disk
    ├─sdc1   8:33   0   400M  0 part
    ├─sdc2   8:34   0   400M  0 part
    ├─sdc3   8:35   0   2.6T  0 part
    └─sdc4   8:36   0   2.6T  0 part
    sdd      8:48   1  28.7G  0 disk
    └─sdd1   8:49   1   5.7G  0 part /mnt/install
    sr0     11:0    1  1024M  0 rom
    sr1     11:1    1  1024M  0 rom

    sdd1 のマウントポイントが /mnt/install になっていることを確認してください。

インストーラーのCLIに戻り、インストールを再開します​

インストールを再開するには、admin ユーザーに戻ってください：

# su admin
Welcome to the Cube Appliance Installer
Welcome to the Cube Appliance
Enter "help" for a list of available commands
uefi-installer>

インストールの開始 に戻り、続行してください。