Skip to main content
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:
ParameterDescription
<group_name>Name for the group (alphanumeric characters only)
--descriptionDescription 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.