> 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/v1.4.0/cli/commandreference/ufm.md).

# UFM Management

| Developer | Last modified |
| --------- | ------------- |
| AIDC Team | 2026/02/12    |

## Table of Contents

* [1. Overview](#overview)
* [2. Subcommands](#subcommands)
* [3. Usage Examples](#usage-examples)
* [4. Related Commands](#related-commands)

***

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

The `ufm` command manages the deployment of NVIDIA Unified Fabric Manager (UFM) for InfiniBand network management and monitoring.

```bash
aidc-cli ufm <subcommand> [flags]
```

***

## 2. Subcommands <a href="#subcommands" id="subcommands"></a>

### 2.1 `deploy` — Deploy UFM

Deploys UFM in standalone mode on the target management node.

```bash
aidc-cli ufm deploy [-n <interface>] [-p <licenses-path>]
```

| Flag              | Short | Required | Description                          |
| ----------------- | :---: | :------: | ------------------------------------ |
| `--interface`     |  `-n` |     ❌    | Management network interface for UFM |
| `--licenses-path` |  `-p` |     ❌    | Path to UFM license files            |

{% hint style="info" %}
Configure UFM parameters first with `aidc-cli init ufm-set` before deploying.
{% endhint %}

***

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

```bash
# Configure UFM parameters first
aidc-cli init ufm-set -n ib0 -p /root/ufm_licenses
aidc-cli init ufm-get

# Deploy UFM
aidc-cli ufm deploy

# Deploy with specific interface
aidc-cli ufm deploy -n ib0

# Deploy with license files
aidc-cli ufm deploy -p /opt/ufm/licenses/

# Deploy with both options
aidc-cli ufm deploy -n ib0 -p /opt/ufm/licenses/
```

{% hint style="info" %}
Refer to the "UFM" section in the `init` documentation and ensure the required packages are properly defined before execution.
{% endhint %}

***

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

| Command            | Purpose                                  |
| ------------------ | ---------------------------------------- |
| `init ufm-get/set` | View/set UFM configuration               |
| `chknet ib`        | Validate InfiniBand network connectivity |
| `network ib-cfg`   | Configure InfiniBand interfaces          |