StoreOnce CLI Reference Guide

Transcription

1 StoreOnce CLI Reference Guide For software version 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 System appliance or to control appliance activity. It is intended for system administrators managing a StoreOnce System. IMPORTANT: This guide may have more recent updates. Always check for the most current documentation for your product. Part Number: BB Published: April 2016 Edition: 12

2 Copyright 2011, 2016 Hewlett Packard Enterprise Development LP The information contained herein is subject to change without notice. The only warranties for Hewlett Packard Enterprise 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. Hewlett Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein. Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use, or copying. Consistent with FAR and , 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. Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise website. Acknowledgments Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. UNIX is a registered trademark of The Open Group. Revision History Revision 1 October 2012 For StoreOnce 2700, 4500, 4700, and 4900 only. Initial release on product CD. Revision 2 December 2012 For StoreOnce 2700, 4500, 4700, and 4900 only. Minor text updates for release to the HP website. Part number: BB Revision 4 October 2012 For StoreOnce 6500 and B6200 only. Part number: EJ Revision 5 June 2013 Combined version for StoreOnce 2700, 4500, 4700, and 4900 with version for HP StoreOnce 6500 and B6200. Part number: BB Revision 6 September 2013 Added commands for software release. Part number: BB Revision 7 December 2013 Added commands for software release. Part number: BB Revision 8 June 2014 Added commands for software release. Part number: BB Revision 9 September 2014 Added commands for software release. Part number: BB Revision 10 March 2015 Added commands for software release. Part number: BB Revision 11 September 2015 Added and updated commands for software release. Part number: BB Revision 12 March 2016 Added and updated commands for software release. Part number: BB

3 Contents 1 Using the CLI...7 Introduction...7 Accessing the CLI...7 Command Entry...7 Viewing Help...9 Transferring Files...9 Scripting Command Instruction Syntax...10 Global Defaults Categorical List of Commands Alphabetical List of Commands and Details...17 accounts add...17 accounts del...19 accounts modify...20 accounts show...21 alerts show...22 cifs add localadmin...23 cifs add user...24 cifs delete localadmin...25 cifs delete user...26 cifs disable domainjoin...27 cifs disable user...28 cifs enable domainjoin...29 cifs enable user...30 cifs modify config...31 cifs modify user...32 cifs show config...33 cifs show localadmin...34 config delete...35 config restore devices...36 config restore keystore...37 config save devices...38 config save keystore...39 config show list...40 exit...41 hardware add storage...42 hardware beacon...43 hardware delete storage...44 hardware delete storage (legacy systems)...45 hardware disable failover...46 hardware discover storage...47 hardware enable failover...48 hardware failback...48 hardware failover...48 hardware poweroff...49 hardware powerup...51 hardware prepare storage...52 hardware reboot...53 hardware set ports...54 hardware show firmware...55 hardware show net status...56 Contents 3

4 hardware show node status...58 hardware show problems...59 hardware show status...60 hardware show storage status...61 hardware update firmware...62 help...64 keymanager create...65 keymanager import...66 keymanager mode external...67 keymanager mode local...68 keymanager mode show...69 keymanager update...70 license add...71 license hardware activate...73 license hardware show...75 license load...76 license refresh...77 license show all...78 license show summary...79 logs export events...80 logs show events...81 logs show update...82 nas create share...84 nas delete share...86 nas modify share...87 nas show share...88 net activate config...90 net activate status...91 net add encryption...92 net add ipaddr...93 net add portset...94 net add route...95 net add subnet...96 net copy config...98 net create config...99 net create portset net delete config net delete encryption net delete ipaddr net delete portset net delete route net delete subnet net modify config net modify portset net modify subnet net ping net set address net set wizard net show config net show ipaddr net show ports net show portset net show status net validate config nfs add host Contents

5 nfs delete host nfs disable browsing nfs disable host nfs enable browsing nfs enable host nfs modify host nfs show config serviceset show status serviceset start serviceset stop snmp add trapsink snmp add user snmp del trapsink snmp del user snmp disable snmp enable snmp modify trapsink snmp modify user snmp reset ro-community snmp send testtrap snmp set contact snmp set location snmp set ro-community snmp show config snmp show user support create ticket support del ticket support show ticket system clear packages system clear repository system confidencechecker system disable failover system disable remoteeventsuppression system enable failover system enable remoteeventsuppression system failback system failover system load packages system move afm system reboot system restart remotesupport system scan devices system set clioutput system set clusterid system set config system set description system set pagecontrol system set timeout system set warrantyserial system show config system show packages system show performance system show remoteeventsuppression system show repository system show status Contents 5

