PowerScaleOneFS CLI Command Reference

Syntax

isi nfs exports modify <id>
  [--block-size <size>]
  [--revert-block-size]
  [--can-set-time {yes | no}]
  [--revert-can-set-time]
  [--case-insensitive {yes | no}]
  [--revert-case-insensitive]
  [--case-preserving {yes | no}] 
  [--revert-case-preserving]
  [--chown-restricted {yes | no}] 
  [--revert-chown-restricted]{yes | no}
  [--directory-transfer-size <size>]
  [--revert-directory-transfer-size]
  [--link-max <integer>]
  [--revert-link-max]
  [--max-file-size <size>]
  [--revert-max-file-size]
  [--name-max-size <integer>]
  [--revert-name-max-size]
  [--no-truncate {yes | no}]
  [--revert-no-truncate]
  [--return-32bit-file-ids {yes | no}]
  [--revert-return-32bit-file-ids]
  [--symlinks {yes | no}]
  [--revert-symlinks]
  [--new-zone <string>]
  [--description <string>]
  [--paths <path>]
  [--clear-paths]
  [--add-paths <string>]
  [--remove-paths <string>]
  [--clients <string>]
  [--clear-clients]
  [--add-clients <string>]
  [--remove-clients <string>]
  [--root-clients <string>]
  [--clear-root-clients]
  [--add-root-clients <string>]
  [--remove-root-clients <string>]
  [--read-write-clients <string>]
  [--clear-read-write-clients]
  [--add-read-write-clients <string>]
  [--remove-read-write-clients <string>]
  [--read-only-clients <string>]
  [--clear-read-only-clients]
  [--add-read-only-clients <string>]
  [--remove-read-only-clients <string>]
  [--all-dirs {yes | no}]
  [--revert-all-dirs]
  [--encoding <string>]
  [--revert-encoding]
  [--security-flavors {unix | krb5 | krb5i | krb5p}]
  [--revert-security-flavors]
  [--clear-security-flavors]
  [--add-security-flavors {unix | krb5 | krb5i | krb5p}]
  [--remove-security-flavors <string>]
  [--snapshot <snapshot>]
  [--revert-snapshot]
  [--map-lookup-uid {yes | no}]
  [--revert-map-lookup-uid]
  [--map-retry {yes | no}]
  [--revert-map-retry]
  [--map-root-enabled {yes | no}]
  [--revert-map-root-enabled]
  [--map-non-root-enabled {yes | no}]
  [--revert-map-non-root-enabled]
  [--map-failure-enabled {yes | no}]
  [--revert-map-failure-enabled]
  [--map-all <identity>]
  [--revert-map-all]
  [--map-root <identity>]
  [--revert-map-root]
  [--map-non-root <identity>]
  [--revert-map-non-root]
  [--map-failure <identity>]
  [--revert-map-failure]
  [--map-full {yes | no}]
  [--revert-map-full]
  [--commit-asynchronous {yes | no}]
  [--revert-commit-asynchronous]
  [--read-only {yes | no}]
  [--revert-read-only]
  [--readdirplus {yes | no}]
  [--revert-readdirplus]
  [--read-transfer-max-size <size>]
  [--revert-read-transfer-max-size]
  [--read-transfer-multiple <integer>]
  [--revert-read-transfer-multiple]
  [--read-transfer-size <size>]
  [--revert-read-transfer-size]
  [--setattr-asynchronous {yes | no}]
  [--revert-setattr-asynchronous]
  [--time-delta <time delta>]
  [--revert-time-delta]
  [--write-datasync-action {datasync | filesync |unstable}]
  [--revert-write-datasync-action]
  [--write-datasync-reply {datasync | filesync}]
  [--revert-write-datasync-reply]
  [--write-filesync-action {datasync | filesync |unstable}]
  [--revert-write-filesync-action]
  [--write-filesync-reply filesync]
  [--write-unstable-action {datasync | filesync |unstable}]
  [--revert-write-unstable-action]
  [--write-unstable-reply {datasync | filesync |unstable}]
  [--revert-write-unstable-reply]
  [--write-transfer-max-size <size>]
  [--revert-write-transfer-max-size]
  [--write-transfer-multiple <integer>]
  [--revert-write-transfer-multiple]
  [--write-transfer-size <size>]
  [--revert-write-transfer-size]
  [--zone <string>]
  [--ignore-unresolvable-hosts]
  [--ignore-bad-paths]
  [--ignore-bad-auth]
  [--ignore-conflicts]
  [--force]
  [--verbose]

