Location
Using the location parameter of the storpool command you can configure other StorPool sub-clusters in
the same or different location (see Multi-site and multi-cluster). The
command can be used for adding, listing, removing, renaming, and updating locations.
When performing these operations you should provide the name or ID of a location. The
location ID is the first part (left of the .) in the SP_CLUSTER_ID
option (see Cluster ID) configured in the remote cluster.
Adding a location
To add a location with SP_CLUSTER_ID=nzkr.b you need to use the add argument and provide the ID and name:
# storpool location add nzkr StorPoolLab-Sofia
OK
Listing locations
To list the configured locations you should use the list argument:
# storpool location list
-----------------------------------------------
| id | name | rxBuf | txBuf |
-----------------------------------------------
| nzkr | StorPoolLab-Sofia | 85 KiB | 128 KiB |
-----------------------------------------------
The values in the list are as follows:
id: A unique location ID.name: The human-readable location name.rxBuf: The size of the TCP receive buffer for the location.txBuf: The size of the TCP send buffer for the location.
Renaming a location
To rename a location you need to provide first the rename argument with the old name, and then the name argument with the new name:
# storpool location rename StorPoolLab-Sofia name StorPoolLab-Amsterdam
OK
Removing a location
To remove a location you should use the remove argument and provide the name:
# storpool location remove StorPoolLab-Sofia
OK
Note
This command will fail if there is an existing cluster or a remote bridge configured for this location
Updating a location
To update the send or receive buffer sizes to values different from the
defaults you should use the update argument with the name of the location and
specify values using the sendBufferSize and recvBufferSize arguments (respectively):
# storpool location update StorPoolLab-Sofia recvBufferSize 16M
OK
# storpool location update StorPoolLab-Sofia sendBufferSize 1M
OK
# storpool location list
-----------------------------------------------
| id | name | rxBuf | txBuf |
-----------------------------------------------
| nzkr | StorPoolLab-Sofia | 16 MiB | 1.0 MiB |
-----------------------------------------------