> ## 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 ノードの表示、管理、および DC 電源操作について説明します。

## ノードコマンド

ノードの表示と管理には、以下のコマンドを使用します。

### ノードの一覧表示

設定済みのすべてのノードとそのタイプを表示します。

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

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

```text theme={}
Configured Nodes
+-----------------+---------+---------+-------+
| Node Name       | Type    | Rack ID | Index |
+-----------------+---------+---------+-------+
| sn40l-16-001-n1 | 1001934 | 001     | 0     |
+-----------------+---------+---------+-------+
```

**出力例 - 2-PDU ラック:**

```text theme={}
Configured Nodes
+-----------------+-----------+---------+-------+
| Node Name       | Type      | Rack ID | Index |
+-----------------+-----------+---------+-------+
| sn40l-16-001-n1 | 1002331 | 001     | 0     |
+-----------------+-----------+---------+-------+
```

### ノード詳細の表示

特定のノードとそのデバイスに関する詳細情報を表示します。

```bash theme={}
snctl node show <node_name>
```

**例:**

```bash theme={}
snctl node show sn40l-16-001-n1
```

**出力例:**

```text theme={}
Node Details: sn40l-16-001-n1
+-----------+--------------------+-------------+------+----------+
| Component | Hostname           | IP          | Port | Username |
+-----------+--------------------+-------------+------+----------+
| Host      | SFT-SN40L-16-H-1   | 172.20.3.45 | 3024 | root     |
| BMC       | SN40L-16-H-1-SP    | 172.20.3.46 |      | admin    |
| XRDU/0    | SN40L-16-H-1-XRDU0 | 172.20.3.47 | 3026 | root     |
| XRDU/1    | SN40L-16-H-1-XRDU1 | 172.20.3.48 | 3025 | root     |
| XRDU/2    | SN40L-16-H-1-XRDU2 | 172.20.3.49 | 3023 | root     |
| XRDU/3    | SN40L-16-H-1-XRDU3 | 172.20.3.50 | 3022 | root     |
| XRDU/4    | SN40L-16-H-1-XRDU4 | 172.20.3.51 | 3016 | root     |
| XRDU/5    | SN40L-16-H-1-XRDU5 | 172.20.3.52 | 3015 | root     |
| XRDU/6    | SN40L-16-H-1-XRDU6 | 172.20.3.53 | 3013 | root     |
| XRDU/7    | SN40L-16-H-1-XRDU7 | 172.20.3.54 | 3012 | root     |
+-----------+--------------------+-------------+------+----------+

Belongs to Rack: <rack_id> (Type: <rack_type>)
```

### ノード名の変更

ノードにカスタムの名前を割り当てます。

```bash theme={}
snctl node rename <current_name> <new_name>
```

**例:**

```bash theme={}
snctl node rename sn40l-16-001-n1 production-node-1
```

> [!NOTE]
>
> デバイスの管理 (デバイスの追加・削除) は、`snctl rack add-device` および `snctl rack delete-device` を使用して行います。詳細は [ラック管理](/docs/ja/v2.0.2/sambastack/hardware-admin/sambarack-manager/srm-rack-admin.md) をご参照ください。

## 電源操作

DC 電源操作では、ノードとデバイスの電源状態の制御と監視を行います。これらの操作は**実際のハードウェア**に影響します。

**対応デバイス:**

* **ホストシステム**: インフラストラクチャ内の CPU ノード
* **XRDU**: SambaNova の実行ユニット

**非対応:**

* 電源分配ユニット (Power Distribution Unit; PDU)
* ネットワークスイッチ
* シリアルコンソールサーバー
* その他のインフラストラクチャコンポーネント

> [!NOTE]
>
> 電源操作が実行するのは、DC サイクル操作 (ホスト/XRDU の管理インターフェースを介した電源状態の制御) であり、AC サイクル操作 (PDU を介した制御) ではありません。

### 電源操作のデバイスタイプ

電源操作では、以下のデバイスタイプを指定できます。

| デバイスタイプ | 説明 |
| - | - |
| `node` | ノード全体 (ホストとすべての XRDU) |
| `host` | ホストシステムのみ |
| `xrdu` | XRDU デバイスのみ |

### 対象の指定

すべての電源コマンドでは、`--node` または `--group` のいずれか一方の指定が必須です (同時には指定できません)。

| パラメータ | 説明 |
| - | - |
| `--node <node_id>` | 特定のノードを対象にする |
| `--group <group_name>` | グループ内のすべてのノードを対象にする |

### 電源状態の確認

