SambaRack Manager のラック管理 - SambaNova ドキュメント

本ガイドでは、SambaRack Manager を使用したラックおよびラック内デバイスの追加、表示、管理について説明します。新規インストール時の作業と、その後の継続的な管理作業の両方を扱います。セットアップの全体の流れは次のとおりです。

SambaRack Manager ソフトウェアのインストール
初期セットアップと動作確認
SambaRack Manager インベントリへの SambaRack の追加 (このページ)
SambaRack Manager でのデバイス認証情報の設定

新規インストールの場合

SambaRack Manager を初めてセットアップする場合は、以下の手順を実施してください。

ラックの登録

snctl rack add コマンドを使用して、設置済みのすべての SambaRack ユニットをインベントリに追加します。詳細はラックの追加をご参照ください。

次のステップ

ラックを SambaRack Manager に追加できたら、デバイス認証情報を設定します。

ラックコマンド

SambaRack Manager インベントリ内のラックを管理するには、以下のコマンドを使用します。

ラックの追加

部品番号 (part number) の構成に基づいて、新しいラックをインベントリに追加します。

ラックをインベントリに追加する前に、ラックの電源がオンで、完全に動作可能な状態になっている必要があります。

snctl rack add <rack_id> --type <partnumber>

パラメータ:

パラメータ	説明
`<rack_id>`	追加するラックの ID (例: `001`)
`--type`	ラックの部品番号。サポートされる値: `1001934` (4-PDU SN40L-16)、`1002331` (2-PDU SN40L-16)

設置されている SambaRack の正しい部品番号を確認するには、SambaNova サポートポータルの該当するナレッジベース記事をご参照ください。

部品番号:

部品番号	構成
`1001934`	4 PDU 構成の SambaRack SN40L-16
`1002331`	2 PDU 構成の SambaRack SN40L-16

例 – 4-PDU ラック:

snctl rack add 001 --type 1001934

例 – 2-PDU ラック:

snctl rack add 001 --type 1002331

このコマンドは、部品番号の構成に基づいて、以下のコンポーネントを持つラックを作成します。

ノード
PDU (構成に応じて 2 台または 4 台)
ノードごとの XRDU (通常はノードあたり 8 台)
アクセススイッチ
データスイッチ
シリアルターミナル

ラックの一覧表示

インベントリ内の設定済みのすべてのラックを表示します。

snctl rack list

出力例 – 4-PDU ラック:

                              Configured Racks
+---------+----------------+-------+------+-------+------------+-------------+-----+
| Rack ID | Type           | Nodes | PDUs | XRDUs | Acc Switch | Data Switch | SCS |
+---------+----------------+-------+------+-------+------------+-------------+-----+
| 001     | 1001934        | 1     | 4    | 8     | 1          | 1           | 1   |
| 002     | 1001934        | 1     | 4    | 8     | 1          | 1           | 1   |
+---------+----------------+-------+------+-------+------------+-------------+-----+

出力例 – 2-PDU ラック:

                              Configured Racks
+---------+----------------+-------+------+-------+------------+-------------+-----+
| Rack ID | Type           | Nodes | PDUs | XRDUs | Acc Switch | Data Switch | SCS |
+---------+----------------+-------+------+-------+------------+-------------+-----+
| 001     | 1002331        | 1     | 2    | 8     | 1          | 1           | 1   |
+---------+----------------+-------+------+-------+------------+-------------+-----+

ラック詳細の表示

特定のラックとそのコンポーネントに関する詳細情報を表示します。

snctl rack show <rack_id>

例:

snctl rack show 001

出力例 – 4-PDU ラック:

                                       Rack Details: 001
