SambaRack RDU モジュールの管理 - SambaNova ドキュメント

SN40L-2 RDU モジュールには、ベースボード管理コントローラー (Baseboard Management Controller; BMC) と RDU コントローラー (RDU-C) が搭載されており、これらには定期的な管理が必要です。本ドキュメントでは、これらのコンポーネントのパスワード管理、API 認証、ファームウェア更新、ネットワーク設定について説明します。

SN40L-2 の BMC には、root パスワードの復旧に使用する snservice という組み込みのセキュアアカウントが用意されています。詳細は KB 記事 #1417 をご参照ください。

パスワード管理

初期デプロイ後、直ちに SN40L-2 BMC のデフォルトの root パスワードを変更してください。

SambaRack および Core Services Rack は、すべてのデバイスにデフォルトの認証情報が設定された状態で出荷されます。デフォルトの認証情報については、KB 記事 #1411 をご参照ください。

手順:

SN40L-2 BMC にログインします:

ssh root@<SN40L-2_BMC_IP>

passwd コマンドを実行します:

passwd

新しいパスワードを入力して確認します:

New password: <new_password>
Retype new password: <new_password>
passwd: password updated successfully

新しい BMC パスワードを選ぶ際は、以下の制限に注意してください。パスワードには、一般的な辞書に載っている単語に基づくものは使用できず、# 文字を含めることはできません。パスワードがこれらの要件を満たさない場合、システムは変更を拒否し、別のパスワードを選ぶよう促します。

安全な API ログイントークンの生成

トークンベースの認証を使用すると、REST API 呼び出しの際に平文のパスワードを送信する必要がなくなります。電源管理をはじめとする BMC 操作で API を使用する前に、トークンを生成してください。 前提条件:

SN40L-2 BMC にネットワークアクセスできるクライアントシステム
curl がインストール済みであること

手順:

トークンを生成します:

export token=$(curl -k -H "Content-Type: application/json" -X POST \
  https://<SN40L-2_BMC_IP>/login \
  -d '{"username":"root","password":"<password>"}' \
  | grep token | awk '{print $2;}' | tr -d '"')

トークンが作成されたことを確認します:

echo $token

出力例:

1h0Dk9xjtjsOtBkMhgIN

トークンを検証します:

curl -k -H "X-Auth-Token: $token" \
  https://<SN40L-2_BMC_IP>/xyz/openbmc_project/

想定される出力:

{
  "data": [
    "/xyz/openbmc_project/Ipmi",
    "/xyz/openbmc_project/certs",
    "/xyz/openbmc_project/user"
  ],
  "message": "200 OK",
  "status": "ok"
}

正常なレスポンスが返れば、SN40L-2 RDU モジュールの電源オン・オフなど、他の API 呼び出しでこのトークンを使用する準備が整っています。

BMC および RDU-C ファームウェアの更新

BMC および RDU-C のファームウェア更新は、ノード内の各 SN40L-2 モジュールで順番どおりに実施する必要があります。システムの回復力を確保するため、プライマリパーティションとリカバリパーティションの両方を更新します。

ステップ	コンポーネント	パーティション
1	–	準備
2	BMC	プライマリ
3	BMC	リカバリ
4	RDU-C	プライマリ
5	RDU-C	リカバリ

前提条件:

SambaNova の ext-xrdu-fw リポジトリの /latest サブディレクトリからダウンロードしたファームウェアファイル sn<XRDU_version>-xrdu-sys-fw-<fw_version>.tar.gz（KB 記事 #1063 参照）
更新対象のすべての SN40L-2 BMC へのネットワークアクセス

必ず SN40L 用の XRDU ファームウェアをダウンロードしてください。他の RDU バージョン向けのファームウェアには互換性がありません。

ステップ 1: 更新の準備

手順:

SambaRack Manager を使用してノードをシャットダウンします。ノード管理の「Power off」をご参照ください。
各 SN40L-2 BMC にログインし、レジスタをクリアするために再起動します:

