> ## 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 ソフトウェアの初回インストールとアップグレードの両方について説明します。

SambaRack Manager を使用するには、事前にインストール、セットアップ、設置済みシステムの登録、およびデバイス認証情報の設定が必要です。セットアップの全体の流れは次のとおりです。

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

## 前提条件

SambaRack Manager をインストールする前に、システムが以下の要件を満たしていることをご確認ください。

### オペレーティングシステムとライブラリ

* Red Hat Enterprise Linux 8 以降が動作する Linux ホスト
* glibc 2.28 以降 (`ldd --version` で確認できます)
* libffi (ほとんどのシステムにプリインストールされています)

> [!NOTE]
>
> glibc 2.28 以降を備えた他の Linux ディストリビューションでも動作する可能性はありますが、公式にはサポートされていません。

### ネットワークアクセス

インストール先ホストには、以下のネットワーク接続性が必要です。

* **管理ネットワーク**: デバイスの管理インターフェース (BMC、XRDU 管理ポート) との通信用。
* **フロントエンドネットワーク**: SambaRack ホストモジュールおよびコントロールプレーンノードとの通信用。
* **パブリックインターネット**: Google Cloud Storage (GCS) からのリリースのダウンロード用。

### GCS アクセス

SambaRack Manager のバイナリは Google Cloud Storage を通じて配布されます。以下が必要です。

* Google Cloud Storage バケット `gs://<SAMBASTACK_ARTIFACTS_BUCKET>` へのアクセス権
* 適切な認証情報で設定済みの `gsutil` CLI ツール、または `gcloud auth login` を実行した `gcloud` CLI

## インストール

以下の手順に従って SambaRack Manager をインストールします。

### ステップ 1: サービスアカウント認証情報の有効化

SambaNova から受領したサービスアカウント認証情報の JSON ファイルを指定して、以下のコマンドを実行します。

```shellscript theme={}
gcloud auth activate-service-account --key-file=<Service-Account-Credentials-Path>
```

正常に実行されると、以下のように表示されます。

```shellscript theme={}
Activated service account credentials for: [...]
```

### ステップ 2: 利用可能なバージョンの確認

GCS バケット内の利用可能なバージョンを一覧表示します。

```bash theme={}
gsutil ls gs://<SAMBASTACK_ARTIFACTS_BUCKET>/sambarack-cli/releases/
```

### ステップ 3: 目的のバージョンのダウンロード

目的のバージョンのバイナリをダウンロードします。

```bash theme={}
# Replace VERSION with the actual version number (e.g., 0.0.5)
gsutil cp gs://<SAMBASTACK_ARTIFACTS_BUCKET>/sambarack-cli/releases/VERSION/snctl-linux-amd64 snctl

#Example : If the latest version is 0.0.5
gsutil cp gs://<SAMBASTACK_ARTIFACTS_BUCKET>/sambarack-cli/releases/0.0.5/snctl-linux-amd64 snctl
```

### ステップ 4: 実行権限の付与

```bash theme={}
chmod +x snctl
```

### ステップ 5: PATH の通った場所へのバイナリのコピー

以下のいずれかのオプションを選択します。

**オプション 1 - すべてのユーザーが利用可能:** バイナリを `/usr/local/bin/` にコピーします。これにより、`snctl` が `$PATH` を通じてシステム全体で利用可能になります。

```bash theme={}
sudo cp snctl /usr/local/bin/snctl
```

**オプション 2 - 現在のユーザーのみ利用可能:** バイナリを `~/.local/bin/` にコピーします。`~/.bashrc` または `~/.zshrc` で、環境変数 PATH に `~/.local/bin` を追加する必要がある場合があります。

```bash theme={}
mkdir -p ~/.local/bin
cp snctl ~/.local/bin/snctl
```

### ステップ 6: インストールの確認

SambaRack Manager が正しくインストールされたことを確認します。

```bash theme={}
snctl --version
snctl --help
```

## 次のステップ

インストールが完了したら、[初期セットアップ](https://docs.sambanova.ai/docs/ja/v1.2.0/sambastack/hardware-admin/sambarack-manager/srm-initial-setup.md) に進んでください。

## SambaRack Manager のアップグレード

以下の手順に従って、既存の SambaRack Manager インストールを新しいバージョンにアップグレードします。

### ステップ 1: 利用可能なバージョンの確認

GCS バケット内の利用可能なバージョンを一覧表示します。

```bash theme={}
gsutil ls gs://<SAMBASTACK_ARTIFACTS_BUCKET>/sambarack-cli/releases/
```

### ステップ 2: 新しいバージョンのダウンロード

目的のバージョンのバイナリをダウンロードします。

```bash theme={}
# Replace NEW_VERSION with the desired version number (e.g., 0.0.4)
gsutil cp gs://<SAMBASTACK_ARTIFACTS_BUCKET>/sambarack-cli/releases/NEW_VERSION/snctl-linux-amd64 snctl-new
```

### ステップ 3: 実行権限の付与

```bash theme={}
chmod +x snctl-new
```

### ステップ 4: 既存の SambaRack Manager バイナリの置き換え

最初にインストールしたのと同じ場所にあるバイナリを置き換えます。

**オプション 1 - システム全体へのインストールの場合:** `/usr/local/bin/` のバイナリを置き換えます。

```bash theme={}
sudo cp snctl-new /usr/local/bin/snctl
```

**オプション 2 - ユーザー単位のインストールの場合:** `~/.local/bin/` のバイナリを置き換えます。

```bash theme={}
cp snctl-new ~/.local/bin/snctl
```

### ステップ 5: 新しいバージョンの確認

アップグレードが成功したことを確認します。

```bash theme={}
snctl --version
```