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