6 system show warrantyserial system shutdown system update packages time add ntpserver time del ntpserver time reset timezone time set timezone time set UTC time show config vtl create cartridge vtl create library vtl delete cartridge vtl delete cartridges vtl delete library vtl erase cartridge vtl erase cartridges vtl modify cartridge vtl modify drive vtl modify library vtl move cartridge vtl show capacity vtl show cartridges vtl show drive info vtl show drive list vtl show library info vtl show library list vtl show ports Support and other resources Accessing Hewlett Packard Enterprise Support Accessing updates Websites Customer self repair Remote support Documentation feedback Glossary Index Contents

7 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 it can be used with the entire StoreOnce portfolio of products. The CLI software embedded in the appliance enables you to manage and monitor storage-system operation. The commonality of the CLI command set means that some unsupported commands (that are not applicable to your appliance) are present in the CLI inline help. Any unsupported commands that are executed return the failure message: Command Failed - This command is not supported on this system. Control the StoreOnce appliance by entering a command using a specific syntax. The operation defined by the command is executed, and any output associated with the operation is displayed in text or XML output (depending on the configuration settings). After the operation is complete, the command prompt is displayed to allow entry of the next command. Commands are grouped by function. For example, all commands related the network configuration are in one group and begin with net. This grouping makes it easy to locate the correct command for a given operation. See Categorical List of Commands (page 12) for details. Accessing the CLI Access the CLI from an SSH terminal using an SSH client application (freely available on the internet). The CLI runs on the management console: ssh <username>@<appliance IP address> The Common CLI command set supports two authorization levels that permit execution of different commands. Each authorization level has a unique command prompt. The accounts in Table 1 (page 7) are created at the time of the StoreOnce system installation, and the can create additional users at any time. Table 1 Login Information Authorization Level Can Execute Commands That User Name Default Password Command Prompt Operator Provide information about the state and configuration of the StoreOnce appliance. Operator operator > Same as Operator, plus commands that configure or change the configuration of the StoreOnce appliance. Admin admin # 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 Enter directs the Common CLI to interpret the instruction entry and perform the defined operation. After the operation is completed, the command prompt is displayed, and another instruction may be entered. Introduction 7

8 Useful information: Before pressing Enter, the text after the command prompt can be edited by pressing Delete or Backspace and using the right and left arrow keys. Use the up and down arrow keys to scroll through previously entered commands; you can then edit and enter previous commands. This capability speeds the entry after entering multiple instances of similar commands. A short form exists for each command. The short form comprises at least the first three characters of each command and be unique from other short form commands. For example, for system show repository, shorten the command by entering sys sho repo at the CLI prompt. Display help on different levels of each command. For example, entering help (or h) at cifs # lists all of the secondary options available (add, delete, disable, etc.). Entering help at cifs add # lists user and localadmin. See the examples below. At cifs #: cifs # h Global Commands help - List commands or get help for a specific command. home - Go to the root level. exit - Log out up - Go up one level Paths currently available add - add user to CIFS server delete - delete user from CIFS server enable - enable CIFS user or join Active Directory domain disable - disable CIFS user or leave Active Directory domain modify - modify CIFS user or CIFS server configuration show - show CIFS server configuration or local administrators Commands currently available cifs# At cifs add#: cifs add # h Global Commands help - List commands or get help for a specific command. home - Go to the root level. exit - Log out up - Go up one level Paths currently available Commands currently available user - add user to CIFS server localadmin - add user to CIFS server BUILTIN\s group 8 Using the CLI

