HP StoreOnce Backup System CLI Reference Guide

nfs delete host
Description of Command Function
Deletes an existing host from the NFS server.
Command Syntax
nfs delete host [SETX] name <hostname>
Command Authority
Administrator
Command Object Requirements
SET X – This object defines an individual service set from where the NAS share is to be deleted. 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.
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 host is deleted from the NFS server, 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
deleted from 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 - 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
• Command Failed - Host is configured in share
Example
# nfs delete host SET1 name Host1
Command Successful
146 Alphabetical List of Commands and Details