> ## Documentation Index
> Fetch the complete documentation index at: https://sambanova-systems.mintlify.site/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Group administration

Groups organize racks into logical collections for batch operations. Use groups to manage related infrastructure, such as production, staging, or testing environments.

## Group commands

Use the following commands to create and manage groups.

### Create group

Create a new group:

```bash theme={}
snctl group create <group_name> --description <description>
```

**Parameters:**

| Parameter       | Description                                       |
| --------------- | ------------------------------------------------- |
| `<group_name>`  | Name for the group (alphanumeric characters only) |
| `--description` | Description of the group (required)               |

**Example:**

```bash theme={}
snctl group create g1 --description "Production"
snctl group create g2 --description "Staging"
```

### Update group description

Edit the description of an existing group:

```bash theme={}
snctl group create <group_name> --description <new_description>
```

**Example:**

```bash theme={}
snctl group create production --description "Updated: Production infrastructure (High Priority)"
```

### Delete group

Remove a group from the inventory:

```bash theme={}
snctl group delete <group_name>
```

**Example:**

```bash theme={}
snctl group delete staging
```

<Note>
  Deleting a group does not delete the racks within it. The racks remain in the SambaRack Manager inventory.
</Note>

### List groups

Display all configured groups and their rack counts:

```bash theme={}
snctl group list
```

**Example output:**

```text theme={}
Group Name  Description  Rack Count
----------  -----------  ----------
g1          Production   1
```

Use `-o wide` to add a **Racks** column listing the member rack IDs:

```bash theme={}
snctl group list -o wide
```

```text theme={}
Group Name  Description  Rack Count  Racks
----------  -----------  ----------  --------
g1          Production   2           001, 002
```

### Show group details

View details of a specific group, including all racks:

```bash theme={}
snctl group show <group_name>
```

**Example:**

```bash theme={}
snctl group show g1
```

**Example output - 4-PDU racks:**

```text theme={}
Group: g1
├── Description: Group 1
└── Racks
    ├── 001 (part number: 1001934)
    └── 002 (part number: 1001934)
```

**Example output - mixed configuration:**

```text theme={}
Group: g1
├── Description: Group 1
└── Racks
    ├── 001 (part number: 1001934)
    └── 002 (part number: 1002331)
```

## Rack membership commands

Use the following commands to manage rack membership within groups.

### Add rack to group

Add one or more racks to a group:

```bash theme={}
snctl group add-rack <group_name> --rack-id <rack_id>[,<rack_id>,...]
```

**Example – add a single rack:**

```bash theme={}
snctl group add-rack production --rack-id 001

#Expected output
✓ Rack 001 added to group production
```

**Example – add multiple racks:**

```bash theme={}
snctl group add-rack production --rack-id 001,002,003
```

### Remove rack from group

Remove a rack from a group:

```bash theme={}
snctl group remove-rack <group_name> --rack-id <rack_id>
```

**Example:**

```bash theme={}
snctl group remove-rack production --rack-id 001

#Expected output
✓ Rack 001 removed from group production
```

<Note>
  Removing a rack from a group does not delete the rack from the SambaRack Manager inventory.
</Note>

## Using groups with other commands

A group is a target for firmware and power operations, letting you act on many racks at once.

### Firmware operations

```bash theme={}
# Audit firmware across every rack in a group
snctl firmware version --group production --device-type all

# Upgrade BMC firmware across every rack in a group
snctl firmware upgrade --group production --device-type bmc
```

See [Firmware Updates](srm-firmware-updates) for details.

### Power operations

```bash theme={}
# Check power state of all nodes in a group
snctl power state --group production --type node

# Power on all nodes in a group
snctl power on --group production --type node

# Power off all nodes in a group
snctl power off --group production --type node

# Power cycle all nodes in a group
snctl power cycle --group production
```

See [Power Operations](srm-power-admin) for target types and parallelism control.

<Note>
  Group fan-out is capped by `--parallelism-racks` and `--parallelism-devices`. Use `--parallelism-devices` to limit the total number of simultaneous IPMI, Redfish, and SSH sessions against your management network.
</Note>

***

## Next step

Fan out power state, on, off, and cycle across every rack in a group. See [Power Operations](srm-power-admin).