Required Privileges

IISI_PRIV_NFS.

Options

<id>

The export ID number. You can use the isi nfs exports list command to view all the exports and their ID numbers in the current access zone.

--block-size <size>

Specifies the block size, in bytes.

--revert-block-size

Restores the setting to the system default.

--can-set-time {yes | no}

If set to yes, enables the export to set time. The default setting is no.

--revert-can-set-time

Restores the setting to the system default.

--case-insensitive {yes | no}

If set to yes, the server will report that it ignores case for file names. The default setting is no.

--revert-case-insensitive

Restores the setting to the system default.

--case-preserving {yes | no}

If set to yes, the server will report that it always preserves case for file names. The default setting is no.

--revert-case-preserving

Restores the setting to the system default.

--chown-restricted {yes | no}

If set to yes, the server will report that only the superuser can change file ownership. The default setting is no.

--revert-chown-restricted

Restores the setting to the system default.

--directory-transfer-size <size>

Specifies the preferred directory transfer size. Valid values are a number followed by a case-sensitive unit of measure: b for bytes; K for KB; M for MB; or G for GB. If no unit is specified, bytes are used by default. The maximum value is 4294967295b. The initial default value is 128K.

--revert-directory-transfer-size

Restores the setting to the system default.

--link-max <integer>

The reported maximum number of links to a file.

--revert-link-max

Restores the setting to the system default.

--max-file-size <size>

Specifies the maximum allowed file size on the server (in bytes). If a file is larger than the specified value, an error is returned.

--revert-max-file-size

Restores the setting to the system default.

--name-max-size <integer>

The reported maximum length of characters in a filename.

--revert-name-max-size

Restores the setting to the system default.

--no-truncate {yes | no}

If set to yes, too-long file names will result in an error rather than be truncated.

--revert-no-truncate

Restores the setting to the system default.

--return-32bit-file-ids {yes | no}

Applies to NFSv3 and later. If set to yes, limits the size of file identifiers returned from readdir to 32-bit values. The default value is no.

NOTE: This setting is provided for backward compatibility with older NFS clients, and should not be enabled unless necessary.

--revert-return-32bit-file-ids

Restores the setting to the system default.

--symlinks {yes | no}

If set to yes, advertises support for symlinks. The default setting is no.

--revert-symlinks

Restores the setting to the system default.

--new-zone <string>

Specifies a new access zone in which the export should apply. The default zone is system.

--description <string>

The description for this NFS export.

--paths <paths> ...

Required. Specifies the path to be exported, starting at /ifs. This option can be repeated to specify multiple paths.

--clear-paths

Clear any of the paths originally specified for the export. The path must be within the /ifs directory.

--add-paths <paths> ...

Add to the paths originally specified for the export. The path must be within /ifs. This option can be repeated to specify multiple paths.

--remove-paths <paths> ...

Remove a path from the paths originally specified for the export. The path must be within /ifs. This option can be repeated to specify multiple paths to be removed.

--clients <string>

Specifies a client to be allowed access through this export. Specify clients as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can add multiple clients by repeating this option.

--clear-clients

Clear the full list of clients originally allowed access through this export.

--add-clients <string>

Specifies a client to be added to the list of clients with access through this export. Specify clients to be added as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can add multiple clients by repeating this option.

--remove-clients <string>

Specifies a client to be removed from the list of clients with access through this export. Specify clients to be removed as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can remove multiple clients by repeating this option.

--root-clients <string>

Allows the root user of the specified client to execute operations as the root user of the cluster. This option overrides the --map-all and --map-root option for the specified client.

