SambaRack Manager Group Administration - SambaNova Documentation

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:

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:

snctl group create g1 --description "Production"
snctl group create g2 --description "Staging"

Update group description

Edit the description of an existing group:

snctl group create <group_name> --description <new_description>

Example:

snctl group create production --description "Updated: Production infrastructure (High Priority)"

Delete group

Remove a group from the inventory:

snctl group delete <group_name>

Example:

snctl group delete staging

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

List groups

Display all configured groups and their rack counts:

snctl group list

Example output:

Group Name  Description  Rack Count
----------  -----------  ----------
g1          Production   1

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

snctl group list -o wide

Group Name  Description  Rack Count  Racks
----------  -----------  ----------  --------
g1          Production   2           001, 002

Show group details

View details of a specific group, including all racks:

snctl group show <group_name>

Example:

snctl group show g1

Example output - 4-PDU racks:

Group: g1
├── Description: Group 1
└── Racks
    ├── 001 (part number: 1001934)
    └── 002 (part number: 1001934)

Example output - mixed configuration:

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:

snctl group add-rack <group_name> --rack-id <rack_id>[,<rack_id>,...]

Example – add a single rack:

snctl group add-rack production --rack-id 001

#Expected output
✓ Rack 001 added to group production

Example – add multiple racks:

snctl group add-rack production --rack-id 001,002,003

Remove rack from group

Remove a rack from a group:

snctl group remove-rack <group_name> --rack-id <rack_id>

Example:

snctl group remove-rack production --rack-id 001

#Expected output
✓ Rack 001 removed from group production

Removing a rack from a group does not delete the rack from the SambaRack Manager inventory.

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

# 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 for details.

Power operations

# 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 for target types and parallelism control.

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.

Next step

Fan out power state, on, off, and cycle across every rack in a group. See Power Operations.

Getting Started

Service Administration

Hardware Administration

Reference Architecture

Resources

Group administration

Group commands

Create group

Update group description

Delete group

List groups

Show group details

Rack membership commands

Add rack to group

Remove rack from group

Using groups with other commands

Firmware operations

Power operations

Next step

​Group commands

​Create group

​Update group description

​Delete group

​List groups

​Show group details

​Rack membership commands

​Add rack to group

​Remove rack from group

​Using groups with other commands

​Firmware operations

​Power operations

​Next step

Group commands

Create group

Update group description

Delete group

List groups

Show group details

Rack membership commands

Add rack to group

Remove rack from group

Using groups with other commands

Firmware operations

Power operations

Next step