9 IMPORTANT: The command entry must conform to the command syntax, and all objects and parameters must contain valid values. The command will fail if there are any misspellings, invalid values, references to objects that do not currently exist, etc. If the command fails, an error message is displayed indicating the problem. s of error messages (depending on the command): Command Failed - the command does not conform to the required syntax of [SYNTAX], where [SYNTAX] is the syntax described in the section. Command Failed - Service set ID (SETX) not specified Command Failed - Parameter X requires argument Command Failed - The node is invalid Command Failed The library <LIBX> does not exist Command Failed The system hardware does not match the configuration file (difference in number of nodes) Viewing Help To view brief descriptions of all global commands and commands that are available to the current user level, enter: help Additionally, include a command or command group after help to see help specific to that command or command group. For further assistance in using the Common CLI, the following help features exist: If you enter a correct command but use incorrect syntax, information on the correct syntax is displayed. If you enter an invalid command, information on valid permutations of the command elements are displayed. Transferring Files Scripting Transfer of files to and from the StoreOnce appliance is managed with a repository directory within the appliance. Access to the directory is controlled through secure FTP. Scripting is performed using Expect, a UNIX automation and testing tool. To aid in parsing, the Common CLI can be configured to return XML formatted output (see system set clioutput (page 173)). You can also use the StoreOnce REST API to extract reporting information from and to execute commands on StoreOnce appliances. See the StoreOnce REST API and SDK user guide for details. Viewing Help 9

10 2 Command Instruction Syntax A StoreOnce appliance is controlled by operations. An operation: Provides configuration information to the appliance Requests an action Obtains information about the appliance The command sequence up to four command elements representing groups of related operations, actions, or subjects of the action. A command sequence is unique and a defined syntax for every command sequence exists. The command sequence must be present in all entries to define the desired operation. A typical command sequence consists of a command element defining the group of related operations to which the given sequence belongs (for example, net). This element is followed by a command element describing the action of the operation (for example, show). Then, depending on the operation, a third and possibly fourth element may be included to describe the subject of the action (for example, config). In some cases, the command sequence may consist of only one command element describing the action of the operation. Objects represent an item associated with a StoreOnce appliance. It may be a physical item, such as a network interface, or a virtual item, such as a virtual tape cartridge. Not all instructions contain objects, but up to three are possible. Parameters define additional conditions placed on the operation. A parameter consists of a word (or a series of words separated by dashes) followed by a colon; the characters after the colon define the value of the parameter. Not all instructions contain parameters. NOTE: Command entries are not case sensitive; command words, objects, and parameters may be entered in either uppercase or lowercase. After the command sequence is established, the entry is verified for correct syntax. If the entry is correct, the operation is performed as defined. If a syntax violation exists, the help function is performed to aid you in determining the correct entry. Table 2 Command Entry Syntax Common Conventions Character Convention square parenthesis carat parenthesis special parenthesis parenthesis parenthesis enclosing the phrase default=value s [object] or [parameter] <object> or <parameter> {object1 object2 object3} or {value1 value2} (object) (default=value) Explanation The object or parameter entry is optional. User entry is required to define the object or parameter. A selection of one item is required among the items separated by the character. A label for the object is automatically generated by the Common CLI application. No entry is required for this item. If no value is provided for this parameter, the value within the parenthesis is used. Global Defaults Global defaults exist to clearly represent groups of objects or specific objects. Unlike the existence of most objects which depend on the StoreOnce appliance or user requirements, global defaults 10 Command Instruction Syntax

11 are directly related to the Common CLI and can be used in command entries on any implementation of the Common interface. Default ALL Represents All objects related to a given command sequence. (Often, the absence of object elements implies all objects. The all default is used to ensure intent. For example, the command entry system disable failover does not include a definition of a node object. Therefore, the operation is performed on all nodes. In contrast, the command entry support del ticket all must include the global default all to delete all the support tickets. Because the user cannot reverse the results of deleting all the support tickets, the global default all must be included to ensure the user s intent). CLI (StoreOnce 6500 and B6200 Systems) The Common CLI interface. (To support high availability, the instance of the Common CLI can exist on any node, a VIF is used to define the location and, by default, the Common CLI object. Before the VIF assignment, this global default is used to represent the Common CLI.) CURRENT DEFAULT The object currently active. Default settings as defined by Hewlett Packard Enterprise. GUI (StoreOnce 6500 and B6200 Systems) The GUI associated with the StoreOnce appliance supported by the Common CLI. (To support high availability, the GUI instance can exist on any node. A VIF is used to define the location and, by default, the Common CLI object. Before VIF assignment, this global default is used to represent the GUI.) Global Defaults 11

