HP StoreOnce Backup System CLI Reference Guide

nfs add host
Description of Command Function
Adds a host to the NFS server.
Command Syntax
nfs add host [SETX] name <hostname> [desc <description>]
Command Authority
Administrator
Command Object Requirements
SET X – This object defines an individual service set where the NAS share is to be created. 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 parameter is required and specifies the host name. It must be fewer than 100
characters long and cannot contain a forward slash (/).
• desc – This parameter is optional and specifies a description of the host name. It must be
fewer than 84 characters long.
Requirements for Command Execution
The command entry must conform to command syntax.
Successful Command Output
Upon successful completion of the command, the NAS share is created 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 is not
added to the NFS server 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 - Hostname (name) 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 - Invalid NFS host name
• Command Failed - NAS Host is already configured
Example
# nfs add host SET1 name Host1
Command Successful
nfs add host 145