バージョン: 3.0

シングルノード環境のセットアップ

制御統合型（AIO）ノードの概要

AIOノードは、コントロールプレーンサービス、コンピューティング、ネットワーク、ストレージなど、すべての主要な機能を単一のノードに統合しています。このオールインワン・デプロイメントでは、1台のマシン上でCubeCOSの全機能を利用できるため、テストや評価、あるいは小規模な環境に最適です。

AIOノードのハードウェア要件

プロセッサ

CubeCOS には、最低 8 コアおよび 16 スレッドを備えた x86-64-v2 CPU が必要です。
使用するプロセッサは、ハードウェア仮想化（Intel VT-x または AMD-V）に対応しており、かつ有効になっている必要があります。
64ビット版であり、2017年以降にリリースされたものである必要があります。

メモリ

CubeCOSのクラスタサービスには、最低128GBのRAMが必要です。
ソフトウェア定義ストレージの実利用容量1TBごとに、RAMを1.7GB追加で確保してください。

システムドライブ（SSD）

最低構成：システムドライブ用に500GBのソリッドステートドライブ（SSD）を1台。
本番環境：本番環境における冗長性と耐障害性を確保するため、2台のSSDを使用してRAID-1を構成します。

ストレージ

CubeCOSでは、ストレージプール用にSSD、HDD、またはNVMeなどの追加の永続ストレージが必要です。
CubeCOSは、以下のストレージ構成をサポートしています：
- JBOD（Just a Bunch Of Disks）
- HBA（ホスト・バス・アダプタ）
Kubernetesのワークロードには、フラッシュベース（SSD）のストレージが必要です。

インストールファイルをダウンロードする

ご希望のインストール方法に合わせて、CubeCOS GitHub リポジトリからインストールファイルをダウンロードしてください。

対応しているインストールオプション

USBメモリ：CubeCOSを直接インストールするための起動用USBイメージを作成します。
仮想メディアまたはDVD用のISO：仮想メディアを使用してISOをマウントするか、DVDに書き込んでインストールしてください。
PXEサーバー経由のネットワークブート（IMG/ISO）：IMGまたはISO形式のファイルを使用し、PXEサーバーを介してネットワーク経由でインストールします。

クラスタ情報の準備

クラスタ展開に必要な情報を準備するには、以下の表を参照してください。

CubeCOS ノードの IP アドレスとホスト名

CubeCOS ノードのホスト名	管理用IPアドレス

