Editing and deleting external storages

Limitations

You cannot rename external storages.
You cannot edit the management address of external storage if there are virtual machines using this storage.
You cannot edit the NFS share path of external NFS storage if there are virtual machines using this storage.
You cannot delete external storage if it has storage policies associated with it. You need to delete these storage policies first.
After deleting external NFS storage, the associated NFS share is left mounted.

Prerequisites

An external storage is attached to the compute cluster, as described in Attaching external iSCSI storage, Attaching external FC storage, or Attaching external NFS storage.

To edit external storage

Admin panel

On the Compute > Storage > External storages tab, click the required storage.
On the storage right pane, click Edit.
In the Edit external storage window, change the required parameters and click Save.

Command-line interface

Use the following command:

vinfra service compute storage set [--params <param=value>[,<param2=value2>,...] [--secret-params <param=value>[,<param2=value2>,...]
                                   [--param <param=value>] [--secret-param <param=value>] [--ssl-ca-cert-bundle <file>]
                                   [--nfs-mount-options <opts>] [--enable | --disable] [--unset-params <params>]
                                   [--unset-secret-params <params>] [-y] <name>

--params <param=value>[,<param2=value2>,...]

A comma-separated list of parameters in the format key=value. This option can be used multiple times.

--secret-params <param=value>[,<param2=value2>,...]

A comma-separated list of secret parameters in the format key=value. This option can be used multiple times.

--param <param=value>

Single parameter in the format key=value. The parameter value can contain the comma symbol. This option can be used multiple times.

--secret-param <param=value>

Single secret parameter in the format key=value. The parameter value can contain the comma symbol. This option can be used multiple times.

--ssl-ca-cert-bundle <file>

Path to a CA certificate file.

--nfs-mount-options <opts>

A comma-separated list of mount options for NFS compute storages, with additional flags separated by spaces. For example: lookupcache=none,nfsvers=4,minorversion=0,timeo=150,retrans=3 -m -s. To see a full list of mount options, refer to the mount and nfs man pages.

Note that if nfs_shares_config is used, these mount options are applied to every share listed in the configuration file, unless they are overwritten in the configuration file.

Setting the lookupcache policy to all is not recommended as it leads to issues with accessing volume .info files.

--enable

Enable the compute storage.

--disable

Disable the compute storage.

--unset-params <params>

A comma-separated list of parameters to unset.

--unset-secret-params <params>

A comma-separated list of secret parameters to unset.

-y, --yes

Skip yes/no prompt (assume yes).

<name>

Compute storage name.

For example, to change the share path for the external storage nfs_storage to /newshare, run:

# vinfra service compute storage set nfs_storage --params nas_share_path=/newshare

To delete external storage

Admin panel

On the Compute > Storage > External storages tab, click the required storage.
On the storage right pane, click Delete.
In the confirmation window, click Delete.
After deleting all external iSCSI or FC storages, disable multipathing:
1. Click Multipath configuration.
2. In the window that opens, turn off the toggle switch Multipath configuration or Custom multipath configuration.
3. In the confirmation window, click Disable.

Command-line interface

Delete the external storage from the compute cluster. For example, to remove the external storage pure-storage, run:
```
# vinfra service compute storage remove pure_storage
```
After deleting all external storages, reset multipath configuration to default:
```
# vinfra service compute multipath config set default
```