Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Baskets

Dell Unity™ Family Unisphere® Command Line Interface User Guide

PDF

Change NFS share settings

Change the settings of an NFS share.

Format

/stor/prov/fs/nfs {-id <value> | -name <value>} set [-async] [-descr <value>] [-defAccess { ro | rw | roroot | root | na }] [-advHostMgmtEnabled { yes | no }] [{[-roHosts <value>] [-rwHosts <value>] [-roRootHosts <value>] [-rootHosts <value>] [-naHosts <value>] [-addRoHosts <value>] [-addRwHosts <value>] [-addRoRootHosts <value>] [-addRootHosts <value>] [-addNaHosts <value>] [-removeHosts <value>]}] [-minSecurity {sys | krb5 | krb5i | krb5p}] [-allowSuid {yes | no}] [-anonUid <value>] [-anonGid <value>]

Object qualifiers

QualifierDescription
-idType the ID of an NFS share to change. View NFS share settings explains how to view the IDs of the NFS network shares on the system.
-nameType the name of an NFS share to change.

Action qualifiers

QualifierDescription
-asyncRun the operation in asynchronous mode.
-descrType a brief description of the share.
-defAccessSpecify the default share access settings for host configurations and for unconfigured hosts who can reach the share. Value is one of the following:
  • ro—Hosts have read-only access to primary storage and snapshots that are associated with the share.
  • rw—Hosts have read/write access to primary storage and snapshots that are associated with the share.
  • roroot—Hosts have read-only root access to primary storage and snapshots that are associated with the share.
  • root—Hosts have read/write root access to primary storage and snapshots that are associated with the share. This value includes the ability to set access controls that restrict the permissions for other login accounts.
  • na—Hosts have no access to the share or its snapshots.
-advHostMgmtEnabled Specifies whether the hosts that are specified in the hosts lists are defined using /remote/host objects as their identifier (advanced host management). Values are (case insensitive):
  • yes (default)—Hosts lists contain the IDs of registered hosts.
  • no—Host lists contain comma-separated strings, with each string defining a host name, IP, subnet, netgroup, or DNS domain.

This setting may be updated only if the five hosts list below are empty.

-roHosts Specifies the comma-separated list of identifiers of hosts that are allowed to read the NFS share. It overwrites the existing read-only hosts.
-rwHosts Specifies the comma-separated list of identifiers of hosts that are allowed to read and write the NFS share. It overwrites the existing read/write hosts.
-roRootHosts Specifies the comma-separated list of identifiers of hosts with read-only root permissions to the NFS share. It overwrites the existing read-only root hosts.
-rootHosts Specifies the comma-separated list of identifiers of hosts with root permissions to the NFS share. It overwrites the existing read/write root hosts.
-naHosts Specifies the comma-separated list of identifiers of hosts without access to the NFS share. It overwrites the existing no access hosts.
-addRoHosts Specifies the comma-separated list of hosts to be added with read-only access to the NFS share. This option allows you to incrementally add hosts with read-only access to NFS share. It does not overwrite all existing read-only hosts.
-addRwHosts Specifies the comma-separated list of hosts to be added with read/write access to the NFS share. This option allows you to incrementally add hosts with read/write access to the NFS share. It does not overwrite all existing read/write hosts.
-addRoRootHosts Specifies the comma-separated list of hosts to be added with read-only root access to the NFS share. This option allows you to incrementally add hosts with read-only root access to the NFS share. It does not overwrite all existing read-only root hosts.
-addRootHosts Specifies the comma-separated list of hosts to be given read/write root access to the NFS share. This option allows you to incrementally add hosts with read/write root access to the NFS share. It does not overwrite all existing read/write hosts with read/write root access.
-addNaHosts Specifies the comma-separated list of hosts that have no access to the NFS share. This option allows you to incrementally specify hosts that will have no access to the NFS share. It does not overwrite all existing no-access hosts.
-removeHosts Specifies the comma-separated list of hosts for which access to the NFS share will be removed. This option allows you to incrementally remove host access to the NFS share.
-minSecuritySpecifies a minimal security option that must be provided by the client for an NFS mount operation. The value is one of the following, from lower to higher security level. All higher security levels are supported, and can be enforced by the client at negotiations for secure NFS access.
  • sys—No server-side authentication (server relies on NFS client authentication)

    This option is also known as AUTH_SYS security.

  • krb5—Kerberos v5 authentication
  • krb5i—Kerberos v5 authentication and integrity
  • krb5p—Kerberos v5 authentication and integrity; encryption is enabled
-allowSuidSpecifies whether to allow users to set the setuid and setgid UNIX permission bits. Values are (case insensitive):
  • yes (default)—Users can set the setuid and setgid—UNIX permission bits. This value allows users to run the executable with the privileges of the file owner.
  • no—Users cannot set the setuid and setgid—UNIX permission bits.
-anonUidSpecify the UID of the anonymous account.
-anonGidSpecify the GID of the anonymous account.

Example 1

The following command changes NFS share NFSShare_1 to block access to the share and its snapshots for host HOST_1:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/fs/nfs –id NFSShare_1 set -descr “My share” -naHosts ”HOST_1” 
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = NFSShare_1
Operation completed successfully.

Example 2

The following command changes NFS share NFSShare_1 to add read-only access to the share and its snapshots for host HOST_3.

NOTE:HOST_2, HOST_4, and HOST_5 already have ready-only access to the share, but the entire list of current read-only hosts must be specified whenever you remove or add a new read-only host.
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/fs/nfs –id NFSShare_1 set -roHosts HOST_2, HOST_3, HOST_4, HOST_5 
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = NFSShare_1
Operation completed successfully.

Example 3

The following example shows host access changes to NFSShare_2. Host_2 is added as a read-only host, Host_3 is added as a read/write host, and access is removed for Host_1:

uemcli /stor/prov/fs/nfs -id NFSShare_2 set -addRoHosts Host_2 -addRwHosts Host_3 -removeHosts Host_1 
ID = NFSShare_2
Operation completed successfully.

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\