:::info[A サンプルプラン

CubeCOS ノードのホスト名	管理用IPアドレス
制御統合型	10.32.2.230

:::

パブリックネットワークの設定

クイックスタートガイドでは、以下のクラスタ情報を使用してください：

パブリックネットワーク：インターネットや内部リソースへのアクセスを可能にするネットワーク。
フラットネットワーク：フラットネットワークでは、ブリッジモードに設定されたイーサネットインターフェースを使用して、すべてのノード間でシームレスなネットワークトラフィックの流れを実現します。この構成は、環境に応じて、物理ホスト上の単一のネットワークアダプタを使用するか、複数のアダプタを使用するかによって実装できます。
DHCP IPプール：利用可能なDHCP IPプールは、同じフラットネットワーク内にあり、100から200の範囲です。

先に進む前に、以下の点を確認してください：

選択したサブネットは、お使いの環境内の他のネットワークと重複していません。
ゲートウェイのIPアドレスは、サブネット内からアクセス可能です。
このDHCP範囲は他のサービスで使用されておらず、想定されるVMインスタンス用に十分なIPアドレスが確保されています。
必要に応じて外部からのアクセス（インターネットや上流ルーターなど）を許可できるよう、CIDRおよびゲートウェイは正しく設定されています。

パブリックネットワークの設定は、cluster set_ready プロセス中に実施します。

警告

ネットワーク環境に合わせて、パブリックネットワークおよびDHCPのIPアドレス範囲を変更してください。

パブリックネットワークのCIDR	パブリックネットワークのゲートウェイアドレス	DHCP IPプール範囲

:::info[Sample パブリックネットワーク設定

パブリックネットワークのCIDR	パブリックネットワークのゲートウェイアドレス	DHCP IPプール範囲
10.32.0.0/16	10.32.0.254	10.32.2.100～10.32.2.200

:::

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

インストールメディアを準備し、対象マシンを起動した後。インストールプロセスを開始します。

ログインして復元プロセスを開始してください

情報

セットアップを開始する前に、ネットワーク設定を確認してください：

割り当てられたIPアドレスが正しいサブネットの範囲内にあることを確認してください。
CIDR表記が意図したネットワークマスクを反映していることを確認してください（例：255.255.255.0の場合は/24）。
対象ネットワーク内でIPアドレスの競合がないことを確認してください。

危険

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

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

uefi-installer のログインプロンプトで、以下の認証情報を入力してください。
1. ユーザー名: admin
2. パスワード: admin
restore を実行して、インストールを開始してください。インストーラは、利用可能なディスクの一覧を表示します。対象ディスクのインデックスを入力し、YESと入力して確定してください。
```
uefi-installer> restore
 1: sda   238.5G   INTEL
 2: sdb   476.9G   SQF-S25V2-512GDSDC
Enter index: 1
Restoring CUBE_<version> on /dev/sda
Enter 'YES' to confirm: YES
```
情報
複数のディスクが搭載されているノードでは、オペレーティングシステム用に使用するディスクを選択してください。追加のディスクはすべて、ストレージプールに使用されます。

「画像が見つかりません」エラーの解決方法
インストーラーから hex_install: Error: No images found というエラーが表示された場合は、「No images found」エラーの解決方法の手順に従って問題を解決してください。
インストールが完了したら、次のコマンドでシステムを再起動してください：
1. YES と入力して確認してください
```
reboot
```

CubeCOS コンソールからの開始

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

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

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

ユーザー名: 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が不要な場合は、特定のインターフェースのIPアドレスを設定するへ進んでください。

    -- 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アドレスを設定する

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

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

CubeCOSの管理用IPアドレスの固定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-management-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: <your-dns-server>

タイムゾーンを設定する

情報

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

タイムゾーンを設定するには、オプション 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ノードの役割を設定する

シングルノード環境では、「コントロール・コンバージド」ロールを選択してください。この役割は、コントロールプレーン、コンピューティング、およびストレージの機能を単一のホスト上に統合したものです。

    -- 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 control-converged role
    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 bridge
    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）はサポートされていません

n キーを押してこの手順をスキップしてください：

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

ポリシー申請を開始

先に進む前に、設定の概要を注意深く確認してください。必要に応じて設定を変更できます。

インストールを開始する準備ができたら、オプション 1 を選択して設定を適用してください：

    Summary
    Password has not been modified.
    Host name: control-converged
    IF.1
        Default interface.
        IPv4 Mode: Manual
        IPv4 Address: 10.32.2.230
        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: disabled
    1: Accept the configuration
    2: Cancel the configuration
    3: Modify the configuration

    Select option: 1

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

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

Verify コンソールでの成功

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

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

再ログイン後、コンソールのステータス画面には、ノードの状態が services ready であり、ロール数は 1 x control、1 x compute、1 x storage であると表示されます。

クラスタを初期化する

cluster set_ready CLI コマンドを実行して、システムを初期化します。この手順は、単一のノードを稼働状態にするために必要です。

このコマンドは、以下の手順でクラスタを稼働状態に準備します：

ストレージデバイスの確認と有効化。
ストレージレプリケーションポリシーの適用（シングルノードトポロジーに合わせて調整済み）。
コアプラットフォームサービス（コンピューティング、ネットワーク、ストレージ、ID管理、監視など）の初期化を行います。
共有外部ネットワークの設定。

警告

cluster set_ready は 1 回だけ実行してください。少なくとも1つのCeph OSDが最初にup状態になっている必要があります。そうでない場合、コマンドは「set_ready aborted due to zero running osd for cluster storage」というエラーで中止されます。

パブリックネットワークの設定で準備したパブリックネットワークの設定を指定してください。引数として set_ready [<CIDR>] [<gateway>] [<IP,IP-IP>] を指定するか、プロンプトが表示された際にその場で値を入力することができます。

    control-converged> cluster
    control-converged:cluster> set_ready 10.32.0.0/16 10.32.0.254 10.32.1.100-10.32.1.110
    Storage disk configurations.
    ============================================================
    GROUP: default
    ID  CLASS  WEIGHT   TYPE NAME                   STATUS  REWEIGHT  PRI-AFF
    -1         0.46500  root default
    -3         0.46500      host control-converged
     0    ssd  0.23250          osd.0                   up   1.00000  1.00000
     1    ssd  0.23250          osd.1                   up   1.00000  1.00000
    [1/6] Updating storage replication rule
    [2/6] Checking SDN services
    [3/6] Configuring modules
    (1/5) processing: cube_last
    (2/5) processing: octavia
    (3/5) processing: influxdb
    (4/5) processing: opensearch-dashboards
    (5/5) processing: kafka
    [4/6] Starting cluster
    [5/6] Strengthening password
    [6/6] Cluster check and repair
    Done

「Done」と表示され、すべてのサービスが「ok」を報告したら、クラスターの準備が完了します。

メモ

「[5/6] パスワードの強化」のステップにおいて、CubeCOS はデフォルトの admin パスワードを [email protected] という形式のパスワードに置き換えます。ここで、xxx.xxx はクラスタの VIP の最後の 2 オクテットです。たとえば、VIPが「10.32.1.200」の場合、パスワードは「[email protected]」となります。今後のログイン時には、このパスワードを使用してください。

デプロイメントの確認

ノードが正常であることを確認します：

コンソールのステータス画面には、「services ready」および「1 x コントロール / 1 x コンピューティング / 1 x ストレージ」と表示されています。
ストレージは正常です。rootシェルから ceph -s を実行すると、health: HEALTH_OK と表示されます（[1/6] ストレージのレプリケーションルールを更新中 のステップでは、set_ready 実行前に単一ホストで発生すると予想される undersized/degraded 警告が解消されます）。

管理インターフェースにアクセスする

お使いのコンピュータでブラウザを開いてください。
https://<your-management-ip-address>（例：https://10.32.1.200）にアクセスしてください。
以下のアカウントでログイン：
1. ユーザー名: admin
2. パスワード：セットアップ時に設定したパスワード、または set_ready によって生成されたデフォルトの [email protected]。
ログイン後、Web UI を通じて CubeCOS 環境を管理できます。

トラブルシューティング

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

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

:::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

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

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

インストールパーティションを /mnt/install にマウントします。
```
mount /dev/sdd1 /mnt/install
```

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

# 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>

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

制御統合型（AIO）ノードの概要​

AIOノードのハードウェア要件​

プロセッサ​

メモリ​

システムドライブ（SSD）​

ストレージ​

インストールファイルをダウンロードする​

対応しているインストールオプション​

クラスタ情報の準備​

CubeCOS ノードの IP アドレスとホスト名​

パブリックネットワークの設定​

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

ログインして復元プロセスを開始してください​

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

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

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

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

パスワードを変更する​

ホスト名を設定する​

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

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

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

DNS サーバーの設定​

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

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

高可用性の設定​

ポリシー申請を開始​

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

クラスタを初期化する​

デプロイメントの確認​

管理インターフェースにアクセスする​

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

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

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

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

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

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

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