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          |
+------------+-------------+------------+

Show group details

View details of a specific group, including all racks:

snctl group show <group_name>

Example:

snctl group show g1

Example output:

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

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

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

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

Using groups with other commands

Groups can be used as targets for device and node operations, allowing you to perform batch operations across multiple racks.

Device operations

Check firmware on all devices in racks belonging to a group:

snctl device firmware-check --group production --type all

See Device Administration for more details.

Node power operations

Perform DC power operations on all nodes in racks belonging to a group:

# Check power state of all nodes in a group
snctl node powerstate --group production --type node

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

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

# Power cycle all nodes in a group
snctl node powercycle --group production --type node

See Node Administration for more details on 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

Device operations

Node power operations

​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

​Device operations

​Node power operations

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

Device operations

Node power operations