> ## 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 内のデバイスのファームウェアバージョンの確認について説明します。デバイスとは、ラックやノードに取り付けられた個々のコンポーネントのことで、BMC、スイッチ、PDU、シリアルターミナルなどが含まれます。

## コマンド

デバイスの管理には、以下のコマンドを使用します。

### ファームウェアバージョンの確認

デバイスのファームウェアバージョンを確認します。

```bash theme={}
snctl device firmware-check \
  (--rack-id <rack_id> | --group <group_name>) \
  --type <device_type> \
  [--index <index>]
```

**対象の指定:**

すべてのファームウェアチェックコマンドでは、`--rack-id` または `--group` のいずれか一方の指定が必須です (同時には指定できません)。

| パラメータ | 説明 |
| - | - |
| `--rack-id <rack_id>` | 特定のラック内のデバイスを確認 |
| `--group <group_name>` | グループ内のすべてのラックのデバイスを確認 |

**デバイスタイプ:**

| タイプ | 説明 |
| - | - |
| `access_switch` | アクセススイッチ |
| `data_switch` | データスイッチ |
| `scs` | システムコントロールスイッチ (System Control Switch) |
| `bios` | BIOS |
| `bmc` | ベースボード管理コントローラー (Baseboard Management Controller; BMC) |
| `card` | カード/アダプター |
| `pdu` | 電源分配ユニット (Power Distribution Unit; PDU) |
| `xrdu` | XRDU |
| `all` | すべてのデバイスタイプ |

**例 – 単一ラックの BMC ファームウェアを確認:**

```bash theme={}
snctl device firmware-check --rack-id 001 --type bmc
```

**出力例:**

```text theme={}
             Firmware Version Information
+----------+-----------+--------+----------+----------+
| Rack     | Component | Status | CURR     | POR      |
+----------+-----------+--------+----------+----------+
| Rack-001 | BMC       | PASS   | 12.61.21 | 12.61.21 |
+----------+-----------+--------+----------+----------+
```

**例 – ラック内のすべてのファームウェアを確認:**

```bash theme={}
snctl device firmware-check --rack-id 001 --type all
```

**出力例:**

```text theme={}
                                        Firmware Version Information
+----------+---------------+--------+----------+-------------+-----------+----------+-----------+----------+
| Rack     | Component     | Status | CURR     | POR         | OBMC_CURR | OBMC_POR | RDUC_CURR | RDUC_POR |
+----------+---------------+--------+----------+-------------+-----------+----------+-----------+----------+
| Rack-001 | ACCESS_SWITCH | FAIL   |          |             |           |          |           |          |
| Rack-001 | BIOS          | PASS   | R24_P1   | R24_P1      |           |          |           |          |
| Rack-001 | BMC           | PASS   | 12.61.21 | 12.61.21    |           |          |           |          |
| Rack-001 | CARD          | FAIL   |          | 228.1.111.0 |           |          |           |          |
| Rack-001 | DATA_SWITCH   | FAIL   |          |             |           |          |           |          |
| Rack-001 | PDU_PDU_1     | FAIL   |          |             |           |          |           |          |
| Rack-001 | PDU_PDU_2     | FAIL   |          |             |           |          |           |          |
| Rack-001 | PDU_PDU_3     | FAIL   |          |             |           |          |           |          |
| Rack-001 | PDU_PDU_4     | FAIL   |          |             |           |          |           |          |
| Rack-001 | SCS           | FAIL   |          |             |           |          |           |          |
| Rack-001 | XRDU_XRDU_0   | PASS   |          |             | 5.1.2-0   | 5.1.2-0  | 5.1.2     | 5.1.2    |
| Rack-001 | XRDU_XRDU_1   | PASS   |          |             | 5.1.2-0   | 5.1.2-0  | 5.1.2     | 5.1.2    |
| Rack-001 | XRDU_XRDU_2   | PASS   |          |             | 5.1.2-0   | 5.1.2-0  | 5.1.2     | 5.1.2    |
| Rack-001 | XRDU_XRDU_3   | PASS   |          |             | 5.1.2-0   | 5.1.2-0  | 5.1.2     | 5.1.2    |
| Rack-001 | XRDU_XRDU_4   | PASS   |          |             | 5.1.2-0   | 5.1.2-0  | 5.1.2     | 5.1.2    |
| Rack-001 | XRDU_XRDU_5   | PASS   |          |             | 5.1.2-0   | 5.1.2-0  | 5.1.2     | 5.1.2    |
| Rack-001 | XRDU_XRDU_6   | PASS   |          |             | 5.1.2-0   | 5.1.2-0  | 5.1.2     | 5.1.2    |
| Rack-001 | XRDU_XRDU_7   | PASS   |          |             | 5.1.2-0   | 5.1.2-0  | 5.1.2     | 5.1.2    |
+----------+---------------+--------+----------+-------------+-----------+----------+-----------+----------+
```

> [!NOTE]
>
> デバイスに到達できない場合や設定が正しくない場合、該当デバイスのファームウェアチェックは、上の出力例のように `FAIL` ステータスで失敗します。

**例 – グループ内のすべてのデバイスのファームウェアを確認:**

```bash theme={}
snctl device firmware-check --group g1 --type all
```

## 出力列

ファームウェアチェックの出力には、以下の列が含まれます。

| 列 | 説明 |
| - | - |
| Rack | ラックの識別子 |
| Component | デバイスタイプとインデックス |
| Status | ファームウェアが期待されるバージョンと一致する場合は `PASS`、それ以外は `FAIL` |
| CURR | 現在のファームウェアバージョン |
| POR | Plan of Record (期待される) ファームウェアバージョン |
| OBMC\_CURR | 現在の OpenBMC ファームウェアバージョン (XRDU のみ) |
| OBMC\_POR | 期待される OpenBMC ファームウェアバージョン (XRDU のみ) |
| RDUC\_CURR | 現在の RDUC ファームウェアバージョン (XRDU のみ) |
| RDUC\_POR | 期待される RDUC ファームウェアバージョン (XRDU のみ) |