HP D2D2502i HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem
HP D2D2502i Manual
View all HP D2D2502i manuals
Add to My Manuals
Save this manual to your list of manuals |
HP D2D2502i manual content summary:
- HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 1
HP StoreOnce Backup System CLI Reference Guide Abstract This document details the set of operations supported by the Common CLI. This command set defines the instructions used to obtain information about a StoreOnce Backup system appliance or to control the appliance's activity. It is intended for - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 2
HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated. Java and Oracle are registered trademarks - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 3
Command Entry...7 Viewing Help...7 Transferring Files...7 Scripting...7 2 Command Instruction Syntax 8 Global Defaults...9 3 Categorical List of Commands 10 show net status...46 hardware show node status...48 hardware show problems...49 hardware show status...50 hardware show storage status 53 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 4
user...118 support create ticket...119 support del ticket...120 support show ticket...121 system clear packages...122 system clear repository...123 system disable failover...124 system enable failover...125 system load packages...126 system reboot...127 system set clioutput...128 system set config - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 5
show status...143 system shutdown...145 system update packages...146 time add ntpserver...147 time del vtl show library list...188 vtl show ports...189 5 Support and other resources 191 Contacting HP...191 Related information...191 Websites...191 Typographic conventions...191 Documentation - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 6
>@ The Common CLI instruction set supports different authorization levels that permit execution of different subsets of commands. Each authorization level has a unique command prompt. The accounts in Table 1 (page 6) are created at the time of the StoreOnce system installation - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 7
Table 1 Login Information (continued) Authorization Level Can Execute User Name the StoreOnce appliance. Password Command Prompt Command Entry Upon log in, the cursor appears after the command prompt. Instruction entry elements are placed after the prompt by entering the appropriate characters - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 8
the action of the operation. • Objects - represent an item associated with a StoreOnce appliance. It may be a physical item, such as a network interface, or a virtual item, such as a virtual tape cartridge. Not all instructions contain objects, but up to three is possible. • Parameters - define - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 9
global default is used to represent the Common CLI.) The object currently active. Default settings as define by HP. The GUI associated with the StoreOnce appliance support by the Common CLI. (To support high availability, the instance of the GUI can exist on any node, a VIF is used to define the - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 10
ports" (page 43) "hardware show firmware" (page 44) "hardware show net status" (page 46) "hardware show node status" (page 48) "hardware show problems" (page 49) "hardware show status" (page 50) "hardware show storage status" (page 53) "hardware update firmware" (page 54) help (see "help" (page - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 11
" (page 114) "snmp set ro-community" (page 115) "snmp show config" (page 116) "snmp show user" (page 118) support "support create ticket" (page 119) "support del ticket" (page 120) "support show ticket" (page 121) system "system clear packages" (page 122) "system clear repository" (page 123) 11 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 12
set description" (page 136) "system set pagecontrol" (page 137) "system show config" (page 138) "system show packages" (page 139) "system show performance" (page 140) "system show repository" (page 142) "system show status" (page 143) "system shutdown" (page 145) "system update packages" (page 146 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 13
4 Alphabetical List of Commands and Details accounts add Description of Command Function Creates an account that interfaces with the StoreOnce appliance using the CLI or GUI. NOTE: The standard factory or restore image already contains the account Admin with the administrator authority level and the - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 14
account ACCOUNT added, where ACCOUNT is the string label of the new account. Command Operation during Abnormal Conditions • If the command does not conform to the required syntax, the following is displayed: Command Failed - the command does not conform to the required syntax, SYNTAX, where SYNTAX - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 15
accounts del Description of Command Function Deletes an existing account. NOTE: Accounts can only be deleted if the user is logged in with an account with at least the same level of command authority/permission as the account being deleted. Command Syntax accounts del Command Authority - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 16
, numbers and the following symbols • If the account label included in the command does not match an existing account, the following is displayed: No such D2D User: ACCOUNT 16 Alphabetical List of Commands and Details - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 17
Example # accounts modify Joe_Operator newpassword F00tB*ll F00tB*ll account Joe_Operator modified To modify the password of the currently active account: # accounts modify newpassword F00tB*ll F00tB*ll account (current account name) modified accounts modify 17 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 18
user accounts and their authority level defined for the StoreOnce appliance. Command Syntax accounts show [CURRENT] Command Authority account. • A user with admin permissions will see all accounts on the system. Successful Command Output Upon successful completion of the command, the following is - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 19
User Name Type Authority HERZOG-AD1\mayuri123 External User admin accounts show 19 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 20
alerts show Description of Command Function Lists all events with a severity of "critical" or "error." NOTE: The command logs show events can also be used to show all events or filtered events, not just critical or error events. See "logs show events" (page 61). Command Syntax alerts show [ - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 21
config delete Description of Command Function Deletes a configuration file that exists in the configuration jail directory. Command Syntax config delete Command Authority Administrator Command Object Requirements ConfigFile - This required object is the configuration file which is - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 22
about the configuration save and restore process, see the HP StoreOnce Backup System User Guide (single-node or multi-node, depending on your product of the service set. You can include more than one service set. If no service sets are defined, the restore is performed on all the service sets in - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 23
number of nodes) ◦ Command Failed - The system hardware does not match the configuration file (service set does not exist) ◦ Command Failed - execution, verify devices have been configured on system as expected • Errors generated by the d2d serviceset restore process are prefixed with " - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 24
config restore keystore Description of Command Function Restores a saved keystore from the file specified to the device. This operation requires the password originally given to the save command in order to decrypt the keystore. Command Syntax config restore keystore Command Authority - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 25
information about the configuration save and restore process, see the HP StoreOnce Backup System User Guide (single-node or multi-node, depending on your product). Command Syntax in this section. • Errors generated by the d2d serviceset save process are prefixed with "Command Failed" and displayed - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 26
to encrypt the keystore. This password will be required to restore the keystore to the device. Keep a copy in a safe place outside of the backup system directory. You will need to re-enter the password to confirm before the command is finally executed. Command Authority Administrator Command Object - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 27
config show list Description of Command Function Displays a list of saved configuration files or keystores. A saved configuration file is any file located in the config jail directory with the .zip extension. (A configuration file listed by this may not be a valid configuration file. The user must - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 28
exit Description of Command Function Terminates a CLI session. Command Syntax exit Command Authority Operator and Administrator Command Object Requirements Not applicable - no objects exist within this command. Command Parameter Requirements Not applicable - no parameters exist within this command. - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 29
newly discovered storage does not exist, the following is displayed: Command Failed - New storage does not exist. Add physical storage to D2D system and execute the "hardware discover storage" command • If the storage discovery process in currently being executed, the following message is displayed - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 30
single-node products only. Description of Command Function Turns on or off the beacon for a hardware component. (The hardware component must support the beacon feature.) Command Syntax hardware beacon {on|off} Command Authority Operator and Administrator Command Object Requirements dev-id - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 31
-node products only. Description of Command Function Deletes storage segments associated with the StoreOnce system "backend" file system. This command does not apply to the storage on which each nodes operating system is located. Command Syntax Hardware delete storage {ALL|dev-id} Command Authority - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 32
◦ Command Failed - The storage volume is assigned to the D2D dedupe data file system ◦ Command Failed - The storage volume is not part of D2D dedupe data storage • If you do not respond to the warning message with y, the command is terminated and the CLI returns to the user prompt. - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 33
nodes which is automatically configured during the initial automatic configuration of the StoreOnce appliance. HP recommends disabling failover before rebooting the StoreOnce appliance. Command Syntax hardware disable failover [NODEX] Command Authority Administrator Command Object Requirements - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 34
Function Discovers storage which has been connected to the StoreOnce appliance. Before this command can be executed, any previous using the system show status command (see "system show status" (page 143)). Once the discover storage process has been successfully started, the system show status - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 35
hardware enable failover NOTE: This command applies to multi-node products only. Description of Command Function Enables the failover feature between nodes which had been disabled using the hardware disable failover (see "hardware disable failover" (page 33)) command. Command Syntax hardware enable - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 36
hardware failback NOTE: This command applies to multi-node products only. Description of Command Function Returns the file server node defined in the command entry back from the failover condition. The node is placed in the failover condition as a result of automatic failover or by using the - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 37
availability feature for the file server node defined within the command. When this command is executed, the backup node within the couplet takes over the service set functions originally residing on the defined node. Command Syntax hardware failover NODEX Command Authority Administrator Command - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 38
Description of Command Function Powers down the StoreOnce appliance. If a file server node is must conform to the command syntax. • At least one system with an active CLI must exist. • If a file serving if the shutdown applies to the node currently supporting the CLI interface, the session will be - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 39
poweroff request successfully sent hardware poweroff 39 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 40
• The command entry must conform to the command syntax. • At least one system with an active CLI must exist. • If a file serving node is defined described under Command Syntax in this section. • If the entire StoreOnce appliance or the specified node is already powered up, the following is - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 41
hardware prepare storage Description of Command Function An alias for the hardware discover storage command. See "hardware discover storage" (page 34) for details. Command Syntax hardware prepare storage hardware prepare storage 41 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 42
Description of Command Function Reboots the StoreOnce appliance nodes. If a file server node must conform to the command syntax. • At least one system with an active CLI must exist. • If a if the reboot applies to the node currently supporting the CLI interface, the session will terminate following - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 43
hardware set ports NOTE: This command applies to single-node products only. Description of Command Function Sets the node's physical port parameters. Command Syntax hardware set ports [NODEX] PORTX [speed {auto|2Gbs|4Gbs|8Gbs}] [{Connection Loop|Fabric|pnt-to-pnt}] Command Authority Administrator - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 44
hardware show firmware Description of Command Function Shows firmware components on server and storage. Command Syntax hardware show firmware Command Authority Operator and Administrator Command Object Requirements Not applicable - no objects exist within this command. Command Parameter Requirements - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 45
NONE NONE NONE HPD3 HPD3 HPD3 HPD3 HPD3 HPD3 HPD3 HPD3 HPD8 HPD8 0147 HPD3 HPD3 HPD3 HPD3 HPD3 HPD3 HPD3 HPD3 HPD8 HPD8 0147 * = System reboot required to apply firmware updates hardware show firmware 45 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 46
show net status NOTE: This command applies to multi-node products only. Description of Command Function Provides status on the StoreOnce file server node's network interfaces. Command Syntax hardware show net status Command Authority Operator and Administrator Command Object Requirements Not - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 47
NOTE: The example output is in a small font to fit on this specification page. As a CLI output, the character string will simply wrap at the end of a terminal line. hardware show net status 47 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 48
show node status Description of Command Function Provides status on the StoreOnce file server nodes. If a node object is included in the this section. Example > hardware show node status SERVER_NAME BACKUP STATE HA ID GROUP d2d78e7d1e6928e_node_1 d2d78e7d1e6928e_node_2 Up off 68fa0df3 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 49
of Command Function Displays a list of the failed hardware components in the StoreOnce system. Command Syntax hardware show problems Command Authority Operator and Administrator Command Object Requirements Not applicable - no objects exist within this command. Command Parameter Requirements - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 50
hardware show status Description of Command Function Provides status on all the hardware components of the StoreOnce system. Command Syntax hardware show status [detail] [dev-id] Command Authority Operator and Administrator Command Object Requirements Not applicable - no objects exist within this - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 51
= USE048N4JX Status = 2 Id = hp85647867b2-2 FirmwareVersion = P67 05/05/2011 Type = SERVER Vendor = HP SystemName = HP B6200 StoreOnce Backup System RolledUpStatus = unknown diagMessages = Good AdditionalProperties = UIDBeacon=On, ReleaseVersion=3.3.0-1222.16 - hp85647867b2-1 Name - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 52
FirmwareVersion = P67 05/05/2011 Type = SERVER Vendor = HP SystemName = HP B6200 StoreOnce Backup System RolledUpStatus = unknown diagMessages = Good AdditionalProperties = UIDBeacon=On, ReleaseVersion=3.3.0-1222.16 Command Successful NOTE: The example output is in a small font to fit - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 53
hardware show storage status Description of Command Function An alias for the system show status command. See "system show status" (page 143) for details. Command Syntax hardware show storage status hardware show storage status 53 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 54
hardware update firmware Description of Command Function Updates the firmware for the defined type of hardware. Command Syntax hardware update firmware [allow-downgrade] Command Authority Administrator Command Object Requirements Not applicable - no objects exist within this command - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 55
System file system. • hardware - manage Backup System hardware. • license - manage Backup System licenses. • logs - commands related to the logs generated by the Backup System. • net - commands related to the Backup System network configuration. • snmp - ommands related to management of appliance - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 56
- create, delete or show support tickets. • system - commands related to configuration and system setup. • time - manage time related functions. Commands currently available hpsupport - provides access to the HP support account with the HP support authority level. shell - creates a shell with - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 57
hpresetpassword Description of Command Function Allows you to change passwords for the default Admin account or for the hpresetpassword account. Command Syntax hpresetpassword [manage|reset] Command Authority Administrator Command Object Requirements Not applicable - no objects exist within this - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 58
Description of Command Function Provides for the installation of a StoreOnce appliance license. The license is entered as a 168 character the license is ignored. The license is purchased by the customer and provided by HP. If you are installing demo licensing, type demo in the parameter entry field. - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 59
appear in the command entry after license load. The license is purchased by the customer and provided by HP. The means by which the license file is place in the StoreOnce appliance repository directory is beyond the scope of the CLI. Requirements for Command Execution The command entry must conform - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 60
serial number and available licenses for the StoreOnce appliance. Command Operation during Abnormal Conditions If the Capacity: 1 FeatureID: 9165 Key: N/A License Name: HP StoreOnce Catalyst 4700 LTU Description: HP StoreOnce 4700 Catalyst LTU (Instant-On) Days remaining: 90 Expiration - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 61
logs show events Description of Command Function Lists all the items in the event log. If a severity parameter is included in the command entry, only events at or greater than the defined severity are displayed. Command Syntax logs show events [severity {alert|warni|info}] [numofevents ] ( - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 62
bond1:1 0 637 Aug 3 18:58:41 INFO Nic bond1:3 on host d2d78e7d1e6928e_node_1 up 636 Aug 3 18:58:19 d2d78e7d1e6928e_node_1 bond1:3 0 WARN Server d2d78e7d1e6928e_node_2 failed over 635 Aug 3 18:58:13 d2d78e7d1e6928e_node_2 0 ALERT Server d2d78e7d1e6928e_node_2 in failover - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 63
updates that have occurred on the system. Command Syntax logs show update service sets successful. 14:27:04 Disabling service set failover. 14:27:04 Disabling service set failover successful. 14:27:04 Stopping file services. 14:27:18 File service stop successful. 14:27:18 Stopping management service - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 64
is up to date 14:34:51 Server firmware update successful. 14:34:51 Removing update tools packages. 14:34:51 Start reboot of the system. 14:34:53 Update will complete after rebooting. 14:34:53 Ssh connection will be lost. Allow 15-20 minutes for reboot to complete before - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 65
set where the NAS share is to be created.X is the numeric index of the service set. 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 multi-node or single - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 66
Command Successful 66 Alphabetical List of Commands and Details - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 67
set where NAS share is to be deleted. X is the numeric index of the service set. 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 multi-node or single-node - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 68
set where NAS share is to be modified. X is the numeric index of the service set. 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 multi-node or single-node - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 69
set where NAS share is to be shown. X is the numeric index of the service set. 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 multi-node or single-node - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 70
command, information on the external network configuration is displayed. Command Operation during Abnormal Conditions If the command fails, the system will attempt to configure the external network using the original, current configuration. Example # net activate config management 70 Alphabetical - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 71
. Command Parameter Requirements • default - This optional parameter defines if the subnet configuration is the default; the default subnet defines the default gateway for the system. The values can be either Yes or No. If not defined, the default value is No, unless the subnet label is "default" in - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 72
• bonding - This parameter defines network bonding modes. is 1, 4, or 6. See the HP StoreOnce Backup System Installation and Configuration guide for more detailed information on supported bonding modes and related templates. Bonding mode Description Default Bonding Mode for: Mode 1 (Active - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 73
net copy config NOTE: This command applies to single-node products only. Description of Command Function Copies a network configuration. Command Syntax net copy config from to Command Authority Administrator Command Object Requirements • netlabel - The data structure in this - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 74
configuration object that is pre-defined at the initial installation. This default configuration will be different depending on the StoreOnce system. Command Parameter Requirements • description - This optional parameter describes the network configuration and is contained in quotes ("). There is no - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 75
to obtain information on which integers may be used to define ports for the subnet configuration. The maximum number of values depends on your system; use the Command Authority (page 71) command for information on which ports are available. Requirements for Command Execution • The command entry must - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 76
net delete config NOTE: This applies to single-node products only. Description of Command Function Deletes a network configuration. Command Syntax net delete config Command Authority Administrator Command Object Requirements netlabel - This label identifies the network configuration to be - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 77
net delete subnet NOTE: This command applies to single-node products only. Description of Command Function Deletes a subnet configuration. Command Syntax net delete subnet Command Authority Administrator Command Object Requirements • netlabel - This label identifies the network - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 78
and the temporary structure discarded. ◦ The description is updated with the following string Configuration modified on DATE by USER, where date is the system date and time when modification was made and user is the account user from which the modification was made. ◦ If the activation fails - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 79
obtain information on which integers may be used to define ports for the subnet configuration. The maximum number of values depends on your system; use the Command Authority (page 71) command for information on which ports are available. IMPORTANT: If a parameter is undefined in the modify command - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 80
the subnet configuration. The maximum number of values depends on your system; use the Command Authority (page 71) command for information on bonding - This parameter defines how the multiple ports are bonded. The supported bonding modes and the default bonding modes for specific templates are shown - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 81
StoreOnce B6200 Backup System Installation Planning and Preparation Guide and Checklists for more detailed information about supported bonding modes. Bonding mode Description Default Bonding Mode for: Mode 1 (Active/Backup 5.6.7.8 netmask 255.255.0.0 domain gbr.hp.com default yes bonding 5 port - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 82
the GUI processes will transmit the "ping" packet. • CLI - This optional global object determines that the node supporting the CLI processes will transmit the "ping" packet. Command Parameter Requirements IPAddr - This required parameter defines the location to which the "ping" packet will - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 83
to one of the five pre-defined configurations. NOTE: See the HP StoreOnce B6200 Backup System Installation Planning and Preparation Guide and Checklists for more detailed information about supported network configurations. Command Syntax net set config TEMPLATEX Command Authority Administrator - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 84
• 10GbE management subnet mask • 10GbE management subnet mask • DNS server IP addresses (enter up to three, separated with commas) The information you just entered is displayed for confirmation. After you enter Y, the following displays: Starting network configuration This session may terminate Log - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 85
syntax as described under Command Syntax in this section. Example # net set wizard StoreOnce Network Configuration Wizard This Wizard will guide you through the configuration of network settings on your StoreOnce Backup System If you wish to make additions or modifications to an existing network - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 86
Do you want to configure a static default gateway for this subnet or get gateway from DHCP? 1.) Gateway obtained from DHCP server (default) 2.) Set gateway manually 2 Enter gateway IP address : 192.168.1.1 Do you want to configure the network domain name or get domain name from DHCP? 1.) Domain name - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 87
step: Step 2.) 3.) Go back to start of present step: Step 3.) 4.) Quit wizard and lose all settings 1 You have successfully configured the network settings on your StoreOnce Appliance. net set wizard 87 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 88
Only): 16.24.164.22 1GbE Network Virtual Data IP: 16.24.164.23 Node 2: 1GbE Network Physical IP (HP Service Only): 16.24.164.24 1GbE Network Virtual Data IP: null Appliance Wide Parameters 1GbE subnet mask: 255.255.240.0 Data/Management network gateway: 16.24.160.1 (default) 88 Alphabetical List - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 89
Domain Name: DNS server IP address(es): 16.110.135.51, 16.110.135.52 IP Address Ranges Allocated for this B6200 system 1GbE Data/Management network start IP address: 16.24.164.22 1GbE Data/Management network End IP range: 16.24.164.33 net show config 89 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 90
net show config NOTE: This command applies to single-node products only. Description of Command Function Shows the network configuration. Command Syntax net show config [all] Command Authority Operator and Administrator Command Object Requirements netlabel- This object defines the name of - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 91
Write Protected: no DNS Servers Number of Networks:1 Network: subnet_one IP Address: dhcp Net Mask: dhcp Domain Name: dhcp Gateway: dhcp Bonding Mode: 6 (High Availability) Default Network: yes Interfaces:eth0 Network Name: current Network Description: default Write Protected: no DNS Servers - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 92
net show config list NOTE: This command applies to single-node products only. Description of Command Function Lists all the labels of all the existing network configurations. Command Syntax net show config list Command Authority Operator and Administrator Command Object Requirements Not applicable - - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 93
net show ports NOTE: This command applies to single-node products only. Description of Command Function Lists the ports that are available to use in subnet configurations. Command Syntax net show ports [NODEX] Command Authority Operator and Administrator Command Object Requirements NODEX - This - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 94
net show status NOTE: This command applies to single-node products only. Description of Command Function Displays information on the network status. Command Syntax net show status [subnet ][port ][all] Command Authority Operator and Administrator Command Object Requirements Not - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 95
activation is scheduled to take place at a given time when the backup traffic is low, the command provides confidence the net activate config list shows some examples but is not a complete list of checks. The system will verify the configuration structure according to the rules below: • A default - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 96
under Command Syntax in this section. Example > serviceset show status Service Set 1 Status ------- Overall : Fault StoreOnce Subsystem : Running Virtual Tape : Running NAS : Running StoreOnce Catalyst : Running Replication : Fault Housekeeping : Running 96 Alphabetical List of - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 97
be started. Command Syntax serviceset start [SETX] [all] Command Authority Administrator Command Object Requirements SETX - This optional object defines an individual service set. X is a unique numeric index. If the object is not included in the command sequence, the parameter must be included in - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 98
set is defined in the command sequence, it must exist. Successful Command Output Upon successful completion of the command, the service sets defined in the command sequence are stopped and the following is displayed: Command Successful Command Operation During Abnormal Conditions • If the command - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 99
snmp add trapsink Description of Command Function Defines a host to which the SNMP agent sends traps. Parameters for SNMP versions 1 and 2 differ from those for SNMP version 3 (v3). Command Syntax SNMP versions 1 and 2: snmp add trapsink [version {1|2}] [port ] [trap-community - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 100
must conform to the command syntax. Successful Command Output Upon successful entry of the command sequence, the trap host is added to the StoreOnce appliance's SNMP agent and the following is displayed: SNMP versions 1 and 2: Command Successful, host trap FQDN | IP added, where FQDN | IP is the - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 101
trapsink 16.34.123.44 version 3 user john-snmp event alerts authentication-algo SHA authentication-pwd T3stPwd privacy-algo AES privacy-pwd Pr!vPwd contextname D2D-SNMP Command Successful, trapsink 16.34.123.44 added for john-snmp snmp add trapsink 101 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 102
snmp add user Description of Command Function Creates a new SNMP user. Command Syntax snmp add user USERNAME security-level {noAuthNoPriv|authNoPriv|authPriv} [authorization-algo {MD5|SHA}] [authorization-pwd ] [privacy-algo {DES|AES}] [privacy-pwd ] Command - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 103
Command Successful, snmp user john-snmp added snmp add user 103 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 104
snmp del trapsink Description of Command Function Removes a trap host which has already been created using the snmp add trapsink command (see "snmp add trapsink " (page 99)). Command Syntax snmp del trapsink Command Authority Administrator Command Object Requirements Not applicable - no - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 105
snmp del user Description of Command Function Deletes an existing SNMP user. Command Syntax snmp del user USERNAME Command Authority Administrator Command Object Requirements Not applicable - no objects exist within this command. Command Parameter Requirements Not applicable - no parameters exist - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 106
snmp disable Description of Command Function Disables the SNMP functionality. Command Syntax snmp disable Command Authority Administrator Command Object Requirements Not applicable - no objects exist within this command. Command Parameter Requirements Not applicable - no parameters exist within this - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 107
- This optional parameter can be provided during version 3 configuration. If the value is "yes," versions 1 and 2 will be supported along with version 3. If the value is "no," only version 3 will be supported. If this parameter is not included in the command entry, only version 3 will be - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 108
snmp modify trapsink Description of Command Function Modifies the host to which the SNMP agent sends traps. Command Syntax SNMP versions 1 and 2: snmp modify trapsink [version {1|2}] [port ] [trap-community ] [events {alert|warn|info}] SNMP version 3: snmp modify trapsink - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 109
trapsink 16.34.123.44 version 3 user john-snmp event alerts authentication-algo MD5 authentication-pwd T3stPwd privacy-algo DES privacy-pwd Pr!vPwd contextname D2D-SNMP Command Successful, trapsink 16.34.123.44 modified for john-snmp snmp modify trapsink 109 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 110
entry must conform to the command syntax. Successful Command Output Upon successful command entry, the SNMP user "username" is modified as instructed in the parameters and the following is displayed: Command Successful, snmp user 'username' modified Command Operation during Abnormal Conditions • If - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 111
Example # snmp modify user john-snmp security-level noAuthNoPriv authorization-algo MD5 authorization-pwd auth798wd privacy-algo AES privacy-pwd priv945wd Command Successful, snmp user john-snmp modified snmp modify user 111 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 112
snmp reset ro-community Description of Command Function Resets the ro-community string (the password to access the StoreOnce Management Information Base) to the default string of "public." Command Syntax snmp reset ro-community Command Authority Administrator Command Object Requirements Not - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 113
character text string enclosed in quotations. The text string provides information on the contact responsible for the management of the StoreOnce appliance's SNMP agent. Requirements for Command Execution The command entry must conform to the command syntax. Successful Command Output Upon successful - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 114
parameter. It consists of a character text string enclosed in quotations. The text string provides information on the location for the StoreOnce appliance containing the SNMP agent. Requirements for Command Execution The command entry must conform to the command syntax. Successful Command Output - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 115
the ro-community string. In other words, it defines the passphrase for read-only access to the SNMP agent on the StoreOnce appliance. Command Syntax snmp set ro-community Command Authority Administrator Command Object Requirements Not applicable - no objects exist within this - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 116
StoreOnce appliance's SNMP agent contact string (or blank if not defined). • The StoreOnce appliance's SNMP agent location string (or blank if not defined). • The StoreOnce appliance Description: This command displays information on the backup system's snmp configuration. Example: snmp show config - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 117
Snmp agent parameters Version : 2 Port : 161 SysContact : JAdmin SysLocation : Paradise SysDescr : HP StorageWorks D2D Backup System [D2D Serial Number] [D2D hostname] [D2D SKU] SysObjectID : SEMI-MIB::hp.10.3.1.3.27 Encrypt passwords and communities : no Allow non-V3 read - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 118
snmp show user Description of Command Function Lists the SNMP user settings of all SNMP users unless a specific user name is included. Command Syntax snmp show user [username] Command Authority Administrator Command Object Requirements Not applicable - no objects exist within this command. Command - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 119
support ticket for the StoreOnce appliance. Command Syntax support create ticket Command Authority Operator and Administrator Command Object Requirements No object is required in the command entry, but upon command execution a support of the newly created support ticket Command Operation during - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 120
which has already been create and exists for the StoreOnce appliance. • ALL - This is a global default which represents all of the support ticket objects which exist within the StoreOnce appliance. Command Parameter Requirements Not applicable - no parameters exist within this command. Requirements - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 121
completion of the command, all the support tickets which exist within the StoreOnce appliance are listed with their description and time Collected 2011-08-03-21-22-29 Manual tkt_110803_205514 collected at 2011-08-03-20-55-16 Collected 2011-08-03-20-55-16 Manual NOTE: The example output is in - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 122
packages Description of Command Function Clears all packages from the queue which have been loaded for update. Command Syntax system clear packages Command Authority Administrator Command Object Requirements Not applicable - no parameters exist within this command. Command Parameter Requirements - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 123
clear repository Description of Command Function Deletes all the files in the StoreOnce appliance repository directory. Command Syntax system clear repository Command Authority Administrator Command Object Requirements Not applicable - no parameters exist within this command. Command Parameter - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 124
the initial release, this command will only disable failover for the entire appliance. In following releases, the command will be updated to disable failover for given service sets. Command Syntax system disable failover Command Authority Administrator Command Object Requirements Not applicable - no - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 125
initial release, this command will only enable failover for the entire appliance. In following releases, the command will be updated to enable failover for give service sets. Command Syntax system enable failover Command Authority Administrator Command Object Requirements Not applicable - objects - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 126
the StoreOnce appliance and into the package update queue. The next time the system update packages command is executed the StoreOnce appliance D2D appliance repository directory Example # system load packages D2D-example.scexe package D2D-common-5.3.3-1 successful added to update queue use "systems - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 127
reboot Description of Command Function Gracefully shuts down and reboots the entire StoreOnce appliance. Command Syntax system reboot Command Authority Administrator Command Object Requirements Not applicable - no parameters exist within this command. Command Parameter Requirements Not applicable - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 128
or xml; the default is text. Every time a new terminal session is started the default output will be set. Command Syntax system set clioutput {text|xml} Command Authority Administrator Command Object Requirements Not applicable - no objects exist within this command. Command Parameter Requirements - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 129
Function Runs a step-based wizard to guide you through a complete series of system configuration steps: • Configure network • Configure example applies to multinode products (configure failover is not supported in single-node). > system set config Please ensure all nodes have joined the cluster - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 130
address (must be IPv4 X.X.X.X): Enter 1GbE management subnet mask (must be IPv4 X.X.X.X): Select bonding mode for 10GbE data bond enter 1 (Active/Backup), 4 (IEEE 802.3ad Dynamic Link Aggregation), or 6 (Active Load Balancing), (default = 1): 1 Enter 10GbE data network start IP address (must be - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 131
to maintain reliable network connectivity to this system. Continue with network setup? [Y/N]: Enter 1GbE management 16.24.164.147 Select bonding mode for 10GbE management and data bond enter 1 (Active/Backup), 4 (IEEE 802.3ad Dynamic Link Aggregation), or 6 (Active Load Balancing), (default = - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 132
hp.com : : : Do you want to configure a 1GbE management and 1GbE data network? [Y/(N)]: Enter Virtual Management Console IP Address (must be IPv4 X.X.X.X): 16.24.164.147 Select bonding mode for 1GbE management bond enter 1 (Active/Backup time for the system (mm/dd/yyyy hh:mm:ss): 05 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 133
Command Successful. The Backup System UTC has been set to 05/01/2013 09:39:00. N.B. If set time is before current system time this warning will appear. Current UTC : 05/01/2013 09:35:23 New UTC : 05/01/2013 09:35:05 Warning: System time will move backwards as a result of this command - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 134
SUMMARY # # Report Date: Wed May 01 08:52:52 UTC 2013 Product ID: HP B6200 StoreOnce Backup System Cluster S/N: hpa0b3cce3861a Version: 3.6.0-1315.1 Overall Status: FAILED (Hardware) ### HARDWARE COMPONENT STATUS The following hardware is in a 'down' or 'failed' state: | Device - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 135
) Perform the current step (Default) skip) Skip to the next step back) Go back to a previous step quit) Exit the configuration immediately Finish Configuration [execute]? system set config 135 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 136
StoreOnce appliance. This label is part of the replication process when the source or target appliance needs to be identified. Command Syntax system set description - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 137
of CLI output is set to [on or off] as defined Command Successful Command Operation during Abnormal Conditions • If any of the command elements (system, set, pagecontrol, ) are misspelled, the following is displayed: element: command not found • If the command does not conform to the required syntax - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 138
information on the StoreOnce appliance system configuration. Command Syntax system show config Command Authority D2D appliance name: APPLIANCE-NAME Product Serial Number: XXXXXXXX CLI output: OUTPUT where APPLIANCE-NAME is the parameter defined using the command system set description (see "system - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 139
on the StoreOnce appliance and packages that have been added to the queue for installation. Command Syntax system show packages as described under Command Syntax in this section. Example # system show packages D2D APPLIANCE: Packages consistent across all nodes D2D_3.0 D2D_Patch_199 The following - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 140
Description of Command Function Provides a snapshot of the StoreOnce appliance's real-time performance. If a service set object is included in the command entry, the information is only provided for that service set. Command Syntax system show performance [SETX] Command Authority Operator and - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 141
NAS Write: 0 MB/s Catalyst Read: 0 MB/s Catalyst Write: 0 MB/s Replication Inbound: 0 MB/s Outbound: 0 MB/s Catalyst Inbound: 0 MB/s Outbound: 0 MB/s system show performance 141 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 142
to the required syntax, SYNTAX, where SYNTAX is the command syntax as described under Command Syntax in this section. Example # system show repository File ---D2D_Master-3.2.0-1219.42.x86_64.rpm D2D_Master-3.5.0-1302.1.x86_64.rpm D2D_Master-3.6.0-1315.1.x86_64.rpm 142 Alphabetical List of Commands - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 143
Command Function Provides status on the StoreOnce appliance system. Command Syntax system show status Command Authority Operator and reported where XX represents the number of GB of data discovered or formatted. The Service Set Status can be one of the following: • Running • Not Started • - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 144
1 Running # system show status Storage Set Service Sets 3, 4 Service Sets 7, 8 Service Sets 1, 2 Service Sets 5, 6 Status -----No volumes found on the arrays in Couplet 2, may need to run discovery Formatted 30,543.25GB Needs Finalization (mounting) Formatted 30,543.25GB Service Sets Status - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 145
Description of Command Function Gracefully shuts down the entire StoreOnce appliance. Command Syntax system shutdown Command Authority Administrator Command Object Requirements Not applicable - no objects exist within this command. Command Parameter Requirements Not applicable - no parameters - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 146
system update packages [force] Command Authority Administrator Command Object Requirements Not applicable - no parameters exist within this command. Command Parameter Requirements force - This optional parameter will force the packages to be install on the StoreOnce appliance the D2D appliance - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 147
(No more than two ntp server objects can exist for a given StoreOnce appliance.) Requirements for Command Execution • The command entry must conform to the three ntp servers may be assigned to the D2D appliance Example # time add ntpserver ntp.hp.net ntp server(s) added successfully # time add - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 148
ntp server(s) added successfully 148 Alphabetical List of Commands and Details - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 149
on the number of ntp server objects which currently exist for the StoreOnce appliance, up to two ntp server ID parameters may exist within the command more than two ntp server objects can exist for a given StoreOnce appliance.) Requirements for Command Execution • The command entry must conform to - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 150
time reset timezone Description of Command Function Resets the time zone for the StoreOnce appliance to the default of UTC. Local time is the same as UTC. Command Syntax time reset timezone Command Authority Administrator Command Object Requirements Not applicable - - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 151
Requirements Not applicable - no objects exist within this command. Command Parameter Requirements timezone - A parameter defining the time zone for the StoreOnce appliance must appear in the command entry after time set timezone. The parameter is a string label matching one of the timezone labels - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 152
The following information has been given: Britain (UK) Therefore TZ='Europe/London' will be used. Local time is now: Thu May 9 12:12:58 BST 2013. Universal Time is now: Thu May 9 11:12:58 UTC 2013. Is the above information OK? 1) Yes 2) No #? 1 timezone set to :Europe/London 152 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 153
UTC Description of Command Function Sets the value of the system clock on the node with active fusion manager to syntax. Successful Command Output Upon successful completion of the command, the following is displayed: The D2D appliance UTC has been set to MM/DD/YYYY hh:mm:ss, where MM/DD/YYYY hh: - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 154
of Command Function Displays the time configuration and the StoreOnce appliances UTC and local times. Command Syntax time show config Command Syntax in this section. Example # time show config NTP Server(s 10.10.10.10 ntp.hp.net TimeZONE: MDT UTC : 8/22/2011 21:12:39 LocalTime : 8/22/11 15:12:39 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 155
Administrator Command Object Requirements • SETX - This object defines the service set containing the virtual tape library into which the cartridge will be added. X is the numeric index of the service set. • LIBX - This required object is the virtual tape library into - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 156
string>] [CartSize {10 | 25 | 50 | 100 | 200 | 400 | 800 | 1000 | 1200 | 1400 | 1600 | 3200}]" • Command Failed - The service set is invalid • Command Failed - The service set does not exist • Command Failed - The library is invalid • Command Failed - The library does not - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 157
- This object defines the service set into which virtual tape library will be added. X is the numeric index of the service set. • LIBX - This , if the parameter is not defined, the default below is used: StoreOnce System Type multi-node single-node Default Interface FC iSCSI • LibEmulation - This - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 158
the drive in the library in a round robin fashion. If not defined, the value is the set of all Fibre Channel ports available to the service set (all the ports listed by the vtl show ports command. A value of zero indicates that no port should be assigned to the Fibre Channel - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 159
- The entry does not conform to command syntax. The number of double quotes (") is odd. ◦ Command Failed - The service set is invalid ◦ Command Failed - The service set does not exist ◦ Command Failed - Invalid Parameter: value: ◦ Command Failed - The name must be - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 160
emulation ◦ Command Failed - tAuthentication must be "yes" when iAuthentication is "yes" • If execution of the command will add more than 48 libraries to a service set, the command execution terminates and the following error message is displayed: Command Failed - Only 48 libraries may be added to - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 161
# vtl create library set2 name MyLib2 interface iSCSI libemulation ESL driveemulation LTO5 noofslots 96 noofdrives 2 port 1 iscsiname iqn.1991-05.co.microsoft:myserver.mydomain.local Command Successful vtl create library 161 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 162
cartridge [SETX] LIBX [{CARTX|ALL}] [barcode ] [mail ] [slot ] Command Authority Administrator Command Object Requirements • SETX - This object defines the service set containing the virtual tape library from which the cartridge will be deleted. X is the numeric index of the - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 163
"vtl delete cartridge [SETX] LIBX [{CARTX | ALL}] [barcode ] [mail ] [slot ]" ◦ Command Failed - The service set is invalid ◦ Command Failed - The service set does not exist ◦ Command Failed - The library is invalid ◦ Command Failed - The library - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 164
set does not exist ◦ Command Failed - The library is invalid ◦ Command Failed - The library does not exist ◦ Command Failed - the service set must be specified • If you do not respond to the warning message with y, the command is terminated and the CLI returns to the user - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 165
Command Successful vtl delete library 165 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 166
Command Object Requirements • SETX - This required object defines the service set containing the virtual tape library that contains the cartridge to be modified . X is the numeric index of the service set. • LIBX - This required object is the virtual tape library - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 167
] [CartSize {10 | 25 | 50 | 100 | 200 | 400 | 800 | 1000 | 1200 | 1400 | 1600 | 3200}]" • Command Failed - The service set is invalid • Command Failed - The service set does not exist • Command Failed - The library is invalid • Command Failed - The library does not - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 168
] [iSCSIname ] [iUsername ] [wwpn ] [wwnn ] Command Authority Administrator Command Object Requirements • SETX - This required object defines the service set containing the virtual tape library that contains the drive to be modified. X is the numeric index of the - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 169
LTO5 | UltriumVT}] [DrivePort ] [iSCSIname ] [iUsername ] [wwpn ] [wwnn ]" • Command Failed - The service set is invalid • Command Failed - The service set does not exist • Command Failed - The library is invalid • Command Failed - The library - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 170
wwnn ] Command Authority Administrator Command Object Requirements • SETX - This required object defines the service set containing the virtual tape library to be modified. X is the numeric index of the service set. • LIBX - This required object is the virtual tape library to be modified. X is - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 171
current value remains unchanged. If this parameter is changed, the number of slots and number of drives currently defined must be less than that defined by the library emulation. If this is not the case, an error message is generated. • DriveEmulation - This optional parameter defines the type of - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 172
{ 6 | 8 }] [nonstop {yes | no}]" • Command Failed - The entry does not conform to command syntax. The number of double quotes (") is odd. • Command Failed - The service set is invalid • Command Failed - The service set does not exist 172 Alphabetical List of Commands and Details - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 173
• Command Failed - The library does not exist • Command Failed - Invalid Parameter: value: • Command Failed - The name must be equal to or less than 30 characters • Command Failed - The interface is invalid • Command Failed - The library port is - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 174
] to [libX] {drive |mail |slot } Command Authority Operator and Administrator Command Object Requirements • SETX - This required object defines the service set containing the virtual tape library into which the cartridge will be moved. X is the numeric index of the - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 175
◦ Command Failed - The service set does not exist ◦ Command Failed - The library is invalid ◦ Command Failed - The library does not exist ◦ Command Failed - The mail slot < - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 176
vtl show capacity Description of Command Function Displays details on the library storage used and available at the cluster, service set, or library level. The level of information displayed depends on the objects defined within the command sequence. Command Syntax vtl show capacity [SETX] [LIBX] - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 177
SET1 LIB1 LIB2 Lib3 4 TB 5 TB 1 TB 20 TB 75 TB 5 TB Command Successful # vtl show capacity SET1 LIB1 Object ------ LIB1 Space Used ---------- 4 TB User Data --------- 20 TB Command Successful 5:1 15:1 5:1 Dedupe Ratio 5:1 vtl show capacity 177 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 178
Command Failed - Did not conform to the correct command syntax "vtl show cartridges SETX LIBX" • Command Failed - The service set is invalid • Command Failed - The service set does not exist • Command Failed - The library is invalid • Command Failed - The library does - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 179
Library : LIB1 Name: Gregslib Object Location Slot CART1 1 CART2 2 CART3 Drive2 3 CART4 4 Barcode ------- ABC001 ABC002 ABC003 ABC004 Command Successful Max Size -------- 800 GB 800 GB User Data --------- 745 GB 712 GB Protected --------- yes yes Mapped ------ no no 800 GB 799 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 180
Failed - Did not conform to the correct command syntax "vtl show drive info SETX LIBX [DRVX]" • Command Failed - The service set is invalid • Command Failed - The service set does not exist • Command Failed - The library is invalid • Command Failed - The library does - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 181
: GregsNextlib Emulation Type : LTO4 Protocol : iSCSI Serial Number : CR2058t021 WWNN : 500143874B5B68A0 iSCSI Target Name : ign-1986-03.com.hp.storage.d2dbs.cr206f12e.500143874b5b68a0.library2.drive1 iSCSI Target Alias : D2DBS.CR206F1F2E.library2.Drive Command Successful # vtl show drive - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 182
Authority Operator and Administrator Command Object Requirements • SETX - This optional object defines the service set containing the drives to be listed. X is the numeric index of the service set.If used on a single-node system, the object must be defined as SET1. If not defined, all drives are - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 183
------LIB1 LIB1 LIB2 LIB2 Command Successful # vtl show drive list SET1 LIB1 Object -----DRV1 DRV2 Type ---LTO4 LTO4 Service Set ----------SET1 SET1 Library ------LIB1 LIB1 Command Successful Name ---Gregslib Gregslib GregsNextlib GregsNextlib Name ---Gregslib Gregslib vtl show drive - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 184
Operator and Administrator Command Object Requirements • SETX - This optional object defines the service set containing the libraries to be described. X is the numeric index of the service set.If used on a single-node system, the object must be defined as SET1. If not defined, all libraries are - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 185
iSCSI Alias : H1B600B50J : 5001438011A18947 : iqn.1986-03.com.hp:storage.d2dbs.nre0a6b83d.5001438011a18947.library2.robotics : D2DBS.nre0a6b83d.0.Library2.Robotics >>>>Additonal Information>Additonal - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 186
Object : LIB1 Name : Robslib >>>>Additonal Information>Additonal Information - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 187
- Did not conform to the correct command syntax "vtl show library iscsi authentication SETX LIBX" • Command Failed - The service set is invalid • Command Failed - The service set does not exist • Command Failed - The library is invalid • Command Failed - The library does - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 188
Operator and Administrator Command Object Requirements SETX - This optional object defines the service set containing the libraries to be listed. X is the numeric index of the service set. If used on a single-node system, the object must be defined as SET1. Command Parameter Requirements Not - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 189
on the physical Fibre Channel ports is displayed. Because this information depends on the physical hardware, the output will differ from system to system. See the examples for the different outputs. Configuration values can be: • Speed - Auto, 2 Gbs, 4 Gbs, or 8 Gbs • Connection - Loop, Fabric - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 190
VTL Port Number ---------- 1 not used 2 not used Physical Location Slot Port ---- ----- HBA1 Port1 HBA1 Port2 HBA2 Port1 HBA2 Port2 Configuration Speed Connection ----- ---------- 4 Gbs Fabric 4 Gbs Fabric 4 Gbs Fabric 4 Gbs Fabric Null VTL Port Number ---------- 0 - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 191
hp.com/support/manuals In the Storage section, click link label and then select your product. Websites • HP Event Monitoring Service and HA Monitors Software http://www.hp.com/go/ hpux-ha-monitoring-docs • HP Serviceguard Solutions for HP-UX http://www.hp.com/go/hpux-serviceguard-docs • HP Systems - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 192
boxes Italic text Monospace text Text emphasis • File and directory names • System output • Code • Commands, their arguments, and argument values Monospace, italic specific instructions. NOTE: Provides additional information. TIP: Provides helpful hints and shortcuts. Documentation feedback HP - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 193
comprised of various commands which are used to control operating system responses. elements entered into the Common CLI by the user to convey instructions a sequence of commands which uniquely defines an instruction for the StoreOnce appliance the entire list of unique command sequences and their - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 194
W white space word any combination of spaces, tabs and carriage returns an element whose characters having meaning in the natural language of the user. The meaning of the word is directly related to the intended operation defined by the words in the command sequence 194 Glossary - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 195
, 42 set ports, 43 show firmware, 44 show net status, 46 show node status, 48 show problems, 49 show status, 50 show storage status, 53 update firmware, 54 help, 55 obtaining, 191 viewing, 7 HP technical support, 191 hpresetpassword, 57 L license add, 58 load, 59 show, 60 logs show events, 61 show - HP D2D2502i | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Novem - Page 196
user , 118 support create ticket, 119 del ticket, 120 show ticket, 121 symbols in text, 192 syntax for commands, 8 system clear packages, 122 show status, 143 shutdown, 145 update packages, 146 T technical support, 191 196 Index HP, 191 text symbols, 192 time add ntpserver, 147 del manuals, 191
HP StoreOnce Backup System CLI Reference
Guide
Abstract
This document details the set of operations supported by the Common CLI. This command set defines the instructions used to
obtain information about a StoreOnce Backup system appliance or to control the appliance’s activity. It is intended for system
administrators managing a single or multi-node HP StoreOnce Backup System.
IMPORTANT:
This guide may have more recent updates. Always check
w
w
w
.hp
.co
m/su
ppo
r
t/man
uals
for the most up-to-date
documentation for your product.
HP Part Number: BB877-90906
Published: September 2013
Edition: Six