> For the complete documentation index, see [llms.txt](https://asus-isg-aidc.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://asus-isg-aidc.gitbook.io/guide/latest/cli/commandreference/weka.md).

# WEKA Storage

| Developer | Last modified |
| --------- | ------------- |
| AIDC Team | 2026/07/06    |

## Table of Contents

* [1. Overview](#overview)
* [2. Command Groups](#command-groups)
* [3. Server Deployment](#server-deployment)
* [4. Client Deployment](#client-deployment)
* [5. Usage Examples](#usage-examples)
* [6. Related Commands](#related-commands)

***

## 1. Overview <a href="#overview" id="overview"></a>

{% hint style="warning" %}
**⚠️ Prerequisite: `aidc-cli init` required first**

This command depends on settings saved by [`aidc-cli init`](/guide/latest/cli/commandreference/init.md). Before running it, make sure you have completed:

* [`aidc-cli init inventory`](/guide/latest/cli/commandreference/init.md#inventory) — render the node inventory from `aidc.csv`
* SSH access to the nodes — [`aidc-cli deploy install`](/guide/latest/cli/commandreference/deploy.md) sets this up during OS deployment; for nodes that already have an OS, run [`aidc-cli deploy access-key`](/guide/latest/cli/commandreference/deploy.md) or fill the `password` column in `aidc.csv`
* [`aidc-cli init bmc-set`](/guide/latest/cli/commandreference/init.md#bmc-configuration) — save the BMC credentials

For the full setup sequence, see the [Getting Started](/guide/latest/cli/gettingstarted.md) guide.
{% endhint %}

The `weka` command provides separate workflows for WEKA server deployment and WEKA client deployment.

```bash
aidc-cli weka <server|client> <subcommand> [flags]
```

***

## 2. Command Groups <a href="#command-groups" id="command-groups"></a>

| Group    | Purpose                                              |
| -------- | ---------------------------------------------------- |
| `server` | Deploy and manage WEKA storage servers               |
| `client` | Deploy and manage WEKA clients and filesystem mounts |

***

## 3. Server Deployment <a href="#server-deployment" id="server-deployment"></a>

### 3.1 `server deploy` — Deploy WEKA Storage Servers

Deploys WEKA storage servers by using the specified WEKA ISO image filename.

```bash
aidc-cli weka server deploy -I <weka-iso>
```

| Flag         | Short | Required | Description             |
| ------------ | :---: | :------: | ----------------------- |
| `--weka-iso` |  `-I` |     ✅    | WEKA ISO image filename |

{% hint style="warning" %}
`aidc-cli weka server deploy` requires `BMC_USERNAME` and `BMC_PASSWORD` to be configured first. If they are missing, the command instructs you to run `aidc-cli init bmc-set`.
{% endhint %}

***

## 4. Client Deployment <a href="#client-deployment" id="client-deployment"></a>

### 4.1 `client deploy` — Deploy a WEKA Client

Deploys a WEKA client agent and mounts the selected WEKA filesystem.

```bash
aidc-cli weka client deploy -s <server-ips> -m <mount-point> -f <fs-name> [-p <server-port>]
```

| Flag            | Short | Required | Default | Description                                |
| --------------- | :---: | :------: | :-----: | ------------------------------------------ |
| `--server-ips`  |  `-s` |     ✅    |    —    | Comma-separated WEKA server data-plane IPs |
| `--mount-point` |  `-m` |     ✅    |    —    | Mount point path on the client node        |
| `--fs-name`     |  `-f` |     ✅    |    —    | WEKA filesystem name                       |
| `--server-port` |  `-p` |     ❌    | `14000` | WEKA server data-plane port                |

***

## 5. Usage Examples <a href="#usage-examples" id="usage-examples"></a>

```bash
# Configure BMC credentials before server deployment
aidc-cli init bmc-set -p "bmc-password"

# Deploy WEKA storage servers from a WEKA ISO image
aidc-cli weka server deploy -I weka-4.4.10.150-2.0.2.iso

# Deploy a WEKA client and mount the default filesystem
aidc-cli weka client deploy \
  -s 10.10.10.11,10.10.10.12 \
  -m /mnt/weka \
  -f default

# Deploy a WEKA client with a custom data-plane port
aidc-cli weka client deploy \
  -s 10.10.10.11,10.10.10.12 \
  -m /mnt/weka \
  -f research \
  -p 15000
```

***

## 6. Related Commands <a href="#related-commands" id="related-commands"></a>

| Command           | Purpose                                                       |
| ----------------- | ------------------------------------------------------------- |
| `init bmc-get`    | Review the current BMC configuration                          |
| `init bmc-set`    | Configure BMC credentials required for WEKA server deployment |
| `hwspec storage`  | Check storage hardware before deployment                      |
| `network eth-cfg` | Prepare client and storage networking                         |