ssh root@<SN40L-2_BMC_IP>
reboot

再起動が完了するまで 3〜5 分待ちます。
クライアントシステム上でファームウェアアーカイブを展開します。
BMC ファームウェアファイルを各 SN40L-2 BMC にコピーします:

scp /<uncompressed_directory>/obmc/obmc-<version>* \
  root@<SN40L-2_BMC_IP>:/dev/shm/

ログインしてファイルを確認します:

ssh root@<SN40L-2_BMC_IP>
ls /dev/shm/obmc*

想定される出力:

obmc-<version>.mtd  obmc-<version>.mtd.md5

ステップ 2: BMC プライマリパーティションの更新

手順:

更新を実行します:

obmcupdate -p primary -t bmc -f /dev/shm/obmc-rdu-<version>.mtd

更新中は、他のコマンドを実行したり、電源を切断したりしないでください。

Erasing、Writing、Verifying の各ステージが 100% に達するまで待ちます。
BMC を再起動します:

reboot -f

3〜5 分待ってから、ログインします:

ssh root@<SN40L-2_BMC_IP>

更新により、BMC の SSH ホストキーが変更されます。プロンプトが表示された場合は、~/.ssh/known_hosts から古いエントリを削除してください。

更新を確認します:

obmcupdate -i

BMC Release Version が適用したファームウェアバージョンと一致していることを確認します。

ステップ 3: BMC リカバリパーティションの更新

再イメージ処理により /dev/shm/ の内容は消去されます。次に進む前に、ファームウェアファイルを再度コピーしてください。

/dev/shm は一時ファイルシステムです。内容は再起動時に失われます。

手順:

クライアントシステムからファームウェアファイルをコピーします:

scp /<uncompressed_directory>/obmc/obmc-<version>* \
  root@<SN40L-2_BMC_IP>:/dev/shm/

ログインして確認します:

ssh root@<SN40L-2_BMC_IP>
ls /dev/shm/obmc*

更新を実行します:

obmcupdate -p recovery -t bmc -f /dev/shm/obmc-rdu-<version>.mtd

更新中は、他のコマンドを実行したり、電源を切断したりしないでください。

すべてのステージが 100% に達するまで待ちます。
更新が繰り返し失敗する場合は、SambaNova サポートまでお問い合わせください。

ステップ 4: RDU-C プライマリパーティションの更新

手順:

クライアントシステムから RDU-C ファームウェアファイルをコピーします:

scp /<uncompressed_directory>/rduc/rduc-<version>-* \
  root@<SN40L-2_BMC_IP>:/dev/shm/

ログインして確認します:

ssh root@<SN40L-2_BMC_IP>
ls /dev/shm/rduc*

想定される出力:

rduc-<version>-primary.spi      rduc-<version>-primary.spi.md5
rduc-<version>-recovery.spi     rduc-<version>-recovery.spi.md5

更新を実行します:

obmcupdate -p primary -t rduc -f /dev/shm/rduc-<version>-primary.spi

更新中は、他のコマンドを実行したり、電源を切断したりしないでください。

更新を確認します:

obmcupdate -i

RDU-C Release Version が適用したファームウェアバージョンと一致していることを確認します。

ステップ 5: RDU-C リカバリパーティションの更新

手順:

更新を実行します:

obmcupdate -p recovery -t rduc -f /dev/shm/rduc-<version>-recovery.spi

いずれかの更新ステップで問題が発生した場合は、SambaNova サポートまでお問い合わせください。

すべての更新が正常に完了したら、SambaRack Manager を使用してシステムの電源をオンにします。詳細は電源オンセクションをご参照ください。

BMC ネットワーク設定の構成

BMC のネットワーク設定はラックの初期納品時に構成されており、通常は変更する必要はありません。再設定が必要な場合は、以下の手順を使用してください。

