HP Storage Essentials 5.
Legal and notice information © Copyright 2002-2006 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Contents About this guide . . . . . . . . . . . . . . . Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document conventions and symbols . . . . . . . . . . . . . . . . . . . . . HP technical support . . . . . . . . . . . . .
appiqlist -backup -backupmanager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqlist -backup -backupmanager -all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqlist -backup -backupmanager -mediamanager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqlist -backup -backupmanager -schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
appiqlist -event -all -startdate -starttime -enddate -endtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqlist -event -all -severity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqlist -event -all -severity -startdate -starttime -enddate -endtime . . . . . . . . . . . . . . . . . . . . . . . . . .
appiqshow -event -all -elementtype -startdate -starttime -enddate -endtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -event -all -startdate -starttime -enddate -endtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqdelete -event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqdelete -event -all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqdelete -event -all -severity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
appiqshow -fabric -all -host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -fabric -all -port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -fabric -all -switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -fabric -all -storagesystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
appiqstats -device -host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqstats -device -host -logicaldisk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Host Security Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqlist -hostsecuritygroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
appiqremove -hostsecuritygroup - initiator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqcreate -hostsecuritygroup -initiator [-name ] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
-password -hostname . . . . . . . . . . . . . appiqinstall -ssh -username -password -hostname . . . . . . . . . . . . . appiqstart -agent -username -password -hostname . . . . . . . . . . . . . appiqstop -agent -username -password -hostname . . . . .
appiqshow -pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -pool -storagesetting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -pool - storageextent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -pool -volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
appiqshow -device -storagesystem -unmappedvolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -device -storagesystem -mappedvolume. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -device -storagesystem -storagecapability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
appiqshow -device -tapelibrary -port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -device -tapelibrary -mediaaccessdevice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqshow -device -tapelibrary -controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
appiqcreate -zonealias -fabric -port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqdelete -zonealias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqadd -zonealias -port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . appiqremove -zonealias -port . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
xvi
About this guide This guide provides information about: • Installing the Command Line Interface (CLI) • Using the CLI Intended audience This guide is intended for: • Network Engineers • Administrators • Any one that needs to monitor and/or manage their elements by using the CLI Prerequisites Prerequisites for using this product include: • Networking • Storage Area Networks (SANs) • The Common Information Model (CIM) Related documentation In addition to this guide, please refer to other documents for this
Document conventions and symbols Document conventions Table 1 Convention Element Medium blue text: Figure 1 Cross-reference links and e-mail addresses Medium blue, underlined text (http://www.hp.
TIP: Provides helpful hints and shortcuts. HP technical support Telephone numbers for worldwide technical support are listed on the HP support web site: http://www.hp.com/support/.
xx
1 Overview of the CLI IMPORTANT: Depending on your license, the Command Line Interface (CLI) may not be available. See the "List of Features" to determine if you have access to the CLI. The "List of Features" is accessible from the Documentation Center (Help > Documentation Center in Storage Essentials). The CLI provides an alternate way for you to manage elements the management server monitors. You can use the CLI commands in scripts to manage your storage.
• Pools • Volumes • Zone Aliases • Zone Sets • Zones To exit the CLI, type exit or quit. Before Using the CLI Before you can use the CLI, you must configure the CLI environment. To connect to the management server, enter the following command on the computer from which you will run the CLI commands. This computer must already have the CLI installed: • Microsoft Windows: appiqconfig -username -password -server transport -erroroutput -port • UNIX: .
• HTTP - 80 • HTTPS - 443 • RMI - 1099 Accessing the CLI Help from the CLI Online help for the command line interface (CLI) is not only accessible by clicking the Help button on the management server, but also from the CLI window. Help can be accessed from the CLI window by appending -help or -h to the command. For example, assume you want to list all the statistics for a host, but you don't know the full command.
• ”Backups” on page 13 • ”Discovery” on page 18 • ”Domains” on page 19 • ”Events” on page 19 • ”Fabrics” on page 32 • ”Export to Visio” on page 32 • ”Hosts” on page 40 • ”Host Security Groups” on page 45 • ”NetApp NAS Devices” on page 51 • ”Remote CIM Extensions Management” on page 53 • ”Security” on page 55 • ”Storage Pools” on page 57 • ”Sorting the Information Displayed” on page 59 • ”Storage Systems” on page 61 • ”Switches” on page 67 • ”Tape Libraries” on page 69 • ”Volumes” on page 71 • ”Zones” on pag
Table 2 Error Code Descriptions (continued) Error Code Description 8 CLI Configuration Error 9 Help Error 10 General Error Accessing Error Codes To access error codes, enter one of the following at the command prompt after you have entered a CLI command: • Microsoft Windows echo %errorlevel% • UNIX (C shell) echo $status • UNIX (Bourne shell, Bourne Again shell, and Korn shell) echo $? The error code is returned, for example 0, which means there is no error. Storage Essentials 5.
6 Overview of the CLI
2 Installing the CLI This chapter describes the following: • ”Installing the CLI on Microsoft Windows” on page 7 • ”Installing the CLI on Sun Solaris” on page 8 • ”Installing the CLI on IBM AIX” on page 9 • ”Upgrading the CLI” on page 10 • ”Removing the CLI from UNIX” on page 10 Keep in mind: • Install the CLI on a remote server that can access the management server. • If you have a previous version of the CLI, you must upgrade it to match the current version of the management server.
9. Configure the CLI workstation to point to the management server. See ”Before Using the CLI” on page 2. Removing the CLI from Microsoft Windows To remove the CLI from Microsoft Windows: 1. Go to Add/Remove Programs. 2. Select the CLI program from the list. 3. Click the Change/Remove button. 4. When you told the product is about to be uninstalled, click Uninstall. 5. When the program is done with removing the product, click Done. The CLI is removed from Microsoft Windows.
The CLI is automatically installed in the /opt/APPQcli directory. 3. During the installation you are asked for the installation directory. Select the default installation directory for best results. 4. Go to a directory other than one on the CD-ROM. 5. Unmount the CD-ROM by entering the following at the command prompt: # umount /cdrom where /cdrom is the name of the directory where you mounted the CD-ROM 6.
• Silent Installation (X Windows not required) - Enter the following at the command prompt. Then, go to Step 6. You cannot change the installation directory. # ./InstallCLI.bin –i silent The CLI is automatically installed in the /opt/APPQcli directory. 5. During the installation you are asked for the installation directory. Select the default installation directory for best results. 6. Go to a directory other than one on the CD-ROM. 7.
3 CLI Commands IMPORTANT: Before you can use the CLI, you must make a connection to the management server. See the topic, ”Before Using the CLI” on page 2 for more information. It is recommended you use the CLI prompt to enter your commands instead of typing the “appiq” prefix in the CLI commands. You can avoid typing the “appiq” prefix in the CLI commands by entering cli at the command prompt.
• ”Switches” on page 67 • ”Tape Libraries” on page 69 • ”Volumes” on page 71 • ”Zones” on page 73 • ”Zone Aliases” on page 79 • ”Zone Sets” on page 81 CLI Version You can find the version of the CLI by entering the following: • Microsoft Windows: cli -version • UNIX: .
appiqlist -application -database -all Description: Lists all the database applications. appiqlist -application -exchange -all Description: Lists all the exchange applications. appiqlist -application -virtual -all Description: Lists all the virtual applications. appiqshow -application Description: Display detailed information about the specified application, where is the identifier for the application.
• ”appiqlist -backup -backupmanager -job -success” on page 15 • ”appiqlist -backup -backupmanager -job -failure” on page 15 • ”appiqlist -backup -backupmanager -job -partial” on page 15 • ”appiqlist -backup -backupmanager -mediapool” on page 15 • ”appiqlist -backup -backupmanager -media” on page 15 • ”appiqlist -backup -backupmanager -policy” on page 16 • ”appiqlist -backup -backupmanager -client” on page 16 • ”appiqlist -backup -mediamanager ” on page 16 • ”appiqlist
appiqlist -backup -backupmanager -mediamanager Description: Lists all the media managers connected to the backup manager. You can find the identifier for the backup manager through the appiqlist -backup -backupmanager -all command. appiqlist -backup -backupmanager -schedule Description: Lists all the backup schedules of the backup manager. You can find the identifier for the backup manager through the appiqlist -backup -backupmanager -all command.
appiqlist -backup -backupmanager -policy Description: Lists all the backup policies configured on the backup manager. You can find the identifier for the backup manager through the appiqlist -backup -backupmanager -all command. appiqlist -backup -backupmanager -client Description: Lists all the backup clients associated for the backup manager. You can find the identifier for the backup manager through the appiqlist -backup -backupmanager -all command.
appiqshow -backup -backupmanager -schedule Description: Provides detailed description of all the backup schedules of the backup manager. You can find the identifier for the backup manager through the appiqlist -backup -backupmanager -all command. appiqshow -backup -backupmanager -job -all Description: Provides detailed description of all the backup jobs configured on the backup manager. You can find the identifier for the backup manager through the appiqlist -backup -backupmanager -all command.
appiqshow -backup -backupmanager -policy Description: Provides detailed description of all the backup policies configured on the backup manager. You can find the identifier for the backup manager through the appiqlist -backup -backupmanager -all command. appiqshow -backup -backupmanager -client Description: Provides detailed description of all the backup clients associated for the backup manager.
appiqdiscover -domaindiscovery -details -backup Description: This command collects only backup data during Get Details. appiqdiscover -domaindiscovery -details -all Description: This command collects infrastructure and backup data during Get Details. appiqdiscover -domaindiscovery -details -stop Description: This command stops the collection of infrastructure and backup data during Get Details.
appiqlist -event -all Description: Provides a short description of the events. appiqlist -event Description: Lists events specified by along with a short description for that event. You can obtain from the appiqlist -event -all command.
appiqlist -event -all -severity -startdate -starttime -enddate -endtime Description: Lists the events from the elements monitored by the management server and fall within the time and severity specified. where • - is the date or today can be entered, for example 2005-05-23. • - is the time (24-hour clock) or now can be entered, for example 10:45. • - is the severity of the event.
Event Type Definition: Enter one of the following for the event type. Table 4 Event Types S.No Event Type An Event Regarding...
Description: Lists the events for the specified event type. Table 5 Element Types Element Type Lists Only Events From... application Applications host Hosts switch Switches storagesystem Storage Systems fabric Fabrics other Elements that do not fit the previous categories management server The management server All All elements appiqlist -event -all -elementtype -severity Description: Lists the events for the specified event type and severity.
appiqlist -event -elementid where is the identifier for the element. The element identifier can be obtained from several methods. For example, the element identifier for a storage system can be obtained from the appiqlist -device -storagesystem -all command. Description: Lists the events from the element specified. appiqlist -event -elementid -severity Description: Lists the events from a specified element and with a specified severity value.
• - is the severity of the event. See Table 3 on page 20 for more information. All severities are included if you do not include the severity flag. • - is the date or today can be entered, for example 2005-05-23. • - is the time (24-hour clock) or now can be entered, for example 10:45.
information about the various element types. Events from all element types are displayed if you do not specify the -elementtype tag. appiqshow -event -all -severity where is the severity of the event. All severities are included if you do not include the severity flag. Description: Provides a description of the events from the elements monitored by the management server and fall within the severity specified. All severities are included if you do not include the severity flag.
where • - is the date or today can be entered, for example 2005-05-23. • - is the time (24-hour clock) or now can be entered, for example 10:45. • - is the severity of the event. See Table 3 on page 20 for more information. All severities are included if you do not include the severity flag.
• - is the severity of the event. All severities are included if you do not include the severity flag. appiqshow -event -elementid Description: Provides detailed information of all the events for a specified element. appiqshow -event -elementid -severity Description: Provides a detailed description of events from the specified element and with specified severity value. where • is the identifier for the element.
appiqshow -event -elementid -type -startdate -starttime -enddate -endtime Description: Provides detailed information of all the events for a specified element, event type and between the specified time intervals. where • - is the identifier for an element. • - is the date or today can be entered, for example 2005-05-23.
appiqclear -event -all -startdate -starttime -enddate -endtime Description: Clears all the events generated between the given time intervals. where • - is the date or today can be entered, for example 2005-05-23. • - is the time (24-hour clock) or now can be entered, for example 10:45. appiqclear -event -all -severity Description: Clears all the events with the specified severity.
appiqdelete -event -all -startdate -starttime -enddate -endtime Description: Deletes all the events that are associated with an element between given time intervals. This command can only delete events that are associated with an element. where • - is the date or today can be entered, for example 2005-05-23. • - is the time (24-hour clock) or now can be entered, for example 10:45.
• - is the identifier for an element. • - is the date or today can be entered, for example 2005-05-23. • - is the time (24-hour clock) or now can be entered, for example 10:45. • - is the severity of the event. See Table 3 on page 20 for more information. All severities are included if you do not include the severity flag.
Application:1064:straker1 Application:1125:Archer1 Fabric:1166:10000060695011e9 Application:1064:straker1 Application:1125:Archer1 Fabric:1179:1000080088A06414 Fabric:1215:100000606930260d The number after the first colon is the identifier for the element. The item after the second colon is the World Wide Name (WWN) of the fabric or the name of the element in the fabric. appiqlist -fabric -all -host Description: Lists the hosts in fabrics.
Switch:1012:AppIQ_ED-1032 Fabric:1089:1000080088A0D07E Switch:1010:AppIQ_ES-3016 Fabric:1096:1000006069500b84 Switch:1013:QBrocade3 Switch:1014:QBrocade4 Fabric:1166:10000060695011e9 Switch:1007:QBrocade2 Switch:1008:QBrocade5 Fabric:1179:1000080088A06414 Switch:1011:AppIQ_ED-6064 Fabric:1215:100000606930260d Switch:1005:QBrocade1 The number after the first colon is the identifier for the element.
StorageSystem:1001:000183500570 (Symm48:3830) The number after the first colon is the identifier for the element. The item after the second colon is the World Wide Name (WWN) of the fabric or the name of the element in the fabric. appiqlist -fabric -all -tapelibrary Description: Lists the tape libraries in fabrics. appiqlist -fabric -all -zoneset Description: Lists the zone sets in fabrics. appiqlist -fabric -all -zone Description: Lists the zones in fabrics.
The number after the first colon is the identifier for the element. The item after the second colon is the World Wide Name (WWN) of the fabric or the name of the element in the fabric. appiqlist -fabric -application Description: Lists the applications in the fabric specified by .where is the fabric identifier. The fabric identifier can be obtained from several methods, such as from the appiqlist -fabric -all command.
Switch:1014:QBrocade4 The number after the first colon is the identifier for the element. The item after the second colon is the name of the element in the fabric. appiqlist -fabric -storagesystem where is the fabric identifier. The fabric identifier can be obtained from several methods, such as from the appiqlist -fabric -all command. Description: Lists the storage systems in the fabric specified by .
appiqshow -fabric -all -device Description: Provides a detailed description of the elements, such as hosts, switches, and storage in the fabrics managed by the management server. appiqshow -fabric -all -application Description: Provides a detailed description of the applications in the fabrics managed by the management server. appiqshow -fabric -all -host Description: Provides a detailed description of the hosts in the fabrics managed by the management server.
Description: Provides a detailed description of the fabric specified by . appiqshow -fabric -device where is the fabric identifier. The fabric identifier can be obtained from several methods, such as from the appiqlist -fabric -all command. Description: Provides a detailed description of the applications, hosts, switches, storage systems, zone sets, zones, paths, in the fabric specified by .
appiqshow -fabric -zoneset where is the fabric identifier. The fabric identifier can be obtained from several methods, such as from the appiqlist -fabric -all command. Description: Provides a detailed description of the zone sets in the fabric specified by . appiqshow -fabric -zone where is the fabric identifier. The fabric identifier can be obtained from several methods, such as from the appiqlist -fabric -all command.
appiqlist -device -host where is the host identifier. The host identifier can be obtained from several methods, such as from the appiqlist -device -host -all command. Description: Provides the DNS name of the host specified. Example: C:\cli>appiqlist -device -host 1004 Host:1004:comet The number after the first colon is the identifier for the element. The item after the second colon is the name of the host. appiqlist -device -host -all where is the host identifier.
Application:1064:straker1 The number 1064 is the identifier for the application and straker1 is the name of the instance for the application. In this instance, straker1 is an Oracle instance. appiqlist -device -host -hba where is the host identifier. The host identifier can be obtained from several methods, such as from the appiqlist -device -host -all command. Description: Lists the host bust adapters connected to the host specified.
appiqlist -device -host -multipathdevice where is the host identifier. The host identifier can be obtained from several methods, such as from the appiqlist -device -host -all command. Description: Lists the multi-path devices connected to the host specified. appiqlist -device -host -processor where is the host identifier. The host identifier can be obtained from several methods, such as from the appiqlist -device -host -all command.
appiqshow -device -host -targetmapping where is the host identifier. The host identifier can be obtained from several methods, such as from the appiqlist -device -host -all command. Description: Provides a detailed description of the target mappings of the host specified. appiqshow -device -host -diskdrive where is the host identifier. The host identifier can be obtained from several methods, such as from the appiqlist -device -host -all command.
Description: Provides statistics about the host specified. appiqstats -device -host -logicaldisk where is the host identifier. The host identifier can be obtained from several methods, such as from the appiqlist -device -host -all command. Description: Provides statistics about the logical disks on the specified host.
appiqlist -hostsecuritygroup -hid Description: Provides list of all the hardware IDs belonging to the specified host security group. The identifier for the host security group can be obtained from several methods, such as the appiqlist -device -storagesystem -hostsecuritygroup command. appiqlist -hostsecuritygroup -subordinate Description: Provides list of all the subordinate host security group belonging to the specified host security group.
appiqshow -hostsecuritygroup -lun Description: Provides detailed information of all the luns belonging to the specified host security group. The identifier for the host security group can be obtained from several methods, such as the appiqlist -device -storagesystem -hostsecuritygroup command. appiqshow -hostsecuritygroup -hid Description: Provides detailed information of all the hardware IDs belonging to the specified host security group.
appiqlist -device -storagesystem -hostsecuritygroup and appiqlist -device -storagesystem -storageclientsettings commands. appiqset -hostsecuritygroup -hostmode2 Description: Sets data for the second host mode. where • - is the identifier for the host security group. • - is the string for the second host mode.
• - it is the HBA port ID or initiator for the host. The HBA port ID can be obtain from several methods, such as from the appiqlist –device –host -port command. appiqremove -hostsecuritygroup -volume Description: Removes specified volumes from the protocol controller specified. where: • is the identifier for the host security group.
appiqcreate -hostsecuritygroup -port -initiator [-name ] Description: Creates a host security group with the given name that is associated to the specified list of initiators (host ports) and specified list of storage system ports. where: • - The storage system identifier can be obtained from several methods, such as from the appiqlist -device -storagesystem -all command.
• 2: Read Write • 3: Read-Only • 4: No Access • (optional) is the name you specify for the host security group Adding a list of initiator, volumes or storagesystem ports to a host security group (HSG) is specific to the storage system. Some storage system may not support adding more than one volume or initiator to the same HSG. Some storage systems may not support adding same volume to more than one HSG.
appiqlist -device -nashost -aggregate Description: Provides a list of all aggregates of a NAS host. appiqlist -device -nashost -plex Description: Provides a list of all plexes of a NAS host. appiqlist -device -nashost -raid Description: Provides a list of all raid groups of a NAS host. appiqlist -fabric -nashost Description: Provides a list of all NAS hosts of a fabric. appiqlist -fabric -all -nashost Description: Provides a list of all NAS hosts of all fabrics.
appiqshow -device -nashost -aggregate Description: Provides a detailed description of all the aggregates of a NAS host. appiqshow -device -nashost -plex Description: Provides a detailed description of all the plexes of a NAS host. appiqshow -device -nashost -raid Description: Provides a detailed description of all the raid groups of a NAS host. appiqshow -fabric -nashost Description: Provides a detailed description of all the NAS hosts of a fabric.
appiqstart -agent -username -password -hostname Description: Tries to start the CIM Extension on the indicated remote host. appiqstop -agent -username -password -hostname Description: Tries to stop the CIM Extension on the indicated remote host.
-ip: The IP address to start the agent on (useful for multihomed systems). -autoip: Specifies that the same IP address used to communicate with the machine via SSH is used to start the agent. -agentUsername: The username the agent will respond to. -agentPassword: The password the agent will respond to. appiquninstall -agent -username -password -hostname Description: Uninstalls the CIM Extension from the indicated host.
appiqlist -organization -element Description: Lists elements available in the organization specified. You can obtain the identifier for the organization from the appiqlist -organization -all command. appiqlist -organization -user Description: Lists users in the organization specified. You can obtain the identifier for the organization from the appiqlist -organization -all command.
appiqshow -organization -element Description: Provides detailed description of all the elements available in the organization specified. You can obtain the identifier for the organization from the appiqlist -organization -all command. appiqshow -organization -user Description: Provides detailed description of all the users in the organization specified. You can obtain the identifier for the organization from the appiqlist -organization -all command.
appiqshow -pool Description: Provides a detailed description of pool. The pool ID can be obtained from several methods, such as from the appiqlist -device -storagesystem -pool command. appiqshow -pool -storagesetting Description: Provides a detailed list of storage settings for this pool. Keep in mind the following: • For a parent pool (unconfigured pool), these settings are used in the creation of a pool.
• - is the size of the pool in megabytes. appiqcreate -pool … -extents … -storagesetting -size Description: Creates a storage pool with the specified unconfigured pools, storage setting, size and storage pool name. where: • - is an unconfigured pool ID The pool ID can be obtained from several methods, such as from the appiqlist -device -storagesystem -pool command.
The software displays the following: 2 2 2 2 2 1 1 1 1 Host:3563:Host_3563 Host:1622:ufo Host:1620:challenger Host:1608:YAMATO Host:1607:TIRPITZ Host:3597:Host_3597 Host:3594:Host_3594 Host:3591:Host_3591 Host:3588:Host_3588 The number after the first colon is the identifier for the element. The item after the second colon is the name of the host.
Sort All Zones in All Fabrics by Zone Name To sort all zones in all fabrics by zone name, enter the following at the command prompt: # appiqlist -fabric -all -zone | grep "^Zone:" | cut -d':' -f3 | sort The software displays the following: BobsLP8000_FA13B BobsLP8000_FA13B Challenger_FA13A Challenger_FA16A The names of the zones are displayed.
appiqlist -device -storagesystem where is the storage system identifier. The storage system identifier can be obtained from several methods, such as from the appiqlist -device -storagesystem -all command. Description: Provides the name of the specified storage system. Example: C:\cli>appiqlist -device -storagesystem 1006 StorageSystem:1006:LSI2400 The number after the first colon is the identifier for the element.
Description: Lists the volumes for the storage system specified. appiqlist -device -storagesystem -storagecapability where is the storage system identifier. The storage system identifier can be obtained from several methods, such as from the appiqlist -device -storagesystem -all command. Description: Lists the storage capabilities for the storage system specified. appiqlist -device -storagesystem -drive where is the storage system identifier.
appiqlist -device -storagesystem -mappedvolume where is the identifier for a storage system. The storage system identifier can be found through several methods, such as from the appiqlist -device -storagesystem -all command. Description: Lists the mapped volumes for the storage system specified. appiqlist -device -storagesystem -storageclientsettings where is the storage system identifier.
appiqshow -device -storagesystem -pool where is the storage system identifier. The storage system identifier can be obtained from several methods, such as from the appiqlist -device -storagesystem -all command. Description: Provides a detailed description of the storage pools for the storage system specified. appiqshow -device -storagesystem -volume where is the storage system identifier.
appiqshow -device -storagesystem -extent where is the storage system identifier. The storage system identifier can be obtained from several methods, such as from the appiqlist -device -storagesystem -all command. Description: Provides a detailed description of the extents for the storage system specified. appiqshow -device -storagesystem -hostsecuritygroup where is the storage system identifier.
Switches Use the following types of CLI commands to obtain information about switches: • appiqlist - Lists information about the components of the switch • appiqshow - Provides a detailed description of the components in the switch appiqlist -device -switch -all Description: Lists the switches the management server detects.
appiqlist -device -switch -port where is the switch identifier. The switch identifier can be obtained from several methods, such as from the appiqlist -device -switch -all command. Description: Provides information about the ports on the specified switch. appiqlist -device -switch -zonealias where is the switch identifier. The switch identifier can be obtained from several methods, such as from the appiqlist -device -switch -all command.
appiqshow -device -switch -zone where is the switch identifier. The switch identifier can be obtained from several methods, such as from the appiqlist -device -switch -all command. Description: Provides detailed information of zones in the switch fabric. appiqshow -device -switch -zoneset where is the switch identifier. The switch identifier can be obtained from several methods, such as from the appiqlist -device -switch -all command.
Description: Provide a list of all the subcomponents (port, media access device, controller cards and changer devices) that belong to the specified tape library. appiqlist -device -tapelibrary -port where is the identifier for the tape library. The identifier for the tape library can be obtained from several methods, such as from the appiqlist -device -tapelibrary -all command. Description: Provides a list of all fibre channel ports that belongs to the specified tape library.
appiqshow -device -tapelibrary -all where is the identifier for the tape library. The identifier for the tape library can be obtained from several methods, such as from the appiqlist -device -tapelibrary -all command. Description: Provides a detailed description of all subcomponents, for example, port, media access device, controller and changerdevice) that belongs to the specified tape library.
• appiqdelete - Deletes a volume. appiqdelete -volume Description: Deletes the volume specified, where is the identifier of a volume. The can be obtained through several methods, such as from the appiqlist -device -host -volume command appiqcreate -volume -storagesetting -size Description: Creates a storage volume with the specified storage pool and the storage settings ID.
appiqcreate -volume -lsi -storagesetting -size -cacheahead -segmentsize -name Description: Creates a storage volume on an Engenio (LSI) storage system. where: • - is the identifier for a storage system pool. The storage system pool identifier can be found through several methods, such as from the appiqlist -device -storagesystem -pool command.
appiqlist -zone -all where is the zone identifier. The zone identifier can be obtained from several methods, such as from the appiqlist -fabric -zone command. Description: Provides a list of the ports, zone aliases, hosts and storage systems contained in the zone specified. appiqlist -zone -host where is the zone identifier. The zone identifier can be obtained from several methods, such as from the appiqlist -fabric --zone command.
Description: Provides detailed description of the hosts contained in the zone specified. appiqshow -zone -storagesystem where is the zone identifier. The zone identifier can be obtained from several methods, such as from the appiqlist -fabric -zone command. Description: Provides detailed description of the storage systems contained in the zone specified. appiqshow -zone -port where is the zone identifier.
• is the fabric identifier. The fabric identifier can be obtained from several methods, such as from the appiqlist -fabric -all command. • is the port identifier for a host or storage system. The port identifier for a host can be obtained from the appiqlist -device -host -port command and the port identifier for a storage system can be obtained from the appiqlist -device -storagesystem -port command. Description: Creates a zone within the specified fabric.
Description: Creates a zone within the specified fabric and containing the specified zone alias. Use the appiqadd -zone -port command to add the port identifier for a storage system or host. Spaces and dashes are not supported within the zone name for McDATA and Brocade switches. This command is for switches that do not use virtuals storage area networks (VSANs).
Likewise, if you used the port identifier of a storage system when you created the zone, use the appiqadd -zone -port command to add the port identifier for the host. This command is for switches that do not use virtuals storage area networks (VSANs). Use the appiqcreate -zone :: -fabric -port command for switches that do use virtual storage area networks. Naming Conventions for Brocade Switches: • The name must contain 1 to 64 characters.
• is the zone identifier. The zone identifier can be obtained from several methods, such as from the appiqlist -fabric -zone command. • is the zone alias identifier. The zone alias identifier can be obtained from several methods, such as from the appiqlist -zone -zonealias command. Description: Adds a zone alias to a zone. appiqremove -zone -port where • is the zone identifier.
• is the name of the virtual SAN in which you want to create the zone alias. • is the name of the switch on which you want to create the zone alias. • is the name of the zone alias you want to create. • is the fabric identifier. The fabric identifier can be obtained from several methods, such as from the appiqlist -fabric -all command. • is the port identifier for a host, switch or storage system.
• The following characters are invalid for Brocade switches: caret (^), dash (-), and dollar sign ($). Naming Conventions for McDATA and Connectrix Switches: • The name can have a maximum of 64 characters. • The first character of a zone alias name must be a letter (A-Z, AZ). • A zone alias name cannot contain spaces. • Valid characters are a-a, AA, 0-9, caret (^), dash ( -), underscore ( _), and dollar sign ($). • All names must be unique and may not differ by case.
• appiqcreate - Creates a zone set. • appiqactivate - Activates a zone set. • appiqdelete - Deletes a zone set. • appiqadd - Adds a specified zone to a zone set. • appiqremove - Removes a zone set appiqlist -zoneset where is the zone set identifier. The zone set identifier can be obtained from several methods, such as from the appiqlist -fabric -zoneset command. Description: Lists the elements that are contained within the zone set specified.
appiqcreate -zoneset -fabric -zone where • is the name of the zone set. To verify you have a unique name for the zone set in the fabric, enter the appiqlist -fabric -zoneset command. • is the fabric identifier. The fabric identifier can be obtained from several methods, such as from the appiqlist -fabric -all command. • is the zone identifier.
appiqactivate -zoneset where is the zone set identifier. The zone set identifier can be obtained from several methods, such as from the appiqlist -fabric -zoneset command. Description: Activates the zone set specified by . The zone set that was previously active is automatically deactivated. appiqadd -zoneset -zone where • is the zone set identifier.
Index A accessing CLI 2 CLI help 3 error codes 4 AIX CLI installation 9 CLI removal 10 appiqactivate 81 appiqadd 73, 79, 81 appiqclear 19 appiqcreate 57, 71, 73, 79, 81 appiqdelete 19, 57, 71, 73, 79, 81 appiqlist 19, 32, 40, 61, 67, 73, 81 appiqlist -device -storagesystem -port 61 appiqlist -device -storagesystem -all 61 appiqremove 73, 79, 81 appiqshow 19, 32, 40, 61, 67, 73, 79, 81 audience xvii authorized reseller, HP xix C CIM xvii CLI 59 accessing 2 CLI_DIR 2 configuring 2 connecting 2 error codes 4
H help accessing 3 help, obtaining xix hosts CLI commands 40 HP authorized reseller xix storage web site xix Subscriber’s choice web site xix technical support xix I installing CLI 7, 8, 9 L leaving CLI 1 list of CLI commands 3, 4 N Networking xvii P pools CLI commands 57 prerequisites xvii Q quitting CLI 1 R related documentation xvii removing CLI 10 S SAN xvii setting CLI variable 2 CLI_DIR 2 Solaris 86 CLI installation 8 CLI removal 10 sorting CLI 59 storage pools CLI commands 57 storage systems
Tables 1 2 3 4 5 Document conventions . . . Error Code Descriptions . . Severity Definitions . . . . . Event Types. . . . . . . . . . . Element Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii ..............................................4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 . . . . . . .