Configuring node locations

The location for a node can be selected before it is joined to the storage cluster. By default, the nodes are added to the Default rack in the Default row in the Default room.

Locations are designed to be used as failure domains. You can create locations, move nodes between them, rename and delete locations.

Limitations

The location can be changed for unassigned nodes only. If the node is added to the storage cluster, release it first. After moving the node, you will be able to join it back to the cluster.
You can only delete empty locations. If a location contains some nodes, move them first. The default location cannot be deleted as well. However, you can rename it to match your infrastructure.

Prerequisites

A clear understanding of the concept Failure domains.

To create locations

Admin panel

On the Infrastructure > Nodes screen, click the icon to show the node filters and location (if hidden).
In the location sidebar, click the top of the tree with the cluster name.
Click the Create room toolbar button and enter the room name.
To add a new row, click the created room. Click the Create row button and enter a name for it.
To add a new rack, click the created row. Click the Create rack button and enter a name for it. You can now move nodes to this rack.

Command-line interface

Use the following command:

vinfra location create --fd <fd> --name <location-name> [--parent-id <parent-id>]

--fd <fd>: Failure domain ID: 0=disk, 1=host, 2=rack, 3=row, 4=room. You can view the list of failure domains by using vinfra failure domain list.
--name <location-name>: Name of the location to be created
--parent-id <parent-id>: ID of the parent location where the child location should be created in

For example, to create the location row2, run:

# vinfra location create --fd 3 --name row2 --parent-id 0
+----------+-------+
| Field    | Value |
+----------+-------+
| children | []    |
| id       | 1     |
| name     | row2  |
| parent   | 0     |
+----------+-------+

To create a location of level 4 (room), do not use the --parent-id argument.

The created location will appear in the vinfra location list output:

# vinfra location list --fd 3
+----+-------------+--------+----------+
| id | name        | parent | children |
+----+-------------+--------+----------+
| 0  | Default row | 0      | - 0      |
| 1  | row2        | 0      | []       |
+----+-------------+--------+----------+

To rename locations

Admin panel

On the Infrastructure > Nodes screen, click the icon to show the node filters and location (if hidden).
In the location sidebar, click the parent location for the item you want to rename. For example, click the row if you want to rename a rack in it.
In the list, click the required location. On the right pane, click Rename and enter a new name.

The location will be renamed.

You can rename the room, row, and rack locations by using the command-line interface. For example, you can rename rack to chassis to match your actual server location.

Command-line interface

Use the following command:

vinfra location rename --fd <fd> --id <location-id> --name <location-name>

--fd <fd>: Failure domain ID: 0=disk, 1=host, 2=rack, 3=row, 4=room. You can view the list of failure domains by using vinfra failure domain list.
--id <location-id>: ID of the location to rename
--name <location-name>: A new location name

For example, to rename the location with the ID 1 to row_renamed, run:

# vinfra location rename --fd 3 --id 1 --name row_renamed

You can also change names for failure domain levels 2, 3 and 4 by using the following command:

vinfra failure domain rename {2,3,4} <singular-name> <plural-name>

{2,3,4}: Failure domain ID: 0=disk, 1=host, 2=rack, 3=row, 4=room. You can view the list of failure domains by using vinfra failure domain list.
<singular-name>: Singular name of the specified failure domain
<plural-name>: Plural name of the specified failure domain

For example, to rename the failure domain 2 to chassis, run:

# vinfra failure domain rename 2 chassis chassis

If you use a name other than zone, enclosure, chassis, blade server, it will be replaced with location in the admin panel.

To move nodes to a new location

On the Infrastructure > Nodes screen, there are two ways to move a node to a new location. Either from the node location tree, you can select the rack to move the node to, and click Move nodes. Or you can click the line with a node to move, and click Move node on the right pane.
In the Move nodes window, select the required node/location and click Move.
You can now join this node to the cluster. To do this, click the line with the node, and on the right pane click Join to cluster. Click Join in the open window.

The node will be moved to the specified location.

To delete locations

Admin panel

On the Infrastructure > Nodes screen, click the icon to show the node filters and location (if hidden).
In the location sidebar, click the parent location for the item you want to delete. For example, click the row if you want to delete a rack from it.
In the list, click the required location. On the right pane, click Delete.

The location will be deleted.

Command-line interface

Use the following command:

vinfra location delete --fd <fd> --id <location-id>

--fd <fd>: Failure domain ID: 0=disk, 1=host, 2=rack, 3=row, 4=room. You can view the list of failure domains by using vinfra failure domain list.
--id <location-id>: ID of the location to delete

For example, to delete the location with the ID 1, run:

# vinfra location delete --fd 3 --id 1