+---------------------------+--------------------+----------------+------+----------+
| Component                 | Hostname           | IP             | Port | Username |
+---------------------------+--------------------+----------------+------+----------+
| Rack/001/AccessSwitch/0   | SN40L-16-ACCSW     | 192.168.10.240 | 3001 | root     |
| Rack/001/DataSwitch/0     | SN40L-16-DATASW    | 192.168.10.241 | 3002 | root     |
| Rack/001/PDU/1            | SN40L-16-PDU1      | 192.168.10.20  | 3003 | admin    |
| Rack/001/PDU/2            | SN40L-16-PDU2      | 192.168.10.21  | 3004 | admin    |
| Rack/001/PDU/3            | SN40L-16-PDU3      | 192.168.10.22  | 3005 | admin    |
| Rack/001/PDU/4            | SN40L-16-PDU4      | 192.168.10.23  | 3006 | admin    |
| Rack/001/SerialTerminal/0 | SN40L-16-SCS       | 192.168.10.20  |      | sysadmin |
| Rack/001/Node/0/Host      | SFT-SN40L-16-H-1   | 192.168.4.1    | 3024 | root     |
| Rack/001/Node/0/BMC       | SN40L-16-H-1-SP    | 192.168.5.1    |      | admin    |
| Rack/001/Node/0/XRDU/0    | SN40L-16-H-1-XRDU0 | 192.168.6.1    | 3026 | root     |
| Rack/001/Node/0/XRDU/1    | SN40L-16-H-1-XRDU1 | 192.168.7.1    | 3025 | root     |
| Rack/001/Node/0/XRDU/2    | SN40L-16-H-1-XRDU2 | 192.168.8.1    | 3023 | root     |
| Rack/001/Node/0/XRDU/3    | SN40L-16-H-1-XRDU3 | 192.168.9.1    | 3023 | root     |
| Rack/001/Node/0/XRDU/4    | SN40L-16-H-1-XRDU4 | 192.168.10.1   | 3016 | root     |
| Rack/001/Node/0/XRDU/5    | SN40L-16-H-1-XRDU5 | 192.168.11.1   | 3015 | root     |
| Rack/001/Node/0/XRDU/6    | SN40L-16-H-1-XRDU6 | 192.168.12.1   | 3013 | root     |
| Rack/001/Node/0/XRDU/7    | SN40L-16-H-1-XRDU7 | 192.168.13.1   | 3012 | root     |
+---------------------------+--------------------+----------------+------+----------+

出力例 – 2-PDU ラック:

                                       Rack Details: 001
+---------------------------+--------------------+----------------+------+----------+
| Component                 | Hostname           | IP             | Port | Username |
+---------------------------+--------------------+----------------+------+----------+
| Rack/001/AccessSwitch/0   | SN40L-16-ACCSW     | 192.168.10.240 | 3001 | root     |
| Rack/001/DataSwitch/0     | SN40L-16-DATASW    | 192.168.10.241 | 3002 | root     |
| Rack/001/PDU/1            | SN40L-16-PDU1      | 192.168.10.20  | 3003 | admin    |
| Rack/001/PDU/2            | SN40L-16-PDU2      | 192.168.10.21  | 3004 | admin    |
| Rack/001/SerialTerminal/0 | SN40L-16-SCS       | 192.168.10.20  |      | sysadmin |
| Rack/001/Node/0/Host      | SFT-SN40L-16-H-1   | 192.168.4.1    | 3024 | root     |
| Rack/001/Node/0/BMC       | SN40L-16-H-1-SP    | 192.168.5.1    |      | admin    |
| Rack/001/Node/0/XRDU/0    | SN40L-16-H-1-XRDU0 | 192.168.6.1    | 3026 | root     |
| Rack/001/Node/0/XRDU/1    | SN40L-16-H-1-XRDU1 | 192.168.7.1    | 3025 | root     |
| Rack/001/Node/0/XRDU/2    | SN40L-16-H-1-XRDU2 | 192.168.8.1    | 3023 | root     |
| Rack/001/Node/0/XRDU/3    | SN40L-16-H-1-XRDU3 | 192.168.9.1    | 3023 | root     |
| Rack/001/Node/0/XRDU/4    | SN40L-16-H-1-XRDU4 | 192.168.10.1   | 3016 | root     |
| Rack/001/Node/0/XRDU/5    | SN40L-16-H-1-XRDU5 | 192.168.11.1   | 3015 | root     |
| Rack/001/Node/0/XRDU/6    | SN40L-16-H-1-XRDU6 | 192.168.12.1   | 3013 | root     |
| Rack/001/Node/0/XRDU/7    | SN40L-16-H-1-XRDU7 | 192.168.13.1   | 3012 | root     |
+---------------------------+--------------------+----------------+------+----------+

ラックの削除

ラックと、それに関連付けられたノードを SambaRack Manager インベントリから削除します。

snctl rack delete <rack_id>

この操作は、ラック、そのノード、および関連するすべてのデバイスを SambaRack Manager インベントリから完全に削除します。SambaRack Manager からラックを削除しても、SambaStack クラスターからは削除されません。

例:

snctl rack delete 001

デバイスコマンド

ラック内の個々のデバイスを管理するには、以下のコマンドを使用します。

デバイスの追加・更新

ラックに新しいデバイスを追加するか、既存のデバイスを更新します。

snctl rack add-device <device_path> \
  [--ip <ip_address>] \
  [--user <username>] \
  [--password <password>] \
  [--hostname <hostname>] \
  [--port <port>] \
  [--index <index>] \
  [--ask-pass] \
  [--use-global-secret]

パラメータ:

