Skip to main content
This guide covers adding, viewing, and managing racks and their devices using SambaRack Manager. It includes tasks for both new installations and ongoing management. The complete setup process is:
  1. Install SambaRack Manager software
  2. Initial setup and verification
  3. Add SambaRack to the SambaRack Manager inventory (this page)
  4. Configure device credentials in SambaRack Manager

​
For new installations

If you are setting up SambaRack Manager for the first time, complete the following steps.

​
Adding racks

Use the snctl rack add command to add all installed SambaRack units to the inventory. See Add rack for details.

​
Next step

After successfully adding racks to SambaRack Manager, configure your Device Credentials.

​
Rack commands

Use the following commands to manage racks in the SambaRack Manager inventory.

​
Add rack

Add a new rack to the inventory based on a partnumber configuration.
Racks must be powered on and fully functional before adding them to the inventory.
snctl rack add <rack_id> --type <partnumber>
Parameters:
ParameterDescription
<rack_id>The ID of the rack to add (e.g., 001)
--typePartnumber type
To identify the correct part number for your installed SambaRack, refer to the relevant SambaNova Support Portal knowledge base article.
Example: 
snctl rack add 001 --type 1001934
This creates a rack with the following components based on the partnumber configuration:
  • Nodes
  • PDUs (typically 4)
  • XRDUs per node (typically 8 per node)
  • Access switches
  • Data switches
  • Serial terminals

​
List racks

Display all configured racks in the inventory: 
snctl rack list
Example output: 
                              Configured Racks
+---------+----------------+-------+------+-------+------------+-------------+-----+
| Rack ID | Type           | Nodes | PDUs | XRDUs | Acc Switch | Data Switch | SCS |
+---------+----------------+-------+------+-------+------------+-------------+-----+
| 001     | 1001934        | 1     | 4    | 8     | 2          | 2           | 2   |
| 002     | 1001934        | 1     | 4    | 8     | 2          | 2           | 2   |
+---------+----------------+-------+------+-------+------------+-------------+-----+

​
Show rack details

View detailed information about a specific rack and its components: 
snctl rack show <rack_id>
Example: 
snctl rack show 001
Example output: 
                                       Rack Details: 001
+---------------------------+--------------------+----------------+------+----------+
| Component                 | Hostname           | IP             | Port | Username |
+---------------------------+--------------------+----------------+------+----------+
| Rack/001/AccessSwitch/0   | SN40L-16-ACCSW     | 192.168.10.240 | 3001 | root     |
| Rack/001/DataSwitch/0     | SN40L-16-DATASW    | 192.168.10.241 | 3002 | root     |
| Rack/001/PDU/1            | SN40L-16-PDU1      | 192.168.10.20  | 3003 | admin    |
| Rack/001/PDU/2            | SN40L-16-PDU2      | 192.168.10.21  | 3004 | admin    |
| Rack/001/PDU/3            | SN40L-16-PDU3      | 192.168.10.22  | 3005 | admin    |
| Rack/001/PDU/4            | SN40L-16-PDU4      | 192.168.10.23  | 3006 | admin    |
| Rack/001/SerialTerminal/0 | SN40L-16-SCS       | 192.168.10.20  |      | sysadmin |
| Rack/001/Node/0/Host      | SFT-SN40L-16-H-1   | 192.168.4.1    | 3024 | root     |
| Rack/001/Node/0/BMC       | SN40L-16-H-1-SP    | 192.168.5.1    |      | admin    |
| Rack/001/Node/0/XRDU/0    | SN40L-16-H-1-XRDU0 | 192.168.6.1    | 3026 | root     |
| Rack/001/Node/0/XRDU/1    | SN40L-16-H-1-XRDU1 | 192.168.7.1    | 3025 | root     |
| Rack/001/Node/0/XRDU/2    | SN40L-16-H-1-XRDU2 | 192.168.8.1    | 3023 | root     |
| Rack/001/Node/0/XRDU/3    | SN40L-16-H-1-XRDU3 | 192.168.9.1    | 3023 | root     |
| Rack/001/Node/0/XRDU/4    | SN40L-16-H-1-XRDU4 | 192.168.10.1   | 3016 | root     |
| Rack/001/Node/0/XRDU/5    | SN40L-16-H-1-XRDU5 | 192.168.11.1   | 3015 | root     |
| Rack/001/Node/0/XRDU/6    | SN40L-16-H-1-XRDU6 | 192.168.12.1   | 3013 | root     |
| Rack/001/Node/0/XRDU/7    | SN40L-16-H-1-XRDU7 | 192.168.13.1   | 3012 | root     |
+---------------------------+--------------------+----------------+------+----------+

