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:
Perform DC power operations on all nodes in racks belonging to a group:
# Check power state of all nodes in a groupsnctl node powerstate --group production --type node# Power on all nodes in a groupsnctl node poweron --group production --type node# Power off all nodes in a groupsnctl node poweroff --group production --type node# Power cycle all nodes in a groupsnctl node powercycle --group production --type node