Specify clients as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can specify multiple clients in a comma-separated list.

--clear-root-clients

Clear the full list of root clients originally allowed access through this export.

--add-root-clients <string>

Specifies a root client to be added to the list of root clients with access through this export. Specify root clients to be added as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can add multiple root clients by repeating this option.

--remove-root-clients <string>

Specifies a root client to be removed from the list of root clients with access through this export. Specify root clients to be removed as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can remove multiple root clients by repeating this option.

--read-write-clients <string>

Grants read/write privileges to the specified client for this export. This option overrides the --read-only option for the specified client.

Specify clients as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can specify multiple clients in a comma-separated list.

--clear-read-write-clients

Clear the full list of read-write clients originally allowed access through this export.

--add-read-write-clients <string>

Specifies a read-write client to be added to the list of read-write clients with access through this export. Specify read-write clients to be added as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can add multiple read-write clients by repeating this option.

--remove-read-write-clients <string>

Specifies a read-write client to be removed from the list of read-write clients with access through this export. Specify read-write clients to be removed as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can remove multiple read-write clients by repeating this option.

--read-only-clients <string>

Makes the specified client read-only for this export. This option overrides the --read-only option for the specified client.

Specify clients as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can specify multiple clients in a comma-separated list.

--clear-read-only-clients

Clear the full list of read-only clients originally allowed access through this export.

--add-read-only-clients <string>

Specifies a read-only client to be added to the list of read-only clients with access through this export. Specify read-only clients to be added as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can add multiple read-only clients by repeating this option.

--remove-read-only-clients <string>

Specifies a read-only client to be removed from the list of read-only clients with access through this export. Specify read-only clients to be removed as an IPv4 or IPv6 address, hostname, netgroup, or CIDR range. You can remove multiple read-only clients by repeating this option.

--all-dirs {yes | no}

If set to yes, this export will cover all directories. The default setting is no.

--revert-all-dirs

Restores the setting to the system default.

--encoding <string>

Specifies the character encoding of clients connecting through this NFS export.

Valid values and their corresponding character encodings are provided in the following table. These values are taken from the node's /etc/encodings.xml file, and are not case sensitive.

Table 1. Encoding valuesAvailable values.

Value	Encoding
cp932	Windows-SJIS
cp949	Windows-949
cp1252	Windows-1252
euc-kr	EUC-KR
euc-jp	EUC-JP
euc-jp-ms	EUC-JP-MS
utf-8-mac	UTF-8-MAC
utf-8	UTF-8
iso-8859-1	ISO-8859-1 (Latin-1)
iso-8859-2	ISO-8859-2 (Latin-2)
iso-8859-3	ISO-8859-3 (Latin-3)
iso-8859-4	ISO-8859-4 (Latin-4)
iso-8859-5	ISO-8859-5 (Cyrillic)
iso-8859-6	ISO-8859-6 (Arabic)
iso-8859-7	ISO-8859-7 (Greek)
iso-8859-8	ISO-8859-8 (Hebrew)
iso-8859-9	ISO-8859-9 (Latin-5)
iso-8859-10	ISO-8859-10 (Latin-6)
iso-8859-13	ISO-8859-13 (Latin-7)
iso-8859- 14	ISO-8859-14 (Latin-8)
iso-8859-15	ISO-8859-15 (Latin-9)
iso-8859-16	ISO-8859-16 (Latin-10)

--revert-encoding

Restores the setting to the system default.

--security-flavors {unix | krb5 | krb5i | krb5p}

Specifies a security flavor to support. To support multiple security flavors, repeat this option for each additional entry. The following values are valid:

unix

UNIX (system) authentication.

krb5

Kerberos V5 authentication.

krb5i

Kerberos V5 authentication with integrity.

krb5p

Kerberos V5 authentication with privacy.

--revert-security-flavors

Restores the setting to the system default.

--clear-security-flavors

Clears the value for supported security flavors.

--add-security-flavors {unix | krb5 | krb5i | krb5p}

Adds supported security flavors. Repeat for each additional supported security flavor to add.

