Managing NFS shares

Once an NFS share is created, it is started automatically. You can modify its size and redundancy scheme, stop it to change its IP address, and finally delete it.

Limitations

After creating an NFS share, you can change only the replication redundancy scheme. Changing the encoding redundancy scheme is disabled, because it may decrease cluster performance. Re-encoding demands a significant amount of cluster resources for a long period of time. If you still want to change the redundancy scheme, contact the technical support team.
You can change the IP address only for stopped NFS shares.

Prerequisites

NFS shares are created, as described in Creating NFS shares.

To stop an NFS share

Admin panel

Go to the Storage services > NFS > Shares tab.
Click the line with a running share, and then click Stop on the right pane.

Command-line interface

Use the following command:

vinfra service nfs share stop [--force] <name>

--force: Stop the NFS share forcibly
<name>: NFS share name

For example, to stop the share share1, run:

# vinfra service nfs share stop share1

To restart an NFS share

Admin panel

Go to the Storage services > NFS > Shares tab.
Click the line with a stopped share, and then click Run on the right pane.

Command-line interface

Use the following command:

vinfra service nfs share start <name>

<name>: NFS share name

For example, to start the share share1, run:

# vinfra service nfs share start share1

To reconfigure an NFS share

Admin panel

Go to the Storage services > NFS > Shares tab.
If you want to change the IP address of a share, stop the share first. To do it, click the line with the share, and then click Stop on the right pane.
To change the share parameters, click Edit on the right pane.
In the Edit window, change the IP address, size, or replication redundancy parameters, and then click Save.

Command-line interface

Use the following command:

vinfra service nfs share set [--tier {0,1,2,3}] [--replicas <norm>] [--failure-domain {0,1,2,3,4}]
                             [--size <size>] <name>

--tier {0,1,2,3}

Storage tier

--replicas <norm>

Storage replication mapping in the format:

norm: the number of replicas to maintain

--failure-domain {0,1,2,3,4}

Storage failure domain

--size <size>

NFS share size, in bytes. You can also specify the following units: KiB for kibibytes, MiB for mebibytes, GiB for gibibytes, TiB for tebibytes, and PiB for pebibytes.

<name>

NFS share name

For example, to increase the size of the share share1 to 200 GiB, run:

# vinfra service nfs share set share1 --size 200GiB

To delete an NFS share

Admin panel

Go to the Storage services > NFS > Shares tab.
Click the line with a share to remove, and then click Delete on the right pane.
If a share has exports, it can only be deleted after deleting all of them. To delete such a share, select Delete all exports in this share, and then click Delete in the confirmation window.

Command-line interface

Use the following command:

vinfra service nfs share delete <name>

<name>: NFS share name

For example, to delete the share share1, run:

# vinfra service nfs share delete share1