12 3 Categorical List of Commands Table 3 Commands by Category Command Group accounts alerts cifs config exit hardware Commands accounts add (page 17) accounts del (page 19) accounts modify (page 20) accounts show (page 21) alerts show (page 22) cifs add localadmin (page 23) cifs add user (page 24) cifs delete localadmin (page 25) cifs delete user (page 26) cifs disable domainjoin (page 27) cifs disable user (page 28) cifs enable domainjoin (page 29) cifs enable user (page 30) cifs modify config (page 31) cifs modify user (page 32) cifs show config (page 33) cifs show localadmin (page 34) config delete (page 35) config restore devices (page 36) config restore keystore (page 37) config save devices (page 38) config save keystore (page 39) config show list (page 40) exit (page 41) hardware add storage (page 42) hardware beacon (page 43) hardware delete storage (page 44) hardware delete storage (legacy systems) (page 45) hardware disable failover (page 46) hardware discover storage (page 47) hardware enable failover (page 48) hardware failback (page 48) hardware failover (page 48) hardware poweroff (page 49) hardware powerup (page 51) hardware prepare storage (page 52) hardware reboot (page 53) hardware set ports (page 54) hardware show firmware (page 55) hardware show net status (page 56) hardware show node status (page 58) 12 Categorical List of Commands

13 Table 3 Commands by Category (continued) Command Group Commands hardware show problems (page 59) hardware show status (page 60) hardware show storage status (page 61) hardware update firmware (page 62) help (see Viewing Help (page 9)) keymanager license logs nas net help (page 64) keymanager create (page 65) keymanager import (page 66) keymanager mode external (page 67) keymanager mode local (page 68) keymanager mode show (page 69) keymanager update (page 70) license add (page 71) license hardware activate (page 73) license hardware show (page 75) license load (page 76) license refresh (page 77) license show all (page 78) license show summary (page 79) logs export events (page 80) logs show events (page 81) logs show update (page 82) nas create share (page 84) nas delete share (page 86) nas modify share (page 87) nas show share (page 88) net activate config (page 90) net activate status (page 91) net add encryption (page 92) net add ipaddr (page 93) net add portset (page 94) net add route (page 95) net add subnet (page 96) net copy config (page 98) net create config (page 99) net delete config (page 102) net delete encryption (page 103) net delete ipaddr (page 104) net delete portset (page 105) net delete subnet (page 107) net modify config (page 108) net modify portset (page 109) 13

14 Table 3 Commands by Category (continued) Command Group Commands net modify subnet (page 110) net ping (page 112) net set wizard (page 115) net show config (page 119) net show ipaddr (page 121) net show ports (page 122) net show portset (page 123) net show status (page 124) net validate config (page 126) nfs serviceset snmp support system nfs add host (page 127) nfs delete host (page 128) nfs disable browsing (page 129) nfs disable host (page 130) nfs enable browsing (page 131) nfs enable host (page 132) nfs modify host (page 133) nfs show config (page 134) serviceset show status (page 135) serviceset start (page 136) serviceset stop (page 137) snmp add trapsink (page 138) snmp add user (page 140) snmp del trapsink (page 141) snmp del user (page 142) snmp disable (page 143) snmp enable (page 144) snmp modify trapsink (page 145) snmp modify user (page 147) snmp reset ro-community (page 148) snmp send testtrap (page 149) snmp set contact (page 150) snmp set location (page 151) snmp set ro-community (page 152) snmp show config (page 153) snmp show user (page 154) support create ticket (page 155) support del ticket (page 156) support show ticket (page 157) system clear packages (page 158) system clear repository (page 159) system confidencechecker (page 160) system disable failover (page 162) system disable remoteeventsuppression (page 163) 14 Categorical List of Commands

15 Table 3 Commands by Category (continued) Command Group Commands system enable failover (page 164) system enable remoteeventsuppression (page 165) system failback (page 166) system failover (page 167) system load packages (page 168) system move afm (page 169) system reboot (page 170) system restart remotesupport (page 171) system scan devices (page 172) system set clioutput (page 173) system set clusterid (page 174) system set config (page 175) system set description (page 178) system set pagecontrol (page 179) system set warrantyserial (page 181) system show config (page 182) system show packages (page 183) system show performance (page 184) system show remoteeventsuppression (page 186) system show repository (page 187) system show status (page 188) system show warrantyserial (page 190) system shutdown (page 191) system update packages (page 192) time vtl time add ntpserver (page 194) time del ntpserver (page 195) time reset timezone (page 196) time set timezone (page 197) time set UTC (page 198) time show config (page 199) vtl create cartridge (page 200) vtl create library (page 202) vtl delete cartridge (page 206) vtl delete cartridges (page 207) vtl delete library (page 208) vtl erase cartridge (page 209) vtl erase cartridges (page 210) vtl modify cartridge (page 211) vtl modify drive (page 213) vtl modify library (page 215) vtl move cartridge (page 219) vtl show capacity (page 220) vtl show cartridges (page 221) vtl show drive info (page 222) 15