​
Delete rack

Remove a rack and its associated nodes from the SambaRack Manager inventory: 
snctl rack delete <rack_id>
This permanently deletes the rack, its nodes, and all associated devices from the SambaRack Manager inventory. Deleting a rack from SambaRack Manager does not remove it from your SambaStack cluster.
Example: 
snctl rack delete 001

​
Device commands

Use the following commands to manage individual devices within racks.

​
Add or update device

Add a new device or update an existing device in a rack: 
snctl rack add-device <device_path> \
  [--ip <ip_address>] \
  [--user <username>] \
  [--password <password>] \
  [--hostname <hostname>] \
  [--port <port>] \
  [--index <index>] \
  [--ask-pass] \
  [--use-global-secret]
Parameters:
ParameterDescription
<device_path>Path to the device. See Device path formats.
--ipDevice IP address
--userUsername for the device
--passwordPassword for the device (uses placeholder if not provided)
--hostnameDevice hostname
--portConnection port for the device. If not provided when adding a new device, port is set to None. If not provided when updating, the existing port value is preserved.
--indexDevice index. See Device indexing.
--ask-passPrompt for password securely
--use-global-secretForce use of global secret placeholder
Examples: Add a PDU with port: 
snctl rack add-device Rack/001/PDU/1 \
  --ip 192.168.10.20 \
  --user admin \
  --hostname SN40L-16-PDU1 \
  --port 3003
Add an XRDU with port: 
snctl rack add-device Rack/001/Node/0/XRDU/0 \
  --ip 192.168.6.1 \
  --user root \
  --hostname SN40L-16-H-1-XRDU0 \
  --port 3026
Update an existing device port: 
snctl rack add-device Rack/001/PDU/1 \
  --port 3004

​
Delete device

Remove a device from a rack: 
snctl rack delete-device <target_id> \
  --device-type <device_type> \
  [--index <index>]
Parameters:
ParameterDescription
<target_id>Rack ID or node name
--device-typeType of device to delete. See Device types.
--indexDevice index. See Device indexing.
Examples: Remove a PDU: 
snctl rack delete-device 001 \
  --device-type pdu \
  --index 1
Remove an XRDU: 
snctl rack delete-device 001 \
  --device-type xrdu \
  --index 0

​
Device reference

This section provides reference information for device commands.

​
Device path formats

Use these path formats when specifying devices:
FormatDescriptionExample
Rack/<rack_id>/<device_type>/<index>Rack-level devicesRack/001/PDU/1
Rack/<rack_id>/Node/<node_index>/<device_type>/<index>Node-level devices with indexRack/001/Node/0/XRDU/1
Rack/<rack_id>/Node/<node_index>/<device_type>Node-level devices without index (defaults to 0)Rack/001/Node/0/Host

​
Device types

The following device types are available: Rack-level devices:
TypeDescription
AccessSwitchAccess switch
DataSwitchData switch
PDUPower Distribution Unit
SerialTerminalSerial console server
Node-level devices:
TypeDescription
HostHost module
BMCBaseboard Management Controller
XRDUAccelerator module with two Reconfigurable Data Units™ (RDUs)

​
Device indexing

Different device types use different indexing schemes:
Device typeIndex rangeNotes
PDU1–41-indexed
XRDU0–70-indexed
Other devices0+0-indexed, defaults to 0 if not specified