--remove-security-flavors

Removes supported security flavors. Repeat for each additional supported security flavor to remove from the list.

--snapshot {<snapshot> | <snapshot-alias>}

Specifies the ID of a snapshot or snapshot alias to export. If you specify this option, directories will be exported in the state captured in either the specified snapshot or the snapshot referenced by the specified snapshot alias. If the snapshot does not capture the exported path, the export will be inaccessible to users.

If you specify a snapshot alias, and the alias is later modified to reference a new snapshot, the new snapshot will be automatically applied to the export.

Because snapshots are read-only, clients will not be able to modify data through the export unless you specify the ID of a snapshot alias that references the live version of the file system.

Specify <snapshot> or <snapshot-alias> as the ID or name of a snapshot or snapshot alias.

--revert-snapshot

Restores the setting to the system default.

--map-lookup-uid {yes | no}

If set to yes, incoming UNIX user identifiers (UIDs) will be looked up locally. The default setting is no.

--revert-map-lookup-uid

Restores the setting to the system default.

--map-retry {yes | no}

If set to yes, the system will retry failed user-mapping lookups. The default setting is no.

--revert-map-retry

Restores the setting to the system default.

--map-root-enabled {yes | no}

Enable/disable mapping incoming root users to a specific account.

--revert-map-root-enabled

Restores the setting to the system default.

--map-non-root-enabled {yes | no}

Enable/disable mapping incoming non-root users to a specific account.

--revert-map-non-root-enabled

Restores the setting to the system default.

--map-failure-enabled {yes | no}

Enable/disable mapping users to a specific account after failing an auth lookup.

--revert-map-failure-enabled

Restores the setting to the system default.

--map-all <identity>

Specifies the default identity that operations by any user will execute as. If this option is not set to root, you can allow the root user of a specific client to execute operations as the root user of the cluster by including the client in the --root-clients list.

--revert-map-all

Restores the setting to the system default.

--map-root <identity>

Map incoming root users to a specific user and/or group ID.

--revert-map-root

Restores the setting to the system default.

--map-non-root <identity>

Map non-root users to a specific user and/or group ID.

--revert-map-non-root

Restores the setting to the system default.

--map-failure <identity>

Map users to a specific user and/or group ID after a failed auth attempt.

--revert-map-failure

Restores the setting to the system default.

--map-full {yes | no}

Determines how user mapping is accomplished if a user is specified in an export option such as --map-root or --map-all. When enabled, a user mapping queries the OneFS user database and retrieves users from the applicable authentication subsystem, such as local authentication or Active Directory. When disabled, only local authentication is queried.

The default setting is yes.

--revert-map-full

Restores the --map-full setting to the system default, yes.

--commit-asynchronous {yes | no}

If set to yes, enables commit data operations to be performed asynchronously. The default setting is no

--revert-commit-asynchronous

Restores the setting to the system default.

--read-only {yes | no}

Determines the default privileges for all clients accessing the export.

If set to yes, you can grant read/write privileges to a specific client by including the client in the --read-write-clients list.

If set to no, you can make a specific client read-only by including the client in the --read-only-clients list. The default setting is no.

--revert-read-only

Restores the setting to the system default.

--readdirplus {yes | no}

Applies to NFSv3 only. If set to yes, enables processing of readdir-plus requests. The default setting is yes.

--revert-readdirplus

Restores the setting to the system default.

--read-transfer-max-size <size>

Specifies the maximum read transfer size to report to NFSv3 and NFSv4 clients. Valid values are a number followed by a case-sensitive unit of measure: b for bytes; K for KB; M for MB; or G for GB. If no unit is specified, bytes are used by default. The maximum value is 4294967295b. The initial default value is 1M.

--revert-read-transfer-max-size

Restores the setting to the system default.

--read-transfer-multiple <integer>

Specifies the suggested multiple read size to report to NFSv3 and NFSv4 clients. Valid values are 0-4294967295. The initial default value is 512.

--revert-read-transfer-multiple

Restores the setting to the system default.

