> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ラック管理

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

セットアップの全体の流れは次のとおりです。

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

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

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

### ラックの登録

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

### 次のステップ

ラックを SambaRack Manager に追加できたら、[デバイス認証情報](/docs/ja/v2.0.2/sambastack/hardware-admin/sambarack-manager/srm-device-credentials.md) を設定します。

## ラックコマンド

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

### ラックの追加

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

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

```bash theme={}
snctl rack add <rack_id> --type <partnumber>
```

**パラメータ:**

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

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

**部品番号:**

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

**例 – 4-PDU ラック:**

```bash theme={}
snctl rack add 001 --type 1001934
```

**例 – 2-PDU ラック:**

```bash theme={}
snctl rack add 001 --type 1002331
```

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

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

### ラックの一覧表示

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

```bash theme={}
snctl rack list
```

**出力例 – 4-PDU ラック:**

```text theme={}
                              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 ラック:**

```text theme={}
                              Configured Racks
+---------+----------------+-------+------+-------+------------+-------------+-----+
| Rack ID | Type           | Nodes | PDUs | XRDUs | Acc Switch | Data Switch | SCS |
+---------+----------------+-------+------+-------+------------+-------------+-----+
| 001     | 1002331        | 1     | 2    | 8     | 1          | 1           | 1   |
+---------+----------------+-------+------+-------+------------+-------------+-----+
```

### ラック詳細の表示

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

```bash theme={}
snctl rack show <rack_id>
```

**例:**

```bash theme={}
snctl rack show 001
```

**出力例 – 4-PDU ラック:**

```text theme={}
                                       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 ラック:**

```text theme={}
                                       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 インベントリから削除します。

```bash theme={}
snctl rack delete <rack_id>
```

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

**例:**

```bash theme={}
snctl rack delete 001
```

## デバイスコマンド

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

### デバイスの追加・更新

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

```bash theme={}
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 を追加:

```bash theme={}
snctl rack add-device Rack/001/PDU/1 \
  --ip 192.168.10.20 \
  --user admin \
  --hostname SN40L-16-PDU1 \
  --port 3003
```

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

```bash theme={}
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
```

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

```bash theme={}
snctl rack add-device Rack/001/PDU/1 \
  --port 3004
```

### デバイスの削除

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

```bash theme={}
snctl rack delete-device <target_id> \
  --device-type <device_type> \
  [--index <index>]
```

**パラメータ:**

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

**例:**

PDU を削除:

```bash theme={}
snctl rack delete-device 001 \
  --device-type pdu \
  --index 1
```

XRDU を削除:

```bash theme={}
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 |