HP StoreOnce Backup System Single-node and Multi-node 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 http://www.hp.
© Copyright 2011–2013 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Using the CLI.............................................................................................6 Introduction..............................................................................................................................6 Accessing the CLI.....................................................................................................................6 Command Entry........................................................................................................
net modify config...................................................................................................................63 net modify subnet...................................................................................................................65 net ping................................................................................................................................67 net set config.........................................................................................
vtl vtl vtl vtl vtl vtl vtl vtl vtl vtl vtl vtl vtl vtl delete cartridge................................................................................................................144 delete library...................................................................................................................146 modify cartridge...............................................................................................................148 modify drive...............................................
1 Using the CLI Introduction The Common CLI Command Set provides a method of communication with the StoreOnce appliance which is intuitive, consistent, and easy to use. The command set is broad in scope so that once learned, you can use it with the entire StoreOnce portfolio of products. The commonality of the CLI command set means that some unsupported commands will be present in the CLI inline help (commands that are not applicable your appliance or are accessible through a different CLI command).
Table 1 Login Information (continued) Authorization Level Can Execute User Name Password Command Prompt the StoreOnce appliance. 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 and symbols. Pressing the enter key directs the Common CLI to interpret the instruction entry and perform the defined operation.
2 Command Instruction Syntax A StoreOnce appliance is controlled by operations. An operation is one or more of the following events: • Providing configuration information to the appliance • Requesting an action • Obtaining information about the appliance The execution of operations is initiated by instructions. The instruction entry consists of three parts: • The command sequence — up to four command elements representing groups of related operations, actions, or subjects of the action.
• The use of parenthesis such as (object) indicates a label for the object will be automatically generated by the Common CLI application. No entry is required for this item. • The use of parenthesis enclosing the phrase default=value such as (default=value) indicate that if no value is provided for this parameter, the value within the parenthesis will be used. Global Defaults Global defaults exist to clearly represent groups of objects or specific objects.
3 Categorical List of Commands Table 3 Commands by Category Command Group Commands accounts “accounts add” (page 13) “accounts del” (page 15) “accounts modify” (page 16) “accounts show” (page 17) alerts “alerts show” (page 18) config “config delete” (page 19) “config restore devices” (page 20) “config save devices” (page 22) “config show list” (page 23) exit “exit” (page 24) hardware “hardware add storage” (page 25) “hardware beacon” (page 26) “hardware delete storage” (page 27) “hardware disable
Table 3 Commands by Category (continued) Command Group Commands “net delete subnet” (page 62) “net modify config” (page 63) “net modify subnet” (page 65) “net ping” (page 67) “net set config” (page 68) “net set wizard” (page 70) “net show config” (page 73) “net show config” (page 75) “net show config list” (page 77) “net show ports” (page 78) “net show status” (page 79) “net validate config” (page 80) serviceset “serviceset show status” (page 81) “serviceset start” (page 82) “serviceset stop” (page 83)
Table 3 Commands by Category (continued) Command Group Commands “system show repository” (page 125) “system show status” (page 126) “system shutdown” (page 128) “system update packages” (page 129) time “time add ntpserver” (page 130) “time del ntpserver” (page 132) “time reset timezone” (page 133) “time set timezone” (page 134) “time set UTC” (page 136) “time show config” (page 137) vtl “vtl create cartridge” (page 138) “vtl create library” (page 140) “vtl delete cartridge” (page 144) “vtl delete libra
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 password: admin. You cannot create that account, but you can modify or delete it.
lower case letters, numbers and the following symbols ! @ # $ % ^ & * • If the account description is too long, the following is displayed: Command Failed – The account description can only be 32 characters max • If the label is the same as an existing account, the following is displayed: Command Failed - account ACCOUNT already exists, where ACCOUNT is the string label of the account.
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 password Command Authority Administrator Command Object Requirements ACCOUNT – This required object is a string matching the label of an existing account.
accounts modify Description of Command Function Modifies the password of an existing account. Command Syntax accounts modify [ACCOUNT] password newpassword Command Authority Administrator Command Object Requirements ACCOUNT – This required object is a string of an existing account. Command Parameter Requirements password – This parameter may be modified for the account defined within this command by entering a new value.
accounts show Description of Command Function Lists all the user accounts and their authority level defined for the StoreOnce appliance. Command Syntax accounts show [current] Command Authority Administrator Command Object Requirements current – As an option, the global default “current” may be included in the command entry. If included, “current” must follow accounts show in the command entry.
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 53). Command Syntax alerts show [verbose] [numofevents ] Command Authority Operator, Administrator Command Object Requirements Not applicable – no objects exist within this command.
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 deleted from the configuration jail directory. This file must exist in the configuration jail directory. The config show list command lists all valid configuration files in the config directory.
config restore devices Description of Command Function Restores the StoreOnce system devices to the condition detailed in the defined device’s configuration file. 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 save devices” (page 22).
• ◦ 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 the force parameter is set, the following message is displayed before executing the command: The validity of the configuration file is not being checked.
config save devices Description of Command Function Saves the device configuration to the configuration jail directory using the standard naming convention of devconfig_ .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 20).
config show list Description of Command Function Displays a list of saved configuration files. A saved configuration file is any file located in the config jail directory with the .zip extention. (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.
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. Requirements for Command Execution The command entry must conform to the command syntax. Successful Command Output Not applicable – after command execution, the terminal is closed.
hardware add storage Description of Command Function This command adds storage which has been discovered using the hardware discover storage command (see “hardware discover storage” (page 30)). Before this command can be executed, newly discovered storage must exist as presented in the system show status command (see “system show status” (page 126)). At least one storage set must exist with a status of “discovered (XXTB)” where XX cannot be equal to zero.
hardware beacon NOTE: This command applies to 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 – This required object defines the hardware component whose beacon is to be turned on or off.
hardware delete storage NOTE: This command applies to single-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 Administrator Command Object Requirements Not applicable – no objects exist within this command.
• ◦ 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.
hardware disable failover NOTE: This command applies to multi-node products only. Description of Command Function Disables the failover 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.
hardware discover storage Description of Command Function Discovers storage which has been connected to the StoreOnce appliance. Before this command can be executed, any previous discovery process must be complete. No storage set can have the status of “discovering.” The status of storage sets can be obtain by using the system show status command (see “system show status” (page 126)).
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 29)) command. Command Syntax hardware enable failover [NODEX] Command Authority Administrator Command Object Requirements NODEX – As an option, this can be used to define an individual file server node. X is a unique numeric index.
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 hardware failover command (see “hardware failover” (page 33)).
hardware failover NOTE: This command applies to multi-node products only. Description of Command Function Forces the implementation of the high 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.
hardware poweroff NOTE: This command applies to multi-node products only. Description of Command Function Powers down the StoreOnce appliance. If a file server node is defined in the command entry, only this node is powered down. NOTE: This command will only work if failover is enabled.
poweroff request successfully sent hardware poweroff 35
hardware powerup NOTE: This command applies to multi-node products only. Description of Command Function Powers up the StoreOnce appliance. If a file server node is defined in the command entry, only this node is powered up. Command Syntax hardware powerup [NODEX] Command Authority Administrator Command Object Requirements NODEX – As an option, this can be used to define an individual file server node. X is a unique numeric index.
hardware prepare storage Description of Command Function An alias for the hardware discover storage command. See “hardware discover storage” (page 30) for details.
hardware reboot NOTE: This command applies to multi-node products only. Description of Command Function 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 [NODEX] Command Authority Administrator Command Object Requirements NODEX – As an option, this can be used to define an individual file server node. X is a unique numeric index. NODEX is a label uniquely defining the hardware component.
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 Command Object Requirements • NODEX – This object defines the node containing the port whose parameters are to be set. X is a numeric index for the node.
hardware 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 applicable – no objects exist within this command. Command Parameter Requirements Not applicable – no parameters exist within this command.
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 node status Description of Command Function Provides status on the StoreOnce file server nodes. If a node object is included in the command entry. The port and component status is only provided for that node. Command Syntax hardware show node status [NODEX] Command Authority Operator and Administrator Command Object Requirements NODEX – As an option, this can be used to define an individual file server node. X is a unique numeric index.
hardware show problems Description 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 Not applicable – no parameters exist within this command. Requirements for Command Execution The command entry must conform to the command syntax.
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 command. Command Parameter Requirements • detail – This optional parameter provides a detailed output for the hardware components selected. If not defined, only the device ID and its status are provided.
- controller-1-2 - enclosure-1-1 - enclosure-1-2 - raidset-1-1 - raidset-1-2 - raidset-1-3 - raidset-1-4 Command Successful up down up up warn up up > hardware show status Couplet_1 detail dev-id ---------------------------------------------------------------------Couplet_1 Name = Couplet_1 SerialNumber = Couplet_1 Status = 3 Id = Couplet_1 FirmwareVersion = Type = COUPLET Vendor = HP SystemName = HP B6200 StoreOnce Backup System RolledUpStatus = down diagMessages = AdditionalProperties = groupId=null, di
FirmwareVersion Type Vendor SystemName RolledUpStatus diagMessages AdditionalProperties = = = = = = = P67 05/05/2011 SERVER HP HP B6200 StoreOnce Backup System unknown Good UIDBeacon=On, ReleaseVersion=3.3.0-1222.16 Command Successful 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 storage status Description of Command Function An alias for the system show status command. See “system show status” (page 126) for details.
help Description of Command Function Provides information to assist in the use of the CLI. Command Syntax help [command] Command Authority Operator and Administrator Command Object Requirements Not applicable – no objects exist within this command entry. Command Parameter Requirements • Command Group – A command group word may be included in the command entry. If this parameter is included, it appears after “help” in the command entry. • Command – a command word may be included in the command entry.
• support — 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 root access on the server node.
license add Description of Command Function Provides for the installation of a StoreOnce appliance license. The license is entered as a 168 character string. Command Syntax license add Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command entry. Command Parameter Requirements license – a license string must appear in the command entry after license add. The license string is 168 characters in length.
license load Description of Command Function Provides for the installation of a StoreOnce appliance license. The license is entered as a file image which exists in the StoreOnce appliances repository directory. The means by which the license file is placed in the repository directory is outside the scope of the CLI. Command Syntax license load Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command entry.
license show Description of Command Function Displays the licenses which are available for this StoreOnce appliance. Command Syntax license show Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command entry. Command Parameter Requirements Not applicable – no parameters exist within this command entry. Requirements for Command Execution The command entry must conform to the command syntax.
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 ] (default = 20) Command Authority Operator, Administrator Command Object Requirements Not applicable – no objects exist within this command.
637 636 635 634 Aug 3 18:58:41 bond1:1 0 INFO Nic bond1:3 on host d2d78e7d1e6928e_node_1 up Aug 3 18:58:19 d2d78e7d1e6928e_node_1 bond1:3 0 WARN Server d2d78e7d1e6928e_node_2 failed over Aug 3 18:58:13 d2d78e7d1e6928e_node_2 0 Server d2d78e7d1e6928e_node_2 in failover Aug 3 18:58:13 ALERT INFO d2d78e7d1e6928e_node_2 0 Command from Local Host, user root: Failover for server d2d78e7d1e6928e_node_2.
net activate config NOTE: This command applies to single-node products only. Description of Command Function Configures the external network. IMPORTANT: If the network you are using for the CLI session is modified from this command, your session may be terminated.
net add subnet NOTE: This command applies to single-node products only. Description of Command Function Adds a subnet data structure to the network configuration.
• • 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/Backup) Simple bonding mode that allows network traffic via one active Templates 1, 3, 4, and 5 port only. If the active network fails then traffic moves to the backup port. Mode 4 (IEEE 802.
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 network configuration is copied to the new network configuration object created by this command. • newnetlabel – This network configuration object is created by this command.
net create config NOTE: This command applies to single-node products only. Description of Command Function Creates a data structure that defines a network configuration. (A default data structure exists as part of the initial installation.
• netmask – This optional parameter defines the netmask. If the IPAddr value is DHCP, a value is not required for netmask. • gateway – This optional parameter defines the gateway for the subnet configuration. • ports – This parameter defines the ports which will be attached to the subnet for each node associated with the network configuration containing the subnet. (See the “net activate config” (page 55) command for details on how the nodes are associated with network configurations.
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 deleted. This label is case insensitive. Command Parameter Requirements Not applicable – no parameters exist within this command.
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 configuration to which the subnet will be added. This label is case insensitive. • sublabel – This label identifies the subnet configuration within the define network configuration that will be deleted.
net modify config NOTE: This command applies to single-node products only. Description of Command Function Modifies the parameters in an existing network configuration.
• domain – This optional parameter defines the domain name for the preceding subnet configuration. • IPAddr – This parameter defines an IP address. The value DHCP can be used to indicate that the IP address will be defined by a DHCP server. • netmask – This optional parameter defines the netmask. If the IPAddr value is DHCP, a value is not required for netmask. • gateway – This optional parameter defines the gateway for the subnet configuration.
net modify subnet NOTE: This command applies to single-node products only. Description of Command Function Modifies an existing named subnet configuration. Modifies parameters in the current configuration and validates and activates settings. NOTE: It is not possible to modify the default configuration.
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) Simple bonding mode that allows network traffic via one active Templates 1, 3, 4, and 5 port only. If the active network fails then traffic moves to the backup port. Mode 4 (IEEE 802.
net ping Description of Command Function Verifies communication by pinging a defined location. Command Syntax net ping [{NODEX|CLI|GUI}] [IPAddr ]|[FQN ] Command Authority Operator and Administrator Command Object Requirements • NODEX – This object defines which node should transmit the “ping” packet. X is the index which uniquely defines each node in the cluster. • GUI – This optional global object determines that the node supporting the GUI processes will transmit the “ping” packet.
net set config NOTE: This command applies to multi-node products only. Description of Command Function Configures the external network 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 Command Object Requirements TEMPLATEX – One of five predefined configurations.
• 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.
net set wizard NOTE: This command applies to single-node products only. Description of Command Function Runs a step-based wizard to guide you through the creation of a complete network configuration. Command Syntax net set wizard Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements Not applicable – no parameters exist within this command.
Select bond configuration : 1.) eth0 and eth1 (1 Gig) (default) 2.) eth3 and eth4 (10 Gig) 1 Select Static or DHCP addressing : 1.) DHCP (default) 2.) Static 2 Enter static IP address : 192.168.1.27 Enter subnet mask : 255.255.255.0 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.
Step Complete. Do you want to : 1.) Finish wizard and apply settings (default) 2.) Go back to previous 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 show config NOTE: This command applies to multinode products only. Description of Command Function Shows the network configuration. Command Syntax net show config 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. Requirements for Command Execution The command entry must conform to the command syntax.
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.
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 the specific network configuration to be shown. If the object is not included in the command sequence, the parameter “all” must be included in the command sequence.
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: ---------------------Number of Networks:1 ---------------------Network: subnet_one ---------------------IP Address: dhcp Net Mask: dh
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 – no objects exist within this command. Command Parameter Requirements list – Though list is presented as a command word, it is in fact a parameter.
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 object determines that port information will be provided for individual nodes verses the entire cluster. Command Parameter Requirements Not applicable – no parameters exist within this command.
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 applicable – no parameters exist within this command. Command Parameter Requirements • subnet – This parameter shows subnetwork status. • port— This parameter shows port status.
net validate config NOTE: This command applies to single-node products only. Description of Command Function Validates a configuration. The command checks the data structure according to the rules listed in the net activate config command. However, unlike the activate command, the external network is not configured as defined by the data structure. This command exists to allow a newly created configuration to be tested before configuration is actually activated.
serviceset show status Description of Command Function This command displays information on the selected or all service sets. Command Syntax serviceset show status [SETX] [all] Command Authority Operator and 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 the command sequence.
serviceset start Description of Command Function This command starts the service sets. The command will either start the service set defined in the command sequence or if parameter “all” is included in the command sequence, all the service sets in the cluster will 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.
serviceset stop Description of Command Function This command stops the service sets. The command will either stop the service set defined in the command sequence or if parameter “all” is included in the command sequence, all the service sets in the cluster will be sopped. IMPORTANT: service set.
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).
Requirements for Command Execution The command entry 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 fully qualified domain name or IP address of the trap host.
port 182 events information authentication-algo SHA authuthentication-pwd authpass privacy-algo AES privacy-pwd privpass contextname cname - adds trapsink 14.34.123.44 for SNMP version 3. • If the SNMP USERNAME provided does not exist, the following is displayed: Failed – snmp user USERNAME does not exist, where USERNAME is the user name provided in the command entry. Examples SNMP version 2: # snmp add trapsink 16.34.123.44 version 2 event alerts Command Successful, trapsink 16.34.123.
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 Authority Administrator Command Object Requirements Not applicable – no objects exist within this command.
Command Successful, snmp user john-snmp added 88 Alphabetical List of Commands and Details
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 84)). Command Syntax snmp del trapsink Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements FQDN or IP – This is a required parameter.
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 within this command. Requirements for Command Execution The command entry must conform to the command syntax.
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 command. Requirements for Command Execution The command entry must conform to the command syntax.
snmp enable Description of Command Function Enables the SNMP functionality. Command Syntax snmp enable [version {1|2|3}] [engine-id ] [allownonv3request ] Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements • 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 value of 1, 2, or 3.
snmp modify trapsink Description of Command Function Modifies the host to which the SNMP agent sends traps.
Successful Command Output Upon successful entry of the command sequence the trap host values are modified and the following is displayed: SNMP versions 1 and 2: Command Successful, host trap FQDN | IP modified, where FQDN | IP is the fully qualified domain name or IP address of the trap host.
snmp modify user Description of Command Function Modifies an existing SNMP user. Command Syntax snmp modify user USERNAME security-level {noAuthNoPriv|authNoPriv|authPriv} [authorization-algo {MD5|SHA}] [authorization-pwd ] [privacy-algo {DES|AES}] [privacy-pwd ] Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command.
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 96 Alphabetical List of Commands and Details
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 applicable – no objects exist within this command. Command Parameter Requirements Not applicable – no parameters exist within this command.
snmp set contact Description of Command Function Defines a text string indicating the contact person for SNMP agent management of this StoreOnce appliance. Command Syntax snmp set contact <”contact”> Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements contact – This is a required parameter. It consists of a character text string enclosed in quotations.
snmp set location Description of Command Function Defines a text string indicating the location of the StoreOnce appliance containing the SNMP agent. Command Syntax snmp set location <”location”> Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements location – This is a required parameter. It consists of a character text string enclosed in quotations.
snmp set ro-community Description of Command Function 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 <”ro-community”> Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements ro-community – This is a required parameter. It consists of a character text string enclosed in quotations.
snmp show config Description of Command Function Displays information on the StoreOnce appliance’s SNMP configuration. Command Syntax snmp show config Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements Not applicable – no parameters exist within this command. Requirements for Command Execution The command entry must conform to the command syntax.
SNMP V3 Trapsinks ================= Trapsink Address Version Port Password Context State ----------------------------------------------16.78.5.
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 Parameter Requirements USERNAME – If this optional parameter is included, the SNMP settings for only that user are displayed.
support create ticket Description of Command Function Creates a 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 ticket object with a date label is created. Command Parameter Requirements Not applicable – no parameters exist within this command.
support del ticket Description of Command Function Deletes support tickets which exist for the StoreOnce appliance. Command Syntax support del ticket {TICKET|ALL} Command Authority Administrator Command Object Requirements • TICKET – This object is a support ticket 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.
support show ticket Description of Command Function Lists the support tickets that exist for the StoreOnce appliance. Command Syntax support show ticket Command Authority Administrator Command Object Requirements Not applicable – objects exist within this command. Command Parameter Requirements Not applicable – no parameters exist within this command. Requirements for Command Execution The command entry must conform to the command syntax.
system clear 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 Not applicable – no parameters exist within this command. Requirements for Command Execution The command entry must conform to the command syntax.
system 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 Requirements Not applicable – no parameters exist within this command. Requirements for Command Execution The command entry must conform to the command syntax.
system disable failover NOTE: This command applies to multi-node products only. Description of Command Function Disables the failover feature on the StoreOnce appliance. It is a direct map to the command sequence hardware disable failover (see “hardware disable failover” (page 29)). For 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.
system enable failover NOTE: This command applies to multi-node products only. Description of Command Function Enables the failover feature on the StoreOnce appliance. It is a direct map to the command sequence hardware enable failover (see “hardware enable failover” (page 31)). For the 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.
system load packages Description of Command Function Loads the queue with the packages for which the StoreOnce appliance will be updated. The update package is a file image which must exist in the StoreOnce appliance repository. The placement of the files in 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.
system 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 – no parameters exist within this command. Requirements for Command Execution The command entry must conform to the command syntax.
system set clioutput Description of Command Function Defines the format of the command output. The format can be either ASCII text 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.
system set config Description of Command Function Runs a step-based wizard to guide you through a complete series of system configuration steps: • Configure network • Configure time • Configure licenses • Verify hardware health • Configure failover • Finish configuration and reboot • .
Configure Network [execute]? Please choose a template to apply: 1) Management on (2) 1Gb ports (bonded), Data/Replication on (2) 10Gb ports (bonded) - Template 1 2) Management/Data/Replication on (4) 1Gb ports (bonded) - Template 2 3) Management/Data/Replication on (2) 10 Gb ports (bonded) - Template 3 4) Management on (2) 1Gb ports (bonded), Data/Replication on (2) 1Gb ports (bonded) - Template 4 5) Management/Data/Replication on (2) 1Gb ports (bonded) - Template 5 quit) quit without configuring the networ
(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): ==================================================================== Template #2 - Management/Data/Replication on (4) 1Gb ports (bonded) Do you want to configure a combined 1GbE management and data network? [Y/(N)]: Select bonding mode for 1GbE management and data bond enter 1 (Active/Backup), 4 (IEEE 802.
4 (IEEE 802.3ad Dynamic Link Aggregation), or 6 (Active Load Balancing), (default = 1): 1 Enter 1GbE management network start IP address (must be IPv4 X.X.X.X): Enter 1GbE management network end IP address (must be IPv4 X.X.X.X): Enter 1GbE management subnet mask (must be IPv4 X.X.X.X): Select bonding mode for 1GbE data bond enter 1 (Active/Backup), 4 (IEEE 802.3ad Dynamic Link Aggregation), or 6 (Active Load Balancing), (default = 1): 1 Enter 1GbE data network start IP address (must be IPv4 X.X.X.
Enter Selection: 2 Enter up to 2 ntp server names or ip addresses (space separated): 12.10.191.251 Cannot get time for NTP server 12.10.191.251 Both selections lead onto this… Do you want to set your timezone [y/N]? y Please identify a location so that time zone rules can be set correctly. Please select a continent or ocean. 1) Africa 4) Arctic Ocean 7) Australia 10) Pacific Ocean 2) Americas 5) Asia 8) Europe 11) Exit 3) Antarctica 6) Atlantic Ocean 9) Indian Ocean #? 8 Please select a country.
License(s): -----------No licenses installed MENU Item 4 The following configuration steps will be performed: Configure Network Configure Time Configure Licenses -> Verify Hardware health Configure Failover Finish Configuration and reboot Finish Configuration Actions: execute) Perform the current step (Default) skip) Skip to the next step back) Go back to a previous step quit) Exit the configuration immediately Verify Hardware health [execute]? #############################################################
Verify Hardware health Configure Failover -> Finish Configuration and reboot Finish Configuration Actions: execute) 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 and reboot [execute]? MENU Item 7 The following configuration steps will be performed: Configure Network Configure Time Configure Licenses Verify Hardware health Configure Failover Finish Configuration and reboot -> Finish Configuration A
system set description Description of Command 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 Not applicable – no objects exist within this command.
system set pagecontrol Description of Command Function Enables or disable the page control feature. Command Syntax system set pagecontrol {on|off} Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements on/off – This required parameter defines the state of page control. “On” means the page control feature is enabled, and “off” means the page control feature is disabled.
system show config 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 Not applicable – no parameters exist within this command. Requirements for Command Execution The command entry must conform to the command syntax.
system show packages Description of 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 – no objects exist within this command. Command Parameter Requirements Not applicable – no parameters exist within this command.
system show repository Description of Command Function Displays the packages which have been transferred into the repository. Command Syntax system show repository 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. Requirements for Command Execution The command entry must conform to the command syntax.
system show status Description of Command Function Provides status on the StoreOnce appliance system. Command Syntax system show status 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. Requirements for Command Execution The command entry must conform to the command syntax.
------------ ------ ----Set 1 Running # system show status Storage Set ----------------Service Sets 3, 4 Service Sets 7, 8 Service Sets 1, 2 Service Sets 5, 6 Service Sets -----------Set 1 Set 2 Set 3 Set 4 Set 5 Set 6 Set 7 Set 8 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.
system shutdown 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 exist within this command. Requirements for Command Execution The command entry must conform to the command syntax.
system update packages Description of Command Function Updates the system with the packages existing in the update queue or optionally defined in the command entry. Parameters in this command will force the update process to be performed for packages the system already believes exist. Command Syntax system update packages [force] Command Authority Administrator Command Object Requirements Not applicable – no parameters exist within this command.
time add ntpserver Description of Command Function Adds a network time protocol server to use if ntp is enabled. Up to two ntp servers may be defined for the StoreOnce appliance. Command Syntax time add ntpserver {|} [{|}] Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements ntp server ID – At least one ntp server ID must appear in the command entry.
ntp server(s) added successfully time add ntpserver 131
time del ntpserver Description of Command Function Removes an ntp server which exists for the StoreOnce appliance. Command Syntax time del ntpserver {|} Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements ntp server ID – At least one ntp server ID must appear in the command entry.
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 – no objects exist within this command. Command Parameter Requirements Not applicable – no parameters exist within this command. Requirements for Command Execution The command entry must conform to the command syntax.
time set timezone Description of Command Function Sets the time zone for the StoreOnce appliance. Command Syntax time set timezone Command Authority Administrator Command Object 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 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.
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. Command Syntax time set UTC Command Authority Administrator Command Object Requirements Not applicable – no objects exist within this command. Command Parameter Requirements date time – This parameter must appear in the command entry after time set UTC.
time show config Description of Command Function Displays the time configuration and the StoreOnce appliances UTC and local times. Command Syntax time show config 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. Requirements for Command Execution The command entry must conform to the command syntax.
vtl create cartridge Description of Command Function Adds a cartridge to an existing virtual tape library. Command Syntax vtl create cartridge [SETX ] LIBX {ALL|slot |mail } [WriteProtect {yes|no}] [barcode ] [CartSize {10|25|50|100|200|400|800|1000|1200|1400|1600|3200}] Command Authority Administrator Command Object Requirements • SETX – This object defines the service set containing the virtual tape library into which the cartridge will be added.
Requirements for Command Execution • The command entry must conform to the command syntax. • All object values must be valid; see the object descriptions for details. • All parameter values must be valid; see the parameter descriptions for details. Successful Command Output Upon successful completion of the command, the following is displayed: Command Successful Command Operation during Abnormal Conditions If any of the command execution requirements fail, command execution terminates.
vtl create library Description of Command Function Creates a virtual tape library. In addition, a virtual tape cartridge is created in every slot in the virtual library.
• DriveEmulation – This optional parameter defines the type of physical drive the virtual tape drive will emulate. The values are defined in the Command Syntax. If the parameter is not defined, the default value corresponds to the default drive type defined by the library’s emulation type. • NoOfSlots – This optional parameter defines the number of cartridge slots in the virtual library created by this command. The number of slots must conform to the library emulation type.
• BarcodeLength – This optional parameter defines the total number of characters in the barcode used by the cartridges in the virtual tape library created by this command. The value is either 6 or 8. If not included, a default value of 8 is used. Requirements for Command Execution • The command entry must conform to the command syntax. • All object values must be valid; see the object descriptions for details. • All parameter values must be valid; see the parameter descriptions for details.
• ◦ Command Failed - The number of drives must be between 0 and 192 ◦ Command Failed – Drive fibre channel port defined for interface ◦ Command Failed – Library fibre channel port defined for interface ◦ Command Failed – iSCSI parameters defined for interface ◦ Command Failed – Initiator log on enabled, CHAPS parameters required ◦ Command Failed – Target log on enabled, CHAPS parameters required ◦ Command Failed – Worldwide port names defined for
vtl delete cartridge Description of Command Function Deletes a single cartridge or all cartridges from a virtual tape library. Command Syntax vtl delete 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 service set.
Command Operation during Abnormal Conditions • • If any of the command execution requirements fail, command execution terminates.
vtl delete library Description of Command Function Deletes a virtual tape library. Command Syntax vtl delete library SETX LIBX Command Authority Administrator Command Object Requirements • SETX – This required object defines the service set containing the virtual tape library that will be deleted. X is the numeric index of the service set. • LIBX – This required object is the virtual tape library that will be deleted. X is the numeric index of the library.
Command Successful vtl delete library 147
vtl modify cartridge Description of Command Function Modifies the parameters of an existing cartridge. Command Syntax vtl modify cartridge [SETX] LIBX [{CARTX|ALL}] [slot ] [WriteProtect {yes|no}] [barcode ] [CartSize {10|25|50|100|200|400|800|1000|1200|1400|1600|3200}] Command Authority Administrator Command Object Requirements • SETX – This required object defines the service set containing the virtual tape library that contains the cartridge to be modified.
Command Operation during Abnormal Conditions If any of the command execution requirements fail, command execution terminates.
vtl modify drive Description of Command Function Modifies a drive which already exists within a library. Command Syntax vtl modify drive SETX LIBX DRVX [Drive Emulation {LTO2|LTO3|LTO4|LTO5|UltriumVT}] [DrivePort ] [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.
Command Successful Command Operation during Abnormal Conditions If any of the command execution requirements fail, command execution terminates.
vtl modify library Description of Command Function Modifies an existing library.
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 physical drive the virtual tape drive will emulate. The values are defined in the Command Syntax. If not defined, the current value remains unchanged.
• tAuthenticationEnable – single-node only. This optional parameter determines if the CHAP (challenge handshake authentication protocol) target log on is enabled. The value for this parameter is either yes or no. If not defined, the current value remains unchanged. • tUserName – single-node only. This optional parameter defines the target user name for the CHAP (challenge handshake authentication protocol) and is only valid if the interface is iSCSI.
• 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 invalid • Command Failed – The library emulation is invalid • Command Failed – The drive emulation is invalid • Command Failed – The drive port is invalid •
vtl move cartridge Description of Command Function Moves a cartridge within a virtual tape library. Command Syntax vtl move cartridge SETX LIBX [CARTX] [from {drive |mail |slot }] [barcode ] 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.
• ◦ 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 does not exist in the library ◦ Command Failed – The slot does not exist in the library ◦ Command Failed – The drive does not exist in the library ◦ Command Failed – The mail slot does not contain a cartridge ◦ Command Failed – The slot does not contain a cartridge
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] Command Authority Operator and Administrator Command Object Requirements • SETX – This object defines the service set to be described. X is the numeric index of the service set.
SET1 LIB1 LIB2 Lib3 4 TB 5 TB 1 TB 20 TB 75 TB 5 TB 5:1 15:1 5:1 User Data --------20 TB Dedupe Ratio -----------5:1 Command Successful # vtl show capacity SET1 LIB1 Object -----LIB1 Space Used ---------4 TB Command Successful vtl show capacity 159
vtl show cartridges Description of Command Function Displays information about the cartridges in a given library. Command Syntax vtl show cartridges SETX LIBX Command Authority Operator and Administrator Command Object Requirements • SETX – This required object defines the service set containing the virtual library to be described. X is the numeric index of the service set. If not defined, the capacity information is provided at the cluster level.
Library : LIB1 Name: Gregslib Object Location Slot ------------- ---CART1 1 CART2 2 CART3 Drive2 CART4 Barcode ------ABC001 ABC002 Max Size -------800 GB 800 GB User Data --------745 GB 712 GB Protected --------yes yes Mapped -----no no 3 ABC003 800 GB 799 GB yes no 4 ABC004 800 GB 785 GB yes no Command Successful vtl show cartridges 161
vtl show drive info Description of Command Function Displays information about a given virtual drive or all the virtual drives in a given library. Command Syntax vtl show drive info SETX LIBX [DRVX] Command Authority Operator and Administrator Command Object Requirements • SETX – This required object defines the service 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.
Command Successful # vtl show drive info SET1 LIB2 DRV1 Drive Object Library Library Name Emulation Type Protocol Serial Number WWNN iSCSI Target Name iSCSI Target Alias : : : : : : : : : DRV1 LIB1 GregsNextlib LTO4 iSCSI CR2058t021 500143874B5B68A0 ign-1986-03.com.hp.storage.d2dbs.cr206f12e.500143874b5b68a0.library2.drive1 D2DBS.CR206F1F2E.library2.
vtl show drive list Description of Command Function Lists the drives in a library. Command Syntax vtl show drive [SETX] [LIBX] Command 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 listed.
# vtl show drive list SET1 Object -----DRV1 DRV2 DRV1 DRV2 Type ---LTO4 LTO4 LTO4 LTO4 Service Set ----------SET1 SET1 SET1 SET1 Library ------LIB1 LIB1 LIB2 LIB2 Name ---Gregslib Gregslib GregsNextlib GregsNextlib Command Successful # vtl show drive list SET1 LIB1 Object -----DRV1 DRV2 Type ---LTO4 LTO4 Service Set ----------SET1 SET1 Library ------LIB1 LIB1 Name ---Gregslib Gregslib Command Successful vtl show drive list 165
vtl show library info Description of Command Function Displays library configuration information. The number of library configurations displayed depends on if a service set and specific library object is defined in the command sequence. Command Syntax vtl show library info [SETX] [LIBX] Command Authority 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.
FC Address WWPN Port FC Address WWPN : : : : : 0x971623 5001438011A18945 2 0x971623 5001438011A18946 No. of Drives : 1 No.
Object : LIB1 Name : Robslib >>>>Additonal Information<<<< Object : LIB2 Name : RobsNextlib >>>>Additonal Information<<<< Command Successful 168 Alphabetical List of Commands and Details
vtl show library iscsi authentication NOTE: This command applies to single-node products only. Description of Command Function Displays information on a library’s CHAP (challenge handshake authentication protocol) configuration. Command Syntax vtl show library iscsi authentication SETX LIBX Command Authority Administrator Command Object Requirements • SETX – This required object defines the service set containing the library whose CHAP information will be displayed.
vtl show library list Description of Command Function Lists the libraries in a cluster. Command Syntax vtl show library list [SETX] Command Authority 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 applicable – no parameters exist within this command.
vtl show ports Description of Command Function Provides information on the Fibre Channel ports which can be used during the creation of a virtual tape library. This is identical to the hardware show ports command but is included to allow the user to obtain this information (required when configuring libraries) without leaving the vtl command group. Command Syntax vtl show ports Command Authority Operator and Administrator Command Object Requirements Not applicable – no objects exist within this command.
VTL Port Number ---------1 not used 2 not used Physical Slot ---HBA1 HBA1 HBA2 HBA2 Location Port ----Port1 Port2 Port1 Port2 Configuration Speed Connection -------------4 Gbs Fabric 4 Gbs Fabric 4 Gbs Fabric 4 Gbs Fabric Null VTL Port Number ---------0 Indicates no port is assigned to vtl Command Successful 172 Alphabetical List of Commands and Details
5 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
Table 4 Document conventions (continued) Convention Element Bold text • Keys that are pressed • Text typed into a GUI element, such as a box • GUI elements that are clicked or selected, such as menu and list items, buttons, tabs, and check boxes Italic text Text emphasis Monospace text • File and directory names • System output • Code • Commands, their arguments, and argument values Monospace, italic text • Code variables • Command variables Monospace, bold text WARNING! CAUTION: IMPORTANT: NOTE:
Glossary C CLI Command-line interface. An interface comprised of various commands which are used to control operating system responses.
W white space any combination of spaces, tabs and carriage returns word an element whose characters having meaning in the natural language of the user.
Index A H accessing the CLI, 6 accounts add, 13 del, 15 modify, 16 show, 17 alerts show, 18 alphabetical list of commands, 13 hardware add storage, 25 beacon, 26 delete storage, 27 disable failover, 29 discover storage, 30 enable failover, 31 failback, 32 failover, 33 poweroff, 34 powerup, 36 prepare storage, 37 reboot, 38 set ports, 39 show net status, 40 show node status, 42 show problems, 43 show status, 44 show storage status, 47 help, 48 obtaining, 173 viewing, 7 HP technical support, 173 C categor
repository directory, 7 typographic conventions, 173 S V scripting, 7 serviceset show status, 81 start, 82 stop, 83 snmp add trapsink , 84 add user , 87 del trapsink , 89 del user , 90 disable, 91 enable, 92 modify trapsink , 93 modify user , 95 reset ro-community, 97 set contact, 98 set location, 99 set ro-community, 100 show config, 101 show user , 103 support create ticket, 104 del ticket, 105 show ticket, 106 symbols in text, 174 syntax for commands, 8 system clear packages, 107 clear repository, 10