パラメータ	説明
`<device_path>`	デバイスへのパス。デバイスパスの形式をご参照ください。
`--ip`	デバイスの IP アドレス
`--user`	デバイスのユーザー名
`--password`	デバイスのパスワード (指定しない場合はプレースホルダを使用)
`--hostname`	デバイスのホスト名
`--port`	デバイスへの接続ポート。新規デバイスの追加時に指定しない場合、ポートは `None` に設定されます。更新時に指定しない場合は、既存のポート値が維持されます。
`--index`	デバイスのインデックス。デバイスのインデックスをご参照ください。
`--ask-pass`	パスワードの入力を安全な方法で対話的に求める
`--use-global-secret`	グローバルシークレットのプレースホルダの使用を強制する

例: ポートを指定して PDU を追加:

snctl rack add-device Rack/001/PDU/1 \
  --ip 192.168.10.20 \
  --user admin \
  --hostname SN40L-16-PDU1 \
  --port 3003

ポートを指定して XRDU を追加:

snctl rack add-device Rack/001/Node/0/XRDU/0 \
  --ip 192.168.6.1 \
  --user root \
  --hostname SN40L-16-H-1-XRDU0 \
  --port 3026

既存デバイスのポートを更新:

snctl rack add-device Rack/001/PDU/1 \
  --port 3004

デバイスの削除

ラックからデバイスを削除します。

snctl rack delete-device <target_id> \
  --device-type <device_type> \
  [--index <index>]

パラメータ:

パラメータ	説明
`<target_id>`	ラック ID またはノード名
`--device-type`	削除するデバイスのタイプ。デバイスタイプをご参照ください。
`--index`	デバイスのインデックス。デバイスのインデックスをご参照ください。

例: PDU を削除:

snctl rack delete-device 001 \
  --device-type pdu \
  --index 1

XRDU を削除:

snctl rack delete-device 001 \
  --device-type xrdu \
  --index 0

デバイスリファレンス

本セクションでは、デバイスコマンドのリファレンス情報を提供します。

デバイスパスの形式

デバイスを指定する際は、以下のパス形式を使用します。

形式	説明	例
`Rack/<rack_id>/<device_type>/<index>`	ラックレベルのデバイス	`Rack/001/PDU/1`
`Rack/<rack_id>/Node/<node_index>/<device_type>/<index>`	ノードレベルのデバイス (インデックス指定あり)	`Rack/001/Node/0/XRDU/1`
`Rack/<rack_id>/Node/<node_index>/<device_type>`	ノードレベルのデバイス (インデックス指定なし。デフォルトは 0)	`Rack/001/Node/0/Host`

デバイスタイプ

以下のデバイスタイプが利用できます。 ラックレベルのデバイス:

タイプ	説明
`AccessSwitch`	アクセススイッチ
`DataSwitch`	データスイッチ
`PDU`	電源分配ユニット (Power Distribution Unit; PDU)
`SerialTerminal`	シリアルコンソールサーバー

ノードレベルのデバイス:

タイプ	説明
`Host`	ホストモジュール
`BMC`	ベースボード管理コントローラー (Baseboard Management Controller; BMC)
`XRDU`	2 基の Reconfigurable Data Unit™ (RDU) を搭載したアクセラレーターモジュール

デバイスのインデックス

デバイスタイプによって、インデックスの付け方が異なります。

デバイスタイプ	インデックス範囲	備考
PDU	1–4 (4-PDU 構成) または 1–2 (2-PDU 構成)	1 始まり
XRDU	0–7	0 始まり
その他のデバイス	0 以上	0 始まり。指定しない場合のデフォルトは 0

はじめに

サービス管理

ハードウェア管理

リファレンスアーキテクチャ

リソース

ラック管理

新規インストールの場合

ラックの登録

次のステップ

ラックコマンド

ラックの追加

ラックの一覧表示

ラック詳細の表示

ラックの削除

デバイスコマンド

デバイスの追加・更新

デバイスの削除

デバイスリファレンス

デバイスパスの形式

デバイスタイプ

デバイスのインデックス

​新規インストールの場合

​ラックの登録

​次のステップ

​ラックコマンド

​ラックの追加

​ラックの一覧表示

​ラック詳細の表示

​ラックの削除

​デバイスコマンド

​デバイスの追加・更新

​デバイスの削除

​デバイスリファレンス

​デバイスパスの形式

​デバイスタイプ

​デバイスのインデックス

新規インストールの場合

ラックの登録

次のステップ

ラックコマンド

ラックの追加

ラックの一覧表示

ラック詳細の表示

ラックの削除

デバイスコマンド

デバイスの追加・更新

デバイスの削除

デバイスリファレンス

デバイスパスの形式

デバイスタイプ

デバイスのインデックス