16 Table 3 Commands by Category (continued) Command Group Commands vtl show drive list (page 224) vtl show library info (page 225) vtl show library list (page 227) vtl show ports (page 228) 16 Categorical List of Commands

17 4 Alphabetical List of Commands and Details accounts add Creates an account that provides access to the StoreOnce appliance using the CLI or GUI. NOTE: A default account exists with administrator authority level and has the user name, Admin, and the password, admin. You cannot delete that account, but you can and should modify its password. Also note that after the Admin account password is changed, its password cannot be changed back to admin as this password is not sufficiently complex. The only way to revert that password back to admin is through the HPresetpassword account which is only available on the local console of the device. accounts add <ACCOUNT> type {local externaluser externalgroup} level {admin user} newpassword <password> <password> ACCOUNT This required object is the username of the account to be created. It must conform to the following rules: Local accounts can have usernames between 1 and 16 characters in length and contain only alpha-numeric characters and the underscore (_) special character. External names (e.g., Active Directory account names or group names) may be up to 256 characters in length and contain alpha-numeric characters and the following symbols: ~, `!, #, $, %, (, ), _-, {, }, and \ type This required parameter defines the type of account to be created: local (default) Indicates that a local user (default) is being created on the StoreOnce appliance. externaluser Indicates that an external user (i.e., a Microsoft Active Directory user or an Active Directory group) is being granted login permissions on the device. externalgroup Indicates all users of an external group (i.e., a Microsoft Active Directory user group) are being granted login permissions on the device. If type is not defined, then it defaults to local. level This required parameter defines the account authorization level and is one of the following: admin (administrator) authority level user (operator) User authority level newpassword This required parameter defines a password for the added account. The text password must be followed by a string which may contain upper case letters, lower case letters, numbers, and the #, $, %, ^, &, and *. The password string can be a maximum of 24 characters long. Two identical entries of the password string separated by a space must be entered. To access the account, the user must enter the exact string accounts add 17

18 and defined by this parameter (i.e., the password is case sensitive). This parameter is valid only for users of type local; authentication of external accounts is managed by an authentication service, such as Active Directory. NOTE: Some passwords cannot be created and are rejected if they are based on common words or known, insecure key patterns. Be sure to use valid passwords without using common words or invalid patterns. Upon successful completion of the command, the following is displayed: account ACCOUNT added, where ACCOUNT is the string label of the new account. # accounts add Joe_Operator level user newpassword F00tB*ll F00tB*ll account Joe_Operator added 18 Alphabetical List of Commands and Details

19 accounts del Deletes an existing account. The account specified cannot be the only account with admin authorization levels. accounts del <ACCOUNT> ACCOUNT This required object is a string matching the label of an existing account. The default account, Admin, cannot be deleted. Not applicable no parameters exist within this command. Upon successful completion of the command, the following is displayed: account ACCOUNT deleted, where ACCOUNT is the string label of the deleted account. # accounts del Joe_Operator account Joe_Operator deleted accounts del 19

20 accounts modify Modifies an existing account. NOTE: A user with user permission may only change their own password. A user with admin permissions may change the password or level of any user or group. All nodes in StoreOnce 6500 and B6200 Systems must be powered on and accessible within the cluster network. accounts modify [ACCOUNT] [newpassword <password> <password>] [level {admin user}] Operator and ACCOUNT This object is the name of an existing account. newpassword This parameter defines the new password for the account. The text password must be followed by a string which may contain upper case letters, lower case letters, numbers, and the #, $, %, ^, &, and *. The password string can be a maximum of 24 characters long. Two identical entries of the password string separated by a space must be entered. This parameter is valid only for users of type local; authentication of external accounts is managed by an authentication service, such as Active Directory. For StoreOnce 6500 and B6200 Systems, all nodes within the cluster must be powered on, operational, and accessible within the cluster network. NOTE: Some passwords cannot be created and are rejected if they are based on common words or known, insecure key patterns. Be sure to use valid passwords without using common words or invalid patterns. level This parameter may be modified to change the access level for the specified account. Access level may only be modified by a user with administrator privileges. Access levels can be changed for local users and external users, or groups. Upon successful completion of the command, the following is displayed: account ACCOUNT modified, where ACCOUNT is the string labeling the account to be modified. 1 Modifying the password of an account: # accounts modify Joe_Operator newpassword F00tB*ll F00tB*ll account Joe_Operator modified 2 Modifying the password of the currently active account: # accounts modify newpassword F00tB*ll F00tB*ll account (current account name) modified 20 Alphabetical List of Commands and Details

21 accounts show Lists all the user accounts and their authority level defined for the StoreOnce appliance. NOTE: A user with admin permissions sees all accounts on the system, but a user with user permissions sees only their account. accounts show [CURRENT] Operator and CURRENT This is optional parameter returns details on only the currently logged in user s account. If the user is logged in as an Operator level user, details about that user s own account is displayed. NOTE: If level users do not use CURRENT as part of the command syntax, all accounts associated with this device are displayed. Not applicable no parameters exist within this command. Upon successful completion of the command, the following is displayed for each account: User name Type local user, external user, or external group Authority level admin or operator (user) # accounts show User Name Type Authority Admin Local User admin Joe_Admin Local User admin Joe_Operator Local User user Operator Local User user # accounts show current User Name Type Authority Admin Local User admin accounts show 21

22 alerts show 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 81). alerts show [verbose] [numofevents <number>] Operator, Not applicable no objects exist within this command. verbose When this parameter is included in the command entry, a detailed output is provided. numofevents When this parameter is used, an integer must follow numofevents. This parameter indicates the maximum number of events which are listed in the output, starting with the most recent events. Upon successful completion of the command, a list of the most recent events up to 20 events is displayed starting with the most recent event. The output includes the event time, level, and description. If verbose is included, a detailed list of information for each event is output. If numofevents is included, the maximum number of events displayed is defined by the integer provided with this parameter. The list of events starts with the most recent event. # alerts show SEQUENCE ID TIMESTAMP LEVEL EVENT TYPE EVENT CODE TEXT May 18 11:26:14 ALERT System E Warning! - failover is disabled on this cluster, please go to Maintenance page to enable failover. 875 May 17 09:26:48 ALERT System E011D0000 Failed login attempt for user username from host (CLI). 851 May 16 11:26:14 ALERT System E Warning! - failover is disabled on this cluster, please go to Maintenance page to enable failover. 775 May 15 14:19:29 ALERT System E011D0000 Failed login attempt for user Admin from host (GUI). 773 May 15 14:18:42 ALERT System E011D0000 Failed login attempt for user Admin from host (GUI). 750 May 15 13:30:32 ALERT System E010A0025 File system ifs1 not mounted on hpb3cce3861a May 15 13:30:32 ALERT System E010A0025 File system ifs1 not mounted on hpb3cce3861a May 15 11:26:14 ALERT System E Warning! - failover is disabled on this cluster, please go to Maintenance page to enable failover. 698 May 15 11:16:43 ALERT System E071D001C component:managementprocessor, status:degraded, location:managementprocessor in IOmodule S/N:CN8231M078 in Back Upper IOM Slot in driveenclosure S/N:2S6233D259, Message: The management processor firmware needs to be upgraded. Management processor services may become unavailable., Diagnostic message: Perform a firmware update using the integrated firmware management capability as soon as possible., uuid:500c0ff15386b000-mp-a,500c0ff15386b000-mp-b, eventname:mgmt_processor_fw_mandatory_upgrade, eventid:001d001c, level:alert, category:storage_cluster, overallstatus:ok, name: vs_500c0ff15386b May 15 09:32:38 ALERT System E component:server, status:unknown, location:server hpb3cce3861a-2, Message: The server status cannot be determined., Diagnostic message: If the condition persists, contact HP technical support for further assistance., uuid: a a5731, eventname:server_status_unknown, eventid: , level:alert, category:server, overallstatus:degraded, name: ch_6500, engine name: hpb3cce3861a May 15 09:13:45 ALERT System E011D0000 Failed login attempt for user username from host (CLI). 598 May 14 14:30:55 ALERT System E010A0025 File system ifs1 not mounted on hpb3cce3861a May 14 14:30:55 ALERT System E010A0025 File system ifs1 not mounted on hpb3cce3861a May 14 14:04:37 ALERT System E Warning! - failover is disabled on this cluster, please go to Maintenance page to enable failover. 22 Alphabetical List of Commands and Details

23 cifs add localadmin Use the cifs add localadmin command only when CIFS authentication is set to AD. Adds a local administrator to the CIFS server s BUILTIN\s group. The local administrator also allows users that are not Active Directory domain administrators to perform share management on the StoreOnce appliance. cifs add localadmin [SETX] name <username> SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow localadmin). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. name This required parameter specifies the CIFS domain user or group. Upon successful completion of the command, the message is displayed. # cifs add localadmin name name1@domainname.com cifs add localadmin 23

24 cifs add user Used when the CIFS server authentication is set to user. Adds a user to the CIFS server. cifs add user [SETX] name <username> password <password> SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow user). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. name This required parameter specifies user name. password This required parameter specifies the user password. Passwords must contain at least eight characters and should not contain the single quotation mark ( ). Upon successful completion of the command, the message is displayed. # cifs add user name newuser password newpassword 24 Alphabetical List of Commands and Details

25 cifs delete localadmin Deletes local administrator from the CIFS server s BUILTIN\s group. Used only when the CIFS server authentication mode is set to AD. cifs delete localadmin [SETX] name <username> SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow localadmin). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. name This required parameter specifies the CIFS user or group name. Upon successful completion of the command, the message is displayed. 1 # cifs delete localadmin name domainname\name1 2 # cifs delete localadmin name name1@domainname.com cifs delete localadmin 25

26 cifs delete user Deletes user from CIFS server. Used only when the CIFS server authentication is set to User. cifs delete user [SETX] name <username> SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow user). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. name This required parameter specifies user name. Upon successful completion of the command, the message is displayed. # cifs delete user name newuser 26 Alphabetical List of Commands and Details

27 cifs disable domainjoin Causes the CIFS server to leave the Active Directory domain. Used only when the CIFS server authentication mode is set to AD. cifs disable domainjoin [SETX] SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow domainjoin). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. Not applicable no parameters exist within this command. Upon successful completion of the command, the message is displayed. # cifs disable domainjoin cifs disable domainjoin 27

28 cifs disable user Disables specific user authentication for the CIFS share. Used only when the CIFS server authentication mode is set to User. cifs disable user [SETX] <SHAREX> name <username> SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow user). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. SHAREX Indicates the share index. X is the numeric share ID. This value can be found from the CLI command nas show share SETX all (see nas show share (page 88)). This object must be specified in the exact position as given by the command syntax (i.e., it must immediately follow the user command if the SETX object is omitted); otherwise, it must immediately follow the SETX object. name This required parameter specifies the user name. Upon successful completion of the command, the message is displayed. # cifs disable user SHARE1 name myuser 28 Alphabetical List of Commands and Details

29 cifs enable domainjoin Causes the CIFS server to join to an Active Directory domain. Use this command after switching the CIFS authentication mode to AD and specifying a domain to join using the cifs modify config command. NOTE: This command may take up to 120 seconds to complete. cifs enable domainjoin [SETX] name <username> password <password> SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow domainjoin). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. name This required parameter specifies the Active Directory user name. password This required parameter specifies the user password. Upon successful completion of the command, the message is displayed. # cifs enable domainjoin name password abc123 cifs enable domainjoin 29

30 cifs enable user Enables specific user authentication for the CIFS share. Used when the CIFS server authentication mode is set to User. Before running this command, the user must be added to the CIFS server users list. cifs enable user [SETX] <SHAREX> name <username> SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow user). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. SHAREX Share index. X is the numeric share ID. This value can be found from the CLI command nas show share SETX all (see nas show share (page 88)). This object must be specified in the exact position as given by the command syntax (i.e., it must immediately follow the user command if the SETX object is omitted; otherwise, it must immediately follow the SETX object). name This required parameter specifies the user name. Upon successful completion of the command, the message is displayed. # cifs enable user SHARE1 name myuser 30 Alphabetical List of Commands and Details

31 cifs modify config Modifies CIFS server configuration. NOTE: Because the functionality of the servername and workgroup parameters are disabled, these parameters should not be used within scripts. After changing authentication mode to AD, the cifs enable domainjoin command must be run in order to join the domain. cifs modify config [SETX] [auth {None User AD domain <name>}] [smbsigning {Required Optional}] [networktype {ipv6 ipv4}] SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow config). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. auth This optional parameter specifies the CIFS server authentication type (None, User or Active Directory specifying the AD domain name). smbsigning This optional parameter specifies CIFS server SMB signing (Required or Optional). Using this parameter is not recommended because of a possible issue with the SMB server. networktype This optional parameter specifies whether the network is an IPv6 or IPv4 network. Upon successful completion of the command, the message is displayed. 1 # cifs modify config SET1 auth AD domain test.com 2 # cifs modify config auth None cifs modify config 31

32 cifs modify user Modifies the CIFS user password. Used when the CIFS server authentication mode is set to User. cifs modify user [SETX] name <username> password <password> SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow user). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. name This required parameter specifies the user name. password This required parameter specifies the user s new password. Upon successful completion of the command, the message is displayed. # cifs modify user name johndoe password abc Alphabetical List of Commands and Details

33 cifs show config Displays CIFS server configuration information. cifs show config [SETX] SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow config). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. Not applicable no parameters exist within this command. Upon successful completion of the command, the message is displayed. # cifs show config set3 CIFS Server Name: Authentication Mode: Workgroup: SMB Signing Required: StoreOnce-USE337E8RY None WORKGROUP false cifs show config 33

34 cifs show localadmin Lists the names of local administrators currently in the CIFS server BUILTIN\s group. Used when the CIFS server authentication mode is set to AD. cifs show localadmin [SETX] SETX This object defines the service set where the NAS share is located. X is the numeric index of the service set. It must be specified in the exact position as given by the command syntax (i.e., it must immediately follow localadmin). This object is required for StoreOnce 6500 and B6200 Systems. The object is optional for StoreOnce 2700, 2900, 4500, 4700, and 4900 Systems (and older models); if omitted, it defaults to SET1. Not applicable no parameters exist within this command. Upon successful completion of the command, the message is displayed. 1 # cifs show localadmin set1 Admin: LOCAL\ 2 # cifs show localadmin Admin: Admin: Admin: ApplianceName\ ServerName\domain^admins ServerName\name1 34 Alphabetical List of Commands and Details

35 config delete Deletes a configuration file existing in the config directory. config delete <ConfigFile> ConfigFile This required object is the configuration file which is deleted from the config directory. This file must exist in the config directory. The config show list (page 40) command lists all valid configuration files in the config directory. Not applicable no parameters exist within this command. Upon successful completion of the command, the message is displayed. # config delete devconfig_hpd a1fc_thur_jul_19_10:33:24_utc_2012.zip config delete 35

36 config restore devices Restores 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 StoreOnce System user guide for your product. See also config save devices (page 38). config restore devices [SETX[,X]] <ConfigFile> [force] SETX This optional object defines the service sets to which the drive is added. X is the numeric index of the service set. Include more than one service set, if necessary. If no service sets are defined, the restore is performed on all the service sets in the cluster. ConfigFile This required object defines the device configuration file detailing the configuration to which the devices in the system are restored. force This optional parameter overrides any digital signatures or sumchecks. Upon successful completion of the command, the message is displayed. # config restore devices saved-devices-config 36 Alphabetical List of Commands and Details

37 config restore keystore 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. WARNING! This command overwrites the existing system keystore. If an up-to-date backup of the keystore is unavailable, permanent and unrecoverable access to encrypted data may occur. config restore keystore <keystorefile> Not applicable no objects exist within this command. keystorefile This required parameter defines the name of the keystore file to be retrieved. List available configuration files using the CLI command, config show list keystore. Upon successful completion of the command, the message is displayed. # config restore keystore keystore_hpvm979d0769_ t12:27:05z.kms config restore keystore 37

38 config save devices Saves the device configuration to the config directory using the standard naming convention of devconfig_<cluster ID and serial number> <date and time stamp>.zip. IMPORTANT: Copy the configuration zip file to a local system immediately after creation; this is especially important for StoreOnce 6500 and B6200 Systems. You must manage the configuration files and keep them updated as changes occur to the StoreOnce configuration. NOTE: This command only works if storage systems are in a Good state. If, for example, replication is out of sync and the storage system status is something other than Running state, the config save devices command fails. For more information about the configuration save and restore process, see the StoreOnce System user guide for your product. See also config restore devices (page 36). config save devices Not applicable no objects exist within this command. Not applicable no parameters exist within this command. Upon successful completion of the command, the following is displayed: Configuration Save Started Use the config show list (page 40) command to see the saved configuration files. # config save devices Configuration Save Started Enter command "config show list devices" to see the saved configuration files 38 Alphabetical List of Commands and Details