HP StoreOnce Backup System CLI Reference Guide

nfs disable host
Description of Command Function
Disables specific host authentication for an NFS share.
NOTE: When you create a share with the CLI, by default, other users are unable to access that
share. You must enable read/write permissions on the share in order for other users to access the
share by using the nfs enable host command.
If you wish to remove those permissions, you use this disable command.
Command Syntax
nfs disable host [SETX] SHAREX name <hostname>
Command Authority
Administrator
Command Object Requirements
• SET X – This object defines an individual service set. X is a unique numeric index. This object
is required for a multi-node system and optional for a single-node system. If it is omitted for a
single-node system, it defaults to SET1. If the object is specified (either for a multi-node or
single-node system), it must be specified in the exact position as given by the command syntax,
i.e., it must immediately follow the host command.
• SHARE X – This object is required. X is a unique numeric index of the share. It must be specified
in the exact position as given by the command syntax (i.e., it must immediately follow the
SETX object, or if the SETX object is omitted, it must immediately follow the host command).
Command Parameter Requirements
name – This required parameter specifies the host name.
Requirements for Command Execution
• The command entry must conform to command syntax.
• The service set SETX object must be valid.
• The share SHAREX object must be valid.
• The host name must exist on the NFS server.
Successful Command Output
Upon successful completion of the command, the NSF host authentication is disabled, and the
following is displayed:
Command Successful
Command Operation During Abnormal Conditions
If any of the command execution requirements fail, command execution terminates, the host
authentication is not disabled, and one of these error messages is displayed:
• Command Failed - The command does not conform to the required syntax,
SYNTAX, where SYNTAX is the command syntax as described under Command Syntax in this
section.
• Command Failed - Invalid number of arguments
• Command Failed - Service set ID (SETX) not specified
• Command Failed - Service set ID (SHAREX) not specified
• Command Failed - Parameter ‘X’ requires argument
• Command Failed - Invalid parameter ‘X’
• Command Failed - Parameter ‘X’ specifies invalid value
nfs disable host 147