HP StoreOnce Backup System CLI Reference Guide

nfs modify host
Description of Command Function
Modifies the properties of an NFS host.
Command Syntax
nfs modify host [SETX] name <hostname> desc <description>
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.
Command Parameter Requirements
• name – This required parameter specifies the host name.
• desc – This required parameter specifies the new description for the specified host name. It
must be fewer than 84 characters long.
Requirements for Command Execution
• The command entry must conform to command syntax.
• The service set SETX object must be valid.
• The host name must exist on the NFS server.
Successful Command Output
Upon successful completion of the command, the properties of the NFS host are modified, 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
properties are not modified, 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 - Description (desc) not specified
• Command Failed - Service set ID (SETX) not specified
• Command Failed - Parameter ‘X’ requires argument
• Command Failed - Invalid parameter ‘X’
• Command Failed - Parameter ‘X’ specifies invalid value
• Command Failed - Invalid parameter value: X
• Command Failed - No such host: X
Example
# nfs modify host SET1 name Host1 desc Primary host
Command Successful
nfs modify host 151