> ## Documentation Index
> Fetch the complete documentation index at: https://sambanova-systems.mintlify.site/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Node administration

This guide covers viewing and managing SN40L nodes in the SambaRack Manager inventory.

<Note>
  Nodes are added automatically when you add a rack. There is no command to add a node directly.
</Note>

## Node commands

Use the following commands to view and manage nodes.

### List nodes

Display all configured nodes:

```bash theme={}
snctl node list
```

Expected output:

```text theme={}
Node Name        Part Number  Rack ID  Index
---------------  -----------  -------  -----
sn40l-16-001-n1  1001934      001      0
```

Use `-o wide` to add a **Type** column with the human-readable rack model:

```bash theme={}
snctl node list -o wide
```

```text theme={}
Node Name        Part Number  Type      Rack ID  Index
---------------  -----------  --------  -------  -----
sn40l-16-001-n1  1001934      SN40L-16  001      0
```

For machine-readable output:

```bash theme={}
snctl node list -o json
```

### Show node details

View a node and its devices:

```bash theme={}
snctl node show <node_name>
```

**Example:**

```bash theme={}
snctl node show sn40l-16-001-n1
```

Expected output:

```text theme={}
Node sn40l-16-001-n1
Component  Hostname            IP           Port  Username
---------  ------------------  -----------  ----  --------
Host       SFT-SN40L-16-H-1    172.20.3.45  3024  root
BMC        SN40L-16-H-1-SP     172.20.3.46        admin
XRDU/0     SN40L-16-H-1-XRDU0  172.20.3.47  3026  root
XRDU/1     SN40L-16-H-1-XRDU1  172.20.3.48  3025  root
XRDU/2     SN40L-16-H-1-XRDU2  172.20.3.49  3024  root
XRDU/3     SN40L-16-H-1-XRDU3  172.20.3.50  3023  root
XRDU/4     SN40L-16-H-1-XRDU4  172.20.3.51  3022  root
XRDU/5     SN40L-16-H-1-XRDU5  172.20.3.52  3021  root
XRDU/6     SN40L-16-H-1-XRDU6  172.20.3.53  3020  root
XRDU/7     SN40L-16-H-1-XRDU7  172.20.3.54  3019  root

Belongs to Rack: 001 (Part Number: 1001934)
```

Use `-o wide` to include the rack's human-readable type in the "Belongs to Rack" line:

```bash theme={}
snctl node show sn40l-16-001-n1 -o wide
```

```text theme={}
Belongs to Rack: 001 (Part Number: 1001934, Type: SN40L-16)
```

### Rename node

Assign a custom name to a node:

```bash theme={}
snctl node rename <current_name> <new_name>
```

**Example:**

```bash theme={}
snctl node rename sn40l-16-001-n1 production-node-1
```

<Note>
  Adding and removing devices is done with `snctl rack add-device` and `snctl rack delete-device`. See [Rack administration](srm-rack-admin).
</Note>

## Power operations

See [Power Operations](srm-power-admin) for target types, parallelism control, protocol overrides, and the `snd.service` readiness check.

## Firmware operations

Firmware commands are likewise their own group. Use `snctl firmware version` to audit installed versions and `snctl firmware upgrade` to push images. See [Firmware Updates](srm-firmware-updates).

## Next step

To operate on many nodes at once, group their racks and target the group. See [Group administration](srm-group-admin).