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.
You cannot delete an NFS share that has exports.

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.
Select a running share, and then click Stop.

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 screen.
Select a stopped share, and then click Start.

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, and then select a share.
If you want to change the IP address, stop the share by clicking Stop.
Click Configure.
On the Share parameters pane, 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.
Select a share, and then click Remove.
Click Yes in the confirmation window.

Command-line interface

Use the following command:

vinfra service nfs share delete <name>

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

For example, to delete the share share1, run:

# vinfra service nfs share delete share1