--read-transfer-size <size>

Specifies the preferred read transfer size to report to NFSv3 and NFSv4 clients. Valid values are a number followed by a case-sensitive unit of measure: b for bytes; K for KB; M for MB; or G for GB. If no unit is specified, bytes are used by default. The maximum value is 4294967295b, or lower if the --read-transfer-max-size is set to a lesser value. The initial default value is 128K.

--revert-read-transfer-size

Restores the setting to the system default.

--setattr-asynchronous {yes | no}

If set to yes, performs set-attributes operations asynchronously. The default setting is no.

--revert-setattr-asynchronous

Restores the setting to the system default.

--time-delta <float>

Specifies server time granularity, in seconds.

--revert-time-delta

Restores the setting to the system default.

--write-datasync-action {datasync | filesync | unstable}

Applies to NFSv3 and NFSv4 only. Specifies an alternate datasync write method. The following values are valid:

• datasync
• filesync
• unstable

The default value is datasync, which performs the request as specified.

--revert-write-datasync-action

Restores the setting to the system default.

--write-datasync-reply {datasync | filesync}

Applies to NFSv3 and NFSv4 only. Specifies an alternate datasync reply method. The following values are valid:

• datasync
• filesync

The default value is datasync (does not respond differently).

--revert-write-datasync-reply

Restores the setting to the system default.

--write-filesync-action {datasync | filesync | unstable}

Applies to NFSv3 and NFSv4 only. Specifies an alternate filesync write method. The following values are valid:

• datasync
• filesync
• unstable

The default value is filesync, which performs the request as specified.

--revert-write-filesync-action

Restores the setting to the system default.

--write-filesync-reply {filesync}

Applies to NFSv3 and NFSv4 only. Specifies an alternate filesync reply method. The only valid value is filesync (does not respond differently).

--write-unstable-action {datasync | filesync | unstable}

Specifies an alternate unstable-write method. The following values are valid:

• datasync
• filesync
• unstable

The default value is unstable, which performs the request as specified.

--revert-write-unstable-action

Restores the setting to the system default.

--write-unstable-reply {datasync | filesync | unstable}

Specifies an alternate unstable-reply method. The following values are valid:

• datasync
• filesync
• unstable

The default value is unstable (does not respond differently).

--revert-write-unstable-reply

Restores the setting to the system default.

--write-transfer-max-size <size>

Specifies the preferred maximum write transfer size to report to NFSv3 and NFSv4 clients. Valid values are a number followed by a case-sensitive unit of measure: b for bytes; K for KB; M for MB; or G for GB. If no unit is specified, bytes are used by default. The maximum value is 4294967295b. The initial default value is 1M.

--revert-write-transfer-max-size

Restores the setting to the system default.

--write-transfer-multiple <integer>

Specifies the suggested write transfer multiplier to report to NFSv3 and NFSv4 clients. Valid values are 0-4294967295. The initial default value is 512.

--revert-write-transfer-multiple

Restores the setting to the system default.

--write-transfer-size <size>

Specifies the preferred write transfer size to report to NFSv3 and NFSv4 clients. Valid values are a number followed by a case-sensitive unit of measure: b for bytes; K for KB; M for MB; or G for GB. If no unit is specified, bytes are used by default. The maximum value is 4294967295b, or lower if the --write-transfer-max-size is set to a lesser value. The initial default value is 512K.

--revert-write-transfer-size

Restores the setting to the system default.

--zone

Access zone in which the export was originally created.

--ignore-unresolvale-hosts

Does not present an error condition on unresolvable hosts when creating or modifying an export.

--ignore-bad-paths

Does not present an error condition on bad paths when creating or modifying an export.

--ignore-bad-auth

Ignores bad authentication for mapping options when creating or modifying an export.

--ignore-conflicts

Ignores conflicts between the new or modified exports and the existing configuration.

{--force | -f}

If set to no (default), a confirmation prompt displays when the command runs. If set to yes, the command executes without prompting for confirmation.

{--verbose | -v}

Displays more detailed information.

--help | -h

Display help for this command.