デバイスの現在の電源状態を確認します。

```bash theme={}
snctl node powerstate \
  (--node <node_id> | --group <group_name>) \
  --type <device_type>
```

**例 – 単一ノード:**

```bash theme={}
snctl node powerstate --node sn40l-16-001-n1 --type node
```

**出力例:**

```text theme={}
Power State Information
+------+-----------------+-------------+--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+
| Rack | Node Name       | Component   | Status | Host   | XRDU_0 | XRDU_1 | XRDU_2 | XRDU_3 | XRDU_4 | XRDU_5 | XRDU_6 | XRDU_7 |
+------+-----------------+-------------+--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+
| 001  | sn40l-16-001-n1 | NODE_NODE_0 | PASS   | Online | Online | Online | Online | Online | Online | Online | Online | Online |
+------+-----------------+-------------+--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+
```

**例 – グループ:**

```bash theme={}
snctl node powerstate --group g1 --type node
```

**出力例:**

```text theme={}
Power State Information
+------+-----------------+-------------+--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+
| Rack | Node Name       | Component   | Status | Host   | XRDU_0 | XRDU_1 | XRDU_2 | XRDU_3 | XRDU_4 | XRDU_5 | XRDU_6 | XRDU_7 |
+------+-----------------+-------------+--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+
| 002  | sn40l-16-002-n1 | NODE_NODE_0 | PASS   | Online | Online | Online | Online | Online | Online | Online | Online | Online |
| 001  | sn40l-16-001-n1 | NODE_NODE_0 | PASS   | Online | Online | Online | Online | Online | Online | Online | Online | Online |
+------+-----------------+-------------+--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+
```

### 電源オン

デバイスの電源をオンにします。

```bash theme={}
snctl node poweron \
  (--node <node_id> | --group <group_name>) \
  --type <device_type>
```

**例 – 単一ノード:**

```bash theme={}
snctl node poweron --node 001 --type node
```

**出力例:**

```text theme={}
Node Power ON Status
└── Rack-001 🟢 Power ON Successful
```

**例 – グループ:**

```bash theme={}
snctl node poweron --group g1 --type node
```

**出力例:**

```text theme={}
Node Power ON Status
└── Rack-001 🟢 Power ON Successful
└── Rack-002 🟢 Power ON Successful
```

### 電源オフ

デバイスの電源をオフにします。

> [!WARNING]
>
> 電源オフ操作は、実行中のサービスを中断します。計画的に実施してください。

```bash theme={}
snctl node poweroff \
  (--node <node_id> | --group <group_name>) \
  --type <device_type>
```

**例 – 単一ノード:**

```bash theme={}
snctl node poweroff --node 001 --type node
```

**出力例:**

```text theme={}
Node Power OFF Status
└── Rack-001 🟢 Power OFF Successful
```

**例 – グループ:**

```bash theme={}
snctl node poweroff --group g1 --type node
```

**出力例:**

```text theme={}
Node Power OFF Status
└── Rack-001 🟢 Power OFF Successful
└── Rack-002 🟢 Power OFF Successful
```

### パワーサイクル

デバイスのパワーサイクル (power cycle、電源オフ後にオン) を実行します。

> [!WARNING]
>
> パワーサイクル操作は、実行中のサービスを中断します。計画的に実施してください。

```bash theme={}
snctl node powercycle \
  (--node <node_id> | --group <group_name>) \
  --type node
```

> [!NOTE]
>
> パワーサイクルは、現在 `--type node` のみをサポートしています。

**例 – 単一ノード:**

```bash theme={}
snctl node powercycle --node 001 --type node
```

**出力例:**

```text theme={}
Node Power Cycle Status
└── Rack-001 🟢 Power Cycle Successful
```

**例 – グループ:**

```bash theme={}
snctl node powercycle --group g1 --type node
```

**出力例:**

```text theme={}
Node Power Cycle Status
└── Rack-001 🟢 Power Cycle Successful
└── Rack-002 🟢 Power Cycle Successful
```

## グループを使った一括操作

グループを使用すると、複数のノードに対して電源操作を一括で実行できます。

```bash theme={}
# Check power state of all nodes in a group
snctl node powerstate --group production --type node

# Power on all nodes in a group
snctl node poweron --group production --type node

# Power off all nodes in a group
snctl node poweroff --group production --type node

# Power cycle all nodes in a group
snctl node powercycle --group production --type node
```

グループの作成と管理については、[グループ管理](/docs/ja/v2.0.2/sambastack/hardware-admin/sambarack-manager/srm-group-admin.md) をご参照ください。