HP D2D4009fc HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove
HP D2D4009fc Manual
View all HP D2D4009fc manuals
Add to My Manuals
Save this manual to your list of manuals |
HP D2D4009fc manual content summary:
- HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 1
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 www.hp.com/support/manuals for the most up-to-date documentation for your product - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 3
Entry...7 Viewing Help...7 Transferring Files...7 Scripting...7 2 Command Instruction Syntax 8 Global Defaults...9 3 Categorical List of Commands 10 reboot...42 hardware set ports...43 hardware show firmware...44 hardware show net status...46 hardware show node status...48 hardware show problems - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 4
...116 snmp show 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 5
...143 system shutdown...145 system update ...168 vtl modify library...170 vtl move cartridge...174 vtl show capacity...176 vtl show cartridges...178 vtl show drive info...180 vtl show vtl show ports...189 5 Support and other resources 191 Contacting HP...191 Related information...191 Websites... - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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, and the Administrator - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 8
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 The use of carat parenthesis such as or indicates user entry is required to define the object or parameter • The use of special - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 9
the existence of most objects which depend on the StoreOnce appliance or user requirements, global defaults are directly related to the 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 10
" (page 40) "hardware prepare storage" (page 41) "hardware reboot" (page 42) "hardware set 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 12
system enable failover" (page 125) "system load packages" (page 126) "system reboot" (page 127) "system set clioutput" (page 128) "system set description" (page 136) "system set pagecontrol" (page 137) "system show config" (page 138) "system " (page 174) "vtl show capacity" (page 176) "vtl show - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 13
Description of Command Function Creates an account that interfaces with the StoreOnce appliance using the CLI or GUI. NOTE: The standard factory or (i.e the password is case sensitive). This parameter is valid only for users of type "local". Requirements for Command Execution The command entry must - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 14
account, the following is displayed: Command Failed - account ACCOUNT already exists, where ACCOUNT is the string label of the account. Example # accounts add Joe_Operator level user newpassword F00tB*ll F00tB*ll account Joe_Operator added 14 Alphabetical List of Commands and Details - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 < - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 16
uppercase/lowercase alphabets, numbers and the following symbols !@#$%^&* Note: The two password entries should match. You cannot modify a password for external users or groups. • level - This parameter may be modified to change the access level for the specified account. Access level may only be - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 18
of Command Function Lists all the user accounts and their authority level defined for the StoreOnce appliance. Command Syntax accounts show shown. • A user with user permissions will see only their account. • A user with admin permissions will see all accounts on the system. Successful Command - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 19
User Name Type Authority HERZOG-AD1\mayuri123 External User admin accounts show 19 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 20
HBA link 50.06.05.b0.02.56.45.00 on host d2dd48564785fd8_node_1 status is > alerts show verbose EVENT ID TIMESTAMP LEVEL TEXT FILESYSTEM HOST USER NAME OPERATION SEGMENT NUMBER PV NUMBER NIC HBA RELATED EVENT 580 Jul 21 16:22:50 ALERT HBA link 50.06.05.b0.02.56 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 23
hardware does not match the configuration file (difference in number of nodes) ◦ Command Failed - The system hardware does not match the configuration file (service set does not exist) ◦ Command Failed - Configuration file has been modified (use of the force parameter will override this check) • If - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 25
ID and serial number> .zip. NOTE: For more 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). See also "config restore devices" (page 22). Command Syntax config save - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 27
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 manage the transfer of valid configuration files into the config directory.) Command Syntax config show list [devices|keystore] Command Authority Operator - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 29
be executed, newly discovered storage must exist as presented in the system show status command (see "system show status" (page 143)). At least one storage set must storage enclosure must contain 12 drives all of the same capacity. Successful Command Output Upon successful completion of the command, - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 32
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. Example # hardware delete storage ALL - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 33
feature between 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 38
Description of Command Function Powers down the StoreOnce appliance. If a file server node entry 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 39
poweroff request successfully sent hardware poweroff 39 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 as described under Command Syntax in this section. • If the entire StoreOnce appliance or the specified node is already powered up, the following is - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 42
Reboots the StoreOnce appliance nodes. If a file server node is defined in the command entry, only this node is rebooted. Command Syntax hardware reboot to verify that the server nodes rebooted correctly. Also, if the reboot applies to the node currently supporting the CLI interface, the session will - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 44
not conform to the required syntax, SYNTAX, where SYNTAX is the command syntax as described under Command Syntax in this section. Example # hardware show firmware Server ====== * Component Action Current Available BIOS NONE P70 12/14/2012 P70 12/14/2012 ILO4 NONE 1.22 1.22 NIC NONE BC - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 46
only. Description of Command Function Provides status on the StoreOnce file server node's network interfaces. Command Syntax hardware bond0:1 Cluster Up, LinkUp 10.10.1.1 No d2d78e7d1e6928e_node_1 [Active FM Nonedit] bond1:2 User Up, LinkUp 10.10.10.5 No MAC_ADDRESS 78:e7:d1:e6:92:8e 78: - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 54
uniquely defining the hardware component. NOTE: X is optional for single node products. • allow-downgrade - This optional parameter allows the firmware upgrade to remain back-ward compatible. Requirements for Command Execution • The command entry must conform to the command syntax. • All parameter - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 55
available • accounts - manage user accounts. • alerts - commands related to display and settings of alerts and events. • filesys - provides information on the Backup System file system. • hardware - manage Backup System hardware. • license - manage Backup System licenses. • logs - commands - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 57
is the command syntax as described under Command Syntax in this section. Example # hpresetpassword (current) UNIX password: # manage Changing password for user HPresetpassword (current) UNIX password: new password: new password: # reset Admin password reset Admin password reset hpresetpassword 57 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 58
Description of Command Function Provides for the installation of a StoreOnce appliance license. The license is entered as a 168 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 59
must 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 60
License Name: HP StoreOnce Replication 4700 E-LTU Description: HP StoreOnce 4700 Replication LTU (Instant-On) Days remaining: 90 Expiration Date: December 04, 2013 23:59:59 PM UTC Licenses to Use (LTU): N/A Capacity: 1 FeatureID: 9165 Key: N/A License Name: HP StoreOnce Catalyst 4700 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 61
command syntax as described under Command Syntax in this section. Example > logs show events EVENT ID TIMESTAMP LEVEL TEXT FILESYSTEM HOST USER NAME OPERATION SEGMENT NUMBER PV NUMBER NIC HBA RELATED EVENT 644 Aug 3 19:00:41 INFO Nic bond1:3 on host d2d78e7d1e6928e_node_1 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 62
3 18:58:13 d2d78e7d1e6928e_node_2 0 ALERT Server d2d78e7d1e6928e_node_2 in failover d2d78e7d1e6928e_node_2 0 634 Aug 3 18:58:13 INFO Command from Local Host, user root: Failover for server d2d78e7d1e6928e_node_2. d2d78e7d1e6928e_node_2 NOTE: The example output is in a small font to fit on this - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 63
the software updates that have occurred on the system. Command Syntax logs show update Command Authority Administrator Reboot will occur after update completes. 14:25:27 Verifying status of hardware and services. 14:25:27 Hardware and services status verification successful. 14:25:27 Stopping service - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 64
is up to date 14:34:49 node 5 : Server firmware update 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 65
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 message is displayed and the CLI returns to the user prompt: Command Successful Command Operation during Abnormal Conditions - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 66
Command Successful 66 Alphabetical List of Commands and Details - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 67
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 is displayed and the CLI returns to the user prompt: Command Successful Command Operation during Abnormal Conditions - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 68
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 is displayed and the CLI returns to the user prompt: Command Successful Command Operation during Abnormal Conditions - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 69
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 is displayed and the CLI returns to the user prompt: Command Successful Command Operation during Abnormal Conditions - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 78
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, the command sequence fails - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 88
# net show config External Network Configuration Template 2 Management/Data/Replication on (4) 1Gb ports (bonded) Virtual Management Console IP Address: Node Specific Parameters Node 1: 1GbE Network Physical IP (HP Service Only): 16.24.164.22 1GbE Network Virtual Data IP: 16.24.164. - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 96
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 Commands - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 99
-algo(v3 only) - This optional parameter identifies the SNMP version 3 privacy algorithm used to encrypt messages or received on behalf of this user (default is DES). • privacy-password(v3 only) - This optional parameter specifies the privacy password for SNMP version 3 and decryption (default is no - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 100
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 or IP address of the trap host and username is the authorized SNMP user provided in the command entry. Command Operation during Abnormal Conditions • If - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 101
.44 version 2 event alerts Command Successful, trapsink 16.34.123.44 added SNMP version 3: # snmp add 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 102
characters. Requirements for Command Execution The command entry must conform to the command syntax. Successful Command Output Upon successful command entry, the SNMP user "username" is created and added to a group per the security level set for the SNMP agent and the following is displayed: Command - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 103
Command Successful, snmp user john-snmp added snmp add user 103 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 105
must conform to the command syntax. Successful Command Output Upon successful command entry, the SNMP user "username" is deleted and the following is displayed: Command Successful, snmp user 'username' deleted Command Operation during Abnormal Conditions • If any of the command elements (snmp, del - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 107
version - This is a mandatory parameter which implies which SNMP version the user wants to set. The parameter consists of the text version followed by a 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 108
-algo(v3 only) - This optional parameter identifies the SNMP version 3 privacy algorithm used to encrypt messages or received on behalf of this user (default is DES). • privacy-password(v3 only) - This optional parameter specifies the privacy password for SNMP version 3 and decryption (default is no - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 109
"username", where FQDN | IP is the fully qualified domain name or IP address of the trap host and username is the authorized SNMP user provided in the command entry. Command Operation during Abnormal Conditions • If any of the command elements (snmp, modify, trapsink) are misspelled, the following - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 110
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 any of the command - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 113
of a 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 115
Defines 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 116
their trap community string • The StoreOnce appliance's SNMP agent contact string (or blank if not defined). • The StoreOnce appliance's SNMP agent location string (or config Description: This command displays information on the backup system's snmp configuration. Example: snmp show config - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 117
.5.170 3 162 on User Name --------d2dUser Auth Algorithm Auth Password Priv Algorithm Priv MD5 authpasswd DES privpasswd Snmp agent parameters Version : 2 Port : 161 SysContact : JAdmin SysLocation : Paradise SysDescr : HP StorageWorks D2D Backup System [D2D Serial Number - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 118
no objects exist within this command. Command Parameter Requirements USERNAME - If this optional parameter is included, the SNMP settings for only that user are displayed. Requirements for Command Execution • The command entry must conform to the command syntax. • The username in the command entry - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 121
successful completion of the command, all the support tickets which exist within the StoreOnce appliance are listed with their description and 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 124
system disable failover NOTE: This command applies to multi-node products only. Description of Command Function Disables the failover feature on the StoreOnce be updated to disable failover for given service sets. Command Syntax system disable failover Command Authority Administrator Command Object - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 125
system enable failover NOTE: This command applies to multi-node products only. Description of Command Function Enables the failover feature on the StoreOnce updated to enable failover for give service sets. Command Syntax system enable failover Command Authority Administrator Command Object - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 126
the repository is outside the scope of this document. This command moves the file image from the StoreOnce appliance and into the package update queue. The next time the system update packages command is executed the StoreOnce appliance will be updated with the packages in the queue. Command Syntax - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 127
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 - no - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 129
step-based wizard to guide you through a complete series of system configuration steps: • Configure configuration and reboot • Finish configuration . Command Syntax system set config multinode products (configure failover is not supported in single-node). > system set config Please ensure all nodes - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 130
Configure Failover Finish Configuration and reboot Finish Configuration Actions: execute) - Management on (2) 1Gb ports (bonded), Data/Replication on (2) 10Gb ports (bonded) Do you want Select bonding mode for 10GbE data bond enter 1 (Active/Backup), 4 (IEEE 802.3ad Dynamic Link Aggregation), or 6 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 131
to maintain reliable network connectivity to this system. Continue with network setup? [Y/N]: Enter 1GbE management bond enter 1 (Active/Backup), 4 (IEEE 802.3ad Dynamic Link Aggregation), or 6 (Active Load Balancing), (default = 1): Template #2 - Management/Data/Replication on (4) 1Gb ports ( - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 /Replication on reboot system (mm/dd/yyyy hh: - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 133
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. The system will need to be rebooted via the 'system reboot' command. Enter 'y' to continue or 'n' to skip [default='n']: Enter Selection: 2 Enter up to 2 ntp server - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 134
-> Verify Hardware health Configure Failover Finish Configuration and reboot Finish Configuration Actions: execute) Perform the current step 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 135
Configure Failover -> Finish Configuration and reboot Finish Configuration Actions: execute) Perform the configuration immediately Finish Configuration and reboot [execute]? MENU Item 7 The following health Configure Failover Finish Configuration and reboot -> Finish Configuration Actions: execute) - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 136
Function Defines the string used to label and identify the 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 Command Authority Administrator Command Object Requirements - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 138
Description of Command Function Displays information on the StoreOnce appliance system configuration. Command Syntax system show config Command Authority Operator and Administrator Command Object Requirements Not applicable - no objects exist within this command. Command Parameter Requirements - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 139
Command Function Displays information on the software packages currently installed on the StoreOnce appliance and packages that have been added to the queue for installation. Command Syntax system show packages Command Authority Operator and Administrator Command Object Requirements Not applicable - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 140
provided for that service set. Command Syntax system show performance [SETX] Command Authority Operator and Administrator Command Object Requirements SETX - This optional object is a service set. It is the software operations which reside on a given node and support the StoreOnce function. SETX is - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 145
Function Gracefully shuts down the entire StoreOnce appliance. Command Syntax system shutdown Command Authority Administrator Command Object the command syntax. Successful Command Output Upon successfully sending the reboot request, the following is displayed: shutdown request successfully sent - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 even if the StoreOnce - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 147
Depending 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 may be assigned to the D2D appliance Example # time add ntpserver ntp.hp.net ntp server(s) added successfully # time add ntpserver 10.10.10.10 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 148
ntp server(s) added successfully 148 Alphabetical List of Commands and Details - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 149
Depending 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 No more than two ntp server objects can exist for a given StoreOnce appliance.) Requirements for Command Execution • The command entry must conform - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 151
Parameter Requirements timezone - A parameter defining the time zone for the StoreOnce appliance must appear in the command entry after time set timezone. entry, the command will execute a menu driven list allowing the user to select a timezone. Requirements for Command Execution The command entry - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 153
time set UTC Description of Command Function Sets the value of the system clock on the node with active fusion manager to the value defined within the command entry. NTP must be disabled for this command to execute. - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 154
of Command Function Displays the time configuration and the StoreOnce appliances UTC and local times. Command Syntax time show under 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 158
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 default value is no. • tUserName - This optional parameter defines the target user name for the CHAP (challenge handshake authentication protocol) and is only valid if - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 162
Administrator Command Object Requirements • SETX - This object defines the service set containing the virtual tape library from which the cartridge will index of the library. NOTE: This is the library object name, not the user-defined name of the library. You can find the LIBX object name for a - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 163
>] [mail ] [slot ]" ◦ Command Failed - The service set is invalid ◦ Command Failed - The service set does not exist ◦ Command Failed - The library - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 164
◦ 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 prompt. Example # vtl delete library LIB4 164 Alphabetical List of Commands and - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 165
Command Successful vtl delete library 165 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 166
Object Requirements • SETX - This required object defines the service set containing the virtual tape library that contains the cartridge to numeric index of the library. NOTE: This is the library object name, not the user-defined name of the library. You can find the LIBX object name for a library - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 168
Command Object Requirements • SETX - This required object defines the service set containing the virtual tape library that contains the drive to numeric index of the library. NOTE: This is the library object name, not the user-defined name of the library. You can find the LIBX object name for a - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 170
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 the numeric index of the library. NOTE: This is the library object name, not the user-defined name of the library. You can find the LIBX object - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 171
is either yes or no. If not defined, the current value remains unchanged. • iUserName - single-node only. This optional parameter defines the initiator user name for the CHAP (challenge handshake authentication protocol) and is only valid if the interface is iSCSI. The value is a text string with - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 172
tUserName - single-node only. This optional parameter defines the target user name for the CHAP (challenge handshake authentication protocol) and is quotes (") is odd. • Command Failed - The service set is invalid • Command Failed - The service set does not exist 172 Alphabetical List - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 176
Failed - If a library is defined, a service set must be defined Examples # vtl show capacity Object -----SET1 LIB1 LIB2 Lib3 SET2 LIB1 LIB2 Lib3 Space Used ---------- 4 TB 5 TB 1 TB 10 TB 5 TB 1 TB User Data --------- 20 TB 75 TB 5 TB 20 TB 75 TB 100 TB Dedupe Ratio 5:1 15:1 5:1 2:1 15:1 100 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 178
to be described. X is the numeric index of the service set. If not defined, the capacity information is provided at the cluster level. • LIBX - CART2 2 Barcode ------ABC001YZ ABC002YZ Max Size -------- 800 GB 800 GB User Data --------- 745 GB 712 GB Protected --------- yes yes Mapped ------ no - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 179
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 GB yes no 800 GB 785 GB yes - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 180
set containing the virtual library drives to be described. X is the numeric index of the service set. If not defined, the capacity information is provided at the cluster level. • LIBX - This required object is the virtual tape library that contains the drive to be described. X is the - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 184
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, Command Failed - A service set must be defined Examples # vtl show library info lib1 Object Name Creation Time Replication Role Deduplication NonStop Emulation Type - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 185
lib2 Object Name Creation Time Replication Role Deduplication NonStop Emulation Type Default hp:storage.d2dbs.nre0a6b83d.5001438011a18947.library2.robotics : D2DBS.nre0a6b83d.0.Library2.Robotics Initiator iSCSI Name : Authenticate Initiator : User Name : Authenticate Target : User Service - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 186
Object : LIB1 Name : Robslib >>>>Additonal Information>Additonal Information - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 187
show library iscsi authentication SETX LIBX" • Command Failed - The service set is invalid • Command Failed - The service set does not exist • Command Failed - The : Authenticate Initiator : CHAP User Name : CHAP Secret : Authenticate Target : CHAP User Name : CHAP Secret : - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 189
hardware show ports command but is included to allow the user to obtain this information (required when configuring libraries) 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: - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 191
user guide • [example] HP StorageWorks Command View EVA release notes You can find these documents on the Manuals page of the HP Business Support Center website: www.hp.com/support/manuals In the Storage section, click link label and then select your product. Websites • HP Event Monitoring Service - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - 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 D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 195
, 38 powerup, 40 prepare storage, 41 reboot, 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 - HP D2D4009fc | HP StoreOnce Backup System CLI Reference Guide (BB877-90906, Nove - Page 196
set contact, 113 set location, 114 set ro-community, 115 show config, 116 show user , 118 support create ticket, 119 del ticket, 120 show ticket, 121 symbols in text, 192 syntax for commands, 8 system clear packages, 122 clear repository, 123 disable failover, 124 enable failover, 125 load packages
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