Adding Storage to DSX

You can add storage to a DSX node after the initial installation is complete. Each of these steps are detailed in the sections that follow:

Add storage [External task]
Refresh the configuration [Hammerspace task]
Create a logical volume [Hammerspace task]
Register the new volume [Hammerspace task]

Part 1: Adding Storage

This step is done outside of the Hammerspace interface. This example has added storage using the VMware vCenter interface. The DSX node automatically detects this storage and adds the new block devices at the operating system level. Additional steps, described in Steps 2 and 3 below, are required before the new storage is usable.

It is also possible to use a Fibre Channel storage area network (FC SAN) or an Internet Small Computer Systems Interface storage area network (iSCSI SAN) to add new storage; however, multi-pathing options are not available. In a VMware environment, it is recommended that the hypervisor present the storage to the virtual machine so that it is configured to support multi-pathing.

Part 2: Refreshing the DSX Configuration

On Anvil, log in as administrator and execute node-refresh on the DSX where you added new storage.

Admin CLI

Command:

node-refresh --name dsx.example.com --rescan

Expected output:

Name:                          dsx.example.com
Type:                          Hammerspace
Product node type:             DSX
Internal ID:                   1073741833
ID:                            6444d356-0670-5281-a795-5845396f50f1
HW state:                      OK
Node state:                    MANAGED
Node mode:                     ONLINE
<Additional output removed for brevity>

node-list: Identify the correct DSX.
node-refresh options:
- --id: ID of the DSX node.
- --rescan: Forces the DSX to discover new block devices. Does not affect existing, already discovered devices. This is a required option when adding new storage.

Part 3: Creating a New Logical Volume

Identify the added block device(s) first. In this example, the device added is /dev/sdb:

Admin CLI

Command:

drive-list --node-name dsx.example.com

Expected output:

total 6
Type:                    Hdd
ID:                      0ab5f946-f754-45d2-b689-f48dab222fdf
Name:                    /dev/dm-0
State:                   OK

Type:                    Hdd
ID:                      2fe8580b-e8d0-4304-8162-61e1599e0987
Name:                    /dev/sda
State:                   OK

Type:                    Hdd
ID:                      73595b5c-5d9f-4bcd-b892-15eeb3c1a08d
Name:                    /dev/dm-2
State:                   OK

Type:                    Hdd
ID:                      99944f5b-91db-4695-8bae-160f502c6263
Name:                    /dev/dm-1
State:                   OK

Type:                    Hdd
ID:                      b052f260-b3e5-4a7a-a368-2b17eeedc7a4
Name:                    /dev/sdc
State:                   OK

Type:                    Hdd
ID:                      fd037f43-3880-475b-a8bc-6852a0d8c817
Name:                    /dev/sdb
State:                   OK

Create a logical volume using the new device path with the --device-path option.

Admin CLI

Command:

logical-volume-create --node-name dsx.example.com --device-path /dev/sdb

Expected output:

Type:                    Logical Volume
ID:                      42a939fe-7ee7-4208-b950-c781077fc88c
Name:                    /hsvol0
Exported path:           /hsvol0
Addresses:
                         [IP: 192.0.2.21/20, Port: 3049, NetId: tcp, NodeNum: 0]
Node:                    dsx.example.com
Usage:                   DS
Reserved:                false
Filesystem type:         XFS
Capacity:                [Total: 21.4GB]
Hardware:
                         [Type: Hdd, ID: fd037f43-3880-475b-a8bc-6852a0d8c817, Name: /dev/sdb, State: OK]

Part 4: Registering the New Volume

This step creates a new file system on the logical volume and adds the new volume into the available storage configuration. Depending on how the system objectives are configured, it is possible that data will be placed on the new volume as soon as this step is complete.

The logical-volume-name is found in the output from the previous command.

Add the volume

Command:

volume-add --logical-volume-name /hsvol0 --node-name dsx.example.com

Expected output:

ID:                      8a62660e-f9d9-484a-a5d7-ab23e200a0c9
Name:                    dsx.example.com::/hsvol0
Internal ID:             19
Discovered addresses:
                         [IP: 192.0.2.21/20, Port: 3049, NetId: tcp, NodeNum: 0]
Effective IPs:
                         [IP: 192.0.2.21/20, Port: 3049, NetId: tcp, NodeNum: 0]
Path:                    /hsvol0
State:                   OK
Access type:             Read Write
Node:                    dsx.example.com
Oper state:              Up
Admin state:             Up
Capacity:                [Total: 21.4GB, Used: 216.1MB (1%), Free: 21.2GB]
Capabilities:            Max read IOPs:            10557
                         Max write IOPs:           2506
                         Min read latency:         0.328342 milliseconds
                         Min write latency:        1.874412 milliseconds
                         Max read bandwidth:       1061642 KB/s
                         Max write bandwidth:      177658 KB/s
                         NFS read request size:    1.0 MiB
                         NFS write request size:   1.0 MiB
                         Tolerable read latency:   100000 milliseconds
                         Tolerable write latency:  100000 milliseconds
                         High threshold:           75%
                         Low threshold:            60%
                         Availability:             99%
                         Availability (effective): 99%
                         Availability drop:        Disabled
                         Durability:               99.9%
                         Durability (effective):   99.9%
                         Clone status:             Functional
                         Online delay:             Online
Created:                 2026-09-22 13:31:42 UTC
Modified:                2026-09-22 13:31:42 UTC
Root file handle:        0100060042a939fe7ee74208b950c781077fc88c
Locations:
                         [Type: Node, ID: 6444d356-0670-5281-a795-5845396f50f1, Name: dsx.example.com]
                         [Type: Volume Group, ID: 275f5acb-f7a3-4010-9127-d5a9f12fca02, Name: all]
                         [Type: Storage Volume, ID: 8a62660e-f9d9-484a-a5d7-ab23e200a0c9, Name: dsx.example.com::/hsvol0]
Random writes:           Enabled

The new volume will be viewable in the UI after a short wait as the system refreshes.