SN40L-2 BMC の IP アドレスを変更する際は、変更した BMC と、ノード内で直接接続されているすべての BMC の両方で、/platform/network.json の IP_ADDRESS_SP# エントリを更新してください。

IP アドレスを変更すると、アクティブな SSH セッションは切断されます。新しい IP アドレスで再接続してください。

コマンドリファレンス

network-settings [-h] -i [IPADDRESS] -n [NETMASK] -g [GATEWAY] -d [DNS] {static,DHCP}

オプション	説明
`{static,DHCP}`	ネットワークモード
`-i`, `--ipAddress`	IP アドレス（DHCP の場合は `""` を指定）
`-n`, `--netMask`	サブネットマスク。0〜32（DHCP の場合は任意の値）
`-g`, `--gateWay`	ゲートウェイアドレス（DHCP の場合は `""` を指定）
`-d`, `--dns`	DNS サーバー（DHCP の場合は `""` を指定）
`-h`, `--help`	ヘルプの表示

静的 IP アドレスの設定

手順:

SN40L-2 BMC にログインします:

ssh root@<SN40L-2_BMC_IP>

静的 IP を設定します:

network-settings -i "10.10.0.15" -n 24 -g "10.10.0.1" -d "10.0.0.13" static

ネットワークサービスを再起動します:

systemctl restart systemd-networkd.service

新しい IP アドレスで再接続します:

ssh root@<SN40L-2_NEW_BMC_IP>

設定を確認します:

ip address

新しい IP は、eth0 の下の 2 番目の inet 値として表示されます。

DHCP の設定

手順:

SN40L-2 BMC にログインします:

ssh root@<SN40L-2_BMC_IP>

DHCP を設定します:

network-settings -i "" -n 0 -g "" -d "" DHCP

ネットワークサービスを再起動します:

systemctl restart systemd-networkd.service

DHCP により割り当てられた IP アドレスで再接続し、設定を確認します。

BMC ホスト名の設定

手順:

SN40L-2 BMC にログインします:

ssh root@<SN40L-2_BMC_IP>

ホスト名を設定します:

hostnamectl set-hostname <hostname>

一度ログアウトして再度ログインし、プロンプトに新しいホスト名が表示されることを確認します。

はじめに

サービス管理

ハードウェア管理

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

リソース

RDU モジュールの管理

パスワード管理

安全な API ログイントークンの生成

BMC および RDU-C ファームウェアの更新

ステップ 1: 更新の準備

ステップ 2: BMC プライマリパーティションの更新

ステップ 3: BMC リカバリパーティションの更新

ステップ 4: RDU-C プライマリパーティションの更新

ステップ 5: RDU-C リカバリパーティションの更新

BMC ネットワーク設定の構成

コマンドリファレンス

静的 IP アドレスの設定

DHCP の設定

BMC ホスト名の設定

​パスワード管理

​安全な API ログイントークンの生成

​BMC および RDU-C ファームウェアの更新

​ステップ 1: 更新の準備

​ステップ 2: BMC プライマリパーティションの更新

​ステップ 3: BMC リカバリパーティションの更新

​ステップ 4: RDU-C プライマリパーティションの更新

​ステップ 5: RDU-C リカバリパーティションの更新

​BMC ネットワーク設定の構成

​コマンドリファレンス

​静的 IP アドレスの設定

​DHCP の設定

​BMC ホスト名の設定

パスワード管理

安全な API ログイントークンの生成

BMC および RDU-C ファームウェアの更新

ステップ 1: 更新の準備

ステップ 2: BMC プライマリパーティションの更新

ステップ 3: BMC リカバリパーティションの更新

ステップ 4: RDU-C プライマリパーティションの更新

ステップ 5: RDU-C リカバリパーティションの更新

BMC ネットワーク設定の構成

コマンドリファレンス

静的 IP アドレスの設定

DHCP の設定

BMC ホスト名の設定