IBM FlashSystem A9000Version 12.0
Command-Line Interface (CLI)Reference Guide
SC27-8559-00
IBM
NoteBefore using this document and the product it supports, read the information in “Notices” on page 565.
Edition notice
Publication number: SC27-8559-00. This publication applies to version 12.0 of IBM FlashSystem A9000 and to allsubsequent releases and modifications until otherwise indicated in a newer publication.
© Copyright IBM Corporation 2016.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.
Contents
About this guide . . . . . . . . . . . ixIntended audience . . . . . . . . . . . . ixConventions used in this guide . . . . . . . . ixRelated information and publications . . . . . . ixIBM Publications Center . . . . . . . . . . xSending or posting your comments . . . . . . . xGetting information, help, and service . . . . . . x
Chapter 1. Overview of thecommand-line interface (CLI) . . . . . 1Overview of the XCLI utility . . . . . . . . . 1
Installing and starting the XCLI . . . . . . . 1Exiting an interactive XCLI session . . . . . . 3
Using the CLI . . . . . . . . . . . . . . 3Interactive and basic modes . . . . . . . . 3Understanding the command syntax . . . . . 5Using identification parameters . . . . . . . 7Display options . . . . . . . . . . . . 10Running commands in batch mode . . . . . 13Displaying CLI help and the XCLI utility version 14
Chapter 2. Host and clustermanagement commands . . . . . . . 15Adding a host to a cluster . . . . . . . . . 15Creating a cluster . . . . . . . . . . . . 16Deleting clusters. . . . . . . . . . . . . 17Listing clusters . . . . . . . . . . . . . 18Removing a host from a cluster. . . . . . . . 19Renaming clusters . . . . . . . . . . . . 20Adding a port to a host . . . . . . . . . . 20Defining a new host . . . . . . . . . . . 22Deleting a host . . . . . . . . . . . . . 23Listing hosts . . . . . . . . . . . . . . 24Listing ports . . . . . . . . . . . . . . 25Removing a port from a host . . . . . . . . 26Renaming a host. . . . . . . . . . . . . 27Updating a host definition . . . . . . . . . 28Mapping a volume to a host or cluster . . . . . 30Listing the mapping of volumes to hosts or clusters 32Setting the special type of hosts or clusters . . . . 33Listing hosts/clusters to which a volume is mapped 34Unmapping a volume from a host or cluster . . . 35Setting the default idle time before unmapping avolume . . . . . . . . . . . . . . . . 37Retrieving the default idle time before unmapping avolume . . . . . . . . . . . . . . . . 37Creating a performance class . . . . . . . . 38Deleting a performance class . . . . . . . . 38Renaming a performance class . . . . . . . . 40Listing details of performance classes. . . . . . 40Adding a host to a performance class. . . . . . 41Removing a host from its performance class . . . 42Adding a pool to a performance class . . . . . 43Removing a pool from its performance class . . . 44Adding a volume to a performance class . . . . 45
Removing a volume from its performance class . . 46Adding a domain to a performance class . . . . 47Removing a domain from its performance class . . 48Setting the rate for a performance class . . . . . 48Listing host profiles . . . . . . . . . . . 50Updating the host profile . . . . . . . . . . 50Removing the profile of the specified host . . . . 51Enabling the host profiler. . . . . . . . . . 52Disabling the host profiler . . . . . . . . . 52
Chapter 3. Volume managementcommands . . . . . . . . . . . . . 55Clearing reservations of a volume . . . . . . . 55Listing reservation keys . . . . . . . . . . 55Listing volume reservations . . . . . . . . . 56Copying volumes . . . . . . . . . . . . 57Creating a volume . . . . . . . . . . . . 60Deleting a volume . . . . . . . . . . . . 62Formatting a volume . . . . . . . . . . . 64Listing volumes . . . . . . . . . . . . . 65Listing a volume's extended attributes . . . . . 67Locking a volume . . . . . . . . . . . . 68Renaming a volume . . . . . . . . . . . 70Resizing a volume . . . . . . . . . . . . 71Unlocking a volume . . . . . . . . . . . 74
Chapter 4. Volume snapshotmanagement commands . . . . . . . 77Changing a snapshot deletion priority . . . . . 77Creating a snapshot . . . . . . . . . . . 78Deleting a snapshot . . . . . . . . . . . 81Duplicating a snapshot . . . . . . . . . . 83Formatting a snapshot . . . . . . . . . . . 84Listing snapshot information . . . . . . . . 86Restoring a volume from a snapshot . . . . . . 88
Chapter 5. Consistency groupmanagement commands . . . . . . . 91Adding a volume to a consistency group . . . . 91Creating consistency groups . . . . . . . . . 93Deleting a consistency group . . . . . . . . 94Listing consistency groups . . . . . . . . . 96Removing a volume from a consistency group. . . 97Renaming a consistency group . . . . . . . . 98Suspending I/O execution on a consistency group 99Resuming I/O execution . . . . . . . . . 101Listing the status of consistency groups withpaused I/O . . . . . . . . . . . . . . 102Creating a cross-system consistency group. . . . 103Associating an existing consistency group with across-system consistency group definition . . . . 104Removing a consistency group from a cross-systemconsistency group . . . . . . . . . . . . 105
© Copyright IBM Corp. 2016 iii
Adding a remote system name to a cross-systemconsistency group definition . . . . . . . . 106Removing a remote system from a cross-systemconsistency group . . . . . . . . . . . . 107Listing cross-system consistency group definitions 108Retrieving remote systems in a specifiedcross-system consistency group . . . . . . . 109Deleting a cross-system consistency group. . . . 110Listing cross-system consistency group definitions 110
Chapter 6. Snapshot set managementcommands . . . . . . . . . . . . 113Snapshotting a consistency group. . . . . . . 113Changing a snapshot group deletion priority . . . 116Deleting a snapshot group . . . . . . . . . 117Disbanding a snapshot group . . . . . . . . 118Duplicating a snapshot group . . . . . . . . 119Formatting a snapshot group . . . . . . . . 121Listing snapshot groups . . . . . . . . . . 122Locking a snapshot group . . . . . . . . . 123Renaming a snapshot group . . . . . . . . 124Restoring a consistency group from a snapshotgroup . . . . . . . . . . . . . . . . 125Unlocking a snapshot group . . . . . . . . 127Setting a snapshot group descriptor . . . . . . 128Returning a snapshot group's descriptor . . . . 129
Chapter 7. Storage pool managementcommands . . . . . . . . . . . . 131Moving a consistency group between storage pools 131Changing the pool limitation, performance class, orthreshold parameters . . . . . . . . . . . 133Changing pool settings for snapshots . . . . . 135Creating storage pools . . . . . . . . . . 136Deleting a storage pool . . . . . . . . . . 138Listing storage pools . . . . . . . . . . . 139Renaming a storage pool . . . . . . . . . 141Resizing a storage pool . . . . . . . . . . 142Moving a volume between storage pools . . . . 143
Chapter 8. System managementcommands . . . . . . . . . . . . 147Displaying the values of configuration parameters 147Setting configuration parameters . . . . . . . 148Testing the DNS . . . . . . . . . . . . 150Displaying help . . . . . . . . . . . . 151Displaying the current maintenance urgency . . . 152Shutting down the system . . . . . . . . . 152Listing the operational state . . . . . . . . 154Displaying system usage and data reductionstatistics . . . . . . . . . . . . . . . 154Displaying information about effective andphysical capacity . . . . . . . . . . . . 155Displaying information about effective capacity 157Displaying system capacity thresholds . . . . . 157Changing a system capacity threshold . . . . . 159Resuming the system's normal operation . . . . 160Displaying the current time . . . . . . . . 161Setting the system's time . . . . . . . . . 161Listing optional time zones . . . . . . . . . 162
Setting the time zone . . . . . . . . . . . 163Printing the current system version . . . . . . 164Displaying the values of VPD parameters . . . . 164Setting VPD parameters . . . . . . . . . . 165Displaying the system's MIB file . . . . . . . 167Retrieving the electronic license acceptance status 168Retrieving a fragment of the electronic license file 169Accepting the electronic license agreement . . . 170Enabling command auditing . . . . . . . . 170Disabling command auditing . . . . . . . . 171Displaying the command audit state. . . . . . 172Configuring audit servers . . . . . . . . . 172Checking the command audit state . . . . . . 173Retrieving the list of Flash VDisks . . . . . . 174Enabling CIM service. . . . . . . . . . . 175Disabling the CIM service . . . . . . . . . 175Displaying the CIM service state . . . . . . . 176
Chapter 9. Remote target connectivitycommands . . . . . . . . . . . . 177Setting the threshold of a link disruption durationthat triggers an event. . . . . . . . . . . 177Updating the target's mirroring configuration . . 178Activating connectivity to a remote target . . . . 179Deactivating connectivity to a remote target . . . 180Defining connectivity to a remote target . . . . 181Deleting connectivity to a remote target . . . . 183Listing target connectivity definitions . . . . . 184Defining a remote target. . . . . . . . . . 185Deleting a remote target . . . . . . . . . . 187Listing remote targets . . . . . . . . . . 187Activating a port . . . . . . . . . . . . 188Adding a new port to a remote target . . . . . 189Deactivating a port . . . . . . . . . . . 190Deleting a port from a remote system . . . . . 192Listing the ports of a remote target . . . . . . 193Renaming a remote target . . . . . . . . . 193Updating the target configuration . . . . . . 194
Chapter 10. Data migration commands 197Activating data migration . . . . . . . . . 197Deactivating data migration . . . . . . . . 198Defining data migration configuration . . . . . 199Deleting the data migration process . . . . . . 201Listing data migration statuses . . . . . . . 202Testing the data migration definition . . . . . 203
Chapter 11. Event handlingcommands . . . . . . . . . . . . 205Generating a custom event . . . . . . . . . 205Generating a CSS product event . . . . . . . 205Defining a new event notification destination. . . 206Deleting a destination . . . . . . . . . . 210Listing event notification destinations . . . . . 211Renaming a destination . . . . . . . . . . 212Testing a destination . . . . . . . . . . . 213Updating an event notification destination . . . 215Adding a destination to a destination group . . . 218Creating a destination group . . . . . . . . 219Updating an event notification destination group 220
iv IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Deleting a destination group . . . . . . . . 221Listing destination groups . . . . . . . . . 222Removing a destination from a destination group 223Renaming a destination group. . . . . . . . 224Clearing alerting events . . . . . . . . . . 225Listing events . . . . . . . . . . . . . 226Listing uncleared alerting events . . . . . . . 228Setting the threshold for event notification . . . 229Listing thresholds . . . . . . . . . . . . 230Activating a rule . . . . . . . . . . . . 231Creating event notification rules . . . . . . . 232Deactivating a rule . . . . . . . . . . . 235Deleting event notification rules . . . . . . . 236Listing event notification rules. . . . . . . . 237Renaming event notification rules . . . . . . 238Updating an event notification rule . . . . . . 239Defining an SMS gateway . . . . . . . . . 241Deleting an SMS gateway . . . . . . . . . 243Listing SMS gateways . . . . . . . . . . 244Prioritizing SMS gateways . . . . . . . . . 245Renaming an SMS gateway. . . . . . . . . 246Updating an SMS gateway . . . . . . . . . 247Defining a new SMTP gateway . . . . . . . 249Deleting an SMTP gateway . . . . . . . . . 250Listing SMTP gateways . . . . . . . . . . 251Prioritizing SMTP gateways . . . . . . . . 252Renaming an SMTP gateway . . . . . . . . 253Updating an SMTP gateway . . . . . . . . 254Generating an XMPNS user control event . . . . 255Generating an XMPNS admin control event . . . 256
Chapter 12. IP configurationcommands . . . . . . . . . . . . 259Creating a new IP interface . . . . . . . . . 259Deleting IP interfaces . . . . . . . . . . . 260Listing IP interface configuration . . . . . . . 261Listing IP interface addresses . . . . . . . . 263Showing the status and configuration of Ethernetports . . . . . . . . . . . . . . . . 264Renaming an IP interface . . . . . . . . . 266Printing the ARP database of an IP interface . . . 267Testing the traceroute to a remote IP . . . . . 267Testing the traceroute to a remote IP . . . . . 268Updating an IP interface. . . . . . . . . . 269Defining a new IPSec connection . . . . . . . 272Updating an existing IPSec connection . . . . . 273Removing an existing IPSec connection. . . . . 275Listing IPSec connections . . . . . . . . . 276Listing IPSec tunnels . . . . . . . . . . . 276Defining a support center connection on restart 277Connecting to a support center . . . . . . . 278Defining a support center . . . . . . . . . 280Deleting a support center . . . . . . . . . 281Disconnecting from a support center . . . . . 282Listing support centers . . . . . . . . . . 282Listing the configuration of support centerconnect-on-restart . . . . . . . . . . . . 283Listing the status of all support centers . . . . . 283Creating a new IP access group . . . . . . . 284Removing an address from an IP access group . . 285Adding a new address to an IP access group . . . 286
Deleting an existing IP access group. . . . . . 287Renaming an existing IP access group . . . . . 288Listing IP access groups . . . . . . . . . . 288Listing IP access groups . . . . . . . . . . 289
Chapter 13. PKI configurationcommands . . . . . . . . . . . . 291Listing PKI items . . . . . . . . . . . . 291Generating a certificate signing request . . . . . 292Generating a private key and CSR . . . . . . 293Deleting the PKI content . . . . . . . . . 294Changing a PKI symbolic name . . . . . . . 294Importing a signed certificate . . . . . . . . 295Importing a PKCS#12 certificate . . . . . . . 297Displaying the details of a signed certificate . . . 298Updating a PKI certificate or services . . . . . 299
Chapter 14. InfiniBand commands . . 301Listing the configured InfiniBand ports . . . . . 301Listing data counters for the enabled InfiniBandHCA ports . . . . . . . . . . . . . . 302Listing error counters for the enabled InfiniBandHCA ports. . . . . . . . . . . . . . . 303Listing the statuses of the enabled InfiniBand HCAports . . . . . . . . . . . . . . . . 304Listing the configured InfiniBand switches . . . 305Listing the configured InfiniBand switchmanagement addresses . . . . . . . . . . 307Listing the configured InfiniBand switch firmwareversions . . . . . . . . . . . . . . . 308Listing the configured InfiniBand switch powervalues . . . . . . . . . . . . . . . . 309Listing the configured InfiniBand switch voltagevalues . . . . . . . . . . . . . . . . 310Listing the configured InfiniBand switchtemperature values . . . . . . . . . . . 312Listing the configured InfiniBand switch fan parts 313Listing the configured InfiniBand switch PSUs . . 314Listing the configured InfiniBand switch BBUs . . 315Listing the configured InfiniBand switch fans. . . 317
Chapter 15. Access controlcommands . . . . . . . . . . . . 319Adding an access control definition . . . . . . 319Deleting an access control definition. . . . . . 320Listing access control definitions . . . . . . . 321Adding an LDAP server definition . . . . . . 322Testing an LDAP configuration . . . . . . . 324Listing LDAP configuration parameters . . . . 325Configuring LDAP in the system . . . . . . . 326Listing LDAP servers defined in the system . . . 330Listing LDAP server users . . . . . . . . . 331Listing LDAP-based authentication mode . . . . 333Enabling or disabling LDAP-based authenticationmode . . . . . . . . . . . . . . . . 333Updating an LDAP server definition . . . . . 334Removing an LDAP server definition . . . . . 336Launching the ldapsearch utility . . . . . . . 337Defining a new user . . . . . . . . . . . 339Deleting a user . . . . . . . . . . . . . 341
Contents v
Adding users to user groups . . . . . . . . 342Creating user groups . . . . . . . . . . . 343Deleting a user group . . . . . . . . . . 345Listing user groups . . . . . . . . . . . 346Removing a user from a user group . . . . . . 347Renaming user groups . . . . . . . . . . 348Updating a user group . . . . . . . . . . 349Listing users. . . . . . . . . . . . . . 350Renaming users . . . . . . . . . . . . 351Updating a user definition . . . . . . . . . 352Creating a new domain . . . . . . . . . . 355Updating a domain definition . . . . . . . . 357Renaming a domain . . . . . . . . . . . 359Deleting a domain. . . . . . . . . . . . 359Listing domains . . . . . . . . . . . . 360Listing users per domain . . . . . . . . . 362Listing objects in domains . . . . . . . . . 363Listing the global domain . . . . . . . . . 364Attaching an object to a domain . . . . . . . 365Disassociating object from a domain. . . . . . 367Associating users to a domain . . . . . . . . 369Removing a user from a domain . . . . . . . 370Adding a pool to a domain. . . . . . . . . 371Removing a pool from a domain . . . . . . . 372Moving a pool from one domain to another . . . 374Setting the domain attribute . . . . . . . . 375Setting domain-related policies . . . . . . . 376Displaying domain-related policies . . . . . . 377Specifying a user associated with IBM Hyper-ScaleManager . . . . . . . . . . . . . . . 378Retrieving the user associated with the IBMHyper-Scale Manager. . . . . . . . . . . 379Setting the application administrator's scope ofcommands . . . . . . . . . . . . . . 379Getting the application administrator's scope ofcommands . . . . . . . . . . . . . . 380
Chapter 16. Fibre channel and iSCSIconfiguration and status commands . 383Discovering FC hosts . . . . . . . . . . . 383Changing FC port configuration . . . . . . . 384Listing FC ports . . . . . . . . . . . . 385Listing connectivity to hosts . . . . . . . . 387Displaying the InfiniBand connectivity status. . . 389
Chapter 17. Flash enclosure and flashcanister maintenance commands . . . 391Listing Flash enclosure status . . . . . . . . 391Listing Flash enclosure statuses . . . . . . . 392Listing a Flash canister status . . . . . . . . 393Listing a Flash card status . . . . . . . . . 395Retrieving the list of Flash fans . . . . . . . 396Retrieving the list of Flash IB adapters . . . . . 397Retrieving the Flash control connectivity list . . . 398Retrieving the list of Flash PSUs . . . . . . . 399Retrieving the list of Flash PIBs . . . . . . . 400Retrieving the list of Flash LED cards . . . . . 401Listing Flash BBU components . . . . . . . 402Retrieving the serial number of a Flash enclosure1S . . . . . . . . . . . . . . . . . 403
Chapter 18. Hardware maintenancecommands . . . . . . . . . . . . 405Monitoring the rebuilding or redistributionprocesses . . . . . . . . . . . . . . . 405Displaying the system's average powerconsumption . . . . . . . . . . . . . 406Displaying the system's average temperature . . . 406Enabling XIV Support access . . . . . . . . 407Disabling XIV Support access . . . . . . . . 408Displaying the XIV Support window . . . . . 409Listing system components . . . . . . . . . 409Listing module configuration . . . . . . . . 412Listing the internal temperature of modules . . . 414Listing boot media devices in the system . . . . 415Listing vault devices in the system . . . . . . 417Listing BBUs in the system . . . . . . . . . 419Listing PSUs in a module . . . . . . . . . 422Listing compression adapters in the system . . . 423Listing fans in a module. . . . . . . . . . 424Listing NICs in the system . . . . . . . . . 426Listing DIMMs in the system . . . . . . . . 428Listing CPUs in the system . . . . . . . . . 433Listing InfiniBand host card adapters in the storagesystem . . . . . . . . . . . . . . . 434Listing CNA adapters in the system . . . . . . 436Listing service statuses . . . . . . . . . . 437Listing system components that require service . . 438Listing trace snapshot on a module . . . . . . 439Creating a trace snapshot . . . . . . . . . 440
Chapter 19. Statistics commands . . . 443Getting performance statistics . . . . . . . . 443Retrieving usage history. . . . . . . . . . 447
Chapter 20. Metadata commands . . . 449Setting metadata . . . . . . . . . . . . 449Deleting metadata . . . . . . . . . . . . 450Listing metadata . . . . . . . . . . . . 451Setting user metadata . . . . . . . . . . 452Listing user metadata . . . . . . . . . . 453Deleting user metadata . . . . . . . . . . 454
Chapter 21. Encryption enablementand support commands . . . . . . . 455Disabling encryption . . . . . . . . . . . 455Enabling encryption . . . . . . . . . . . 456Defining a keyserver . . . . . . . . . . . 458Removing a keyserver . . . . . . . . . . 460Displaying keyserver status . . . . . . . . 461Checking keyserver status . . . . . . . . . 462Obtaining a new master key . . . . . . . . 463Renaming a keyserver . . . . . . . . . . 464Changing keyserver properties . . . . . . . 465Entering a recovery key . . . . . . . . . . 467Generating recovery keys . . . . . . . . . 469Retrieving the security administrator's recovery key 471Rekeying the security administrators . . . . . 472Displaying recovery key status . . . . . . . 474Recovering key verification . . . . . . . . . 475Recovering key share information . . . . . . 476
vi IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Finishing the recovery process. . . . . . . . 477
Chapter 22. Events . . . . . . . . . 479
Chapter 23. Return codes . . . . . . 563
Notices . . . . . . . . . . . . . . 565Trademarks . . . . . . . . . . . . . . 567
Contents vii
viii IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
About this guide
This guide describes the command-line interface (CLI) commands for IBM®
FlashSystem A9000.
Intended audienceThis document serves as a reference for system administrators and all IT staff whomanage the IBM FlashSystem® A9000 system from the CLI. This document is also areference for programmers who want to automate storage system commands.
Conventions used in this guideCommand examples and output examples are documented in monospaced font,with a frame around it.
For example:v Command:
vol_rename vol=DBVolume new_name=DBVolume1
v Output:
Command completed successfully.
Access control refers to the types of user accounts that are allowed to use aspecific command.
Return codes are the possible codes that the system can return after a specificcommand is issued and completed either successfully or with an error.
Related information and publicationsYou can find additional information and publications related to IBM FlashSystemA9000 on the following information sources:v IBM FlashSystem A9000 on IBM Knowledge Center (ibm.com/support/
knowledgecenter/STJKMM) – on which you can find the following relatedpublications:– IBM FlashSystem A9000 – Release Notes– IBM FlashSystem A9000 – Product Overview– IBM FlashSystem A9000 – Planning Guide– IBM FlashSystem A9000 and IBM FlashSystem A9000R – Application
Programming Interface (API) Reference Guidev IBM Flash Storage and Solutions marketing website(ibm.com/systems/storage/
flash)v IBM Storage Redbooks® website (redbooks.ibm.com/portals/storage)
© Copyright IBM Corp. 2016 ix
IBM Publications CenterThe IBM Publications Center is a worldwide central repository for IBM productpublications and marketing material.
The IBM Publications Center website (ibm.com/shop/publications/order) offerscustomized search functions to help you find the publications that you need. Youcan view or download publications at no charge.
Sending or posting your commentsYour feedback is important in helping to provide the most accurate and highestquality information.
Procedure
To submit any comments about this guide:v Go to IBM FlashSystem A9000 on IBM Knowledge Center (http://
www.ibm.com/support/knowledgecenter/STJKMM), drill down to the relevantpage, and then click the Feedback link that is located at the bottom of the page.
The feedback form is displayed and you can use it to enter and submit yourcomments privately.
v You can post a public comment on the Knowledge Center page that you areviewing, by clicking Add Comment. For this option, you must first log in toIBM Knowledge Center with your IBM ID.
v You can send your comments by email to [email protected]. Be sure toinclude the following information:– Exact publication title and product version– Publication form number (for example: SC01-0001-01)– Page, table, or illustration numbers that you are commenting on– A detailed description of any information that should be changed
Note: When you send information to IBM, you grant IBM a nonexclusive rightto use or distribute the information in any way it believes appropriate withoutincurring any obligation to you.
Getting information, help, and serviceIf you need help, service, technical assistance, or want more information about IBMproducts, you can find various sources to assist you. You can view the followingwebsites to get information about IBM products and services and to find the latesttechnical information and support.v IBM website (ibm.com®)
x IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v IBM Support Portal website (www.ibm.com/storage/support)v IBM Directory of Worldwide Contacts website (www.ibm.com/planetwide)v IBM developerWorks Answers website (www.developer.ibm.com/answers)v IBM service requests and PMRs (ibm.com/support/servicerequest/Home.action)
About this guide xi
xii IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 1. Overview of the command-line interface (CLI)
The command-line interface (CLI) provides a mechanism for issuing commands tomanage and maintain the storage system. CLI commands are entered on the IBMXCLI utility.
This section explains how to install and start the XCLI utility. It also providesinformation about interactive and basic modes for running commands in the utilityand an overview of the CLI command structure and parameters.
The following topics are covered:v “Overview of the XCLI utility”v “Using the CLI” on page 3
Overview of the XCLI utilityThis section describes how to download, install, and start the IBM XCLI utility. Italso explains how to log off the XCLI.
The following topics are covered:v “Installing and starting the XCLI”v “Exiting an interactive XCLI session” on page 3
Installing and starting the XCLIThis information describes how to download and install the IBM XCLI utility. TheXCLI is available on Microsoft Windows, Linux and other operating systems.
About this task
Note: For the installation requirements and a list of available packages, see theIBM Hyper-Scale Manager Release Notes on the IBM Knowledge Center website.
Procedure
Perform these steps to download and install the XCLI:1. Download the IBM Hyper-Scale Manager installation package from the IBM Fix
Central website.2. Perform one of the following procedures for your operating system.v Windows: Double-click the installation file, and follow the instructions on
the screen.v Linux: Extract the installation file to a designated folder on your system,
using the following command:tar -xzf file_name.tar
v AIX®, HP-UX, Solaris: Extract the installation file using the followingcommand:gunzip file_name.tar.gz
Then extract the file to a designated folder on your system, using thefollowing command:tar -xvf file_name.tar
© Copyright IBM Corp. 2016 1
3. Start the XCLI depending on the hosting operating system and operationalmode.
Starting the XCLI on a Windows systemYou can start the XCLI on a Windows system in either interactive or basic mode.
Interactive mode:About this task
To run commands in interactive mode, perform the following steps:
Procedure
1. Click Start > Programs > IBM XIV > XCLI to open an XCLI session window.2. Follow the instructions on the screen and type the following information:
a. Storage system IP address or DNSb. User namec. Password
3. You are now connected to the specified storage system. The XCLI promptappears in the session window. The window title includes the name of thestorage system to which the XCLI is connected.
4. Run any CLI command from this prompt.
Basic mode:About this task
To run commands in basic mode, perform the following steps:
Procedure
1. Open a Windows command session.2. Type cd c:\program files\IBM\Storage\XIV.3. Run any CLI command, including the XCLI identification parameters, for
example:
Figure 1. XCLI terminal
2 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
xcli -u user -p ******** -m 127.0.0.1 vol_list
Starting the XCLI on a Linux systemYou can start the XCLI on a Linux system in either interactive or basic mode.
Interactive mode:About this task
To run commands in interactive mode, perform the following steps:
Procedure
1. Type xcli -w to open a new session.2. Follow the instructions on the screen and type the following information:
a. User nameb. Passwordc. Storage system IP address or DNS
3. You are now connected to the specified storage system. The XCLI promptappears in the session window. You can run any CLI command from thisprompt.
Basic mode:About this task
To run commands in basic mode, enter the command including the XCLIidentification parameters, for example:
xcli -u user -p ******** -m 127.0.0.1 vol_list
Exiting an interactive XCLI sessionWhen running XCLI in interactive mode, you can exit the interactive session byeither closing the session window or running the exit command.
Using the CLIThis section provides information about interactive and basic modes for runningCLI commands and an overview of the CLI command structure and parameters.
The following topics are covered:v “Interactive and basic modes”v “Understanding the command syntax” on page 5v “Using identification parameters” on page 7v “Display options” on page 10v “Running commands in batch mode” on page 13v “Displaying CLI help and the XCLI utility version” on page 14
Interactive and basic modesYou can use the CLI in two modes: interactive and basic.
The differences between these two modes are as follows:
Chapter 1. Overview of the command-line interface (CLI) 3
v Basic mode requires you to log in to the storage system each time you issue acommand, but the interactive mode requires you to log in only once.
v In basic mode, you must enter the entire command syntax. In interactive mode,you can enter a shorter syntax.
v Interactive mode offers several command and argument completion features.
The following example shows the command syntax for each of these modes:
Basic
xcli -u user -p password -m 127.0.0.1 vol_list
Interactive
vol_list
Note: Each of the batch-mode parameters in these examples is explained later inthis chapter.
Interactive mode featuresRunning CLI commands in interactive mode provides command and argumentcompletion, along with possible values to these arguments.
About this task
The CLI offers several ways to interactively complete command names.
Procedure1. To complete the name of a command, type one or more characters and press
Tab. In the following example, the CLI adds a character to the name of acommand that starts with vol. The first click on Tab adds a character.
>>vol>>vol_
2. Next, to list commands, type one or more characters and press Tab twice(Tab-Tab).
>>vol_vol_by_id vol_copy vol_create vol_deletevol_format vol_list vol_lock vol_mapping_listvol_move vol_rename vol_resize vol_unlock
Examplev This example lists all commands that start with the letter v:
>> vversion_get vol_by_id vol_copy vol_createvol_delete vol_format vol_list vol_lockvol_mapping_list vol_move vol_rename vol_resizevol_unlock vpd_config_get vpd_config_set
v This example lists all commands that start with the letters cg_:
4 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
>> cg_cg_add_vol cg_create cg_delete cg_listcg_move cg_remove_vol cg_rename cg_snapshots_create
Command Argument Completion:
The CLI can provide list arguments and argument values to help you complete acommand.
About this task
To list arguments for a specific command, type the command name and press Tab.To list values for a specific argument, type the command name and argument,optionally specify one or more characters for the value, and then press Tab.
Procedure
1. Listing arguments for a command. This example lists arguments for thevol_create command:
>> vol_createvol= size= size_block= pool=
2. Listing values for a specific argument. This example lists valid values for thepool argument that is required for the pool_create command:
>> pool_create pool=8058 2nd Pool 8059 pool1
3. Listing a subset of values for a specific argument. This example lists validvalues that start with v for the vol argument that is required for the vol_listcommand:
>> vol_list vol=vvol1 vol2
Understanding the command syntaxThis information describes the general syntax for a CLI command in basic mode.
When in basic mode, the CLI uses the following general syntax:
xcli < <[ --file=FILE ] -c CONFIG|-m IP1 [-m IP2 [-m IP3]] >-L|-a <config> -m IP1 [-m IP2 [ -m IP3]]|-d IP1 [-m IP2 [ -m IP3]] >|[ -r ][ <-l | --list> | <-s | --csv> | <-x | --xml> ][ <-u | --user> user ][ <-p | --password> password ][-t [--fields=field1,field2,...]][command]
Command syntax quick referenceThis information describes the command parameters and options that are availablein the CLI basic mode.
Use the following table as a quick reference to the various parameters and options.
Chapter 1. Overview of the command-line interface (CLI) 5
Options Values
-f Specifies the name of a configuration file that lists the storage system
-c Specifies the storage system on which the command is to be run
-m Specifies the IP address of the storage system on which the command runs
-L Lists the storage systems, as read from the configuration file
-a Specifies the name of the storage system
-d Removes a storage system from the configuration file
-r Specifies the name of a batch file that runs CLI commands
-l Displays the command output in user-readable format
-s Displays the command output in CSV format
-x Displays the command output in XML format
-u Specifies the user
-p Specifies the password
-t Manages the fields of the command output
-h Displays command help
-y Suppresses the Are you sure? prompt
-v Displays the version of the XCLI on the screen
command Runs the specified command
Syntax exampleThe CLI command syntax specifies the command to be run, along with itsapplicable parameters and their values.
In the following example, the parameters to the left of the vol_list commandspecify the storage system to which the command is being directed, and alsospecify the required user and password for this storage system:
xcli -u admin -p ********** -m 127.0.0.1 vol_list
Identification parameters
-u Specifies the user ID.
-p Specifies the password.
Storage systemThe storage system is specified by either its IP address or name of thestorage system as listed in the configuration file. See “Configurationparameters” on page 8 for more information.
-m Specifies the IP address of the storage system to which this commandis directed.
-c Specifies the name of the storage system to which this command isdirected, as it is defined in the configuration file (for example,my_system).
Command
vol_listSpecifies the command to be run. For more information about runningcommands, see “Interactive mode features” on page 4.
6 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Using identification parametersThis information describes the parameters used to set the user, password, andstorage system.
The following topics are covered:v “Setting user and password parameters”v “Identifying and configuring a storage system”
Setting user and password parametersThe CLI and the storage system provide a password-controlled user ID as asecurity mechanism for controlling CLI operations.
When running in basic mode, specify the user name and password as follows:
xcli -u admin -p ********** -c my_system vol_list
In this command:
Identification parameters
-u Specifies the user ID.
-p Specifies the password.
my_system
-c Specifies the name of the storage system to which this command isdirected, as it is defined in the configuration file (for example,my_system).
Command
vol_listSpecifies the command to be run.
The password handling mechanism performs as follows:1. Checking the user:v The -u or --user parameter on the command line is checked first and its
value is used as the user name.v If the -u or --user parameter is not specified, the XIV_XCLIUSER environment
variable is used as a user name.2. Checking the password:v The -p or --password parameter on the command line is checked first and its
value is used as the password.v If the -p or --password parameter is not specified, the XIV_XCLIPASSWORD
environment variable is used as the password.
Note: If you do not specify both the user ID and the password, the command fails.
Identifying and configuring a storage systemThis information describes the parameters used to identify the storage system onwhich a command is to run, and how to create a configuration file to manage thestorage systems that you can use.
Chapter 1. Overview of the command-line interface (CLI) 7
Configuration parameters:
Most CLI commands are directed to a specific storage system using the IP address.You must provide at least one address and up to three addresses per storagesystem.
To provide the storage system IP address, log in to an interactive session or specifythe configuration file that stores the storage system IP address or addresses.
Specifying a storage system using its IP addressIn the following example, the command is directed to a storage systemwith an IP address of 127.0.0.1:
xcli -u admin -p ********** -m 127.0.0.1 vol_list
In this command:
Identification parameters
-u Specifies the user ID.
-p Specifies the password.
Storage systemThe storage system is specified by its IP address.
-m Specifies the IP address of the storage system to which thiscommand is directed.
Command
vol_listSpecifies the command to be run.
Specifying a storage system by using a configuration fileIn the following example, the command is directed to a storage system thatis listed on the my_system configuration file:
xcli -u admin -p ********** -c my_system vol_list
In this command:
Identification parameters
-u Specifies the user ID.
-p Specifies the password.
Storage systemThe storage system is specified by its name on the configurationfile.
-c Specifies the name of the storage system to which thiscommand is directed, as it is defined in the configuration file(for example, my_system).
Command
vol_listSpecifies the command to be run.
8 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Creating a configuration file:
You can use the configuration file to manage a list of the storage systems that youare working with.
Use the following options to add and subtract storage systems from this file and tolist them.
Listing the available storage systemsIn the following example, the configuration information is read from adefault file location or from the file that is specified with [-f file].
xcli [-f file] -L
Adding a new storage system to the configuration fileIn the following example, IP1...IP3 are added to the configuration file atthe default file location. If applicable, the addresses are added to the filethat is specified in [-f file]. The <config> variable represents theconfiguration name of the storage system that you are adding to the list.
xcli [-f file] -a <config> -m IP1 [-m IP2 [ -m IP3]]
Removing a storage system from the configuration fileIn the following example, IP1...IP3 are removed from the configuration file.If applicable, the addresses are removed from the file that is specified with[-f file].
xcli [-f file] -d IP1 [-m IP2 [ -m IP3]]
Location of the configuration file
The configuration file is located in the following directory, depending on theoperating system. You do not specify the location of the configuration file whenyou add or remove storage systems from the configuration.
Windows\Application Data\XIV\GUI12\properties
UNIX In the home folder under .xiv
Certificate managementThis section describes the way certificates are managed via the XCLI utility.
The general format of the certificate commands is:
xcli -C <command> [ <p1>=<v1> [<p2>=<v2>]...]
The available commands are: list, show, import and remove.
List [ type=<type> ]
This command lists the trusted certificates (global and private). This commandaccepts the type of list as a parameter.
Type = all (default)Lists all trusted certificates.
Chapter 1. Overview of the command-line interface (CLI) 9
For example:
xcli -C list
PrivateLists all private trusted certificates.
For example:
xcli -C list type=private
GlobalLists all global trusted certificates.
Show alias=<alias>
This command displays the certificate details. This command accepts the name ofthe specific certificate as a parameter. For example:
xcli -C show alias=abcd
Import pem=<pem_file_path> [ alias=<alias> ]
This command imports a certificate (in PEM format) into the list of trustedcertificates. This command accepts the location of the certificate as a mandatoryparameter and the name into which the certificate will be renamed. For example:
xcli -C import pem=C:\abc\def\cert.pemxcli -C import alias=abcd pem=C:\abc\def\cert.pem
Remove alias=<alias>
This command removes a certificate from the list. For example:
xcli -C remove alias=abcd
Display optionsThis information describes the formats that you can choose to display thecommand output.
The following topics are covered:v “Using display options”v “Table display options” on page 11
Using display optionsOutput from an CLI command can be displayed in a list, comma-separated value(CSV) and XML formats. You can specify only one format. If you do not specifythe format, the output defaults to a list.
The display options are:
-l Displays command output in a list (also known as user-readable format).
-s Displays command output in CSV format.
10 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
-x Displays command output in XML format.
Use the display options as follows:
Interactive mode
vol_list -s
Basic mode
xcli -u user -p ********** -m 127.0.0.1 -s vol_list
In this command:
Identification parameters
-u Specifies the user ID.
-p Specifies the password.
Storage systemThe storage system is specified by either its IP address or name ofthe storage system as listed in the configuration file. See“Configuration parameters” on page 8 for more information.
-m Specifies the IP address of the storage system to which thiscommand is directed.
-c Specifies the name of the storage system to which thiscommand is directed, as it is defined in the configuration file(for example, my_system).
Display option
-s Displays command output in CSV format.
Command
vol_listSpecifies the command to be run. For more information aboutrunning commands, see “Interactive mode features” on page 4.
Table display optionsThe list option displays the command output in a user-readable format. Whenrunning a command with a list option, you can specify which table columns aredisplayed on the screen.
Determine the way that the table is displayed as follows:
Interactive mode
vol_list -t "size"
Single-command mode
xcli -u admin -p ********** -m 127.0.0.1 vol_list -t "size"
In this command:
Identification parameters
-u Specifies the user ID.
Chapter 1. Overview of the command-line interface (CLI) 11
-p Specifies the password.
Storage systemThe storage system is specified by either its IP address or name ofthe storage system as listed in the configuration file. See“Configuration parameters” on page 8 for more information.
-m Specifies the IP address of the storage system to which thiscommand is directed.
-c Specifies the name of the storage system to which thiscommand is directed, as it is defined in the configuration file(for example, my_system).
Table display option
-t "size"Specifies the one or more columns that are to be displayed. In thisexample, only the Size column is displayed. You can list anycombination of the table columns.
Command
vol_listSpecifies the command to be run. For more information about runningcommands, see “Interactive mode features” on page 4.
Viewing the available columns
You can view all of the available table's columns by running: helpcommand=<command_name> format=full.
The result provides information about the command, including a list of all of itsfields. For example, the available fields for the vol_list command are:v name
v size
v master_name
v cg_name
v pool_name
v creator
v used_capacity
v used_capacity_MiB
v snapshot_time_on_master
v serial
v wwn
v capacity
v mirrored
v sg_name
v snapshot_time
v sg_snapshot_of
v locked_by_pool
v size_MiB
v locked
v snapshot_of
12 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v modified
v delete_priority
Running commands in batch modeCLI commands can be grouped together and run in a batch. For example, you canuse batch mode to run an identical set of commands on multiple storage systems.
Creating a batch file for the commands
Create a text file and write the commands without the xcli prefix or CLIparameters. For example:
pool_create pool=pool_00001 hard_size=171 soft_size=171 snapshot_size=65vol_create vol=vol_00010 size=17 pool=pool_00001vol_list vol=vol_00010
This example contains the following commands:v The pool_create command, along with its arguments. This command creates a
storage pool, which is a prerequisite for creating a volume.v The vol_create command, along with its arguments. This command creates a
volume in the pool that has just been created.v The vol_list command displays the details of the newly created volume.
Name the script file and save it.
Running a batch file
To run the batch file, you must specify the CLI parameters:
xcli -u admin -p ********** -m 127.0.0.1 -r"C:\Documents and Settings\avia\xcli\xcli_script.txt"
In this command:
Identification parameters
-u Specifies the user ID.
-p Specifies the password.
Storage systemThe storage system is specified by either its IP address or name of thestorage system as listed in the configuration file. See “Configurationparameters” on page 8 for more information.
-m Specifies the IP address of the storage system to which this commandis directed.
-c Specifies the name of the storage system to which this command isdirected, as it is defined in the configuration file (for example,my_system).
The batch parameter
-r Specifies the name of the batch file to run on the storage system.
Chapter 1. Overview of the command-line interface (CLI) 13
Viewing the output
The three commands in the previous example create a pool, then create a volume,then display the volume details. The following output is returned from runningthese three commands in batch mode:v Confirmation that a pool was createdv Confirmation that a volume was createdv Table with the details of the newly created volume
Failure of batch mode
When one of the commands that run in batch mode fails, the following actionsoccur:1. The script exits immediately.2. No commands after the failing command are run.3. An error message is displayed identifying the CLI command that failed.
Displaying CLI help and the XCLI utility versionThis information describes how to display help for the CLI command and theversion of the XCLI utility.
About this task
The following command displays the help text for the CLI in batch mode:
xcli <-h | --help>
For details about the help command, see “Displaying help” on page 151.
The following command displays the XCLI utility version:
xcli <-v | --version>
14 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 2. Host and cluster management commands
This section describes the command-line interface (CLI) for host and clustermanagement.
Adding a host to a clusterUse the cluster_add_host command to add a host to a cluster.
cluster_add_host cluster=ClusterName host=HostName map=MapName
Parameters
Name Type Description Mandatory
cluster Object name Name of the cluster tocontain the host.
Y
host Object name Host to be added to thecluster.
Y
map Enumeration Defines whether tooverride the clustermapping with the hostmapping or vice versa,or append the clustermapping on top of thehost mapping.
Y
If the host already belongs to another cluster, the command fails. If the hostalready belongs to the specified cluster, the operation completes successfully, buthas no effect.
Using the map parameter:v If map=cluster, the mapping of the host and host type are overridden with the
cluster's mapping and type.v If map=host, the mapping of the cluster and its host type are overridden with the
host's mapping and type. Use this value to add a host to an empty cluster, sothat the cluster will obtain the host’s mapping.
v If map=clusterWithHostExceptions, the host keeps its mapping and the clustermapping is appended on top of it.
The host or cluster receives a single SCSI unit attention message, even if thechange affects multiple volumes.
Example:
cluster_add_host cluster=Cluster1 host=Host1 map=cluster
Output:
Command completed successfully.
© Copyright IBM Corp. 2016 15
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv HOST_BAD_NAME
Host name does not existv CLUSTER_BAD_NAME
Cluster name does not existv HOST_BELONGS_TO_ANOTHER_CLUSTER
Host already belongs to another clusterv HOST_AND_CLUSTER_HAVE_CONFLICTING_MAPPINGS
Host mapping conflicts with cluster mappingv HOST_AND_CLUSTER_HAVE_DIFFERENT_MAPPING_TYPE
Host mapping type is not the same as the cluster mapping typev HOST_NOT_IN_CLUSTERS_DOMAINS
The host is not part of all of the domains the cluster is attached to.
Creating a clusterUse the cluster_create command to create a new cluster.
cluster_create cluster=ClusterName [ domain=DomainList ]
Parameters
Name Type Description Mandatory Default
cluster Object name Name of thecluster to becreated.
Y N/A
domain N/A The cluster will beattached to thespecified domains.To define morethan one domain,separate them witha comma. Toattach the clusterto all existingdomains, use "*".
N none
The newly created cluster does not contain hosts, and has the default type, but nomapping.
Example:
16 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
cluster_create cluster=Cluster1
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CLUSTER_NAME_EXISTS
Cluster name already existsv MAX_CLUSTERS_REACHED
Maximum number of clusters already definedv DOMAIN_DOESNT_EXIST
Domain does not exist.
Deleting clustersUse the cluster_delete command to delete a cluster.
cluster_delete cluster=ClusterName
Parameters
Name Type Description Mandatory
cluster Object name Cluster to be deleted. Y
This command deletes a cluster. All hosts contained in the cluster remain activeand are not deleted. The special type of each host is set to the cluster's specialtype. The mapping of each host is set to the cluster's mapping. No I/Ointerruption is caused by this command.
Example:
cluster_delete cluster=Cluster1
Output:
Command completed successfully.
Chapter 2. Host and cluster management commands 17
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_ASSIGNED_CLUSTER
Cluster Cluster' has hosts in it. Are you sure you want to delete it?
Return codesv CLUSTER_BAD_NAME
Cluster name does not exist
Listing clustersUse the cluster_list command to retrieve information about a specific cluster, orabout all of them.
cluster_list [ cluster=ClusterName ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
cluster Object name Name of cluster tobe listed.
N All clusters.
domain Object name The domain name. N All Domains
The output provides each cluster's special type, and comma-separated lists ofhosts, users, and user groups.
Example:
cluster_list
Output:
Name Hosts Type Creator User Group---------- ------- --------- ----------------- ------------Cluster1 default xiv_maintenance
Field ID Field output Default position
name Name 1
hosts Hosts 2
type Type 3
creator Creator 4
18 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
user_group User Group 5
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Removing a host from a clusterUse the cluster_remove_host command to remove a host from a cluster.
cluster_remove_host cluster=ClusterName host=HostName
Parameters
Name Type Description Mandatory
cluster Object name Cluster name. Y
host Object name Host to be removedfrom cluster.
Y
This command removes the specified host from a cluster. The host then no longerbelongs to any cluster. The host's special type and mapping remain identical to thecluster's special type and mapping, and therefore, I/O is not interrupted. Theassociation of the host with user or user groups remains the same as the cluster'sassociation.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv HOST_BAD_NAME
Host name does not existv CLUSTER_BAD_NAME
Cluster name does not existv HOST_NOT_IN_CLUSTER
Host is not part of specified cluster
Chapter 2. Host and cluster management commands 19
Renaming clustersUse the cluster_rename command to rename a cluster.
cluster_rename cluster=ClusterName new_name=Name
Parameters
Name Type Description Mandatory
cluster Object name Cluster to be renamed. Y
new_name Object name New name of cluster. Y
This command renames the specified cluster.
Example:
cluster_rename cluster=Cluster1 new_name=Cluster2
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CLUSTER_BAD_NAME
Cluster name does not existv CLUSTER_NAME_EXISTS
Cluster name already exists
Adding a port to a hostUse the host_add_port command to add a port address to a host.
host_add_port host=HostName < fcaddress=wwpn | iscsi_name=iSCSIName >
Parameters
Name Type Description Mandatory
host Object name The host name. Y
fcaddress N/A FC address of theadded port.
N
20 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory
iscsi_name iSCSI initiator name iSCSI initiator name ofthe newly added port.
N
The FC port address or iSCSI initiator (port) name assigned to the host must beunique per storage system. The FC port name must be exactly 16 characters long,in hexadecimal format.
Only the following alphanumeric characters are valid: 0-9, A-F, a-f. In addition tothe 16 characters, colons (:) may be used as separators in the 16 character portname. The iSCSI initiator name may not exceed 253 characters and may notcontain any blank spaces.
Example:
host_add_port host=Host1 fcaddress=5001738035C601C0
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv HOST_BAD_NAME
Host name does not existv HOST_PORT_EXISTS
Host with this port ID already definedv ISCSI_HOST_ILLEGAL_PORT_NAME
Port name for iSCSI Host is illegalTroubleshooting: Port names for iSCSI Hosts must contain only printablecharacters.
v MAX_PORTS_REACHED
Maximum number of ports already defined in the systemv TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote targetv PORT_EXISTS
Port is already definedv REMOTE_MAX_VIRTUAL_HOSTS_REACHED
Maximum number of remote virtual hosts already defined
Chapter 2. Host and cluster management commands 21
Defining a new hostUse the host_define command to define a new host to connect to the storagesystem.
host_define host=HostName [ cluster=ClusterName ][ iscsi_chap_name=iscsiChapName iscsi_chap_secret=iscsiPass ] [ domain=DomainList ]
Parameters
Name Type Description Mandatory Default
host Object name The name of thehost to be created.
Y N/A
cluster Object name The name of thecluster to containthe newly createdhost.
N No cluster.
iscsi_chap_name String The host's CHAPname identifier.
N none
iscsi_chap_secret String The password ofthe initiator usedto authenticate tothe system whenCHAP is enabled.
N none
domain N/A The domains thecluster will beattached to. Toinclude more thanone domain,separate them witha comma. Toinclude all existingdomains, use anasterisk ("*").
N none
The name of the host must be unique in the system.
Use the host_add_port command to add port addresses to this host (see Adding aport to a host for details). Specifying the cluster is optional.
The parameters iscsi_chap_name and iscsi_chap_secret must be either bothspecified or both unspecified.
If iscsi_chap_secret does not conform to the required secret length (96-128 bits),the command will fail.
The command checks whether the iscsi_chap_name and iscsi_chap secret areunique. In case they are not, an error message is displayed, but the commandcompletes.
The secret has to be between 96 bits and 128 bits. There are 3 ways to enter thesecret:v Base64: Requires to prefix the entry with 0b. Each subsequent character entered
is treated as a 6-bit equivalent lengthv Hex: Requires to prefix the entry with 0x. Each subsequent character entered is
treated as a 4-bit equivalent length
22 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v String: Requires no prefix (cannot be prefixed with 0b or 0x). Each characterentered is treated as a 8 bit equivalent length
Example:
host_define host=server1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ISCSI_CHAP_NAME_AND_SECRET_NOT_UNIQUE
Both iSCSI CHAP name and secret are already used by another host. Are yousure you want to reuse those values?
Return codesv HOST_NAME_EXISTS
Host name already existsv MAX_HOSTS_REACHED
Maximum number of hosts already definedv CLUSTER_BAD_NAME
Cluster name does not existv DOMAIN_DOESNT_EXIST
Domain does not exist.v HOST_NOT_IN_CLUSTERS_DOMAINS
The host is not part of all of the domains the cluster is attached to.
Deleting a hostUse the host_delete command to delete a host.
host_delete host=HostName
Parameters
Name Type Description Mandatory
host Object name The host name. Y
Chapter 2. Host and cluster management commands 23
After this command is executed, the deleted host can no longer connect to thesystem, and I/O requests from this host are not handled.
Example:
host_delete host=mailserver
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_HOST
Are you sure you want to delete host Host?
Return codesv HOST_BAD_NAME
Host name does not exist
Listing hostsUse the host_list command to list a specific host or all hosts.
host_list [ host=HostName ] [ perf_class=perfClassName ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
host Object name The host name. N All hosts.
perf_class Object name The name of aperformance class.
N no filter.
domain Object name The domain name. N All Domains
This command lists all the hosts in the system.
A host name can be specified to list only a specific host or all the hosts.
The list contains the following comma separated information:v Port addressesv Containing cluster, if one exists
24 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v Associated users and user groups
Example:
host_list host=mailserver
Output:
Name Type FC Ports iSCSI Ports User Group Cluster-------- --------- ---------- ------------- ------------ ---------host_4 default iscsi_4host_5 default iscsi_5host_6 default iscsi_6host_7 default iscsi_7host_8 default iscsi_8host_9 default iscsi_9
Field ID Field output Default position
name Name 1
type Type 2
fc_ports FC Ports 3
iscsi_ports iSCSI Ports 4
creator Creator N/A
user_group User Group 5
cluster Cluster 6
perf_class Performance Class 7
iscsi_chap_name iSCSI CHAP Name N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Listing portsUse the host_list_ports command to list all the ports of a host.
host_list_ports host=HostName [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
host Object name The host name. Y N/A
domain Object name The domain name. N All Domains
Example:
Chapter 2. Host and cluster management commands 25
host_list_ports host=tlib_host_pro125_fc0
Output:
Host Type Port name-------- --------- ---------tlib_host_pro125_fc0 FC 100000062B125CD0
Field ID Field output Default position
host Host 1
type Type 2
port_name Port Name 3
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Removing a port from a hostUse the host_remove_port command to remove a port from a host.
host_remove_port host=HostName < fcaddress=wwpn | iscsi_name=iSCSIName >
Parameters
Name Type Description Mandatory
host Object name The host name. Y
fcaddress N/A FC address of the portto be removed.
N
iscsi_name iSCSI initiator name iSCSI initiator name ofthe port to be removed.
N
Example:
xcli.py host_remove_port host=host1 iscsi_name=iscsi1
Output:
Command completed successfully
26 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv HOST_BAD_NAME
Host name does not existv PORT_DOES_NOT_BELONG_TO_HOST
Port ID belongs to another hostv HOST_PORT_DOES_NOT_EXIST
Port ID is not definedv ISCSI_HOST_ILLEGAL_PORT_NAME
Port name for iSCSI Host is illegalTroubleshooting: Port names for iSCSI Hosts must contain only printablecharacters.
v TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote targetv HOST_PORT_EXISTS
Host with this port ID already definedv MAX_PORTS_REACHED
Maximum number of ports already defined in the systemv PORT_EXISTS
Port is already definedv REMOTE_MAX_VIRTUAL_HOSTS_REACHED
Maximum number of remote virtual hosts already defined
Renaming a hostUse the host_rename command to rename a host.
host_rename host=HostName new_name=Name
Parameters
Name Type Description Mandatory
host Object name The original host name. Y
new_name Object name The new host name.Must be unique in thesystem.
Y
The new host name must be unique in the system.
Chapter 2. Host and cluster management commands 27
The command still succeeds even if the new name is identical to the current name.
Example:
host_rename host=server2 new_name=mailserver
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv HOST_BAD_NAME
Host name does not existv HOST_NAME_EXISTS
Host name already exists
Updating a host definitionUse the host_update command to update a host definition.
host_update host=HostName [ iscsi_chap_name=iscsiChapName ] [ iscsi_chap_secret=iscsiPass ]
Parameters
Name Type Description Mandatory Default
host Object name Name thatrepresents the hostto the storagesystem.
Y N/A
iscsi_chap_name String The host's CHAPname identifier
N [unchanged]
iscsi_chap_secret String The password ofthe initiator usedto authenticate tothe storage systemwhen CHAP isenabled
N [unchanged]
The command carries out the following CHAP-related checks:v The parameters iscsi_chap_name and iscsi_chap_secret must be either both
specified or both unspecified.
28 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
These parameters have to be unique. In case they are not, an error message isdisplayed, but the command completes.
v The secret needs to be between 96 bits and 128 bits. There are 3 ways to enterthe secret:– Base64: Requires to prefix the entry with 0b. Each subsequent character
entered is treated as a 6-bit equivalent length– Hex: Requires to prefix the entry with 0x. Each subsequent character entered
is treated as a 4-bit equivalent length– String: Requires no prefix (cannot be prefixed with 0b or 0x). Each character
entered is treated as an 8-bit equivalent lengthv If iscsi_chap_secret does not conform with the required secret length (96-128
bits), the command fails.
Changing the iscsi_chap_name and/or iscsi_chap_secret:v A warning message will be displayed stating that the changes will apply only
next time the host is connected.
Example:
host_update host iscsi_chap_name iscsi_chap_secret
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ISCSI_CHAP_NAME_AND_SECRET_NOT_UNIQUE
Both iSCSI CHAP name and secret are already used by another host. Are yousure you want to reuse those values?
v ISCSI_CHAP_SECRET_NOT_UNIQUE
iSCSI CHAP secret is already used by another host. Are you sure you want toreuse this value?
v ISCSI_CHAP_NAME_NOT_UNIQUE
iSCSI CHAP name is already used by another host. Are you sure you want toreuse this value?
Return codesv HOST_BAD_NAME
Host name does not exist
Chapter 2. Host and cluster management commands 29
v ISCSI_CHAP_NAME_EMPTY
CHAP name should be a non-empty stringv ISCSI_CHAP_NAME_TOO_LONG
CHAP name is too longv ISCSI_CHAP_SECRET_EMPTY
CHAP secret should be a non-empty stringv ISCSI_CHAP_SECRET_BAD_SIZE
CHAP secret should be 12 to 16 bytes longv ISCSI_CHAP_SECRET_BAD_HEX_FORMAT
CHAP secret is an illegal hexadecimal number or wrong size - should be 24 to32 hexadecimal digits
Mapping a volume to a host or clusterUse the map_vol command to map a volume to a host or a cluster.
map_vol <host=HostName | cluster=ClusterName> vol=VolName lun=LUN [ override=<no|yes> ]
Parameters
Name Type Description Mandatory Default
host Object name Host name. N N/A
cluster Object name Cluster name. N N/A
vol Object name Volume name. Y N/A
lun Integer LUN identifier. Y N/A
override Boolean Override theexisting mapping.
N no
This command maps a volume to a host or to a cluster. It maps the volume to allthe hosts that are contained in the cluster.
The command fails if:v The specified host is contained in a cluster, because in this case the mapping
must be done through the cluster.v Another volume is mapped to the same LUN for this cluster/host, and the
override parameter is not specified.– If the override parameter is specified, the mapping is replaced. The host (or
all hosts in the cluster) will see continuous mapping of volume to this LUNwith a different content, and probably size.
v Mapping to a cluster, if the LUN was defined as an exception.– Whenever the LUN is defined as an exception, map it directly to the host.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
30 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission Condition
Application administrator Conditionally Allowed This volume is a snapshot. Themaster volume of this snapshotis mapped to a host or clusterthat is associated with the userexecuting this command. Thissnapshot was created by anapplication administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Warningsv ARE_YOU_SURE_YOU_WANT_TO_PERFORM_HOST_SPECIFIC_MAPPING
'Host' is part of a cluster. Are you sure you want to map this volume only forthat specific host?
v ARE_YOU_SURE_YOU_WANT_TO_MAP_VOLUME
Are you sure you want to map volume Volume, which is already mapped toanother host/cluster?
Return codesv HOST_BAD_NAME
Host name does not existv HOST_BELONGS_TO_CLUSTER
Host is part of a clusterv CLUSTER_BAD_NAME
Cluster name does not existv VOLUME_BAD_NAME
Volume name does not existv SNAPSHOT_IS_INTERNAL
Internal snapshots cannot be mapped, modified or deleted.v VOLUME_ALREADY_ASSIGNED
Mapping conflict: volume is already assignedv LUN_ALREADY_IN_USE
Mapping conflict: LUN is already in usev EXT_LUN_ILLEGAL
LUN is out of range or does not existv VOLUME_HAS_HOST_SPECIFIC_MAPPING
Specified Volume is currently mapped to another LUN in a host-specificmapping
v LUN_HAS_HOST_SPECIFIC_MAPPING
Specified LUN currently has another volume mapped in a host-specific mappingv ISCSI_HOST_ILLEGAL_PORT_NAME
Port name for iSCSI Host is illegalTroubleshooting: Port names for iSCSI Hosts must contain only printablecharacters.
v MAX_PORTS_REACHED
Maximum number of ports already defined in the system
Chapter 2. Host and cluster management commands 31
v HOST_PORT_EXISTS
Host with this port ID already definedv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v REMOTE_MAX_VIRTUAL_HOSTS_REACHED
Maximum number of remote virtual hosts already defined
Listing the mapping of volumes to hosts or clustersUse the mapping_list command to list the mapping of volumes to a specified hostor cluster.
mapping_list [ host=HostName | cluster=ClusterName ] [ domain=DomainList ]
Parameters
Name Type Description Mandatory Default
host Object name Host name. N N/A
cluster Object name Cluster name. N N/A
domain N/A List of hosts,clusters ordomains to showmapping from. Todefine more thanone host, cluster ordomain, separatethem with acomma. To specifyall existingdomains, use "*".
N All user domains.
Field ID Field output Default position
lun LUN 1
volume Volume 2
proxy Proxy 3
size Size 4
master Master 5
wwn WWN 6
locked Locked 7
host Host 8
Example:
mapping_list host=demo__host_1,demo_host_fc10000006072d0190
Output:
32 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
LUN Volume Proxy Size Master----- --------------------------------------------------- ------- ------ ------------------0 vol-2693072-0006 no 1031 vol-2693072-0007 no 1032 cg-2693072-0005.snap_group_00001.vol-2693072-0006 no 103 vol-2693072-00063 cg-2693072-0005.snap_group_00001.vol-2693072-0007 no 103 vol-2693072-00074 vol-2693172-0013 no 1035 vol-2693172-0013.snapshot_00001 no 103 vol-2693172-0013
WWN Locked Host---------------------------------- -------- --------------------------------------60017380000035c7000000000000000a no tlib_host_host081_fc21000024ff2c4cf760017380000035c7000000000000000b no tlib_host_host081_fc21000024ff2c4cf760017380000035c7000000000000000c yes tlib_host_host081_fc21000024ff2c4cf760017380000035c7000000000000000c yes tlib_host_host081_fc21000024ff2c4cf760017380000035c70000000000000011 no tlib_host_host081_fc21000024ff2c4cf760017380000035c70000000000000012 no tlib_host_host081_fc21000024ff2c4cf7
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Return codesv HOST_BAD_NAME
Host name does not existv CLUSTER_BAD_NAME
Cluster name does not existv TOO_MANY_MAPPINGS
There are too many mappings to displayv DOMAIN_DOESNT_EXIST
Domain does not exist.
Setting the special type of hosts or clustersUse the special_type_set command to set the special type of a host or a cluster.
special_type_set <host=HostName | cluster=ClusterName> type=<default|hpux|zvm>
Parameters
Name Type Description Mandatory
host Object name Host name. N
cluster Object name Cluster name. N
type Enumeration Special map type. Y
Chapter 2. Host and cluster management commands 33
The supported special types are hpux and zvm. The type must be specified for hostsor clusters that run on the HP-UX operating system. All other operating systemsdo not require a special type.
Example:
special_type_set host=tlib_host_pro26_fc0 type=zvm
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv HOST_BAD_NAME
Host name does not existv HOST_BELONGS_TO_CLUSTER
Host is part of a clusterv CLUSTER_BAD_NAME
Cluster name does not exist
Listing hosts/clusters to which a volume is mappedUse the vol_mapping_list command to list all hosts and clusters to which avolume is mapped.
vol_mapping_list vol=VolName
Parameters
Name Type Description Mandatory
vol Object name Volume name. Y
This command lists all the hosts and clusters to which a volume is mapped, aswell as hosts that are part of a cluster and have host-specific mapping to thevolume. The output list contains two columns: name of host/cluster and type (hostor cluster).
Field ID Field output Default position
host Host/Cluster 1
type Type 2
34 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
lun LUN 3
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Return codesv VOLUME_BAD_NAME
Volume name does not exist
Unmapping a volume from a host or clusterUse the unmap_vol command to unmap a volume from a host or a cluster.
unmap_vol <host=HostName | cluster=ClusterName> vol=VolName [ idle_seconds=IdleSeconds ]
Parameters
Name Type Description Mandatory Default
host Object name Host name. N N/A
cluster Object name Cluster name. N N/A
vol Object name Volume name. Y N/A
idle_seconds Integer How manyseconds thevolume needs tobe idle beforeunmapping
N -1
The command to unmap from a cluster will unmap the volume from all the hoststhat are contained in that cluster.
The command fails if the specified host is contained in a cluster. In this case, theunmapping of the host must be performed through the cluster.
The command does not fail when the volume is not mapped to the host/cluster.
Using this command with unmap_vol_set_default_idle_time: The default value ofthe idle_seconds parameter can be set before running the unmap_volume command.
The command takes some time to process: If the command fails withVOLUME_NOT_IDLE (see the completion codes table below), wait one minute to allowthe host to complete background writes, and try again the command.
Chapter 2. Host and cluster management commands 35
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed The volume is a snapshot, whereits master volume is mapped toa host or cluster associated withthe user and the snapshot wascreated by an applicationadministrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv HOST_BAD_NAME
Host name does not existv HOST_BELONGS_TO_CLUSTER
Host is part of a clusterv CLUSTER_BAD_NAME
Cluster name does not existv VOLUME_BAD_NAME
Volume name does not existv SNAPSHOT_IS_INTERNAL
Internal snapshots cannot be mapped, modified or deleted.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v ISCSI_HOST_ILLEGAL_PORT_NAME
Port name for iSCSI Host is illegalTroubleshooting: Port names for iSCSI Hosts must contain only printablecharacters.
v MAX_PORTS_REACHED
Maximum number of ports already defined in the systemv HOST_PORT_EXISTS
Host with this port ID already definedv VOLUME_NOT_IDLE
Volume was not idle before unmapping. Check connected hosts and idle timeoutv MAPPING_IS_NOT_DEFINED
The requested mapping is not definedv REMOTE_MAX_VIRTUAL_HOSTS_REACHED
Maximum number of remote virtual hosts already defined
36 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Setting the default idle time before unmapping a volumeUse the unmap_vol_set_default_idle_time command to set the default idle timerequired for a volume before unmapping it.
unmap_vol_set_default_idle_time idle_time_seconds=IdleSeconds
Parameters
Name Type Description Mandatory
idle_time_seconds Integer Defines how manyseconds the volumeneeds to be idle beforeunmapping.
Y
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Retrieving the default idle time before unmapping a volumeUse the unmap_vol_get_default_idle_time command to retrieve the default idletime required for a volume before unmapping it.
unmap_vol_get_default_idle_time
Example:
unmap_vol_get_default_idle_time
Output:
idle_time_seconds = "0"
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Chapter 2. Host and cluster management commands 37
Creating a performance classUse the perf_class_create command to create a performance class.
perf_class_create perf_class=perfClassName [ type=<shared|independent> ]
Parameters
Name Type Description Mandatory Default
perf_class String The name of aperformance class.
Y N/A
type Enumeration Determines ifassociated objectswill be limitedindependently orshare the samelimit.
N shared
The performance class name must be unique. Up to 1000 classes can be created.
Example:
perf_class_create perf_class=p1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv PERF_CLASS_EXISTS
Performance Class already exists.v MAX_PERF_CLASSES_REACHED
Maximum number of Performance Class is already defined.
Deleting a performance classUse the perf_class_delete command to delete a performance class.
perf_class_delete perf_class=perfClassName
38 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory
perf_class Object name Name of a performanceclass.
Y
Example:
perf_class_delete perf_class=p1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_A_PERF_CLASS
Are you sure you want to delete Performance Class Performance Class?v ARE_YOU_SURE_YOU_WANT_TO_DELETE_A_PERF_CLASS_ASSOCIATED_WITH_HOSTS
Deleting Performance Class Performance Class will remove the performance limitsset for hosts associated with the Performance Class. Are you sure you want todelete Performance Class Performance Class?
v ARE_YOU_SURE_YOU_WANT_TO_DELETE_A_PERF_CLASS_ASSOCIATED_WITH_POOLS
Deleting Performance Class Performance Class will remove the performance limitsset for pools associated with the Performance Class. Are you sure you want todelete Performance Class Performance Class?
v ARE_YOU_SURE_YOU_WANT_TO_DELETE_A_PERF_CLASS_ASSOCIATED_WITH_VOLUMES
Deleting Performance Class Performance Class will remove the performance limitsset for volumes associated with the Performance Class. Are you sure you wantto delete Performance Class Performance Class?
v ARE_YOU_SURE_YOU_WANT_TO_DELETE_A_PERF_CLASS_ASSOCIATED_WITH_DOMAINS
Deleting Performance Class Performance Class will remove the performance limitsset for domains associated with the Performance Class. Are you sure you wantto delete Performance Class Performance Class?
Return codesv PERF_CLASS_BAD_NAME
Performance Class does not exist
Chapter 2. Host and cluster management commands 39
Renaming a performance classUse the perf_class_rename command to rename a performance class.
perf_class_rename perf_class=perfClassNamenew_name=Name
Parameters
Name Type Description Mandatory
perf_class Object name The name of an existingperformance class.
Y
new_name String The new name for theperformance class. Theclass new name must beunique.
Y
Example:
perf_class_rename perf_class=p1 new_name=perf1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv PERF_CLASS_EXISTS
Performance Class already exists.v PERF_CLASS_BAD_NAME
Performance Class does not exist
Listing details of performance classesUse the perf_class_list command to list performance classes.
perf_class_list [ perf_class=perfClassName ]
40 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
perf_class String Name of aperformance class.If left unspecified,all performanceclasses will belisted.
N All performanceclasses.
ID Name Default Position
name Performance class 1
type Class type 2
max_iops Max IOPS rate (IOPS) 3
max_bw Max bandwidth rate (MB/s) 4
Example:
perf_class_list
Output:
Performance class Max IO rate(IOPOS) Max BW rate(MB/s)perf1 0 0
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Adding a host to a performance classUse the perf_class_add_host command to add a host to a performance class.
perf_class_add_host perf_class=perfClassName host=HostName
Parameters
Name Type Description Mandatory
perf_class Object name The name of aperformance class.
Y
host Object name The name of the host tobe added to theperformance class.
Y
Chapter 2. Host and cluster management commands 41
If the host is already associated with another performance class, it will be removedfrom that performance class.
Example:
perf_class_add_host perf_class=p1 host=h1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv PERF_CLASS_BAD_NAME
Performance Class does not existv PERF_CLASS_ASSOCIATED_WITH_POOLS_OR_DOMAINS
Performance Class Performance Class is already in use by pool or domain.v PERF_CLASS_ASSOCIATED_WITH_VOLUMES
Performance Class Performance Class is already in use by volume.v HOST_BAD_NAME
Host name does not existv HOST_ALREADY_IN_PERF_CLASS
Host host already in Performance Class Performance Class.
Removing a host from its performance classUse the perf_class_remove_host command to remove a host from its performanceclass.
perf_class_remove_host host=HostName
Parameters
Name Type Description Mandatory
host Object name The name of the host tobe removed from itsperformance class.
Y
Example:
42 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
perf_class_remove_host host=h1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv HOST_BAD_NAME
Host name does not existv PERF_CLASS_DOES_NOT_CONTAIN_ANY_HOSTS
Performance Class is already empty
Adding a pool to a performance classUse the perf_class_add_pool command to add a pool to a performance class.
perf_class_add_pool perf_class=perfClassName pool=PoolName
Parameters
Name Type Description Mandatory
perf_class Object name Name of a performanceclass
Y
pool Object name Name of a pool thatwill be added to theperformance class
Y
If the pool is already associated with another performance class, it will be removedfrom it.
Example:
perf_class_add_pool perf_class=p1 pool=h1
Output:
Command executed successfully.
Chapter 2. Host and cluster management commands 43
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv PERF_CLASS_BAD_NAME
Performance Class does not existv PERF_CLASS_ASSOCIATED_WITH_HOSTS
Performance Class Performance Class is already in use by host.v PERF_CLASS_ASSOCIATED_WITH_VOLUMES
Performance Class Performance Class is already in use by volume.v POOL_DOES_NOT_EXIST
Storage Pool does not existv POOL_ALREADY_IN_PERF_CLASS
Pool pool name already in Performance Class Performance Class.
Removing a pool from its performance classUse the perf_class_remove_pool command to remove a pool from its performanceclass.
perf_class_remove_pool pool=PoolName
Parameters
Name Type Description Mandatory
pool Object name The name of the pool tobe removed from itsperformance class.
Y
Example:
perf_class_remove_pool pool=h1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
44 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv POOL_DOES_NOT_EXIST
Storage Pool does not existv POOL_NOT_CONNECTED_TO_ANY_PERF_CLASS
Pool Not connected to any performance class
Adding a volume to a performance classUse the perf_class_add_vol command to add a volume to a performance class.
perf_class_add_vol perf_class=perfClassName vol=VolName
Parameters
Name Type Description Mandatory
perf_class Object name The name of aperformance class.
Y
vol Object name The name of the volumeto be added to theperformance class.
Y
If the volume is already associated with another performance class, it will beremoved from that.
Example:
perf_class_add_vol perf_class=p1 volume=h1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Chapter 2. Host and cluster management commands 45
Return codesv PERF_CLASS_BAD_NAME
Performance Class does not existv PERF_CLASS_ASSOCIATED_WITH_HOSTS
Performance Class Performance Class is already in use by host.v PERF_CLASS_ASSOCIATED_WITH_POOLS_OR_DOMAINS
Performance Class Performance Class is already in use by pool or domain.v VOLUME_BAD_NAME
Volume name does not existv VOLUME_ALREADY_IN_PERF_CLASS
Volume volume name already in Performance Class Performance Class.
Removing a volume from its performance classUse the perf_class_remove_vol command to remove a volume from itsperformance class.
perf_class_remove_vol vol=VolName
Parameters
Name Type Description Mandatory
vol Object name The name of a volumeto be removed from itsperformance class.
Y
Example:
perf_class_remove_vol volume=h1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv VOLUME_BAD_NAME
Volume name does not existv VOLUME_NOT_CONNECTED_TO_ANY_PERF_CLASS
Volume Not connected to any performance class
46 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Adding a domain to a performance classUse the perf_class_add_domain command to add a domain to a performance class.
perf_class_add_domain perf_class=perfClassName domain=DomainName
Parameters
Name Type Description Mandatory
domain Object name The name of thedomain to be added tothe performance class.
Y
perf_class Object name The name of aperformance class.
Y
Example:
perf_class_add_domain perf_class=perf1 domain=d1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DOMAIN_DOESNT_EXIST
Domain does not exist.v PERF_CLASS_BAD_NAME
Performance Class does not existv PERF_CLASS_ASSOCIATED_WITH_HOSTS
Performance Class Performance Class is already in use by host.v PERF_CLASS_ASSOCIATED_WITH_VOLUMES
Performance Class Performance Class is already in use by volume.v DOMAIN_ALREADY_IN_PERF_CLASS
Domain domain name already in Performance Class Performance Class.
Chapter 2. Host and cluster management commands 47
Removing a domain from its performance classUse the perf_class_remove_domain command to remove a domain from itsperformance class.
perf_class_remove_domain domain=DomainName
Parameters
Name Type Description Mandatory
domain Object name The name of thedomain to be removedfrom its performanceclass.
Y
Example:
perf_class_remove_domain domain=d1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DOMAIN_DOESNT_EXIST
Domain does not exist.v PERF_CLASS_NOT_ASSOC_WITH_DOMAIN
The domain is not in any performance class.
Setting the rate for a performance classUse the perf_class_set_rate command to set the rate for a performance class.
perf_class_set_rate perf_class=perfClassName [ max_io_rate=iops ] [ max_bw_rate=bw ]
Parameters
Name Type Description Mandatory Default
perf_class Object name Name of aperformance class.
Y N/A
48 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory Default
max_io_rate Positive integer Specifies theperformance classmaximum rate inIOPS per interface(IOPS). The maxsetting allowed is100,000. If zero isspecified, the IOPSrate will not belimited.
N Keep unchanged.
max_bw_rate Positive integer Specifies theperformance classmaximum rate inbandwidth perinterface (Mbps).The max settingallowed is 10,000.If zero is specified,the bandwidth ratewill not be limited.
N Keep unchanged.
This command sets the rate for a performance class. The specified rate is appliedfor each interface module. Either max_io_rate, max_bw_rate or both must be set.
Example:
perf_class_set_rate perf_class=p1 max_io_rate=1000
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv PERF_CLASS_BAD_NAME
Performance Class does not existv PERF_CLASS_INVALID_RATE
The rate set for the Performance Class is invalid
Chapter 2. Host and cluster management commands 49
Listing host profilesUse the host_profile_list command to list all host profiles.
host_profile_list [ host=HostName ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
host Object name The name of thespecific host whoseprofiles should belisted
N >All Host Profiles.
domain Object name The domain name. N All Domains
The command lists all host profiles or a specific one.
Field ID Field output Default position
host_name Host Name 1
update_time Update Time 2
profile Profile 3
Example:
host_profile_list host
Output:
Host Name Update Time Profile---------------------------- --------------------- -----------------------host1 2012-05-09 22:54:36 Windows 7
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Updating the host profileUse the host_profile_set command to update the host profile.
host_profile_set profile_value
50 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory
profile_value String The host profile valuelength up to 1024characters
Y
Example:
host_profile_set profile_value=Profile
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv HOST_PROFILE_UPDATE_TOO_FREQUENT
Host Profile has been set too often.Troubleshooting: Try again after the minimal update interval time
v HOST_BAD_NAME
Host name does not existv MAX_HOST_PROFILES_REACHED
Maximum number of host profiles already defined
Removing the profile of the specified hostUse the host_profile_clear command to remove the profile of the specified host.
host_profile_clear host=HostName
Parameters
Name Type Description Mandatory
host Object name The host name. Y
Example:
host_profile_clear host
Chapter 2. Host and cluster management commands 51
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv HOST_BAD_NAME
Host name does not existv HOST_PROFILE_DOES_NOT_EXIST
No profile defined for the requested host
Enabling the host profilerUse the host_profiler_enable command to enable the host profiler functionality.
host_profiler_enable
Example:
host_profiler_enable
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Disabling the host profilerUse the host_profiler_disable command to disable the host profiler functionality.
host_profiler_disable
Example:
host_profiler_disable
52 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Chapter 2. Host and cluster management commands 53
54 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 3. Volume management commands
This section describes the command-line interface (CLI) for volume management.
See also:v Volume snapshot management commandsv Consistency group management commandsv Storage pool management commands
Clearing reservations of a volumeUse the reservation_clear command to clear reservations of a volume.
reservation_clear vol=VolName
Parameters
Name Type Description Mandatory
vol Object name The name of the volumeto clear reservations of.
Y
Example:
reservation_clear vol=Vol1
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv VOLUME_BAD_NAME
Volume name does not exist
Listing reservation keysUse the reservation_key_list command to list reservation keys.
reservation_key_list [ vol=VolName ]
© Copyright IBM Corp. 2016 55
Parameters
Name Type Description Mandatory Default
vol Object name The name of thevolume whosereservation keysare to be listed.
N All volumes.
Example:
reservation_key_list vol=Vol2
Output:
Initiator Port Volume Name Reservation Key------------------ ------------------ -----------------100000062B151C3C vol-dmathies-0a7 2100000062B151C3C vol-dobratz-23a 3
Field ID Field output Default position
initiator_port Initiator Port 1
initiator_port_isid Initiator ISID 2
vol_name Volume Name 3
reg_key Reservation Key 4
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Return codesv VOLUME_BAD_NAME
Volume name does not exist
Listing volume reservationsUse the reservation_list command to list volume reservations.
reservation_list [ vol=VolName ]
Parameters
Name Type Description Mandatory Default
vol Object name The name of thevolume whosereservations are tobe listed.
N All volumes.
56 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Example:
reservation_list vol=Vol1
Output:
Volume Name Reserving Port Reservation Type Persistentvol1 none none
Cont.:
Reservation Type Persistent Access Type Initiator UID PR Generationnone -1 0
Field ID Field output Description Default position
name Volume Name N/A 1
reserved_by_port Reserving Port N/A 2
reserved_by_port_isid Reserving ISID N/A 3
reservation_type Reservation Type N/A 4
persistent_reservation_type
Persistent ReservationType
N/A 5
access_type Persistent Access Type N/A 6
reserving_initiator_uid
Initiator UID uid of reserving host 7
pr_generation PR Generation N/A 8
reservation_age Reservation Age N/A 9
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Return codesv VOLUME_BAD_NAME
Volume name does not exist
Copying volumesUse the vol_copy command to copy a source volume onto a target volume.
vol_copy vol_src=VolName vol_trg=VolName
Chapter 3. Volume management commands 57
Parameters
Name Type Description Mandatory
vol_src Object name Name of the sourcevolume from which thedata is to be taken.
Y
vol_trg Object name Name of the targetvolume to which thedata is to be copied.
Y
This command copies a source volume onto a target volume.
All data stored on the target volume is lost and cannot be restored.
This command performs the following as a single atomic action:v Deletes the target volume.v Creates a new volume with the same name as the target volume and the same
size as the source volume.v Instantly copies the source volume data onto the target volume.
All volume-to-host mappings of the target volume remain intact during thisprocess. Except for its size, the target volume retains all of its properties, includingits name, ID, lock state, creation time and all other attributes.
Immediately after the completion of the command, the volumes are independent ofeach other and are valid for any further operations (including deletion).
If the target volume is larger then the source volume, excess storage space is freedand returned to the target volume's storage pool. If the target volume is smallerthan the source volume, all storage space that is needed to support the additionalvolume's capacity is reserved from the storage pool.
The command fails in the following cases:v The target is not formatted.v The source volume is larger than the target volume, and there is not enough free
space in the storage pool that contains the target for target volume resizing.v The target volume has a snapshot associated with it or if the target volume is a
snapshot.v The target volume is locked.v The target volume is part of any mirroring definitions (either master or slave).v The source volume is a slave of a synchronous mirroring, and it is currently
inconsistent due to either a re-synchronization or an initialization process.v There is not enough free space in the storage pool that contains the target.
In the following example, the -y option suppresses theARE_YOU_SURE_YOU_WANT_TO_COPY_VOLUME Y/N prompt.
Example:
vol_copy vol_src=DBVolume vol_trg=DBVolumeCopy
Output:
58 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Command executed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_COPY_VOLUME
Are you sure you want to copy the contents of volume source Volume to volumetarget Volume?
Warningsv ARE_YOU_SURE_YOU_WANT_TO_COPY_VOLUME
Are you sure you want to copy the contents of volume source Volume to volumetarget Volume?
Return codesv NOT_ENOUGH_SPACE
No space to allocate for volume's current usagev SOURCE_VOLUME_BAD_NAME
Source volume name does not existv SOURCE_VOLUME_DATA_MIGRATION_UNSYNCHRONIZED
Data Migration has not completed to source volumev TARGET_VOLUME_BAD_NAME
Target volume name does not existv TARGET_VOLUME_LOCKED
Target volume is lockedv TARGET_VOLUME_HAS_DATA_MIGRATION
Data Migration is defined for target volumev VOLUME_IS_SNAPSHOT
Operation is not permitted on snapshotsv VOLUME_IDENTICAL
Source and target are the same volumev VOLUME_HAS_SNAPSHOTS
Volume has snapshotsv TARGET_VOLUME_NOT_FORMATTED
Target volume is not formattedv SNAPSHOT_IS_FORMATTED
Snapshot is formattedv VOLUME_TOO_BIG_TO_COPY
Chapter 3. Volume management commands 59
Volume is too large to be copiedv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v SYSTEM_OUT_OF_PHYSICAL_SPACE
Operation not allowed while the system is out of physical space.v VOLUME_TOO_BIG
No space to allocate volume
Creating a volumeUse the vol_create command to create a new volume.
vol_create vol=VolName < size=GB | size_blocks=BLOCKS > pool=PoolName [ ext_id=Identifier ][ perf_class=perfClassName ]
Parameters
Name Type Description Mandatory Default
vol Object name Volume name. Y N/A
size Positive integer Volume size in GB. N N/A
size_blocks Positive integer Size in number ofblocks.
N N/A
pool Object name The name of thestorage pool towhich the volumebelongs.
Y N/A
ext_id String External identifierof the volume.
N N/A
perf_class Object name Name of theperformance classfor the volume.
N No performanceclass
This command is used to create a new volume. The name of the volume must beunique in the system.
The space for the volume is allocated from the specified storage pool and thevolume belongs to that storage pool. Specifying the storage pool is mandatory.
When creating a volume, the storage space that is needed to support the volume'scapacity is reserved from the capacity of the storage pool for the volume. Thecommand fails if the reservation cannot be committed.
Volumes are created in increments of approximately 1 GB. In some cases, roundingof up to 5% of the size can take place. The size is the actual "net" storage space, asseen by the user's applications, not including any mirroring or other dataprotection overhead.
60 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
The volume is logically formatted at the creation time, which means that any readoperation results in returning all zeros as a response.
Upon successful completion of the command, its lock state is unlocked, meaningthat write, format and resize operations are allowed.
The creation time of the volume is set to the current time and is never changed.
Example:
vol_create vol=DBVolume size=2000 pool=DBPool
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv VOLUME_CANNOT_HAVE_ZERO_SIZE
Volume size cannot be zerov POOL_DOES_NOT_EXIST
Storage Pool does not existv VOLUME_EXISTS
Volume name already existsv VOLUME_BAD_PREFIX
Volume name has a reserved prefixv VOLUME_TOO_BIG
No space to allocate volumev MAX_VOLUMES_REACHED
Maximum number of volumes already definedv ELECTRONIC_LICENSE_NOT_APPROVED
Operation blocked until Electronic license approvalTroubleshooting: Please retrieve Electronic license version and accept it
v VOLUME_SIZE_ABOVE_LIMIT
Volume size specified is above limitv INVALID_SLICE_OFFSET
Slice offset is illegalv OPERATION_DENIED_OBJECT_MANAGED
Chapter 3. Volume management commands 61
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v ENCRYPTION_IN_PROGRESS
System is in the process of changing encryption activation statev DOMAIN_MAX_VOLUMES_REACHED
The domain exceeds the maximum allowed number of volumes.v PERF_CLASS_ASSOCIATED_WITH_HOSTS
Performance Class Performance Class is already in use by host.v PERF_CLASS_ASSOCIATED_WITH_POOLS_OR_DOMAINS
Performance Class Performance Class is already in use by pool or domain.v PERF_CLASS_BAD_NAME
Performance Class does not existv DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v SYSTEM_OUT_OF_PHYSICAL_SPACE
Operation not allowed while the system is out of physical space.
Deleting a volumeUse the vol_delete command to delete a volume.
vol_delete vol=VolName
Parameters
Name Type Description Mandatory
vol Object name Name of the volume todelete.
Y
After deletion, all data stored on the volume is lost and cannot be restored.
This command cannot be applied to a snapshot. To delete a snapshot, use Deletinga snapshot.
The volume is removed from all LUN maps that contain its mapping
This command deletes all snapshots associated with this volume. Even snapshotsthat are part of a snapshot group (this can happen when the volume was in aconsistency group and was removed from it prior to the deletion).
This command cannot be applied to a volume that is part of a consistency groupor to a volume that is mapped to a host or cluster.
The command succeeds regardless of the volume's lock state.
Example:
vol_delete vol=DBVolumeCopy
62 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_VOLUME
Are you sure you want to delete volume Volume?v ARE_YOU_SURE_YOU_WANT_TO_DELETE_VOLUME_WITH_SNAPSHOTS
Volume Volume has snapshots! Are you sure you want to delete this volumeAND all its snapshots?
Return codesv VOLUME_BAD_NAME
Volume name does not existv SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Snapshot is part of a Snapshot Groupv SNAPSHOT_IS_INTERNAL
Internal snapshots cannot be mapped, modified or deleted.v VOLUME_BELONGS_TO_CG
Volume belongs to a Consistency Groupv VOLUME_IS_MAPPED
Volume that is mapped to a host cannot be deletedv VOLUME_IS_BOUND
Volume is bound to a ALUTroubleshooting: Unbound the volume from the ALU
v VOLUME_HAS_MAPPED_SNAPSHOT
Volume which has a snapshot that is mapped to a host cannot be deletedv SNAPSHOT_IS_CONSISTENT_ELCS
If a mirrored volume is not consistent then its ELCS is protected and cannot bedeleted.
v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v VOLUME_HAS_DATA_MIGRATION
Data Migration is defined for this volumev DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowed
Chapter 3. Volume management commands 63
Troubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Formatting a volumeUse the vol_format command to formats a volume.
vol_format vol=VolName
Parameters
Name Type Description Mandatory
vol Object name Name of the volume tobe formatted.
Y
A formatted volume returns zeros as a response to any read command.
All data stored on the volume is lost and cannot be restored.
The formatting of the volume is done logically and no data is actually written tothe physical storage space allocated for the volume. This allows the command tocomplete instantly.
The volume's lock state must be unlocked when the command is issued.
This command fails if the volume has snapshots associated with it, or if thevolume is a snapshot, or if the volume is part of any mirroring or data migrationdefinition.
Example:
vol_format vol=DBVolume
Output:
Command executed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_FORMAT_VOLUME
Volume Volume may contain data. Formatting will cause data loss. Are you sureyou want to format volume Volume?
64 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Return codesv VOLUME_BAD_NAME
Volume name does not existv VOLUME_HAS_SNAPSHOTS
Volume has snapshotsv VOLUME_IS_SNAPSHOT
Operation is not permitted on snapshotsv VOLUME_LOCKED
Volume is lockedv VOLUME_HAS_DATA_MIGRATION
Data Migration is defined for this volumev OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Listing volumesUse the vol_list command to list all volumes or a specific one.
vol_list [ vol=VolName | pool=PoolName | cg=cgName ] [ show_proxy=<yes|no> ][ managed=<yes|no|all> ] [ domain=DomainName ] [ wwn=WWNString ]
Parameters
Name Type Description Mandatory Default
vol Object name Name of a specificvolume to belisted.
N All volumes.
pool Object name Name of a specificpool whosevolumes are to belisted.
N Volumes in allPools.
cg Object name List all thevolumes in thisconsistency group.
N All ConsistencyGroups.
show_proxy Boolean Returns data onproxy volumes(volumes in Proxystate) as well.
N No
managed Boolean Filter onlyvolumes that areor are notmanaged.
N no.
domain Object name The domain name. N All Domains
wwn String The WWN instring format.
N ""
This command lists volumes according to:
Chapter 3. Volume management commands 65
v Volume namev Poolv Consistency Groupv WWN
If no parameter is indicated, the command lists all the available volumes. Inaddition, the command indicates whether the volume is mirrored.
This command displays the following VAAI fields (available in the XML outputformat):v enable_VAAI
v user_disabled_VAAI
This command displays the following snapshot format field (available in the XMLoutput format):v snapshot_format
Field ID Field output Default position
name Name 1
size Size (GB) 2
size_MiB Size (MiB) N/A
master_name Master Name 3
cg_name Consistency Group 4
pool_name Pool 5
creator Creator 6
written Written (GB) 7
written_MiB Written (MiB) N/A
proxy Proxy N/A
capacity Capacity (blocks) N/A
modified Modified N/A
sg_name Snapshot Group Name N/A
delete_priority Deletion Priority N/A
locked Locked N/A
snapshot_time Snapshot Creation Time N/A
snapshot_time_on_master Master Copy Creation Time N/A
snapshot_internal_role Snapshot Internal Role N/A
snapshot_of Snapshot of N/A
sg_snapshot_of Snapshot of Snap Group N/A
wwn WWN N/A
mirrored Mirrored N/A
locked_by_pool Locked by Pool N/A
capacity_used_by_snapshots_MiB Capacity Used by Snapshots(MiB)
N/A
short_lived_io Short Live IO N/A
enable_VAAI VAAI enabled N/A
user_disabled_VAAI VAAI disabled by user N/A
snapshot_format Snapshot Format N/A
unmap_support Unmap Support N/A
managed Managed N/A
66 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
marked Marked N/A
perf_class Performance Class Name N/A
thin_provisioning_savings Thin Provisioning Savings (%) N/A
est_data_reduction_savings Est. Data Reduction Savings (%) 8
est_deduplication_factor Est. Deduplication Factor N/A
est_compression_factor Est. Compression Factor N/A
est_min_delete_size Est. Min. Delete Size (GB) 9
Example:
vol_list
Output:
Name Size (GB) Master Name Consistency Group--------------------------------- ----------- ------------------ -------------------DBLog 3006Dev 2010Dev.snapshot_00001 2010 Dev
Pool Creator Written (GB) Est. Data Reduction Savings (%)---------------- ----------------- -------------- ---------------------------------MainPool admin 21 5MainPool admin 13 6MainPool admin 0
Est. Min. Delete Size (GB)----------------------------2012
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Disallowed
Listing a volume's extended attributesUse the vol_list_extended command to return the attributes of the volume whichare not returned by vol_list.
vol_list_extended [ vol=VolName ]
Chapter 3. Volume management commands 67
Parameters
Name Type Description Mandatory Default
vol Object name Name of a specificvolume to belisted.
N All volumes.
This command lists extended attributes of volumes according to:v Volume name
Field ID Field output Default position
name Name 1
wwn WWN 2
product_serial_number Product Serial Number 3
Example:
vol_list_extended
Output:
Name WWN Product Serial Number-------------------- ---------------------------------- -------------------------DBLog 60017380000035C3000000000000000A MN035C3000000000000000ADev 60017380000035C3000000000000000B MN035C3000000000000000BDev.snapshot_00001 60017380000035C3000000000000000D MN035C3000000000000000DDev.snapshot_00002 60017380000035C3000000000000000E MN035C3000000000000000EDev.snapshot_00003 60017380000035C3000000000000000F MN035C3000000000000000FMarketing 60017380000035C3000000000000000C MN035C3000000000000000C
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Disallowed
Return codesv VOLUME_BAD_NAME
Volume name does not exist
Locking a volumeUse the vol_lock command to lock a volume so that it is read-only.
vol_lock vol=VolName
68 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory
vol Object name Name of the volume tolock.
Y
This command locks a volume so that hosts cannot write to it.
A volume that is locked is write-protected, so that hosts can read the data storedon it, but cannot change it. In addition, a locked volume cannot be formatted orresized. In general, locking a volume prevents any operation (other than deletion)that changes the volume's image.
This command succeeds when the volume's lock state is already set to the one theuser is trying to apply. In this case, the lock state remains unchanged.
The lock state of a master volume is set to unlocked when a master volume iscreated.
The lock state of a snapshot is set to locked when a snapshot is created.
In addition to the lock state, snapshots also have a modification state. Themodification state is a read-only state (which cannot be changed by the userexplicitly) and it is initially set to unmodified when the snapshot is created. The firsttime a snapshot lock state is set to unlocked, the modification state of the snapshotis changed to modified, and it is never changed thereafter.
Example:
vol_lock vol=DBVolume
Output:
Command executed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed The volume is a snapshot, whereits master volume is mapped toa host or cluster associated withthe user and the snapshot wascreated by an applicationadministrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv SNAPSHOT_IS_INTERNAL
Internal snapshots cannot be mapped, modified or deleted.
Chapter 3. Volume management commands 69
v VOLUME_BAD_NAME
Volume name does not existv SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Snapshot is part of a Snapshot Groupv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Renaming a volumeUse the vol_rename command to rename a volume.
vol_rename vol=VolName new_name=Name
Parameters
Name Type Description Mandatory
vol Object name Name of the volume tobe renamed.
Y
new_name Object name New volume name. Y
The new name of the volume must be unique in the system.
This command succeeds even if the new name is identical to the current name. Italso succeeds regardless of the volume's lock state.
Renaming a snapshot does not change the name of its master volume. Renaming amaster volume does not change the names of its associated snapshots.
Example:
vol_rename vol=DBVolume new_name=DBVolume1
Output:
Command completed successfully
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed The volume is a snapshot, whereits master volume is mapped toa host or cluster associated withthe user and the snapshot wascreated by an applicationadministrator.
70 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission Condition
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv VOLUME_BAD_NAME
Volume name does not existv VOLUME_EXISTS
Volume name already existsv SNAPSHOT_IS_INTERNAL
Internal snapshots cannot be mapped, modified or deleted.v SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Snapshot is part of a Snapshot Groupv VOLUME_BAD_PREFIX
Volume name has a reserved prefixv SNAPSHOT_IS_CONSISTENT_ELCS
If a mirrored volume is not consistent then its ELCS is protected and cannot bedeleted.
v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Resizing a volumeUse the vol_resize command to resize a volume.
vol_resize vol=VolName < size=GB | size_blocks=BLOCKS >[ shrink_volume=<yes|no> ] [ force_on_inactive_mirror=<yes|no> ]
Parameters
Name Type Description Mandatory Default
vol Object name The name of thevolume to beresized.
Y N/A
size N/A The new volumesize.
N N/A
size_blocks N/A New size ofvolumes innumber of blocks.
N N/A
shrink_volume Boolean Must be specifiedas yes if the newsize is smaller thanthe current size.
N No
Chapter 3. Volume management commands 71
Name Type Description Mandatory Default
force_on_inactive_mirror
Boolean The parameter isrequired for asuccessful resize ofa volume if (1) thevolume ismirrored, (2) thevolume is amaster, and (3) themirror has beendeactivated by thesystem following apreviously issuedresize commandthat failed tosuccessfullycomplete due to acommunicationerror.
N No
The volume can be resized in either direction. However, whenever the volume isdownsized, you have to specify this with shrink_volume=yes.
The new size of the volume is rounded up in increments of approximately 1 GB. Insome cases, rounding of up to 5% of the size can take place.
If the new size equals the current size, the command succeeds without changes tothe volume.
The volume's address space is extended at its end to reflect the increased size, andthe additional capacity is logically formatted (that is, zeros are returned for all readcommands).
When resizing a regular volume (not a writable snapshot), all storage space that isneeded to support the additional volume's capacity is reserved (static allocation).This guarantees the functionality and integrity of the volume, regardless of theresource levels of the volume's storage pool. The command fails if this reservationcannot be committed.
The volume's lock state must be unlocked when the command is issued, orotherwise the command fails.v Resizing a master volume does not change the size of its associated snapshots.v These snapshots can still be used to restore their individual master volumes.v A snapshot is resized in a similar way: the resize does not change the size of its
master volume.
In the following example, the -y option suppresses theARE_YOU_SURE_YOU_WANT_TO_ENLARGE_VOLUME Y/N prompt.
Example:
vol_resize -y vol=DBVolume size=2500
Using the force_on_inactive_mirror parameter:v This parameter forces the resizing of a mirror peer even if mirroring is inactive
(this may happen when the mirroring cannot be activated due to size mismatch).
72 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Output:
Command executed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_ENLARGE_VOLUME
Are you sure you want to increase volume size?v ARE_YOU_SURE_YOU_WANT_TO_REDUCE_VOLUME
Decreasing volume size may cause data loss. Are you sure you want to proceed?
Return codesv VOLUME_BAD_NAME
Volume name does not existv VOLUME_TOO_BIG
No space to allocate volumev VOLUME_LOCKED
Volume is lockedv VOLUME_HAS_DATA_MIGRATION
Data Migration is defined for this volumev CAN_NOT_SHRINK_MAPPED_VOLUME
Mapped volume's size cannot be decreasedv CAN_NOT_SHRINK_VOLUME_WITH_SNAPSHOTS
Size of volume with snapshots cannot be decreasedv VOLUME_IS_BOUND
Volume is bound to a ALUTroubleshooting: Unbound the volume from the ALU
v REMOTE_VOLUME_HAS_DATA_MIGRATION
Data Migration is defined for slave volumev VOLUME_CANNOT_HAVE_ZERO_SIZE
Volume size cannot be zerov CAN_NOT_SHRINK_SNAPSHOTS
Size of snapshots cannot be decreasedv CAN_NOT_SHRINK_VOLUME
Size of volumes cannot be decreased without explicit requestv VOLUME_SIZE_ABOVE_LIMIT
Volume size specified is above limit
Chapter 3. Volume management commands 73
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Unlocking a volumeUse the vol_unlock command to unlock a volume, so that it is no longer read-onlyand can be written to.
vol_unlock vol=VolName
Parameters
Name Type Description Mandatory
vol Object name The name of the volumeto unlock.
Y
An unlocked volume is no longer write-protected.
The lock state of regular volumes is set to unlocked when they are created. The lockstate of snapshots is set to locked when they are created.
In addition to the lock state, snapshots also have a modification state. Themodification state is a read-only state (which cannot be changed by the userexplicitly) and it is initially set to unmodified when the snapshot is created. The firsttime a snapshot lock state is set to unlocked, the modification state of the snapshotis changed to modified, and it is never changed thereafter.
The modification time is the time when the unlock command was executed,regardless of the actual changes performed on the volume via write commands.
Example:
vol_unlock vol=DBVolume
Output:
Command executed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed The volume is a snapshot, whereits master volume is mapped toa host or cluster associated withthe user and the snapshot wascreated by an applicationadministrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
74 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission Condition
Technicians Disallowed N/A
Warningsv ARE_YOU_SURE_YOU_WANT_TO_UNLOCK_SNAPSHOT
Are you sure you want to unlock snapshot Snapshot?
Return codesv VOLUME_BAD_NAME
Volume name does not existv SNAPSHOT_IS_INTERNAL
Internal snapshots cannot be mapped, modified or deleted.v SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Snapshot is part of a Snapshot Groupv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v SYSTEM_OUT_OF_PHYSICAL_SPACE
Operation not allowed while the system is out of physical space.
Chapter 3. Volume management commands 75
76 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 4. Volume snapshot management commands
This section describes the command-line interface (CLI) for snapshot management.
See also:v Volume management commandsv Consistency group management commandsv Storage pool management commands
Changing a snapshot deletion priorityUse the snapshot_change_priority command to change a snapshot's deletionpriority.
snapshot_change_priority snapshot=SnapshotName delete_priority=del_value
Parameters
Name Type Description Mandatory
snapshot Object name Name of the snapshotwhose delete_priority isto be changed.
Y
delete_priority Integer The priority for deletingthe volume's snapshot.
Y
This command changes the priority of the deletion of an existing snapshot. Thedeletion priority determines which snapshots are deleted first when the systemruns out of snapshot storage.
The Auto Delete Priority can have a value between 1 and 4, as follows:v 1 = Is the last to be deleted automatically ("1" is the default set by the system)v ...v 4 = Is the first to be deleted automatically
Example:
snapshot_change_priority snapshot=DBVolume.snapshot1 delete_priority=4
Output:
Command completed successfully
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
© Copyright IBM Corp. 2016 77
User Category Permission Condition
Application administrator Conditionally Allowed The master volume of thesnapshot is mapped to a host orcluster associated with the userand the snapshot was created bythe application administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv VOLUME_IS_NOT_A_SNAPSHOT
Operation is permitted only on snapshotsv SNAPSHOT_ILLEGAL_PRIORITY
Illegal snapshot priority; must be an integer between 1 and 4.v SNAPSHOT_IS_INTERNAL
Internal snapshots cannot be mapped, modified or deleted.v SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Snapshot is part of a Snapshot Groupv VOLUME_BAD_NAME
Volume name does not existv SNAPSHOT_IS_CONSISTENT_ELCS
If a mirrored volume is not consistent then its ELCS is protected and cannot bedeleted.
v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Creating a snapshotUse the snapshot_create command to create a snapshot of an existing volume.
snapshot_create vol=VolName < [ name=Name ][ delete_priority=del_value ] > | < overwrite=Name > [ ext_id=Identifier ]
Parameters
Name Type Description Mandatory Default
vol Object name Name of thevolumes tosnapshot.
Y N/A
name Object name Names of the newsnapshots.
N Auto-generatednames.
delete_priority Integer The deletionpriority of thevolume's snapshot.
N 1
78 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory Default
overwrite Object name Name of anexisting snapshotsto be overwrittenwith the currentvolumes content.
N N/A
ext_id String External identifierof the volume.
N N/A
This command creates a new snapshot for an existing volume, which is referred toas the snapshot's master volume. The snapshot's content is the same as the mastervolume at the exact point in time when the snapshot was created. The snapshotremains unchanged, although the master volume keeps changing after thesnapshot is created. Upon a successful completion of this command, the snapshotis created and assigned a name that can later be used by other commands. Thename does not have to be new. It can be the name of an already existing snapshot(in such a case, the already existing snapshot is overridden).
A write operation can be processed at the exact time of the snapshot creation,meaning that the write operation request was sent to the system before thecommand was executed, while the write was acknowledged after the commandwas executed. In this case, the content of the snapshot is not deterministic and mayeither contain the original value before the write operation, or the new value afterthe write operation. In fact, the snapshot's data may even contain a mixture of thetwo, where some blocks are equal to the volume before the write operation andother blocks are equal to the value after the write operation.
The new snapshot is initially locked for changes.
The created snapshot acts like a regular volume, except for the differencesdescribed below:v The snapshot's name is either automatically generated from its master volume's
name or given as a parameter to the command. It can later be changed withoutaltering the snapshot's modification state.
v Upon successful completion of the command, the system assigns a unique SCSIID to the snapshot. The creation time of the snapshot is set to the current timeand is never changed until the snapshot is deleted.
v The size of the snapshot is the same as its master volume's size, but no storagespace is reserved for the snapshot. This means that the functionality of thesnapshot is not guaranteed. When the snapshot's storage pool is exhausted, thesnapshot may be deleted.
v The snapshot's lock state is initially set to "locked", and as long as it is not"unlocked", the snapshot remains an exact image of the master volume atcreation time and can be the source for a restore operation. The modificationstate of the snapshot is initially set to "unmodified".
During creation, the snapshot's deletion priority can be set explicitly, or it isautomatically set to the default value. The deletion priority determines whichsnapshots will be deleted first when the storage pool runs out of snapshot storage.This may happen due to the redirect-on-write mechanisms which share unchangeddata between volumes and their snapshots, as well as between snapshots of thesame volume.
The Auto Delete Priority can have a value between 1 and 4, as follows:
Chapter 4. Volume snapshot management commands 79
v 1 = Is last to be deleted automatically ("1" is the default set by the system)v ...v 4 = Is first to be deleted automatically
The snapshot is associated with its master volume and this association cannot bebroken or changed as long as the snapshot exists.
The overwrite option copies the current content of the volume into one of itsexisting snapshots (set as an input argument). The overwritten snapshot keeps thesame SCSI device WWN and same mapping, so hosts maintain a continuousmapping to the snapshot, without any need for a rescan or similar operation. Theoverwritten snapshot must be an existing snapshot of the given volume. Theoverwritten snapshot cannot be part of a snapshot group.
This command fails when no snapshot space is defined in the storage pool themaster volume belongs to.
Mirroring limitations:v This command fails if the volume is a slave of an asynchronous mirroring
coupling (either synchronous or asynchronous).v This command fails if the volume is a slave of an inconsistent synchronous
coupling.
Example:
snapshot_create vol=DBVolume name=DBVolume.snapshot1 delete_priority=2
Output:
Command executed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed The volume is mapped to a hostor a cluster associated with theuser. If a snapshot overwrite isused, the target snapshot mustbe one created by a serveradministrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv VOLUME_BAD_NAME
Volume name does not existv MAX_VOLUMES_REACHED
Maximum number of volumes already definedv DOMAIN_MAX_VOLUMES_REACHED
80 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
The domain exceeds the maximum allowed number of volumes.v SNAPSHOT_ILLEGAL_PRIORITY
Illegal snapshot priority; must be an integer between 1 and 4.v VOLUME_IS_SNAPSHOT
Operation is not permitted on snapshotsv VOLUME_EXISTS
Volume name already existsv VOLUME_BAD_PREFIX
Volume name has a reserved prefixv VOLUME_DATA_MIGRATION_UNSYNCHRONIZED
Data Migration has not completed to this volumev OVERWRITE_SNAPSHOT_BAD_NAME
Snapshot name does not existv OVERWRITE_SNAPSHOT_IS_MASTER_VOL
This snapshot cannot be overwritten as it is a master volume.v SNAPSHOT_OVERWRITE_MISMATCH
Specified snapshot is not a snapshot of the specified volumev SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Snapshot is part of a Snapshot Groupv SNAPSHOT_IS_INTERNAL
Internal snapshots cannot be mapped, modified or deleted.v POOL_SNAPSHOT_LIMIT_REACHED
There is not enough space to create a snapshot.v TOO_MANY_FAST_SNAPSHOTS_IN_VOLUME
Max number of fast snapshots for this volume already existv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v NUM_VOLUMES_WILL_EXCEED_MAXIMUM
Can not create all the volumes, as the num of volumes will exceed its maximumvalue.
v DOMAIN_WILL_EXCEED_MAXIMUM_VOLUMES_ALLOWED
Can not create all of the volumes, as the domain will exceed the maximumallowed number of volumes.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v MAX_SNAPSHOTS_PER_VOLUME_REACHED
Maximum number of snapshots already created
Deleting a snapshotUse the snapshot_delete command to delete a snapshot.
snapshot_delete snapshot=SnapshotName
Chapter 4. Volume snapshot management commands 81
Parameters
Name Type Description Mandatory
snapshot Object name Snapshot to be deleted. Y
This command cannot be used to delete a master volume, or a snapshot which ismapped to a host or cluster, or an internal snapshot of a mirroring.
Example:
snapshot_delete snapshot=DBVolume.snapshot1
Output:
Command completed successfully
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed The master volume of thesnapshot is mapped to a host orcluster associated with the userand the snapshot was created bythe application administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv VOLUME_BAD_NAME
Volume name does not existv VOLUME_IS_NOT_A_SNAPSHOT
Operation is permitted only on snapshotsv SNAPSHOT_IS_INTERNAL
Internal snapshots cannot be mapped, modified or deleted.v SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Snapshot is part of a Snapshot Groupv SNAPSHOT_IS_MAPPED
Snapshot that is mapped to a host cannot be deletedv VOLUME_IS_BOUND
Volume is bound to a ALUTroubleshooting: Unbound the volume from the ALU
v SNAPSHOT_IS_CONSISTENT_ELCS
If a mirrored volume is not consistent then its ELCS is protected and cannot bedeleted.
v OPERATION_DENIED_OBJECT_MANAGED
82 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Duplicating a snapshotUse the snapshot_duplicate command to duplicate an existing snapshot.
snapshot_duplicate snapshot=SnapshotName [ name=Name ]
Parameters
Name Type Description Mandatory Default
snapshot Object name The name of thesnapshot toduplicate.
Y N/A
name Object name Name of the newsnapshot to begenerated.
N Automaticallygenerated name.
The newly created snapshot is initially locked for changes and is associated withthe master volume of the existing snapshot. The content of the newly createdsnapshot is identical with the content of the source snapshot.
It is useful to duplicate a snapshot before unlocking it for write operations. Theduplicate snapshot can be used as a logical backup of the data in case the writeoperation caused logical data corruption.
Upon successful completion of the command, a new duplicate snapshot is created.
The duplicated snapshot is identical with the source snapshot. It has the samecreation time and behaves as if it was created at the exact same moment and fromthe same master volume.
The duplicate snapshot's name is either automatically generated from its mastervolume's name or provided as a parameter. It can later be changed withoutaltering its modification state.
A snapshot can be duplicated multiple times. A duplicated snapshot can be thesource for further duplications.
Example:
snapshot_duplicate snapshot=DBVolume.snapshot1 name=DBVolume.snapshot1.copy
Output:
Command executed successfully.
Chapter 4. Volume snapshot management commands 83
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed The master volume of thesnapshot is mapped to a host orcluster associated with the userand the snapshot was created bythe application administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv VOLUME_BAD_NAME
Volume name does not existv MAX_VOLUMES_REACHED
Maximum number of volumes already definedv DOMAIN_MAX_VOLUMES_REACHED
The domain exceeds the maximum allowed number of volumes.v VOLUME_IS_NOT_A_SNAPSHOT
Operation is permitted only on snapshotsv VOLUME_EXISTS
Volume name already existsv SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Snapshot is part of a Snapshot Groupv VOLUME_BAD_PREFIX
Volume name has a reserved prefixv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v MAX_SNAPSHOTS_PER_VOLUME_REACHED
Maximum number of snapshots already created
Formatting a snapshotUse the snapshot_format command to format a snapshot.
snapshot_format snapshot=SnapshotName
84 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory
snapshot Object name The snapshot to beformatted.
Y
This command deletes the content of a snapshot while maintaining its mapping tothe host. The format operation results with:v The formatted snapshot is read-onlyv The format operation has no impact on performancev The formatted snapshot does not consume spacev Reading from the formatted snapshot always returns zeroesv The formatted snapshot can be overriddenv The formatted snapshot can be deletedv The formatted snapshot deletion priority can be changed
Example:
snapshot_format snapshot
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Snapshot is part of a Snapshot Groupv VOLUME_BAD_NAME
Volume name does not existv SNAPSHOT_IS_INTERNAL
Internal snapshots cannot be mapped, modified or deleted.v MAX_VOLUMES_REACHED
Maximum number of volumes already definedv SNAPSHOT_IS_FORMATTED
Snapshot is formattedv ELCS_CANNOT_BE_FORMATTED
The snapshot is an ELCS and cannot be formatted.v VOLUME_IS_NOT_A_SNAPSHOT
Chapter 4. Volume snapshot management commands 85
Operation is permitted only on snapshotsv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Listing snapshot informationUse the snapshot_list command to list snapshot information.
snapshot_list vol=VolName [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
vol Object name List of all thesnapshots of thisvolume.
Y N/A
domain Object name The domain name. N All Domains
This command lists snapshot information for all the snapshots of a specifiedvolume.
It displays the following VAAI fields (available in XML output format):v enable_VAAI
v user_disabled_VAAI
The command displays the following snapshot format field (available in XMLoutput format):v snapshot_format
Field ID Field output Default position
name Name 1
size Size (GB) 2
size_MiB Size (MiB) N/A
master_name Master Name 3
cg_name Consistency Group 4
pool_name Pool 5
creator Creator 6
written Written (GB) 7
written_MiB Written (MiB) N/A
proxy Proxy N/A
capacity Capacity (blocks) N/A
modified Modified N/A
sg_name Snapshot Group Name N/A
delete_priority Deletion Priority N/A
locked Locked N/A
86 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
snapshot_time Snapshot Creation Time N/A
snapshot_time_on_master Master Copy Creation Time N/A
snapshot_internal_role Snapshot Internal Role N/A
snapshot_of Snapshot of N/A
sg_snapshot_of Snapshot of Snap Group N/A
wwn WWN N/A
mirrored Mirrored N/A
locked_by_pool Locked by Pool N/A
capacity_used_by_snapshots_MiB Capacity Used by Snapshots(MiB)
N/A
short_lived_io Short Live IO N/A
enable_VAAI VAAI enabled N/A
user_disabled_VAAI VAAI disabled by user N/A
snapshot_format Snapshot Format N/A
unmap_support Unmap Support N/A
managed Managed N/A
marked Marked N/A
perf_class Performance Class Name N/A
thin_provisioning_savings Thin Provisioning Savings (%) N/A
est_data_reduction_savings Est. Data Reduction Savings (%) 8
est_deduplication_factor Est. Deduplication Factor N/A
est_compression_factor Est. Compression Factor N/A
est_min_delete_size Est. Min. Delete Size (GB) 9
Example:
snapshot_list vol=DBVolume
Output:
Name Size (GB) Master Name Consistency Group PoolDBVolume.sp1 2508 DBVolume defaultDBVolume.sp1.copy 2508 DBVolume default
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Chapter 4. Volume snapshot management commands 87
Restoring a volume from a snapshotUse the snapshot_restore command to restore a master volume or a snapshotfrom one of its associated snapshots.
snapshot_restore snapshot=SnapshotName [ target_snapshot=SnapshotName ]
Parameters
Name Type Description Mandatory Default
snapshot Object name Name of thesnapshot withwhich to restore itsmaster volume, orsnapshot.
Y N/A
target_snapshot Object name Snapshot to berestored.
N Restore the mastervolume.
This command restores the data of a master volume from one of its associatedsnapshots.
Issuing a restore command, logically copies the data of the source snapshot onto itsvolume. The volume's data is therefore restored to the state of the snapshotcreation. If the volume was resized after the snapshot was created, the restoreoperation resizes the volume back to its original size.
All the snapshots associated with the volume are left unchanged during a restoreoperation.
It is possible to snapshot the volume before restoring it, so that the generatedsnapshot can be used and the data is not lost.
It is possible to restore another snapshot (the target snapshot) from the sourcesnapshot. The target snapshot must be a snapshot of the same volume as thesource snapshot. The target snapshot's content and size will be identical to thesource snapshot's content and size. The target snapshot's lock/unlock status willremain as it was.
Restoring a mirrored volume:v Delete the mirrorv Restore the volumev Re-establish the mirror
It is impossible to restore a volume while it is mirrored.
Example:
snapshot_restore snapshot=DBVolume.snapshot1
Output:
Command completed successfully.
88 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed Both target and source aresnapshots of the same mastervolume. This master volume ismapped to a host or clusterassociated with the user, and thetarget snapshot was created byan application administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Warningsv ARE_YOU_SURE_YOU_WANT_TO_RESTORE_SNAPSHOT
Are you sure you want to restore the volume from snapshot Snapshot?
Return codesv VOLUME_HAS_DATA_MIGRATION
Data Migration is defined for this volumev VOLUME_BAD_NAME
Volume name does not existv VOLUME_IS_NOT_A_SNAPSHOT
Operation is permitted only on snapshotsv VOLUME_TOO_BIG
No space to allocate volumev SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Snapshot is part of a Snapshot Groupv VOLUME_LOCKED
Volume is lockedv SNAPSHOTS_BELONG_TO_DIFFERENT_MASTERS
Target snapshot and source snapshot should be snapshots of the same volumev TARGET_SNAPSHOT_BAD_NAME
Target snapshot name does not existv TARGET_SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
Target snapshot is part of a Snapshot Groupv TARGET_SNAPSHOT_IS_MASTER
Target snapshot is a master volumev TARGET_SNAPSHOT_SAME_AS_SNAPSHOT
Source snapshot cannot be the target snapshotv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowed
Chapter 4. Volume snapshot management commands 89
Troubleshooting: Wait for data reduction recovery to start and recover thecompression objects
90 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 5. Consistency group management commands
This section describes the command-line interface (CLI) for consistency groupmanagement.
See also:v Volume management commandsv Volume snapshot management commandsv Storage pool management commands
Adding a volume to a consistency groupUse the cg_add_vol command to add a volume to a consistency group.
cg_add_vol cg=cgName vol=VolName
Parameters
Name Type Description Mandatory
cg Object name Name of a consistencygroup.
Y
vol Object name Name of the volume tobe added.
Y
This command adds a volume to a consistency group. The consistency group cancontain up to 128 volumes.
Requirements for successful command completion:v The volume and consistency group are associated with the same pool.v The volume is not already part of a consistency group.v The volume is not a snapshot.v The consistency group has less than the maximum number of volumes (see
above).
Adding a mirrored volume to a non-mirrored consistency group:v Such an addition always succeeds and the volume will retain its mirroring
settings.
Requirements for successful command completion for a mirrored consistencygroup:v The command must be issued only on the master consistency group.v The command cannot be run during the initialization of the volume or
consistency group.v The volume does not have any outstanding ad-hoc sync jobs.v The volume has to be mirrored, and its following mirroring settings must be
identical to those of the consistency group: mirroring type (for example,synchronous), mirroring status, mirroring target, target pool, designation.
© Copyright IBM Corp. 2016 91
v In addition, for a mirrored consistency group that is defined assync_best_effort (synchronous):– The synchronization status of both volume and consistency group has to be
Synchronized.v For a mirrored consistency group that is defined as async_interval
(asynchronous):– The volume and consistency group must have the following identical settings
and values: schedule, remote schedule, timestamp of the last replicatedsnapshot.
– The synchronization status of the volume and consistency group must beRPO_OK
v The link has to be up.
Adding a mirrored volume to a mirrored volume and consistency group also addsthe volume's peer to the volume and consistency group's peer. Once added, themirrored volume will be set the RPO of the mirrored volume and consistencygroup.
The mirrored consistency group has one sync job for all pertinent mirroredvolumes within the consistency group.
In case of acknowledgment timeout:v If the command is issued on a mirrored master consistency group, which does
not receive an acknowledgment from the slave until the command times out ordue to an unexpected failure, a completion code is returned(MIRROR_POSSIBLE_CONS_GROUP_MEMBERSHIP_MISMATCH).
If the command cg_add_vol is issued on a mirrored master consistency group,which does not receive an acknowledgment from the slave until the commandtimes out or due to an unexpected failure, a new completion code is returned(MIRROR_POSSIBLE_CONS_GROUP_MEMBERSHIP_MISMATCH, meaning that the member listsof the mirror consistency group peers might not be the same).
Example:
cg_add_vol cg=DBGroup vol=DBLog
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
92 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Return codesv VOLUME_BAD_NAME
Volume name does not existv CONS_GROUP_BAD_NAME
Consistency Group name does not exist.v MAX_VOLUMES_IN_CONS_GROUP_REACHED
Consistency Group contains maximum number of volumes.v TARGET_NOT_CONNECTED
There is currently no connection to the target systemv VOLUME_BAD_POOL
Volume belongs to a different Storage Poolv VOLUME_BELONGS_TO_CG
Volume belongs to a Consistency Groupv VOLUME_DATA_MIGRATION_UNSYNCHRONIZED
Data Migration has not completed to this volumev VOLUME_IS_SNAPSHOT
Operation is not permitted on snapshotsv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Creating consistency groupsUse the cg_create command to create a consistency group.
cg_create cg=cgName pool=PoolName
Parameters
Name Type Description Mandatory
cg Object name Name of the consistencygroup.
Y
pool Object name Storage pool of theconsistency group.
Y
This command creates a consistency group. A consistency group is a group ofvolumes that can all be snapshotted at the same point of time. This is essential forsnapshotting several volumes used by the same application or by applications thatinteract with each other in order to generate a consistent set of snapshots.
The name of the consistency group must be unique in the system. The system cancontain up to 256 consistency groups.
The storage pool of the consistency group must be specified.
The consistency group is initially empty, containing no volumes.
Chapter 5. Consistency group management commands 93
A consistency group always belongs to a specific storage pool. All the volumes inthe consistency group belong to the same storage pool as the consistency groupitself.
Example:
cg_create pool=p_1 cg=DBgroup
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CONS_GROUP_NAME_EXISTS
Consistency Group name already exists.v MAX_CONS_GROUPS_REACHED
Maximum number of Consistency Groups already defined.v POOL_DOES_NOT_EXIST
Storage Pool does not existv DOMAIN_MAX_CONS_GROUPS_REACHED
The domain exceeds the maximum allowed number of consistency groups.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Deleting a consistency groupUse the cg_delete command to delete a consistency group.
cg_delete cg=cgName
94 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory
cg Object name Name of the consistencygroup to be deleted.
Y
This command fails if:v The consistency group is not empty, that is, it still contains volumes.v The consistency group is mirrored, even if it is empty.
All snapshot groups associated with the consistency group are disbanded, that isthe snapshots contained in these snapshot groups become independent snapshots.
Example:
cg_delete cg=DBvolumes
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CONS_GROUP_BAD_NAME
Consistency Group name does not exist.v CONS_GROUP_NOT_EMPTY
This operation is only allowed on an empty Consistency Group.v CONS_GROUP_BELONGS_TO_XCG
Consistency Group belongs to another Cross Consistency Group.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Chapter 5. Consistency group management commands 95
Listing consistency groupsUse the cg_list command to list consistency groups.
cg_list [ cg=cgName ] [ managed=<yes|no|all> ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
cg Object name Name of aconsistency group.
N All
managed Boolean Determineswhether to showunmanagedconsistency groups(no), managedconsistency groups(yes) or both (all).
N no
domain Object name The domain name. N All Domains
This command lists the specified details for all consistency groups. If a consistencygroup name is indicated, only this consistency group is listed.
Field ID Field output Default position
name Name 1
pool Pool Name 2
mirrored Mirrored N/A
managed Managed N/A
Example:
cg_list cg=DBgroup
Output:
Name Pool Name Mirrored GP BasedDBgroup default Yes No
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
96 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Removing a volume from a consistency groupUse the command cg_remove_vol to remove a volume from a consistency group.
cg_remove_vol vol=VolName
Parameters
Name Type Description Mandatory
vol Object name Name of the volume tobe removed.
Y
This command removes a volume from a consistency group.
A consistency group's name is deduced from the volume name. A unique name isensured because each volume belongs to only a single consistency group. Futuresnapshot groups created from this consistency group will not include the snapshotassociated with the removed volume.
All the snapshots of the removed volume that were created as part of thisconsistency group will be permanently removed from the snapshot groups theywere associated with.
Following the volume removal:v The corresponding peer volume is removed from the peer consistency group. If
the consistency group is mirrored, the mirroring definition of the removedvolume is retained (based on the same settings as the consistency group fromwhich it was removed).
v The peer volume is also removed from the peer consistency group.v The removed mirrored volume acquires the RPO of the mirrored consistency
group from which it was removed.v An event is generated.
This command succeeds even if the volume is not included in any consistencygroup.
Requirements for a successful command completion:v The command can be issued only on the master.v The link has to be up.v The consistency group cannot have ongoing sync jobs.
If the command is issued on a mirrored contingency group master, and the masterdoes not receive an acknowledgment from the slave because the command timesout or due to an unexpected failure, a return code is returned:(MIRROR_POSSIBLE_CONS_GROUP_MEMBERSHIP_MISMATCH).
Example:
cg_remove_vol vol=DBLog
Output:
Chapter 5. Consistency group management commands 97
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_REMOVE_VOLUME_FROM_CONS_GROUP
Are you sure you want to remove volume 'Volume' from its Consistency Group?
Return codesv VOLUME_BAD_NAME
Volume name does not existv VOLUME_NOT_IN_CONS_GROUP
Volume does not belong to a Consistency Groupv TARGET_NOT_CONNECTED
There is currently no connection to the target systemv VOLUME_IS_SNAPSHOT
Operation is not permitted on snapshotsv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v MAX_SNAPSHOTS_PER_VOLUME_REACHED
Maximum number of snapshots already created
Renaming a consistency groupUse the cg_rename command to rename consistency groups.
cg_rename cg=cgName new_name=Name
Parameters
Name Type Description Mandatory
cg Object name The name of theconsistency group to berenamed.
Y
98 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory
new_name Object name The new name of theconsistency group.
Y
The new name of the consistency group must be unique in the system.
This command succeeds even if the new name is identical with the current name.
Example:
cg_rename cg=DBgroup new_name=DBvolumes
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CONS_GROUP_BAD_NAME
Consistency Group name does not exist.v CONS_GROUP_NAME_EXISTS
Consistency Group name already exists.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Suspending I/O execution on a consistency groupUse the io_pause command to suspend I/O execution on a consistency group.
io_pause cg=cgName [ milli_seconds_to_resume=MilliSecondsTimeout ] [ allow_read=AllowRead ]
Chapter 5. Consistency group management commands 99
Parameters
Name Type Description Mandatory Default
milli_seconds_to_resume
Positive integer Timeout for autoresume. Themeasurementstarts whencurrent I/Oexecution on theconsistency groupis completed.
N 10000
allow_read Boolean Controls whetherto continuereading I/Os whileI/Os aresuspended.
N yes
cg Object name CG name Y N/A
The I/O execution is suspended with an auto-resume timeout.
It is possible to suspend execution of all I/Os or writes only.
Example:
io_pause cg=test_cg milli_seconds_to_resume=10000
Output:
command:code = "SUCCESS"status = "0"status_str = "Command completed successfully"return:
token_id = "6343971831808"
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv COMMAND_IS_NOT_VALID_IN_CURRENT_SYSTEM_STATE
The requested command cannot be invoked in the current system statev PAUSE_IO_TIMEOUT_OUT_OF_RANGE
100 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Timeout parameter is out of rangev TOO_MANY_IO_PAUSE_ISSUED
Too many Pause IOs are in progressv CONS_GROUP_BAD_NAME
Consistency Group name does not exist.v IO_PAUSE_ALREADY_ISSUED_FOR_CONS_GROUP
Volume(s) belonging to the Consistency Group are already paused
Resuming I/O executionUse the io_resume command to resume I/O execution on a consistency group,previously suspended with the io_pause command.
io_resume token_id=Token
Parameters
Name Type Description Mandatory
token_id Positive integer The token returned bythe io_resumecommand.
Y
Example:
io_resume token_id=6343971831808
Output:
command:code = "SUCCESS"status = "0"status_str = "Command completed successfully"
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv CONS_GROUP_IS_NOT_PAUSED
Consistency Group is not paused or auto-resume timeout expired
Chapter 5. Consistency group management commands 101
v CONS_GROUP_DEFINITION_MODIFIED_DURING_IO_PAUSE
Consistency Group definitions changed during pause io period
Listing the status of consistency groups with paused I/OUse the io_pause_list command to list the status of consistency groups for whichthe io_pause command was invoked.
io_pause_list [ token_id=Token ]
Parameters
Name Description Mandatory Default
token_id Optional filter value toshow the status for aspecific token. 0 meansthat the filter is notapplied.
N 0
This command displays the detailed status of the consistency groups on which I/Owas suspended with the io_pause command.
Example:
io_pause_list
Output:
command:code = "SUCCESS"status = "0"status_str = "Command completed successfully"return:
stop_io 0:allow_read = "yes"cg_name = "cg_test"config_changed = "no"inode_list_changed = "no"num_volumes = "1"resume_pending = "no"stop_io_elapsed_time = "4062"timeout = "10000"token = "6343971831808"
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
102 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission Condition
Read-only users Allowed N/A
Technicians Disallowed N/A
Creating a cross-system consistency groupUse the xcg_create command to create a cross-system consistency group (XCG)definition.
xcg_create xcg=XcgName
Parameters
Name Type Description Mandatory
xcg Object name The name of the newcross-system consistencygroup.
Y
This command creates a cross-system consistency group (XCG) definition, withwhich consistency groups on different systems can be associated.
Example:
xcg_create xcg=DBbackup
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv XCG_NAME_EXISTS
Cross Consistency Group name already exists.v MAX_XCGS_REACHED
Maximum number of Cross Consistency Groups already defined.
Chapter 5. Consistency group management commands 103
Associating an existing consistency group with a cross-systemconsistency group definition
Use the xcg_add_cg command to associate an existing consistency group to across-system consistency group definition.
xcg_add_cg xcg=XcgName cg=cgName
Parameters
Name Type Description Mandatory
xcg Object name Name of a cross-systemconsistency group.
Y
cg Object name Name of a consistencygroup.
Y
Example:
xcg_add_cg xcg=DBbackup cg=CGbackup
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv XCG_BAD_NAME
Cross Consistency Group name does not exist.v MAX_CONS_GROUPS_IN_XCG_REACHED
Cross Consistency Group contains maximum number of cgs.v CONS_GROUP_BAD_NAME
Consistency Group name does not exist.v CONS_GROUP_ALREADY_IN_XCG
Consistency Group already belongs to Cross Consistency Group.v CONS_GROUP_BELONGS_TO_XCG
104 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Consistency Group belongs to another Cross Consistency Group.
Removing a consistency group from a cross-system consistencygroup
Use the xcg_remove_cg command to remove an existing consistency group from across-system consistency group definition.
xcg_remove_cg xcg=XcgName cg=cgName
Parameters
Name Type Description Mandatory
xcg Object name Name of a Cross-systemConsistency Group.
Y
cg Object name Name of a ConsistencyGroup.
Y
Example:
xcg_remove_cg xcg=DBbackup cg=CGBackup
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Warningsv ARE_YOU_SURE_YOU_WANT_TO_REMOVE_CONS_GROUP_FROM_XCG
Are you sure you want to remove cons group 'CG' from its cross ConsistencyGroup?
Return codesv XCG_BAD_NAME
Cross Consistency Group name does not exist.v CONS_GROUP_BAD_NAME
Chapter 5. Consistency group management commands 105
Consistency Group name does not exist.v XCG_IS_EMPTY
Consistency Group is empty.v CONS_GROUP_NOT_IN_XCG
Consistency Group doesnt belong to Cross Consistency Group.
Adding a remote system name to a cross-system consistency groupdefinition
Use the xcg_add_remote_system command to add a remote system name to across-system consistency group definition.
xcg_add_remote_system xcg=XcgName remote_system=RemoteSystem
Parameters
Name Type Description Mandatory
xcg Object name Name of a cross-systemconsistency group.
Y
remote_system String Name of a remotesystem.
Y
Example:
xcg_add_remote_system xcg=DBbackup remote_system=CGbackup
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv XCG_BAD_NAME
Cross Consistency Group name does not exist.v MAX_REMOTE_SYSTEMS_IN_XCG_REACHED
Cross Consistency Group contains maximum number of remote systems.
106 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v REMOTE_SYSTEM_ALREADY_ADDED
Remote system belongs to Cross Consistency Group
Removing a remote system from a cross-system consistency groupUse the xcg_remove_remote_system command to remove a remote system namefrom a cross-system consistency group definition.
xcg_remove_remote_system xcg=XcgName remote_system=RemoteSystem
Parameters
Name Type Description Mandatory
xcg Object name Name of a Cross-systemConsistency Group.
Y
remote_system String Name of a remotesystem.
Y
Example:
xcg_remove_remote_system xcg=DBbackup remote_system=CGbackup
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv XCG_BAD_NAME
Cross Consistency Group name does not exist.v REMOTE_SYSTEM_NOT_IN_XCG
Remote system doesnt belong to Cross Consistency Group
Chapter 5. Consistency group management commands 107
Listing cross-system consistency group definitionsUse the xcg_get_local_cgs command to list cross-system consistency groupdefinitions together with the contained consistency groups.
xcg_get_local_cgs [ xcg=XcgName ]
Parameters
Name Type Description Mandatory Default
xcg Object name Name of across-systemconsistency group.
N All Cross-systemConsistencyGroups.
Example:
xcg_get_local_cgs
Output:
Command completed successfully.
Field ID Field output Default position
name Name 1
xcg XCG Name 2
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Allowed N/A
Technicians Disallowed N/A
Return codesv XCG_BAD_NAME
Cross Consistency Group name does not exist.
108 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Retrieving remote systems in a specified cross-system consistencygroup
Use the xcg_get_remote_systems command to retrieve the names of remotesystems that are a part of the specified cross-system consistency group.
xcg_get_remote_systems xcg=XcgName
Parameters
Name Type Description Mandatory
xcg Object name Name of a Cross-systemConsistency Group.
Y
Example:
xcg_get_remote_systems xcg=XcGroup1
Output:
Command completed successfully.
Field ID Field output Default position
name Name 1
xcg XCG Name 2
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Allowed N/A
Technicians Disallowed N/A
Return codesv XCG_BAD_NAME
Cross Consistency Group name does not exist.
Chapter 5. Consistency group management commands 109
Deleting a cross-system consistency groupUse the xcg_delete command to delete a cross-system consistency group (XCG)definition.
xcg_delete xcg=XcgName
Parameters
Name Type Description Mandatory
xcg Object name Name of a cross-systemconsistency group.
Y
Example:
xcg_delete xcg=DBbackup
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv XCG_BAD_NAME
Cross Consistency Group name does not exist.v XCG_NOT_EMPTY
Consistency Group is not empty.
Listing cross-system consistency group definitionsUse the xcg_list command to list cross-system consistency group definitionstogether with the contained consistency groups.
xcg_list [ xcg=XcgName ]
110 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
xcg Object name Name of aCross-systemConsistencyGroup.
N All Cross-systemConsistencyGroups.
Field ID Field output Default position
name Name 1
num_of_cgs Num Of CGs 2
num_of_remote_systems Num Of Remote Systems 3
Example:
xcg_list
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Allowed N/A
Technicians Disallowed N/A
Chapter 5. Consistency group management commands 111
112 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 6. Snapshot set management commands
This section describes the command-line interface (CLI) for snapshot setmanagement.
See also:v Volume management commandsv Volume snapshot management commandsv Consistency group management commands
Snapshotting a consistency groupUse the cg_snapshots_create command to create a snapshot group of a consistencygroup.
cg_snapshots_create cg=cgName < [ snap_group=SnapshotGroupName ][ delete_priority=del_value ] [ auto_resume=token_id ] > | <overwrite=Name>
Parameters
Name Type Description Mandatory Default
cg Object name The name of theconsistency groupwhose snapshotwill be created.
Y N/A
snap_group Object name The name of thenewly createdsnapshot group.
N Automaticallygenerated name.
delete_priority Integer The priority fordeleting thisvolume when thesystem runs out ofsnapshot space.
N 1
overwrite Object name An existingsnapshot groupthat will beoverwritten withthe currentcontent.
N N/A
auto_resume Positive integer Defines whether toresume IO to theconsistency groupby providing thetoken ID.
N 0
This command creates a consistent snapshot group of a consistency group. Thesnapshot group includes a snapshot for each of the volumes contained in theconsistency group.
Logically, this command is comprised of the following steps:v Suspending all I/O activity on all the volumes in the group and waiting for all
pending I/Os to complete.v Creating a snapshot for each volume in the group.
© Copyright IBM Corp. 2016 113
v Resuming I/O activity on all the volumes.
The main advantage of using this command (as opposed to a manual procedure) isthat all snapshots are taken at the same point of time, thus ensuring that they areconsistent with each other.
The snapshots in the created snapshot group are consistent with each other in thefollowing aspects:v They are created synchronously at the same point of time.v All I/Os to the consistency group's volumes that were completed prior to this
point of time are recorded in the snapshot's image.v Neither I/O that was completed after this point of time is recorded in the
snapshot's image.
In addition to their regular attributes, all the snapshots in the snapshot group arealso associated with the consistency group.
The name of the snapshot group is either automatically generated or provided inthe command line.
The delete priority of the snapshots in the snapshot group can also be provided(see Creating a snapshot). The delete priority controls which snapshots or snapshotgroups are deleted first when the system runs out of space for snapshots.
The overwrite option causes the current content of the consistency group to becopied into one of its existing snapshot groups (indicated as parameter'sargument). The snapshots of the overwritten snapshot group keep the same SCSIdevice WWN and same mapping, so hosts maintain a continuous mapping of thesnapshots, and a rescan or similar operation is not needed. The overwrittensnapshot group must be an existing snapshot group of the respective consistencygroup.
This command fails if no snapshot space is defined for the storage pool containingthe consistency group.
This command fails if one or more of the volumes in the consistency group areslaves in the synchronous mirroring, and the synchronous mirroring is currentlyinconsistent due to either a re-synchronization or an initialization process.
Mirroring limitations:v This command fails if the volume is a slave of an asynchronous mirroring
coupling (either synchronous or asynchronous).v This command fails if the volume is a slave of an inconsistent synchronous
coupling.
Example:
cg_snapshots_create cg=DBgroup snap_group=DBbackupdaily
Output:
Command completed successfully.
114 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe group is mapped to a host orcluster associated with the user.If a Snapshot Group overwrite isused, then the target SnapshotGroup must be one created by aserver administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv MAX_VOLUMES_REACHED
Maximum number of volumes already definedv DOMAIN_MAX_VOLUMES_REACHED
The domain exceeds the maximum allowed number of volumes.v CONS_GROUP_BAD_NAME
Consistency Group name does not exist.v SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v SNAPSHOT_GROUP_BAD_PREFIX
Snapshot Group name has a reserved prefix.v SNAPSHOT_GROUP_NAME_EXISTS
Snapshot Group name already exists.v CONS_GROUP_EMPTY
Operation is not allowed on an empty Consistency Group.v CONS_GROUP_MISMATCH
Snapshot Group does not match Consistency Group volumes.v OVERWRITE_SNAPSHOT_GROUP_DOES_NOT_BELONG_TO_GIVEN_GROUP
Snapshot Group belongs to another Consistency Group.v POOL_SNAPSHOT_LIMIT_REACHED
There is not enough space to create a snapshot.v SNAPSHOT_GROUP_IS_INTERNAL
Internal snapshots cannot be mapped, modified in any way or deleted.v SNAPSHOT_GROUP_ILLEGAL_PRIORITY
Illegal snapshot group priority; must be an integer between 1 and 4.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v CONS_GROUP_TOKEN_MISMATCH
Token does not match Consistency Group.v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowed
Chapter 6. Snapshot set management commands 115
Troubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v MAX_SNAPSHOTS_PER_VOLUME_REACHED
Maximum number of snapshots already created
Changing a snapshot group deletion priorityUse the snap_group_change_priority command to change the deletion priority of asnapshot group.
snap_group_change_priority snap_group=SnapshotGroupName delete_priority=del_value
Parameters
Name Type Description Mandatory
snap_group Object name Name of the snapshotgroup whosedelete_priority is to bechanged.
Y
delete_priority Integer Priority according towhich this snapshotgroup is deleted.
Y
This command changes the priority of the deletion of an existing snapshot group.Similarly to snapshots, the system determines which of the snapshot groups isdeleted first when it runs out of snapshot storage, in accordance with theredirect-on-write mechanism. When the system runs out of space, it deletes thesnapshot or snapshot group with the highest deletion priority, and among themthe unmapped snapshots or snapshot groups, and the snapshot or snapshot groupwhich was created first.
See Changing a snapshot deletion priority for more details about the valid deletionpriority values and their meaning.
Example:
snap_group_change_priority snap_group=DBbackup delete_priority=4
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe master Consistency Group ismapped to a host or clusterassociated with the user andSnapshot Group was created bya server administrator
Security administrator Disallowed N/A
116 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission Condition
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v SNAPSHOT_ILLEGAL_PRIORITY
Illegal snapshot priority; must be an integer between 1 and 4.v SNAPSHOT_GROUP_IS_INTERNAL
Internal snapshots cannot be mapped, modified in any way or deleted.v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Deleting a snapshot groupUse the snap_group_delete command to delete a snapshot group and all itssnapshots.
snap_group_delete snap_group=SnapshotGroupName
Parameters
Name Type Description Mandatory
snap_group Object name Name of the snapshotgroup to be deleted.
Y
This command deletes the snapshot group, as well as all of the snapshots that arecontained in the snapshot group. Refer to the documentation on Deleting asnapshot for more information about deleting snapshots.
If one of the members of the snapshot group is mapped to a host, then the entiresnapshot group cannot be deleted.
The command is inapplicable for a snapshot group that is still associated with amirrored consistency group.
Example:
snap_group_delete snap_group=DBBackupweekly
Output:
Command completed successfully.
Chapter 6. Snapshot set management commands 117
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe master Consistency Group ismapped to a host or clusterassociated with the user andSnapshot Group was created bya server administrator
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v SNAPSHOT_IS_MAPPED
Snapshot that is mapped to a host cannot be deletedv VOLUME_IS_BOUND
Volume is bound to a ALUTroubleshooting: Unbound the volume from the ALU
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Disbanding a snapshot groupUse the snap_group_disband command to disband a snapshot group intoindependent snapshots.
snap_group_disband snap_group=SnapshotGroupName
Parameters
Name Type Description Mandatory
snap_group Object name Snapshot group to bedisbanded.
Y
This command disbands the snapshot group into independent snapshots. Afterexecuting this command, the snapshots can be individually deleted, restored,unlocked, duplicated, and so on. The snapshot group does not exist anymore afterthis command. The snapshots retain the same names(snap_group_name.volumename).
118 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
The command is inapplicable for a snapshot group of a mirrored consistencygroup.
Example:
snap_group_disband snap_group=DBbackup_copy
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe master Consistency Group ismapped to a host or clusterassociated with the user andSnapshot Group was created bya server administrator
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Duplicating a snapshot groupUse the snap_group_duplicate command to duplicate an existing snapshot group.
snap_group_duplicate snap_group=SnapshotGroupName [ new_snap_group=NewName ]
Parameters
Name Type Description Mandatory Default
snap_group Object name Name of thesnapshot group tobe duplicated.
Y N/A
new_snap_group Object name Name of the newlygenerated snapshotgroup.
N Autogeneratedname.
Chapter 6. Snapshot set management commands 119
This command duplicates the specified snapshot group. This is functionallyequivalent to duplicating all the snapshots in the snapshot group usingDuplicating a snapshot and creating a new snapshot group that contains all thegenerated snapshots.
The name of the new snapshot group is either specified as a parameter orgenerated automatically.
Refer to Duplicating a snapshot for more details about the snapshot duplicationoperation.
Deletion priority:v The deletion priority of the duplicated snapshots is 0.
Example:
snap_group_duplicate snap_group=DBbackup new_snap_group=DBbackup_copy
Output:
Command completed successfully
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe master Consistency Group ismapped to a host or clusterassociated with the user andSnapshot Group was created bya server administrator
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v MAX_VOLUMES_REACHED
Maximum number of volumes already definedv DOMAIN_MAX_VOLUMES_REACHED
The domain exceeds the maximum allowed number of volumes.v SNAPSHOT_GROUP_NAME_EXISTS
Snapshot Group name already exists.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
120 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v MAX_SNAPSHOTS_PER_VOLUME_REACHED
Maximum number of snapshots already created
Formatting a snapshot groupUse the snap_group_format command to format a snapshot group.
snap_group_format snap_group=SnapshotGroupName
Parameters
Name Type Description Mandatory
snap_group Object name The snapshot group tobe formatted.
Y
This command deletes the content of a snapshot group while maintaining itssnapshots mapping to the host. The format operation results with:v The snapshots of the formatted snapshot group are read-onlyv The format operation has no impact on performancev The snapshots of the formatted snapshot group do not consume spacev Reading from the snapshots of the formatted snapshot group always returns
zeroesv The snapshots can be overriddenv The snapshots can be deletedv The snapshots deletion priority can be changed
Example:
snap_group_format snap_group
Output:
Command executed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe master Consistency Group ismapped to a host or clusterassociated with the user andSnapshot Group was created bya server administrator
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Chapter 6. Snapshot set management commands 121
User Category Permission Condition
Technicians Disallowed N/A
Return codesv SNAPSHOT_GROUP_IS_FORMATTED
Snapshot group is formatted.v ELCS_GROUP_CANNOT_BE_FORMATTED
The snapshot group is an ELCS and cannot be formatted.v MAX_VOLUMES_REACHED
Maximum number of volumes already definedv SNAPSHOT_GROUP_IS_INTERNAL
Internal snapshots cannot be mapped, modified in any way or deleted.v VOLUME_IS_NOT_A_SNAPSHOT
Operation is permitted only on snapshotsv SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Listing snapshot groupsUse the snap_group_list command to list all snapshot groups or a specific one.
snap_group_list [ snap_group=SnapshotGroupName | cg=cgName ] [ managed=<yes|no|all> ]
Parameters
Name Type Description Mandatory Default
snap_group Object name Name of a specificsnapshot group tobe listed.
N All snapshotgroups.
cg Object name List all thesnapshot groups ofthis ConsistencyGroup.
N All snapshotgroups.
managed Boolean Defines whether toshow unmanagedsnap groups (no),managed (yes) orboth (all).
N no.
This command lists snapshot groups. When a snapshot group name is specified,then only that specific snapshot group is listed. When a consistency group name isspecified, then the snapshot groups of this consistency group are listed.
122 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
This command displays the following snapshot group format field (available in theXML output format):v snap_group_format
Field ID Field output Default position
name Name 1
cg CG 2
snapshot_time Snapshot Time 3
locked Locked N/A
modified Modified N/A
delete_priority Deletion Priority 4
snap_group_format Snapshot Group Format N/A
snap_group_descriptor Snapshot Group Descriptor N/A
managed Managed N/A
Example:
snap_group_list cg=DBvolumes
Output:
Name CG Snapshot Time Deletion PriorityDBbackup DBvolumes 2007-01-03 17:46:29 1DBbackupdaily DBvolumes 2007-01-03 17:49:36 1
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Locking a snapshot groupUse the snap_group_lock command to lock a snapshot group by locking all itssnapshots.
snap_group_lock snap_group=SnapshotGroupName
Parameters
Name Type Description Mandatory
snap_group Object name Name of the snapshotgroup to be locked.
Y
Chapter 6. Snapshot set management commands 123
This command is functionally equivalent to locking all snapshots individually(through executing Locking a volume on each snapshot). Refer to thedocumentation of Locking a volume for a description of locking behavior.
Example:
snap_group_lock snap_group=DBbackup
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe master Consistency Group ismapped to a host or clusterassociated with the user andSnapshot Group was created bya server administrator
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v SNAPSHOT_GROUP_IS_INTERNAL
Internal snapshots cannot be mapped, modified in any way or deleted.v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Renaming a snapshot groupUse the snap_group_rename command to rename a snapshot group.
snap_group_rename snap_group=SnapshotGroupName new_name=Name
Parameters
Name Type Description Mandatory
snap_group Object name Name of the snapshotgroup to be renamed.
Y
new_name Object name New name for thesnapshot group.
Y
124 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
The command is inapplicable for a snapshot group of a mirrored snapshot group.
Example:
snap_group_rename snap_group=DBbackup new_name=DBBackupweekly
Output:
Command completed successfully
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe master Consistency Group ismapped to a host or clusterassociated with the user andSnapshot Group was created bya server administrator
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v SNAPSHOT_GROUP_NAME_EXISTS
Snapshot Group name already exists.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Restoring a consistency group from a snapshot groupUse the snap_group_restore command to restore the master volumes of aconsistency group, or of a snapshot group from one of its associated snapshotgroups.
snap_group_restore snap_group=SnapshotGroupName [ target_snap_group=SnapshotGroupName ]
Chapter 6. Snapshot set management commands 125
Parameters
Name Type Description Mandatory
snap_group Object name Name of the snapshotgroup from which torestore its mastervolumes.
Y
target_snap_group Object name Snapshot group to berestored.
N
Using this command is equivalent to restoring all the volumes in the consistencygroup, or all the snapshots in the target snapshot group from their snapshots in thesnapshot group.
It is possible to restore a snapshot group from a snapshot group.
Requirements for a successful command completion:v The consistency group or the target snapshot group must contain the exact same
volumes that they contained when the snapshot group was generated.– Each volume added to the consistency group after the creation of the
snapshot group must be removed from the consistency group beforerestoration is completed.
v The command is inapplicable for a snapshot group of a mirrored consistencygroup.
See Restoring a volume from a snapshot for more information about the restoring.
Example:
snap_group_restore snap_group=DBbackup_copy
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed Both target and source aresnapshots groups of the samemaster Consistency Group,where at least one of the mastervolumes in this ConsistencyGroup is mapped to a host orcluster associated with the user,and the target Snapshot Groupwas created by an applicationadministrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
126 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Return codesv VOLUME_HAS_DATA_MIGRATION
Data Migration is defined for this volumev SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v CONS_GROUP_MISMATCH
Snapshot Group does not match Consistency Group volumes.v VOLUME_TOO_BIG
No space to allocate volumev VOLUME_LOCKED
Volume is lockedv TARGET_SNAPSHOT_GROUP_BAD_NAME
Target Snapshot Group name does not exist.v SNAPSHOT_GROUP_MISMATCH
Snapshot Group does not match target Snapshot Group.v TARGET_SNAPSHOT_GROUP_SAME_AS_SOURCE
Target Snapshot Group is the same as Snapshot Group.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Unlocking a snapshot groupUse the snap_group_unlock command to unlock a snapshot group by unlocking allits snapshots.
snap_group_unlock snap_group=SnapshotGroupName
Parameters
Name Type Description Mandatory
snap_group Object name Name of the snapshotgroup to be unlocked.
Y
This command unlocks a snapshot group by unlocking all its snapshots. This isequivalent to executing Unlocking a volume on each snapshot. Refer to thedocumentation of Unlocking a volume for a description of unlocking behavior.
Example:
snap_group_unlock snap_group=DBbackup
Output:
Chapter 6. Snapshot set management commands 127
Command completed successfully
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe master Consistency Group ismapped to a host or clusterassociated with the user andSnapshot Group was created bya server administrator
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v SNAPSHOT_GROUP_IS_INTERNAL
Internal snapshots cannot be mapped, modified in any way or deleted.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Setting a snapshot group descriptorUse the snap_group_set_descriptor command to set a snapshot group descriptor.
snap_group_set_descriptor snap_group=SnapshotGroupName descriptor=Descriptor
Parameters
Name Type Description Mandatory
snap_group Object name Name of the snapshotgroup.
Y
descriptor String A snap group descriptorto be used by externalsoftware.
Y
Provides external software with the ability to mark the snapshot as part of aconsistency group for various usage scenarios. The command replaces an existingdescriptor with a newly specified one.
Example:
128 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
snap_group_set_descriptor snap_group=DBbackup descriptor=blabla
Output:
Command completed successfully
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed At least one of the volumes inthe master Consistency Group ismapped to a host or clusterassociated with the user andSnapshot Group was created bya server administrator
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Returning a snapshot group's descriptorUse the snap_group_get_descriptor command to return a snapshot group'sdescriptor.
snap_group_get_descriptor snap_group=SnapshotGroupName
Parameters
Name Type Description Mandatory
snap_group Object name Name of the snapshotgroup.
Y
The command provides an external software with the ability to obtain thedescriptor attribute value for a snapshot group.
Example:
snap_group_get_descriptor snap_group=DBbackup
Output:
Chapter 6. Snapshot set management commands 129
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Return codesv SNAPSHOT_GROUP_BAD_NAME
Snapshot Group name does not exist.
130 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 7. Storage pool management commands
This section describes the command-line interface (CLI) for storage poolmanagement.
See also:v Volume management commandsv Volume snapshot management commandsv Consistency group management commands
Moving a consistency group between storage poolsUse the cg_move command to move a consistency group, all its volumes, and alltheir snapshots and snapshot sets from one storage pool to another.
cg_move cg=cgName pool=PoolName [ domain_adjust=<yes|no> ]
Parameters
Name Type Description Mandatory Default
cg Object name Name of theconsistency groupto be moved.
Y N/A
pool Object name Name of the targetstorage pool.
Y N/A
domain_adjust Boolean Adjusts domainresources. If set toTrue, the resourcesof the consistencygroup sourcedomain anddestination domainare adjusted toaccommodate theconsistency groupbeing moved.
N no
Requirements for successful command completion:v Sufficient space on the target poolsv If the consistency group is mirrored, it can only be moved to a pool that is not
thin-provisioned.
Example:
cg_move cg=DBGroup pool=DBPool
Output:
Command completed successfully.
© Copyright IBM Corp. 2016 131
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CONS_GROUP_BAD_NAME
Consistency Group name does not exist.v POOL_DOES_NOT_EXIST
Storage Pool does not existv NOT_ENOUGH_SPACE
No space to allocate for volume's current usagev NOT_ENOUGH_SNAPSHOT_SPACE
Snapshot usage will exceed snapshot limitv DOMAIN_MAX_VOLUMES_REACHED
The domain exceeds the maximum allowed number of volumes.v MAX_VOLUMES_REACHED
Maximum number of volumes already definedv DOMAIN_MAX_CONS_GROUPS_REACHED
The domain exceeds the maximum allowed number of consistency groups.v MAX_CONS_GROUPS_REACHED
Maximum number of Consistency Groups already defined.v DOMAIN_USED_TARGET_NOT_IN_DESTINATION
A target that is used by mirror in the pool is not associated with the targetdomain.
v MAPPED_HOSTS_NOT_IN_DESTINATION
A host that is mapped to a volume in the pool is not associated with the targetdomain.
v MAPPED_CLUSTERS_NOT_IN_DESTINATION
A cluster that is mapped to a volume in the pool is not associated with thetarget domain.
v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v CONS_GROUP_REQUIRES_DESTINATION_POOL
A destination Pool must be entered.v MAX_DMS_REACHED
Maximum number of remote volumes (mirror/migration) is already definedTroubleshooting: Delete unnecessary Data Migration objects
v DOMAIN_MAX_DMS_REACHED
The domain exceeds the maximum allowed number of data migrations.
132 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v NO_SPACE
The system does not have enough free space for the requested Storage Pool sizev VOLUME_TOO_BIG
No space to allocate volume
Changing the pool limitation, performance class, or thresholdparameters
Use the pool_change_config command to change a storage pool configuration.
pool_change_config pool=PoolName [ lock_behavior=<read_only|no_io> ][ perf_class=perfClassName ] [ restore_thresholds=<yes|no> | hysteresis=HysteresisValue |< code=EventCode severity=<INFORMATIONAL|WARNING|MINOR|MAJOR|CRITICAL|NONE>threshold=<ThresholdValue|NONE> > ]
Parameters
Name Type Description Mandatory Default
pool Object name The name of astorage pool.
Y N/A
lock_behavior Enumeration Determineswhether and howthe pool is lockedupon spacedepletion.
N read_only
perf_class Object name The name of theperformance classpool.
N No performanceclass
code N/A Event code. N No code
severity Enumeration Severity. N No severity
threshold Integer The thresholdvalue. Noneindicates that anevent with thisseverity is notcreated.
N No threshold
restore_thresholds Boolean Restore thresholdsto default values.
N no
hysteresis Integer The hysteresis ofthe eventthrowing.
N "3"
This command changes the pool behavior when the pool runs out of thinprovisioning space.
For thin provisioned storage pools, the lock_behavior parameter sets how the poolis locked upon space depletion. The pool can be locked for write, or for both readand write.
Example:
Chapter 7. Storage pool management commands 133
pool_change_config pool=VOL_BREED_None_0 lock_behavior=read_only
This command changes the Performance Class of the pool.
Example:
pool_change_config pool=VOL_BREED_None_1 perf_class=valid_perf_class_name
This command changes the thresholds parameters of the pool or reset it to defaultthresholds value.
Example:
pool_change_config pool=VOL_BREED_None_1 code=STORAGE_POOL_VOLUME_USAGE_INCREASEDseverity=INFORMATIONAL threshold=40 pool_change_config pool=VOL_BREED_None_1code=STORAGE_POOL_SNAPSHOT_USAGE_INCREASED severity=INFORMATIONAL threshold=50pool_change_config pool=VOL_BREED_None_1 restore_thresholds=yes
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv POOL_DOES_NOT_EXIST
Storage Pool does not existv PERF_CLASS_BAD_NAME
Performance Class does not existv PERF_CLASS_ASSOCIATED_WITH_HOSTS
Performance Class Performance Class is already in use by host.v PERF_CLASS_ASSOCIATED_WITH_VOLUMES
Performance Class Performance Class is already in use by volume.v POOL_ALREADY_IN_PERF_CLASS
Pool pool name already in Performance Class Performance Class.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v UNRECOGNIZED_EVENT_CODE
'String' is not a recognized event code
134 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Troubleshooting: Consult the manual for the list of event codesv EVENT_DOES_NOT_HAVE_THRESHOLDS
Event does not have thresholdsv EVENT_THRESHOLD_IS_ILLEGAL
Illegal value for event thresholdTroubleshooting: Event threshold values must be monotonic
Changing pool settings for snapshotsUse the pool_config_snapshots command to change storage pool snapshotsettings.
pool_config_snapshots pool=PoolName [ protected_snapshot_priority=<0|1|2|3|4> ]
Parameters
Name Type Description Mandatory Default
pool Object name The name of astorage pool.
Y N/A
protected_snapshot_priority
Integer Specifies thesnapshot deletepriority from 0 to4 (see fullexplanationbelow).
N unchanged
This command changes the storage pool snapshot limitation policy.
The create_last_consistent_snapshot attribute (used for systems which have no space):v If the value of the attribute is No, no last consistent snapshot is generated.v If the value is changed while synchronizing, the existing snapshot is not deleted.
The protected_snapshot_priority parameter:v Snapshots with a lower delete priority (that is, a higher number) than the
specified value might be deleted by the system automatically, in order to freespace, before pausing the mirroring, thus protecting snapshots with a priorityequal or higher than the value.
v If, for example, the value is set to 3:– The system will deactivate mirroring if not enough space can be freed even
after the deletion of snapshots with deletion priority of 4.– Snapshots with priority level 1, 2 and 3 will not be deleted.
v If the value is set to 4, the system will deactivate mirroring before deleting anyof the snapshots.
v If the value is set to 0, the system can delete any snapshot regardless of deletionpriority.
Example:
pool_config_snapshots pool=DBPool
Output:
Chapter 7. Storage pool management commands 135
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_CHANGE_THE_PROTECTED_LEVEL_OF_SNAPSHOTS
Are you sure you want to change the protected level of snapshot in Storage PoolPool? Note that in case of pool space depletion the system will delete protectedsnapshots only after deleting unprotected snapshots and internal asynchronousmirror snapshots
v ARE_YOU_SURE_YOU_WANT_TO_INCREASE_THE_PROTECTED_LEVEL_OF_EXISTING_SNAPSHOTS
Are you sure you want to increase the protected level of snapshot in StoragePool Pool? Note that the pool contains unprotected snapshots that will becomeprotected after issuing this command. In case of pool space depletion the systemwill delete protected snapshots only after deleting unprotected snapshots andinternal asynchronous mirror snapshots
v ARE_YOU_SURE_YOU_WANT_TO_DECREASE_THE_PROTECTED_LEVEL_OF_EXISTING_SNAPSHOTS
Are you sure you want to decrease the protected level of snapshot in StoragePool Pool? Note that the pool contains protected snapshots that will becomeunprotected after issuing this command.In case of pool space depletion thesystem will delete internal asynchronous mirror snapshots only after deletingunprotected snapshots
Return codesv POOL_DOES_NOT_EXIST
Storage Pool does not existv SNAPSHOT_ILLEGAL_PRIORITY
Illegal snapshot priority; must be an integer between 1 and 4.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
Creating storage poolsUse the pool_create command to create a storage pool.
pool_create pool=PoolName size=GB snapshot_size=GB [ lock_behavior=<read_only|no_io> ][ perf_class=perfClassName ] [ domain=DomainName ]
136 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
pool Object name The name of thenew storage pool.
Y N/A
size Positive integer Effective capacityof the storage pool(in gigabytes).
Y N/A
snapshot_size Positive integer Effective capacityallocated forsnapshots.
Y N/A
lock_behavior Enumeration Determineswhether and howthe pool is lockedupon spacedepletion.
N read_only
perf_class Object name The name of theperformance classpool.
N No performanceclass
domain Object name Add the pool tothe specifieddomain.
N none
The name of the storage pool must be unique in the system. Upon creation, thestorage pool is empty and does not contain volumes.
Pool size limits
The parameters size and snapshot_size relate to effective capacity.
The upper limit of the size parameter is set to 1 PB.
As for the lower limits of the size and snapshot_size parameters, the followingrestrictions apply:v size cannot be less than 2 TBv snapshot_size must be 0, or not less than 400GB.
These limits can be ignored by force (-y). To change the limits, contact the IBMSupport.
Example:
pool_create pool=DBPool size=1000 snapshot_size=500
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Chapter 7. Storage pool management commands 137
User Category Permission
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv POOL_SIZE_SMALL
Pool size is very small. Volumes may not be able to use this space efficiently. Areyou sure?
v POOL_SNAPSHOT_SIZE_SMALL
Pool snapshot size is very small. Snapshots may be deleted frequently. Are yousure?
Return codesv POOL_NAME_EXISTS
Storage Pool name already assigned to another Storage Poolv PERF_CLASS_BAD_NAME
Performance Class does not existv PERF_CLASS_ASSOCIATED_WITH_HOSTS
Performance Class Performance Class is already in use by host.v PERF_CLASS_ASSOCIATED_WITH_VOLUMES
Performance Class Performance Class is already in use by volume.v MAX_POOLS_REACHED
Maximum number of Storage Pools already definedv NO_SPACE
The system does not have enough free space for the requested Storage Pool sizev SNAPSHOT_SIZE_BIGGER_THAN_POOL_SIZE
Snapshot size must be equal or smaller than pool sizev REACHED_POOL_MAX_SIZE
Reached max pool sizev DOMAIN_DOESNT_EXIST
Domain does not exist.v USER_ASSOCIATED_TO_MORE_THAN_ONE_DOMAIN
As the user that runs this command is attached to more than one domain, it isnot clear in which domain the pool is created. Run the command again andspecify a domain.
v NO_FREE_CAPACITY_IN_DOMAIN
There is not enough free space in the domain.v DOMAIN_MAX_POOLS_REACHED
The maximum number of domain pools was reached.
Deleting a storage poolUse the pool_delete command to delete a storage pool.
pool_delete pool=PoolName
138 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory
pool Object name The name of the storagepool to be deleted.
Y
This command fails if the storage pool is not empty, that is it still containsvolumes.
The capacity of the deleted storage pool is added to the free space.
Example:
pool_delete pool=ERPPool
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_POOL
Are you sure you want to delete Storage Pool Pool?
Return codesv POOL_DOES_NOT_EXIST
Storage Pool does not existv POOL_HAS_CG
Storage Pool has Consistency Groups definedv POOL_IN_USE
Storage Pool has volumes allocated in itv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
Listing storage poolsUse the pool_list command to list all storage pools or the specified one.
pool_list [ pool=PoolName ] [ managed=<yes|no|all> ] [ domain=DomainName ]
Chapter 7. Storage pool management commands 139
Parameters
Name Type Description Mandatory Default
pool Object name The name of astorage pool.
N All pools.
managed Boolean Determineswhether to showunmanaged pools(no), managed(yes), or both (all).
N No
domain Object name The domain name. N All Domains
When the pool parameter is provided, only the specified storage pool is listed.
Example:
pool_list
Output:
Name Size (GB) Empty Space (GB)default 24292 9225DBPool 1013 1013
Field ID Field output Default position
name Name 1
size Size (GB) 2
size_MiB Size (MiB) N/A
snapshot_size Snap Size (GB) 3
snapshot_size_MiB Snap Size (MiB) N/A
total_volume_size Total Vols (GB) 4
total_volume_size_MiB Total Vols (MiB) N/A
empty_space Empty (GB) 5
empty_space_MiB Empty (MiB) N/A
used_by_volumes Used by Vols (GB) 6
used_by_volumes_MiB Used by Vols (MiB) N/A
used_by_snapshots Used by Snaps (GB) 7
used_by_snapshots_MiB Used by Snaps (MiB) N/A
creator Creator N/A
locked Locked 8
lock_behavior Lock Behavior N/A
create_last_consistent_snapshot
Create Last Consistent Snapshot N/A
protected_snapshot_priority Protected Snapshots Priority N/A
managed Managed N/A
perf_class Perf Class Name 9
domain Domain 10
sparse Sparse N/A
140 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Renaming a storage poolUse the pool_rename command to rename the specified storage pool.
pool_rename pool=PoolName new_name=Name
Parameters
Name Type Description Mandatory
pool Object name The current name of thestorage pool.
Y
new_name Object name The new name of thestorage pool.
Y
The new name of the storage pool must be unique in the system.
This command succeeds even if the new name is identical with the current name.
Example:
pool_rename pool=DBPool new_name=ERPPool
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv POOL_DOES_NOT_EXIST
Storage Pool does not existv POOL_NAME_EXISTS
Chapter 7. Storage pool management commands 141
Storage Pool name already assigned to another Storage Poolv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
Resizing a storage poolUse the pool_resize command to resize a storage pool.
pool_resize pool=PoolName [ size=GB ] [ snapshot_size=GB ]
Parameters
Name Type Description Mandatory Default
pool Object name The name of thestorage pool to beresized.
Y N/A
size Positive integer The new size ofthe storage pool(in gigabytes)
N N/A
snapshot_size Integer The new limit onsnapshot capacityusage of thestorage pool.
N Leave unchanged.
The command can either increase or decrease the storage pool size.v When increasing a storage pool size, the command succeeds only if the free
space holds enough free capacity to allow such an increase.v When decreasing a storage pool size, the command succeeds only if the storage
pool itself holds enough free capacity to allow such a reduction.v If the new size equals the current size, the command succeeds without changing
the storage pool.
Pool size limits
The parameters size and snapshot_size relate to effective capacity.
The upper limit of the size parameter is set to 1 PB.
As for the lower limits of the size and snapshot_size parameters, the followingrestrictions apply:v size cannot be less than 2 TBv snapshot_size must be 0, or not less than 400GB.
These limits can be ignored by force (-y). To change the limits, contact the IBMSupport.
This command fails if the current storage pool size cannot be decreased, or if thefree space cannot be decreased.
Example:
pool_resize pool=DBPool size=1300
142 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv POOL_SIZE_SMALL
Pool size is very small. Volumes may not be able to use this space efficiently. Areyou sure?
v POOL_SNAPSHOT_SIZE_SMALL
Pool snapshot size is very small. Snapshots may be deleted frequently. Are yousure?
Return codesv POOL_DOES_NOT_EXIST
Storage Pool does not existv POOL_SIZE_TOO_SMALL
Storage Pool usage exceeds requested sizev REACHED_POOL_MAX_SIZE
Reached max pool sizev NO_SPACE
The system does not have enough free space for the requested Storage Pool sizev POOL_SNAPSHOT_SIZE_TOO_SMALL
Storage Pool snapshot usage exceeds requested snapshot sizev SNAPSHOT_SIZE_BIGGER_THAN_POOL_SIZE
Snapshot size must be equal or smaller than pool sizev OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v NO_FREE_CAPACITY_IN_DOMAIN
There is not enough free space in the domain.
Moving a volume between storage poolsUse the vol_move command to move a volume and all its snapshot from onestorage pool to another.
vol_move vol=VolName pool=PoolName [ domain_adjust=<yes|no> ]
Chapter 7. Storage pool management commands 143
Parameters
Name Type Description Mandatory Default
vol Object name Name of thevolume to move.
Y N/A
pool Object name Name of thestorage pool towhich to move.
Y N/A
domain_adjust Boolean Adjust domainresources. If set totrue, the resourcesof the volumesource domain anddestination domainare adjusted toaccommodate thevolume beingmoved.
N no
When moving a master volume from one storage pool to another, all of itssnapshots are moved together with it to the destination storage pool.
This command fails when trying to move a snapshot of a volume on its own. Thiscommand can fail due to the lack of either soft or hard space.
The command succeeds only if the destination storage pool has enough freestorage capacity to accommodate the volume and its snapshots. The exact amountof storage capacity allocated from the destination storage pool is released at thesource storage pool.
A volume which belongs to a consistency group cannot be moved without theentire consistency group. You may use Moving a consistency group betweenstorage pools to move the consistency group itself from one storage pool toanother.
A volume that is asynchronously mirrored cannot be moved into a thinprovisioning pool.
Example:
vol_move vol=DBLog pool=DBPool
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
144 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Return codesv VOLUME_BAD_NAME
Volume name does not existv POOL_DOES_NOT_EXIST
Storage Pool does not existv NOT_ENOUGH_SPACE
No space to allocate for volume's current usagev NO_SPACE
The system does not have enough free space for the requested Storage Pool sizev VOLUME_TOO_BIG
No space to allocate volumev NO_FREE_CAPACITY_IN_DOMAIN
There is not enough free space in the domain.v VOLUME_IS_SNAPSHOT
Operation is not permitted on snapshotsv VOLUME_BELONGS_TO_CG
Volume belongs to a Consistency Groupv NOT_ENOUGH_SNAPSHOT_SPACE
Snapshot usage will exceed snapshot limitv OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v CANNOT_MOVE_TO_THICK_POOL_VOLUME_HAS_GOLDEN_SNAPSHOTS
Volume has golden snapshots and therefore cannot be moved to a thick pool.v MAPPED_HOSTS_NOT_IN_DESTINATION
A host that is mapped to a volume in the pool is not associated with the targetdomain.
v MAPPED_CLUSTERS_NOT_IN_DESTINATION
A cluster that is mapped to a volume in the pool is not associated with thetarget domain.
v DOMAIN_USED_TARGET_NOT_IN_DESTINATION
A target that is used by mirror in the pool is not associated with the targetdomain.
v DOMAIN_MAX_DMS_REACHED
The domain exceeds the maximum allowed number of data migrations.v DOMAIN_MAX_VOLUMES_REACHED
The domain exceeds the maximum allowed number of volumes.v MAX_DMS_REACHED
Maximum number of remote volumes (mirror/migration) is already definedTroubleshooting: Delete unnecessary Data Migration objects
v MAX_VOLUMES_REACHED
Maximum number of volumes already definedv DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowed
Chapter 7. Storage pool management commands 145
Troubleshooting: Wait for data reduction recovery to start and recover thecompression objects
146 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 8. System management commands
This section describes the command-line interface (CLI) for system management.
Displaying the values of configuration parametersUse the config_get command to show the values of configuration parameters.
config_get [ name=Name ]
Parameters
Name Type Description Mandatory Default
name String Name ofparameter to print.
N All parameters.
Field ID Field output Default position
name Name 1
value Value 2
This command shows the name and value of the specified configuration parameteror of all of them, if no parameter is provided.
The values of the following parameters can be shown:v dns_primary - IP address of the master DNS server.v dns_secondary - IP address of the slave DNS server.v email_reply_to_address - Reply-to address to be used when sending emails.
This is useful for troubleshooting errors in email addresses.v email_sender_address - Email address used as the sender's address when
sending email messages.v email_subject_format - Controls the formatting of the email subject line. To
insert the event's data, use the following tags: {severity}, {description}, or{system_name}. System default is "{severity}: {description}".
v iscsi_name - iSCSI initiator name. Used when configuring a non-XIV system fordata migration over iSCSI.
v machine_model
v machine_serial_number
v machine_type
v ntp_server - IP address or DNS name of the NTP server.v snmp_community - Community used for SNMP queries of the system.v snmp_location - SNMP location as shown in the SNMP MIB. (.1.3.6.1.2.1.1.6.0).v snmp_contact - SNMP contact as shown in the SNMP MIB. (.1.3.6.1.2.1.1.4.0).v snmp_trap_community - Community used for SNMP traps sent by the system.v support_center_port_type -v system_id - Unique system identifier (equivalent to a serial number).v system_name
© Copyright IBM Corp. 2016 147
Example:
config_get
Output:
Name Value------------------------ -----------------------------------email_sender_address [email protected]_reply_to_address [email protected]_primary 10.0.0.10dns_secondaryiscsi_name iqn.2005-10.com.xivstorage:010140system_name IBM Storage System
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Return codesv CONF_SERVER_UNREACHABLE
Configuration server unreachablev UNRECOGNIZED_CONFIG_PARAMETER
Unrecognized configuration parameter: 'name'.Troubleshooting: Use a valid configuration parameter as an input.
Setting configuration parametersUse the config_set command to set configuration parameters.
config_set name=Name value=ParamValue
Parameters
Name Type Description Mandatory
name String Name of the parameterto set.
Y
value String Value of the parameter. Y
This command sets the values of configuration parameters.
The values of the following parameters can be set:v dns_master - IP address of the master DNS server.v dns_slave - IP address of the slave DNS server.v email_sender_address - Email address used as the sender's address when
sending email messages. Once set, this parameter cannot be set to null.
148 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v email_reply_to_address - Reply-to address to be used when sending emails.This is useful for troubleshooting errors in email addresses.
v system_name - Name used as the sender's name when sending email messages.v defaultuser - Default user to be used if no user is specified for the CLI. If null,
a user must be specified.v snmp_sysname - SNMP system name as shown in the SNMP MIB.
(.1.3.6.1.2.1.1.5.0)v snmp_location - SNMP location as shown in the SNMP MIB. (.1.3.6.1.2.1.1.6.0)v snmp_contact - SNMP contact as shown in the SNMP MIB. (.1.3.6.1.2.1.1.4.0 )v email_subject_format - Controls the formatting of the email subject line. To
insert the event's data, use the following tags: {severity}, {description}, or{system_name}. System default is "{severity}: {description}".
v ntp_server - IP address or DNS name of the NTP server.v snmp_community - Community used for SNMP queries of the system.v snmp_trap_community - Community used for SNMP traps sent by the system.
Example:
config_set name=dns_secondary value=10.0.0.119
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv UNRECOGNIZED_CONFIG_PARAMETER
Unrecognized configuration parameter: 'name'.Troubleshooting: Use a valid configuration parameter as an input.
v READ_ONLY_CONFIG_PARAMETER
Configuration parameter: 'name' is read-only.Troubleshooting: You cannot modify read-only parameters.
v IPV4_NOT_CONFIGURED
IPv4 address is not configured on management interfaceTroubleshooting: Define IPv4 addrress for management before disabling IPv6
v RULE_WITH_SNMP_DEST_EXISTS
Can not set snmp_type to none. There is a rule that contains SNMP destination.
Chapter 8. System management commands 149
Testing the DNSUse the dns_test command to test the DNS (Domain Naming Service).
dns_test name=Name [ type=<A|AAAA> ]
Parameters
Name Description Mandatory Default
name Name of the host to beresolved.
Y N/A
type Type of query. N According to the DNSserver type
This command attempts to translate the DNS name into an IP address. Translationis attempted through each of the defined DNS servers.
This command fails if no DNS servers are defined. A failure of the translation froma name to an IP address is not considered a failure of the command.
The result of each defined DNS server is displayed.
Field ID Field output Default position
name Name 1
primary_ip IP (Primary DNS) 2
secondary_ip IP (Secondary DNS) 3
Example:
dns_test name=hermes.xiv
Output:
Name IP (Primary DNS) IP (Secondary DNS)------------ ------------------ --------------------hermes.xiv 212.143.102.243 Not Found
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv DNS_SERVER_NOT_DEFINED
No DNS servers are defined
150 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Displaying helpUse the help command to display system help.
help [ category=Category | search=SearchString | command=CommandName ]
Parameters
Name Type Description Mandatory
category String Category name. N
search String Search string. N
command String Command name. N
This command displays the help as follows:v No parameters - Lists all the commands with their short descriptions, grouped
by categories.v Category - Lists all the commands in the category, with their short descriptions.v Search - Lists the short descriptions of all the commands in which the search
string appears in their name or short description.v Command with short output (default for command) - Displays the command
name and short description.v Command with full output (default when used in XIV-internal mode) - Displays
the command name, short description, syntax, list of parameters and theirdescription, types and default values. If output is table, displays all possibletable columns.
Example:
help category=volume
Output:
Category Name Description
volume vol_copy Copies a source volume onto a target volume.
volume vol_create Creates a new volume.
volume vol_delete Deletes a volume
volume vol_format Formats a volume.
volume vol_list Lists all volumes, or a specific one.
volume vol_lock Locks a volume, so that it is read-only.
volume vol_rename Renames a volume
volume vol_resize Resizes a volume
volume vol_unlock Unlocks a volume, so that it is no longer read-only,and can be written to.
Field ID Field output Default position
category Category 1
name Name 2
Chapter 8. System management commands 151
Field ID Field output Default position
access_control Access Control N/A
syntax Syntax N/A
fields Fields N/A
description Description 3
example Example N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Displaying the current maintenance urgencyUse the maintenance_urgency_list to display the current maintenance urgency ofthe system.
maintenance_urgency_list
Example:
maintenance_urgency_list
Output:
maintenance_urgency = "NONE"
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Shutting down the systemUse the shutdown command to shut down the system.
shutdown [ emergency=<yes|no> ]
152 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
emergency Boolean Instructs thesystem to shutdown within atimeout even ifsome of the diskscould not besaved, much likein an emergencyshutdownperformed whenthe system losespower.
N no
The system stops serving hosts, de-stages all information to disks and then turnsitself off. If the emergency parameter is defined, the system shuts down within thetimeout period.
NOTE: USING THIS OPTION MAY CAUSE DATA LOSS.
Example:
shutdown
Output:
Command executed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_SHUT_DOWN
Are you sure you want to shut down the machine and all its components?
Return codesv COMMAND_IS_NOT_VALID_IN_CURRENT_SYSTEM_STATE
The requested command cannot be invoked in the current system statev FIRMWARE_UPGRADE_IN_PROGRESS
Firmware upgrade in progressTroubleshooting: Contact support
v FLASH_CCL_IN_PROGRESS
Chapter 8. System management commands 153
The requested command cannot be invoked while Flash Enclosure CCL is inprogress.Troubleshooting: Wait for Flash CCL to complete
Listing the operational stateUse the state_list command to display the current operational state of thesystem.
state_list
Field ID Field output Default position
category Category 1
value Value 2
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Displaying system usage and data reduction statisticsUse the system_usage_get command to retrieve system-wide usage and datareduction related statistics.
system_usage_get
The command provides various information on system usage, and on datareduction, including:v the sum of all user volume and snapshot sizes, excluding internal volumes
(statistics and metadata)v the sum of all logical block address (LBA) ranges written to the currently
existing volumes and snapshotsv savings due to thin provisioningv savings due to data reductionv deduplication and compression factors.
The data retrieved by the command may vary due to currently runningbackground processes.
Example:
system_usage_get
Output:
154 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Volumes and Snapshots (GB) Thin Provisioning Savings (%) Total Written (GB)---------------------------- ------------------------------- --------------------3100 90 340
Data Reduction Savings (%) Total Stored (GB) Deduplication Factor Compression Factor---------------------------- ------------------- ---------------------- --------------------87 45 1.37 5.63
Field ID Field output Default position
total_volumes_and_snapshots Volumes and Snapshots (GB) 1
thin_provisioning_savings Thin Provisioning Savings (%) 2
total_written Total Written (GB) 3
data_reduction_savings Data Reduction Savings (%) 4
total_stored Total Stored (GB) 5
deduplication_factor Deduplication Factor 6
compression_factor Compression Factor 7
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Displaying information about effective and physical capacityUse the system_capacity_list command to display information about the system'seffective and physical capacity.
system_capacity_list
The command output displays two lines of information: one for the effectivecapacity, and one for the physical capacity.
Effective capacity
Effective capacity represents a realistic expectation of how much can be written tothe system. This value is based on the authorized user's individual assessment andis usually 3-5 times the physical capacity. It does not actually constrain pool ordomain allocations, but rather serves as a frame of reference.
The command output for effective capacity includes the following fields:v Total — The system's total effective capacity in GB.v Allocated (GB) — The sum of all effective capacity provisioned to domains, and
to pools in the default domain. The value is represented in GB.v Allocated (%) — The allocated capacity, represented as percentage of the total
capacity. The value may exceed 100%.
Chapter 8. System management commands 155
v Free (GB) — The difference between the total and allocated capacity in GB. Ifthe allocated capacity is larger than total, the value of this field will be zero.
v Free (%) — The free capacity, represented as percentage of the total capacity.
Physical capacity
Physical capacity is the non-volatile storage with physical constraints. It is theusable flash capacity, to the exact extent that the storage system can realize it.
The command output for physical capacity includes the following fields:v Total — The system's total physical capacity in GB.v Allocated (GB) — The consumed physical capacity, represented in GB.v Allocated (%) — The allocated capacity, represented as percentage of the total
capacity.v Free (GB) — The difference between the total and allocated capacity in GB.v Free (%) — The free capacity, represented as percentage of the total capacity.
Example:
system_capacity_list
Output:
Type Total (GB) Allocated (GB) Allocated (%) Free (GB) Free (%)----------- ----------- --------------- -------------- ---------- ---------Effective 198450 50640 25 147810 75Physical 16530 1400 8 15130 92
Field ID Field output Default position
type Type 1
total Total (GB) 2
allocated Allocated (GB) 3
allocated_percent Allocated (%) 4
free Free (GB) 5
free_percent Free (%) 6
total_MiB Total (MiB) N/A
allocated_MiB Allocated (MiB) N/A
free_MiB Free (MiB) N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
156 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Displaying information about effective capacityUse the system_effective_capacity_get command to display additionalinformation about the system's effective capacity.
system_effective_capacity_get
This command displays additional information about the system's effectivecapacity, in particular about the effective capacity limits:v the effective capacity limit, that depends on the current system configurationv the default limit, that depends on the system configurationv the minimum and maximum limits, that depend on the system configuration.
Example:
system_effective_capacity_get
Output:
Limit (GB) Effective (GB) Effective Factor------------ ---------------- ------------------1400071 217582 5
Field ID Field output Default position
effective_capacity_limit Limit (GB) 1
effective_capacity Effective (GB) 2
effective_capacity_factor Effective Factor 3
effective_capacity_max_limit Max. Limit (GB) N/A
effective_capacity_default_limit
Default Limit (GB) N/A
effective_capacity_min_limit Min. Limit (GB) N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Displaying system capacity thresholdsUse the system_capacity_threshold_list command to list the current systemcapacity thresholds.
system_capacity_threshold_list
Chapter 8. System management commands 157
A user can define up to 8 progressive thresholds that will trigger events aboutphysical capacity consumption, as per the system_capacity_list command (see“Displaying information about effective and physical capacity” on page 155). Anevent of the configured severity is emitted once if the configured threshold value isexceeded, and an informational event is emitted when capacity recedes below thethreshold minus the hysteresis.
For example, if a threshold is set at 85% and the hysteresis is set at 3%:v a SYSTEM_CAPACITY_USAGE_INCREASED event is emitted when system capacity used
in percent (per system_capacity_list) moves from a value below 85% to a valueof 85% or more
v the matching SYSTEM_CAPACITY_USAGE_DECREASED event is emitted when systemcapacity used moves from a value greater than 82% down to a value of 82% orless.
The output includes the following fields:v The ordinal of the threshold (between 1 and 8)v Threshold value in percent (between 10 and 99)v Severity of the eventv Hysteresis value (between 1 and 10, same for all thresholds)v Indication whether the threshold is enabled or not
Example:
system_capacity_threshold_list
Output:
Ordinal Threshold (%) Severity Hysteresis (%) Enabled--------- --------------- ---------- ---------------- ---------1 70 Warning 3 yes2 75 Minor 3 yes3 80 Minor 3 yes4 85 Major 3 yes5 90 Major 3 yes6 95 Critical 3 yes7 97 Critical 3 yes8 99 Critical 3 yes
Field ID Field output Default position
ordinal Ordinal 1
threshold Threshold (%) 2
severity Severity 3
hysteresis Hysteresis (%) 4
enabled Enabled 5
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
158 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission
Read-only users Disallowed
Technicians Allowed
Changing a system capacity thresholdUse the system_capacity_threshold_change command to change a system capacitythreshold.
system_capacity_threshold_change hysteresis=HysteresisValue | < ordinal=Ordinal [ enabled=<yes|no> ] [ threshold=ThresholdValue ] [ severity=<WARNING|MINOR|MAJOR|CRITICAL> ] >
The user can define progressive thresholds that will trigger events about physicalcapacity consumption. An event of the configured severity is issued once if theconfigured threshold value is exceeded, and an informational all-clear event isissued, when capacity drops below the threshold minus the hysteresis.
Parameters:
Name Type Description Mandatory Default
hysteresis Integer The hysteresisvalue in per cent(same for allthresholds).
N N/A
ordinal Integer The ordinal of thethreshold.
N N/A
enabled Boolean Enable or disablesystem capacitythreshold.
N yes
threshold Integer The new thresholdvalue in percent,strictlymonotonicallyincreasing acrossthresholds.
N No threshold
severity N/A The new severityvalue, strictlymonotonicallyincreasing acrossthresholds.
N No severity
Example:
system_capacity_threshold_change hysteresis=3
This command changes the hysteresis of the system capacity.
Example:
system_capacity_threshold_change ordinal=1 enabled=yes threshold=15 severity=WARNING
This command enables ordinal 1 and changes the threshold and severityparameters of the system capacity.
Chapter 8. System management commands 159
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv SYSTEM_CAPACITY_DUPLICATE_THRESHOLD
New threshold value is duplicating another threshold.v SYSTEM_CAPACITY_THRESHOLD_NOT_MONOTONIC
Threshold value or severity must be monotonic.
Resuming the system's normal operationUse the system_resume_normal_operation command to move a system back toread-write state after it ran out of physical space.
system_resume_normal_operation
Example:
system_resume_normal_operation
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_RESUME_NORMAL_OPERATION
The system is still very close to full. Are you sure you want to resume normaloperation?
Return codesv SYSTEM_IS_STILL_OUT_OF_PHYSICAL_SPACE
The system is still out of physical space, normal operation cannot be resumed.
160 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v SYSTEM_ALREADY_OPERATING_NORMALLY
The system is already operating normally.
Displaying the current timeUse the time_list command to display the current system time.
time_list
This command shows the current time, date and time zone.
Field ID Field output Default position
time Time 1
date Date 2
timezone Time Zone 3
dst Daylight Saving Time 4
Example:
time_list
Output:
Time Date Time Zone Daylight Saving Time---------- ------------ ---------------- ----------------------10:09:47 2008-02-19 Asia/Jerusalem no
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Setting the system's timeUse the time_set command to set the system's time in YYYY-MM-DD.HH:MM:SSformat.
time_set time=Timestamp
Parameters
Name Description Mandatory
time New current time. Y
Example:
Chapter 8. System management commands 161
time_set time=2016-03-04.03:02:01
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv SYSTEM_TIME_NOT_CHANGED
System time was not changedTroubleshooting: Please try again.
v FLASH_ENCLOSURE_TIME_UPDATE_FAILED
Failed to update flash enclosure timeTroubleshooting: Please try again.
v BAD_TIMESTAMP
Timestamp cannot be deciphered
Listing optional time zonesUse the timezone_list command to list all optional time zones.
timezone_list
Standard POSIX time zones are used. http://www.timeanddate.com/worldclock/provides a full description of all time zones.
Example:
timezone_list
Output:
Timezone----------------------------------Africa/AbidjanAfrica/Accra
...
WETZulu
162 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
name Timezone 1
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Setting the time zoneUse the timezone_set command to set the time zone of the system.
timezone_set timezone=TimeZone
Parameters
Name Type Description Mandatory
timezone String New time zone of thesystem.
Y
See Listing optional time zones for a complete list of optional time zones.
Standard POSIX time zones are used. http://www.timeanddate.com/worldclock/provides a full description of all time zones.
Example:
timezone_set timezone=Etc/GMT+1
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Chapter 8. System management commands 163
Return codesv BAD_TIMEZONE_NAME
Timezone is not recognized by the system
Printing the current system versionUse the version_get command to print the current version of the system.
version_get
Field ID Field output Default position
system_version Version 1
Example:
version_get
Output:
Version10.2
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Displaying the values of VPD parametersUse the vpd_config_get command to display the values of VPD parameters.
vpd_config_get [ name=Name ]
Parameters
Name Type Description Mandatory Default
name String Name of theparameter to print.
N All parameters.
Field ID Field output Default position
name Name 1
value Value 2
See Setting VPD parameters for a full list of available settings.
164 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Example:
vpd_config_get name=site.city
Output:
Name Value----------- --------site.city Gotham
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv CONF_SERVER_UNREACHABLE
Configuration server unreachablev UNRECOGNIZED_CONFIG_PARAMETER
Unrecognized configuration parameter: 'name'.Troubleshooting: Use a valid configuration parameter as an input.
Setting VPD parametersUse the vpd_config_set command to set the values of VPD (Vital Product Data)parameters.
vpd_config_set name=Name value=ParamValue
Parameters
Name Type Description Mandatory
name String Name of the parameterto set.
Y
value String Value of the parameter. Y
This command sets the following values of VPD parameters, where only the nameis mandatory.:v customer.name
v customer.primary_contact.calling_hours
v customer.primary_contact.email
v customer.primary_contact.mobile_phone
v customer.primary_contact.name
v customer.primary_contact.office_phone
Chapter 8. System management commands 165
v customer.primary_contact.time_zone
v customer.secondary_contact.calling_hours
v customer.secondary_contact.email
v customer.secondary_contact.mobile_phone
v customer.secondary_contact.name
v customer.secondary_contact.office_phone
v customer.secondary_contact.time_zone
v hardware_info.hw_cable_bundle
v hardware_info.hw_door
v hardware_info.hw_patch_panel
v hardware_info.hw_patch_panel_label
v hardware_info.hw_power_cable_config
v hardware_info.hw_rack_type
v hardware_info.hw_rps
v interface_config.model
v machine_model
v machine_type
v main_ibm_contact.calling_hours
v main_ibm_contact.email
v main_ibm_contact.mobile_phone
v main_ibm_contact.name
v main_ibm_contact.office_phone
v main_ibm_contact.time_zone
v non_mutable_vpd_info.original_flashed_version
v non_mutable_vpd_info.original_flashing_date
v disk_size
v remote_support.customer_contact.calling_hours
v remote_support.customer_contact.email
v remote_support.customer_contact.mobile_phone
v remote_support.customer_contact.name
v remote_support.customer_contact.office_phone
v remote_support.customer_contact.time_zone
v remote_support.modem_phone_number
v remote_support.primary_ibm_ip
v remote_support.secondary_ibm_ip
v remote_support.special_instructions
v remote_support.vpn_ip_1
v remote_support.vpn_ip_2
v site.building_location
v site.city site.country
v site.name
v site.postal_code
v site.state
v site.street_address
v system_info.sys_ec_level
166 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v system_info.sys_hw_level
v system_info.PID
Example:
vpd_config_set name= value=
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv READ_ONLY_CONFIG_PARAMETER
Configuration parameter: 'name' is read-only.Troubleshooting: You cannot modify read-only parameters.
v UNRECOGNIZED_CONFIG_PARAMETER
Unrecognized configuration parameter: 'name'.Troubleshooting: Use a valid configuration parameter as an input.
Displaying the system's MIB fileUse the mib_get command to display the system's MIB file.
mib_get
Field ID Default position
line 1
Example:
mib_get
Output:
Chapter 8. System management commands 167
-------------------------------------------------------------------------------------------------------------------------------------------- -*- SNMP -*- mode for EmacsXIV-MIB DEFINITIONS ::= BEGIN
IMPORTSMODULE-IDENTITY, OBJECT-TYPE,
NOTIFICATION-TYPE,Gauge32, Integer32 FROM SNMPv2-SMI
ucdavis FROM UCD-SNMP-MIBOBJECT-GROUP, NOTIFICATION-GROUP,
MODULE-COMPLIANCE FROM SNMPv2-CONF
TEXTUAL-CONVENTION, DisplayStringFROM SNMPv2-TC;
...
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv CANNOT_READ_FROM_FILE
Cannot read from file 'Filename'Troubleshooting: Contact support
Retrieving the electronic license acceptance statusUse the elicense_status_get command to retrieve the electronic license acceptancestatus.
elicense_status_get
Example:
elicense_status_get
Output:
Status----------Accepted
Field ID Field output Default position
status Status 1
168 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Retrieving a fragment of the electronic license fileUse the elicense_blob_get command to retrieve a fragment of the electroniclicense file.
elicense_blob_get beg=BeginIndex size=Number
Parameters
Name Type Description Mandatory
beg Positive integer Beginning of thefragment in bytes.
Y
size Positive integer Length of the fragmentin bytes. The maximumlength allowed is1000000.
Y
Example:
elicense_blob_get beg=0 size=20
Output:
<file_size value="1300473"/><fragment value="425a6839314159265359ba94ca1106dd587f84fe"/><fragment_size value="20"/>
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Return codesv CANNOT_READ_FROM_FILE
Cannot read from file 'Filename'
Chapter 8. System management commands 169
Troubleshooting: Contact support
Accepting the electronic license agreementUse the elicense_accept command to accept the electronic license agreement.
elicense_accept version=Version [ approver_name=UserName ]
Parameters
Name Type Description Mandatory Default
version String The electroniclicense version.
Y N/A
approver_name String The approver'sname.
N none
Example:
elicense_accept version approver_name
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv ELICENSE_INCOMPATIBLE_VERSION
The accepted version of the Electronic license dose not match the current versionTroubleshooting: Please retrieve the current electronic license version and acceptit
v ELICENSE_ALREADY_ACCEPTED
Electronic license already acceptedTroubleshooting: You do not need to accept the electronic license
v ELICENSE_DISABLED
Electronic license check is disabledTroubleshooting: You do not need to accept the electronic license
Enabling command auditingUse the audit_enable command to enable CLI command auditing
audit_enable
This command is used by a security administrator to enable the auditing ofuser-entered CLI commands on an external auditing server. For this command to
170 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
complete successfully, the current auditing state must be DISABLED (that is, theaudit_show command returns a no), and at least one audit server must beconfigured successfully by the audit_config_set command.
Example:
xcli -u -c XIV1 audit_enable
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv AUDIT_ALREADY_ENABLED
Command auditing already enabled.v AUDIT_NO_AUDIT_SERVER_DEFINED
No audit logging server is configured.
Disabling command auditingUse the audit_disable command to disable CLI command auditing.
audit_disable
This command disables command auditing, provided that auditing is currentlyenabled, that is the audit_show command returns a yes.
Example:
audit_disable -y
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Chapter 8. System management commands 171
User Category Permission
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv AUDIT_NOT_ENABLED
Command auditing is not enabled.
Displaying the command audit stateUse the audit_show command to show the current state of CLI command auditing.
audit_show
Field ID Field output Default position
audit_enabled Auditing Enabled 1
Example:
audit_show
Output:
Auditing Enabled------------------yes
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Configuring audit serversUse the audit_config_set command to configure CLI command auditing.
audit_config_set primary_server=Address [ primary_port=port ] [ secondary_server=Address ][ secondary_port=port ] [ protocol=protocol ]
172 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
primary_server N/A IP address of theprimary auditingserver.
Y N/A
primary_port Positive integer IP port number ofthe primaryauditing server.
N Default forprotocol
secondary_server N/A IP address of thesecondary auditingserver.
N empty
secondary_port Positive integer IP port number ofthe secondaryauditing server.
N Default forprotocol
protocol Enumeration Transport protocol.Only RFC-5424Syslog over UDPis currentlysupported.
N syslog
This command configures the primary and, optionally, the secondary auditingserver for CLI command logging.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Checking the command audit stateUse the audit_config_get command to show the current configuration of CLIcommand auditing.
audit_config_get
Field ID Field output Default position
primary_server Primary Server 1
primary_port Primary Port 2
secondary_server Secondary Server 3
secondary_port Secondary Port 4
audit_protocol Protocol 5
Example:
audit_config_get
Chapter 8. System management commands 173
Output:
Primary Server Primary Port Secondary Server Secondary Port Protocol---------------- -------------- ------------------ ---------------- ----------198.51.100.42 514 0 syslog
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Retrieving the list of Flash VDisksUse the flash_vdisk_list command to retrieve the list of Flash VDisks
flash_vdisk_list
Example:
flash_vdisk_list
Output:
Name Enclosure Id Status ID Lun--------------- --------------------- -------- ---- ------------------xiv_vdisk_2_0 1:Flash_Enclosure:2 OK 0 0000000000000000
Capacity(bytes) Block Size----------------- ------------5717176090624 512
Field ID Field output Default position
name Name 1
enclosure_id Enclosure Id 2
status Raid Status 3
vdisk_id ID 4
lun Lun 5
capacity_in_gb Capacity(GB) 6
block_size Block Size(bytes) 7
capacity_in_gib Capacity(GiB) N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
174 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Enabling CIM serviceUse the cim_enable command to enable the CIM service.
cim_enable
This command enables the CIM service and the associated SLP service. In order forthis command to complete successfully, the current CIM service state must beDISABLED (that is, the cim_show command returns no).
Example:
cim_enable
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CIM_ALREADY_ENABLED
CIM port already enabled.
Disabling the CIM serviceUse the cim_disable command to disable the CIM service.
cim_disable
This command disables the CIM service and the associated SLP service. In orderfor this command to complete successfully, the current CIM service state must beENABLED (that is, the cim_show command returns yes).
Example:
Chapter 8. System management commands 175
cim_disable
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CIM_NOT_ENABLED
CIM port is not enabled.
Displaying the CIM service stateUse the cim_show command to display the current state of CIM service.
cim_show
Field ID Field output Default position
cim_enabled CIM Enabled 1
Example:
cim_show
Output:
CIM Enabled------------------yes
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
176 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 9. Remote target connectivity commands
This section describes the command-line interface (CLI) for defining remote targetconnectivity.
Setting the threshold of a link disruption duration that triggers anevent
Use the target_change_connection_threshold command to set the threshold of alink disruption that lasts more than a specified duration.
target_change_connection_threshold target=TargetName [ duration=duration ]
Parameters
Name Type Description Mandatory Default
duration Integer Duration for linkdown that willtrigger an event, inseconds. Validvalue is between 1and 1000000seconds.
N 30
target Object name The name of thetarget system forwhich thethreshold is set.
Y N/A
This command is used to set the duration of a link disruption that will trigger anevent.
Example:
target_change_connection_threshold target="XIV MN00043" duration=25
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_BAD_NAME
Target name does not existv TARGET_INVALID_CONNECTION_DURATION_THRESHOLD
© Copyright IBM Corp. 2016 177
Target connection duration threshold should be in [1,1000000] range
Updating the target's mirroring configurationUse the target_config_sync_rates command to change the target's mirroringconfiguration.
target_config_sync_rates target=TargetName [ max_initialization_rate=MaxInitializationRate ][ max_syncjob_rate=MaxSyncjobRate ] [ max_resync_rate=MaxResyncRate ]
Parameters
Name Type Description Mandatory Default
target Object name The updatedtarget.
Y N/A
max_initialization_rate
Positive integer Specifies themaximum rate forinitialsynchronization.Cannot be largerthanmax_syncjob_rate.
N Unchanged
max_syncjob_rate Positive integer Specifies thedefault maximumrate for sync jobsynchronization.Cannot be largerthanmax_resync_rate.
N Unchanged
max_resync_rate Positive integer Specifies themaximum rate forre-synchronization
N Unchanged
This command changes the system ID of the remote target. The synchronizationrate units are MB per second. The default rates are: 100 MB/s for initialization rate,300 MB/s for resync rate. The default system_id is the value that is set with theconfig_set command.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_BAD_NAME
Target name does not existv TARGET_ILLEGAL_RATE_VALUES
max init rate should be smaller or equal to max sync job rate. max sync job rateshould not be greater than max resync rate.
178 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Activating connectivity to a remote targetUse the target_connectivity_activate command to activate connectivity betweena port on the local storage system and a port on a remote target.
target_connectivity_activate target=TargetName< ipaddress=IPaddress local_ipinterface=IPInterface > |< fcaddress=wwpn local_port=PortID >
Parameters
Name Type Description Mandatory
target Object name Remote target of theconnectivity definition.
Y
ipaddress N/A IP address of the porton the remote target(iSCSI targets only).
N
local_ipinterface Object name Local IP interface to beconnected to the remoteport (iSCSI only)
N
fcaddress N/A FC address of the porton the remote target(FC targets only).
N
local_port N/A Port identifier. N
Each connectivity definition can be either active or inactive. The system does notuse inactive connectivity definitions. Target connectivity is active by default.
This command has no effect if the connectivity is already active.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_BAD_NAME
Target name does not existv CONNECTIVITY_NOT_DEFINED
Remote port is not connected through this local portv COMPONENT_IS_NOT_AN_FC_PORT
Component must specify an FC portv COMMAND_NOT_ALLOWED_ON_MANAGEMENT_OR_VPN_INTERFACE
Operation is not allowed on Management or VPN IP Interfacev IPINTERFACE_DOES_NOT_EXIST
IP Interface name does not exist
Chapter 9. Remote target connectivity commands 179
v TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote targetv BAD_LOCAL_IP_PORT
An ID of a local IP port must be specified
Deactivating connectivity to a remote targetUse the target_connectivity_deactivate command to deactivate connectivitybetween a port on the local storage system and a port on a remote target.
target_connectivity_deactivate target=TargetName< ipaddress=IPaddress local_ipinterface=IPInterface > |< fcaddress=wwpn local_port=PortID > [ force_on_olvm_peer=<yes|no> ]
Parameters
Name Type Description Mandatory Default
target Object name Remote target ofthe connectivitydefinition.
Y N/A
ipaddress N/A IP address of theport on the remotetarget (iSCSItargets only).
N N/A
local_ipinterface Object name Local IP interfacethat is connectedto the remote port(iSCSI only).
N N/A
fcaddress N/A FC address of theport on the remotetarget (FC targetsonly).
N N/A
local_port N/A Port identifier. N N/A
force_on_olvm_peer
Boolean Reserved N No
This command deactivates connectivity.
Each connectivity definition can be either active or inactive. The system does notuse inactive connectivity definitions. Target connectivity is active by default.Connectivity can be reactivated using Activating connectivity to a remote target.
This command has no effect if the connectivity is already deactivated.
Example:
target_connectivity_deactivatetarget=Nextra2 local_module=101
Output:
Command completed successfully
180 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_BAD_NAME
Target name does not existv COMMAND_NOT_ALLOWED_ON_MANAGEMENT_OR_VPN_INTERFACE
Operation is not allowed on Management or VPN IP Interfacev CONNECTIVITY_NOT_DEFINED
Remote port is not connected through this local portv COMPONENT_IS_NOT_AN_FC_PORT
Component must specify an FC portv TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote targetv BAD_LOCAL_IP_PORT
An ID of a local IP port must be specifiedv IPINTERFACE_DOES_NOT_EXIST
IP Interface name does not exist
Defining connectivity to a remote targetUse the target_connectivity_define command to define connectivity between aport on the local storage system and a port on a remote target.
target_connectivity_define target=TargetName< ipaddress=IPaddress local_ipinterface=IPInterface > |< fcaddress=wwpn local_port=PortID >
Parameters
Name Type Description Mandatory
target Object name Remote target of theconnectivity definition.
Y
ipaddress N/A IP address of the porton the remote target(iSCSI targets only).
N
local_ipinterface Object name Local IP interface to beconnected to the remoteport (iSCSI only).
N
fcaddress N/A FC address of the porton the remote target(FC targets only).
N
local_port N/A FC port (FC only). N
Chapter 9. Remote target connectivity commands 181
Connectivity between a local and a target storage system is defined between aspecific port on a local storage system and a port on the target storage system.
Each connectivity definition can be either active or inactive. The system does notuse inactive connectivity definitions. Target connectivity is active by default. Anoption is provided to de-activate (target_connectivity_deactivate) and thenre-activate (target_connectivity_activate) it, if required. Target connectivity canbe deleted (Deleting connectivity to a remote target) and a list of targetconnectivity definitions (Listing target connectivity definitions) can be displayed.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_BAD_NAME
Target name does not existv CONN_EXISTS
Remote port is already connected through this local portv MAX_CONNECTIONS_REACHED
Maximum number of connections already definedv MAX_ISCSI_CONNECTIONS_PER_MODULE_REACHED
Maximal number of iSCSI connectivities already defined for that module.v COMPONENT_IS_NOT_AN_FC_PORT
Component must specify an FC portv COMPONENT_IS_NOT_FC_INITIATOR_PORT
Component must specify FC initiator portv BAD_LOCAL_IP_PORT
An ID of a local IP port must be specifiedv COMMAND_NOT_ALLOWED_ON_MANAGEMENT_OR_VPN_INTERFACE
Operation is not allowed on Management or VPN IP Interfacev IPINTERFACE_DOES_NOT_EXIST
IP Interface name does not existv TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote target
182 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Deleting connectivity to a remote targetUse the target_connectivity_delete command to delete connectivity between aport on the local storage system and a port on a remote target.
target_connectivity_delete target=TargetName< ipaddress=IPaddress local_ipinterface=IPInterface > |< fcaddress=wwpn local_port=PortID > [ force_on_olvm_peer=<yes|no> ]
Parameters
Name Type Description Mandatory Default
target Object name Remote target ofthe connectivitydefinition.
Y N/A
ipaddress N/A IP address of theport on the remotetarget (iSCSItargets only).
N N/A
local_ipinterface Object name Local IP interfacethat is connectedto the remote port(iSCSI only).
N N/A
fcaddress N/A FC address of theport on the remotetarget (FC targetsonly).
N N/A
local_port N/A Port number onthe local module(FC only).
N N/A
force_on_olvm_peer
Boolean Reserved N No
Only a previously defined connectivity definition can be deleted.
Example:
target_connectivity_delete target=XIV2 local_module=101
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Chapter 9. Remote target connectivity commands 183
Return codesv TARGET_BAD_NAME
Target name does not existv COMMAND_NOT_ALLOWED_ON_MANAGEMENT_OR_VPN_INTERFACE
Operation is not allowed on Management or VPN IP Interfacev CONNECTIVITY_NOT_DEFINED
Remote port is not connected through this local portv COMPONENT_IS_NOT_AN_FC_PORT
Component must specify an FC portv TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote targetv BAD_LOCAL_IP_PORT
An ID of a local IP port must be specifiedv IPINTERFACE_DOES_NOT_EXIST
IP Interface name does not exist
Listing target connectivity definitionsUse the target_connectivity_list command to list all the connectivity definitionsof a remote target.
target_connectivity_list [ target=TargetName ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
target Object name Target name that islisted.
N All targets
domain Object name The domain name. N All Domains
Field ID Field output Default position
target_name Target Name 1
remote_port_address Remote Port 2
local_fc_port FC Port 3
local_ip_port IP Interface 4
active Active 5
up Up 6
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
184 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Defining a remote targetUse the target_define command to define a new remote target for remotemirroring or data migration.
target_define target=TargetName protocol=<FC|iSCSI> [ iscsi_name=iSCSIName ][ xiv_features=<yes|no> ] [ system_id=SystemId ] [ domain=DomainList ]
Parameters
Name Type Description Mandatory Default
target Object name Local name of theremote target.
Y N/A
protocol Enumeration FC (Fiber Channel)or iSCSI,depending on thecommunicationprotocol supportedby the remote host.
Y N/A
iscsi_name iSCSI initiatorname
iSCSI name of theremote target. Thisfield is mandatoryfor iSCSI hosts.
N N/A
system_id String ID of the remotesystem. Should bethe same as theoutput of thesystem_idparameter on theremote system (seeDisplaying thevalues ofconfigurationparameters.
N N/A
xiv_features Boolean Defines the remotesystem as an XIVsystem. Non-XIVsystems are usedonly for datamigration.
N Yes
domain N/A The cluster will beattached to thespecified domains.To define morethan one domain,separate them witha comma. Tospecify all existingdomains, use "*".
N none
This command defines the communication topology between a local storage systemand a remote storage system to enable various features, such as remote mirroring.The local storage system can write to or read from the remote storage system, orallow the target storage system to write to or read from it.
The first step when defining a new target connectivity is to specify the name of theremote storage system and the protocol used to communicate with it. There aretwo possible protocols: Fiber Channel (FC) and iSCSI. Each remote target isavailable through only one of these protocols.
Chapter 9. Remote target connectivity commands 185
This step only defines the remote system object. No connectivity definitions aredefined yet and no communications are performed yet.
Once you have defined a remote target, the only way to change its protocol type isto delete the remote target and define it again.
Example:
target_define target=Nextra2 protocol=FC
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DEFINE_ANOTHER_TARGET_ON_SYSTEM
Defining more than one target to the same remote system is not supported, andmay compromise the data on the slave system. Are you sure the remote systemis not already defined as a target?
Return codesv MAX_TARGETS_REACHED
Maximum number of targets already definedv TARGET_NAME_EXISTS
Target name is already assigned to another targetv TARGET_ISCSI_MUST_HAVE_A_NAME
iSCSI Target must have an iscsi_namev ISCSI_NAME_NOT_ALLOWED_FOR_FC
FC Target does not have an iscsi_namev TARGET_BAD_SCSI_TYPE
Target SCSI type does not existv DOMAIN_DOESNT_EXIST
Domain does not exist.
186 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Deleting a remote targetUse the target_delete command to delete the definition of the specified remotetarget.
target_delete target=TargetName [ force_on_olvm_peer=<yes|no> ]
Parameters
Name Type Description Mandatory Default
target Object name Target that isdeleted.
Y N/A
force_on_olvm_peer
Boolean Reserved N No
A target that contains port definitions cannot be deleted. A target with remotemirroring or data migration definitions cannot be deleted.
Example:
target_delete target=Nextra2
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_BAD_NAME
Target name does not existv TARGET_HAS_PORTS
Ports are defined for this targetv TARGET_HAS_ASSOCIATIONS
Remote volumes are defined on this target
Listing remote targetsUse the target_list command to list a specified remote target definition, or alltarget definitions.
target_list [ target=TargetName ] [ domain=DomainName ]
Chapter 9. Remote target connectivity commands 187
Parameters
Name Type Description Mandatory Default
target Object name Target name that islisted.
N All targets
domain Object name The domain name. N All Domains
The following is listed for each target: port groups, ports, active/inactive status foreach port, and the following mirroring-related values: max initialization rate, maxresync rate, and max sync job rate.
Field ID Field output Default position
name Name 1
scsi_type SCSI Type 2
connected Connected 3
xiv_target XIV Target N/A
iscsi_name iSCSI Name N/A
system_id System ID N/A
num_ports Number of Ports N/A
creator Creator N/A
max_initialization_rate Max Initialization Rate 4
max_resync_rate Max Resync Rate 5
max_syncjob_rate Max Syncjob Rate 6
connectivity_lost_event_threshold
Connection Threshold N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Activating a portUse the target_port_activate command to activate a port on a remote target.
target_port_activate target=TargetName < ipaddress=IPaddress | fcaddress=wwpn >
Parameters
Name Type Description Mandatory
target Object name Remote target of theport.
Y
ipaddress N/A IP address of the porton the remote target(iSCSI targets only).
N
188 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory
fcaddress N/A FC address of the porton the remote target(FC targets only).
N
Each port in a remote system can be configured as either active or inactive. Thesystem does not use inactive ports. After a port is defined, it is active by default.This command reactivates a port if it was de-activated (by using thetarget_port_deactivate command).
This command has no effect, if the port is already active.
Example:
target_port_activatetarget=Nextra2 fcaddress=10:00:00:17:38:27:ec:11
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote targetv TARGET_BAD_PORT_STATE
Port is already in requested activation statev TARGET_BAD_NAME
Target name does not exist
Adding a new port to a remote targetUse the target_port_add command to add a port to a remote target.
target_port_add target=TargetName < ipaddress=IPaddress | fcaddress=wwpn >
Parameters
Name Type Description Mandatory
target Object name Remote target to whichto add the port.
Y
Chapter 9. Remote target connectivity commands 189
Name Type Description Mandatory
ipaddress N/A IP address of the porton the remote target(for iSCSI type targetsonly).
N
fcaddress N/A FC address of theremote port (for FCtype targets only).
N
This command adds a new port to a specified target. A port can be either FC oriSCSI, and its type must conform to the remote target's communication protocoltype.
Specify the IP address or the FC address according to communication protocol ofthe target.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_BAD_NAME
Target name does not existv PORT_EXISTS
Port is already definedv MAX_PORTS_REACHED
Maximum number of ports already defined in the systemv TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote targetv ISCSI_HOST_ILLEGAL_PORT_NAME
Port name for iSCSI Host is illegalTroubleshooting: Port names for iSCSI Hosts must contain only printablecharacters.
v HOST_PORT_EXISTS
Host with this port ID already defined
Deactivating a portUse the target_port_deactivate command to deactivate a port of a remote target.
target_port_deactivate target=TargetName< ipaddress=IPaddress | fcaddress=wwpn > [ force_on_olvm_peer=<yes|no> ]
190 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
target Object name The remote targetthat includes theport to bedeactivated.
Y N/A
ipaddress N/A IP address of theport on the remotetarget (iSCSItargets only).
N N/A
fcaddress N/A FC address of theport on the remotetarget (FC targetsonly).
N N/A
force_on_olvm_peer
Boolean Reserved N No
Each port in a remote system can be configured as either active or in-active. Thesystem does not use an inactive port. After a port is defined, it is active by default.To re-activate a port, issue the target_port_activate command (see Activating aport).
Example:
target_port_deactivate target=XIV2 fcaddress=10:00:00:17:38:27:ec:11
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_BAD_NAME
Target name does not existv TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote targetv TARGET_BAD_PORT_STATE
Port is already in requested activation state
Chapter 9. Remote target connectivity commands 191
Deleting a port from a remote systemUse the target_port_delete command to delete a port from the specified remotetarget.
target_port_delete target=TargetName < ipaddress=IPaddress | fcaddress=wwpn >
Parameters
Name Type Description Mandatory
target Object name Remote target fromwhich the port is that isdeleted.
Y
ipaddress N/A IP address of the port(for iSCSI targets only).
N
fcaddress N/A FC address of theremote port (for FCtargets only).
N
Example:
target_port_deletetarget=Nextra2fcaddress=10:00:00:17:38:27:ec:11
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_BAD_NAME
Target name does not existv TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote targetv TARGET_PORT_HAS_CONNECTIVITY
Port has connectivity defined to it
192 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Listing the ports of a remote targetUse the target_port_list command to list all ports of a target.
target_port_list [ target=TargetName ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
target Object name Target for whichall ports should belisted.
N All systems
domain Object name The domain name. N All Domains
Field ID Field output Default position
target_name Target Name 1
scsi_type Port Type 2
active Active 3
fc_wwpn WWPN 4
iscsi_ip_addr iSCSI Address 5
iscsi_ip_port iSCSI Port 6
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Renaming a remote targetUse the target_rename command to rename a remote target.
target_rename target=TargetName new_name=Name
Parameters
Name Type Description Mandatory
target Object name Tne target to berenamed.
Y
new_name Object name New name of the target. Y
Example:
target_rename target=Nextra2 new_name=Nextra-DRP
Output:
Chapter 9. Remote target connectivity commands 193
Command executed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv TARGET_BAD_NAME
Target name does not existv TARGET_NAME_EXISTS
Target name is already assigned to another target
Updating the target configurationUse the target_update command to update the target's configuration.
target_update target=TargetName system_id=SystemId
Parameters
Name Type Description Mandatory
target Object name Target to be updated. Y
system_id String ID of the remotesystem. Should be thesame as the output ofDisplaying the values ofconfigurationparameters of thesystem_id variable onthe remote system.
Y
This command changes the system ID of the remote target.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
194 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Return codesv TARGET_BAD_NAME
Target name does not exist
Chapter 9. Remote target connectivity commands 195
196 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 10. Data migration commands
This section describes the command-line interface (CLI) for data migration.
Activating data migrationUse the dm_activate command to activate the data migration process.
dm_activate vol=VolName
Parameters
Name Type Description Mandatory
vol Object name The destination volumefor data migrationactivation.
Y
This command activates the data migration process. This is either an initialactivation or an activation after deactivation.
Upon activation, the data migration is tested in the same way as when usingdm_test (see Testing the data migration definition), and this command fails if thedata migration test fails.
This command has no effect if the process is already active.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv VOLUME_BAD_NAME
Volume name does not existv VOLUME_NO_DM
Local volume does not have Data Migration definitionsv TARGET_NOT_CONNECTED
There is currently no connection to the target systemv REMOTE_VOLUME_NO_LUN
Remote volume's LUN is unavailablev REMOTE_VOLUME_NO_READ_ACCESS
Remote volume cannot be read
© Copyright IBM Corp. 2016 197
v REMOTE_VOLUME_NO_WRITE_ACCESS
Remote volume is write protectedv BAD_REMOTE_VOLUME_SIZE
Master and slave volumes contain a different number of blocksv DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Deactivating data migrationUse the dm_deactivate command to deactivate the data migration process.
dm_deactivate vol=VolName
Parameters
Name Type Description Mandatory
vol Object name The local volume onwhich the datamigration process is tobe deactivated.
Y
Hosts are not served while the data migration process is inactive.
This command has no effect if the data migration process is already inactive.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DEACTIVATE_DATA_MIGRATION
Deactivation will stop all applications, data migration can be deleted if it is donev ARE_YOU_SURE_YOU_WANT_TO_DEACTIVATE_SOURCE_UPDATING_DATA_MIGRATION
Deactivation may cause loss of access to hosts, and will stop all applications.Data migration can be deleted if it is done
Return codesv VOLUME_BAD_NAME
Volume name does not existv VOLUME_NO_DM
Local volume does not have Data Migration definitionsv DATA_REDUCTION_TIER_IS_OFFLINE
198 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Defining data migration configurationUse the dm_define command to define a data migration configuration.
dm_define vol=VolName target=TargetName lun=SourceLUNsource_updating=<yes|no> [ create_vol=<yes|no> ] [ pool=PoolName ]
Parameters
Name Type Description Mandatory Default
vol Object name Data migrationdestination volumeon the localsystem.
Y N/A
target Object name Remote systemcontaining thesource volume.
Y N/A
lun Integer LUN of the sourcevolume.
Y N/A
source_updating Boolean Specifies whetherto use sourcevolume updating.
Y N/A
create_vol Boolean A Boolean thatdetermineswhether to create anew volume or touse an existingone.
N No
pool Object name Name of thestorage pool tocontain thevolume. Used onlywhen creating avolume.Mandatory whencreating a volume.
N N/A
This command defines a data migration relationship between a local volume and aremote volume. According to this definition, the local volume should reflect theremote volume.
After this configuration has been defined, it can be tested using the dm_testcommand (see Testing the data migration definition) and then activated using thedm_activate command (see Activating data migration). After this activation, hostscan read and write to this volume, and these operations are reflected on the remotevolume.
The remote volume may be inaccessible when the command is executed. In thiscase, the definition is only used when data migration is tested.
The local system acts as a host to the remote system. The remote system should beconfigured to make the remote volume accessible to the local system through thespecified LUN.
Chapter 10. Data migration commands 199
If source updating is specified, each write to the local volume is reflected as awrite to the remote volume. Otherwise, writes on the local volume are not reflectedand the remote volume is not changed.
The local volume must be formatted.
If create_vol is set to yes, the volume is created. In this case the size of the newlycreated volume is identical to the size of the source volume. When creating avolume, a pool name must be specified. Creating a volume fails if there is noconnectivity to the target since the volume's size is unknown.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv VOLUME_SIZE_VERY_LARGE_ARE_YOU_SURE
Volume size is very large. It may not be possible to mirror this volume to olderversions of XIV. Are you sure?
Return codesv VOLUME_BAD_NAME
Volume name does not existv TARGET_BAD_NAME
Target name does not existv VOLUME_IS_SNAPSHOT
Operation is not permitted on snapshotsv VOLUME_BELONGS_TO_CG
Volume belongs to a Consistency Groupv VOLUME_HAS_DATA_MIGRATION
Data Migration is defined for this volumev VOLUME_HAS_SNAPSHOTS
Volume has snapshotsv VOLUME_NOT_FORMATTED
Local volume is not formattedv VOLUME_EXISTS
Volume name already existsv POOL_DOES_NOT_EXIST
Storage Pool does not existv VOLUME_BAD_PREFIX
Volume name has a reserved prefixv NOT_ENOUGH_SPACE
200 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
No space to allocate for volume's current usagev MAX_VOLUMES_REACHED
Maximum number of volumes already definedv REMOTE_VOLUME_NO_LUN
Remote volume's LUN is unavailablev TARGET_NOT_CONNECTED
There is currently no connection to the target systemv VOLUME_CANNOT_HAVE_ZERO_SIZE
Volume size cannot be zerov ILLEGAL_LUN
LUN is out of rangev NO_ONLINE_MIGRATION_WITHOUT_SOURCE_UPDATING
Data Migration without automatic migration must be defined as source-updatingv MIGRATION_ALREADY_DEFINED_FOR_LUN
Data Migration is already defined from lun LUN of target 'Target'v VOLUME_SIZE_ABOVE_LIMIT
Volume size specified is above limitv INVALID_SLICE_OFFSET
Slice offset is illegalv ENCRYPTION_IN_PROGRESS
System is in the process of changing encryption activation statev DOMAIN_MAX_VOLUMES_REACHED
The domain exceeds the maximum allowed number of volumes.v MAX_DMS_REACHED
Maximum number of remote volumes (mirror/migration) is already definedTroubleshooting: Delete unnecessary Data Migration objects
v DOMAIN_MAX_DMS_REACHED
The domain exceeds the maximum allowed number of data migrations.v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v VOLUME_TOO_BIG
No space to allocate volume
Deleting the data migration processUse the dm_delete command to delete the data migration process.
dm_delete vol=VolName
Parameters
Name Type Description Mandatory
vol Object name The name of the volumewhose data migrationprocess is to be deleted.
Y
Chapter 10. Data migration commands 201
This command deletes the data migration configuration and stops the datamigration process.
This command can only be executed if the data migration has reached the state ofsynchronization.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv VOLUME_BAD_NAME
Volume name does not existv VOLUME_NO_DM
Local volume does not have Data Migration definitionsv DM_IS_NOT_SYNCHRONIZED
Data Migration process has not been completedv DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
Listing data migration statusesUse the dm_list command to list data migration configuration and status.
dm_list [ vol=VolName ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
vol Object name The name of thevolume to belisted.
N All data migrationvolumes.
domain Object name The domain name. N All Domains
This command lists all data migration configuration and statuses, including thefollowing information:v Volume namev Target namev LUNv Volume size (GB)v Migration completed (GB)
202 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v Migration activation (active/inactive)v Migration status (synchronized, unsynchronized)v Migration remaining (GB)v Migration remaining (%)v Estimated time to completion
Field ID Field output Default position
local_volume_name Local Volume 1
target_name Remote System 2
remote_volume_lun Remote LUN 3
active Active 4
sync_state Status 5
connected Target Connected 6
size_to_synchronize Size To Sync (MiB) N/A
operational Operational N/A
sync_progress Sync Progress (%) N/A
start_migration_automatically Start Data MigrationAutomatically
N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Testing the data migration definitionUse the dm_test command to test the data migration configuration.
dm_test vol=VolName
Parameters
Name Type Description Mandatory
vol Object name Destination volume fordata migration testing.
Y
Command return codes indicate the types of test failures that may occur. Once atest is successful, then data migration can be activated.
If source updating is not defined for this data migration, the writing is not tested.
Access control
User Category Permission
Storage administrator Allowed
Chapter 10. Data migration commands 203
User Category Permission
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv VOLUME_BAD_NAME
Volume name does not existv VOLUME_NO_DM
Local volume does not have Data Migration definitionsv TARGET_NOT_CONNECTED
There is currently no connection to the target systemv REMOTE_VOLUME_NO_LUN
Remote volume's LUN is unavailablev REMOTE_VOLUME_NO_READ_ACCESS
Remote volume cannot be readv REMOTE_VOLUME_NO_WRITE_ACCESS
Remote volume is write protectedv BAD_REMOTE_VOLUME_SIZE
Master and slave volumes contain a different number of blocksv DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
204 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 11. Event handling commands
This section describes the command-line interface (CLI) for event handling,including listing events, filtering and sending notifications.
Generating a custom eventUse the custom_event command to generate a custom event.
custom_event description=Description[ severity=<INFORMATIONAL|WARNING|MINOR|MAJOR|CRITICAL> ]
Parameters
Name Type Description Mandatory Default
description String Description of theevent.
Y N/A
severity N/A Severity of theevent.
N Informational
This command can be used to either generate an event from a user application orhost side software, or to test the event notification procedures.
Example:
custom_event description="Test started"
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Generating a CSS product eventUse the css_product_event command to generate a CSS (Cloud Storage Solutions)custom event.
css_product_event product=Product version=Version server=Server platform=Platformaction=Action properties=Properties[ severity=<INFORMATIONAL|WARNING|MINOR|MAJOR|CRITICAL> ]
© Copyright IBM Corp. 2016 205
Parameters
Name Type Description Mandatory Default
product String Product name. Y N/A
version String Versioninformation.
Y N/A
server String Server name. Y N/A
platform String Platforminformation.
Y N/A
action String Actioninformation.
Y N/A
properties String Propertiesinformation.
Y N/A
severity N/A Severity of theevent.
N Informational
This command can be used to either generate an event from a user application orhost side software, or to test the event notification procedures.
Example:
css_product_event product=product_name version=version_info server=server_infoplatform=platform_name action=action_name properties=properties_detailes
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Defining a new event notification destinationUse the dest_define command to define a new destination for event notifications.
dest_definedest=DestName type=<SNMP|EMAIL|SMS|HTTPS>< snmp_manager=SNMPManager | < uri=HTTPSaddress[ proxy=ProxyAddress [ proxy_port=ProxyPortNum ] ]> | email_address=email |<area_code=AreaCode number=PhoneNumber> | user=UserName>[ smtpgws=<SMTPGW1[,SMTPGW2]...|ALL> | smsgws=<SMSGW1[,SMSGW2]...|ALL> ][ heartbeat_test_hour=HH:MM[ heartbeat_test_days=Day ] ] [ domain=DomainList ]
206 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
dest Object name Destination name. Y N/A
type Enumeration Destination typefor eventnotifications: beemail, SMS,HTTPS or SNMP.
Y N/A
snmp_manager N/A IP address or DNSname of the SNMPmanager.
N N/A
uri N/A IP address or DNSname of theHTTPS server. If aport different fromthe default shouldbe used, specify ithere.
N N/A
proxy N/A IP address or DNSname of the proxyserver to sendHTTPS over.
N None
proxy_port Integer Proxy port numberto send HTTPSthrough. Thedefault is 1080.
N None
email_address N/A Email address. N N/A
smtpgws Object name List of SMTPgateways to beused.
N ALL (allgateways).
area_code N/A Area code of thecellular numberfor SMSnotification. Usedigits, '-' or '.'
N N/A
number N/A Cellular numberfor SMSnotification. Usedigits, '-' or '.'
N N/A
smsgws Object name SMS gateways tobe used for thisdestination.
N ALL (allgateways).
user Object name User name, wherethe user's email orphone are used.
N N/A
heartbeat_test_hour
N/A The hour forperiodic heartbeattesting in theformat HH:MM
N No heartbeat
heartbeat_test_days
N/A List of days forheartbeat testing: acomma-separatedlist of 3-letter daynames (such as"mon", "mon,fri",etc.).
N No heartbeat
Chapter 11. Event handling commands 207
Name Type Description Mandatory Default
domain N/A Attach thedestination to thespecified domains.To define morethan one domain,separated themwith a comma. Tospecify all existingdomains, use "*".
N none
This command defines a destination for event notifications. There are four types ofdestinations: email, SMS, HTTPS and SNMP.v Email destinations are used for sending notifications via email. When defining a
new destination of type Email, either the email address of the recipient must bespecified in email_address or the user name must be specified in user (in thiscase the email address of that user is used).
v SMS destinations are used for sending notifications via SMS to cellular phones.When defining a new destination of type SMS, either the cellular phone numberof the destination must be specified in number or the user name must bespecified in user (in this case the cellular phone number of that user is used). Toallow correct formatting, the area code must be separated from the local number.
v SNMP destinations are used for sending notifications by SNMP traps to SNMPmanagers. When defining a new destination of type SNMP, the IP address of theSNMP manager must be specified.
v HTTPS destinations are used for sending notifications to HTTPS servers. Whendefining a new destination of type HTTPS, the IP address of the HTTPS servermust be specified.
By default, when sending an email notification, all SMTP gateways specified in thesmtpgw_prioritize command (see Prioritizing SMTP gateways) are used, accordingto the order specified in that command. It is possible to define that sending emailsto a specific destination will use specific SMTP gateway or gateways. This is doneby specifying the smtpgws parameter.
The same logic applies to sending SMS messages. By default, SMS gatewaysspecified in the smtpgw_prioritize command are used, according to the orderspecified in this command. It is possible to define that messages to a specific SMSdestination will be sent through a specific SMS gateway or gateways.
Example:
dest_define dest=adminemail [email protected]
Output:
Command executed successfully.
Example:
dest_define dest=monitoringserver type=SNMPsnmp_manager=10.170.68.111
208 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DEST_MAX_REACHED
Maximum number of destinations already definedv DEST_NAME_ALREADY_EXISTS
Destination name already existsv DEST_NAME_IS_DESTGROUP_NAME
Destination name already exists as a destination group namev EMAIL_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have an email addressv GATEWAY_NAME_APPEARS_TWICE
Gateway name appears twice in the listv GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not existv SMSGWS_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have SMS gatewaysv SMTPGWS_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have SMTP gatewaysv SNMP_MANAGER_MUST_BE_SPECIFIED_FOR_DEST_TYPE
Destination must have an SNMP managerv SNMP_MANAGER_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have an SNMP managerv NO_SMS_GATEWAYS_ARE_DEFINED
An SMS Destination cannot be defined if no SMS gateways are definedv HTTPS_ADDRESS_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have an https addressv PROXY_ADDRESS_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have a proxy addressv SNMP_DESTS_CANNOT_REFER_TO_USERS
SNMP destinations cannot refer to usersv HTTPS_DESTS_CANNOT_REFER_TO_USERS
HTTPS destinations cannot refer to usersv NO_SMTP_GATEWAYS_ARE_DEFINED
Chapter 11. Event handling commands 209
An email destination cannot be defined if no SMTP gateways are definedv USER_EMAIL_ADDRESS_IS_NOT_DEFINED
User's email address is not definedv USER_PHONE_NUMBER_IS_NOT_DEFINED
User's phone number is not definedv USER_NAME_DOES_NOT_EXIST
User name does not existv INTERNAL_DESTS_CANNOT_REFER_TO_USERS
Internal destinations cannot refer to usersv DAY_APPEARS_TWICE
The day 'Day' appears twice on the list.Troubleshooting: Each day must appear at most once.
v HTTPS_ADDRESS_MUST_BE_SPECIFIED_FOR_DEST_TYPE
Destination must have an https addressv DEST_TYPE_NOT_SUPPORTED
This type of destination is not supportedTroubleshooting: Contact support
v USER_IS_NOT_IN_DESTINATION_DOMAINS
User must by included in the destination domains.v DOMAIN_DOESNT_EXIST
Domain does not exist.
Deleting a destinationUse the dest_delete command to delete an event notification destination.
dest_delete dest=DestName
Parameters
Name Type Description Mandatory
dest Object name Name of the destinationto be deleted.
Y
Destinations that are part of a destination group or used by a rule cannot bedeleted.
Destinations cannot be deleted while there are uncleared alerting events.
Example:
dest_delete dest=itmanager
Output:
Command executed successfully.
210 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_DESTINATION
Are you sure you want to delete destination Destination?
Return codesv DEST_NAME_DOES_NOT_EXIST
Destination name does not existv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v DEST_IS_PART_OF_DESTGROUP
Destination is part of a destination group and hence cannot be deletedv DEST_APPEARS_IN_RULE
Destination appears in a ruleTroubleshooting: To delete the destination, first delete the rule.
Listing event notification destinationsUse the dest_list command to list event notification destinations.
dest_list [ dest=DestName ] [ type=<SNMP|EMAIL|SMS|HTTPS> ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
dest Object name Destinations to belisted.
N All destinations.
type Enumeration Filter onlydestinations of thespecified type.
N All types.
domain Object name The domain name. N All Domains
This command lists the configuration of all defined destinations, or of a specificdestination.
Field ID Field output Default position
name Name 1
type Type 2
email_address Email Address 3
Chapter 11. Event handling commands 211
Field ID Field output Default position
area_code Area Code 4
number Phone Number 5
snmp_manager SNMP Manager 6
uri HTTPS Address 7
gateways Gateways N/A
user User 8
heartbeat_test_days Heartbeat Days N/A
heartbeat_test_hour Heartbeat Time N/A
creator Creator N/A
proxy proxy server address N/A
proxy_port proxy port number N/A
Example:
dest_list
Output:
Name Type Email Address Phone Number Gatewaysstoragemanager EMAIL [email protected] allmonitoringserver SNMP
Access control
User Category Permission Condition
Storage administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Storage integration administrator Disallowed N/A
Application administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Security administrator Disallowed N/A
Read-only users Conditionally Allowed Allowed, unless the internalparameter is specified.
Technicians Allowed N/A
Renaming a destinationUse the dest_rename command to rename an event notification destination.
dest_rename dest=DestName new_name=Name
Parameters
Name Type Description Mandatory
dest Object name The destination to berenamed.
Y
new_name Object name New name of thedestination.
Y
212 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Example:
dest_rename dest=adminemail new_name=storagemanager
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v DEST_NAME_DOES_NOT_EXIST
Destination name does not existv DEST_NAME_IS_DESTGROUP_NAME
Destination name already exists as a destination group namev DEST_NAME_ALREADY_EXISTS
Destination name already exists
Testing a destinationUse the dest_test command to send a test message to an event notificationdestination.
dest_test dest=DestName management_ip=IPaddress [ smtpgw=SMTPGatewayName ][ smsgw=SMSGatewayName ] [ internal=<yes|no> ]
Parameters
Name Type Description Mandatory Default
dest Object name Name of thedestination to betested.
Y N/A
management_ip N/A Management IPused for sendingthe eventnotification.
Y N/A
smtpgw Object name SMTP gateway tobe tested.
N Default systemchoice.
smsgw Object name SMS gateway to betested.
N Default systemchoice.
Chapter 11. Event handling commands 213
Name Type Description Mandatory Default
internal Boolean Must be specifiedfor XIV-internaldestinations.
N no
This command tests a destination by sending a test message, SMS or SNMP trap.Note that a successful return code from this command does not ensure notificationdelivery.
Some problems with SNMP, email, and SMS delivery may fail to be detected.
For email messages, the SMTP gateway must be specified (the destination is onlytested through that gateway). The same applies to the SMS gateway.
Access control
User Category Permission Condition
Storage administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Storage integration administrator Disallowed N/A
Application administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Allowed N/A
Return codesv DEST_NAME_DOES_NOT_EXIST
Destination name does not existv DEST_TEST_NOT_PERFORMED_SYSTEM_BUSY
Test of destination 'Destination Name' not performed because the system is busyTroubleshooting: Please wait a few seconds and try again
v GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not existv SMSGWS_MUST_BE_SPECIFIED_FOR_DEST_TYPE
Destination must have SMS gatewaysv SMSGWS_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have SMS gatewaysv SMTPGWS_MUST_BE_SPECIFIED_FOR_DEST_TYPE
Destination must have SMTP gatewaysv SMTPGWS_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have SMTP gatewaysv DEST_TEST_FAILED
Test of destination 'Destination Name' failedv SYSTEM_HAS_NO_SUCH_EXTERNAL_IP
The system has no such external IP addressv MODULE_CANNOT_SEND_MESSAGES
Selected module cannot send messages
214 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Troubleshooting: Contact supportv ONLY_TECHNICIAN_CAN_REFER_TO_INTERNAL_EVENT_OBJECTS
Only technician can refer to internal event objects
Updating an event notification destinationUse the dest_update command to update a destination.
dest_update dest=DestName[ snmp_manager=SNMPManager ] [ uri=HTTPSaddress ][ proxy=ProxyAddress ] [ proxy_port=ProxyPortNum ][ email_address=email ][ smtpgws=<SMTPGW1[,SMTPGW2]...|ALL> ] [ area_code=AreaCode ][ number=PhoneNumber ][ smsgws=<SMSGW1[,SMSGW2]...|ALL> ][ user=UserName ] [ heartbeat_test_hour=HH:MM ][ heartbeat_test_days=Day ] [ domain=DomainList ]
Parameters
Name Type Description Mandatory Default
dest Object name Destination name. Y N/A
snmp_manager N/A IP address or DNSname of the SNMPmanager.
N Keep unchanged.
uri N/A IP address or DNSname of HTTPSserver.
N Keep unchanged.
proxy N/A IP address or DNSname of proxyserver to sendHTTPS over.
N Keep unchanged.
proxy_port Integer Proxy port numberto send HTTPSthrough (1080 bydefault).
N Keep unchanged.
domain N/A Attach thedestination to thespecified domains.To define morethan one domain,separated themwith a comma. Tospecify all existingdomains, use "*".
N Keep unchanged
email_address N/A Email address. N Keep unchanged.
smtpgws Object name List of SMTPgateways to beused.
N Keep unchanged.
area_code N/A Area code of thecellular numberfor SMSnotification.
N Keep unchanged.
number N/A Cellular numberfor SMSnotification.
N Keep unchanged.
smsgws Object name SMS gateways tobe used.
N Keep unchanged.
Chapter 11. Event handling commands 215
Name Type Description Mandatory Default
user Object name User name, wherethe user's email orphone are used.
N Keep unchanged.
heartbeat_test_hour
N/A The hour ofperiodic heartbeattesting
N Keep unchanged.
heartbeat_test_days
N/A List of days forheartbeat testing: acomma-separatedlist of 3-letter daynames (such as"mon", "mon,fri",and so on).
N Keep unchanged.
The parameters of this command are identical to the Defining a new eventnotification destination command, except that the destination type cannot bechanged. All relevant fields must be specified (not only the ones that are beingchanged).
Example:
dest_update [email protected]
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DEST_NAME_DOES_NOT_EXIST
Destination name does not existv AREA_CODE_MUST_BE_SPECIFIED_FOR_DEST_TYPE
Destination must have an area codev AREA_CODE_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have an area codev CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v EMAIL_MUST_BE_SPECIFIED_FOR_DEST_TYPE
Destination must have an email address
216 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v EMAIL_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have an email addressv GATEWAY_NAME_APPEARS_TWICE
Gateway name appears twice in the listv GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not existv NUMBER_MUST_BE_SPECIFIED_FOR_DEST_TYPE
Destination must have a numberv NUMBER_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have a numberv SMSGWS_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have SMS gatewaysv SNMP_MANAGER_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have an SNMP managerv NO_SMTP_GATEWAYS_ARE_DEFINED
An email destination cannot be defined if no SMTP gateways are definedv DEST_CANNOT_HAVE_A_USER_AND_AN_EMAIL_ADDRESS
Destination cannot simultaneously have an email address and refer to a userv DEST_CANNOT_HAVE_A_USER_AND_A_PHONE_NUMBER
Destination cannot simultaneously have a phone number address and refer to auser
v USER_PHONE_NUMBER_IS_NOT_DEFINED
User's phone number is not definedv USER_NAME_DOES_NOT_EXIST
User name does not existv INTERNAL_DESTS_CANNOT_REFER_TO_USERS
Internal destinations cannot refer to usersv DEST_HEARTBEAT_DAYS_BUT_NO_HOUR
Destination heartbeat days specified with no heartbeat hourv HTTPS_ADDRESS_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have an https addressv PROXY_ADDRESS_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have a proxy addressv SNMP_DESTS_CANNOT_REFER_TO_USERS
SNMP destinations cannot refer to usersv HTTPS_DESTS_CANNOT_REFER_TO_USERS
HTTPS destinations cannot refer to usersv USER_EMAIL_ADDRESS_IS_NOT_DEFINED
User's email address is not definedv SMTPGWS_NOT_ALLOWED_FOR_DEST_TYPE
Destination cannot have SMTP gatewaysv DAY_APPEARS_TWICE
The day 'Day' appears twice on the list.Troubleshooting: Each day must appear at most once.
v SNMP_MANAGER_MUST_BE_SPECIFIED_FOR_DEST_TYPE
Chapter 11. Event handling commands 217
Destination must have an SNMP managerv NO_SMS_GATEWAYS_ARE_DEFINED
An SMS Destination cannot be defined if no SMS gateways are definedv HTTPS_ADDRESS_MUST_BE_SPECIFIED_FOR_DEST_TYPE
Destination must have an https addressv DEST_TYPE_NOT_SUPPORTED
This type of destination is not supportedTroubleshooting: Contact support
v DOMAIN_DOESNT_EXIST
Domain does not exist.v USER_IS_NOT_IN_DESTINATION_DOMAINS
User must by included in the destination domains.v DESTINATION_IS_NOT_IN_RULE_DOMAINS
Destination must by included in the rule domains.v DESTINATION_IS_NOT_IN_DESTGROUP_DOMAINS
Destinations must by included in the destination group domains.
Adding a destination to a destination groupUse the destgroup_add_dest command to add an event notification destination to adestination group.
destgroup_add_dest destgroup=GroupName dest=DestName
Parameters
Name Type Description Mandatory
destgroup Object name Destination group nameto which to add thedestination.
Y
dest Object name Destination to be addedto the group.
Y
The command fails if the destination group already contains the destination.
The command cannot be executed while there are uncleared alerting events.
Example:
destgroup_add_dest destgroup=alladmins dest=john
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
218 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DESTGROUP_NAME_DOES_NOT_EXIST
Destination group name does not existv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v DEST_NAME_DOES_NOT_EXIST
Destination name does not existv DESTGROUP_MAX_DESTS_REACHED
Maximum number of destinations already defined in destination groupsv DESTGROUP_ALREADY_INCLUDES_DEST
Destination group already includes destination namev DESTINATION_IS_NOT_IN_DESTGROUP_DOMAINS
Destinations must by included in the destination group domains.
Creating a destination groupUse the destgroup_create command to create an event notification destinationsgroup.
destgroup_create destgroup=GroupName [ domain=DomainList ]
Parameters
Name Type Description Mandatory Default
destgroup Object name Destination groupname.
Y N/A
domain N/A Attach thedestination groupto the specifieddomains. To definemore than onedomain, separatedthem with acomma. To specifyall existingdomains, use "*".
N none
This command creates a destination group, which is used by rules to sendnotifications to the entire group without specifying all the destinations for eachrule. You can also add or remove destinations from the group, which eliminatesthe need to change the configuration of each rule separately.
Upon creation, the destination group is empty. To add a destination to adestination group, use the Adding a destination to a destination group command.
Chapter 11. Event handling commands 219
Example:
destgroup_create destgroup=alladmins
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DESTGROUP_MAX_REACHED
Maximum number of destination groups already definedv DESTGROUP_NAME_ALREADY_EXISTS
Destination group name already existsv DESTGROUP_NAME_IS_DEST_NAME
Destination group name already exists as a destination namev DOMAIN_DOESNT_EXIST
Domain does not exist.
Updating an event notification destination groupUse the destgroup_update command to update a destination group.
destgroup_update destgroup=GroupName domain=DomainList
Parameters
Name Type Description Mandatory
destgroup Object name Destination groupname.
Y
domain N/A Attach the destinationgroup to the specifieddomains. To definemore than one domain,separated them with acomma. To specify allexisting domains, use"*".
Y
Example:
220 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
destgroup_update destgroup=alladmins domain=D1,D2
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DESTINATION_IS_NOT_IN_DESTGROUP_DOMAINS
Destinations must by included in the destination group domains.v DOMAIN_DOESNT_EXIST
Domain does not exist.v DESTGROUP_IS_NOT_IN_RULE_DOMAINS
Destination groups must by included in the rule domains.v DESTGROUP_NAME_DOES_NOT_EXIST
Destination group name does not existv INTERNAL_EVENT_OBJECTS_CANNOT_USE_SPECIFIC_DOMAINS
Internal event objects cannot be defined on specific domains.
Deleting a destination groupUse the destgroup_delete command to delete an event notification destinationgroup.
destgroup_delete destgroup=GroupName
Parameters
Name Type Description Mandatory
destgroup Object name The name of thedestination group to bedeleted.
Y
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Chapter 11. Event handling commands 221
User Category Permission
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_DESTINATION_GROUP
Are you sure you want to delete destination group Destination Group?
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v DESTGROUP_APPEARS_IN_RULE
Destination Group appears in a RuleTroubleshooting: To delete the destination group, first delete the rule.
v DESTGROUP_NAME_DOES_NOT_EXIST
Destination group name does not exist
Listing destination groupsUse the destgroup_list command to list destination groups.
destgroup_list [ destgroup=GroupName ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
destgroup Object name Destination groupto be listed.
N All groups.
domain Object name The domain name. N All Domains
This command lists all destination groups or a specific one. All the destinations arelisted for each destination group.
Field ID Field output Default position
name Name 1
dests Destinations 2
creator Creator N/A
Example:
destgroup_list
Output:
Name Destinationsitstaff john,michael,linda,monitoringserver
222 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Removing a destination from a destination groupUse the destgroup_remove_dest command to remove an event notificationdestination from a destination group.
destgroup_remove_dest destgroup=GroupName dest=DestName
Parameters
Name Type Description Mandatory
destgroup Object name Group name. Y
dest Object name Destination to beremoved from thegroup.
Y
This command cannot be executed while there are uncleared alerting events.
Example:
destgroup_remove_dest destgroup=alladmins dest=john
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DESTGROUP_NAME_DOES_NOT_EXIST
Destination group name does not existv DEST_NAME_DOES_NOT_EXIST
Chapter 11. Event handling commands 223
Destination name does not existv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v DESTGROUP_DOES_NOT_INCLUDE_DEST
Destination group does not include destination name
Renaming a destination groupUse the destgroup_rename command to rename an event notification destinationgroup.
destgroup_rename destgroup=GroupName new_name=Name
Parameters
Name Type Description Mandatory
destgroup Object name Destination group to berenamed.
Y
new_name Object name New name of thedestination group.
Y
This command cannot be executed while there are uncleared alerting events.
Example:
destgroup_rename destgroup=alladmins new_name=itstaff
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DESTGROUP_NAME_DOES_NOT_EXIST
Destination group name does not existv DESTGROUP_NAME_ALREADY_EXISTS
Destination group name already existsv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting events
224 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Troubleshooting: Clear all alerting events before changing event configurationv DESTGROUP_NAME_IS_DEST_NAME
Destination group name already exists as a destination name
Clearing alerting eventsUse the event_clear command to clear alerting events.
event_clear event_id=EventId [ all_preceding=<yes|no> ] [ internal=<yes|no|all> ]
Parameters
Name Type Description Mandatory Default
event_id Positive integer The ID number ofthe event to becleared.
Y N/A
all_preceding Boolean Clears all eventspreceding thespecified event.
N no
internal Boolean Clears XIV-internalevents.
N no
In order to ensure that an event was indeed received, an event notification may besent repeatedly until it is cleared with a CLI command or from the GUI. Suchevents are called alerting events. An event is defined as alerting if at the time of theevent's generation it was matched by an alerting rule, meaning a rule that haseither snooze or escalation definitions.
Notifications for the alerting event are sent until it is cleared by this command. Theclearing operation does not imply that the problem has been solved. It only impliesthat the event has been noted by the relevant person who takes responsibility forfixing the problem.
The user may clear either a specific event or all alerting events.
Example:
event_clear event_id=87
Output:
Command executed successfully.
Access control
User Category Permission Condition
Storage administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Storage integration administrator Disallowed N/A
Application administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Chapter 11. Event handling commands 225
User Category Permission Condition
Technicians Allowed N/A
Return codesv ONLY_TECHNICIAN_CAN_REFER_TO_INTERNAL_EVENT_OBJECTS
Only technician can refer to internal event objects
Listing eventsUse the event_list command to list system events.
event_list [ max_events=MaxEventsToList ] [ after=TimeStamp ][ before=TimeStamp ] [ min_severity=<INFORMATIONAL|WARNING|MINOR|MAJOR|CRITICAL> ][ alerting=<yes|no|all> ] [ cleared=<yes|no|all> ] [ code=EventCode ][ object_type=<cons_group|destgroup|dest|dm|host|map| mirror|pool|rule|smsgw|smtpgw|target|volume|cluster|ip_interface|ldap_conf|meta_data_object| sync_schedule|user|user_group|ldap_server|modules_status|elicense|ipsec_connection|ipsec_tunnel|cross_cons_group,...> ] [ internal=<yes|no|all> ] [ beg=BeginIndex ] [ end=EndIndex ][ count_all=<yes|no> ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
max_events Positive integer Maximum numberof events to list.
N 300
after N/A Earliest time/date. N no filter
before N/A Latest time/date. N no filter
min_severity Enumeration Minimum severity. N no filter
alerting Boolean Filter alertingevents.
N no filter
cleared Boolean Filter clearedevents.
N no filter
code N/A Filter by a specificevent code.
N no filter
object_type Enumeration Filter events by thetype of the relatedsystem object.
N no filter
internal Boolean Filter XIV internalevents.
N no filter
beg Integer Index of the firstevent to list. Ifnegative, thencounts from theend.
N 1
end Integer Index of the lastevent to list (notinclusive). Ifnegative, thencounts from theend.
N last event + 1
count_all Boolean If yes, it scans allthe events betweenbeginning and endfor computing thenumber of eventsmeeting thecriteria.
N no
226 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory Default
domain Object name The domain name. N All Domains
This command lists system events according to specified criteria, such as minimumseverity, event type, and so on. The event list displays the following informationfor each event: timestamp, severity, code, user and description.
Events are listed and sorted by time of creation, where the latest events are listedlast. Events are listed by default in the user-readable textual form. Alternatively,the CLI option for comma-separated values can be used to generate output thatcan serve as input for other applications.
The syntax for the before and after fields is as follows: Y-M-D[.[h[:m[:s]]]],where the ranges are as follows:v Y - year (four digit)v M - month (1-12)v D - day (1-31)v h - hour (0-23, with 0 as default)v m - minute (0-59, with 0 as default)v s - second (0-59, with 0 as default)
The year, month and day are separated by dashes, while the optional hour, minuteand second are separated by colons.
Field ID Field output Default position
timestamp Timestamp 1
severity Severity 2
code Code 3
user_name User 4
description Description 5
index Index N/A
alerting Alerting N/A
cleared Cleared N/A
tshooting Trouble Shooting N/A
Example:
event_list max_events=10
Output:
Chapter 11. Event handling commands 227
Timestamp Severity Code2009-05-12 15:10:16 Informational START_WORK2009-05-12 15:16:11 Informational POOL_CREATE2009-05-12 15:16:22 Critical WOULD_BE_EMERGENCY_SHUTDOWN2009-05-12 15:16:23 Informational VOLUME_CREATE
Additional output fields(lines are broken to fit the page width of this Guide):
User DescriptionSystem has entered ON state.
xiv_development Storage Pool of size 171GB was created with name’p1_m’.An emergency shutdown has been detected, but UPS controlis disabled.
xiv_development Volume was created with name ’master’ and size 17GB inStorage Pool with name ’p1_m’.
Access control
User Category Permission Condition
Storage administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Storage integration administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Application administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Security administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Read-only users Conditionally Allowed Allowed, unless the internalparameter is specified.
Technicians Allowed N/A
Return codesv UNRECOGNIZED_EVENT_CODE
'String' is not a recognized event codeTroubleshooting: Consult the manual for the list of event codes
v CANNOT_READ_EVENTS
Cannot read events.Troubleshooting: Contact support
v DOMAIN_DOESNT_EXIST
Domain does not exist.
Listing uncleared alerting eventsUse the event_list_uncleared command to list uncleared alerting events.
event_list_uncleared [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
domain Object name The domain name. N All Domains
228 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Example:
event_list_uncleared
Output:
Index Code Severity------- --------------- ---------------318 VOLUME_CREATE Informational666 VOLUME_DELETE Informational
Field ID Field output Default position
index Index 1
code Code 2
severity Severity 3
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Setting the threshold for event notificationUse the event_redefine_threshold command to redefine the threshold of aparameterized event.
event_redefine_threshold code=EventCodeseverity=<INFORMATIONAL|WARNING|MINOR|MAJOR|CRITICAL|NONE>threshold=<ThresholdValue|NONE>
Parameters
Name Type Description Mandatory
code N/A Event code. Y
severity Enumeration Severity. Y
threshold Integer Threshold value, orNONE to indicate thatan event with thisseverity is not created.
Y
This command can be applied to parameterized events, that is events that aretriggered when a certain parameter crosses a certain threshold. Using thiscommand the user can change the threshold for event notification. Furthermore,multiple thresholds can be defined using multiple invocations of this command,one for each event severity. When the relevant parameter crosses a threshold, anevent with the matching severity is created.
Chapter 11. Event handling commands 229
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv EVENT_DOES_NOT_HAVE_THRESHOLDS
Event does not have thresholdsv EVENT_THRESHOLD_IS_ILLEGAL
Illegal value for event thresholdTroubleshooting: Event threshold values must be monotonic
v UNRECOGNIZED_EVENT_CODE
'String' is not a recognized event codeTroubleshooting: Consult the manual for the list of event codes
v LAST_EVENT_THRESHOLD_CANNOT_BE_DELETED
Events must have at least one threshold value
Listing thresholdsUse the event_threshold_list to list event thresholds.
event_threshold_list [ code=EventCode ]
Parameters
Name Type Description Mandatory Default
code Enumeration Filter by a specificevent code.
N no filter
Field ID Field output Default position
code Code 1
has_thresholds Has Thresholds? N/A
not_in_use Not In Use N/A
replaced_by Replaced By N/A
default_thresholds.0 INFORMATIONAL(def) 7
default_thresholds.1 WARNING(def) 8
default_thresholds.2 MINOR(def) 9
default_thresholds.3 MAJOR(def) 10
default_thresholds.4 CRITICAL(def) 11
thresholds.0 INFORMATIONAL 2
thresholds.1 WARNING 3
thresholds.2 MINOR 4
thresholds.3 MAJOR 5
230 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
thresholds.4 CRITICAL 6
Example:
event_threshold_list
Output:
Code INFORMATIONAL WARNING MINOR--------------------------------------- --------------- --------- -------STORAGE_POOL_SNAPSHOT_USAGE_INCREASED none 80 90STORAGE_POOL_VOLUME_USAGE_INCREASED none 80 90
MAJOR CRITICAL INFORMATIONAL(def) WARNING(def) MINOR(def) MAJOR(def)------- ---------- -------------------- -------------- ------------ ------------95 none none 80 90 9595 none none 80 90 95
CRITICAL(def)---------------nonenone
Access control
User Category Permission Condition
Storage administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Storage integration administrator Disallowed N/A
Application administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Security administrator Disallowed N/A
Read-only users Conditionally Allowed Allowed, unless the internalparameter is specified.
Technicians Allowed N/A
Activating a ruleUse the rule_activate command to activate an event notification rule.
rule_activate rule=RuleName
Parameters
Name Type Description Mandatory
rule Object name The name of the rule tobe activated.
Y
This command activates the specified rule. An active rule is matched againstevents and generates notifications. If the rule is already active, this command hasno effect.
Chapter 11. Event handling commands 231
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv EVENT_RULE_NAME_DOES_NOT_EXIST
Event rule name does not exist
Creating event notification rulesUse the rule_create command to create an event notification rule.
rule_create rule=RuleName [ min_severity=<INFORMATIONAL|WARNING|MINOR|MAJOR|CRITICAL|NONE> ][ codes=Codes | except_codes=EventCodes ] [ escalation_only=<yes|no> ]dests=dest1,dest2,... [ snooze_time=SnoozeTime ][ escalation_time=EscalationTime escalation_rule=EscalationRule ] [ domain=DomainList ]
Parameters
Name Type Description Mandatory Default
rule Object name The name of thenew rule.
Y N/A
min_severity Enumeration Minimal eventseverity for rulefiltering.
N All severities.
codes N/A Filter only eventswith these codes.
N All events.
except_codes N/A Filter only eventswith other codes.
N All events.
escalation_only Boolean Specifies that thisrule can only beused for escalation.
N no
dests Object name Comma-separatedlist of destinationsand destinationgroups for eventnotification.
Y N/A
snooze_time Integer Snooze time inminutes.
N No snoozing.
escalation_rule Object name Escalation rule. N N/A
escalation_time Integer Escalation time inminutes. Escalationtime should not besmaller thansnooze time. Referto escalation_ruleabove for moreinformation.
N No escalation.
232 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory Default
domain N/A The rule will beattached to thespecified domains.To define morethan one domain,separate them witha comma. Tospecify all existingdomains, use "*".
N none
This command defines a new event notification rule. An event notification ruledetermines which events should generate which notifications. When an eventoccurs, it is checked by all currently defined rules, based on which notifications aregenerated.
Each rule has a filtering and notification configuration.
The filtering configuration controls which events match this rule. The filtering canbe based on the event's code, by specifying a minimum severity. When using thisconfiguration, each event with a severity higher or equal to the rule's min_severityparameter matches this rule. Alternatively, the rule may match only a specificevent code. Two filters can be combined for events whose severity depends on arun-time parameter.
The second part of a rule configuration is a list of destinations and destinationgroups that receive the notification when an event matches the filtering criteria. Ifa destination is included both in the rule and in one of the rule's destinationgroups, it still gets only one notification. The same applies if a destination isincluded in two destination groups, or if the event matches the filtering criteria ofseveral rules, all using the same destination.
A rule can be defined as alerting, which means that notifications are sent repeatedlyuntil the matching events are cleared using the event_clear command (seeClearing alerting events).
Clearing the event does not mean that the problem has been solved. It only meansthat it was noticed and there is no need to continue sending notifications.
The repeated sending of notifications can be defined by two ways:v The snooze parameter causes the notifications to be sent again and again to the
same destinations. The time in minutes between the repeated transmissions isdetermined by the snooze parameter.
v The escalation_time and escalation_rule parameters cause the notifications tobe sent to the destination list of the escalation_rule if it is not cleared withinescalation_time minutes.
Rules can escalate only to alerting rules (that is, to rules that have snooze orescalation definitions) in order to prevent a situation where notifications arestopped from being sent.
A rule cannot escalate to itself, nor can it be defined in a cyclic escalation of rules.
The escalation_only parameter defines a rule without filters, which can only beused as an escalation for other rules.
Chapter 11. Event handling commands 233
The snooze time cannot be greater than the escalation time.
It is not permitted to define new rules while there are uncleared alerting events.
The following example sends alerts upon critical events to John's cellular numberand to the emails of all the IT staff. The alerts will be resent every 20 minutes untilthe events are cleared.
Example:
xcli -u -c Nextra1 rule_create rule=critical_alerts min_severity=critical destinations=john-cell,itstaff snooze_time=20
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv EVENT_RULE_MAX_REACHED
Maximum number of event rules already definedv EVENT_RULE_CANNOT_ESCALATE_TO_NON_ALERTING_RULES
Event rule cannot escalate to non-alerting ruleTroubleshooting: Alerting rule can only escalate to another escalating rule
v DEST_APPEARS_TWICE
Destination or destination group appears twicev EVENT_RULE_NAME_ALREADY_EXISTS
Event rule name already existsv EVENT_RULE_NAME_DOES_NOT_EXIST
Event rule name does not existv NAME_IS_NEITHER_DEST_NOR_GROUP
Name is neither the name of a destination group nor the name of a destinationv ESCALATION_TIME_MUST_BE_LARGER_THAN_SNOOZE_TIME
Escalation time must be larger than snooze timev RULE_MAX_DESTS_REACHED
Maximum number of destinations and destination groups in a rule alreadydefined
v EVENT_RULE_MUST_HAVE_FILTER
An alerting event rule must have a filter, either event code or severity
234 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v EVENT_RULE_CANNOT_REFER_TO_INTERNAL_EVENT_CODES
A user event rule cannot refer to internal event codesv ESCALATION_EVENT_RULE_CANNOT_HAVE_FILTER
An escalation-only event rule cannot have code or min_severity specificationv ESCALATION_EVENT_RULE_MUST_BE_ALERTING
Escalation-only event rules must be alerting rulesv TOO_MANY_EVENT_CODES
A maximum of Maximum event codes can be specifiedv EVENT_CODE_APPEARS_TWICE
Event code 'Code' appears twice in the listTroubleshooting: Each event code must appear at most once.
v UNRECOGNIZED_EVENT_CODE
'String' is not a recognized event codeTroubleshooting: Consult the manual for the list of event codes
v EVENT_RULE_CANNOT_HAVE_A_CATEGORY
A user event rule cannot have a category definitionv DOMAIN_DOESNT_EXIST
Domain does not exist.v DESTINATION_IS_NOT_IN_RULE_DOMAINS
Destination must by included in the rule domains.v DESTGROUP_IS_NOT_IN_RULE_DOMAINS
Destination groups must by included in the rule domains.v ESCALATION_RULE_NOT_IN_RULE_DOMAINS
Escalation rule must belong to rule domains.v EVENT_RULE_MUST_NOT_HAVE_SNMP_DEST
On current system configuration state (snmp_type = NONE) event rule must nothave SNMP destination
Deactivating a ruleUse the rule_deactivate command to deactivate an event notification rule.
rule_deactivate rule=RuleName
Parameters
Name Type Description Mandatory
rule Object name The name of the rule tobe deactivated.
Y
A deactivated rule is not matched against events and does not generatenotifications. If the rule is already inactive, then this command has no effect.
Inactive rules cannot be used as escalation rules.
The rules of type escalation_only cannot be deactivated.
Chapter 11. Event handling commands 235
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv EVENT_RULE_NAME_DOES_NOT_EXIST
Event rule name does not existv ESCALATION_ONLY_RULES_ARE_ALWAYS_ACTIVE
Escalation-only event rules cannot be deactivated or activated
Deleting event notification rulesUse the rule_delete command to delete an event notification rule.
rule_delete rule=RuleName
Parameters
Name Type Description Mandatory
rule Object name The rule to be deleted. Y
Rules that are defined as the escalation of other rules cannot be deleted.
It is not permitted to delete a rule while there are uncleared alerting events.
Example:
rule_delete rule=emergency_alerts
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
236 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_RULE
Are you sure you want to delete Rule Rule?
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v EVENT_RULE_NAME_DOES_NOT_EXIST
Event rule name does not existv EVENT_RULE_USED_FOR_ESCALATION_CAN_NOT_BE_DELETED
Event rule is an escalation rule of another event rule and thus cannot be deletedTroubleshooting: Delete all escalation rules that refer to this rule as theirescalation rule
Listing event notification rulesUse the rule_list command to list event notification rules.
rule_list [ rule=RuleName ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
rule Object name The rule to belisted.
N All rules.
domain Object name The domain name. N All Domains
Field ID Field output Default position
name Name 1
min_severity Minimum Severity 2
codes Event Codes 3
except_codes Except Codes 4
dests Destinations 5
active Active 6
escalation_time Escalation Time N/A
snooze_time Snooze Time N/A
escalation_rule Escalation Rule N/A
escalation_only Escalation Only 7
category Category N/A
creator Creator N/A
Example:
rule_list
Output:
Chapter 11. Event handling commands 237
Name Minimum Severity Event Code Destinations---------------- ---------------- ---------- -----------------emergency_alerts critical all john-cell,itstaff
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Renaming event notification rulesUse the rule_rename command to rename an event notification rule.
rule_rename rule=RuleName new_name=Name
Parameters
Name Type Description Mandatory
rule Object name The rule to be renamed. Y
new_name Object name The new name of therule.
Y
Example:
rule_rename rule=critical_alerts new_name=emergency_alerts
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting events
238 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Troubleshooting: Clear all alerting events before changing event configurationv EVENT_RULE_NAME_ALREADY_EXISTS
Event rule name already existsv EVENT_RULE_NAME_DOES_NOT_EXIST
Event rule name does not exist
Updating an event notification ruleUse the rule_update command to update an event notification rule.
rule_update rule=RuleName [ min_severity=<INFORMATIONAL|WARNING|MINOR|MAJOR|CRITICAL|NONE> ][ codes=Codes ] [ except_codes=EventCodes ] [ escalation_only=<yes|no> ][ dests=dest1,dest2,... ] [ snooze_time=SnoozeTime ] [ escalation_time=EscalationTime ][ escalation_rule=EscalationRule ] [ domain=DomainList ]
Parameters
Name Type Description Mandatory Default
rule Object name The name of therule.
Y N/A
min_severity Enumeration Minimum eventseverity for rulefiltering.
N Leave unchanged.
codes N/A Filter only eventswith this code.
N Leave unchanged.
except_codes N/A Filter only eventswith other codes.
N Leave unchanged.
escalation_only Boolean Specifies that thisrule can only beused for escalation.
N no
dests Object name Comma-separatedlist of destinationsand destinationgroups for eventnotification.
N Leave unchanged.
snooze_time Integer Snooze time inminutes.
N Leave unchanged.
escalation_time Integer Escalation time inminutes.
N Leave unchanged.
escalation_rule Object name Escalation rule. N Leave unchanged.
domain N/A The rule will beattached to thespecified domains.To specify morethan one domain,separate them witha comma. Tospecify all existingdomains, use "*".
N Leave unchanged.
This command updates the configuration of an event notification rule. Allparameters and their descriptions are identical to the Creating event notificationrules command.
Parameters which are not specified are not changed.
Example:
Chapter 11. Event handling commands 239
rule_update rule=critical_alerts min_severity=critical destinations=john-cell,itstaffsnooze_time=30
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv EVENT_RULE_NAME_DOES_NOT_EXIST
Event rule name does not existv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v EVENT_RULE_CANNOT_ESCALATE_TO_ITSELF
An event rule cannot be its own escalation rulev EVENT_RULE_CANNOT_ESCALATE_TO_NON_ALERTING_RULES
Event rule cannot escalate to non-alerting ruleTroubleshooting: Alerting rule can only escalate to another escalating rule
v DEST_APPEARS_TWICE
Destination or destination group appears twicev EVENT_RULE_MISSING_ESCALATION_RULE
An alerting event rule must have an escalation ruleTroubleshooting: If escalation time is specified, then an escalation rule must bespecified also.
v EVENT_RULE_MISSING_ESCALATION_TIME
An alerting event rule must have escalation timeTroubleshooting: If an escalation rule is specified, then escalation time must bespecified also.
v NAME_IS_NEITHER_DEST_NOR_GROUP
Name is neither the name of a destination group nor the name of a destinationv ESCALATION_TIME_MUST_BE_LARGER_THAN_SNOOZE_TIME
Escalation time must be larger than snooze timev RULE_MAX_DESTS_REACHED
Maximum number of destinations and destination groups in a rule alreadydefined
v EVENT_RULE_MUST_HAVE_FILTER
240 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
An alerting event rule must have a filter, either event code or severityv CYCLIC_ESCALATION_RULES_DEFINITION
Event rule escalation cannot be cyclicv EVENT_RULE_USED_FOR_ESCALATION_MUST_BE_ALERTING
Event rule is an escalation rule of another event rule and thus must be analerting rule
v EVENT_RULE_CANNOT_REFER_TO_INTERNAL_EVENT_CODES
A user event rule cannot refer to internal event codesv ESCALATION_EVENT_RULE_CANNOT_HAVE_FILTER
An escalation-only event rule cannot have code or min_severity specificationv EVENT_RULE_CANNOT_HAVE_A_CATEGORY
A user event rule cannot have a category definitionv EVENT_RULE_CANNOT_HAVE_BOTH_CODES_AND_EXCEPTION_CODES
An event rule cannot have both codes and exception codesv ESCALATION_EVENT_RULE_MUST_BE_ALERTING
Escalation-only event rules must be alerting rulesv TOO_MANY_EVENT_CODES
A maximum of Maximum event codes can be specifiedv EVENT_CODE_APPEARS_TWICE
Event code 'Code' appears twice in the listTroubleshooting: Each event code must appear at most once.
v UNRECOGNIZED_EVENT_CODE
'String' is not a recognized event codeTroubleshooting: Consult the manual for the list of event codes
v DOMAIN_DOESNT_EXIST
Domain does not exist.v DESTINATION_IS_NOT_IN_RULE_DOMAINS
Destination must by included in the rule domains.v DESTGROUP_IS_NOT_IN_RULE_DOMAINS
Destination groups must by included in the rule domains.v ESCALATION_RULE_NOT_IN_RULE_DOMAINS
Escalation rule must belong to rule domains.v EVENT_RULE_MUST_NOT_HAVE_SNMP_DEST
On current system configuration state (snmp_type = NONE) event rule must nothave SNMP destination
Defining an SMS gatewayUse the smsgw_define command to define an SMS gateway.
smsgw_define smsgw=SMSGatewayName email_address=emailsubject_line=SubjectLineScheme email_body=EmailBodyScheme[ smtpgw=<SMTPGW1[,SMTPGW2]...|ALL> ]
Chapter 11. Event handling commands 241
Parameters
Name Type Description Mandatory Default
smsgw Object name SMS gatewayname.
Y N/A
email_address Token String Format for theemail address.
Y N/A
subject_line Token String Format for thesubject line.
Y N/A
email_body Token String Format for theemail body.
Y N/A
smtpgw Object name List of SMTPgateways to beused.
N The SMTPgateways definedin thesmtpgw_prioritizecommand.
SMS gateways are used to send event notifications via SMS messages. SMSmessages are sent via SMS-to-email servers.To define a new SMS gateway, it isnecessary to know how SMS messages are encapsulated in the email message.
When the system sends an SMS message, it uses the actual message text thatdescribes the event and the destination number. The destination number iscomprised of an area code and the local number. Both are specified when thedestination is defined as described in the Defining a new event notificationdestination command.
The message text and destination numbers can be embedded into various parts ofthe email message: destination address, subject line, or email body. This commanddefines how email messages are formatted, and how the information of the specificSMS is arranged.
When defining an SMS gateway, three parameters must be specified in order todefine the formatting:v email_address: This is the email address used for sending the SMS via the
email-to-SMS gateway.v subject_line: This is the subject line of the outgoing email that will be
converted to an SMS.v email_body: This is the body of the outgoing email that will be converted to an
SMS.
For each of these parameters, the value can be either fixed text, or an event text, orthe destination phone number. The information must be embedded into thefollowing escape sequences:v {areacode}. This escape sequence is replaced by the destination's cellular
number area code.v {number}. This escape sequence is replaced by the destination's cellular local
number.v {message}. This escape sequence is replaced by the text to be shown to the user.v \{, \}, \\. These are replaced by the {, } or \ respectively.
By default, the email to the email-to-SMS server is sent through the defined SMTPservers, prioritized by the smtpgw_prioritize command (see Prioritizing SMTP
242 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
gateways). If needed, the user may define a specific SMTP gateway or gatewaysfor sending email to this email-to-SMS gateway.
The system will try each SMS gateway, in the order specified in thesmtpgw_prioritize command, until it successfully connects to one of them. Thespecific SMS destination can be associated with the specific SMS gateway (seeDefining a new event notification destination).
Example:
smsgw_define smsgw=SMSGW1email_address={areacode}{number}@sms2emailserver.yourcompany.comsubject_line=SMS email_body={message}
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv GATEWAY_MAX_REACHED
Maximum number of gateways already definedv SMSGW_CANNOT_BE_DEFINED_WITHOUT_SMTPGW
SMS gateways cannot be defined if no SMTP gateways are definedv GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not existv GATEWAY_NAME_APPEARS_TWICE
Gateway name appears twice in the listv GATEWAY_NAME_ALREADY_EXISTS
Gateway name already exists
Deleting an SMS gatewayUse the smsgw_delete command to delete an SMS gateway.
smsgw_delete smsgw=SMSGatewayName
Chapter 11. Event handling commands 243
Parameters
Name Type Description Mandatory
smsgw Object name SMS gateway to bedeleted.
Y
A gateway cannot be deleted if it is part of a notification rule or if it is being usedby a destination.
Before deleting an SMS gateway, make sure that all alerting events are cleared.
Example:
smsgw_delete smsgw=external-SMSGW
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_SMS_GATEWAY
Are you sure you want to delete SMS gateway Gateway?
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not existv GATEWAY_USED_BY_DESTINATION
Gateway is used by a destination
Listing SMS gatewaysUse the smsgw_list command to list SMS gateways.
smsgw_list [ smsgw=SMSGatewayName ]
244 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
smsgw Object name Name of SMSgateway to list.
N All gateways.
The command lists all SMS gateways, or a specific one. For each SMS gateway, allof its configuration information is listed.
Field ID Field output Default position
name Name 1
email_address Email Address 2
gateways SMTP Gateways 3
subject_line Subject Line N/A
email_body Email Body N/A
priority Priority N/A
Example:
smsgw_list
Output:
Name Email Address SMTP GatewaysSMSGW1 {areacode}{number}@sms2emailserver.yourcompany.com allSMSGW2 {areacode}{number}@sms2emailservice.com all
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Prioritizing SMS gatewaysUse the smsgw_prioritize command to set the priorities of the SMS gateways forsending SMS messages.
smsgw_prioritize order=<gw1[,gw2]...>
Parameters
Name Type Description Mandatory
order Object name List of all SMSgateways ordered bypriority.
Y
Chapter 11. Event handling commands 245
SMS messages can be sent to cell phones through one of the email-to-SMSgateways in this list. This command determines the order in which the storagesystem attempts to use these SMS gateways.
Only one gateway is used and subsequent gateways are only tried if the precedingones in this priority list return an error.
Specific SMS destinations may define their own SMS gateways to be used whensending SMS to these destinations, regardless of this list.
Example:
smsgw_prioritize order=SMSGW1,SMSGW2
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v GATEWAY_NAME_APPEARS_TWICE
Gateway name appears twice in the listv GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not existv GATEWAY_NAME_MISSING_FROM_LIST
Gateway name is missing from the list
Renaming an SMS gatewayUse the smsgw_rename command to rename an SMS gateway.
smsgw_rename smsgw=SMSGatewayName new_name=Name
Parameters
Name Type Description Mandatory
smsgw Object name SMS gateway to berenamed.
Y
246 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory
new_name Object name New name for the SMSgateway.
Y
Before renaming an SMS gateway, make sure that all alerting events are cleared.
Example:
smsgw_rename smsgw=SMSGW2 new_name=external-SMSGW
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v GATEWAY_NAME_ALREADY_EXISTS
Gateway name already existsv GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not exist
Updating an SMS gatewayUse the smsgw_update command to update an SMS gateway.
smsgw_update smsgw=SMSGatewayName [ email_address=email ][ subject_line=SubjectLineScheme ] [ email_body=EmailBodyScheme ][ smtpgw=<SMTPGW1[,SMTPGW2]...|ALL> ]
Parameters
Name Type Description Mandatory Default
smsgw Object name SMS gatewayname.
Y N/A
email_address Token String Format for emailaddress.
N Leave unchanged.
subject_line Token String Format for subjectline.
N Leave unchanged.
Chapter 11. Event handling commands 247
Name Type Description Mandatory Default
email_body Token String Format for theemail's body.
N Leave unchanged.
smtpgw Object name List of SMTPgateways to beused.
N The SMTPgateways definedin thesmtpgw_prioritizecommand.
This command updates the configuration information of an existing SMS gateway.For the exact description and documentation of each parameter, see thedocumentation of Defining an SMS gateway.
This command cannot be executed while there are uncleared alerting events.
Parameters that are not specified will not be changed.
Example:
smsgw_update smsgw=SMSGW1email_address={areacode}{number}@sms2emailserver.yourcompany.com
subject_line=NextraSMSemail_body={message}
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v GATEWAY_NAME_APPEARS_TWICE
Gateway name appears twice in the listv GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not exist
248 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Defining a new SMTP gatewayUse the smtpgw_define command to define an SMTP gateway.
smtpgw_define smtpgw=SMTPGatewayName address=Address[ from_address=<email|DEFAULT> ][ reply_to_address=<email|DEFAULT> ]
Parameters
Name Type Description Mandatory Default
smtpgw Object name SMTP gatewayname.
Y N/A
address N/A SMTP gatewayaddress (IP orDNS name).
Y N/A
from_address N/A Sender's emailaddress used foroutgoing emailssent through thisSMTP server.
N DEFAULT(system-widesender's addressthat applies to allservers).
reply_to_address N/A The reply toaddress used foroutgoing emailssent through thisSMTP server.
N DEFAULT(system-widereply-to addressthat applies to allservers).
Several email gateways can be defined to enable notification of events by email orsending SMS messages via email-to-SMS gateways. By default, the system attemptsto send each email notification through the first gateway according to the orderthat you specify. Subsequent gateways are only tried if the first in line returns anerror. A specific email destination, or a specific SMS gateway may be defined touse only specific SMTP gateways.
The SMTP protocol dictates that every email message must specify the emailaddress of the sender. This sender address must be a valid address for tworeasons:v Many SMTP gateways require a valid sender address, otherwise they will not
forward the email, as a security measure in order to prevent unauthorized usageof the SMTP server. Often this sender address must be limited to a specificdomain.
v The sender's address is used as the destination for error messages generated bythe SMTP gateways, such as: incorrect email address, full email mailbox and soon.
If the sender's address is not specified for a specific SMTP gateway, a globalsystem-wide sender's address specified in Setting configuration parameters is used.
The user can also configure a reply-to address which is different from the sender'saddress, if it is required that the return emails be sent to another destination.
Example:
smtpgw_define smtpgw=mailserver1 address=smtp.yourcompany.comfrom_address=nextra@[email protected]
Chapter 11. Event handling commands 249
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv FROM_ADDRESS_NOT_DEFINED
Neither the gateway's From Address nor the default From Address is definedv GATEWAY_MAX_REACHED
Maximum number of gateways already definedv GATEWAY_NAME_ALREADY_EXISTS
Gateway name already exists
Deleting an SMTP gatewayUse the smtpgw_delete command to delete the specified SMTP gateway.
smtpgw_delete smtpgw=SMTPGatewayName
Parameters
Name Type Description Mandatory
smtpgw Object name SMTP gateway to bedeleted.
Y
A gateway cannot be deleted if it is part of a notification rule, is being used as anSMS gateway, or if it belongs to a destination.
Before deleting an SMTP gateway, make sure that all alerting events are cleared.
Example:
smtpgw_delete smtpgw=mailserverbackup
Output:
Command completed successfully
250 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_SMTP_GATEWAY
Are you sure you want to delete SMTP gateway Gateway?
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not existv GATEWAY_USED_BY_DESTINATION
Gateway is used by a destinationv GATEWAY_USED_BY_SMS_GATEWAY
Gateway is used by an SMS Gateway
Listing SMTP gatewaysUse the smtpgw_list command to list SMTP gateways.
smtpgw_list [ smtpgw=SMTPGatewayName ]
Parameters
Name Type Description Mandatory Default
smtpgw Object name Name of SMTPgateway to list.
N no.
This command lists defined SMTP gateways and their configuration information.
Field ID Field output Default position
name Name 1
address Address 2
priority Priority 3
from_address From Address N/A
reply_to_address Reply-to Address N/A
failed Failed N/A
port Port N/A
creator Creator N/A
Chapter 11. Event handling commands 251
Example:
smtpgw_list
Output:
Name Email Address Port Priority----------- -------------------- ---- --------mailserver1 smtp.yourcompany.com 25 1mailserver2 smtp.yourcompany.com 25 2
Access control
User Category Permission Condition
Storage administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Storage integration administrator Disallowed N/A
Application administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Security administrator Disallowed N/A
Read-only users Conditionally Allowed Allowed, unless the internalparameter is specified.
Technicians Allowed N/A
Prioritizing SMTP gatewaysUse the smtpgw_prioritize command to prioritize SMTP gateways.
smtpgw_prioritize order=<gw1[,gw2]...>
Parameters
Name Type Description Mandatory
order Object name List of all the SMTPgateways in the order oftheir priority.
Y
Several email gateways can be defined to enable notification of events or thesending of SMS by email. By default, XIV attempts to send each email through thefirst gateway according to the order that is specified in this command. Only onegateway is used and subsequent gateways are only tried if the preceding ones inthis priority list return an error.
These priorities are used only for email destinations and SMS gateways that didnot specify their own SMTP gateways.
Example:
smtpgw_prioritize order=mailserver2,mailserver1
Output:
252 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v GATEWAY_NAME_APPEARS_TWICE
Gateway name appears twice in the listv GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not existv GATEWAY_NAME_MISSING_FROM_LIST
Gateway name is missing from the list
Renaming an SMTP gatewayUse the smtpgw_rename command to rename an SMTP gateway.
smtpgw_rename smtpgw=SMTPGatewayName new_name=Name
Parameters
Name Type Description Mandatory
smtpgw Object name SMTP gateway to berenamed.
Y
new_name Object name New name for theSMTP gateway.
Y
Example:
smtpgw_rename smtpgw=mailserver2 new_name=mailserverbackup
Output:
Command completed successfully.
Chapter 11. Event handling commands 253
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v GATEWAY_NAME_ALREADY_EXISTS
Gateway name already existsv GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not exist
Updating an SMTP gatewayUse the smtpgw_update command to update the configuration of an SMTP gateway.
smtpgw_update smtpgw=SMTPGatewayName [ address=Address ][ from_address=<email|DEFAULT> ][ reply_to_address=<email|DEFAULT> ] [ internal=<yes|no> ]
Parameters
Name Type Description Mandatory Default
smtpgw Object name SMTP gatewayname.
Y N/A
address N/A SMTP gatewayaddress (IP orDNS name).
N Leave unchanged.
internal Boolean For an XIVinternal gateway,set to Yes.
N NO
from_address N/A Sender's emailaddress used forout-going emailssent through thisSMTP server, orDEFAULT for thesystem-widedefault.
N Leave unchanged.
reply_to_address N/A The reply-toaddress used foroutgoing emailssent through thisSMTP server, orDEFAULT for thesystem-widedefault.
N Leave unchanged.
254 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
This command updates the configuration of an existing SMTP gateway. Fieldswhich are not specified are not changed.
Example:
smtpgw_update smtpgw=mailserver1 address=smtp2.yourcompany.comfrom_address=nextra@[email protected]
Output:
Command executed successfully.
Access control
User Category Permission Condition
Storage administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Storage integration administrator Disallowed N/A
Application administrator Conditionally Allowed Allowed, unless the internalparameter is specified.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Allowed N/A
Return codesv GATEWAY_NAME_DOES_NOT_EXIST
Gateway name does not existv CANNOT_CHANGE_EVENT_CONF_WITH_ALERTING_EVENTS
Cannot change event configuration while there are alerting eventsTroubleshooting: Clear all alerting events before changing event configuration
v FROM_ADDRESS_NOT_DEFINED
Neither the gateway's From Address nor the default From Address is definedv ONLY_TECHNICIAN_CAN_REFER_TO_INTERNAL_EVENT_OBJECTS
Only technician can refer to internal event objects
Generating an XMPNS user control eventUse xmpns_user_config_set command to generate an XMPNS_USER_CONTROL event.
xmpns_user_config_set action=Action
Parameters
Name Type Description Mandatory
action String Action code text. Y
Chapter 11. Event handling commands 255
This command generates an XMPNS_USER_CONTROL event which includes theaction_code text in the event's description field. The current logged-in username isalso added to the action string sent in the description field after validating that theuser exists in the given system.
Example:
xmpns_user_config_set action="registration;device_token=aa23d1234;pns=gcm"
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Generating an XMPNS admin control eventUse the xmpns_admin_config_set command to generate an XMPNS_ADMIN_CONTROLevent.
xmpns_admin_config_set action=Action user=User
Parameters
Name Type Description Mandatory
action String Action code text. Y
user String User name. Y
This command generates an XMPNS_ADMIN_CONTROL event which includes theaction_code text in the event's description field. The username is also added to theaction string sent in the description field.
Example:
xmpns_admin_config_set action user
Output:
Command executed successfully.
256 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Chapter 11. Event handling commands 257
258 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 12. IP configuration commands
This section describes the command-line interface (CLI) for IP configuration.
Creating a new IP interfaceUse the ipinterface_create command to create a new IP interface for iSCSI.
ipinterface_create ipinterface=IPInterfaceName address=Address netmask=NetworkMask[ gateway=DefaultGateway ] [ mtu=MTU ] module=ModuleNumber port=PortNumber[ speed=<auto|10mb|100mb|1000mb|1gb|2500mb|2.5gb|10000mb|10gb> ]
Parameters
Name Type Description Mandatory Default
ipinterface Object name The name of the IPinterface to becreated. Do notuse the namesManagement or VPN.
Y N/A
address N/A IP address of theinterface.
Y N/A
netmask N/A Network mask ofthe interface.
Y N/A
gateway N/A IP address of thedefault gatewayfor this interface.This parameter isoptional.
N None
mtu Integer MaximumTransmission Unit:The supportedpacket size by theconnectingEthernet switch.
This is optionalwhen the defaultequals 1536. MTUof up to 4500 issupported.
N 4500 for iSCSI and1536 forManagement andVPN.
module N/A Componentidentifier (rack andmodule) of themodule containingEthernet ports.
Y N/A
port Integer Port Number Y N/A
speed Enumeration Interface's speed,either automatic orexplicit. An explicitspeed turns offauto-negotiation.
N auto
This command defines a new IP interface for iSCSI traffic. Gateway, MTU, networkmask and IP are the standard IP definitions.
© Copyright IBM Corp. 2016 259
Each iSCSI Ethernet port can be defined as an IP interface.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv IPINTERFACE_EXISTS
IP Interface name already usedv ILLEGAL_PORT_NUMBER
Port number is out of rangev PORT_IS_USED_IN_ANOTHER_IP_INTERFACE
One of the physical ports specified is already assigned to an IP Interfacev IP_ADDRESS_ALREADY_USED_IN_ANOTHER_INTERFACE
IP address is already assigned to another interfacev IPADDRESS_AND_GATEWAY_ARE_NOT_ON_SAME_SUBNET
IP address specified for the default gateway is not in the subnet of the IPInterface
v MTU_TOO_LARGE
Specified MTU value is too largev ILLEGAL_COMPONENT_ID
Component ID is illegalv ILLEGAL_IPADDRESS
Illegal IP address was enteredv DUPLICATE_IPADDRESSES
Duplicate IP addresses were specifiedv ILLEGAL_GATEWAY_IPADDRESS
Illegal IP address was specified for default gateway
Deleting IP interfacesUse the ipinterface_delete command to delete an IP interface.
ipinterface_delete ipinterface=IPInterfaceName
Parameters
Name Type Description Mandatory
ipinterface Object name The IP interface to bedeleted.
Y
260 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Only the interfaces defined for iSCSI traffic can be deleted. Management and VPNinterfaces cannot be deleted.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv IPINTERFACE_DOES_NOT_EXIST
IP Interface name does not existv COMMAND_NOT_ALLOWED_ON_MANAGEMENT_OR_VPN_INTERFACE
Operation is not allowed on Management or VPN IP Interfacev IPINTERFACE_HAS_CONNECTIVITY
IP interface has connectivity defined to another machine
Listing IP interface configurationUse the ipinterface_list command to list the configuration of a specific IPinterface or all IP interfaces.
ipinterface_list [ ipinterface=IPInterfaceName | address=Address | address6=IPv6address ]
Parameters
Name Type Description Mandatory Default
ipinterface Object name The IP interface tobe listed.
N All interfaces
address N/A IP address of theinterface to belisted.
N All interfaces
address6 N/A IPv6 address of theinterface to belisted.
N All interfaces
This command lists configuration information for the specified IP interface, or forall IP interfaces (including management). The management or VPN name can onlybe used to view the configuration of the management of VPN interfaces.
The following information is listed:v Namev Type (iSCSI/management)v IP address (or comma separated addresses for management and VPN)v Network maskv Default gatewayv CIDR address (or comma separated addresses for management and VPN)
Chapter 12. IP configuration commands 261
v Default IPv6 gatewayv MTUv Module (for iSCSI only)v Comma separated list of ports (for iSCSI only)v Interface desired speed information
Example:
ipinterface_list
Output:
Name Type IP Address Network Mask Default Gateway IPv6 Address------------ ------------ --------------- --------------- ----------------- --------------management Management 9.151.154.239 255.255.248.0 9.151.159.254
Cont.:
IPv6 Gateway MTU Module Port IP access group name-------------- ------ ------------- ------ ----------------------
1500 1:Module:12
Field ID Field output Default position
name Name 1
type Type 2
address IP Address 3
netmask Network Mask 4
gateway Default Gateway 5
address6 IPv6 Address 6
gateway6 IPv6 Gateway 7
mtu MTU 8
module Module 9
port Port 10
speed Speed N/A
access_group IP access group name 11
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
262 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Listing IP interface addressesUse the ipinterface_list_ips command to list the IP addresses configured on aspecific IP interface or all IP interfaces.
ipinterface_list_ips [ ipinterface=IPInterfaceName |address=Address | address6=IPv6address | module=ModuleNumber ]
Parameters
Name Type Description Mandatory Default
ipinterface Object name The IP interface tobe listed.
N All interfaces
address N/A IP address of theinterface to belisted.
N All addresses
address6 N/A IPv6 address of theinterface to belisted.
N All addresses
module N/A Limits the listingto a specificmodule.
N All modules
This command lists IP addresses for the specified interface, or for the specifiedmodule, or for both (including Management). The Management or VPN name canonly be used to view IP addresses configured for the management of VPNinterfaces.
The following information is listed:v IP Interfacev Interface Type (iSCSI/Management/VPN)v Address (in CIDR format)v Address type (Static IPv4/Static IPv6/Link Local IPv6/Site Local IPv6/Global
IPv6)v Module
Example:
ipinterface_list_ips
Output:
IP Interface Interface Type Address-------------- ---------------- -------------------------------------------management Management 2001:bf8:2000:5159:42f2:e9ff:feaf:ccb2/64management Management 9.151.154.239/21management Management fe80::42f2:e9ff:feaf:ccb2/64
Cont.:
Address Type Module IP access group name----------------- ------------- ----------------------Global IPv6 1:Module:12Static IPv4 1:Module:12Link Local IPv6 1:Module:12
Chapter 12. IP configuration commands 263
Field ID Field output Default position
ipinterface IP Interface 1
ipinterface_type Interface Type 2
address Address 3
address_type Address Type 4
module Module 5
access_group IP access group name 6
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Showing the status and configuration of Ethernet portsUse the ipinterface_list_ports command to list all Ethernet ports together withtheir configuration and status.
ipinterface_list_ports
All physical Ethernet ports used to connect to the user's network are listed. The listincludes the following information:v Component ID (Module number for iSCSI or switch number for
management/field technician port)v Port number on module/switchv For management/VPN/field technician: "management"/"VPN"/"field technician"v IP interface containing the ports (or none, if port is not configured as part of IP
interface)v Status up/downv Auto-negotiation: Half-full duplex, 1000/100/10
Example:
ipinterface_list_ports
Output:
264 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Index Role IP Interface Connected Component Link Up?------- ------------ -------------- ---------------------- ----------1 Component 1:Flash_Canister:4:1 yes1 Component 1:Flash_Canister:4:2 yes1 IPMI 1:Module:13 yes1 IPMI 1:Module:14 yes1 IPMI 1:Module:9 yes1 Internal 1:IB_Switch:1:12 yes1 Internal 1:IB_Switch:1:13 yes1 Internal 1:IB_Switch:1:8 yes1 Management yes1 iSCSI unknown1 iSCSI unknown1 iSCSI unknown2 IPMI 1:Module:11 yes2 IPMI 1:Module:12 yes2 IPMI 1:Module:7 yes2 iSCSI unknown2 iSCSI unknown2 iSCSI unknown
Cont.:
Negotiated Speed (Mb/s) Full Duplex? Module RX Flow Control? TX Flow Control?------------------------- -------------- ------------- ------------------ ------------------1000 yes 1:Module:12 yes yes1000 yes 1:Module:13 yes yes1000 yes 1:Module:12 yes yes1000 yes 1:Module:13 yes yes1000 yes 1:Module:8 yes yes10000 yes 1:Module:12 yes yes10000 yes 1:Module:13 yes yes10000 yes 1:Module:8 yes yes1000 yes 1:Module:12 yes yesN/A unknown 1:Module:12 yes yesN/A unknown 1:Module:13 yes yesN/A unknown 1:Module:8 yes yes1000 yes 1:Module:12 yes yes1000 yes 1:Module:13 yes yes1000 yes 1:Module:8 yes yesN/A unknown 1:Module:12 yes yesN/A unknown 1:Module:13 yes yesN/A unknown 1:Module:8 yes yes
Field ID Field output Default position
index Index 1
role Role 2
ip_interface_name IP Interface 3
connected_component Connected Component 4
is_link_up Link Up? 5
negotiated_speed_Mbs Negotiated Speed (Mb/s) 6
is_full_duplex Full Duplex? 7
module_id Module 8
requires_service Requires Service N/A
service_reason Service Reason N/A
pause_autonegotiate Flow control auto-negotiate? N/A
pause_rx RX Flow Control? 9
pause_tx TX Flow Control? 10
Chapter 12. IP configuration commands 265
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Renaming an IP interfaceUse the ipinterface_rename command to rename an IP interface.
ipinterface_rename ipinterface=IPInterfaceName new_name=Name
Parameters
Name Type Description Mandatory
ipinterface Object name Original name of the IPinterface.
Y
new_name Object name The new name of the IPinterface.
Y
This command renames an IP interface. The IP interface must be unique in thesystem. This command cannot be applied to Management or VPN interfaces.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv IPINTERFACE_DOES_NOT_EXIST
IP Interface name does not existv IPINTERFACE_EXISTS
IP Interface name already usedv COMMAND_NOT_ALLOWED_ON_MANAGEMENT_OR_VPN_INTERFACE
Operation is not allowed on Management or VPN IP Interface
266 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Printing the ARP database of an IP interfaceUse the ipinterface_run_arp command to print the ARP database of the specifiedIP interface.
ipinterface_run_arp localipaddress=IPaddress | localipaddress6=IPv6address
Parameters
Name Description Mandatory
localipaddress IP address of the IP interface forwhich the ARP database shouldbe printed.
N
localipaddress6 IPv6 address of the IP interfacefor which the ARP databaseshould be printed.
N
This command prints a list of the ARP database of an IP interface with its IPaddresses and their associated Ethernet MAC addresses. The IP address must beone of the IP addresses defined for iSCSI IP interfaces, or the management or VPNname.
Field ID Field output Default position
arp_output arp Output 1
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv NO_IP_INTERFACE_MATCHES_CRITERIA
No IP Interface matches given criteriav MORE_THAN_ONE_IP_INTERFACE_MATCHES
More than one IP Interface matches given criteria
Testing the traceroute to a remote IPUse the ipinterface_run_traceroute to test connectivity to a remote IP node usingthe ICMP trace-route mechanism.
ipinterface_run_traceroute localipaddress=IPaddress remote=remoteHost
Chapter 12. IP configuration commands 267
Parameters
Name Description Mandatory
localipaddress IP address of the IP interface forwhich the traceroute commandis run.
Y
remote IP address or DNS for thetraceroute test.
Y
This command runs a route trace to the specified remote host through the specifiedIP interface. The IP address must be one of the IP addresses defined for iSCSI IPinterfaces or the Management or VPN name.
Field ID Field output Default position
traceroute_output traceroute Output 1
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv NO_IP_INTERFACE_MATCHES_CRITERIA
No IP Interface matches given criteriav MORE_THAN_ONE_IP_INTERFACE_MATCHES
More than one IP Interface matches given criteria
Testing the traceroute to a remote IPUse the ipinterface_run_traceroute6 command to test connectivity to a remote IPnode using the ICMP trace-route mechanism.
ipinterface_run_traceroute6 localipaddress6=IPv6address remote6=remoteHost
Parameters
Name Description Mandatory
localipaddress6 IPv6 address of the IP interfacefor which the traceroute6command is run.
Y
remote6 IPv6 address or DNS for thetraceroute test.
Y
This command runs a route trace to the specified remote host through the specifiedIP interface. The IP address must be one of the IP addresses defined for iSCSI IPinterfaces or the Management or VPN name.
268 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
traceroute_output traceroute Output 1
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv NO_IP_INTERFACE_MATCHES_CRITERIA
No IP Interface matches given criteriav MORE_THAN_ONE_IP_INTERFACE_MATCHES
More than one IP Interface matches given criteria
Updating an IP interfaceUse the ipinterface_update command to update the configuration of an IPinterface.
ipinterface_update ipinterface=IPInterfaceName [ address=Address ] [ netmask=NetworkMask ][ gateway=DefaultGateway ] [ address6=IPv6address ] [ gateway6=DefaultIPv6Gateway ][ mtu=MTU ] [ access_group=IPAccessGroupName ]
Parameters
Name Type Description Mandatory Default
ipinterface Object name The name of the IPinterface to beupdated.
Y N/A
address N/A IP address of theinterface or a listof addresses forthe Managementand VPNinterfaces.
N Leaves the addressunchanged.
netmask N/A Network mask ofthe interface.
N Leaves thenetwork maskunchanged.
gateway N/A IP address of thedefault gatewayfor this interface.
N Leaves unchanged.
address6 N/A IPv6 address of theinterface or a listof addresses forthe Managementand VPNinterfaces.
N Leaves the addressunchanged.
Chapter 12. IP configuration commands 269
Name Type Description Mandatory Default
gateway6 N/A IPv6 address of thedefault gatewayfor this interface.
N Leaves unchanged.
mtu Integer MaximumTransmission Unit:The packet sizethat is supportedby the connectingEthernet switch.
N Keep unchanged.
access_group Object name The name of the IPaccess group usedfor IP filtering.
N Keep unchanged.
This command updates the configuration of an existing IP interface.
Fields that are not specified do not change their values.
The name of the interface may either be one of the previously defined IP interfacesfor iSCSI, or Management for the management IP interface, or VPN for the VPNinterface.
Management ports are dedicated for CLI and GUI communications, as well as foroutgoing SNMP and SMTP connections. For management interfaces, the user mustspecify three IP addresses (equal to the number of potential managers, minus thenumber of management ports).
For VPN interfaces, the user must specify two IP addresses (equal to the numberof VPN ports). All VPN addresses must reside on the same subnet.
Example:
ipinterface_update ipinterface=management
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv IPINTERFACE_DOES_NOT_EXIST
IP Interface name does not existv IP_ADDRESS_ALREADY_USED_IN_ANOTHER_INTERFACE
270 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
IP address is already assigned to another interfacev IPADDRESS_AND_GATEWAY_ARE_NOT_ON_SAME_SUBNET
IP address specified for the default gateway is not in the subnet of the IPInterface
v IPINTERFACE_MANAGEMENT_DIFFERENT_SUBNET
IP addresses management modules must all be in the same subnetv IPINTERFACE_MANAGEMENT_MISSING_IPS
Number of IP addresses specified is less than the number of managementmodules
v IPINTERFACE_MANAGEMENT_TOO_MANY_IPS
Number of IP addresses specified is larger than the number of managementmodules
v MTU_TOO_LARGE
Specified MTU value is too largev ILLEGAL_IPADDRESS
Illegal IP address was enteredv DUPLICATE_IPADDRESSES
Duplicate IP addresses were specifiedv ILLEGAL_GATEWAY_IPADDRESS
Illegal IP address was specified for default gatewayv ILLEGAL_IPV6ADDRESS
Illegal IPv6 address was enteredv DUPLICATE_IPV6ADDRESSES
Duplicate IPv6 addresses were specifiedv ILLEGAL_GATEWAY_IPV6_ADDRESS
Illegal IPv6 address was specified for default gatewayv IPV6ADDRESS_AND_GATEWAY_ARE_NOT_ON_SAME_SUBNET
IPv6 address specified for the default gateway is not in the subnet of the IPInterface
v IPV6_ADDRESS_ALREADY_USED_IN_ANOTHER_INTERFACE
IPv6 address is already assigned to another interfacev IPINTERFACE_MANAGEMENT_MISSING_IPV6S
Number of IPv6 addresses specified is less than the number of managementmodules
v IPINTERFACE_MANAGEMENT_TOO_MANY_IPV6S
Number of IPv6 addresses specified is larger than the number of managementmodules
v IPINTERFACE_MANAGEMENT_DIFFERENT_IPV6_SUBNET
IPv6 addresses management modules must all be in the same subnetv IP_ACCESS_GROUP_DOES_NOT_EXIST
IP access group with such name doesn't existv IP_ACCESS_INVALID_INTERFACE_TYPE
IP filtering is applied to an invalid interface (should be management or VPN)
Chapter 12. IP configuration commands 271
Defining a new IPSec connectionUse the ipsec_connection_add command to add a new IPSec connection.
ipsec_connection_add ipsec_connection=ConnectionName left=IPInterfaceName[ right_ip=RightIpAddress ] < passkey=PassKey | certificate=PemCertificate >
Parameters
Name Type Description Mandatory Default
ipsec_connection N/A The name of theIPSec connectionto be added.
Y N/A
left Object name The name of the IPinterface to beused as the leftside: management orVPN.
Y N/A
right_ip N/A IP address of theright side.
N Any
passkey N/A Secret password. N N/A
certificate N/A The content of a.pem file, withasterisks (*)instead ofnewlines. InWindows,drag-and-drop the.pem file from theWindows Explorerto the appropriatelocation in theXCLI sessionwindow; thecontent will beaddedautomatically.
N N/A
This command defines a new IPSec connection between an IP interface and theright side.
IP interface can be either management or VPN. If specified:v the address of the right side is IPv4 or IPv6; otherwise the right side can be anyv the secret password must be shared between the left and the right sidesv the certificate must contain a public key of the right side
Example:
ipsec_connection_add ipsec_connection=MySec left=management passkey="MyPass123"
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
272 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv IPSEC_CONNECTION_EXISTS
The IPSec connection already existsv IPSEC_CONNECTION_BETWEEN_ENDPOINTS_EXISTS
A connection between these endpoints already existsv LEFT_INTERFACE_NOT_FOUND
The specified left side interface was not foundv MAX_IPSEC_CONNECTIONS_REACHED
The maximum allowed number of IPSec connections is already configuredv IPSEC_UNSUPPORTED_FOR_ISCSI
IPSec is unsupported for iSCSI portsv SSL_CERTIFICATE_CHAIN_EMPTY
No certificates found in input.v SSL_CERTIFICATE_HAS_EXPIRED
SSL certificate has expired.v SSL_CERTIFICATE_INVALID_FORMAT
SSL certificate format is invalid or corrupted.v SSL_CERTIFICATE_ISSUER_NOT_FOUND
SSL certificate issuer not found in certificate chain.v SSL_CERTIFICATE_NOT_YET_VALID
SSL certificate is not yet valid.v SSL_CERTIFICATE_VERIFICATION_FAILED
SSL certificate chain verification failed.v SSL_CERTIFICATE_VERIFICATION_INTERNAL_ERROR
SSL certificate verification has failed because of internal system error.
Updating an existing IPSec connectionUse the ipsec_connection_update command to update an existing IPSecconnection.
ipsec_connection_update ipsec_connection=ConnectionName [ left=IPInterfaceName ][ right_ip=RightIpAddress ] [ passkey=PassKey | certificate=PemCertificate ]
Parameters
Name Type Description Mandatory Default
ipsec_connection Object name The name of theIPSec connectionto be updated.
Y N/A
Chapter 12. IP configuration commands 273
Name Type Description Mandatory Default
left Object name The name of the IPinterface to beused as left side:management or VPN.
N None
right_ip N/A The IP address ofthe right side.
N None
passkey N/A Pre-shared key. N None
certificate N/A The content of a.pem file, withasterisks (*)instead ofnewlines. InWindows,drag-and-drop the.pem file from theWindows Explorerto the appropriatelocation in theXCLI sessionwindow; thecontent will beaddedautomatically.
N None
This command updates an existing IPSec connection between an IP interface andthe right side.
IP interface can be either management or VPN. If specified:v the address of the right side is IPv4 or IPv6; otherwise the right side can be anyv the pre-shared key must be shared between the left and the right sidesv the certificate must contain a public key of the right side.
Example:
ipsec_connection_update ipsec_connection=MySec passkey="MyNewPass!@#"
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv IPSEC_CONNECTION_DOES_NOT_EXIST
The specified IPSec connection does not existv IPSEC_CONNECTION_EXISTS
The IPSec connection already existsv LEFT_INTERFACE_NOT_FOUND
274 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
The specified left side interface was not foundv IPSEC_UNSUPPORTED_FOR_ISCSI
IPSec is unsupported for iSCSI portsv SSL_CERTIFICATE_CHAIN_EMPTY
No certificates found in input.v SSL_CERTIFICATE_HAS_EXPIRED
SSL certificate has expired.v SSL_CERTIFICATE_INVALID_FORMAT
SSL certificate format is invalid or corrupted.v SSL_CERTIFICATE_ISSUER_NOT_FOUND
SSL certificate issuer not found in certificate chain.v SSL_CERTIFICATE_NOT_YET_VALID
SSL certificate is not yet valid.v SSL_CERTIFICATE_VERIFICATION_FAILED
SSL certificate chain verification failed.v SSL_CERTIFICATE_VERIFICATION_INTERNAL_ERROR
SSL certificate verification has failed because of internal system error.
Removing an existing IPSec connectionUse the ipsec_connection_remove command to remove an existing IPSecconnection.
ipsec_connection_remove ipsec_connection=ConnectionName
Parameters
Name Type Description Mandatory
ipsec_connection Object name The name of the IPSecconnection to beupdated.
Y
Example:
xcli.py ipsec_connection_remove ipsec_connection=connect1
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Chapter 12. IP configuration commands 275
Return codesv IPSEC_CONNECTION_DOES_NOT_EXIST
The specified IPSec connection does not exist
Listing IPSec connectionsUse the ipsec_connection_list command to list all or specific IPSec connections.
ipsec_connection_list [ ipsec_connection=ConnectionName ]
Parameters
Name Type Description Mandatory Default
ipsec_connection Object name The IPSecconnection(s) to belisted.
N All IPsecconnections
Field ID Field output Default position
name IPSec Connection 1
type Type 2
left Left Interface 3
right_ip Right Address 4
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing IPSec tunnelsUse the ipsec_list_tunnels command to list all or specific IPSec tunnels.
ipsec_list_tunnels [ ipsec_connection=ConnectionName ] [ left=IPInterfaceName ][ left_ip=InterfaceIpAddress ] [ right_ip=RightIpAddress ] [ module=ComponentId ]
Parameters
Name Type Description Mandatory Default
ipsec_connection Object name Lists all IPSectunnels of thisIPSec connection.
N IPSec tunnels of allIPsec connections
left Object name Lists all IPSectunnels from thisinterface.
N IPsec tunnels fromany interface
276 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory Default
left_ip N/A Lists all IPSectunnels from thisleft IP.
N IPsec tunnels fromany left IP
right_ip N/A Lists all IPSectunnels from thisright IP.
N IPsec tunnels toany right IP
module N/A Limits the listingto a specificmodule.
N All modules
Field ID Field output Default position
name IPSec Connection 1
type Type 2
status Status 3
left Left Interface 4
left_ip Left Address 5
right_ip Right Address 6
module Module 7
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Defining a support center connection on restartUse the support_center_config command to configure the connection to a supportcenter on restart.
support_center_config[ connect_on_restart=<yes|no> ][ connect_on_restart_module1=module ][ connect_on_restart_module2=module ][ password=Password ]
Parameters
Name Type Description Mandatory Default
connect_on_restart
Boolean Enables theconnection to thesupport center onrestart.
N no
Chapter 12. IP configuration commands 277
Name Type Description Mandatory Default
connect_on_restart_ module1
N/A The first modulefrom which toestablish aconnection to thesupport centerafter restart.
N Module with firstmanagement port
connect_on_restart_ module2
N/A The secondmodule fromwhich to establisha connection to thesupport centerafter restart.
N Module withsecondmanagement port
password String A password set bythe customer, thatneeds to besubmitted bysupport services,in order to start aremote supportsession. Format:string, must be6-12 alphanumericcharacters, and iscase-insensitive.
N none
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv MODULE_HAS_NO_SUPPORT_CENTER_PORT
The specified module does not have a port from which Support Center canconnect
v NO_MODULE_WITH_SUPPORT_CENTER_PORT
No module has a port from which Support Center can connect
Connecting to a support centerUse the support_center_connect command to connect to a support center.
support_center_connect[ < timeout=Timeout [ idle_timeout=IdleTimeout ] > | always_on=<yes|no> ][ module=ModuleNumber ] [ password=Password ]
278 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
timeout N/A Specifies theduration of thesession. After theduration elapses,the session will bedisconnected. Timeis specified inhh:mm format.
N none
idle_timeout N/A Specifies the idletime for thesession after whichit will bedisconnected. Timeis specified inhh:mm format.
N [timeout]
module N/A The module fromwhich theconnection to thesupport centershould be initiated
N [ the module thathandled the CLIrequest ]
password String A password set bythe customer, thatneeds to besubmitted bysupport services,in order to start aremote supportsession Format:string, must be6-12 alpha-numericcharacters, and iscase-insensitive.
N none
always_on Boolean Enables a constantconnection to thesupport center(rather than anon-demandconnection).
N none
If the support center is not defined, the command will fail.
To control the duration of the session, use the parameters timeout andidle_disconnect.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Chapter 12. IP configuration commands 279
Return codesv NO_SUPPORT_CENTERS_ARE_DEFINED
No support centers are definedv IDLE_TIMEOUT_MUST_BE_LOWER_THAN_TIMEOUT
The idle timeout, if specified, must be lower than the regular timeoutv MODULE_HAS_NO_SUPPORT_CENTER_PORT
The specified module does not have a port from which Support Center canconnect
v NO_MODULE_WITH_SUPPORT_CENTER_PORT
No module has a port from which Support Center can connectv REMOTE_SUPPORT_CLIENT_ALREADY_RUNNING
The Remote Support Client is already runningv REMOTE_SUPPORT_CLIENT_CONNECT_ON_RESTART_IS_RUNNING
The Remote Support Client in connect-on-restart mode is runningTroubleshooting: Run support_center_disconnect to stop it.
Defining a support centerUse the support_center_define command to define a support center.
support_center_define support_center=SupportCenterName address=Address [ port=port ][ priority=priority ]
Parameters
Name Type Description Mandatory Default
support_center Object name The name of thesupport centerserver
Y N/A
address N/A The IP address ofthe support centerserver
Y N/A
port Positive integer The TCP port toconnect to on thesupport center
N 22
priority N/A The priority of thesupport center(support centerswith a higherpriority will beconnected first)
N 0
Example:
xcli.py support_center_define support_center=somewhere address=1.1.1.1
Output:
Command completed successfully
280 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Return codesv MAX_SUPPORT_CENTERS_DEFINED
Maximum number of support centers is already defined.
Deleting a support centerUse the support_center_delete command to delete a support center.
support_center_delete support_center=SupportCenterName
Parameters
Name Type Description Mandatory
support_center Object name The name of thesupport center to delete.
Y
Sessions that belong to this support center are disconnected, even if they are openat the time of deletion.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Warningsv ARE_YOU_SURE_TO_DELETE_THE_SUPPORT_CENTER
Are you sure you want to delete Support Center?.
Return codesv SUPPORT_CENTER_NOT_DEFINED
Support Center is not defined.v CANNOT_DELETE_WHILE_SUPPORT_CENTER_IS_RUNNING
Support Center is running. Disconnect before deleting.
Chapter 12. IP configuration commands 281
Disconnecting from a support centerUse the support_center_disconnect command to disconnect the storage systemfrom a support center.
support_center_disconnect
Example:
support_center_disconnect
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DISCONNECT_BUSY_REMOTE_SUPPORT
Are you sure you want to disconnect the busy Remote Support connection?
Return codesv REMOTE_SUPPORT_CLIENT_NOT_RUNNING
The Remote Support Client is not running
Listing support centersUse the support_center_list command to list support centers.
support_center_list
This command displays the following information about all defined supportcenters:v Namev IP Addressv Portv Priority
Field ID Field output Default position
name Name 1
address Address 2
282 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
port Port 3
priority Priority 4
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the configuration of support center connect-on-restartUse the support_center_show_restart_config command to list information aboutsupport center connect-on-restart configuration.
support_center_show_restart_config
Field ID Field output Default position
enabled Enabled 1
module1_id First Module 2
module2_id Second Module 3
connection_timeout_after_restart
Connection Timeout AfterRestart
N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the status of all support centersUse the support_center_status command to list information about all definedsupport centers.
support_center_status
Example:
support_center_status
Chapter 12. IP configuration commands 283
Output:
State Connected sessions Timeout (min) Module Connected since--------------- -------------------- --------------- -------- -----------------no connection 0 no timeout
Cont.:
Destination Connect-on-restart active------------- ---------------------------
no
Field ID Field output Default position
state State 1
connected_support_sessions Connected sessions 2
minutes_to_timeout Timeout (min) 3
running_from_module Module 4
start_time Connected since 5
destination Destination 6
connect_on_restart Connect-on-restart active 7
stop_connect_on_restart Stop support centerconnect-on-restart
N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Creating a new IP access groupUse the ip_access_group_create command to create a new IP access group.
ip_access_group_create access_group=IPAccessGroupName
Parameters
Name Type Description Mandatory
access_group Object name The name of the IPaccess group to becreated.
Y
The group may contain up to 20 addresses and can be used to limit network accessto a management/VPN interface.
Example:
ip_access_group_create access_group=IPAccessGroup1
284 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv IP_ACCESS_GROUP_ALREADY_EXISTS
IP access group with such name already existsv IP_ACCESS_MAXIMUM_NUMBER_OF_GROUPS_IS_REACHED
Reached maximum number of IP access groups
Removing an address from an IP access groupUse the ip_access_group_remove_address command to delete the IP address of anaccess group.
ip_access_group_remove_address access_group=IPAccessGroupName address=Address
Parameters
Name Type Description Mandatory
access_group Object name The name of the IPaccess group.
Y
address N/A The address that shouldbe deleted from the IPaccess group.
Y
As a prerequisite for completing this command, the IP address must be defined forthe group.
Example:
ip_access_group_remove_address access_group=IPAccessGroup1 address=172.30.214.202
Output:
Command completed successfully
Chapter 12. IP configuration commands 285
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv IP_ACCESS_GROUP_DOES_NOT_EXIST
IP access group with such name doesn't existv IP_ACCESS_ADDRESS_IS_NOT_VALID
The given address is not validv IP_ACCESS_ADDRESS_IS_NOT_IN_GROUP
The given address isn't in the group
Adding a new address to an IP access groupUse the ip_access_group_add_address command to add a new IP to an accessgroup.
ip_access_group_add_address access_group=IPAccessGroupNameaddress=Address [ netmask=NetworkMask ]
Parameters
Name Type Description Mandatory Default
access_group Object name The name of an IPaccess group.
Y N/A
address N/A A valid IP4address or FQDNto be added to theIP access group.
Y N/A
netmask N/A The network maskfor a networkaddress range.
N Single IP addressrange(255.255.255.255).
The address can be an IP4 address with or without a netmask, or a valid hostname (FQDN).
Example:
ip_access_group_add_address access_group=IPAccessGroup1 address=172.30.214.202
Output:
Command completed successfully
286 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv IP_ACCESS_GROUP_DOES_NOT_EXIST
IP access group with such name doesn't existv IP_ACCESS_REMOTE_RESOLVE_ADDRESS_CALL_HAS_FAILED
The remote call to resolve an address has failedv IP_ACCESS_MAXIMUM_NUMBER_OF_ADDRESSES_IN_GROUP_IS_REACHED
Reached the maximum number of addresses in the IP access group
Deleting an existing IP access groupUse the ip_access_group_delete command to delete an IP access group.
ip_access_group_delete access_group=IPAccessGroupName
Parameters
Name Type Description Mandatory
access_group Object name The name of the IPaccess group to bedeleted.
Y
Example:
ip_access_group_delete access_group=DBGroupNew
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Chapter 12. IP configuration commands 287
Return codesv IP_ACCESS_GROUP_DOES_NOT_EXIST
IP access group with such name doesn't existv IP_ACCESS_GROUP_IN_USE
The group is used for IP filtering
Renaming an existing IP access groupUse the ip_access_group_rename command to rename an existing IP access group.
ip_access_group_rename access_group=IPAccessGroupName new_name=Name
Parameters
Name Type Description Mandatory
access_group Object name Name of the IP accessgroup to be renamed.
Y
new_name Object name A new name of the IPaccess group.
Y
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv IP_ACCESS_GROUP_DOES_NOT_EXIST
IP access group with such name doesn't existv IP_ACCESS_GROUP_ALREADY_EXISTS
IP access group with such name already exists
Listing IP access groupsUse the ip_access_group_list command to list IP access groups.
ip_access_group_list
Field ID Field output Default position
name Group Name 1
addresses.0 Address 1 N/A
addresses.1 Address 2 N/A
addresses.2 Address 3 N/A
addresses.3 Address 4 N/A
addresses.4 Address 5 N/A
288 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
addresses.5 Address 6 N/A
addresses.6 Address 7 N/A
addresses.7 Address 8 N/A
addresses.8 Address 9 N/A
addresses.9 Address 10 N/A
addresses.10 Address 11 N/A
addresses.11 Address 12 N/A
addresses.12 Address 13 N/A
addresses.13 Address 14 N/A
addresses.14 Address 15 N/A
addresses.15 Address 16 N/A
addresses.16 Address 17 N/A
addresses.17 Address 18 N/A
addresses.18 Address 19 N/A
addresses.19 Address 20 N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Allowed
Technicians Disallowed
Listing IP access groupsUse the ip_access_group_address_list command to list IP access group addresses.
ip_access_group_address_list
This command lists IP access groups and address lists for these groups.
Example:
ip_access_group_address_list
Output:
Group Name Address---------------- ----------------DBGroup 192.168.1.10IPAccessGroup1 172.30.214.202
Field ID Field output Default position
access_group Group Name 1
address Address 2
Chapter 12. IP configuration commands 289
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Allowed
Technicians Disallowed
290 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 13. PKI configuration commands
This section describes the command-line interface (CLI) for PKI configuration.
Listing PKI itemsUse the pki_list content to list PKI items.
pki_list
The storage system allows you to install certificates generated by your owncertificate authority (CA) for the different services that use digital certificates (SSLauthentication, IPSec, and so on). When you install a certificate, it is associatedwith a name that you provide, which is used for managing it.
Certificates can be installed in one of two ways, depending on your site PKIpolicy:v System generated: This method does not expose the system private key
– The system generates a public-private keypair– The public key is exported in a certificate signing request (CSR) file using the
pki_generate_private_key_and_csr command.– CA generated: The CA signs this file, returning a .PEM file that is then
imported into the storage system using the pki_set_pem command.v The CA generates both the key pair and associated certificate. Both are provided
in a password-protected PKCS#12 file.– This file is imported into the system using the pki_set_pkcs12 command.
The pki_list command lists the following information:v Namev Fingerprintv Has signed certificatev Services
Field ID Field output Default position
name Name 1
fingerprint Fingerprint 2
authenticated Has signed certificate 3
services Services 4
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
© Copyright IBM Corp. 2016 291
User Category Permission
Technicians Disallowed
Generating a certificate signing requestUse the pki_generate_csr command to generate a certificate signing request.
pki_generate_csr name=Name subject=Subject
Parameters
Name Type Description Mandatory
name String The certificate'ssymbolic name.
Y
subject N/A The subject name forthe generated certificaterequest. The argumentmust be formatted as/type0=value0/type1=value1/type2=... .
Y
Example:
pki_generate_csr name subject
Field ID Field output Default position
csr CSR 1
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv FAILED_CREATING_CERTIFICATE_SIGNING_REQUEST
Failed to generate the certificate signing requestTroubleshooting: Generate a certificate signing request specifying a correctsubject (e.g., '/C=US/CN=IBM')
v CERTIFICATE_NAME_DOES_NOT_EXIST
Certificate name was not foundTroubleshooting: Choose a different name
292 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Generating a private key and CSRUse the pki_generate_private_key_and_csr command to generate a private keyand CSR.
pki_generate_private_key_and_csr name=Name subject=Subject [ bits=Bits ]
Parameters
Name Type Description Mandatory Default
bits Integer The private keysize in bits. It canbe between 1024 to4096.
N 2048
name String The certificate'ssymbolic name.
Y N/A
subject N/A The subject namefor the generatedcertificate request.The argumentmust be formattedas/type0=value0/type1=value1/type2=... .
Y N/A
Example:
pki_generate_private_key_and_csr name="my_cert"subject="/C=US/CN=IBM" bits=1024
Field ID Field output Default position
csr CSR 1
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv FAILED_CREATING_CERTIFICATE_SIGNING_REQUEST
Failed to generate the certificate signing requestTroubleshooting: Generate a certificate signing request specifying a correctsubject (e.g., '/C=US/CN=IBM')
v FAILED_CREATING_PRIVATE_KEY
Failed creating private keyv CERTIFICATE_NAME_ALREADY_EXIST
Chapter 13. PKI configuration commands 293
Certificate with same name already existTroubleshooting: Choose a different name
v CERTIFICATE_CONTAINER_FULL
Can't add more ceritifactes, the maximum already definedTroubleshooting: Delete certificate
Deleting the PKI contentUse the pki_remove command to delete the PKI content.
pki_remove name=Name
Parameters
Name Type Description Mandatory
name String The certificate'ssymbolic name.
Y
Example:
pki_remove name="my_cert"
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_CERTIFICATE
Are you sure you want to delete certificate?
Return codesv CERTIFICATE_NAME_DOES_NOT_EXIST
Certificate name was not foundTroubleshooting: Choose a different name
v DEFAULT_CERTIFICATE_CANNOT_BE_DELETED
Default certificate cannot be deleted.
Changing a PKI symbolic nameUse the pki_rename command to change a PKI symbolic name.
pki_rename name=Name new_name=Name
294 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory
name String The current symbolicname.
Y
new_name String The new symbolicname.
Y
Example:
pki_rename name="current_name" new_name="my_new_name"
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv CERTIFICATE_NAME_ALREADY_EXIST
Certificate with same name already existTroubleshooting: Choose a different name
v CERTIFICATE_NAME_DOES_NOT_EXIST
Certificate name was not foundTroubleshooting: Choose a different name
Importing a signed certificateUse the pki_set_pem command to import a signed certificate in PEM format.
pki_set_pem certificate=SigendCertificate [ services=<xcli [ ,cim ][ ,ipsec ]... | ALL | NONE> ]
Parameters
Name Description Mandatory Default
services A comma-separated listof services that use thiscertificate.
N none
Chapter 13. PKI configuration commands 295
Name Description Mandatory Default
certificate The content of signedcertificate in .pem fileformat. Asterisks (*) canbe used instead ofnewlines. In Windows,drag-and-drop the .pemfile from the WindowsExplorer to theappropriate location inthe XCLI sessionwindow; the contentwill be addedautomatically.
Y N/A
Example:
pki_set_pem certificate=validCertificateChain
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv SERVICE_IS_USING_OTHER_CERTIFICATE
Service 'services' is using other certificate.Troubleshooting: Edit the certificate used by service before
v PRIVATE_KEY_ALREADY_HAS_OTHER_CERTIFICATE
The private key matching this certificate already has other certificateTroubleshooting: Use the pki_update command if you want to replace thecertificate
v CERTIFICATE_KEY_WAS_NOT_FOUND
Failed to set certificateTroubleshooting: Check the parameters
v SSL_CERTIFICATE_CHAIN_EMPTY
No certificates found in input.v SSL_CERTIFICATE_HAS_EXPIRED
SSL certificate has expired.v SSL_CERTIFICATE_INVALID_FORMAT
SSL certificate format is invalid or corrupted.
296 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v SSL_CERTIFICATE_ISSUER_NOT_FOUND
SSL certificate issuer not found in certificate chain.v SSL_CERTIFICATE_NOT_YET_VALID
SSL certificate is not yet valid.v SSL_CERTIFICATE_VERIFICATION_FAILED
SSL certificate chain verification failed.v SSL_CERTIFICATE_VERIFICATION_INTERNAL_ERROR
SSL certificate verification has failed because of internal system error.
Importing a PKCS#12 certificateUse the pki_set_pkcs12 command to import a PKCS#12 certificate.
pki_set_pkcs12 name=Name password=Password certificate=Base64Data[ services=<xcli [ ,cim ] [ ,ipsec ] ... | ALL | NONE> ]
Parameters
Name Type Description Mandatory Default
services N/A Acomma-separatedlist of services thatuse this certificate.
N none
password String The PKCS#12 filepassword.
Y N/A
name String The certificate'ssymbolic name.
Y N/A
certificate N/A The PKCS#12content in one-linebase64 format.Such input can becreated, forexample, by abase64 utility:base64 -w0myCert.pfx
Y N/A
Example:
pki_set_pkcs12 name=myPki password=pkiPassword certificate=pkiCertificateBase64
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Chapter 13. PKI configuration commands 297
User Category Permission
Technicians Disallowed
Return codesv SERVICE_IS_USING_OTHER_CERTIFICATE
Service 'services' is using other certificate.Troubleshooting: Edit the certificate used by service before
v CANNOT_VALIDATE_PKCS12_FILE
Failed validating PKCS#12 file.Troubleshooting: Check PKCS#12 file content is encoded to base64, and thepassword is OK.
v DEFAULT_CERTIFICATE_ALREADY_EXIST
Other default certificate already exist.Troubleshooting: Remove the default certificate, or make it not default.
v CERTIFICATE_NAME_ALREADY_EXIST
Certificate with same name already existTroubleshooting: Choose a different name
v BAD_BASE64_DATA
Data cannot be decoded as base-64 data.v FAILED_GETTING_PRIVATE_KEY_FINGERPRINT
Failed getting private key fingerprint.v FAILED_ENCRYPTING_PRIVATE_KEY
Failed encrypting private key.v CERTIFICATE_CONTAINER_FULL
Can't add more ceritifactes, the maximum already definedTroubleshooting: Delete certificate
Displaying the details of a signed certificateUse the pki_show_certificate command to display the details of a signedcertificate.
pki_show_certificate name=Name
Parameters
Name Type Description Mandatory
name String The certificate'ssymbolic name.
Y
Example:
pki_show_certificate name=ibm
Field ID Field output Default position
certificate Certificate 1
298 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv FAILED_PARSING_CERTIFICATE
Failed parsing certificate.v KEY_HAS_NO_CERTIFICATE
The key has no signed certificate defined.v CERTIFICATE_NAME_DOES_NOT_EXIST
Certificate name was not foundTroubleshooting: Choose a different name
Updating a PKI certificate or servicesUse the pki_update command to update a PKI certificate or services.
pki_update name=Name [ services=<xcli [ ,cim ] [ ,ipsec ] ... | ALL | NONE> ][ certificate=SigendCertificate ]
Parameters
Name Type Description Mandatory Default
services N/A Comma-separatedlist of services thatneed to use thiscertificate.
N none
name String The certificate'ssymbolic name.
Y N/A
certificate N/A If this parameter isdefined, thecertificate will bereplaced.
N none
Example:
pki_update name=cert services=xcli,cim
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Chapter 13. PKI configuration commands 299
User Category Permission
Read-only users Disallowed
Technicians Disallowed
Return codesv SERVICE_IS_USING_OTHER_CERTIFICATE
Service 'services' is using other certificate.Troubleshooting: Edit the certificate used by service before
v NO_PKI_UPDATE_PARAMETERS_SPECIFIED
No parameters were specified for updatev CERTIFICATE_DOES_NOT_MATCH_PRIVATE_KEY
Certificate does not match private keyTroubleshooting: Use other certificate.
v CANNOT_SET_SERVICES_BEFORE_SETTING_CERTIFICATE
Can't set services before certificate.Troubleshooting: Set certificate first.
v DEFAULT_CERTIFICATE_ALREADY_EXIST
Other default certificate already exist.Troubleshooting: Remove the default certificate, or make it not default.
v CERTIFICATE_KEY_WAS_NOT_FOUND
Failed to set certificateTroubleshooting: Check the parameters
v CERTIFICATE_NAME_DOES_NOT_EXIST
Certificate name was not foundTroubleshooting: Choose a different name
v SSL_CERTIFICATE_CHAIN_EMPTY
No certificates found in input.v SSL_CERTIFICATE_HAS_EXPIRED
SSL certificate has expired.v SSL_CERTIFICATE_INVALID_FORMAT
SSL certificate format is invalid or corrupted.v SSL_CERTIFICATE_ISSUER_NOT_FOUND
SSL certificate issuer not found in certificate chain.v SSL_CERTIFICATE_NOT_YET_VALID
SSL certificate is not yet valid.v SSL_CERTIFICATE_VERIFICATION_FAILED
SSL certificate chain verification failed.v SSL_CERTIFICATE_VERIFICATION_INTERNAL_ERROR
SSL certificate verification has failed because of internal system error.
300 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 14. InfiniBand commands
This section describes the command-line interface (CLI) for InfiniBand fabricmanagement.
Listing the configured InfiniBand portsUse the ib_port_list command to list the configured InfiniBand ports.
ib_port_list [ ib_port=ComponentId ]
Parameters
Name Description Mandatory Default
ib_port The InfiniBand port tobe listed.
N All IB ports
Example:
ib_port_list
Field ID Field output Default position
port Port 1
component_id Connected Component 2
status Status 3
skip_miswire Allow Any GUID 4
saved_info.peer_guid GUID 5
saved_info.last_state State 6
saved_info.port_down_reason Failure Reason 7
pending_ia_cmd Component Operation N/A
currently_functioning Currently Functioning N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
© Copyright IBM Corp. 2016 301
Listing data counters for the enabled InfiniBand HCA portsUse the ib_hca_counter_list command to list data counters for InfiniBand HCAports, enabled on modules and flash enclosures.
ib_hca_counter_list [ hca_port=ComponentId ]
Parameters
Name Description Mandatory Default
hca_port The InfiniBand HCAport to be listed.
N All IB HCA ports
Example:
ib_hca_counter_list
Output:
Port TX Data RX Data TX Pkt--------------------------- -------------- -------------- ------------1:IB_FlashSystem_Port:4:1 0 0 01:IB_FlashSystem_Port:4:3 0 0 01:IB_FlashSystem_Port:4:5 0 0 01:IB_FlashSystem_Port:4:7 0 0 01:IB_Module_Port:12:1 254584779527 252260909954 20552388541:IB_Module_Port:12:2 0 0 01:IB_Module_Port:13:1 252395242864 254798454598 20615348831:IB_Module_Port:13:2 0 0 01:IB_Module_Port:8:1 254003578209 254027205845 20554947871:IB_Module_Port:8:2 0 0 0
RX Pkt XmtWait------------ -----------0 00 00 00 02058771428 1036864420 02060782961 942358490 02059021166 1030313190 0
Field ID Field output Default position
port Port 1
XmtData TX Data 2
RcvData RX Data 3
XmtPkts TX Pkt 4
RcvPkts RX Pkt 5
XmtWait XmtWait 6
Access control
User Category Permission
Storage administrator Allowed
302 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing error counters for the enabled InfiniBand HCA ports.Use the ib_hca_error_list command to list error counters for InfiniBand HCAports, enabled on modules and flash enclosures.
ib_hca_error_list [ hca_port=ComponentId ]
Parameters
Name Description Mandatory Default
hca_port The InfiniBand HCAport to be listed.
N All IB HCA ports
Example:
ib_hca_error_list
Field ID Field output Default position
port Port 1
SymbolErrors SymErr 2
LinkRecovers LinkRec 3
LinkDowned LinkDown 4
RcvErrors RcvErr 5
RcvRemotePhysErrors RcvRPErr 6
RcvSwRelayErrors RcvSRErr 7
XmtDiscards XmtDisc 8
XmtConstraintErrors XmtCErr 9
RcvConstraintErrors RcvCErr 10
LinkIntegrityErrors LinkIErr 11
ExcBufOverrunErrors ExcBOEre 12
VL15Dropped VL15Dr 13
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Chapter 14. InfiniBand commands 303
Listing the statuses of the enabled InfiniBand HCA portsUse the ib_hca_info_list command to list the statuses of InfiniBand HCA ports,enabled on modules and flash enclosures.
ib_hca_info_list [ hca_port=ComponentId ]
Parameters
Name Description Mandatory Default
hca_port The InfiniBand HCAport to be listed.
N All IB HCA ports
Example:
ib_hca_info_list
Output:
Port IB Log State IB Phys State--------------------------- -------------- ---------------1:IB_FlashSystem_Port:4:1 NOT SAMPLED NOT SAMPLED1:IB_FlashSystem_Port:4:3 NOT SAMPLED NOT SAMPLED1:IB_FlashSystem_Port:4:5 NOT SAMPLED NOT SAMPLED1:IB_FlashSystem_Port:4:7 NOT SAMPLED NOT SAMPLED1:IB_Module_Port:12:1 ACTIVE LINK UP1:IB_Module_Port:12:2 INIT LINK UP1:IB_Module_Port:13:1 ACTIVE LINK UP1:IB_Module_Port:13:2 INIT LINK UP1:IB_Module_Port:8:1 ACTIVE LINK UP1:IB_Module_Port:8:2 INIT LINK UP
Link Speed Link Width-------------- -------------NOT SAMPLED NOT SAMPLEDNOT SAMPLED NOT SAMPLEDNOT SAMPLED NOT SAMPLEDNOT SAMPLED NOT SAMPLED14.0625 Gbps X414.0625 Gbps X414.0625 Gbps X414.0625 Gbps X414.0625 Gbps X414.0625 Gbps X4
Field ID Field output Default position
port Port 1
log_state IB Log State 2
phys_state IB Phys State 3
link_speed Link Speed 4
link_width Link Width 5
link_width_sup Link Width Sup N/A
link_speed_sup Link Speed Sup N/A
link_speed_enabled Link Speed Ena N/A
link_width_enabled Link Width Ena N/A
304 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the configured InfiniBand switchesUse the switch_list command to list the configured InfiniBand switches.
switch_list [ switch=ComponentId ]
Parameters
Name Description Mandatory Default
switch IB switch to list. N All IB switches
Example:
switch_list
Output:
Switch Switch GUID Status MGMT OK Ports OK Power OK BBU OK--------------- ------------------ -------- --------- ---------- ---------- --------1:IB_Switch:1 E41D2D03003C9900 OK yes yes yes yes1:IB_Switch:2 E41D2D03003C9A80 OK yes yes yes yes
Cont.:
Fan OK Temp OK Volt OK Boot Time FW Serial-------- --------- --------- --------------------- ---------- --------------yes yes yes 04/04/2016 10:51:18 3.5.0500 MT1523X09088yes yes yes 27/03/2016 15:28:31 3.5.0500 MT1523X09091
Field ID Field output Default position
component_id Switch 1
status Status 3
sw_mgmt_status MGMT Status N/A
num_of_down_ports Down Ports N/A
mgmt_ok MGMT OK 4
ports_ok Ports OK 5
power_ok Power OK 6
bbu_ok BBU OK 7
fan_ok Fan OK 8
temp_ok Temp OK 9
volt_ok Volt OK 10
fw FW 12
Chapter 14. InfiniBand commands 305
Field ID Field output Default position
mgmt_serial_number Serial 13
mgmt_part_number Part No N/A
mgmt_asic_rev ASIC Rev N/A
mgmt_hw_rev HW Rev N/A
chassis_serial_number Chassis Serial N/A
chassis_part_number Chassis Part No N/A
chassis_asic_rev Chassis ASIC Rev N/A
chassis_hw_rev Chassis HW Rev N/A
original_mgmt_serial_number Original Serial N/A
original_mgmt_part_number Original Part No N/A
original_mgmt_asic_rev Original ASIC Rev N/A
original_mgmt_hw_rev Original HW Rev N/A
original_chassis_serial_number Original Chassis Serial N/A
original_chassis_part_number Original Chassis Part No N/A
original_chassis_asic_rev Original Chassis ASIC Rev N/A
original_chassis_hw_rev Original Chassis HW Rev N/A
currently_functioning Currently Functioning N/A
mgmt_guid Managememt GUID N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
fabric_switch_info.miss_count Miss Count N/A
fabric_switch_info.num_of_ports
Ports N/A
fabric_switch_info.image_guid FW GUID N/A
fabric_switch_info.node_guid Switch GUID 2
fabric_switch_info.dev_id Device ID N/A
fabric_switch_info.dev_rev Device Revision N/A
fabric_switch_info.vendor_id Vendor ID N/A
fabric_switch_info.name Name N/A
fabric_switch_info.mlx_dev_id Ext Device ID N/A
fabric_switch_info.mlx_hw_rev Ext Device Revision N/A
fabric_switch_info.boot_time Boot Time 11
fabric_switch_info.fw_build_id FW BUILD ID N/A
fabric_switch_info.fw_rev FW Ver N/A
fabric_switch_info.fw_build_date
FW Build Date N/A
fabric_switch_info.psid PSID N/A
used_power Total Power Used N/A
power_capacity Total Power Capacity N/A
power_available Total Power Available N/A
projected_max_used_power Projected Max User Power N/A
bbu_runtime Battery Runtime N/A
306 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the configured InfiniBand switch management addressesUse the switch_mgmt_ip_list command to list the configured InfiniBand switchmanagement addresses.
switch_mgmt_ip_list [ switch=ComponentId ]
Parameters
Name Description Mandatory Default
switch IB switch to list. N All IB switches
Example:
switch_mgmt_ip_list
Output:
Switch Type NAT IP Router Real IP Status--------------- -------- ------------- --------------- --------------- --------1:IB_Switch:1 IPOIB 14.10.255.1 1:IB_Switch:1 14.10.255.1 OK1:IB_Switch:1 MGMT1 14.10.254.1 1:Module:1 192.168.0.254 OK1:IB_Switch:1 MGMT2 14.10.253.1 1:Module:4 192.168.1.254 OK1:IB_Switch:1 SERIAL 14.10.10.3 1:Module:3 14.10.10.3 OK1:IB_Switch:2 IPOIB 14.10.255.2 1:IB_Switch:2 14.10.255.2 OK1:IB_Switch:2 MGMT1 14.10.254.2 1:Module:2 192.168.0.254 OK1:IB_Switch:2 MGMT2 14.10.253.2 1:Module:3 192.168.1.254 OK1:IB_Switch:2 SERIAL 14.10.10.4 1:Module:4 14.10.10.4 OK
Field ID Field output Default position
switch_id Switch 1
type Type 2
nat_ip NAT IP 3
router Router 4
real_ip Real IP 5
status Status 6
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Chapter 14. InfiniBand commands 307
User Category Permission
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the configured InfiniBand switch firmware versionsUse the switch_fw_list command to list the configured InfiniBand switchfirmware versions.
switch_fw_list [ switch=ComponentId ]
Parameters
Name Description Mandatory Default
switch IB switch to list. N All IB switches
Example:
switch_fw_list
Output:
Switch Type Version--------------- ----------------- ----------1:IB_Switch:1 ASIC 9.3.71701:IB_Switch:1 BBU1 7031:IB_Switch:1 BBU2 7031:IB_Switch:1 BIOS 4.6.51:IB_Switch:1 CPLD_PORT1 41:IB_Switch:1 CPLD_SWITCH_BRD 71:IB_Switch:1 CPLD_TOR 91:IB_Switch:1 MGMT 3.5.05001:IB_Switch:1 PSU1 4041:IB_Switch:1 PSU2 4041:IB_Switch:2 ASIC 9.3.71701:IB_Switch:2 BBU1 7031:IB_Switch:2 BBU2 7031:IB_Switch:2 BIOS 4.6.51:IB_Switch:2 CPLD_PORT1 41:IB_Switch:2 CPLD_SWITCH_BRD 71:IB_Switch:2 CPLD_TOR 91:IB_Switch:2 MGMT 3.5.05001:IB_Switch:2 PSU1 4041:IB_Switch:2 PSU2 404
Field ID Field output Default position
switch_id Switch 1
type Type 2
version Version 3
original_version Original Version N/A
308 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the configured InfiniBand switch power valuesUse the switch_power_list command to list the configured InfiniBand switchpower values for PSUs and BBUs.
switch_power_list [ switch=ComponentId ]
Parameters
Name Description Mandatory Default
switch IB switch to list. N All IB switches
Example:
switch_power_list
Output:
Switch Type Power W Voltage V Current A Capacity W Feed Status--------------- ------ --------- ----------- ----------- ------------ ------ --------1:IB_Switch:1 BBU1 N/A N/A N/A 330.00 NA OK1:IB_Switch:1 BBU2 N/A N/A N/A 330.00 NA OK1:IB_Switch:1 PS1 46.00 12.11 2.56 400.00 AC OK1:IB_Switch:1 PS2 44.00 12.19 2.75 400.00 AC OK1:IB_Switch:2 BBU1 N/A N/A N/A 330.00 NA OK1:IB_Switch:2 BBU2 N/A N/A N/A 330.00 NA OK1:IB_Switch:2 PS1 47.00 12.05 2.56 400.00 AC OK1:IB_Switch:2 PS2 44.00 12.14 2.81 400.00 AC OK
Field ID Field output Default position
switch_id Switch 1
type Type 2
power Power W 3
voltage Voltage V 4
current Current A 5
capacity Capacity W 6
feed Feed 7
status Status 8
Chapter 14. InfiniBand commands 309
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the configured InfiniBand switch voltage valuesUse the switch_voltage_list command to list the configured InfiniBand switchvoltage values.
switch_voltage_list [ switch=ComponentId ]
Parameters
Name Description Mandatory Default
switch IB switch to list. N All IB switches
Example:
switch_voltage_list
Output:
310 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Switch Type Expected Actual Status High Low--------------- --------------- ---------- -------- -------- ------- -------1:IB_Switch:1 1.05V LAN 1.50 1.49 OK 1.72 1.271:IB_Switch:1 Asic 1.2V 1.20 1.20 OK 1.38 1.021:IB_Switch:1 Asic 1.8V 1.80 1.81 OK 2.06 1.531:IB_Switch:1 Asic 3.3V 3.30 3.31 OK 3.79 2.801:IB_Switch:1 BBU1 12.00 12.50 OK 13.80 10.191:IB_Switch:1 BBU2 12.00 12.50 OK 13.80 10.191:IB_Switch:1 CPU 0.9V 0.90 0.85 OK 1.03 0.771:IB_Switch:1 CPU 1.05V 1.05 1.03 OK 1.21 0.891:IB_Switch:1 CPU 1.8V 1.80 1.78 OK 2.06 1.531:IB_Switch:1 CPU/PCH 1.05V 1.05 1.00 OK 1.10 0.811:IB_Switch:1 DDR3 0.675V 0.68 0.66 OK 0.78 0.561:IB_Switch:1 DDR3 1.35V 1.35 1.34 OK 1.55 1.141:IB_Switch:1 PS1 vout 12V 12.00 12.11 OK 13.80 10.191:IB_Switch:1 PS2 vout 12V 12.00 12.19 OK 13.80 10.191:IB_Switch:1 SYS 3.3V 3.30 3.31 OK 3.79 2.801:IB_Switch:1 USB 5V 5.00 5.01 OK 5.75 4.251:IB_Switch:1 Vcore SX 0.95 0.96 OK 1.09 0.811:IB_Switch:2 1.05V LAN 1.50 1.52 OK 1.72 1.271:IB_Switch:2 Asic 1.2V 1.20 1.21 OK 1.38 1.021:IB_Switch:2 Asic 1.8V 1.80 1.81 OK 2.06 1.531:IB_Switch:2 Asic 3.3V 3.30 3.32 OK 3.79 2.801:IB_Switch:2 BBU1 12.00 12.50 OK 13.80 10.191:IB_Switch:2 BBU2 12.00 12.50 OK 13.80 10.191:IB_Switch:2 CPU 0.9V 0.90 0.86 OK 1.03 0.771:IB_Switch:2 CPU 1.05V 1.05 1.06 OK 1.21 0.891:IB_Switch:2 CPU 1.8V 1.80 1.83 OK 2.06 1.531:IB_Switch:2 CPU/PCH 1.05V 1.05 1.02 OK 1.10 0.811:IB_Switch:2 DDR3 0.675V 0.68 0.68 OK 0.78 0.561:IB_Switch:2 DDR3 1.35V 1.35 1.37 OK 1.55 1.141:IB_Switch:2 PS1 vout 12V 12.00 12.05 OK 13.80 10.191:IB_Switch:2 PS2 vout 12V 12.00 12.14 OK 13.80 10.191:IB_Switch:2 SYS 3.3V 3.30 3.41 OK 3.79 2.801:IB_Switch:2 USB 5V 5.00 5.16 OK 5.75 4.251:IB_Switch:2 Vcore SX 0.95 0.96 OK 1.09 0.81
Field ID Field output Default position
switch_id Switch 1
type Type 2
expected Expected 3
actual Actual 4
status Status 5
high_margin High 6
low_margin Low 7
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Chapter 14. InfiniBand commands 311
Listing the configured InfiniBand switch temperature valuesUse the switch_temp_list command to list the configured InfiniBand switchtemperature values.
switch_temp_list [ switch=ComponentId ]
Parameters
Name Description Mandatory Default
switch IB switch to list. N All IB switches
Example:
switch_temp_list
Output:
Switch Type Actual Alert Critical Status--------------- ------------ -------- -------- ---------- --------1:IB_Switch:1 BBU1 19.60 60.00 60.00 OK1:IB_Switch:1 BBU2 19.50 60.00 60.00 OK1:IB_Switch:1 MGMT_AMB 20.50 120.00 120.00 OK1:IB_Switch:1 MGMT_CPU 25.00 120.00 120.00 OK1:IB_Switch:1 MGMT_CPU1 22.00 120.00 120.00 OK1:IB_Switch:1 MGMT_CPU2 25.00 120.00 120.00 OK1:IB_Switch:1 MGMT_PORTS 22.00 120.00 120.00 OK1:IB_Switch:1 MGMT_SX 28.00 105.00 110.00 OK1:IB_Switch:1 PS1 24.00 120.00 120.00 OK1:IB_Switch:1 PS2 24.00 120.00 120.00 OK1:IB_Switch:2 BBU1 20.00 60.00 60.00 OK1:IB_Switch:2 BBU2 19.89 60.00 60.00 OK1:IB_Switch:2 MGMT_AMB 21.00 120.00 120.00 OK1:IB_Switch:2 MGMT_CPU 26.00 120.00 120.00 OK1:IB_Switch:2 MGMT_CPU1 25.00 120.00 120.00 OK1:IB_Switch:2 MGMT_CPU2 19.00 120.00 120.00 OK1:IB_Switch:2 MGMT_PORTS 22.50 120.00 120.00 OK1:IB_Switch:2 MGMT_SX 28.00 105.00 110.00 OK1:IB_Switch:2 PS1 24.00 120.00 120.00 OK1:IB_Switch:2 PS2 25.00 120.00 120.00 OK
Field ID Field output Default position
switch_id Switch 1
type Type 2
actual Actual 3
alert Alert 4
critical Critical 5
status Status 6
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
312 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission
Read-only users Allowed
Technicians Allowed
Listing the configured InfiniBand switch fan partsUse the switch_fan_part_list command to list the configured InfiniBand switchfan parts.
switch_fan_part_list [ switch=ComponentId ]
Parameters
Name Description Mandatory Default
switch IB switch to list. N All IB switches
Example:
switch_fan_part_list
Output:
Switch Type Part No Serial No HW Rev Speed Status--------------- --------- --------------- -------------- -------- ---------- --------1:IB_Switch:1 FAN1-F1 MTEF-FANF-B MT1523X09083 A2 10608.00 OK1:IB_Switch:1 FAN1-F2 MTEF-FANF-B MT1523X09083 A2 8998.00 OK1:IB_Switch:1 FAN2-F1 MTEF-FANF-B MT1523X09075 A2 10526.00 OK1:IB_Switch:1 FAN2-F2 MTEF-FANF-B MT1523X09075 A2 8939.00 OK1:IB_Switch:1 FAN3-F1 MTEF-FANF-B MT1523X09082 A2 10608.00 OK1:IB_Switch:1 FAN3-F2 MTEF-FANF-B MT1523X09082 A2 8998.00 OK1:IB_Switch:1 FAN4-F1 MTEF-FANF-B MT1523X09077 A2 10691.00 OK1:IB_Switch:1 FAN4-F2 MTEF-FANF-B MT1523X09077 A2 9242.00 OK1:IB_Switch:1 PSU1 MTEF-PSF-AC-B MT1523X09040 A5 14464.00 OK1:IB_Switch:1 PSU2 MTEF-PSF-AC-B MT1523X09044 A5 14592.00 OK1:IB_Switch:2 FAN1-F1 MTEF-FANF-B MT1523X09065 A2 10526.00 OK1:IB_Switch:2 FAN1-F2 MTEF-FANF-B MT1523X09065 A2 9118.00 OK1:IB_Switch:2 FAN2-F1 MTEF-FANF-B MT1523X09072 A2 10445.00 OK1:IB_Switch:2 FAN2-F2 MTEF-FANF-B MT1523X09072 A2 9118.00 OK1:IB_Switch:2 FAN3-F1 MTEF-FANF-B MT1523X09062 A2 10445.00 OK1:IB_Switch:2 FAN3-F2 MTEF-FANF-B MT1523X09062 A2 8998.00 OK1:IB_Switch:2 FAN4-F1 MTEF-FANF-B MT1523X09073 A2 10526.00 OK1:IB_Switch:2 FAN4-F2 MTEF-FANF-B MT1523X09073 A2 8998.00 OK1:IB_Switch:2 PSU1 MTEF-PSF-AC-B MT1523X09035 A5 14464.00 OK1:IB_Switch:2 PSU2 MTEF-PSF-AC-B MT1523X09033 A5 14464.00 OK
Field ID Field output Default position
switch_id Switch 1
type Type 2
part_no Part No 3
serial_no Serial No 4
hw_rev HW Rev 5
speed Speed 6
status Status 7
Chapter 14. InfiniBand commands 313
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the configured InfiniBand switch PSUsUse the switch_psu_list command to list the configured InfiniBand switch PSUs.
switch_psu_list [ switch_psu=ComponentId ]
Parameters
Name Description Mandatory Default
switch_psu IB switch PSU to list. N All IB switch PSUs
Example:
switch_psu_list
Output:
Component ID Status Sensor Status Power W Voltage V--------------------- -------- --------------- --------- -----------1:IB_Switch_PSU:1:1 OK OK 46.00 12.111:IB_Switch_PSU:1:2 OK OK 44.00 12.191:IB_Switch_PSU:2:1 OK OK 47.00 12.051:IB_Switch_PSU:2:2 OK OK 44.00 12.14
Cont.:
Current A Capacity W----------- ------------2.94 400.002.50 400.002.69 400.003.25 400.00
Field ID Field output Default position
component_id Component ID 1
status Status 2
sensor_status Sensor Status 3
power Power W 4
voltage Voltage V 5
current Current A 6
capacity Capacity W 7
temperature Temperature N/A
fan_speed Fan Speed N/A
314 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
fan_sensor_status Fan Status N/A
serial_number Serial No N/A
original_serial_number Original Serial No N/A
part_number Part No N/A
original_part_number Original Part No N/A
hw_rev HW Rev N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
currently_functioning Currently Functioning N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the configured InfiniBand switch BBUsUse the switch_bbu_list command to list the configured InfiniBand switch BBUs.
switch_bbu_list [ switch_bbu=ComponentId ] [ switch=ComponentId ]
Parameters
Name Description Mandatory Default
switch_bbu IB switch BBU to list. N All IB switch BBUs
switch IB switch to list theBBUs of.
N All IB switches
Example:
switch_bbu_list
Output:
Chapter 14. InfiniBand commands 315
Component ID Status Sensor Status Remaining capacity Full charged capacity--------------------- -------- --------------- -------------------- -----------------------1:IB_Switch_BBU:1:1 OK OK 71520 mWh 80660 mWh1:IB_Switch_BBU:1:2 OK OK 46060 mWh 55520 mWh1:IB_Switch_BBU:2:1 OK OK 80800 mWh 80800 mWh1:IB_Switch_BBU:2:2 OK OK 77840 mWh 80120 mWh
Cont.:
Percent Charged Charger Status Calibration Status Last Recondition Date----------------- ---------------- -------------------- -----------------------100% Fully charged N/A N/A100% Fully charged N/A N/A100% Fully charged N/A N/A100% Fully charged N/A N/A
Field ID Field output Default position
component_id Component ID 1
status Status 2
sensor_status Sensor Status 3
relative_capacity Remaining capacity 4
absolute_capacity Full charged capacity 5
relative_capacity_percent Percent Charged 6
charging_state Charger Status 7
calibration_status Calibration Status 8
last_calibration_date Last Recondition Date 9
fw_version FW N/A
serial_number Serial No N/A
original_serial_number Original Serial No N/A
part_number Part No N/A
original_part_number Original Part No N/A
voltage Voltage N/A
exp_voltage Expected Voltage N/A
temperature Temperature N/A
manufacture_date Manufacture Date N/A
designed_capacity Designed Capacity N/A
absolute_charge Absolute Charge N/A
test_status Test Status N/A
last_test_date Last Test Date N/A
can_charge Charge N/A
can_discharge Discharge N/A
charge_rate Charge Rate N/A
max_error Max Error N/A
hw_rev HW Rev N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
currently_functioning Currently Functioning N/A
switch_id Switch ID N/A
316 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the configured InfiniBand switch fansUse the switch_fan_list command to list the configured InfiniBand switch fans.
switch_fan_list [ switch_fan=ComponentId ]
Parameters
Name Description Mandatory Default
switch_fan IB switch fan to list. N All IB switch fans
Example:
switch_fan_list
Output:
Component ID Status Speed Sensor Status Peer Speed Peer Sensor Status--------------------- -------- ---------- --------------- ------------ --------------------1:IB_Switch_Fan:1:1 OK 10608.00 OK 8998.00 OK1:IB_Switch_Fan:1:2 OK 10526.00 OK 8939.00 OK1:IB_Switch_Fan:1:3 OK 10608.00 OK 8998.00 OK1:IB_Switch_Fan:1:4 OK 10691.00 OK 9242.00 OK1:IB_Switch_Fan:2:1 OK 10526.00 OK 9118.00 OK1:IB_Switch_Fan:2:2 OK 10445.00 OK 9118.00 OK1:IB_Switch_Fan:2:3 OK 10445.00 OK 8998.00 OK1:IB_Switch_Fan:2:4 OK 10526.00 OK 8998.00 OK
Field ID Field output Default position
component_id Component ID 1
status Status 2
speed Speed 3
sensor_status Sensor Status 4
peer_speed Peer Speed 5
peer_sensor_status Peer Sensor Status 6
serial_number Serial No N/A
original_serial_number Original Serial No N/A
part_number Part No N/A
original_part_number Original Part No N/A
hw_rev HW Rev N/A
requires_service Requires Service N/A
Chapter 14. InfiniBand commands 317
Field ID Field output Default position
service_reason Service Reason N/A
currently_functioning Currently Functioning N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
318 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 15. Access control commands
This section describes the command-line interface (CLI) for user access control.
Adding an access control definitionUse the access_define command to define an association between a user groupand a host.
access_define user_group=UserGroup < host=HostName | cluster=ClusterName >
Parameters
Name Type Description Mandatory
user_group Object name User group to beassociated with the hostor cluster.
Y
host Object name Host to be associatedwith the user group.
N
cluster Object name Cluster to be associatedwith the user group.
N
This command associates a user group with a host or a cluster. Hosts and clusterscan only be associated with a single user group.
Example:
access_define host=host1 user_group=usergroup1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv USER_GROUP_NAME_DOES_NOT_EXIST
User group name does not existv CLUSTER_BAD_NAME
Cluster name does not exist
© Copyright IBM Corp. 2016 319
v HOST_BAD_NAME
Host name does not existv HOST_BELONGS_TO_CLUSTER
Host is part of a cluster
Deleting an access control definitionUse the access_delete command to delete an access control definition.
access_delete user_group=UserGroup < host=HostName | cluster=ClusterName >
Parameters
Name Type Description Mandatory
user_group Object name The user groupspecified in the accesscontrol definition thatshould be deleted.
Y
host Object name The host specified in theaccess control definitionthat should be deleted.
N
cluster Object name The cluster specified inthe access controldefinition that shouldbe deleted.
N
This command deletes an association between the user group and host or cluster.The operation fails if no such access definition exists. When a host is removedfrom a cluster, the host's associations become the cluster's associations. This allowsa continued mapping of operations, so that all scripts continue to work.
Example:
access_delete user_group=usergroup1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv USER_GROUP_NAME_DOES_NOT_EXIST
User group name does not exist
320 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v USER_GROUP_DOES_NOT_HAVE_ACCESS_TO_CLUSTER
User Group does not have access to clusterv CLUSTER_BAD_NAME
Cluster name does not existv HOST_BAD_NAME
Host name does not existv HOST_BELONGS_TO_CLUSTER
Host is part of a clusterv USER_GROUP_DOES_NOT_HAVE_ACCESS_TO_HOST
User Group does not have access to host
Listing access control definitionsUse the access_list command to list access control definitions.
access_list [ user_group=UserGroup ] [ host=HostName | cluster=ClusterName ]
Parameters
Name Type Description Mandatory Default
user_group Object name Filters the accesscontrol listing todisplay only thisuser group.
N All user groups.
host Object name Filters the accesscontrol listing todisplay only thishost.
N All hosts.
cluster Object name Filters the accesscontrol listing todisplay only thiscluster.
N All clusters.
The list can be displayed for all access control definitions, or it can be filtered for aspecific user group, host/cluster, or both.
Field ID Field output Default position
type Type 1
name Name 2
user_group User Group 3
Example:
access_list host=buffyvam
Output:
Type Name User Grouphost buffyvam testing
Chapter 15. Access control commands 321
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Return codesv HOST_BAD_NAME
Host name does not existv CLUSTER_BAD_NAME
Cluster name does not existv USER_GROUP_NAME_DOES_NOT_EXIST
User group name does not exist
Adding an LDAP server definitionUse the ldap_add_server command to add an LDAP server definition.
ldap_add_server fqdn=Fqdn [ address=Address ]base_dn=LdapDn [ certificate=PemCertificate ] [ port=PortNum ] [ secure_port=PortNum ]
Parameters
Name Type Description Mandatory Default
fqdn N/A FQDN of theLDAP server.
Y N/A
address N/A IP address of theLDAP server.
N none
base_dn N/A Base_DN of theLDAP server.Serves as thestarting referencepoint for searches.
Y N/A
certificate N/A The content of a.pem file, withasterisks (*)instead ofnewlines. InWindows,drag-and-drop the.pem file from theWindows Explorerto the appropriatelocation in theXCLI sessionwindow; thecontent will beaddedautomatically.
N no certificate
port Integer The port number. N 389
322 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory Default
secure_port Integer The secure portnumber.
N 636
Example:
ldap_add_server fqdn=ldap.example.com address=1.2.3.4
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv MAX_LDAP_SERVERS_REACHED
Maximum number of LDAP servers already definedv ADDRESS_CURRENTLY_ASSOCIATED_WITH_ANOTHER_LDAP_SERVER
The specified IP address is currently associated with another LDAP serverv LDAP_SERVER_EXISTS
LDAP server with specified FQDN already existsv SSL_CERTIFICATE_CHAIN_EMPTY
No certificates found in input.v SSL_CERTIFICATE_HAS_EXPIRED
SSL certificate has expired.v SSL_CERTIFICATE_INVALID_FORMAT
SSL certificate format is invalid or corrupted.v SSL_CERTIFICATE_ISSUER_NOT_FOUND
SSL certificate issuer not found in certificate chain.v SSL_CERTIFICATE_NOT_YET_VALID
SSL certificate is not yet valid.v SSL_CERTIFICATE_VERIFICATION_FAILED
SSL certificate chain verification failed.v SSL_CERTIFICATE_VERIFICATION_INTERNAL_ERROR
SSL certificate verification has failed because of internal system error.
Chapter 15. Access control commands 323
Testing an LDAP configurationUse the ldap_test command to authenticate the specified user against an LDAPserver, based on the existing configuration.
ldap_test [ fqdn=Fqdn ] user=UserName password=Password
Parameters
Name Type Description Mandatory Default
fqdn N/A FQDN of an LDAPserver.
N All servers
user String The username ofthe tested user.
Y N/A
password String The password ofthe tested user.
Y N/A
Example:
xcli.py ldap_test user=user1 password=pass1
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv NO_LDAP_SERVERS_ARE_DEFINED
No LDAP servers are defined in the systemv LDAP_SERVER_NOT_DEFINED
LDAP server Server FQDN is not defined in the system.v LDAP_IS_NOT_FULLY_CONFIGURED
LDAP is not fully configuredTroubleshooting: Check your settings.
v NO_LDAP_SERVERS_WITH_CERTIFICATE_ARE_DEFINED
No LDAP servers with an LDAP certificate are defined in the systemv SSL_CERTIFICATE_HAS_EXPIRED_FOR_SERVER
SSL certificate of ldap server 'Server FQDN' has expired on Expiration Date.v USER_IS_PREDEFINED_IN_THE_SYSTEM
User is predefined in the system
324 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v LOGIN_FAILURE_USER_CANNOT_BE_UNIQUELY_AUTHENTICATED_BY_LDAP_SERVER
User User Name was not uniquely authenticated by LDAP server 'Server FQDN'.v LOGIN_FAILURE_LDAP_SERVER_UNREACHABLE
No LDAP server can be reached.v LOGIN_FAILURE_XIV_USER_NOT_AUTHENTICATED_BY_LDAP_SERVER
XIV User 'XIV User' was not authenticated by LDAP server 'Server FQDN'.v LOGIN_FAILURE_LDAP_SERVER_UNREACHABLE_OR_USER_NOT_FOUND
User User Name was not found in LDAP servers 'Servers FQDN'.v LOGIN_FAILURE_INVALID_BASE_DN
The base dn of server 'Server FQDN' is invalid.v LOGIN_FAILURE_USER_NOT_AUTHENTICATED_BY_LDAP_SERVER
User User Name was not authenticated by LDAP server 'Server FQDN'.v LOGIN_FAILURE_USER_HAS_NO_RECOGNIZED_ROLE
User User Name has no recognized LDAP role.v LOGIN_FAILURE_USER_HAS_MORE_THAN_ONE_RECOGNIZED_ROLE
User User Name has more than one recognized LDAP role.v LOGIN_FAILURE_USER_MISSING_ID_ATTRIBUTE
User User Name is missing the LDAP ID attribute 'Attribute'.v LOGIN_FAILURE_USER_MISSING_GROUP_ATTRIBUTE
User User Name is missing the group attribute 'Attribute'.v LOGIN_FAILURE_USER_NOT_FOUND_IN_LDAP_SERVERS
User User Name was not found in LDAP servers.v LDAP_ROLE_UNRECOGNIZED
LDAP role for user is not recognized in the systemv LDAP_SERVER_NOT_FOUND
LDAP server with specified FQDN is not defined in the systemv LDAP_AUTHENTICATION_IS_NOT_ACTIVE
LDAP authentication is not active
Listing LDAP configuration parametersUse the ldap_config_get command to display system parameters that control userauthentication against a specified LDAP server.
ldap_config_get
A successful execution of this command depends on connecting to a valid LDAPserver.
The output of the command does not list LDAP servers. For the list of LDAPservers, use the ldap_list_servers command.
The xiv_password parameter is not listed.
Example:
ldap_config_get
Chapter 15. Access control commands 325
Output:
Name Valuecurrent_serverbase_dnversion 3xiv_group_attribstorage_admin_roleread_only_rolesession_cache_period 20bind_time_limit 20user_id_attrib objectSiDfirst_expiration_event 30second_expiration_event 14third_expiration_event 7use_ssl noxiv_user
Field ID Field output Default position
name Name 1
value Value 2
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Configuring LDAP in the systemUse the ldap_config_set command to configure general system parameters thatcontrol user authentication against LDAP servers.
ldap_config_set [ user_name_attrib=LdapAttrib ] [ xiv_group_attrib=LdapAttrib ][ storage_admin_role=LdapRole ] [ read_only_role=LdapRole ][ security_admin_role=LdapRole ] [ storage_integration_admin_role=LdapRole ][ use_ssl=<yes|no> ] [ user_id_attrib=LdapAttrib ] [ session_cache_period=Minutes ][ bind_time_limit=Seconds ] [ first_expiration_event=Days ][ second_expiration_event=Days ] [ third_expiration_event=Days ] [ version=LdapVersion ][ xiv_user=LdapAttrib ] [ xiv_password=LdapAttrib ][ server_type=<SUN DIRECTORY|MICROSOFT ACTIVE DIRECTORY|OPEN LDAP> ][ group_search_depth=Depth ] [ group_search_max_queries=Number ][ group_search_stop_when_found=<yes|no> ]
326 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
user_name_attrib String User nameattribute forqueries. If notspecified, it is setto uid for SUNDirectory serversanduserPrincipalNamefor MicrosoftActive Directoryservers.
N According toserver type
xiv_group_attrib String LDAP attributedesignated to holdsystem-mappedroles.
N none
storage_admin_role
String LDAP valuemapped to theStorageAdministrator role.Multiple (up to 8)values aresupported andmust be separatedwith a semicolon(;). Multiple rolesare not availablefor SUN DirectoryLDAP Servers.
N none
read_only_role String LDAP valuemapped to theRead Only role.Multiple (up to 8)values aresupported andmust be separatedwith a semicolon(;).
N none
security_admin_role
String LDAP valuemapped to theSecurityAdministrator role.Multiple (up to 8)values aresupported andmust be separatedwith a semicolon(;).
N none
storage_integration_admin_role
String LDAP valuemapped to theStorage IntegrationAdministrator role.Multiple (up to 8)values aresupported andmust be separatedwith a semicolon(;).
N none
use_ssl Boolean Indicates whethersecure LDAP ismandatory.
N no
Chapter 15. Access control commands 327
Name Type Description Mandatory Default
user_id_attrib String The LDAPattribute set toidentify the user(in addition touser DN) whenrecording useroperations in theevent log.
N objectSiD
session_cache_period
Positive integer Duration ofkeeping usercredentials beforeattempting tore-login the user.
N 20
bind_time_limit Positive integer The duration afterwhich the nextLDAP server onthe LDAP serverlist will be called.
N 0. If set to thedefault, the LDAPserver is contactedfor everycommand.Performance issuesdepend on itsavailability.
first_expiration_ event
Positive integer The number ofdays before theexpiration ofcertificate, whenthe first alert isissued (severity:warning).
N 30/14/7 (third issmallest)
second_expiration_ event
Positive integer The number ofdays before theexpiration ofcertificate, whenthe second alert isissued (severity:warning).
N 30/14/7 (third issmallest)
third_expiration_ event
Positive integer The number ofdays before theexpiration ofcertificate, whenthe third alert isissued (severity:warning).
N 30/14/7 (third issmallest)
version Positive integer Version of LDAPused (only version3 is supported).
N 3
xiv_user String The user for LDAPqueries.
N none
xiv_password String The password ofuser for LDAPqueries.
N none
server_type Enumeration Type of the LDAPserver.
N none
group_search_depth Positive integer The depth ofgroup hierarchy tosearch in.
N 0
group_search_max_queries
Positive integer Maximum numberof group queries toperform per server.
N 39
328 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory Default
group_search_stop_when_found
Boolean Stop the groupsearch when agroup match isfound.
N yes
LDAP access permissions are not enforced for predefined users. These predefinedusers are authenticated by the IBM storage system and not by LDAP even if LDAPauthentication is enabled.
Predefined user names are:v adminv technicianv xiv_developmentv xiv_maintenance
When an LDAP user, whose user name is identical with a predefined name,attempts to log into the system with LDAP authentication enabled, access willnormally be denied, because:v the user is not authenticated against LDAP, but rather against the storage systemv the user's (LDAP) password most likely does not match the storage system
password.
However, if the user attempts to log into the system using the password of thecorresponding predefined user, he or she will be granted the rights of thecorresponding predefined user regardless of LDAP settings (for example, the user'sassociation with the Application Administrator role), because LDAP authenticationfor predefined users is not required.
Example:
ldap_config_setbase_dn version xiv_group_attribstorage_admin_role read_only_rolesession_cache_period bind_time_limituse_ssl user_id_attrib first_expiration_eventsecond_expiration_eventthird_expiration_eventxiv_userxiv_passwordserver_type="SUN DIRECTORY"
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Chapter 15. Access control commands 329
User Category Permission
Technicians Disallowed
Return codesv LDAP_IS_NOT_FULLY_CONFIGURED
LDAP is not fully configuredTroubleshooting: Check your settings.
v LDAP_CONFIG_CHANGE_IS_ILLEGAL_WHEN_AUTHENTICATION_IS_ACTIVE
This LDAP configuration change is invalid when LDAP configuration is activeTroubleshooting: Disable LDAP-based authentication and then change LDAPconfiguration.
v LDAP_ROLE_ALREADY_USED
LDAP role is already in use in LDAP configuration or in a user groupv NO_LDAP_SERVERS_WITH_CERTIFICATE_ARE_DEFINED
No LDAP servers with an LDAP certificate are defined in the systemv INVALID_EXPIRATION_EVENT_DATES
Dates for expiration events must be in ascending orderv LDAP_READ_ONLY_ROLE_HAS_WRONG_NUMBER_OF_PARTS
LDAP read only role contains too many partsTroubleshooting: The role is divided to parts by ';' the number of parts shouldbe between 0 and 8
v LDAP_ROLE_HAS_DUPLICATED_PARTS
LDAP role contains duplicated partsv LDAP_STORAGE_ADMIN_ROLE_HAS_WRONG_NUMBER_OF_PARTS
LDAP storage admin role contains too many partsTroubleshooting: The role is divided to parts by ';' the number of parts shouldbe between 0 and 8
v LDAP_SECURITY_ADMIN_ROLE_HAS_WRONG_NUMBER_OF_PARTS
LDAP security admin role contains too many partsTroubleshooting: The role is divided to parts by ';' the number of parts shouldbe between 0 and 8
v LDAP_STORAGE_INTEGRATION_ADMIN_ROLE_HAS_WRONG_NUMBER_OF_PARTS
LDAP storage integration admin role contains too many partsTroubleshooting: The role is divided to parts by ';' the number of parts shouldbe between 0 and 8
Listing LDAP servers defined in the systemUse the ldap_list_servers command to list LDAP servers defined in the system.
ldap_list_servers [ fqdn=Fqdn ]
Parameters
Name Description Mandatory Default
fqdn FQDN of a specificserver to list.
N All servers.
330 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
This command lists the LDAP servers defined in the system along with their typedescription and the indication whether they are mandatory.
Example:
ldap_list_servers fqdn
Output:
<code value="SUCCESS"/><empty_table_message value="No LDAP servers are defined in the system"/><last_change_index value="367896"/><status value="0"/><status_str value="Command completed successfully"/>
Field ID Field output Default position
fqdn FQDN 1
address Address 2
base_dn Base DN 3
has_certificate Has Certificate 4
expiration_date Expiration Date 5
valid_certificate Valid Certificate N/A
accessible Accessible N/A
port Port 6
secure_port Secure Port 7
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Listing LDAP server usersUse the ldap_user_list command to list LDAP server users.
ldap_user_list role=Category [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
role Enumeration The role of theusers to beretrieved from theLDAP server. Theavailable roles are:storageadmin andreadonly.
Y N/A
Chapter 15. Access control commands 331
Name Type Description Mandatory Default
domain Object name The domain name. N All Domains
This command retrieves a list of users from the LDAP server by a specific role.
Field ID Field output Default position
user_name User Name 1
user_role Role 2
Example:
ldap_user_list role=storageadmin
Output:
User Name Role--------------- -----------readonly_user Read Onlyrestldapread Read Onlytest_readonly Read Onlyxivreadonly Read Only
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv LDAP_AUTHENTICATION_IS_NOT_ACTIVE
LDAP authentication is not activev LDAP_IS_NOT_FULLY_CONFIGURED
LDAP is not fully configuredTroubleshooting: Check your settings.
v NO_LDAP_SERVERS_ARE_DEFINED
No LDAP servers are defined in the systemv NO_LDAP_SERVERS_WITH_CERTIFICATE_ARE_DEFINED
No LDAP servers with an LDAP certificate are defined in the systemv LOGIN_FAILURE_XIV_USER_NOT_AUTHENTICATED_BY_LDAP_SERVER
XIV User 'XIV User' was not authenticated by LDAP server 'Server FQDN'.v LOGIN_FAILURE_LDAP_SERVER_UNREACHABLE
No LDAP server can be reached.v LOGIN_FAILURE_INVALID_BASE_DN
The base dn of server 'Server FQDN' is invalid.
332 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Listing LDAP-based authentication modeUse the ldap_mode_get command to list LDAP-based authentication mode.
ldap_mode_get
The command succeeds regardless of whether the LDAP server is accessible.
Example:
ldap_mode_get
Output:
ModeInactive
Field ID Field output Default position
mode Mode 1
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Enabling or disabling LDAP-based authentication modeUse the ldap_mode_set command to enable or disable LDAP-based authenticationmode.
ldap_mode_set mode=Mode
Parameters
Name Type Description Mandatory
mode Boolean The required state ofLDAP authentication.Available values: Active,Inactive.
Y
Example:
ldap_mode_set mode=active
Output:
Chapter 15. Access control commands 333
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
WarningsvUSERS_ASSOCIATED_TO_DOMAIN_ARE_YOU_SURE_YOU_WANT_TO_ENABLE_LDAP_AUTHENTICATION
There are users associated to domains. Are you sure you want to enable LDAPauthentication?v ARE_YOU_SURE_YOU_WANT_TO_ENABLE_LDAP_AUTHENTICATION
Are you sure you want to enable LDAP authentication?v ARE_YOU_SURE_YOU_WANT_TO_DISABLE_LDAP_AUTHENTICATION
Are you sure you want to disable LDAP authentication?
Return codesv LDAP_IS_NOT_FULLY_CONFIGURED
LDAP is not fully configuredTroubleshooting: Check your settings.
v NO_LDAP_SERVERS_WITH_CERTIFICATE_ARE_DEFINED
No LDAP servers with an LDAP certificate are defined in the systemv NO_LDAP_SERVERS_ARE_DEFINED
No LDAP servers are defined in the system
Updating an LDAP server definitionUse the ldap_update_server command to update an existing server configuration.
ldap_update_server fqdn=Fqdn [ address=Address ] [ base_dn=LdapDn ] [ port=PortNum ][ secure_port=PortNum ] [ certificate=PemCertificate | remove_certificate=<no|yes> ]
Parameters
Name Type Description Mandatory Default
fqdn N/A FQDN of theLDAP server.
Y N/A
address N/A IP address of theLDAP server.
N none
334 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory Default
certificate N/A The content of a.pem file, withasterisks (*)instead ofnewlines. InWindows,drag-and-drop the.pem file from theWindows Explorerto the appropriatelocation in theXCLI sessionwindow; thecontent will beaddedautomatically.
N no certificate
remove_certificate
Boolean Defines whether toremove thecertificate.
N no
base_dn N/A Base_DN of theLDAP directory.
N none
port Integer The port number. N none
secure_port Integer The secure portnumber.
N none
Example:
ldap_update_server fqdn=ldap.example.com address=1.2.3.4remove_certificate=yes
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_UPDATE_LDAP_SERVER
Are you sure you want to update the LDAP server configuration?
Return codesv LDAP_SERVER_NOT_FOUND
LDAP server with specified FQDN is not defined in the systemv ADDRESS_CURRENTLY_ASSOCIATED_WITH_ANOTHER_LDAP_SERVER
Chapter 15. Access control commands 335
The specified IP address is currently associated with another LDAP serverv NO_UPDATE_PARAMETERS_SPECIFIED
No LDAP server parameters were specified for updatev SSL_CERTIFICATE_CHAIN_EMPTY
No certificates found in input.v SSL_CERTIFICATE_HAS_EXPIRED
SSL certificate has expired.v SSL_CERTIFICATE_INVALID_FORMAT
SSL certificate format is invalid or corrupted.v SSL_CERTIFICATE_ISSUER_NOT_FOUND
SSL certificate issuer not found in certificate chain.v SSL_CERTIFICATE_NOT_YET_VALID
SSL certificate is not yet valid.v SSL_CERTIFICATE_VERIFICATION_FAILED
SSL certificate chain verification failed.v SSL_CERTIFICATE_VERIFICATION_INTERNAL_ERROR
SSL certificate verification has failed because of internal system error.
Removing an LDAP server definitionUse the ldap_remove_server command to remove an LDAP server definition.
ldap_remove_server fqdn=Fqdn
Parameters
Name Description Mandatory
fqdn FQDN of the server to remove. Y
Example:
ldap_remove_server fqdn=cloud.xivldap2.com
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
336 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Warningsv ARE_YOU_SURE_YOU_WANT_TO_REMOVE_LDAP_SERVER
Are you sure you want to remove LDAP server?
Return codesv LDAP_SERVER_NOT_FOUND
LDAP server with specified FQDN is not defined in the systemv LDAP_IS_ACTIVE_BUT_THIS_IS_THE_LAST_SERVER
Deleting the last LDAP server is illegal when LDAP authentication is activev LDAP_USES_SSL_BUT_THIS_IS_THE_LAST_SERVER_WITH_CERTIFICATE
Deleting the last LDAP server which has a valid SSL certificate is illegal whenLDAP authentication is active and uses SSL
Launching the ldapsearch utilityUse the ldap_search command to launch the ldapsearch utility.
ldap_search user=UserName fqdn=Fqdn [ second_cmd=<yes|no> password=Password ]
Parameters
Name Type Description Mandatory Default
user Object name The username tosearch for.
Y N/A
password N/A The user passwordto search for.
N empty
second_cmd Boolean Defines whether toinvoke the secondlsearch command.
N no
fqdn N/A FQDN of LDAPserver to query.
Y N/A
There are 2 LDAP search commands executed in the authentication process. Thesecond one can be issued by setting the second_cmd parameter to yes.
Example:
ldap_search fqdn user password
Output:
Name Index Value-------------- ------- ------------------------------------------------------command_line 0 ldapsearch -H ldap://ldapwin2003.xivldap2.com:389...returncode 0 0stderr 0stdout 0 dn: CN=employee,CN=Users,DC=xivldap2,DC=comstdout 1 description: Group Onestdout 2 objectSid:: AQUAAAAAAAUVAAAAYcKhSnhmt01IPSuAbQQAAA==stdout 3stdout 4
Field ID Field output Default position
name Name 1
Chapter 15. Access control commands 337
Field ID Field output Default position
index Index 2
value Value 3
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv LOGIN_FAILURE_USER_NOT_AUTHENTICATED_BY_LDAP_SERVER
User User Name was not authenticated by LDAP server 'Server FQDN'.v LOGIN_FAILURE_USER_MISSING_GROUP_ATTRIBUTE
User User Name is missing the group attribute 'Attribute'.v LDAP_SERVER_NOT_FOUND
LDAP server with specified FQDN is not defined in the systemv LOGIN_FAILURE_LDAP_SERVER_UNREACHABLE
No LDAP server can be reached.v LDAP_SERVER_NOT_DEFINED
LDAP server Server FQDN is not defined in the system.v LDAP_ROLE_UNRECOGNIZED
LDAP role for user is not recognized in the systemv LOGIN_FAILURE_USER_HAS_NO_RECOGNIZED_ROLE
User User Name has no recognized LDAP role.v LOGIN_FAILURE_USER_CANNOT_BE_UNIQUELY_AUTHENTICATED_BY_LDAP_SERVER
User User Name was not uniquely authenticated by LDAP server 'Server FQDN'.v LOGIN_FAILURE_XIV_USER_NOT_AUTHENTICATED_BY_LDAP_SERVER
XIV User 'XIV User' was not authenticated by LDAP server 'Server FQDN'.v LOGIN_FAILURE_USER_HAS_MORE_THAN_ONE_RECOGNIZED_ROLE
User User Name has more than one recognized LDAP role.v LOGIN_FAILURE_USER_MISSING_ID_ATTRIBUTE
User User Name is missing the LDAP ID attribute 'Attribute'.v USER_IS_PREDEFINED_IN_THE_SYSTEM
User is predefined in the systemv LOGIN_FAILURE_INVALID_BASE_DN
The base dn of server 'Server FQDN' is invalid.v LDAP_AUTHENTICATION_IS_NOT_ACTIVE
LDAP authentication is not active
338 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Defining a new userUse the user_define command to define a new user.
user_define user=UserName password=Password password_verify=Passwordcategory=Category[ email_address=email ][ area_code=AreaCode number=PhoneNumber ][ domain=DomainList [ exclusive=<yes|no> ] ]
Parameters
Name Type Description Mandatory Default
user Object name User name. Usernames are lowercase.
Y N/A
password N/A Password of theuser to be created.The passwordmust havebetween 6 and 12charactersconsisting of: a-z.A-Z or 0-9.Password is casesensitive.
Y N/A
password_verify N/A Passwordverification, whichmust be equal tothe value ofpassword.
Y N/A
category Enumeration The role of theuser to be created.Available roles:storageadmin,applicationadmin,operationsadmin,securityadmin,readonly andopsadmin.
Y N/A
email_address N/A Email address ofthis user. Theemail addressspecified here canbe used for eventnotification.Entering thisaddress isoptional. The emailaddress format isany legal emailaddress.
N N/A
number N/A Cellular phonenumber of the userfor eventnotification viaSMS, excluding thearea code. Phonenumbers and areacodes can be amaximum of 63digits, dashes (-)and periods (.)
N N/A
Chapter 15. Access control commands 339
Name Type Description Mandatory Default
area_code N/A Area code of thecellular phonenumber of theuser. Phonenumbers and areacodes can be amaximum of 63digits, dashes (-)and periods (.)
N N/A
domain N/A The cluster will beattached to thespecified domains.To specify morethan one domain,separate them witha comma. Tospecify all existingdomains, use "*".
N none
exclusive Boolean Use yes to restrictthe user todomain's objects.
N yes
Email address and phone number are optional and can be used for eventnotification. The category (user role) may be only one of those specified above(other categories contain only a single predefined user).
The maximum number of users is 128.
Two predefined users are set system-wide: Admin and Technician.
Example:
user_define user=xiv_user1 password=s0mePassw0rd password_verify=s0mePassw0rdcategory=applicationadmin
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv USER_NAME_ALREADY_EXISTS
User name already existsv MAX_USERS_REACHED
340 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Maximum number of users already definedv PASSWORDS_DO_NOT_MATCH
Passwords must be identicalv USER_PHONE_NUMBER_MUST_ACCOMPANY_AREA_CODE
Phone numbers and area code must be defined togetherv LDAP_AUTHENTICATION_IS_ACTIVE
Command is not available while LDAP authentication is activev DOMAIN_DOESNT_EXIST
Domain does not exist.v NON_EXCLUSIVE_USER_NOT_SECURITY_ADMIN
Only a security admin can add a user to a domain non-exclusively.v USER_CANNOT_BE_ADDED_TO_A_DOMAIN
Specified user cannot be associated with a domain.v SIA_MUST_BE_ASSOCIATED_WITH_A_DOMAIN
The Storage Integration Administrator must be associated with a domain.
Deleting a userUse the user_delete command to delete a user.
user_delete user=UserName
Parameters
Name Type Description Mandatory
user Object name User to be deleted. Y
Existing objects created by this user will retain an empty user reference after theuser has been deleted.
Two predefined users are set system-wide: Admin and Technician. Predefinedusers cannot be deleted or renamed.
Example:
user_delete user=user1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Chapter 15. Access control commands 341
User Category Permission
Technicians Disallowed
Return codesv LDAP_AUTHENTICATION_IS_ACTIVE
Command is not available while LDAP authentication is activev USER_NAME_DOES_NOT_EXIST
User name does not existv USER_CANNOT_BE_DELETED
User cannot be deletedv USER_IS_REFERRED_TO_BY_DEST
User is referred to by an event destination and therefore cannot be deletedv USER_OWNS_RECOVERY_KEY
User owns recovery key and therefore cannot be deleted or renamedv REMOVAL_WOULD_CREATE_UNRESOLVABLE_REFERENCE_BETWEEN_USER_AND_USERGROUP
The operation would result in a user referring to user group that's not in itsdomain. First remove the reference explicitly.
Adding users to user groupsUse the user_group_add_user command to add a user to a user group.
user_group_add_user user_group=UserGroup user=UserName
Parameters
Name Type Description Mandatory
user_group Object name User group into whichthe user is to be added.
Y
user Object name User to be added to theuser group.
Y
A user group can contain up to eight users.
A user may belong to only one user group.
Only users defined as Application Administrators can be assigned to a group.
This command fails when the user already belongs to the user group.
Example:
user_group_add_user user_group=ug1 user=user1
Output:
Command executed successfully.
342 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv USER_GROUP_NAME_DOES_NOT_EXIST
User group name does not existv USER_NAME_DOES_NOT_EXIST
User name does not existv USER_ALREADY_INCLUDED_IN_ANOTHER_GROUP
User is included in another user groupv USER_GROUP_ALREADY_INCLUDES_USER
User group already includes userv ONLY_APPLICATION_ADMIN_USERS_CAN_BE_GROUPED
User groups can only contain application administratorsv USER_GROUP_HAS_MAXIMUM_NUMBER_OF_USERS
User group already has the maximum number of usersv LDAP_AUTHENTICATION_IS_ACTIVE
Command is not available while LDAP authentication is active
Creating user groupsUse the user_group_create command to create a user group.
user_group_create user_group=UserGroup [ access_all=<yes|no> ] [ ldap_role=LdapRole ][ domain=DomainList ]
Parameters
Name Type Description Mandatory Default
user_group Object name Name of the usergroup to becreated.
Y N/A
access_all Boolean Allows applicationadministrators toperform theirspecifiedoperations on allvolumes and notjust on a subset ofthe specificvolumes.
N no
ldap_role String The valuerepresenting theuser group inLDAP.
N [none]
Chapter 15. Access control commands 343
Name Type Description Mandatory Default
domain N/A The user_groupwill be attached tothe specifieddomains. Tospecify more thanone domain,separate them witha comma. Tospecify all theexisting domains,use "*".
N none
A user group is a group of application administrators who share the same set ofsnapshot creation limitations. After user groups are created, the limitations of allthe users in a user group can be updated with a single command. These limitationsare enforced by associating the user groups with hosts or clusters.
Storage administrators create user groups and control the various applicationadministrator's permissions. Hosts and clusters can be associated with only asingle user group. When a user belongs to a user group that is associated with ahost, it is possible to manage snapshots of the volumes mapped to that host.
User groups have the following limitations:v Only users who are defined as application administrators can be assigned to a
group.v A user can belong to only a single user group.v A user group can contain up to eight users.
User and host associations have the following properties:v User groups can be associated with both hosts and clusters. This allows limiting
application administrator access to specific volumes.v A host that is part of a cluster cannot also be associated with a user group.v When a host is added to a cluster the host's associations are broken. Limitations
on the management of volumes mapped to the host is controlled by the cluster'sassociation.
v When a host is removed from a cluster, the host's associations become the cluster's associations, this allows continued mapping of operations so that all scriptscontinue to work.
Application administrator access level:v The access_all parameter can be specified for application administrators only.
When it is specified, it means that the user has an application administratoraccess level to all volumes, and can perform operations on all volumes and notjust on a subset of the specific volume.
Example:
user_group_create user_group=ug1 ldap_role="App Admin 1" access_all=yes
Output:
Command executed successfully.
344 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv USER_GROUP_NAME_ALREADY_EXISTS
User group name already existsv MAX_USER_GROUPS_REACHED
Maximum number of user groups already definedv LDAP_ROLE_ALREADY_USED
LDAP role is already in use in LDAP configuration or in a user groupv DOMAIN_DOESNT_EXIST
Domain does not exist.
Deleting a user groupUse the user_group_delete command to delete a user group.
user_group_delete user_group=UserGroup
Parameters
Name Type Description Mandatory
user_group Object name User group to bedeleted.
Y
A user group can be deleted, even when it is associated with hosts or clusters. Itcan be deleted while in LDAP Authentication mode.
A user group can be deleted, even when it contains users. Deleting the user groupdoes not delete the users contained in this group.
Example:
user_group_delete user_group=ug1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Chapter 15. Access control commands 345
User Category Permission
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_LDAP_USER_GROUP
One or more LDAP users might be associated to user group. Are you sure youwant to delete this user group?
v ARE_YOU_SURE_YOU_WANT_TO_DELETE_USER_GROUP
Are you sure you want to delete user group?v ARE_YOU_SURE_YOU_WANT_TO_DELETE_POPULATED_USER_GROUP
One or more internal users are associated to user group. Are you sure you wantto delete this user group?
Return codesv USER_GROUP_NAME_DOES_NOT_EXIST
User group name does not exist
Listing user groupsUse the user_group_list command to list all user groups or a specific one.
user_group_list [ user_group=UserGroup ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
user_group Object name The user group tobe listed.
N All user groups.
domain Object name The domain name. N All Domains
All the users included in the user group are listed.
Field ID Field output Default position
name Name 1
access_all Access All 2
ldap_role LDAP Role 3
users Users 4
creator Creator N/A
Example:
user_group_list
Output:
346 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Access All LDAP Role Usersmyug1 yes Group1myOtherUG yes OtherGroupug1 yes App Admin 1ug2 yes App Admin 2
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Removing a user from a user groupUse the user_group_remove_user command to remove a user from a user group.
user_group_remove_user user_group=UserGroup user=UserName
Parameters
Name Type Description Mandatory
user_group Object name User group. Y
user Object name User to be removed. Y
This command fails when the user does not belong to the user group.
Deleting the user group's mapping is done by removing the role association. Theuser group itself is not deleted.
Example:
user_group_remove_user user_group=ug1 user=user1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Chapter 15. Access control commands 347
Warningsv ARE_YOU_SURE_YOU_WANT_TO_REMOVE_USER
Are you sure you want to remove user from user group?
Return codesv USER_GROUP_NAME_DOES_NOT_EXIST
User group name does not existv USER_NAME_DOES_NOT_EXIST
User name does not existv USER_GROUP_DOES_NOT_INCLUDE_USER
User group does not include userv LDAP_AUTHENTICATION_IS_ACTIVE
Command is not available while LDAP authentication is active
Renaming user groupsUse the user_group_rename command to rename a user group.
user_group_rename user_group=UserGroup new_name=Name
Parameters
Name Type Description Mandatory
user_group Object name User group to berenamed.
Y
new_name Object name New name of the usergroup.
Y
Example:
user_group_rename user_group=ug1 new_name=ug2
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
348 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Return codesv USER_GROUP_NAME_DOES_NOT_EXIST
User group name does not existv USER_GROUP_NAME_ALREADY_EXISTS
User group name already exists
Updating a user groupUse the user_group_update command to update a user group.
user_group_update user_group=UserGroup [ ldap_role=LdapRole ] [ access_all=<yes|no> ][ domain=DomainList ]
Parameters
Name Type Description Mandatory Default
user_group Object name The name of theuser group to beupdated.
Y N/A
ldap_role String The valuerepresenting theuser group inLDAP.
N Keep currentLDAP role.
access_all Boolean Assignsapplicationadministrationaccess level for allvolumes.
N no
domain N/A The user_groupwill be attached tothe specifieddomains. Tospecify more thanone domain,separate them witha comma. Tospecify all theexisting domains,use "*".
N none
Example:
user_group_update user_group=ug1 ldap_role="App Admin 1" access_all=yes
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Chapter 15. Access control commands 349
User Category Permission
Read-only users Disallowed
Technicians Disallowed
Return codesv USER_GROUP_NAME_DOES_NOT_EXIST
User group name does not existv LDAP_ROLE_ALREADY_USED
LDAP role is already in use in LDAP configuration or in a user groupv DOMAIN_DOESNT_EXIST
Domain does not exist.v REMOVAL_WOULD_CREATE_UNRESOLVABLE_REFERENCE_BETWEEN_HOST_AND_USERGROUP
The operation would result in a host referring to user group that's not in itsdomain. First remove the reference explicitly.
v REMOVAL_WOULD_CREATE_UNRESOLVABLE_REFERENCE_BETWEEN_CLUSTER_AND_USERGROUP
The operation would result in a cluster referring to user group that's not in itsdomain. First remove the reference explicitly.
v REMOVAL_WOULD_CREATE_UNRESOLVABLE_REFERENCE_BETWEEN_USER_AND_USERGROUP
The operation would result in a user referring to user group that's not in itsdomain. First remove the reference explicitly.
Listing usersUse the user_list command to list all users or a specific user.
user_list [ user=UserName | show_users=<all|active> ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
user Object name The user to belisted.
N All users.
show_users Enumeration Indicates whetherall internal userswill be listed, oronly internal usersthat are active.
N active
domain Object name The domain name. N All Domains
The following information is listed:v User name: Lower casev Categoryv Email addressv Phone numberv Phone area codev Containing user group
Passwords are not shown in the list.
350 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
name Name 1
category Category 2
group Group 3
active Active 4
email_address Email Address 5
area_code Area Code 6
number Phone Number 7
access_all Access All 8
id ID N/A
creator Creator N/A
creator_category Creator Category N/A
Example:
user_list
Output:
Name Category Groupxiv_development xiv_development yesxiv_maintenance xiv_maintenance yesadmin storageadmin yestechnician technician yes
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Disallowed
Renaming usersUse the user_rename command to rename a user.
user_rename user=UserName new_name=Name
Parameters
Name Type Description Mandatory
user Object name The user to be renamed.User names arelowercase.
Y
new_name Object name New name of the user. Y
This command renames a user.
Chapter 15. Access control commands 351
Example:
user_rename user=admin new_name=storage_admin
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv USER_NAME_DOES_NOT_EXIST
User name does not existv USER_NAME_ALREADY_EXISTS
User name already existsv USER_CANNOT_BE_RENAMED
User cannot be renamedv LDAP_AUTHENTICATION_IS_ACTIVE
Command is not available while LDAP authentication is activev USER_OWNS_RECOVERY_KEY
User owns recovery key and therefore cannot be deleted or renamedv OPERATION_NOT_ALLOWED_ON_DESIGNATED_MSM_USER
Designtated MSM user cannot be renamed and cannot be exclusively associatedwith a domain.
Updating a user definitionUse theuser_update command to update a user definition.
user_update user=UserName [ password=Password password_verify=Password ]
[ email_address=email ] [ area_code=AreaCode ][ number=PhoneNumber ][ exclusive=<yes|no> ]
Parameters
Name Type Description Mandatory Default
user Object name The name of theuser to beupdated. Usernames are lowercase.
Y N/A
352 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory Default
password N/A New password.Users can onlychange their ownpasswords. Thepassword consistsof 6-12 characters,comprised of a-z,A-Z and 0-9, andis case sensitive.
N Retains the currentpassword.
password_verify N/A Verification of thepassword: Must beequal to thepassword.
N Retains the currentpassword.
email_address N/A Email address ofthis user (for eventnotification).
N Leaves the currentemail address.
number N/A Cellular phonenumber of the user(for eventnotification viaSMS) excludingthe area code.
N Leaves the currentnumber.
area_code N/A Area code of thecellular phonenumber of theuser.
N Leaves the currentarea code.
exclusive Boolean This parameter canbe set only bysecurityadministrator. Ifset to "yes", theuser will beremoved from theglobal domain. Ifset to "no", theuser will getpermissions on theglobal domain.
N Leaves the currentvalue.
A user with the predefined password admin can change the passwords of otherusers. The category (role) of a user cannot be changed. The user Technician doesnot require a phone number or email address. Limitations on password changesare as follows:v Any user can change his/her own password.v The predefined admin user can change all passwords, excluding the user
Technician.v Passwords are case sensitive.
Example:
user_update user=admin password=Passw0rd password_verify=Passw0rd
Output:
Command executed successfully.
Chapter 15. Access control commands 353
Access control
User Category Permission Condition
Storage administrator Conditionally Allowed A user other than admin mayonly change its ownconfiguration.
Storage integration administrator Disallowed N/A
Application administrator Conditionally Allowed A user of this category may onlychange its own configuration.
Security administrator Conditionally Allowed A user of this category may onlychange its own configuration.
Read-only users Conditionally Allowed A user other than admin mayonly change its ownconfiguration.
Technicians Disallowed N/A
Return codesv USER_NAME_DOES_NOT_EXIST
User name does not existv PASSWORDS_DO_NOT_MATCH
Passwords must be identicalv USER_PHONE_NUMBER_MUST_ACCOMPANY_AREA_CODE
Phone numbers and area code must be defined togetherv ADMIN_CAN_NOT_CHANGE_TECHNICIAN_USER
Administrators cannot change the details of the technician userv SMS_DESTINATION_REFERS_TO_USER
An SMS destination refers to the user and therefore it must have a phonenumber and an area code
v EMAIL_DESTINATION_REFERS_TO_USER
An email destination refers to the user and therefore it must have an emailaddress
v USER_NOT_ALLOWED_TO_CHANGE_OTHER_USERS
This user is not allowed to change the details of other usersv USER_NOT_ALLOWED_TO_HAVE_PHONE_NUMBER
User not allowed to have phone numberv USER_NOT_ALLOWED_TO_HAVE_EMAIL_ADDRESS
User not allowed to have email addressv USER_NOT_ALLOWED_TO_CHANGE_PASSWORDS
This user cannot change passwords of other usersv USER_CANNOT_BE_UPDATED_WHILE_LDAP_AUTHENTICATION_IS_ACTIVE
User cannot be updated while LDAP authentication is activev NON_EXCLUSIVE_USER_NOT_SECURITY_ADMIN
Only a security admin can add a user to a domain non-exclusively.v PREDEFINED_USER_CANNOT_BE_RESTRICTED_TO_DOMAIN
Specified user cannot be exclusively associated with a domain.v SIA_MUST_BE_ASSOCIATED_WITH_A_DOMAIN
The Storage Integration Administrator must be associated with a domain.v USER_IS_REFERRED_TO_BY_DEST
354 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User is referred to by an event destination and therefore cannot be deletedv OPERATION_NOT_ALLOWED_ON_DESIGNATED_MSM_USER
Designtated MSM user cannot be renamed and cannot be exclusively associatedwith a domain.
v REMOVAL_WOULD_CREATE_UNRESOLVABLE_REFERENCE_BETWEEN_USER_AND_USERGROUP
The operation would result in a user referring to user group that's not in itsdomain. First remove the reference explicitly.
Creating a new domainUse the domain_create command to create a domain.
domain_create domain=DomainName [ size=GB ] [ max_pools=MaxPools ][ max_volumes=MaxVolumes ] [ max_cgs=MaxCGs ] [ max_mirrors=MaxMirrors ][ max_dms=MaxDataMigrations ] [ perf_class=perfClassName ] [ ldap_id=LdapRole ]
Parameters
Name Type Description Mandatory Default
domain Object name The name of thedomain to becreated.
Y N/A
size Integer Defines the sum ofthe sizes of all thepools associatedwith the domain,in gigabytes.
N 0
max_pools Positive integer The maximumnumber of poolsthat can beassociated withthis domain.
N 0
max_volumes Positive integer The maximumnumber ofvolumes that canbe associated withall the pools in thisdomain.
N 0
max_cgs Integer The maximumnumber ofconsistency groupsthat can beassociated withthis domain.
N 512
max_mirrors Positive integer The maximumnumber of mirrorsthat can beassociated withthis domain.
N 0
max_dms Positive integer The maximumnumber of datamigrations that canbe associated withthis domain.
N 0
perf_class Object name Name of aperformance class.
N none
Chapter 15. Access control commands 355
Name Type Description Mandatory Default
ldap_id String The name to beassociated withthis domain inLDAP.
N The domain name
Example:
domain_create domain=d1 size=1000
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv DO_YOU_WANT_TO_SHARE_LDAP_ID
The specified ldap_id is already in use, Are you sure you want to share the sameldap_id?
v DOMAIN_SIZE_SMALL
Domain size is smaller than minimal pool size. Are you sure?
Return codesv DOMAIN_ALREADY_EXISTS
A domain with this name already exists.v DOMAIN_MAX_REACHED
The maximum number of domain objects was reached.v PERF_CLASS_BAD_NAME
Performance Class does not existv PERF_CLASS_ASSOCIATED_WITH_HOSTS
Performance Class Performance Class is already in use by host.v PERF_CLASS_ASSOCIATED_WITH_VOLUMES
Performance Class Performance Class is already in use by volume.v DOMAIN_INSUFFICIENT_CAPACITY
There is not enough capacity available for the domain.v DOMAIN_INSUFFICIENT_VOLUMES
There are not enough volumes available for the domain.v DOMAIN_INSUFFICIENT_POOLS
There are not enough pools available for the domain.
356 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v DOMAIN_INSUFFICIENT_CGS
There are not enough cons groups available for the domain.v DOMAIN_INSUFFICIENT_DMS
There are not enough data migration available for the domain.
Updating a domain definitionUse the domain_update command to update a domain definition.
domain_update domain=DomainName [ size=GB ] [ max_pools=MaxPools ][ max_volumes=MaxVolumes ] [ max_cgs=MaxCGs ] [ max_mirrors=MaxMirrors ][ max_dms=MaxDataMigrations ] [ perf_class=perfClassName ] [ ldap_id=LdapRole ]
Parameters
Name Type Description Mandatory Default
domain Object name The name of thedomain to beupdated.
Y N/A
size Integer Defines the sum ofthe sizes of all thepools associatedwith the domain,in gigabytes.
N Current value.
max_pools Positive integer The maximumnumber of poolsthat can beassociated withthis domain.
N Current value.
max_volumes Positive integer The maximumnumber ofvolumes that canbe associated withall the pools in thisdomain.
N Current value.
max_cgs Integer The maximumnumber ofconsistency groupsthat can beassociated withthis domain.
N Current value.
max_mirrors Positive integer The maximumnumber of mirrorsthat can beassociated withthis domain.
N Current value.
max_dms Positive integer The maximumnumber of datamigrations that canbe associated withthis domain.
N Current value.
perf_class Object name Name of aperformance class.
N Current value.
ldap_id String The name to beassociated withthis domain inLDAP.
N Current value.
Example:
Chapter 15. Access control commands 357
domain_update domain=d1 size=10000 max_pools=5 max_volumes=100
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv DO_YOU_WANT_TO_SHARE_LDAP_ID
The specified ldap_id is already in use, Are you sure you want to share the sameldap_id?
v DOMAIN_SIZE_SMALL
Domain size is smaller than minimal pool size. Are you sure?
Return codesv DOMAIN_DOESNT_EXIST
Domain does not exist.v PERF_CLASS_BAD_NAME
Performance Class does not existv PERF_CLASS_ASSOCIATED_WITH_HOSTS
Performance Class Performance Class is already in use by host.v PERF_CLASS_ASSOCIATED_WITH_VOLUMES
Performance Class Performance Class is already in use by volume.v DOMAIN_SIZE_TOO_SMALL
Domain usage exceeds requested size.v DOMAIN_MAX_VOLUMES_TOO_SMALL
Domain already has more than the specified number of volumes.v DOMAIN_MAX_DMS_TOO_SMALL
Domain already has more than the specified number of data migrations.v DOMAIN_MAX_CGS_TOO_SMALL
Domain already has more than the specified number of consistency groups.v DOMAIN_MAX_POOLS_TOO_SMALL
Domain already has more than the specified number of pools.v DOMAIN_INSUFFICIENT_CAPACITY
There is not enough capacity available for the domain.v DOMAIN_INSUFFICIENT_VOLUMES
There are not enough volumes available for the domain.
358 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v DOMAIN_INSUFFICIENT_POOLS
There are not enough pools available for the domain.v DOMAIN_INSUFFICIENT_CGS
There are not enough cons groups available for the domain.v DOMAIN_INSUFFICIENT_DMS
There are not enough data migration available for the domain.
Renaming a domainUse the domain_rename command to rename a domain.
domain_rename domain=DomainName new_name=Name
Parameters
Name Type Description Mandatory
new_name Object name Name of the domain. Y
domain Object name New name of thedomain.
Y
Example:
domain_rename domain=domain1 new_name=domain2
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DOMAIN_ALREADY_EXISTS
A domain with this name already exists.v DOMAIN_DOESNT_EXIST
Domain does not exist.
Deleting a domainUse the domain_delete command to delete a domain.
domain_delete domain=DomainName
Chapter 15. Access control commands 359
Parameters
Name Type Description Mandatory
domain Object name The name of thedomain to delete.
Y
Example:
domain_delete domain=domain1
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DELETE_DOMAIN
Are you sure you want to delete the domain Domain?
Return codesv DOMAIN_DOESNT_EXIST
Domain does not exist.v DOMAIN_HAS_POOL
One or more pools are still in the domain.v DOMAIN_HAS_USER_GROUP
One or more user groups are associated with this domain.v DOMAIN_HAS_USER
One or more users are associated with this domain.v DOMAIN_HAS_DEST
One or more destinations are associated with this domain.v DOMAIN_HAS_DESTGROUP
One or more destination groups are associated with this domain.
Listing domainsUse the domain_list command to list all domains or the specified one.
domain_list [ domain=DomainName ]
360 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
domain Object name Name of adomain.
N All domains.
When the domain parameter is provided, only the specified domain is listed.
Example:
domain_list domain=d1
Output:
Tabular output
Name DN Soft Free Soft Hard Free HardDomain1 Domain1 1703 0 1703 0Domain2 Domain2 1703 1703 1703 1703Domain3 Domain3 1703 1600 1703 1600Domain4 Domain4 1703 1703 1703 1703Domain5 Domain5 1703 1703 1703 1703
XML output<domain id="4e414e00000"><id value="4e414e00000"/><name value="Domain1"/><hard_capacity value="1703"/><soft_capacity value="1703"/><free_soft_capacity value="0"/><free_hard_capacity value="0"/><max_pools value="25"/><used_pools value="1"/><max_volumes value="100"/><used_volumes value="2"/><max_cgs value="100"/><used_cgs value="1"/><max_sync_mirrors value="70"/><used_sync_mirrors value="0"/><ax_async_mirrors value="70"/><used_async_mirrors value="0"/><perf_class_uid value="50713d00000"/><perf_class value="QoS1"/>><dn value="Domain1"/></domain>
Field ID Field output Default position
name Name 1
ldap_id LDAP ID 2
size Size 3
size_MiB Size (MiB) N/A
total_pool_size Total Pools (GB) 4
total_pool_size_MiB Total Pools (MiB) N/A
empty_space Empty (GB) 5
empty_space_MiB Empty (MiB) N/A
max_pools Max Pools 6
used_pools Pools 7
max_volumes Max Volumes 8
used_volumes Volumes 9
Chapter 15. Access control commands 361
Field ID Field output Default position
max_mirrors Max Mirrors 10
used_mirrors Mirrors 11
max_dms Max Data Migrations 12
used_dms Data Migrations 13
max_cgs Max CGs 14
used_cgs CGs 15
perf_class Performance Class 16
managed Managed 17
id ID N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Disallowed
Listing users per domainUse the domain_list_users command to list users associated with domain(s).
domain_list_users [ domain=DomainName ] [ user=UserName ] [ category=Category ][ show_users=<all|active> ]
Parameters
Name Type Description Mandatory Default
domain Object name Name of adomain.
N All domains.
user Object name Name of a user. N All users.
category Enumeration The roles of theusers to be listed.Available optionsare: storageadmin,readonly,applicationadminandstorageintegrationadmin.
N All categories.
show_users Enumeration Indicates whetherto list all internalusers, or onlyactive internalusers.
N active
Example:
domain_list_users domain=d1
362 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Output:
Domain User Category-------- ----------- --------------d1 d1_domain storageadmin
Field ID Field output Default position
domain_name Domain 1
user_name User 2
category Category 3
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Return codesv DOMAIN_DOESNT_EXIST
Domain does not exist.
Listing objects in domainsUse the domain_list_objects command to list objects attached to domain(s).
domain_list_objects [ domain=DomainName ] [ type=ObjectType [ name=ObjectName ] ]
Parameters
Name Type Description Mandatory Default
domain Object name Name of adomain.
N All domains.
type Enumeration The object type tolist: target, host,cluster, schedule,usergroup, dest,destgroup or rule.
N All object types.
name Object name Name of an object. N All object names.
This command is used for listing objects in the system per domain.
Example:
domain_list_objects domain=d1
Output:
Chapter 15. Access control commands 363
Domain Type Object-------- ---------- --------------d1 cluster c1d1 host MyHostd1 schedule min_intervald1 schedule never
Field ID Field output Default position
domain_name Domain 1
object_type Type 2
object_name Object 3
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Return codesv DOMAIN_DOESNT_EXIST
Domain does not exist.v TOO_MANY_OBJECTS
There are too many objects to output. Run the command again, this time use thecommand's parameters to filter the output by domain or object type.
Listing the global domainUse the domain_global_list to list the global domain.
domain_global_list
Example:
domain_global_list
Field ID Field output Default position
name Name 1
ldap_id LDAP ID 2
size Size 3
size_MiB Size (MiB) N/A
total_pool_size Total Pools (GB) 4
total_pool_size_MiB Total Pools (MiB) N/A
empty_space Empty (GB) 5
empty_space_MiB Empty (MiB) N/A
max_pools Max Pools 6
364 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
used_pools Pools 7
max_volumes Max Volumes 8
used_volumes Volumes 9
max_mirrors Max Mirrors 10
used_mirrors Mirrors 11
max_dms Max Data Migrations 12
used_dms Data Migrations 13
max_cgs Max CGs 14
used_cgs CGs 15
perf_class Performance Class 16
managed Managed 17
id ID N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Attaching an object to a domainUse the domain_attach_object command to associate an object with a domain.
domain_attach_object domain=DomainName type=ObjectType name=ObjectName
Parameters
Name Type Description Mandatory
domain Object name The name of thedomain.
Y
type Enumeration The object type toattach to the domain. Itcan be: target, host,cluster, schedule,usergroup, dest,destgroup or rule.
Y
name Object name The object name. Y
Example:
domain_attach_object domain=d1 type=host name=MyHost
Output:
Chapter 15. Access control commands 365
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DOMAIN_DOESNT_EXIST
Domain does not exist.v TARGET_BAD_NAME
Target name does not existv HOST_BAD_NAME
Host name does not existv CLUSTER_BAD_NAME
Cluster name does not existv USER_GROUP_NAME_DOES_NOT_EXIST
User group name does not existv DEST_NAME_DOES_NOT_EXIST
Destination name does not existv DESTGROUP_NAME_DOES_NOT_EXIST
Destination group name does not existv EVENT_RULE_NAME_DOES_NOT_EXIST
Event rule name does not existv USER_IS_NOT_IN_DESTINATION_DOMAINS
User must by included in the destination domains.v DESTINATION_IS_NOT_IN_DESTGROUP_DOMAINS
Destinations must by included in the destination group domains.v DESTINATION_IS_NOT_IN_RULE_DOMAINS
Destination must by included in the rule domains.v DESTGROUP_IS_NOT_IN_RULE_DOMAINS
Destination groups must by included in the rule domains.v ESCALATION_RULE_NOT_IN_RULE_DOMAINS
Escalation rule must belong to rule domains.v CLUSTER_HAS_HOSTS_UNASSOCIATED_WITH_DOMAIN
Cannot attach a cluster with hosts that aren't in the specified domain.v RESOURCE_ALREADY_ASSOCIATED_WITH_THIS_DOMAIN
The resource is already associated with this domain.
366 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Disassociating object from a domainUse the domain_detach_object command to disassociate object from a domain.
domain_detach_object domain=DomainName type=ObjectType name=ObjectName
Parameters
Name Type Description Mandatory
domain Object name The name of thedomain.
Y
type Enumeration The object type todisassociate from thedomain. It can be:target, host, cluster,schedule, usergroup,dest, destgroup, or rule.
Y
name Object name The object name. Y
The object is disassociated from mapped or bound objects that belong to thedomain.
Example:
domain_detach_object domain=d1 type=host name=MyHost
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DOMAIN_DOESNT_EXIST
Domain does not exist.v RESOURCE_NOT_ASSOCIATED_WITH_THIS_DOMAIN
The resource is not associated with this domain.v DOMAIN_VOLUME_MAPPED_TO_HOST
Host has a volume in the domain mapped to it.v DOMAIN_VOLUME_MAPPED_TO_CLUSTER
Cluster has a volume in the domain mapped to it.v REMOVAL_WOULD_CREATE_UNRESOLVABLE_REFERENCE_BETWEEN_HOST_AND_USERGROUP
Chapter 15. Access control commands 367
The operation would result in a host referring to user group that's not in itsdomain. First remove the reference explicitly.
v REMOVAL_WOULD_CREATE_UNRESOLVABLE_REFERENCE_BETWEEN_CLUSTER_AND_USERGROUP
The operation would result in a cluster referring to user group that's not in itsdomain. First remove the reference explicitly.
v HOST_PART_OF_ATTACHED_CLUSTER
The host is a part of a cluster and cannot be handled individually.v DOMAIN_TARGET_IN_USE
Attempt to remove a target that is used in a mirror or DM relation with avolume in the domain.
v DOMAIN_VOLUME_BOUND_TO_HOST
Host has a volume in the domain bound to it via an ALU.v TARGET_BAD_NAME
Target name does not existv HOST_BAD_NAME
Host name does not existv CLUSTER_BAD_NAME
Cluster name does not existv USER_GROUP_NAME_DOES_NOT_EXIST
User group name does not existv DEST_NAME_DOES_NOT_EXIST
Destination name does not existv DESTGROUP_NAME_DOES_NOT_EXIST
Destination group name does not existv EVENT_RULE_NAME_DOES_NOT_EXIST
Event rule name does not existv DETACH_WOULD_MAKE_OBJECT_INACCESSIBLE
Detaching the object would leave it unassociated with any domain, henceinaccessible.Troubleshooting: If it's no longer needed, please delete it.
v USER_IS_NOT_IN_DESTINATION_DOMAINS
User must by included in the destination domains.v DESTINATION_IS_NOT_IN_RULE_DOMAINS
Destination must by included in the rule domains.v DESTINATION_IS_NOT_IN_DESTGROUP_DOMAINS
Destinations must by included in the destination group domains.v REMOVAL_WOULD_CREATE_UNRESOLVABLE_REFERENCE_BETWEEN_USER_AND_USERGROUP
The operation would result in a user referring to user group that's not in itsdomain. First remove the reference explicitly.
v DESTGROUP_IS_NOT_IN_RULE_DOMAINS
Destination groups must by included in the rule domains.v ESCALATION_RULE_NOT_IN_RULE_DOMAINS
Escalation rule must belong to rule domains.v DOMAIN_PROXY_VOLUME_MAPPED_TO_HOST
Host has a proxy volume in the domain mapped to it.
368 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v DOMAIN_PROXY_VOLUME_MAPPED_TO_CLUSTER
Cluster has a proxy volume in the domain mapped to it.
Associating users to a domainUse the domain_add_user command to associate a user to a domain.
domain_add_user domain=DomainName user=UserName [ exclusive=<yes|no> ]
Parameters
Name Type Description Mandatory Default
domain Object name The name of thedomain.
Y N/A
user Object name The name of theuser.
Y N/A
exclusive Boolean Set to Yes torestrict the user todomain's objects.
N yes
Example:
domain_add_user domain=d1 user=d1_admin
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv LDAP_AUTHENTICATION_IS_ACTIVE
Command is not available while LDAP authentication is activev DOMAIN_DOESNT_EXIST
Domain does not exist.v USER_NAME_DOES_NOT_EXIST
User name does not existv NON_EXCLUSIVE_USER_NOT_SECURITY_ADMIN
Only a security admin can add a user to a domain non-exclusively.v USER_CANNOT_BE_ADDED_TO_A_DOMAIN
Specified user cannot be associated with a domain.
Chapter 15. Access control commands 369
v PREDEFINED_USER_CANNOT_BE_RESTRICTED_TO_DOMAIN
Specified user cannot be exclusively associated with a domain.v DOMAIN_USER_EXIST
This user is already added to the domain.v USER_IS_REFERRED_TO_BY_DEST
User is referred to by an event destination and therefore cannot be deletedv OPERATION_NOT_ALLOWED_ON_DESIGNATED_MSM_USER
Designtated MSM user cannot be renamed and cannot be exclusively associatedwith a domain.
v SIA_MUST_BE_ASSOCIATED_WITH_A_DOMAIN
The Storage Integration Administrator must be associated with a domain.v REMOVAL_WOULD_CREATE_UNRESOLVABLE_REFERENCE_BETWEEN_USER_AND_USERGROUP
The operation would result in a user referring to user group that's not in itsdomain. First remove the reference explicitly.
Removing a user from a domainUse the domain_remove_user command to remove a user from a domain.
domain_remove_user domain=DomainName user=UserName
Parameters
Name Type Description Mandatory
domain Object name The name of thedomain.
Y
user Object name The name of the user. Y
Example:
domain_remove_user domain=d1 user=d1_admin
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Warningsv USER_WILL_BE_DELETED
370 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User is only associated with this domain. This will delete the user from thesystem. Are you sure?
Return codesv USER_NAME_DOES_NOT_EXIST
User name does not existv DOMAIN_DOESNT_HAVE_THE_USER
User is not attached to this domain.v DOMAIN_DOESNT_EXIST
Domain does not exist.v LDAP_AUTHENTICATION_IS_ACTIVE
Command is not available while LDAP authentication is activev REMOVAL_WOULD_CREATE_UNRESOLVABLE_REFERENCE_BETWEEN_USER_AND_USERGROUP
The operation would result in a user referring to user group that's not in itsdomain. First remove the reference explicitly.
v DOMAIN_USER_CANNOT_REMOVE_HIMSELF
Users cannot remove themselves from a domain.v USER_IS_REFERRED_TO_BY_DEST
User is referred to by an event destination and therefore cannot be deleted
Adding a pool to a domainUse the domain_add_pool command to add a pool to a domain.
domain_add_pool domain=DomainName pool=PoolName [ adjust=<yes|no> ]
Parameters
Name Type Description Mandatory Default
domain Object name The name of thedomain.
Y N/A
pool Object name The pool name. Y N/A
adjust Boolean Adjust domainresources. If'adjust' is set totrue, the resourcesof the globaldomain anddestination domainare adjusted toaccommodate thepool being moved.
N no
Example:
domain_add_pool domain=d1 pool=p1
Output:
Command executed successfully.
Chapter 15. Access control commands 371
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv POOL_DOES_NOT_EXIST
Storage Pool does not existv NO_FREE_CAPACITY_IN_DOMAIN
There is not enough free space in the domain.v DOMAIN_DOESNT_EXIST
Domain does not exist.v POOL_ALREADY_ASSOCIATED_WITH_A_DOMAIN
The pool is already associated with a domain.v DOMAIN_MAX_POOLS_REACHED
The maximum number of domain pools was reached.v DOMAIN_MAX_DMS_REACHED
The domain exceeds the maximum allowed number of data migrations.v DOMAIN_MAX_CONS_GROUPS_REACHED
The domain exceeds the maximum allowed number of consistency groups.v DOMAIN_MAX_VOLUMES_REACHED
The domain exceeds the maximum allowed number of volumes.v DOMAIN_USED_TARGET_NOT_IN_DESTINATION
A target that is used by mirror in the pool is not associated with the targetdomain.
v MAPPED_HOSTS_NOT_IN_DESTINATION
A host that is mapped to a volume in the pool is not associated with the targetdomain.
v MAPPED_CLUSTERS_NOT_IN_DESTINATION
A cluster that is mapped to a volume in the pool is not associated with thetarget domain.
v NO_SPACE
The system does not have enough free space for the requested Storage Pool size
Removing a pool from a domainUse the domain_remove_pool command to remove a pool from a domain.
domain_remove_pool domain=DomainName pool=PoolName [ adjust=<yes|no> ]
372 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Type Description Mandatory Default
domain Object name The name of thedomain.
Y N/A
pool Object name The pool name. Y N/A
adjust Boolean Adjust domainresources. If set toTrue, the resourcesof the globaldomain anddestination domainare adjusted toaccommodate thepool being moved.
N no
Example:
domain_remove_pool domain=d1 pool=p1
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DOMAIN_DOESNT_EXIST
Domain does not exist.v POOL_DOES_NOT_EXIST
Storage Pool does not existv DOMAIN_DOESNT_HAVE_THE_POOL
Pool is not attached to this domain.v MAX_POOLS_REACHED
Maximum number of Storage Pools already definedv MAX_CONS_GROUPS_REACHED
Maximum number of Consistency Groups already defined.v MAX_VOLUMES_REACHED
Maximum number of volumes already definedv MAX_DMS_REACHED
Maximum number of remote volumes (mirror/migration) is already definedTroubleshooting: Delete unnecessary Data Migration objects
Chapter 15. Access control commands 373
v NO_SPACE
The system does not have enough free space for the requested Storage Pool size
Moving a pool from one domain to anotherUse the domain_move_pool command to move a pool from one domain to another.
domain_move_pool pool=PoolName src_domain=DomainName dst_domain=DomainName[ adjust=<yes|no> ]
Parameters
Name Type Description Mandatory Default
pool Object name The name of thepool to be moved.
Y N/A
src_domain Object name The source domainname.
Y N/A
dst_domain Object name The destinationdomain name.
Y N/A
adjust Boolean Adjust domainresources. If set toYes, the resourcesof the domains areadjusted toaccommodate thepool being moved.
N no
Example:
domain_move_pool pool=p1 src_domain=d1 dst_domain=d2
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv SOURCE_DOMAIN_DOES_NOT_EXIST
Source domain does not exist.v DESTINATION_DOMAIN_DOES_NOT_EXIST
Destination domain does not exist.v POOL_DOES_NOT_EXIST
374 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Storage Pool does not existv POOL_NOT_ASSOCIATED_WITH_SOURCE_DOMAIN
The pool is not associated with the source domain.v DOMAIN_MAX_POOLS_REACHED
The maximum number of domain pools was reached.v MAPPED_HOSTS_NOT_IN_DESTINATION
A host that is mapped to a volume in the pool is not associated with the targetdomain.
v MAPPED_CLUSTERS_NOT_IN_DESTINATION
A cluster that is mapped to a volume in the pool is not associated with thetarget domain.
v NO_FREE_CAPACITY_IN_DOMAIN
There is not enough free space in the domain.v DOMAIN_USED_TARGET_NOT_IN_DESTINATION
A target that is used by mirror in the pool is not associated with the targetdomain.
v DOMAIN_MAX_DMS_REACHED
The domain exceeds the maximum allowed number of data migrations.v DOMAIN_MAX_CONS_GROUPS_REACHED
The domain exceeds the maximum allowed number of consistency groups.v DOMAIN_MAX_VOLUMES_REACHED
The domain exceeds the maximum allowed number of volumes.v OPERATION_DENIED_OBJECT_MANAGED
This is a managed object. Only the managing software and xiv_maintenance /xiv_development may perform this operation on this object.
v SOURCE_AND_DESTINATION_DOMAINS_MUST_BE_DIFFERENT
Source and destination domains must be different.v NO_SPACE
The system does not have enough free space for the requested Storage Pool size
Setting the domain attributeUse the domain_manage command to set or clear the Managed attribute of adomain.
domain_manage domain=DomainName managed=<yes|no>
Parameters
Name Type Description Mandatory
domain Object name The domain name. Y
managed Boolean The Managed attribute.If set to Yes, the domainwill be marked asmanaged.
Y
Example:
Chapter 15. Access control commands 375
domain_mmanage domain=d1 managed=yes
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv DOMAIN_DOESNT_EXIST
Domain does not exist.v DOMAIN_HAS_POOL
One or more pools are still in the domain.v DOMAIN_HAS_DEST
One or more destinations are associated with this domain.v DOMAIN_HAS_DESTGROUP
One or more destination groups are associated with this domain.v DOMAIN_HAS_USER_GROUP
One or more user groups are associated with this domain.
Setting domain-related policiesUse the domain_policy_set command to set domain-related policies.
domain_policy_set name=Name value=ParamValue
Parameters
Name Type Description Mandatory
name String Name of the parameterto set.
Y
value String Value of the parameter. Y
This command is used for setting domain related policies.v name=access defines whether non-domain-specific users can access
domain-specific resources (value=open) or not (value=closed).v name=host_management defines whether domain administrators can create their
own hosts (value=extended), or are restricted to hosts assigned to their domainsby NDSO administrators (value=basic).
376 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Example:
domain_policy_set name=access value=closed
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv UNRECOGNIZED_CONFIG_PARAMETER
Unrecognized configuration parameter: 'name'.Troubleshooting: Use a valid configuration parameter as an input.
Displaying domain-related policiesUse the domain_policy_get command to display domain-related policies.
domain_policy_get [ name=Name ]
Parameters
Name Type Description Mandatory Default
name String Name of theparameter to get.
N All parameters.
v name=access defines whether non-domain-specific users can accessdomain-specific resources (value=open) or not (value=closed).
v name=host_management defines whether domain administrators can create theirown hosts (value=extended), or are restricted to hosts assigned to their domainsby NDSO administrators (value=basic).
Field ID Field output Default position
name Name 1
value Value 2
Example:
domain_policy_get name=access
Output:
Chapter 15. Access control commands 377
Name Value-------- -------access OPEN
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Return codesv UNRECOGNIZED_CONFIG_PARAMETER
Unrecognized configuration parameter: 'name'.Troubleshooting: Use a valid configuration parameter as an input.
v CONF_SERVER_UNREACHABLE
Configuration server unreachable
Specifying a user associated with IBM Hyper-Scale ManagerUse the designate_msm_user_set command to specify the name of the user that isassociated with the IBM Hyper-Scale Manager.
designate_msm_user_set name=UserName
Parameters
Name Type Description Mandatory
name Object name The designated user. Y
This command specifies which XIV user is defined in the IBM Hyper-ScaleManager Server in the activation step. This can be either a local or LDAP user,depending on whether LDAP authentication is used.
Example:
designate_msm_user_set name=xiv_msms
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
378 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv USER_NAME_DOES_NOT_EXIST
User name does not existv USER_IS_ONLY_DOMAIN_ADMIN
User is associated with one or more domains, and cannot view the entire system.
Retrieving the user associated with the IBM Hyper-Scale ManagerUse the designate_msm_user_get command to retrieve the name of the userassociated with the IBM Hyper-Scale Manager.
designate_msm_user_get
Example:
designate_msm_user_get
Output:
xiv_msms
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Return codesv NO_DESIGNATED_MSM_USER
There is no designated IBM Hyper-Scale user.
Setting the application administrator's scope of commandsUse the appadmin_capabilities_set command to define whether an ApplicationAdministrator is authorized to perform the basic or advanced set of commands.
appadmin_capabilities_set value=<basic|advanced>
Chapter 15. Access control commands 379
Parameters
Name Type Description Mandatory
value Enumeration The set of commandsthat an ApplicationAdministrator isauthorized to perform.
Y
Example:
appadmin_capabilities_set value=basic
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Getting the application administrator's scope of commandsUse the appadmin_capabilities_get command to display the state of theApplication Administrator's capabilities.
appadmin_capabilities_get
Example:
appadmin_capabilities_get
Output:
BASIC
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
380 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 15. Access control commands 381
382 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 16. Fibre channel and iSCSI configuration and statuscommands
This section describes the command-line interface (CLI) for fibre channel portconfiguration.
Discovering FC hostsUse the fc_connectivity_list command to discover FC hosts and targets on theFC network.
fc_connectivity_list [ role=<dual|initiator|target> ] [ wwpn=WWPN ][ module=ModuleNumber | fc_port=ComponentId ]
Parameters
Name Type Description Mandatory Default
role Enumeration Specifies whetherto discoverinitiators ortargets.
N List all - targetsand/or initiators.
wwpn N/A Limits the outputonly to thisspecific address.
N All addresses
module N/A Limits the outputto the enabledconnectivity to thismodule.
N All modules
fc_port N/A Limits the outputto this specific XIVport.
N All ports
This command lists FC hosts on the network.
type=initiator detects initiators on the network. When type=initiator, thenon-logged-in option can only be used to debug hosts that are on the network, butdid not log in.
type=target detects targets. When type=target, the non-logged-in option can onlybe used to debug targets that rejected the storage system login. This commandreturns an error for an attempt to list targets from a target-only port, or to listinitiators from an initiator-only port. Each output line contains the followinginformation:v Component ID (of the module)v Storage system port number (within the module)v WWPNv Port ID (can be correlated with the switch database)v Role: Initiator, Target, Dualv Initiator/target (is the same for all lines of the same command)v Login status (Yes/No)
© Copyright IBM Corp. 2016 383
Field ID Field output Default position
component_id Component ID 1
wwpn WWPN 2
port_id Port ID 3
role Role 4
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Changing FC port configurationUse the fc_port_config command to configure FC ports.
fc_port_config fc_port=ComponentId [ enabled=<yes|no> ][ role=<target|initiator> ] [ rate=<2|4|8|16|auto> ]
Parameters
Name Type Description Mandatory Default
fc_port N/A Port identifier. Y N/A
enabled Boolean Allows you toenable or disablethe port.
N yes
role Enumeration Port role: target,initiator or both.
N Leaves the roleunchanged.
rate Enumeration Line rate or autofor auto-negotiatedrate.
N Leaves the rateunchanged.
Example:
fc_port_config fc_port=1:FC_Port:1:1 enabled=yes role=Target rate=auto
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
384 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv COMPONENT_IS_NOT_AN_FC_PORT
Component must specify an FC portv FC_PORT_DOES_NOT_EXIST
Specified FC port does not exist
Listing FC portsUse the fc_port_list command to list the status and configuration of the system'sFC ports.
fc_port_list [ module=ModuleNumber | fcport=ComponentId ]
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All ports in all modules.
fcport Lists only a specificport.
N All ports in all modules.
This command lists all or some FC ports on the system. When no parameters arespecified, all ports are listed. If a module is specified without a port, all ports onthat module are listed. If a port is specified, a single port is listed.
The following information is provided for each port:v Component ID of the module Port number (internal to module) 1-Nv WWPNv Port IDv Role (Initiator, Target, Dual)v User-enabled (Yes/No)v Maximum support rate: 2GB, 4GB, 8GB; constant - function of the HBA's
capabilityv Configured rate: 2GB, 4GB, 8GB, auto-negotiation; cannot be greater than the
maximum supported ratev Current active rate: 2GB, 4GB, 8GB; equal to the configured rate, unless the
configured rate is auto-negotiationv Port state: Online, Offline, Loopback, Link Down (physical connection is on, but
no logical connection exists)v Error countsv Link type: Fabric Direct Attach, Private Loop, Point-to-Point, Public Loop,
Unknown
Example:
Chapter 16. Fibre channel and iSCSI configuration and status commands 385
fc_port_list
Output:
Component ID Status Currently Functioning WWPN Port ID Role---------------- -------- ----------------------- ------------------ ---------- --------1:FC_Port:12:1 OK yes 5001738035C601C0 FFFFFFFF Target1:FC_Port:12:2 OK yes 5001738035C601C1 FFFFFFFF Target1:FC_Port:12:3 OK yes 5001738035C601C2 FFFFFFFF Target1:FC_Port:12:4 OK yes 5001738035C601C3 00EF009A Target1:FC_Port:13:1 OK yes 5001738035C601D0 FFFFFFFF Target1:FC_Port:13:2 OK yes 5001738035C601D1 FFFFFFFF Target1:FC_Port:13:3 OK yes 5001738035C601D2 FFFFFFFF Target1:FC_Port:13:4 OK yes 5001738035C601D3 FFFFFFFF Target1:FC_Port:8:1 OK yes 5001738035C60180 FFFFFFFF Target1:FC_Port:8:2 OK yes 5001738035C60181 FFFFFFFF Target1:FC_Port:8:3 OK yes 5001738035C60182 FFFFFFFF Target1:FC_Port:8:4 OK yes 5001738035C60183 00163AC0 Target
Cont.:
User Enabled Current Rate (GBaud) Port State Link Type-------------- ---------------------- -------------- ----------------------yes Auto Link Problem Noneyes Auto Link Problem Noneyes Auto Link Problem Noneyes 8 Online Fabric Direct Attachyes Auto Link Problem Noneyes Auto Link Problem Noneyes Auto Link Problem Noneyes Auto Link Problem Noneyes Auto Link Problem Noneyes Auto Link Problem Noneyes Auto Link Problem Noneyes 16 Online Fabric Direct Attach
Cont.:
Error Count Active Firmware------------- -----------------0 8.3.400 8.3.400 8.3.400 8:3:400 8.3.400 8.3.400 8.3.400 8.3.400 8.3.400 8.3.400 8.3.400 8:3:40
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
port_num Port Number N/A
wwpn WWPN 4
port_id Port ID 5
role Role 6
user_enabled User Enabled 7
max_supported_rate Maximum Supported Rate(GBaud)
N/A
386 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
configured_rate Configured Rate (GBaud) N/A
current_rate Current Rate (GBaud) 8
port_state Port State 9
link_type Link Type 10
error_count Error Count 11
active_firmware Active Firmware 12
credit Credit N/A
hba_vendor HBA Vendor N/A
is_enabled Enabled N/A
module Module N/A
serial Serial N/A
temperature Temperature N/A
part_number Part Number N/A
original_serial Original Serial N/A
model Model N/A
original_model Original Model N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing connectivity to hostsUse the host_connectivity_list command to list FC and iSCSI-level connectivityto a pre-defined host.
host_connectivity_list [ host=HostName | fc_host_port=WWPN ][ module=ModuleNumber | fcport=ComponentId ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
host Object name Limits viewing tothe ports of aspecific host.
N All hosts.
fc_host_port N/A Limits viewing tothis specific port.
N All ports
module N/A Limits output onlyto the enabledconnectivity to thismodule.
N All modules
Chapter 16. Fibre channel and iSCSI configuration and status commands 387
Name Type Description Mandatory Default
fcport N/A Limits output to aspecific storagesystem's port.
N All ports
domain Object name The domain name. N All Domains
This command shows the connectivity status between a storage system port and adefined host. The output can be limited to a specific port, module or storagesystem port. Hosts can attach to the FC and iSCSI either directly (point-to-point),via an FC fabric or via a Gigabit Ethernet switch. Connectivity refers to bothphysical connectivity and SCSI login. Each output line contains the followinginformation:v Host (name)v Host port (WWPN)v Module ID, preceded by the rack IDv Port number (within the module)
Example:
host_connectivity_list host=demo_host_fc0 fc_host_port=1:FC_Port:5:1
Output:
Host Host Port Module Local FC port Local iSCSI port Type-------------- ------------------ ------------ --------------- ------------------ ------demo_host_fc0 100000062B151A98 1:Module:5 1:FC_Port:5:1 FC
Field ID Field output Default position
host Host 1
host_port Host Port 2
module Module 3
local_fc_port Local FC port 4
local_iscsi_port Local iSCSI port 5
type Type 6
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
388 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Displaying the InfiniBand connectivity statusUse the pod_ib_connectivity_list command to display the pod's InfiniBand linkconnectivity status.
pod_ib_connectivity_list [ module=ComponentId ]
Parameters
Name Description Mandatory Default
module Defines whether todisplay the InfiniBandlink connectivity statusfor a specific module orfor all modules.
N All modules
Example:
pod_ib_connectivity_list
Output:
Module module-1 module-2 module-3 Flash-Canister-1 Flash-Canister-2---------- ----------- ----------- ----------- ------------------ ------------------module-1 connected disconnected connected connected connectedmodule-2 disconnected connected connected connected connectedmodule-3 connected connected connected connected connected
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Chapter 16. Fibre channel and iSCSI configuration and status commands 389
390 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 17. Flash enclosure and flash canister maintenancecommands
This section describes the command-line interface (CLI) for maintaining flashcanisters and enclosures.
Listing Flash enclosure statusUse the flash_enclosure_list command to list special flash enclosure statuses.
flash_enclosure_list [ flash_enclosure=ComponentId ]
Parameters
Name Description Mandatory Default
flash_enclosure Flash enclosure forwhich special statusesare to be listed.
N All Flash Enclosures.
This command lists the status of each Flash enclosure, including:v Component generic statusv Online canisterv Total number of canisters
Example:
flash_enclosure_list
Output:
Component ID Status Currently Functioning Control Path Status--------------------- -------- ----------------------- ---------------------1:Flash_Enclosure:4 OK yes OK
Cont.:
Cluster IP Redundancy State FW level Has Spare--------------- ------------------ --------------- -----------14.10.204.239 online 1.4.1.0-195.0 yes
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
control_path_status Control Path Status 4
cluster_ip Cluster IP 5
redundancy_state Redundancy State 6
fw_level FW level 7
has_spare Has Spare 8
array_status Array Status N/A
© Copyright IBM Corp. 2016 391
Field ID Field output Default position
fru_part_number FRU Part Number N/A
fru_identity FRU Identity N/A
temperature_state Temperature State N/A
required_service Requires Service N/A
service_reason Service Reason N/A
enabled Enabled N/A
cluster_id Cluster ID N/A
encrypted Encrypted N/A
key_needed Key Needed N/A
base_guid Base GUID N/A
charging Charging N/A
flash_status Flash Status N/A
fw_upgrade_status FW Upgrade Status N/A
fw_upgrade_progress FW Upgrade Progress N/A
fw_upgrade_committed FW Upgrade Committed N/A
target_fw_version Target FW. Version N/A
fw_file_name FW File Name N/A
utility_file_name Utility File Name N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Listing Flash enclosure statusesUse the flash_enclosure_list_all command to list all Flash enclosure statuses.
flash_enclosure_list_all [ flash_enclosure=ComponentId ]
Parameters
Name Description Mandatory Default
flash_enclosure Flash enclosure forwhich special statusesare to be listed.
N All Flash Enclosures.
The high-performance Flash enclosure is a Redundant Array of Independent Disks(RAID) storage enclosure, that can support flash cards. This command lists allstatuses of a Flash enclosure, including:v Component generic statusv Online canister
392 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v Total number of canisters
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
control_path_status Control Path Status 4
cluster_ip Cluster IP 5
redundancy_state Redundancy State 6
fw_level FW level 7
has_spare Has Spare 8
array_status Array Status N/A
fru_part_number FRU Part Number N/A
fru_identity FRU Identity N/A
temperature_state Temperature State N/A
required_service Requires Service N/A
service_reason Service Reason N/A
enabled Enabled N/A
cluster_id Cluster ID N/A
encrypted Encrypted N/A
key_needed Key Needed N/A
base_guid Base GUID N/A
charging Charging N/A
flash_status Flash Status N/A
fw_upgrade_status FW Upgrade Status N/A
fw_upgrade_progress FW Upgrade Progress N/A
fw_upgrade_committed FW Upgrade Committed N/A
target_fw_version Target FW. Version N/A
fw_file_name FW File Name N/A
utility_file_name Utility File Name N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Listing a Flash canister statusUse the flash_canister_list command to list special Flash canister statuses.
flash_canister_list [ canister=ComponentId | flash_enclosure=ComponentId ]
Chapter 17. Flash enclosure and flash canister maintenance commands 393
Parameters
Name Description Mandatory Default
canister Flash Canister for whichspecial statuses are tobe listed.
N All Flash canisters.
flash_enclosure Flash Enclosure forwhich special statusesare to be listed.
N All Flash enclosures.
This command lists the statuses of the Flash canisters, including:v Component generic statusv Canister IDv Node IDv Node name
Example:
flash_canister_list
Output:
Component ID Status Currently Functioning Service IP Raid Status---------------------- -------- ----------------------- --------------- -------------1:Flash_Canister:4:1 OK yes 14.10.204.205 OK1:Flash_Canister:4:2 OK yes 14.10.204.238 OK
Cont.:
Control Path Status Serial Connected MgmtNode--------------------- ------------------ ----------OK 1:Module:12 noOK 1:Module:13 yes
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
service_ip Service IP 4
raid_status Raid Status 5
control_path_status Control Path Status 6
serial_connected Serial Connected 7
active MgmtNode 8
fru_part_number FRU Part Number N/A
fru_identity FRU Identity N/A
temperature_state Temperature State N/A
fw_level FW Level N/A
mac_addresses MAC Addresses N/A
required_service Requires Service N/A
service_reason Service Reason N/A
canister_degraded Canister Degraded N/A
canister_missing Canister Missing N/A
status_led Status Led N/A
394 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
check_log_led Check Log Led N/A
identify_led Identify Led N/A
controller_fault_led Controller Fault Led N/A
fault_led Fault Led N/A
dump_led Dump Led N/A
canister_mode Canister Mode N/A
service_mode Service Mode N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Listing a Flash card statusUse the flash_card_list command to list special Flash card statuses.
flash_card_list [ flash_card=ComponentId | flash_enclosure=ComponentId ]
Parameters
Name Description Mandatory Default
flash_card Flash card for whichspecial statuses are tobe listed.
N All Flash cards.
flash_enclosure Flash enclosure forwhich special statusesare to be listed.
N All Flash enclosures.
This command lists the statuses of the TMS, including:v Component generic statusv Slot IDv Capacityv Health Statev Flash type
Example:
flash_card_list flash_card=1:Flash_Card:4:5
Output:
Chapter 17. Flash enclosure and flash canister maintenance commands 395
Component ID Status Currently Functioning Slot ID Capacity(GB) Health State------------------ -------- ----------------------- --------- -------------- --------------1:Flash_Card:4:5 OK yes 5 5717 good
Cont.:
Usage Missing-------- ---------member no
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
slot_id Slot ID 4
capacity Capacity(GB) 5
health_state Health State 6
drive_use Usage 7
missing Missing 8
fru_part_number FRU Part Number N/A
fru_identity FRU Identity N/A
temperature_state Temperature State N/A
fw_level FW Level N/A
required_service Requires Service N/A
service_reason Service Reason N/A
flash_type Type N/A
fault_led Fault LED N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Retrieving the list of Flash fansUse the flash_fan_list command to retrieve the list of Flash fans.
flash_fan_list [ flash_fan=ComponentId | flash_enclosure=ComponentId ]
Parameters
Name Description Mandatory Default
flash_fan Flash fan component ID N all
flash_enclosure Flash enclosurecomponent ID
N all
396 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Example:
flash_fan_list
Output:
Component ID Status----------------- --------1:Flash_Fan:2:1 OK1:Flash_Fan:2:2 OK1:Flash_Fan:2:3 OK1:Flash_Fan:2:4 OK
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
fru_part_number FRU Part Number N/A
fru_identity FRU Identity N/A
temperature_state Temperature State N/A
fw_level FW Level N/A
required_service Requires Service N/A
service_reason Service Reason N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Retrieving the list of Flash IB adaptersUse the flash_ib_adapter_list command to retrieve the list of Flash IB adapters.
flash_ib_adapter_list [ flash_ib_adapter=ComponentId | flash_enclosure=ComponentId ]
Parameters
Name Description Mandatory Default
flash_ib_adapter Flash IB adaptercomponent ID
N all
flash_enclosure Flash Enclosurecomponent ID
N all
Example:
Chapter 17. Flash enclosure and flash canister maintenance commands 397
flash_ib_adapter_list
Output:
Component ID Status------------------------ --------1:Flash_IB_Adapter:2:1 OK1:Flash_IB_Adapter:2:2 OK1:Flash_IB_Adapter:2:3 OK1:Flash_IB_Adapter:2:4 OK
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
canister_id Canister_name 4
fru_part_number FRU Part Number N/A
fru_identity FRU Identity N/A
temperature_state Temperature State N/A
required_service Requires Service N/A
service_reason Service Reason N/A
fw_level FW Level N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Retrieving the Flash control connectivity listUse the flash_control_connectivity_list command to retrieve the Flash controlconnectivity list.
flash_control_connectivity_list [ canister=ComponentId | flash_enclosure=ComponentId ]
Parameters
Name Description Mandatory Default
canister Canister component ID N all
flash_enclosure Flash enclosureComponent ID
N all
The connectivity for Flash control is provided via Ethernet.
Example:
398 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
flash_control_connectivity_list
Output:
Component ID Path1 IPAddr1 P1Status Path2 IPAddr2---------------------- ------------ ------------- ---------- ------------ --------------1:Flash_Canister:1:1 1:Module:1 14.10.204.1 yes 1:Module:2 14.10.204.331:Flash_Canister:1:2 1:Module:1 14.10.204.2 yes 1:Module:2 14.10.204.34
P2Status Path3 IPAddr3 P3Status Path4 IPAddr4 P4Status---------- ------------ -------------- ---------- ------------ --------------- ----------yes 1:Module:3 14.10.204.65 yes 1:Module:4 14.10.204.97 yesyes 1:Module:3 14.10.204.66 yes 1:Module:4 14.10.204.98 yes
Field ID Field output Default position
component_id Component ID 1
virtual_ips.0.path Path1 2
virtual_ips.0.pathAddr PathAddr1 3
virtual_ips.0.status P1Status 4
virtual_ips.0.state P1State N/A
virtual_ips.1.path Path2 5
virtual_ips.1.pathAddr PathAddr2 6
virtual_ips.1.status P2Status 7
virtual_ips.1.state P2State N/A
virtual_ips.2.path Path3 8
virtual_ips.2.pathAddr PathAddr3 9
virtual_ips.2.status P3Status 10
virtual_ips.2.state P3State N/A
virtual_ips.3.path Path4 11
virtual_ips.3.pathAddr PathAddr4 12
virtual_ips.3.status P4Status 13
virtual_ips.3.state P4State N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Retrieving the list of Flash PSUsUse the flash_psu_list command to retrieve the list of Flash PSUs.
flash_psu_list [ flash_psu=ComponentId | flash_enclosure=ComponentId ]
Chapter 17. Flash enclosure and flash canister maintenance commands 399
Parameters
Name Description Mandatory Default
flash_psu Flash PSU componentID
N all
flash_enclosure Flash Enclosurecomponent ID
N all
Example:
flash_psu_list
Output:
Component ID Status----------------- --------1:Flash_PSU:2:1 OK1:Flash_PSU:2:2 OK
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
input_failed Input Failed 4
output_failed Output Failed 5
fru_part_number FRU Part Number N/A
fru_identity FRU Identity N/A
temperature_state Temperature State N/A
fw_level FW Level N/A
required_service Requires Service N/A
service_reason Service Reason N/A
fan_failed Fan Failed N/A
fault_led Fault LED N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Retrieving the list of Flash PIBsUse the flash_pib_list command to retrieve the list of Flash PIBs.
flash_pib_list [ flash_pib=ComponentId ]
400 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Description Mandatory Default
flash_pib Flash PIB component ID N all
Example:
flash_pib_list
Output:
Component ID Status----------------- --------1:Flash_PIB:2:1 OK
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
fru_part_number FRU Part Number N/A
fru_identity FRU Identity N/A
temperature_state Temperature State N/A
fw_level FW Level N/A
required_service Requires Service N/A
service_reason Service Reason N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Retrieving the list of Flash LED cardsUse the flash_led_card_list command to retrieve the list of Flash LED cards.
flash_led_card_list [ flash_led_card=ComponentId ]
Parameters
Name Description Mandatory Default
flash_led_card Flash LED cardcomponent ID
N all
Example:
Chapter 17. Flash enclosure and flash canister maintenance commands 401
flash_led_card_list
Output:
Component ID Status----------------- --------1:Flash_LED_Card:2:1 OK
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
fru_part_number FRU Part Number N/A
fru_identity FRU Identity N/A
temperature_state Temperature State N/A
fw_level FW Level N/A
required_service Requires Service N/A
service_reason Service Reason N/A
power_led Power Led N/A
fault_led Fault Led N/A
check_log_led Check Log Led N/A
identify_led Identify Led N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing Flash BBU componentsUse the flash_bbu_list command to list Flash BBU components.
flash_bbu_list [ flash_bbu=ComponentId | flash_enclosure=ComponentId ]
Parameters
Name Description Mandatory Default
flash_bbu Flash BBU componentID
N all
flash_enclosure Flash Enclosurecomponent ID
N all
Example:
402 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
flash_bbu_list
Output:
Component ID Status Charging Status Percent Charged Recondition Needed----------------- -------- ----------------- ----------------- --------------------1:Flash_BBU:2:1 OK idle 94 no1:Flash_BBU:2:2 OK idle 89 no
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
percent_charged Percent Charged 4
recondition_needed Recondition Needed 5
charging_status Charging Status 6
last_recondition_time Last Recondition Time 7
temperature_state Temperature State N/A
fw_level FW Level N/A
required_service Requires Service N/A
service_reason Service Reason N/A
fru_part_number FRU Part Number N/A
fru_identity FRU Identity N/A
fault_led Fault LED N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Retrieving the serial number of a Flash enclosure 1SUse the flash_enclosure_1s_get command to retrieve the serial number of a Flashenclosure 1S.
flash_enclosure_1s_get flash_enclosure=ComponentId
Parameters
Name Description Mandatory
flash_enclosure Flash enclosure component ID Y
Example:
Chapter 17. Flash enclosure and flash canister maintenance commands 403
flash_enclosure_1s_get
Field ID Field output Default position
serial Serial 1
mtm Mtm N/A
Example:
flash_enclosure_1s_get
Output:
Serial
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
404 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 18. Hardware maintenance commands
This section describes the command-line interface (CLI) for maintaining hardwarecomponents.
Monitoring the rebuilding or redistribution processesUse the monitor_redist command to monitor the status of the rebuilding orredistribution process.
monitor_redist
This command outputs the current rebuild or redistribution process running on amodule. The command does not yield information about a Flash enclosure.
The command may inform you that no such process exists. If such a process exists,the following information is shown:v Type (adding new capacity, replacing failed component, phase-out, rebuild after
failure)v Initial capacity to copyv Time startedv Capacity remaining to copyv Time elapsedv Percent completedv Estimated time to completion
Field ID Field output Default position
type Type 1
partitions_total Initial Partitions 2
partitions_left Partitions Remaining 3
percent_done % Done 4
time_started Time Started 5
estimated_time_to_finish Estimated Time to Finish 6
time_elapsed Time Elapsed 7
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
© Copyright IBM Corp. 2016 405
Displaying the system's average power consumptionUse the system_average_power_consumption command to display the system'saverage power consumption.
system_average_power_consumption
Example:
system_average_power_consumption
Output:
TODO
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Displaying the system's average temperatureUse the system_average_temperature command to display the system's averagetemperature.
system_average_temperature
Example:
system_average_temperature
Output:
TODO
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
406 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Enabling XIV Support accessUse the xiv_support_enable command to enable XIV Support access for a specificperiod of time limiting access from the specific address.
xiv_support_enable [ start=TimeStamp ]< finish=TimeStamp | timeout=Timeout > from=IPaddress comment=Comment
Parameters
Name Type Description Mandatory Default
start N/A Start time forallowing XIVSupport access.
N Immediately.
finish N/A End time forallowing XIVSupport access.
N N/A
timeout N/A Timeout forallowing XIVSupport access ineither hh:mmformat, or anumber ofminutes. Thetimeout cannotexceed 23 hoursand 59 minutes.The wordunlimited denotesunexpired timeout.
N N/A
from N/A The source addressto which XIVSupport access islimited. It may beeither IPv4 or IPv6address, or any, ortechniciandenoting laptopport.
Y N/A
comment String Reason why XIVSupport access isenabled.
Y N/A
This command enables XIV Support access for a specific period of time limitingaccess from the specific address.
Example:
xiv_support_enable finish=2012-2-3.16:30 from=1.2.3.4 comment="Some reason"
Output:
Command executed successfully.
Chapter 18. Hardware maintenance commands 407
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_ENABLE_XIV_SUPPORT
Are you sure you want to enable xiv support?
Return codesv XIV_SUPPORT_WORK_INVALID_TIMEOUT
Timeout must be positive and define time creater then the current time.v XIV_SUPPORT_WORK_INVALID_FINISH
Finish must be greater then start and the current time.v XIV_SUPPORT_WORK_INVALID_FROM
From must be valid IPv4 or IPv6 address.
Disabling XIV Support accessUse the xiv_support_disable command to disable XIV Support access.
xiv_support_disable
Example:
xiv_support_disable
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
408 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Displaying the XIV Support windowUse the xiv_support_show command to display the XIV Support window.
xiv_support_show
The following information is listed:v From (IPv4 or IPv6 addresses, or "any address", or "technician port")v Start (timestamp or "unlimited")v Finish (timestamp or "unlimited")v Comment
Example:
xiv_support_show
Output:
From Start Finish Comment--------- --------------------- --------------------- -----------1.2.3.4 2012-03-28 12:55:21 2012-03-30 00:00:00 some work
Field ID Field output Default position
enabled Enabled 1
from From 2
start Start 3
finish Finish 4
comment Comment 5
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Listing system componentsUse the component_list command to list system components and their status.
component_list [ component=ComponentId ] [ filter=<ALL|FAILED|NOTOK> ]
Parameters
Name Type Description Mandatory Default
component N/A Lists only thiscomponent.
N All components.
Chapter 18. Hardware maintenance commands 409
Name Type Description Mandatory Default
filter Enumeration Filters the list toshow only failedor only non-OKcomponents.
N ALL
The list can be filtered to show only a specific component, all failed components orall components in a non-OK state.
For status and configuration of specific component types, refer to the _listcommands for specific components, such as: module_list or switch_list.
Example:
component_list
Output:
Component ID Status Currently Functioning--------------------------- -------------- -----------------------1:BBU:12:1 Failed no1:Boot_Media:12:1 OK yes1:Boot_Media:12:2 OK yes1:CNA:12:1 OK yes1:CNA:13:1 OK yes1:CNA:8:1 OK yes1:CPU:12:1 OK yes1:CPU:12:2 OK yes1:DIMM:12:1 OK yes1:DIMM:12:10 OK yes1:Data:12 OK yes1:Data:13 OK yes1:Data:8 OK yes1:Data_Reduction:12 OK yes1:Data_Reduction:13 OK yes1:Data_Reduction:8 OK yes1:FC_Port:12:1 OK yes1:FC_Port:12:2 OK yes1:Fan:12:1 OK yes1:Fan:12:2 OK yes1:Flash_BBU:4:1 OK yes1:Flash_BBU:4:2 OK yes1:Flash_Canister:4:1 OK yes1:Flash_Canister:4:2 OK yes1:Flash_Card:4:1 Failed no1:Flash_Enclosure:4 OK yes1:Flash_Fan:4:1 OK yes1:Flash_Fan:4:2 OK yes1:Flash_Fan:4:3 OK yes1:Flash_Fan:4:4 OK yes1:Flash_IB_Adapter:4:1 OK yes1:Flash_IB_Adapter:4:2 OK yes1:Flash_IB_Adapter:4:3 OK yes1:Flash_IB_Adapter:4:4 OK yes1:Flash_LED_Card:4:1 OK yes1:Flash_PIB:4:1 OK yes1:Flash_PSU:4:1 OK yes1:Flash_PSU:4:2 OK yes1:IB_FlashSystem_Port:4:1 OK yes1:IB_FlashSystem_Port:4:3 OK yes1:IB_FlashSystem_Port:4:5 OK yes1:IB_FlashSystem_Port:4:7 OK yes1:IB_Module_Port:12:1 OK yes
410 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Cont:
1:IB_Module_Port:12:2 Failed no1:IB_Module_Port:13:1 OK yes1:IB_Module_Port:13:2 Failed no1:IB_Module_Port:8:1 OK yes1:IB_Module_Port:8:2 Failed no1:IB_Switch:1 OK yes1:IB_Switch:2 OK yes1:IB_Switch_BBU:1:1 Initializing yes1:IB_Switch_BBU:1:2 Initializing yes1:IB_Switch_BBU:2:1 Initializing yes1:IB_Switch_BBU:2:2 Initializing yes1:IB_Switch_Fan:1:1 Initializing yes1:IB_Switch_PSU:1:1 Initializing yes1:IB_Switch_PSU:1:2 Initializing yes1:IB_Switch_PSU:2:1 Initializing yes1:IB_Switch_PSU:2:2 Initializing yes1:IB_Switch_Port:1:12 OK yes1:IB_Switch_Port:1:13 OK yes1:IB_Switch_Port:1:20 OK yes1:Interface:12 OK yes1:Interface:13 OK yes1:Interface:8 OK yes1:Module:12 OK yes1:Module:13 OK yes1:Module:8 OK yes1:NIC:12:1 OK yes1:NIC:12:2 OK yes1:PSU:12:1 OK yes1:PSU:12:2 OK yes1:PSU:13:1 OK yes1:PSU:13:2 OK yes1:PSU:8:1 OK yes1:PSU:8:2 OK yes1:Remote:12 OK yes1:Remote:13 OK yes1:Remote:8 OK yes1:Vault_Device:12:1 OK yes1:Vault_Device:12:2 OK yes1:Vault_Device:13:1 OK yes1:Vault_Device:13:2 OK yes1:Vault_Device:8:1 OK yes1:Vault_Device:8:2 OK yes
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
requires_service Requires Service N/A
service_reason Service Reason N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Chapter 18. Hardware maintenance commands 411
Listing module configurationUse the module_list command to list the configuration of all or specified modules.
module_list [ module=ModuleNumber ]
Parameters
Name Description Mandatory Default
module Lists the configurationof the specified module.
N All modules
The following modules are available in FlashSystem A9000 and FlashSystemA9000R:v BBU, also referred to or known as battery modulev Boot media, also referred to or known as hard disk drive (HDD)v Compute module, also referred to or known as grid controller or modulev IB Switch, also referred to or known as InfiniBand switchv Module, also referred to or known as grid controller or compute module.
This command lists the following information for each module:v Generic component statusv Module typev Number of boot mediav Number of vault devicesv Number of FC portsv Number of Ethernet ports for iSCSI
Additional information is available through running module_list -t all :v Serialv Original serialv Part numberv Original part number
Example:
module_list
Output:
Component ID Status Currently Functioning Target Status Type-------------- -------- ----------------------- --------------- ------------------------1:Module:12 OK yes g4.0_compute_enclosure1:Module:13 OK yes g4.0_compute_enclosure1:Module:8 OK yes g4.0_compute_enclosure
Cont.:
Boot Media Disks Vault Devices FC Ports iSCSI Ports Temperature------------------ --------------- ---------- ------------- -------------2 2 4 2 222 2 4 2 222 2 4 2 22
412 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
target_status Target Status 4
type Type 5
boot_media_disks Boot Media Disks 6
vault_devices Vault Devices 7
fc_port_count FC Ports 8
ethernet_port_count iSCSI Ports 9
temperature Temperature 10
serial Serial N/A
original_serial Original Serial N/A
part_number Part Number N/A
original_part_number Original Part Number N/A
sas_version SAS N/A
infiniband_hca_version.0 InfiniBand HCA 1 N/A
infiniband_hca_version.1 InfiniBand HCA 2 N/A
cna_version.0 CNA 1 N/A
cna_version.1 CNA 2 N/A
compression_adapter_firmware.0 Compression Adapter 1 N/A
compression_adapter_firmware.1 Compression Adapter 2 N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
memory_gb Mem N/A
module_11s_number 11S Number N/A
megaraid_serial_number MegaRAID Serial N/A
megaraid_product_name MegaRAID Product Name N/A
megaraid_package_version MegaRAID Package Version N/A
imm_version IMM Version N/A
uefi_version UEFI Version N/A
dsa_version DSA Version N/A
mcu_version MCU Version N/A
board_serial Board Serial N/A
board_part_number Board Part Number N/A
board_mfg_date Board MFG Date N/A
dasd_board_serial Backplane Serial N/A
dasd_board_part_number Backplane Part Number N/A
dasd_board_manufacturer Backplane Manufacturer N/A
dasd_board_mfg_date Backplane MFG Date N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Chapter 18. Hardware maintenance commands 413
User Category Permission
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing the internal temperature of modulesUse the module_temperature_list command to list the modules' internaltemperatures in the storage system.
module_temperature_list [ module=ModuleNumber ]
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All temperatures in allmodules.
Example:
module_temperature_list -f all
Output:
xcli.py module_temperature_list -f allModule Ambient PCH RS1 RS2 MID1 MID2 RAID DIMM AB VR DIMM CD VR------------- --------- ----- ----- ----- ------ ------ ------ ------------ ------------1:Module:1 16 44 32 38 31 31 34 27 271:Module:11 16 46 35 40 34 33 35 26 281:Module:2 16 43 34 38 33 32 33 26 271:Module:4 16 43 34 37 33 32 34 25 26
DIMM EF VR DIMM GH VR CPU1 CPU2 InfiniBand HCA PSU FR Fibre Channel Port fc-0------------ ------------ ------ ------ ---------------- -------- -------------------------28 27 52 55 53 28 027 32 58 68 56 32 028 27 51 53 53 28 029 30 51 55 53 29 0
Fibre Channel Port fc-2 CNA=0 CNA-1 Boot Device 0 Boot Device 1 Vault Device 0------------------------- ------- ------- --------------- --------------- ----------------0 50 46 23 21 200 51 52 27 25 210 50 49 22 22 200 48 52 24 23 20
Vault Device 1 BBU1 BBU2 CPU1 VR CPU2 VR Fibre Channel Port fc-1 Fibre ChannelPort fc-3
---------------- ------ ------ --------- --------- ------------------------- -------------21 18 18 35 36 0 021 17 16 37 40 0 020 18 17 35 37 0 020 17 17 35 37 0 0
Field ID Field output Default position
component_id Module 1
sdr_temperatures.0 Ambient 2
sdr_temperatures.1 PCH 3
414 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
sdr_temperatures.2 RS1 4
sdr_temperatures.3 RS2 5
sdr_temperatures.4 MID1 6
sdr_temperatures.5 MID2 7
sdr_temperatures.6 RAID 8
sdr_temperatures.8 CPU1 VR N/A
sdr_temperatures.9 CPU2 VR N/A
sdr_temperatures.10 DIMM AB VR 9
sdr_temperatures.11 DIMM CD VR 10
sdr_temperatures.12 DIMM EF VR 11
sdr_temperatures.13 DIMM GH VR 12
sdr_temperatures.14 CPU1 13
sdr_temperatures.15 CPU2 14
ib_hca_temperature InfiniBand HCA 15
sdr_temperatures.7 PSU FR 16
fc_adapter_temperature.0 Fibre Channel Port fc-0 17
fc_adapter_temperature.1 Fibre Channel Port fc-1 N/A
fc_adapter_temperature.2 Fibre Channel Port fc-2 18
fc_adapter_temperature.3 Fibre Channel Port fc-3 N/A
cna_temperature.0 CNA=0 19
cna_temperature.1 CNA-1 20
boot_device_temperature.0 Boot Device 0 21
boot_device_temperature.1 Boot Device 1 22
vault_device_temperature.0 Vault Device 0 23
vault_device_temperature.1 Vault Device 1 24
bbu_temperature.0 BBU1 25
bbu_temperature.1 BBU2 26
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing boot media devices in the systemUse the boot_media_list command to list boot media devices in the storagesystem.
boot_media_list [ module=ModuleNumber | boot_media=BootMediaDevice ]
Chapter 18. Hardware maintenance commands 415
Parameters
Name Description Mandatory Default
module Limits the listing to thespecific module.
N Boot media devices in aspecific module.
boot_media Limits the listing to aspecific boot media.
N A specific boot mediadevice.
Example:
boot_media_list -f all
Output:
Component ID Status Currently Functioning Hardware Status Vendor------------------- -------- ----------------------- ----------------- --------1:Boot_Media:11:1 OK yes OK ATA1:Boot_Media:11:2 OK yes OK ATA1:Boot_Media:1:1 OK yes OK ATA1:Boot_Media:1:2 OK yes OK ATA1:Boot_Media:2:1 OK yes OK ATA1:Boot_Media:2:2 OK yes OK ATA1:Boot_Media:4:1 OK yes OK ATA1:Boot_Media:4:2 OK yes OK ATA
Model Serial FW Temperature Original Serial Part #-------------- -------- ------ ------------- ----------------- --------ST91000640NS BE2A 26ST91000640NS BE2A 25ST91000640NS BE2A 21ST91000640NS BE2A 20ST91000640NS BE2A 22ST91000640NS BE2A 21ST91000640NS BE2A 23ST91000640NS BE2A 22
Original Part Number Size Requires Service Service Reason---------------------- ------ ------------------ ----------------
0MB0MB0MB0MB0MB0MB0MB0MB
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
hardware_status Hardware Status 4
vendor Vendor 5
model Model 6
serial Serial 7
fw_revision FW 8
temperature Temperature N/A
original_serial Original Serial N/A
part_number Part # N/A
original_part_number Original Part Number N/A
416 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
size Size (GB) N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
rebuild_progress Rebuild Progress N/A
rebuild_time Rebuild Time (sec.) N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing vault devices in the systemUse the vault_device_list command to list vault devices in the system.
vault_device_list [ module=ModuleNumber | vault_device=ComponentId ]
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All vault devices in allmodules.
vault_device Vault devices for whichspecial statuses are tobe listed.
N All vault devices.
Example:
vault_device_list
Output:
Chapter 18. Hardware maintenance commands 417
Component ID Status Currently Functioning Capacity Target Status Vendor--------------------- -------- ----------------------- ---------- --------------- ----------1:Vault_Device:10:1 OK yes 250GB IBM-ESXS1:Vault_Device:10:2 OK yes 250GB IBM-ESXS1:Vault_Device:11:1 OK yes 250GB IBM-ESXS1:Vault_Device:11:2 OK yes 250GB IBM-ESXS1:Vault_Device:7:1 OK yes 250GB IBM-ESXS1:Vault_Device:7:2 OK yes 250GB IBM-ESXS1:Vault_Device:9:1 OK yes 250GB IBM-ESXS1:Vault_Device:9:2 OK yes 250GB IBM-ESXS
Cont.:
Model Serial Firmware FRU Temperature Encryption State---------------- ---------- ---------- --------- ------------- ------------------HUSMM1616ASS20 0PV4G1WA N4C8 00VM221 23 UninitializedHUSMM1616ASS20 0PV4MDMA N4C8 00VM221 23 UninitializedHUSMM1616ASS20 0PV4M83A N4C8 00VM221 23 UninitializedHUSMM1616ASS20 0PV4DG9A N4C8 00VM221 24 UninitializedHUSMM1616ASS20 0PV4GADA N4C8 00VM221 22 UninitializedHUSMM1616ASS20 0PV4GBAA N4C8 00VM221 23 UninitializedHUSMM1616ASS20 0PV4MGPA N4C8 00VM221 23 UninitializedHUSMM1616ASS20 0PV49DPA N4C8 00VM221 23 Uninitialized
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
capacity_in_bytes Capacity N/A
capacity Capacity 4
target_status Target Status 5
vendor Vendor 6
model Model 7
serial Serial 8
firmware Firmware 9
part_number FRU 10
temperature Temperature 11
encryption_state Encryption State 12
requires_service Requires Service N/A
service_reason Service Reason N/A
revision Revision N/A
drive_pn Drive P/N N/A
desc.bgd_scan Background Scan N/A
desc.disk_id Device ID N/A
desc.last_sample_serial Last Sample Serial N/A
desc.last_sample_time Last Sample Time N/A
desc.power_is_on Power On N/A
desc.power_on_hours Power On Hours N/A
desc.power_on_minutes Power On Minutes N/A
desc.last_time_pom_was_mod Last Time Power On MinutesWas Modified
N/A
desc.read_fail Read Fail N/A
desc.smart_code SMART Code N/A
desc.smart_fail SMART Fail N/A
418 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
desc.temperature_status.reported_severity
Reported Temperature Severity N/A
desc.temperature_status.reported_temperature
Reported Temperature N/A
desc.temperature_status.temperature
Device Temperature N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Listing BBUs in the systemUse the module_bbu_list command to list the BBUs in the storage system modules.
module_bbu_list [ module=ModuleNumber ]
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All BBUs in allmodules.
Example:
module_bbu_list -f all
Output:
Chapter 18. Hardware maintenance commands 419
Component ID Status Curr Functioning State Hardware Status Remaining Capacity-------------- -------- ------------------ ------- ----------------- --------------------1:BBU:14:1 OK yes Full OK 8911:BBU:14:2 OK yes Full OK 8771:BBU:3:1 OK yes Full OK 7871:BBU:3:2 OK yes Full OK 8601:BBU:5:1 OK yes Full OK 7921:BBU:5:2 OK yes Full OK 8981:BBU:6:1 OK yes Full OK 8171:BBU:6:2 OK yes Full OK 814
Cont.:
Full Charge Capacity Charged % Time to Empty Time to Full Charger State---------------------- ----------- --------------- -------------- ---------------891 100 1600200 0 in progress877 100 0 0 in progress787 100 0 0 in progress860 100 0 0 in progress792 100 0 0 in progress898 100 0 0 in progress817 100 2944800 0 in progress814 100 0 0 in progress
Cont.:
Calibration State Calibration Time------------------- ------------------Idle 0Idle 0Idle 0Idle 0Idle 0Idle 0Idle 0Idle 0
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Curr Functioning 3
required_service Requires Service N/A
service_reason Service Reason N/A
bbu_state State 4
bbu_status Hardware Status 5
remaining_capacity Remaining Capacity 6
full_charge_capacity Full Charge Capacity 7
percent_charged Charged % 8
time_to_empty Time to Empty 9
time_to_full Time to Full 10
charger_state Charger State 11
calib_state Calibration State 12
calib_requested Calibration Needed N/A
last_succ_calib_date Successful Calibration Time N/A
last_calib_date Calibration Time 13
last_calib_result Calibration Result N/A
insertion_date Inserted N/A
manuf_date Manufactured N/A
fw FW Version N/A
420 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
epow_cable_present EPOW Cable Present N/A
epow_simulate EPOW Simulate N/A
epow_asserted EPOW Asserted N/A
cycle_count Cycles N/A
temperature_tenths_celsius Temp /10C N/A
charger_enabled Charger Enabled N/A
slow_charge_enabled Slow Charge Enabled N/A
discharge_enabled Discharge Enabled N/A
ps2_present PS2 Present N/A
charge_now Nominal Available CapacitymAh
N/A
voltage_now Voltage Now mV N/A
current_now Current Now mA N/A
power_avg Power Average mW N/A
charge_full Full Available Capacity mAh N/A
charge_full_design Design Charge N/A
energy_now Energy now uWh N/A
at_rate At Rate N/A
at_rate_tte At Rate Time to Empty N/A
charge_now_sufficient Charge Now Sufficient N/A
charge_full_sufficient Charge Full Sufficient N/A
endurance_start_monotonic_time Endurance Start Monotonic Time N/A
serial Serial N/A
original_serial Original Serial N/A
part_number Part # N/A
original_part_number Original Part # N/A
fru FRU N/A
runtime Runtime N/A
full_power_runtime Full Power Runtime N/A
half_power_runtime Half Power Runtime N/A
module_runtime Module Runtime N/A
state_of_health Health N/A
charge_voltage Charge Voltage mV N/A
charge_current Charge Current mA N/A
test_calib_en Test/Calib. Enabled N/A
fhd_enabled FHD Enabled N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Chapter 18. Hardware maintenance commands 421
Listing PSUs in a moduleUse the module_psu_list command to list PSUs in the specified module.
module_psu_list [ module=ModuleNumber | psu=ComponentId ]
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All PSUs in all modules.
psu Lists only a specificPSU.
N A specific PSU.
Example:
xcli.py module_psu_list -f all
Output:
Component ID Status Currently Functioning Location-------------- -------- ----------------------- ----------------1:PSU:1:1 Failed no Power Supply 11:PSU:1:2 OK yes Power Supply 21:PSU:2:1 OK yes Power Supply 11:PSU:2:2 Failed no Power Supply 21:PSU:4:1 OK yes Power Supply 11:PSU:4:2 Failed no Power Supply 2
Sensor status Serial number Part number----------------------------------------- --------------- -------------Presence NOT detected N/A N/APresence detected K115148J01L 94Y8143Presence detected K115148B06E 94Y8143Presence detected, Power Supply AC lost K115148B01P 94Y8143Presence detected K115148B0AP 94Y8143Presence detected, Power Supply AC lost K115148J01B 94Y8143
Requires Service Service Reason------------------ --------------------------REPLACE MODULE_PSU__NOT_DETECTED
COMPONENT_TEST MODULE_PSU__BAD_POWER_INPUT
COMPONENT_TEST MODULE_PSU__BAD_POWER_INPUT
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
location Location 4
sensor_statuses Sensor statuses 5
requires_service Requires Service N/A
service_reason Service Reason N/A
serial Serial number N/A
part_number Part number N/A
manufacturer Manufacturer N/A
422 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
mfg_date Manufacturing Date N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing compression adapters in the systemUse the compression_adapter_list command to list compression adapters in thesystem.
compression_adapter_list [ module=ModuleNumber | compression_adapter=ComponentId ]
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All compressionadapters in all modules.
compression_adapter Lists only a specificcompression adapter.
N A specific compressionadapter.
Compression adapters are used to increase the speed of I/O transfers to and fromcompressed volumes.
Example:
compression_adapter_list
Output:
Component ID Status Currently Functioning Firmware Hardware--------------------------- -------- ----------------------- ---------- ----------1:Compression_Adapter:6:1 OK yes 1.0.12 A0 SKU31:Compression_Adapter:6:2 OK yes 1.0.12 A0 SKU3
Driver----------------1.0.12 3d60d121.0.12 3d60d12
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
firmware_version Firmware 4
Chapter 18. Hardware maintenance commands 423
Field ID Field output Default position
hardware_version Hardware 5
driver_version Driver 6
type Type N/A
mmp_version MMP N/A
quick_assist_api_cy_version QuickAssist API CY N/A
quick_assist_api_dc_version QuickAssist API DC N/A
threading_mode Threading Mode N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing fans in a moduleUse the fan_list command to list fans in the specified module.
fan_list [ module=ModuleNumber | fan=ComponentId ]
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All fans in all modules.
fan Lists only a specific fan. N A specific fan.
Example:
fan_list
Output:
424 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Component ID Status Currently Functioning Location Speed-------------- -------- ----------------------- ---------- -------1:Fan:14:1 OK yes 1A 40121:Fan:14:10 OK yes 5B 37801:Fan:14:11 OK yes 6A 39531:Fan:14:12 OK yes 6B 37801:Fan:14:2 OK yes 1B 37171:Fan:14:3 OK yes 2A 40121:Fan:14:4 OK yes 2B 37801:Fan:14:5 OK yes 3A 40121:Fan:14:6 OK yes 3B 37801:Fan:14:7 OK yes 4A 40121:Fan:14:8 OK yes 4B 37801:Fan:14:9 OK yes 5A 38941:Fan:3:1 OK yes 1A 38941:Fan:3:10 OK yes 5B 37171:Fan:3:11 OK yes 6A 39531:Fan:3:12 OK yes 6B 38431:Fan:3:2 OK yes 1B 37171:Fan:3:3 OK yes 2A 40121:Fan:3:4 OK yes 2B 37801:Fan:3:5 OK yes 3A 39531:Fan:3:6 OK yes 3B 37801:Fan:3:7 OK yes 4A 39531:Fan:3:8 OK yes 4B 37171:Fan:3:9 OK yes 5A 38941:Fan:5:1 OK yes 1A 39531:Fan:5:10 OK yes 5B 35281:Fan:5:11 OK yes 6A 39531:Fan:5:12 OK yes 6B 37801:Fan:5:2 OK yes 1B 37801:Fan:5:3 OK yes 2A 39531:Fan:5:4 OK yes 2B 37801:Fan:5:5 OK yes 3A 38941:Fan:5:6 OK yes 3B 37801:Fan:5:7 OK yes 4A 39531:Fan:5:8 OK yes 4B 37801:Fan:5:9 OK yes 5A 39531:Fan:6:1 OK yes 1A 39531:Fan:6:10 OK yes 5B 37801:Fan:6:11 OK yes 6A 38941:Fan:6:12 OK yes 6B 37171:Fan:6:2 OK yes 1B 37801:Fan:6:3 OK yes 2A 39531:Fan:6:4 OK yes 2B 36541:Fan:6:5 OK yes 3A 39531:Fan:6:6 OK yes 3B 38431:Fan:6:7 OK yes 4A 39531:Fan:6:8 OK yes 4B 37801:Fan:6:9 OK yes 5A 4012
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
location_a Location N/A
rpm_a Speed 4
min_rpm_a Min Speed N/A
max_rpm_a Max Speed N/A
location_b Peer Location N/A
rpm_b Peer Speed 5
min_rpm_b Peer Min Speed N/A
max_rpm_b Peer Max Speed N/A
requires_service Requires Service N/A
Chapter 18. Hardware maintenance commands 425
Field ID Field output Default position
service_reason Service Reason N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing NICs in the systemUse the nic_list command to list the NICs in the storage system.
nic_list [ module=ModuleNumber | nic=ComponentId ]
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All NICs in all modules.
nic Lists only a specificNIC.
N A specific NIC.
Example:
nic_list -f all
Output:
426 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
root@nextra-6013742-module-9:~# xcli.py nic_list -f allroot@nextra-6013742-module-9:~# xcli.py nic_list -Ud -f allComponent ID Status Currently Functioning Hardware Status Device Name-------------- -------- ----------------------- ----------------- -------------1:NIC:10:1 OK yes OK eth01:NIC:10:2 OK yes OK eth11:NIC:10:3 OK yes OK eth21:NIC:10:4 OK yes OK eth31:NIC:10:5 OK yes OK eth41:NIC:10:6 OK yes OK eth51:NIC:11:1 OK yes OK eth01:NIC:11:2 OK yes OK eth11:NIC:11:3 OK yes OK eth21:NIC:11:4 OK yes OK eth31:NIC:11:5 OK yes OK eth41:NIC:11:6 OK yes OK eth51:NIC:7:1 OK yes OK eth01:NIC:7:2 OK yes OK eth11:NIC:7:3 OK yes OK eth21:NIC:7:4 OK yes OK eth31:NIC:9:1 OK yes OK eth01:NIC:9:2 OK yes OK eth11:NIC:9:3 OK yes OK eth21:NIC:9:4 OK yes OK eth31:NIC:9:5 OK yes OK eth41:NIC:9:6 OK yes OK eth5
Cont.:
Serial Original Serial Part #------------------- ------------------- --------------------------------------40:f2:e9:af:26:b0 40:f2:e9:af:26:b0 14e4_1657_40f2e9af26b0_5719-v1.3840:f2:e9:af:26:b1 40:f2:e9:af:26:b1 14e4_1657_40f2e9af26b1_5719-v1.3840:f2:e9:af:26:b2 40:f2:e9:af:26:b2 14e4_1657_40f2e9af26b2_5719-v1.3840:f2:e9:af:26:b3 40:f2:e9:af:26:b3 14e4_1657_40f2e9af26b3_5719-v1.38f4:52:14:6e:8f:70 f4:52:14:6e:8f:70 15b3_1007_708f6e00031452f4_2.35.5100f4:52:14:6e:8f:71 f4:52:14:6e:8f:71 15b3_1007_708f6e00031452f4_2.35.510040:f2:e9:af:24:48 40:f2:e9:af:24:48 14e4_1657_40f2e9af2448_5719-v1.3840:f2:e9:af:24:49 40:f2:e9:af:24:49 14e4_1657_40f2e9af2449_5719-v1.3840:f2:e9:af:24:4a 40:f2:e9:af:24:4a 14e4_1657_40f2e9af244a_5719-v1.3840:f2:e9:af:24:4b 40:f2:e9:af:24:4b 14e4_1657_40f2e9af244b_5719-v1.38f4:52:14:6e:8d:30 f4:52:14:6e:8d:30 15b3_1007_308d6e00031452f4_2.35.5100f4:52:14:6e:8d:31 f4:52:14:6e:8d:31 15b3_1007_308d6e00031452f4_2.35.510040:f2:e9:af:2a:90 40:f2:e9:af:2a:90 14e4_1657_40f2e9af2a90_5719-v1.3840:f2:e9:af:2a:91 40:f2:e9:af:2a:91 14e4_1657_40f2e9af2a91_5719-v1.3840:f2:e9:af:2a:92 40:f2:e9:af:2a:92 14e4_1657_40f2e9af2a92_5719-v1.3840:f2:e9:af:2a:93 40:f2:e9:af:2a:93 14e4_1657_40f2e9af2a93_5719-v1.3840:f2:e9:af:23:b8 40:f2:e9:af:23:b8 14e4_1657_40f2e9af23b8_5719-v1.3840:f2:e9:af:23:b9 40:f2:e9:af:23:b9 14e4_1657_40f2e9af23b9_5719-v1.3840:f2:e9:af:23:ba 40:f2:e9:af:23:ba 14e4_1657_40f2e9af23ba_5719-v1.3840:f2:e9:af:23:bb 40:f2:e9:af:23:bb 14e4_1657_40f2e9af23bb_5719-v1.38f4:52:14:6e:8f:20 f4:52:14:6e:8f:20 15b3_1007_208f6e00031452f4_2.35.5100f4:52:14:6e:8f:21 f4:52:14:6e:8f:21 15b3_1007_208f6e00031452f4_2.35.5100
Cont.:
Chapter 18. Hardware maintenance commands 427
Original Part Number Requires Service Service Reason-------------------------------------- ------------------ ----------------14e4_1657_40f2e9af26b0_5719-v1.3814e4_1657_40f2e9af26b1_5719-v1.3814e4_1657_40f2e9af26b2_5719-v1.3814e4_1657_40f2e9af26b3_5719-v1.3815b3_1007_708f6e00031452f4_2.35.510015b3_1007_708f6e00031452f4_2.35.510014e4_1657_40f2e9af2448_5719-v1.3814e4_1657_40f2e9af2449_5719-v1.3814e4_1657_40f2e9af244a_5719-v1.3814e4_1657_40f2e9af244b_5719-v1.3815b3_1007_308d6e00031452f4_2.35.510015b3_1007_308d6e00031452f4_2.35.510014e4_1657_40f2e9af2a90_5719-v1.3814e4_1657_40f2e9af2a91_5719-v1.3814e4_1657_40f2e9af2a92_5719-v1.3814e4_1657_40f2e9af2a93_5719-v1.3814e4_1657_40f2e9af23b8_5719-v1.3814e4_1657_40f2e9af23b9_5719-v1.3814e4_1657_40f2e9af23ba_5719-v1.3814e4_1657_40f2e9af23bb_5719-v1.3815b3_1007_208f6e00031452f4_2.35.510015b3_1007_208f6e00031452f4_2.35.5100
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
hardware_status Hardware Status 4
device_name Device Name 5
serial Serial N/A
original_serial Original Serial N/A
part_number Part # N/A
original_part_number Original Part Number N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing DIMMs in the systemUse the dimm_list command to list the DIMMs in the storage system.
dimm_list [ module=ModuleNumber | dimm=ComponentId ]
428 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All DIMMs in allmodules.
dimm Lists only a specificDIMM.
N A specific DIMM.
The memory modules (DIMMs) run the microcode and the data cache in the gridcontroller.
Example:
dimm_list -f all
Output:
Chapter 18. Hardware maintenance commands 429
Component ID Status Currently Functioning Hardware Status DIMM Id CPU-------------- -------- ----------------------- ----------------- --------- -----1:DIMM:7:1 OK yes OK 1 11:DIMM:7:10 OK yes OK 10 11:DIMM:7:11 OK yes OK 11 11:DIMM:7:12 OK yes OK 12 11:DIMM:7:13 OK yes OK 13 21:DIMM:7:14 OK yes OK 14 21:DIMM:7:15 OK yes OK 15 21:DIMM:7:16 OK yes OK 16 21:DIMM:7:17 OK yes OK 17 21:DIMM:7:18 OK yes OK 18 21:DIMM:7:19 OK yes OK 19 21:DIMM:7:2 OK yes OK 2 11:DIMM:7:20 OK yes OK 20 21:DIMM:7:21 OK yes OK 21 21:DIMM:7:22 OK yes OK 22 21:DIMM:7:23 OK yes OK 23 21:DIMM:7:24 OK yes OK 24 21:DIMM:7:3 OK yes OK 3 11:DIMM:7:4 OK yes OK 4 11:DIMM:7:5 OK yes OK 5 11:DIMM:7:6 OK yes OK 6 11:DIMM:7:7 OK yes OK 7 11:DIMM:7:8 OK yes OK 8 11:DIMM:7:9 OK yes OK 9 11:DIMM:9:1 OK yes OK 1 11:DIMM:9:10 OK yes OK 10 11:DIMM:9:11 OK yes OK 11 11:DIMM:9:12 OK yes OK 12 11:DIMM:9:13 OK yes OK 13 21:DIMM:9:14 OK yes OK 14 21:DIMM:9:15 OK yes OK 15 21:DIMM:9:16 OK yes OK 16 21:DIMM:9:17 OK yes OK 17 21:DIMM:9:18 OK yes OK 18 21:DIMM:9:19 OK yes OK 19 21:DIMM:9:2 OK yes OK 2 11:DIMM:9:20 OK yes OK 20 21:DIMM:9:21 OK yes OK 21 21:DIMM:9:22 OK yes OK 22 21:DIMM:9:23 OK yes OK 23 21:DIMM:9:24 OK yes OK 24 21:DIMM:9:3 OK yes OK 3 11:DIMM:9:4 OK yes OK 4 11:DIMM:9:5 OK yes OK 5 11:DIMM:9:6 OK yes OK 6 11:DIMM:9:7 OK yes OK 7 11:DIMM:9:8 OK yes OK 8 11:DIMM:9:9 OK yes OK 9 1
430 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Cont.:
Size(Mb) Speed(MHz) Manufacturer Serial Original Serial---------- ------------ -------------- ---------- -----------------16384 2133 Hynix 505F63F9 505F63F916384 2133 Samsung 39542977 3954297716384 2133 Samsung 3953EA6C 3953EA6C16384 2133 Samsung 3953F39A 3953F39A16384 2133 Samsung 3953F240 3953F24016384 2133 Samsung 39542562 3954256216384 2133 Samsung 3954300B 3954300B16384 2133 Samsung 39546472 3954647216384 2133 Samsung 39540BB2 39540BB216384 2133 Samsung 3953FB59 3953FB5916384 2133 Samsung 3954074A 3954074A16384 2133 Samsung 3953F241 3953F24116384 2133 Samsung 395404E0 395404E016384 2133 Samsung 395425D8 395425D816384 2133 Samsung 39542BF2 39542BF216384 2133 Samsung 395426EF 395426EF16384 2133 Samsung 3953EB61 3953EB6116384 2133 Samsung 39542AD0 39542AD016384 2133 Samsung 39542973 3954297316384 2133 Samsung 39542ACF 39542ACF16384 2133 Samsung 3953E982 3953E98216384 2133 Samsung 39542568 3954256816384 2133 Samsung 3953EA4A 3953EA4A16384 2133 Samsung 3953E993 3953E99316384 2133 Hynix 804AC8C2 804AC8C216384 2133 Hynix 707387FA 707387FA16384 2133 Hynix 7073895C 7073895C16384 2133 Hynix 3077315A 3077315A16384 2133 Hynix 90655EDF 90655EDF16384 2133 Hynix 7073885E 7073885E16384 2133 Hynix 30772789 3077278916384 2133 Hynix 707388BB 707388BB16384 2133 Hynix 90655FC6 90655FC616384 2133 Hynix 70738960 7073896016384 2133 Hynix 70738871 7073887116384 2133 Hynix 7073881A 7073881A16384 2133 Hynix 307C97D6 307C97D616384 2133 Hynix 7073880D 7073880D16384 2133 Hynix 70738819 7073881916384 2133 Hynix 30773136 3077313616384 2133 Hynix 30772FF8 30772FF816384 2133 Hynix 70738850 7073885016384 2133 Hynix 3079B2CD 3079B2CD16384 2133 Hynix 307A04D2 307A04D216384 2133 Hynix 70738951 7073895116384 2133 Hynix 70738939 7073893916384 2133 Hynix 70738A0B 70738A0B16384 2133 Hynix 70738823 70738823
Chapter 18. Hardware maintenance commands 431
Cont.:
Part # Original Part Number Requires Service Service Reason------------------ ---------------------- ------------------ ----------------HMA42GR7MFR4N-TF HMA42GR7MFR4N-TFM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBM393A2G40DB0-CPB M393A2G40DB0-CPBHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TFHMA42GR7MFR4N-TF HMA42GR7MFR4N-TF
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
hardware_status Hardware Status 4
dimm_id DIMM Id N/A
cpu CPU N/A
size Size(Mb) N/A
speed Speed(MHz) N/A
manufacturer Manufacturer N/A
serial Serial N/A
original_serial Original Serial N/A
432 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
part_number Part # N/A
original_part_number Original Part Number N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing CPUs in the systemUse the cpu_list command to list the central processing units (CPU) in the storagesystem.
cpu_list [ module=ModuleNumber | cpu=ComponentId ]
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All CPUs in allmodules.
cpu Lists only a specificCPU.
N A specific CPU.
Example:
cpu_list
Output:
Component ID Status Currently Functioning Hardware Status CPU Number Family-------------- -------- ----------------------- ----------------- ------------ --------1:CPU:10:1 OK yes OK 1 Xeon1:CPU:11:1 OK yes OK 1 Xeon1:CPU:12:1 OK yes OK 1 Xeon1:CPU:13:1 OK yes OK 1 Xeon1:CPU:1:1 OK yes OK 1 Xeon1:CPU:2:1 OK yes OK 1 Xeon1:CPU:3:1 OK yes OK 1 Xeon1:CPU:4:1 OK yes OK 1 Xeon1:CPU:5:1 OK yes OK 1 Xeon1:CPU:6:1 OK yes OK 1 Xeon1:CPU:7:1 OK yes OK 1 Xeon1:CPU:8:1 OK yes OK 1 Xeon1:CPU:9:1 OK yes OK 1 Xeon
Chapter 18. Hardware maintenance commands 433
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
hardware_status Hardware Status 4
number CPU Number 5
family_string Family 6
type_string Type N/A
id ID N/A
type Type Code N/A
family Family Code N/A
model Model Code N/A
stepping Stepping N/A
max_speed Max Speed(MHz) N/A
current_speed Current Speed(MHz) N/A
status_string Status N/A
manufacturer Manufacturer N/A
version Version N/A
model_string Model N/A
signature Signature N/A
core_count Cores N/A
core_enabled Enabled Cores N/A
thread_count Threads N/A
serial Serial N/A
original_serial Original Serial N/A
part_number Part # N/A
original_part_number Original Part Number N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing InfiniBand host card adapters in the storage systemUse the hca_list command to list the InfiniBand host card adapters (HCAs) in thestorage system's modules.
hca_list [ module=ModuleNumber | hca=ComponentId ]
434 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All InfiniBand HCAadapters in all modules.
hca Lists only a specificHCA.
N A specific InfiniBandHCA.
Example:
hca_list
Output:
Component ID Status Currently Functioning Board Description-------------- -------- ----------------------- --------------------------1:HCA:10:1 OK yes CB194A - Connect-IB QSFP1:HCA:7:1 OK yes CB194A - Connect-IB QSFP1:HCA:9:1 OK yes CB194A - Connect-IB QSFP
Cont.:
Board ID Part Number--------------- -------------MT_1210110019 46W0572MT_1210110019 46W0572MT_1210110019 46W0572
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
version Version N/A
board_description Board Description 4
original_board_description Original Board Description N/A
board_id Board ID 5
original_board_id Original Board ID N/A
board_type Board Type N/A
original_board_type Original Board Type N/A
serial Serial N/A
original_serial Original Serial N/A
part_number Part Number 6
original_part_number Original Part Number N/A
hardware_revision Hardware Revision N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
adapter_id HCA Id N/A
guid GUID N/A
vendor_part_id Vendor Part ID N/A
Chapter 18. Hardware maintenance commands 435
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing CNA adapters in the systemUse the cna_list command to list CNA adapters in the storage system.
cna_list [ module=ModuleNumber | cna=ComponentId ]
Parameters
Name Description Mandatory Default
module Limits the listing to aspecific module.
N All CNA adapters in allmodules.
cna Lists only a specificCNA.
N A specific CNA.
A converged network adapter (CNA) is a single network interface card thatcontains both a Fibre Channel host bus adapter and a TCP/IP Ethernet NIC. Itconnects servers to FC-based storage area networks (SANs) and Ethernet-basedlocal area networks (LANs).
Example:
cna_list
Output:
Component ID Status Currently Functioning Board Description-------------- -------- ----------------------- ------------------------------1:CNA:10:1 OK yes CX312B - ConnectX-3 Pro SFP+1:CNA:9:1 OK yes CX312B - ConnectX-3 Pro SFP+
Board ID Part Number--------------- --------------MT_1200111023 MCX312B-XCCTMT_1200111023 MCX312B-XCCT
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
version Version N/A
board_description Board Description 4
original_board_description Original Board Description N/A
board_id Board ID 5
436 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Field ID Field output Default position
original_board_id Original Board ID N/A
board_type Board Type N/A
original_board_type Original Board Type N/A
serial Serial N/A
original_serial Original Serial N/A
part_number Part Number 6
original_part_number Original Part Number N/A
hardware_revision Hardware Revision N/A
requires_service Requires Service N/A
service_reason Service Reason N/A
adapter_id HCA Id N/A
guid GUID N/A
vendor_part_id Vendor Part ID N/A
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing service statusesUse the service_list command to list all service specific statuses.
service_list [ service=ComponentId ]
Parameters
Name Description Mandatory Default
service The service to be listed. N All services
This command lists the statuses that apply to services. The list includes thefollowing information:v Component generic statusv Service on/failedv Comment (optional)
Example:
service_list
Output:
Chapter 18. Hardware maintenance commands 437
Component ID Status Currently Functioning Target Status--------------------- -------- ----------------------- ---------------1:Data:10 OK yes1:Data:11 OK yes1:Data:7 OK yes1:Data:9 OK yes1:Data_Reduction:10 OK yes1:Data_Reduction:11 OK yes1:Data_Reduction:7 OK yes1:Data_Reduction:9 OK yes1:Interface:10 OK yes1:Interface:11 OK yes1:Interface:9 OK yes1:Remote:10 OK yes1:Remote:11 OK yes1:Remote:9 OK yes
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
target_status Target Status 4
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing system components that require serviceUse the component_service_required_list command to list system componentsand their status.
component_service_required_list [ component=ComponentId ] [ filter=<ALL|FAILED|NOTOK> ]
Parameters
Name Type Description Mandatory Default
component N/A Lists only thiscomponent.
N All components.
filter Enumeration Filters the list toshow only failedor only non-OKcomponents.
N ALL
The list can be filtered to show only a specific component, all failed components,or all components in a non-OK state.
438 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
For status and configuration of specific component types, refer to the _listcommands for specific components, such as: module_list or switch_list.
Example:
component_service_required_list
Output:
Component ID Status Currently Functioning Requires Service----------------------- -------- ----------------------- ------------------1:IB_Module_Port:12:2 Failed no COMPONENT_TEST1:IB_Module_Port:13:2 Failed no COMPONENT_TEST1:IB_Module_Port:8:2 Failed no COMPONENT_TEST1:IB_Switch_Port:2:12 Failed no COMPONENT_TEST1:IB_Switch_Port:2:13 Failed no COMPONENT_TEST1:IB_Switch_Port:2:8 Failed no COMPONENT_TEST
Cont.:
Service Reason---------------------------IB_SWITCH_PHY_PORT_NOT_UPIB_SWITCH_PHY_PORT_NOT_UPIB_SWITCH_PHY_PORT_NOT_UPIB_SWITCH_PHY_PORT_NOT_UPIB_SWITCH_PHY_PORT_NOT_UPIB_SWITCH_PHY_PORT_NOT_UP
Field ID Field output Default position
component_id Component ID 1
status Status 2
currently_functioning Currently Functioning 3
requires_service Requires Service 4
service_reason Service Reason 5
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Listing trace snapshot on a moduleUse the traces_snapshot_list command to list trace snapshots on a module.
traces_snapshot_list module=ModuleNumber
Chapter 18. Hardware maintenance commands 439
Parameters
Name Description Mandatory
module Component ID of the module toquery.
Y
Field ID Field output Default position
snapshot Snapshot Directories 1
Example:
traces_snapshot_list module=1:Module:9
Output:
Snapshots Directories--------------------------------1__20120802_1653_20120802_1713
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Creating a trace snapshotUse the traces_snapshot command to create a trace snapshot.
traces_snapshot [ snapshot_back_time=MINUTES ] [ snapshot_delay_time=MINUTES ]
Parameters
Name Type Description Mandatory Default
snapshot_delay_time
Integer Max delaybetween therequest andsnapshot creation.
N no. Usesconfigurationmisc.internal.auto_snapshot_trace.last_snapshot_minutes_delayfield.
snapshot_back_time
Integer Time back fromthe request time toinclude in thesnapshot.
N no. Usesconfigurationmisc.internal.auto_snapshot_trace.snapshot_back_time field.
Example:
440 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
xcli.py traces_snapshot snapshot_back_time=60 snapshot_delay_time=1
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Allowed
Chapter 18. Hardware maintenance commands 441
442 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 19. Statistics commands
This section describes the command-line interface (CLI) for getting systemstatistics.
Getting performance statisticsUse the statistics_get command to retrieve performance statistics from thestorage system.
statistics_get [ perf_class=perfClassName | host=HostName | host_iscsi_name=initiatorName |host_fc_port=WWPN | target=RemoteTarget | remote_fc_port=WWPN | remote_ipaddress=IPAddress |vol=VolName | domain=DomainName | ipinterface=IPInterfaceName | local_fc_port=ComponentId ]< start=TimeStamp | end=TimeStamp > [ module=ModuleNumber ]count=N interval=IntervalSize resolution_unit=<minute|hour|day|week|month>
Parameters
Name Type Description Mandatory Default
host Object name Limits statistics tothe specific hostonly.
N All hosts
host_fc_port N/A FC address of thehost port.
N All ports.
target Object name Limits statistics toI/O generated bythe specifiedremote target only(due to remotemirroring).
N All targets.
remote_fc_port N/A Limits statistics tothe specifiedhost/remote FCport only.
N All ports.
remote_ipaddress N/A IP address of theremote target port.
N All ports.
host_iscsi_name iSCSI initiatorname
Limits statistics tothe specified iSCSIinitiator only.
N All ports.
ipinterface Object name Limits statistics tothe specified IPinterface (relevantfor iSCSI only).
N All interfaces.
module N/A Limits statistics tothe specifiedmodule only.
N All modules.
local_fc_port N/A Limits statistics toI/O performed onthe specified FCport only.
N All ports.
vol Object name Limits statistics tothe specifiedvolume only.
N All volumes.
domain Object name Limits statistics tothe specifieddomain only.
N All domains.
© Copyright IBM Corp. 2016 443
Name Type Description Mandatory Default
start N/A Starting point forthe statisticsreport.
N N/A
end N/A Ending point forthe statisticsreport.
N N/A
count Positive integer Number of timepoints reported.
Y N/A
interval Positive integer The length of timein each statistic'stime point. Theresolution of thisnumber is set inresolution_unit.
Y N/A
resolution_unit Enumeration Sets the unit ofmeasurement forthe length of eachbin.
Y N/A
perf_class Object name Displaysperformance classaggregatedstatistics forbandwidth andIOPS.
N All Performanceclasses.
This command lists I/O statistics. The count parameter sets the number of lines inthe statistics report. The combination of the interval and resolution_unitparameters sets the length of time for each statistics line. Either start or endtimestamp must be provided. These timestamps set the time for the statisticsreport. Other parameters restrict statistics to a specific host, host port, volume,domain, interface port and so on.
For each line of statistics, 48 numbers are reported, which represent all thecombinations of reads/writes, hits/misses and I/O size reporting for each of the 16options for bandwidth, IOPS and latency. Statistics collection is limited to 32 poolsand 200 volumes.
The syntax for the start and end fields is as follows: Y-M-D[.[h[:m[:s]]]], wherethe ranges are as follows:v Y - year (four digit)v M - month (1-12)v D - day (1-31)v h - hour (0-23, with 0 as default)v m - minute (0-59, with 0 as default)v s - second (0-59, with 0 as default)
The year, month and day are separated by dashes, and the optional hours, minutesand seconds are separated by colons.
Output units:v Very Large blocks are >512KBv Large blocks - 64-512KBv Medium blocks - 8-64KBv Small blocks - 0-8KB
444 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v The latency is in Microsecondsv The bandwidth is in KB
Field ID Field output Default position
time Time 1
failures Failures N/A
aborts Aborts N/A
read_hit_very_large_iops Read Hit Very large - IOps 2
read_hit_very_large_latency Read Hit Very large - Latency 3
read_hit_very_large_throughput
Read Hit Very large -Throughput
4
read_hit_large_iops Read Hit Large - IOps 5
read_hit_large_latency Read Hit Large - Latency 6
read_hit_large_throughput Read Hit Large - Throughput 7
read_hit_medium_iops Read Hit Medium - IOps 8
read_hit_medium_latency Read Hit Medium - Latency 9
read_hit_medium_throughput Read Hit Medium - Throughput 10
read_hit_small_iops Read Hit Small - IOps 11
read_hit_small_latency Read Hit Small - Latency 12
read_hit_small_throughput Read Hit Small - Throughput 13
read_miss_very_large_iops Read Miss Very large - IOps 14
read_miss_very_large_latency Read Miss Very large - Latency 15
read_miss_very_large_throughput
Read Miss Very large -Throughput
16
read_miss_large_iops Read Miss Large - IOps 17
read_miss_large_latency Read Miss Large - Latency 18
read_miss_large_throughput Read Miss Large - Throughput 19
read_miss_medium_iops Read Miss Medium - IOps 20
read_miss_medium_latency Read Miss Medium - Latency 21
read_miss_medium_throughput Read Miss Medium -Throughput
22
read_miss_small_iops Read Miss Small - IOps 23
read_miss_small_latency Read Miss Small - Latency 24
read_miss_small_throughput Read Miss Small - Throughput 25
write_hit_very_large_iops Write Hit Very large - IOps 26
write_hit_very_large_latency Write Hit Very large - Latency 27
write_hit_very_large_throughput
Write Hit Very large -Throughput
28
write_hit_large_iops Write Hit Large - IOps 29
write_hit_large_latency Write Hit Large - Latency 30
write_hit_large_throughput Write Hit Large - Throughput 31
write_hit_medium_iops Write Hit Medium - IOps 32
write_hit_medium_latency Write Hit Medium - Latency 33
write_hit_medium_throughput Write Hit Medium - Throughput 34
write_hit_small_iops Write Hit Small - IOps 35
write_hit_small_latency Write Hit Small - Latency 36
write_hit_small_throughput Write Hit Small - Throughput 37
write_miss_very_large_iops Write Miss Very large - IOps 38
write_miss_very_large_latency Write Miss Very large - Latency 39
Chapter 19. Statistics commands 445
Field ID Field output Default position
write_miss_very_large_throughput
Write Miss Very large -Throughput
40
write_miss_large_iops Write Miss Large - IOps 41
write_miss_large_latency Write Miss Large - Latency 42
write_miss_large_throughput Write Miss Large - Throughput 43
write_miss_medium_iops Write Miss Medium - IOps 44
write_miss_medium_latency Write Miss Medium - Latency 45
write_miss_medium_throughput Write Miss Medium -Throughput
46
write_miss_small_iops Write Miss Small - IOps 47
write_miss_small_latency Write Miss Small - Latency 48
write_miss_small_throughput Write Miss Small - Throughput 49
read_memory_hit_very_large_iops
Read Memory-Hit Very large -IOps
50
read_memory_hit_very_large_latency
Read Memory-Hit Very large -Latency
51
read_memory_hit_very_large_throughput
Read Memory-Hit Very large -Throughput
52
read_memory_hit_large_iops Read Memory-Hit Large - IOps 53
read_memory_hit_large_latency Read Memory-Hit Large -Latency
54
read_memory_hit_large_throughput
Read Memory-Hit Large -Throughput
55
read_memory_hit_medium_iops Read Memory-Hit Medium -IOps
56
read_memory_hit_medium_latency Read Memory-Hit Medium -Latency
57
read_memory_hit_medium_throughput
Read Memory-Hit Medium -Throughput
58
read_memory_hit_small_iops Read Memory-Hit Small - IOps 59
read_memory_hit_small_latency Read Memory-Hit Small -Latency
60
read_memory_hit_small_throughput
Read Memory-Hit Small -Throughput
61
time_in_seconds Time (s) 62
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Return codesv BAD_TIME_FORMAT
Bad time format. Should be YYYY-MM-DD[.HH[:MM[:SS]]]
446 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
v TARGET_PORT_BAD_ADDRESS
Remote port address is illegal or does not belong to the remote targetv VOLUME_BAD_NAME
Volume name does not existv STATS_TOO_MANY_SAMPLES
Requested number of statistics samples is too highv TARGET_BAD_NAME
Target name does not existv COMPONENT_DOES_NOT_EXIST
Component does not existv HOST_BAD_NAME
Host name does not existv HOST_PORT_DOES_NOT_EXIST
Port ID is not definedv IPINTERFACE_DOES_NOT_EXIST
IP Interface name does not existv PERF_CLASS_BAD_NAME
Performance Class does not existv COMMAND_AMBIGUOUS
User belongs to more than one domain. Please specify a domain or a specificobject.
v DOMAIN_DOESNT_EXIST
Domain does not exist.
Retrieving usage historyUse the usage_get command to display the usage history of a volume or a storagepool.
usage_get < vol=VolName | pool=PoolName > [ start=TimeStamp | start_in_seconds=StartTime ][ end=TimeStamp ] [ max=MaxEntries ]
Parameters
Name Type Description Mandatory Default
vol Object name Volume for whichusage statistics areretrieved.
N N/A
pool Object name Storage pool forwhich usagestatistics areretrieved.
N N/A
start N/A Starting time forusage historyretrieval.
N Creation time ofthe object.
end N/A Ending time forusage historyretrieval.
N Current time.
max Integer Maximum numberof entries toretrieve.
N No limit.
Chapter 19. Statistics commands 447
Name Type Description Mandatory Default
start_in_seconds Integer Starting time forusage historyretrieval, inseconds since12:00:00 AM, 1January 1970.
N Creation time ofthe object.
This command retrieves the usage history of a storage pool or volume inmegabytes (MB).
Example:
usage_get pool=DBPool
Output:
Time Volume Usage (MiB) Snapshot Usage (MiB)--------------------- -------------------- ----------------------2016-03-29 12:00:00 0 02016-03-29 13:00:00 0 02016-03-29 14:00:00 0 0
Field ID Field output Default position
time Time 1
volume_usage Volume Usage (MiB) 2
snapshot_usage Snapshot Usage (MiB) 3
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Return codesv VOLUME_BAD_NAME
Volume name does not existv POOL_DOES_NOT_EXIST
Storage Pool does not existv BAD_TIME_FORMAT
Bad time format. Should be YYYY-MM-DD[.HH[:MM[:SS]]]v END_BEFORE_START
End Time should be later than Start Timev VOLUME_IS_SNAPSHOT
Operation is not permitted on snapshots
448 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 20. Metadata commands
This section describes the command-line interface (CLI) for handling metadata.
Setting metadataUse the metadata_set command to set metadata of an object.
metadata_set object_type=Object name=Name key=Key value=Value
Parameters
Name Type Description Mandatory
object_type Enumeration An object type.Available values: cg,cluster, dest, destgroup,host, performanceclass,pool, rule, schedule,smsgw, smtpgw, target,user, user_group, vol.
Y
name Object name An object name. Y
key String Metadata key. Y
value String Metadata value. Y
This command sets a new metadata key value for the specified object. The newvalue overrides the previous one, if it exists.
The value can be an empty string. Up to 16 values are allowed, each limited to 128bytes.
Example:
metadata_set object_type=host name=Host1 key=01 value=Host
Output:
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
© Copyright IBM Corp. 2016 449
User Category Permission Condition
Application administrator Conditionally Allowed Metadata can be set for onlyvolumes, snapshots, snapshotgroups, clusters or hosts, andonly for objects associated withthe application administratorexecuting the command. Hostsor clusters should be associatedwith the user. Volumes shouldbe mapped to a host or a clusterassociated with the user.Snapshots or snapshot groupsshould be ones created byapplication administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv OBJECT_BAD_NAME
Referenced object does not exist.v MAX_METADATA_OBJECTS_REACHED
Maximal number of metadata objects has been reached.
Deleting metadataUse the metadata_delete command to delete an object's metadata.
metadata_delete object_type=Object name=Name key=Key
Parameters
Name Type Description Mandatory
object_type Enumeration Type of object. Availablevalues: cg, cluster, dest,destgroup, host,performanceclass, pool,rule, schedule, smsgw,smtpgw, target, user,user_group, vol.
Y
name Object name The name of the targetobject.
Y
key String Metadata key. Y
This command deletes a metadata key value for the specified object.
The command will fail if the key is not defined.
Example:
metadata_delete object_type=host name=Host1 key=01
Output:
450 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Command completed successfully.
Access control
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed Metadata can be set for onlyvolumes, snapshots, snapshotgroups, clusters or hosts, andonly for objects associated withthe application administratorexecuting the command. Hostsor clusters should be associatedwith the user. Volumes shouldbe mapped to a host or a clusterassociated with the user.Snapshots or snapshot groupsshould be ones created byapplication administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Return codesv OBJECT_BAD_NAME
Referenced object does not exist.v METADATA_OBJECT_KEY_NOT_FOUND
The specified metadata object does not exist.
Listing metadataUse the metadata_list command to list an object's metadata.
metadata_list [ object_type=Object ] [ name=Name ] [ key=Key ] [ domain=DomainName ]
Parameters
Name Type Description Mandatory Default
object_type Enumeration Type of object. N Type of object.Available values:cg, cluster, dest,destgroup, host,performanceclass,pool, rule,schedule, smsgw,smtpgw, target,user, user_group,vol.
name Object name The name of thetarget object.
N All objects
key String Metadata key. N List all keys andvalues.
domain Object name The domain name. N All Domains
Chapter 20. Metadata commands 451
This command lists all the value key pairs for this object, or a specific one. Thecommand fails if no key is defined.
Example:
metadata_list object_type=host
Output:
Object Type Name Key Value------------- ------- ----- -------Host Host1 01 Host
Field ID Field output Default position
object_type Object Type 1
name Name 2
key Key 3
value Value 4
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Allowed
Security administrator Disallowed
Read-only users Allowed
Technicians Allowed
Setting user metadataUse the user_metadata_set command to set user metadata by section and key.
user_metadata_set section=Section key=Key value=Value
Parameters
Name Type Description Mandatory
section Enumeration Metadata section. Y
key String Metadata key. Y
value String Metadata value. Y
Example:
user_metadata_set section=GUI key=GUI_10.2 value=Ubunto_2.6
Output:
(Command returns no output)
452 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv USER_METADATA_FULL
Maximal number of user metadata objects has been reached.
Listing user metadataUse the user_metadata_list command to list user metadata.
user_metadata_list [ section=Section ]
Parameters
Name Type Description Mandatory Default
section Enumeration User metadatasection.
N ''
Example:
user_metadata_list
Output:
Time Section Key Value--------------------- -------- --------- -------2004-11-22 18:08:23 TA GUI_0.2 Ubunto_2.22007-11-22 18:08:22 GUI GUI_10.1 Ubunto_2.62007-11-22 18:08:23 GUI GUI_10.2 Ubunto_2.6
Field ID Field output Default position
time Time 1
section Section 2
key Key 3
value Value 4
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Allowed
Chapter 20. Metadata commands 453
User Category Permission
Security administrator Disallowed
Read-only users Allowed
Technicians Disallowed
Deleting user metadataUse the user_metadata_delete command to delete user metadata by user sectionand key.
user_metadata_delete section=Section key=Key
Parameters
Name Type Description Mandatory
section Enumeration Meta data section. Y
key String Metadata key. Y
Example:
user_metadata_delete section=GUI key=GUI_10.2
Output:
(Command returns no output)
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Technicians Disallowed
Return codesv USER_METADATA_OBJECT_KEY_NOT_FOUND
The specified user metadata object does not exist.
454 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 21. Encryption enablement and support commands
This section describes the command-line interface (CLI) for encryptionconfiguration.
Disabling encryptionUse the encrypt_disable command to disable the data protection feature.
encrypt_disable
This command disables the data protection feature. A prerequisite for this is thatno volumes are defined in the system. In addition to disabling the data protection,a cryptographic erase is performed on all protected bands (ensuring that allexisting user data is no longer accessible). After the command successfullycompletes, all bands are left in the unlocked state. Disabling encryption when theencryption state is other than Active (displayed as Enabled in state_list) willresult in an error.
Example:
encrypt_disable -y
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_DISABLE_ENCRYPTION
Are you sure you want to disable encryption on this system?Troubleshooting: A yes option is required for this command
Return codesv CANNOT_DISABLE_ENCRYPTION_WHILE_NOT_IN_FULLY_PROTECTED_STATE
Cannot disable encryption while not in fully protected state.Troubleshooting: Resolve any issues preventing system from reaching full dataprotection state. Contact support for assistance.
v UNSUPPORTED_HARDWARE
© Copyright IBM Corp. 2016 455
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v ENCRYPT_NOT_ENABLED
Encryption is not enabled.Troubleshooting: Check that encryption is enabled and try again the command.
v VOLUME(S)_DEFINED
There are volumes defined, cannot disable encryption.Troubleshooting: All volumes must be removed before encryption is disabled.
v CANNOT_UNMOUNT_STATISTIC_VOLUME
Failed to unmount statistics volume for disabling encryption.Troubleshooting: Please contact support.
v DATA_REDUCTION_RECOVERY_IS_RUNNING
Data reduction recovery is running, operation is not allowedTroubleshooting: Wait for data reduction recovery to complete.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v SECURE_ERASE_IS_RUNNING
Operation not allowed while secure erase is running.Troubleshooting: Wait for secure erase process to complete.
v FLASH_CCL_IN_PROGRESS
The requested command cannot be invoked while Flash Enclosure CCL is inprogress.Troubleshooting: Wait for Flash CCL to complete
Enabling encryptionUse the encrypt_enable command to enable the data protection feature.
encrypt_enable [ recovery_keys=<yes|no> ]
Parameters
Name Type Description Mandatory Default
recovery_keys Boolean Defines whetherrecovery keys arerequired forencryptionactivation.
N yes
This command is entered by a security administrator to enable the data protectionfeature. In order for this command to complete successfully, all of the followingprerequisites must be fulfilled: Current encryption state must be DISABLED(displayed as "Supported" in state_list) One master keyserver configuredsuccessfully Recovery keys generated and verified, for and by at least 2 separatesecurity administrators, unless the recovery_keys parameter is set to no.
Example:
456 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
encrypt_enable recovery_keys=yes -y
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Warningsv ARE_YOU_SURE_YOU_WANT_TO_ENABLE_ENCRYPTION
Are you sure you want to enable encryption on this system?Troubleshooting: A yes option is required for this command
Return codesv CANNOT_ENABLE_ENCRYPTION_WHILE_NOT_IN_FULLY_PROTECTED_STATE
Cannot enable encryption while not in fully protected state.Troubleshooting: Resolve any issues preventing system from reaching full dataprotection state. Contact support for assistance.
v UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v INVALID_RECOVERY_KEY_STATE
Recovery key state is inconsistent with the option provided.Troubleshooting: Check the recovery key state usingencrypt_recovery_key_status.
v ENCRYPTION_ALREADY_ENABLED
Encryption has already been enabled.Troubleshooting: Check the state_list command
v SYSTEM_IS_REDISTRIBUTING
Operation is not allowed during rebuild or phase-inv NO_LIVE_KEYSERVER_GATEWAY_NODE
There is no live key server gateway node on the system.Troubleshooting: Please restart the key server gateway node and try again.
v NO_MASTER_KEYSERVER_DEFINED
There is no master key server defined on the system.Troubleshooting: Please define a master key server by invoking encrypt_keyserver_update and try again.
v KEYSERVER_COMMUNICATION_GENERIC_ERROR
Chapter 21. Encryption enablement and support commands 457
Cannot connect to an active key server.Troubleshooting: Invoke encrypt_keyserver_list and event_list for more details.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
v ENCRYPTION_CANNOT_ENROLL_SOME_FLASH_ENCLOSURES
Not all flash enclosures are phased in before enrollment.Troubleshooting: Contact support.
v ENCRYPTION_CANNOT_ENROLL_SOME_VAULT_DEVICES
Failed software components prevent enrolling some vault devices.Troubleshooting: Contact support.
v DATA_REDUCTION_RECOVERY_IS_RUNNING
Data reduction recovery is running, operation is not allowedTroubleshooting: Wait for data reduction recovery to complete.
v FLASH_CCL_IN_PROGRESS
The requested command cannot be invoked while Flash Enclosure CCL is inprogress.Troubleshooting: Wait for Flash CCL to complete
Defining a keyserverUse the encrypt_keyserver_define command to define a keyserver to be used bythe system.
encrypt_keyserver_define name=Name [ ipv4=Address ] [ ipv6=Address ] [ port=PortNumber ][ master=<yes|no> ] [ keyserver_type=KeyserverType ] certificate=PemCertificate
Parameters
Name Type Description Mandatory Default
name String The name of thekeyserver beingadded.
Y N/A
certificate N/A The publiccertificate of thekeyserver beingadded.
Y N/A
master Boolean Defines whetherthis keyserver isthe primarykeyserver used forkey retrieval.
N no
ipv4 N/A The IPv4 addressof the keyserverbeing added.Either one IPv4and/or one IPv6must be used.
N NONE
458 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Name Type Description Mandatory Default
ipv6 N/A The IPv6 addressof the keyserverbeing added.Either one IPv4and/or one IPv6must be used.
N NONE
port Integer Port used forkeyservercommunication.
N 5696
keyserver_type Enumeration The type of thekeyserver tocommunicate with.
N TKLM
This command defines a keyserver to be used by the system upon startup orencryption activation to retrieve the key material required to cryptographicallyunlock the disks. At least one keyserver (but preferably two, and no more thanfour) must be defined and accessible in order for encrypt_enable to succeed. Onlyone of the keyservers may be defined as master.
Example:
encrypt_keyserver_definename=snocone ipv4=snocone.ibm.com ipv6=2002::a5a7 certificate=’’
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v ENCRYPTION_TOO_MANY_KEYSERVERS
Too many key servers, cannot add.Troubleshooting: Delete a key server and try again.
v ENCRYPTION_UNSUPPORTED_KEYSERVER_TYPE
Unsupported key server type.v ENCRYPTION_KEYSERVER_NAME_EXISTS
Key server name already exists.Troubleshooting: Check the currently defined key servers
Chapter 21. Encryption enablement and support commands 459
v ENCRYPTION_KEYSERVER_MUST_HAVE_ADDRESS
Key server must have at least one address (IPv4/IPv6).Troubleshooting: Add ipv4= or ipv6= to the command
v ENCRYPTION_KEYSERVER_IPV4_ALREADY_EXISTS
The IPv4 address or host name already exists.Troubleshooting: Check the currently defined key servers
v ENCRYPTION_KEYSERVER_IPV6_ALREADY_EXISTS
The IPv6 address or host name already exists.Troubleshooting: Check the currently defined key servers
v SSL_CERTIFICATE_HAS_EXPIRED
SSL certificate has expired.v SSL_CERTIFICATE_VERIFICATION_FAILED
SSL certificate chain verification failed.v SSL_CERTIFICATE_INVALID_FORMAT
SSL certificate format is invalid or corrupted.v SSL_CERTIFICATE_NOT_YET_VALID
SSL certificate is not yet valid.v SSL_CERTIFICATE_VERIFICATION_INTERNAL_ERROR
SSL certificate verification has failed because of internal system error.v SSL_CERTIFICATE_ISSUER_NOT_FOUND
SSL certificate issuer not found in certificate chain.v SSL_CERTIFICATE_CHAIN_EMPTY
No certificates found in input.
Removing a keyserverUse the encrypt_keyserver_delete command to remove a keyserver used by thesystem.
encrypt_keyserver_delete name=Name
Parameters
Name Type Description Mandatory
name String The name of a definedkeyserver.
Y
Example:
encrypt_keyserver_delete name=snocone
Output:
Command executed successfully.
460 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v ENCRYPTION_UNKNOWN_KEYSERVER
Unknown key server name.Troubleshooting: Check the currently defined key servers
v ENCRYPTION_DELETE_MASTER_KEYSERVER
Removal of master key server is not permitted.Troubleshooting: A new master key server must be defined before removing thecurrent master.
v ENCRYPTION_LAST_DEFINED_KEYSERVER
Cannot delete the last key server.Troubleshooting: Define another master key server before attempting to deletethis one.
Displaying keyserver statusUse the encrypt_keyserver_list command to list the keyservers currently definedin the system along with their connectivity status.
encrypt_keyserver_list
Example:
encrypt_keyserver_list
Output:
Module Name App/Key Status Last time checked Master Port3 nachos NOAPP 2013/03/27 20:18:43 yes 56963 nachos UNKNOWN 2013/03/27 20:18:43 yes 56963 snocone UNKNOWN 2013/03/27 20:18:43 no 56963 snocone ACTIVE 2013/03/27 20:18:43 no 56963 TKLM-SA BAD_CERT 2013/03/27 20:18:43 no 5696
Address9.11.236.12002::1snocone.tucson.ibm.com2002:90b:e006:238:209:6bff:fe00:a5a7tklm-sa.ibm.com
Chapter 21. Encryption enablement and support commands 461
Field ID Field output Default position
module_id Module 1
label Name 2
heartbeat_keyserver_status App/Key Status 3
last_heartbeat Last time checked 4
master Master 5
port Port 6
address Address 7
keyserver_type Keyserver Type 8
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
Checking keyserver statusUse the encrypt_keyserver_check_status command to check connectivity status ofthe keyservers currently defined in the system.
encrypt_keyserver_check_status
This command initiates the async check of the connectivity status of the keyserverscurrently defined in the system. To get the current status, use theencrypt_keyserver_list CLI command.
Example:
encrypt_keyserver_check_status
Output:
Command completed successfully
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
462 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
User Category Permission
Application administrator Disallowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
Obtaining a new master keyUse the encrypt_keyserver_rekey command to initiate a rekey against the masterkeyserver.
encrypt_keyserver_rekey
This command initiates a rekeying (getting new cryptographic material) with themaster keyserver.
Example:
encrypt_keyserver_rekey
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v ENCRYPT_NOT_ENABLED
Encryption is not enabled.Troubleshooting: Check that encryption is enabled and try again the command.
v CANNOT_GET_XIV_MASTER_KEY
Problem obtaining XIV master key from the key server.
Chapter 21. Encryption enablement and support commands 463
Troubleshooting: Check that the key server is active and serving keys, andcontact support.
v CANNOT_GET_NEW_KEY_REQUEST
Error requesting encryption keys from the key server gateway node.Troubleshooting: Check that the key server is actively serving keys
v CANNOT_UPDATE_KEY_METADATA
Cannot update metadata in key repository for new key.Troubleshooting: Contact support.
v CANNOT_CANNOT_GENERATE_EXMK_ESKH
Problem generating EXMK and ESKH.Troubleshooting: Contact support.
v CANNOT_WRITE_TO_KEY_REPOSITORY
Failed writing keys to the key repository.Troubleshooting: Contact support.
v CANNOT_COPY_KEYS_IN_KEY_REPOSITORY
Problem copying current keys to old keys location in the key repository.Troubleshooting: Contact support.
v ENCRYPTION_KR_WRITE_FAILED
Error writing to the key repository.Troubleshooting: Contact support
v ENCRYPTION_KR_READ_FAILED
Error reading the key repository.Troubleshooting: Contact support
v NO_LIVE_KEYSERVER_GATEWAY_NODE
There is no live key server gateway node on the system.Troubleshooting: Please restart the key server gateway node and try again.
v NO_MASTER_KEYSERVER_DEFINED
There is no master key server defined on the system.Troubleshooting: Please define a master key server by invoking encrypt_keyserver_update and try again.
v KEYSERVER_COMMUNICATION_GENERIC_ERROR
Cannot connect to an active key server.Troubleshooting: Invoke encrypt_keyserver_list and event_list for more details.
Renaming a keyserverUse the encrypt_keyserver_rename command to change the name of a definedkeyserver.
encrypt_keyserver_rename name=Name new_name=Name
Parameters
Name Type Description Mandatory
new_name String The new name of thekeyserver.
Y
name String The current name of adefined keyserver.
Y
464 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Example:
encrypt_keyserver_rename name=nachos new_name=snocone
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v ENCRYPTION_UNKNOWN_KEYSERVER
Unknown key server name.Troubleshooting: Check the currently defined key servers
v ENCRYPTION_KEYSERVER_NAME_EXISTS
Key server name already exists.Troubleshooting: Check the currently defined key servers
Changing keyserver propertiesUse the encrypt_keyserver_update command to change a keyserver's IP addressand/or port.
encrypt_keyserver_update name=Name [ ipv4=Address ] [ ipv6=Address ] [ port=PortNumber ][ master=<yes|no> ] [ certificate=PemCertificate ]
Parameters
Name Type Description Mandatory Default
name String Name of thekeyserver to beupdated.
Y N/A
certificate N/A The publiccertificate of thekeyserver to beupdated.
N none
Chapter 21. Encryption enablement and support commands 465
Name Type Description Mandatory Default
master Enumeration Indicates whetherthis keyserver isthe master.
N no
ipv4 N/A The IPv4 address. N none
ipv6 N/A The IPv6 address. N none
port Integer Port number forcommunications.
N 5696
This command is used to update a keyserver's address, port, or certificate.
Example:
encrypt_keyserver_update name=nachos master=yes ipv4=10.0.0.1ipv6=2001::2 port=1010 certificate=’’
Output:
Command completed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v ENCRYPTION_UNKNOWN_KEYSERVER
Unknown key server name.Troubleshooting: Check the currently defined key servers
v ENCRYPTION_KEYSERVER_IPV4_ALREADY_EXISTS
The IPv4 address or host name already exists.Troubleshooting: Check the currently defined key servers
v ENCRYPTION_KEYSERVER_IPV6_ALREADY_EXISTS
The IPv6 address or host name already exists.Troubleshooting: Check the currently defined key servers
v SSL_CERTIFICATE_HAS_EXPIRED
SSL certificate has expired.v SSL_CERTIFICATE_VERIFICATION_FAILED
SSL certificate chain verification failed.v SSL_CERTIFICATE_INVALID_FORMAT
466 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
SSL certificate format is invalid or corrupted.v SSL_CERTIFICATE_NOT_YET_VALID
SSL certificate is not yet valid.v SSL_CERTIFICATE_VERIFICATION_INTERNAL_ERROR
SSL certificate verification has failed because of internal system error.v SSL_CERTIFICATE_ISSUER_NOT_FOUND
SSL certificate issuer not found in certificate chain.v SSL_CERTIFICATE_CHAIN_EMPTY
No certificates found in input.
Entering a recovery keyUse the encrypt_recovery_key_enter command to unlock encrypted disks whenthe system reboots and cannot access any of the defined keyservers, and whenrecovery keys are defined.
encrypt_recovery_key_enter key=Key
Parameters
Name Description Mandatory
key The 64-character hexadecimalrecovery key.
Y
This command is used to unlock encrypted disks when the system reboots andcannot access any of the defined keyservers. To unlock the disks, the min_reqnumber (defined by the encrypt_recovery_key_generate command) of securityadministrators must all successfully enter their recovery key (as presented to themvia recovery_key_get). After the minimum required keys have been entered, thestorage administrator must change the state from Maintenance to On by issuingstate_change target_state=on. When this command is issued with the machine inthe On state, it has no effect, and can be used to check the validity of the recoverykey.
Example:
encrypt_recovery_key_enterkey=CBC9B398373FDE79CD38B23192DABACADB5DA63A915CBF5CA8C4E0C212819DE6
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Chapter 21. Encryption enablement and support commands 467
User Category Permission
Technicians Disallowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v INVALID_RECOVERY_KEY_FRAGMENT
Recovery key fragment given does not match stored key.Troubleshooting: Verify that the proper key(share) has been used
v GENERIC_FAILED
Generic encryption failure.Troubleshooting: Contact support.
v INVALID_RECOVERY_KEY_USER
User is not a valid recovery key administrator.Troubleshooting: Check that the user names provided are valid
v NO_LIVE_KEYSERVER_GATEWAY_NODE
There is no live key server gateway node on the system.Troubleshooting: Please restart the key server gateway node and try again.
v CANNOT_READ_FROM_KEY_REPOSITORY
Failed reading keys from the key repository.Troubleshooting: Contact support.
v RK_FAILED_VERIFY_SLEEP
Too many failed verify attempts, please wait and try again.Troubleshooting: Wait a little and try again.
v ENCRYPTION_KR_WRITE_FAILED
Error writing to the key repository.Troubleshooting: Contact support
v RK_ENTER_SYSTEM_STATE_INVALID
Command is supported in maintenance mode only.Troubleshooting: Switch system state to maintenance mode.
v INVALID_RECOVERY_KEY_STATE
Recovery key state is inconsistent with the option provided.Troubleshooting: Check the recovery key state usingencrypt_recovery_key_status.
v RECOVERY_KEY_ALREADY_VERIFIED
The recovery key has already been verified.Troubleshooting: Check the recovery key state using encrypt_recovery_key_list.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
468 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Generating recovery keysUse the encrypt_recovery_key_generate command to specify which securityadministrators will receive recovery key shares, and to define the minimumnumber of recovery key shares that need to be entered.
encrypt_recovery_key_generate users=Users [ min_req=MinRequired ]
Parameters
Name Type Description Mandatory Default
min_req Integer Minimum numberof requiredsecurityadministratorrecovery keyshares.
N 2
users Object name User names of thesecurityadministrators.
Y N/A
This command is used to specify which security administrator will receiverecovery keys (or, more accurately, "shares"), and to define the minimum numberof recovery keys that need to be entered (using the encrypt_recovery_key_entercommand) in order to unlock the encrypted keys. Once this command has beenentered, all the specified security administrators are expected to retrieve and verifytheir recovery keys, using encrypt_recovery_key_get andencrypt_recovery_key_verify, respectively. This command can only be run whenencryption_state is DISABLED.
Example:
encrypt_recovery_key_generate users=secadmin1,secadmin2,secadmin3,secadmin4 min_req=2
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
Chapter 21. Encryption enablement and support commands 469
v NO_LIVE_KEYSERVER_GATEWAY_NODE
There is no live key server gateway node on the system.Troubleshooting: Please restart the key server gateway node and try again.
v CANNOT_WRITE_TO_KEY_REPOSITORY
Failed writing keys to the key repository.Troubleshooting: Contact support.
v CANNOT_GET_NEW_KEY_REQUEST
Error requesting encryption keys from the key server gateway node.Troubleshooting: Check that the key server is actively serving keys
v KEYSERVER_COMMUNICATION_GENERIC_ERROR
Cannot connect to an active key server.Troubleshooting: Invoke encrypt_keyserver_list and event_list for more details.
v INSUFFICIENT_RK_ADMIN_THRESHOLD
Recovery key creation requires at least two security administrators.Troubleshooting: try again the command with at least 2 security administrators
v ENCRYPTION_KR_WRITE_FAILED
Error writing to the key repository.Troubleshooting: Contact support
v ENCRYPTION_ALREADY_ENABLED
Encryption has already been enabled.Troubleshooting: Check the state_list command
v NO_MASTER_KEYSERVER_DEFINED
There is no master key server defined on the system.Troubleshooting: Please define a master key server by invoking encrypt_keyserver_update and try again.
v INVALID_RECOVERY_KEY_STATE
Recovery key state is inconsistent with the option provided.Troubleshooting: Check the recovery key state usingencrypt_recovery_key_status.
v INSUFFICIENT_RK_ADMINS
Number of users must be greater than or equal to the minimal required number.Troubleshooting: try again the command with at least the minimum number ofrequired users
v CANNOT_GENERATE_KEYS_ON_KEYSERVER_GATEWAY
Failed to generate XMK and hashes on key server gateway node.Troubleshooting: Contact support.
v ENCRYPTION_KR_READ_FAILED
Error reading the key repository.Troubleshooting: Contact support
v CANNOT_UPDATE_KEY_METADATA
Cannot update metadata in key repository for new key.Troubleshooting: Contact support.
470 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Retrieving the security administrator's recovery keyUse the encrypt_recovery_key_get command to retrieve the recovery key sharegenerated for the current user.
encrypt_recovery_key_get
This command retrieves the recovery key generated for the current user (by issuingencrypt_recovery_key_generate or encrypt_recovery_key_rekey) to be stored in asecure manner. After running this command, the user needs to 'prove' that theyhave the key by entering it via the encrypt_recovery_key_verify command. Oncethis is completed successfully, encrypt_recovery_key_get will no longer present theuser's key. Using encrypt_recovery_key_get more than once will return the samevalue again.
Example:
encrypt_recovery_key_get
Output:
Command executed successfully.key=B07C4374AC26C4DD3EC2E755EB3FAAF04EC792C8BE0D0CB1C1BAC79998EBEC6D
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v INVALID_RECOVERY_KEY_USER
User is not a valid recovery key administrator.Troubleshooting: Check that the user names provided are valid
v NO_LIVE_KEYSERVER_GATEWAY_NODE
There is no live key server gateway node on the system.Troubleshooting: Please restart the key server gateway node and try again.
v CANNOT_READ_FROM_KEY_REPOSITORY
Failed reading keys from the key repository.Troubleshooting: Contact support.
v CANNOT_GET_NEW_KEY_REQUEST
Error requesting encryption keys from the key server gateway node.
Chapter 21. Encryption enablement and support commands 471
Troubleshooting: Check that the key server is actively serving keysv KEYSERVER_COMMUNICATION_GENERIC_ERROR
Cannot connect to an active key server.Troubleshooting: Invoke encrypt_keyserver_list and event_list for more details.
v NO_MASTER_KEYSERVER_DEFINED
There is no master key server defined on the system.Troubleshooting: Please define a master key server by invoking encrypt_keyserver_update and try again.
v INVALID_RECOVERY_KEY_STATE
Recovery key state is inconsistent with the option provided.Troubleshooting: Check the recovery key state usingencrypt_recovery_key_status.
v RECOVERY_KEY_ALREADY_VERIFIED
The recovery key has already been verified.Troubleshooting: Check the recovery key state using encrypt_recovery_key_list.
Rekeying the security administratorsUse the encrypt_recovery_key_rekey command to restart the recovery keygeneration process.
encrypt_recovery_key_rekey [ users=Users ] [ min_req=MinRequired ]
Parameters
Name Type Description Mandatory Default
min_req Integer Minimum numberof requiredsecurityadministratorrecovery keyshares.
N 0
users Object name Comma delimitedlist of securityadministrator torekey.
N N/A
This command restarts the recovery key generation process, described in thesection on the encrypt_recovery_key_generate command. The only difference isthat the parameters users and min_required are optional, and will default to thevalues specified in the last call to encrypt_recovery_key_generate. Note that noneof the new recovery keys will take effect until the last user has verified his or herrecovery key. Until then, if recovery is required, the previous keys will remainvalid.
Example:
encrypt_recovery_key_rekey users=secadmin1,secadmin2,secadmin3,secadmin4 min_req=3
Output:
Command completed successfully.
472 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v NO_LIVE_KEYSERVER_GATEWAY_NODE
There is no live key server gateway node on the system.Troubleshooting: Please restart the key server gateway node and try again.
v CANNOT_READ_FROM_KEY_REPOSITORY
Failed reading keys from the key repository.Troubleshooting: Contact support.
v INSUFFICIENT_RK_ADMIN_THRESHOLD
Recovery key creation requires at least two security administrators.Troubleshooting: try again the command with at least 2 security administrators
v ENCRYPTION_KR_WRITE_FAILED
Error writing to the key repository.Troubleshooting: Contact support
v NO_MASTER_KEYSERVER_DEFINED
There is no master key server defined on the system.Troubleshooting: Please define a master key server by invoking encrypt_keyserver_update and try again.
v INVALID_RECOVERY_KEY_STATE
Recovery key state is inconsistent with the option provided.Troubleshooting: Check the recovery key state usingencrypt_recovery_key_status.
v INSUFFICIENT_RK_ADMINS
Number of users must be greater than or equal to the minimal required number.Troubleshooting: try again the command with at least the minimum number ofrequired users
v CANNOT_GENERATE_KEYS_ON_KEYSERVER_GATEWAY
Failed to generate XMK and hashes on key server gateway node.Troubleshooting: Contact support.
v KEYSERVER_COMMUNICATION_GENERIC_ERROR
Cannot connect to an active key server.Troubleshooting: Invoke encrypt_keyserver_list and event_list for more details.
Chapter 21. Encryption enablement and support commands 473
Displaying recovery key statusUse the encrypt_recovery_key_status command to display status information forrecovery keys.
encrypt_recovery_key_status
This command shows status information regarding recovery keys, specifically:Which user has verified his or her recovery key before encrypt_enable or in therecovery key rekey process. When using the recovery key to unlock the disks,which user has entered his or her recovery key. For information about the numberof shares defined and the minimum number required for recovery, issue theencrypt_recovery_key_list command.
Example:
encrypt_recovery_key_status
Output:
Mon Aug 12 20:04:43 IDT 2013Date Created User Status2013-01-03 18:54:46 secadmin1 Verified2013-01-03 18:54:46 secadmin2 Verified2013-01-03 18:54:46 secadmin3 Verified2013-01-03 18:54:46 secadmin4 Verified2013-01-03 19:00:03 secadmin1 Unverified2013-01-03 19:00:03 secadmin2 Unverified2013-01-03 19:00:03 secadmin3 Unverified2013-01-03 19:00:03 secadmin4 Unverified
When entering keys to unlock the disks:Date Created User Status2013-01-03 19:00:03 secadmin1 Accepted2013-01-03 19:00:03 secadmin2 Accepted2013-01-03 19:00:03 secadmin3 Pending2013-01-03 19:00:03 secadmin4 Pending
Field ID Field output Default position
create_date Date Created 1
user User 2
status Status 3
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
474 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v CANNOT_READ_FROM_KEY_REPOSITORY
Failed reading keys from the key repository.Troubleshooting: Contact support.
Recovering key verificationUse the encrypt_recovery_key_verify command to confirm that the current userhas correctly copied the recovery key share retrieved by theencrypt_recovery_key_get command.
encrypt_recovery_key_verify key=Key
Parameters
Name Description Mandatory
key The 64 character hexadecimalrecovery key.
Y
This command is used by security administrators to confirm that they havecorrectly copied the recovery key presented by the encrypt_recovery_key_getcommand. Encryption can be enabled (or a rekey can be completed) only when allsecurity administrators have confirmed their respective recovery keys using thiscommand.
Example:
encrypt_recovery_key_verifykey=B07C4374AC26C4DD3EC2E755EB3FAAF04EC792C8BE0D0CB1C1BAC79998EBEC6D
Output:
Command executed successfully.
Access control
User Category Permission
Storage administrator Disallowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.
Chapter 21. Encryption enablement and support commands 475
Troubleshooting: Contact support to verify encryption status.v INVALID_RECOVERY_KEY_FRAGMENT
Recovery key fragment given does not match stored key.Troubleshooting: Verify that the proper key(share) has been used
v GENERIC_FAILED
Generic encryption failure.Troubleshooting: Contact support.
v INVALID_RECOVERY_KEY_USER
User is not a valid recovery key administrator.Troubleshooting: Check that the user names provided are valid
v CANNOT_READ_FROM_KEY_REPOSITORY
Failed reading keys from the key repository.Troubleshooting: Contact support.
v RK_FAILED_VERIFY_SLEEP
Too many failed verify attempts, please wait and try again.Troubleshooting: Wait a little and try again.
v ENCRYPTION_KR_WRITE_FAILED
Error writing to the key repository.Troubleshooting: Contact support
v INVALID_RECOVERY_KEY_STATE
Recovery key state is inconsistent with the option provided.Troubleshooting: Check the recovery key state usingencrypt_recovery_key_status.
v RECOVERY_KEY_ALREADY_VERIFIED
The recovery key has already been verified.Troubleshooting: Check the recovery key state using encrypt_recovery_key_list.
Recovering key share informationUse the encrypt_recovery_key_list command to list recovery key shareinformation.
encrypt_recovery_key_list
This command lists information regarding recovery keys, specifically: How manyparts was the recovery key shared across, and how many are needed for therecovery process. When the currently valid recovery keys were created. To retrieveper-user information about the status of each key share, use theencrypt_recovery_key_status command.
Example:
encrypt_recovery_key_list
Output:
476 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Recovery Key Initial Generation:
Date created Number of Shares Min Required------------ ---------------- ------------2013-03-11 16:00 3 2
Recovery Key Rekeyed:Date created Number of Shares Min Required------------ ---------------- ------------2013-03-11 16:00 3 22013-03-20 16:05 4 2
Field ID Field output Default position
create_date Key Created 1
number_of_shares Number of Shares 2
min_req Min Required 3
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Allowed
Technicians Allowed
Return codesv UNSUPPORTED_HARDWARE
Cannot utilize encryption on unsupported hardware.Troubleshooting: Contact support to verify encryption status.
v CANNOT_READ_FROM_KEY_REPOSITORY
Failed reading keys from the key repository.Troubleshooting: Contact support.
Finishing the recovery processUse the encrypt_recovery_finish command to finish the recovery process andmove the system to the On state.
encrypt_recovery_finish
Upon entering the recovery keys (see Entering a recovery key), this commandfinishes the recovery process and moves the system to the On state, provided thatno more issues exist.
Example:
encrypt_recovery_finish
Output:
Chapter 21. Encryption enablement and support commands 477
Command executed successfully.
Access control
User Category Permission
Storage administrator Allowed
Storage integration administrator Disallowed
Application administrator Disallowed
Security administrator Allowed
Read-only users Disallowed
Technicians Disallowed
Return codesv ENCRYPT_NOT_ENABLED
Encryption is not enabled.Troubleshooting: Check that encryption is enabled and try again the command.
v RK_ENTER_SYSTEM_STATE_INVALID
Command is supported in maintenance mode only.Troubleshooting: Switch system state to maintenance mode.
v DATA_REDUCTION_TIER_IS_OFFLINE
Data reduced tier is offline, operation is not allowedTroubleshooting: Wait for data reduction recovery to start and recover thecompression objects
478 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 22. Events
This section contains detailed information on CLI events, including their severityand descriptions.
VOLUME_CREATE
Severity Description
informational Volume was created with name 'volume.name' andsize volume.sizeGB in Storage Pool with name'volume.pool_name'.
VOLUME_CREATE_MANY
Severity Description
informational number Volumes was created with names: 'names'in Storage Pool with name 'pool.name'.
VOLUME_CREATE_FAILED_TOO_MANY
Severity Description Troubleshooting
warning Volume with name 'name' couldnot be created. You areattempting to add more volumesthan the system permits.
Delete volumes to allow newones to be created.
VOLUME_RENAME
Severity Description
informational Volume with name 'old_name' and was renamed'volume.name'.
VOLUME_RESIZE
Severity Description
informational Volume with name 'volume.name' was resized fromold_sizeGB to volume.sizeGB.
VOL_SET_EXTERNAL_ID
Severity Description
informational Volume with name 'volume.name' changed theexternal identifier to 'volume.identifier'.
VOL_CLEAR_EXTERNAL_ID
Severity Description
informational Volume with name 'volume.name' cleared theexternal identifier.
© Copyright IBM Corp. 2016 479
SECONDARY_VOLUME_RESIZE
Severity Description
informational Secondary volume with name 'volume.name' wasresized by primary machine from old_sizeGB tovolume.sizeGB.
VOLUME_DELETE
Severity Description
informational Volume with name 'volume.name' was deleted andits data is no longer accessible.
VOLUME_FORMAT
Severity Description
informational Volume with name 'volume.name' was formatted.
VOLUME_COPY
Severity Description
informational Volume with name 'source.name' was copied tovolume with name 'target.name'.
VOLUME_COPY_DIFF
Severity Description
informational Volume with name 'source.name' was diff-copiedfrom base 'base.name' to volume with name'target.name'.
VOLUME_LOCK
Severity Description
informational Volume with name 'volume.name' was locked andset to 'read-only'.
VOLUME_UNLOCK
Severity Description
informational Volume with name 'volume.name' was unlockedand set to 'writable'.
VOLUME_MOVE
Severity Description
informational Volume with name 'volume.name' has been movedfrom Storage Pool 'orig_pool.name' to Pool'pool.name'.
480 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
DATA_REBUILD_STARTED
Severity Description
informational Rebuild process started because system data is notprotected. data_percent% of the data must berebuilt.
DATA_REBUILD_COMPLETED
Severity Description
informational Rebuild process completed. System data is nowprotected.
DATA_REDIST_STARTED
Severity Description
informational Starting data transfer to new disks.
DATA_REDIST_COMPLETED
Severity Description
informational Completed data transfer to new disks.
DATA_REBUILD_COMPLETED_REDIST_STARTED
Severity Description
informational Rebuild process completed. System data is nowprotected. Starting data transfer to new disks.
STORAGE_POOL_EXHAUSTED
Severity Description Troubleshooting
major Pool 'pool' is full. All volumes arelocked.
Enlarge Storage Pool or move ordelete volumes or Clones withClone Deletion Priority 0.
STORAGE_POOL_UNLOCKED
Severity Description
major Pool 'pool' has empty space. All volumes areunlocked.
STORAGE_POOL_VOLUME_USAGE_INCREASED
Severity Description
variable Usage by volumes of Storage Pool with name'pool.name' has reached current%.
Chapter 22. Events 481
STORAGE_POOL_VOLUME_USAGE_DECREASED
Severity Description
informational Usage by volumes of Storage Pool with name'pool.name' has decreased to current%.
STORAGE_POOL_VOLUME_USAGE_TOO_HIGH
Severity Description Troubleshooting
major Usage by volumes of StoragePool with name 'pool.name' hasreached current% of the totalpool size.
Increase pool size or decreasesnapshot size.
STORAGE_POOL_VOLUME_USAGE_BACK_TO_NORMAL
Severity Description
informational Usage by volumes of Storage Pool with name'pool.name' is back to normal with current% of thetotal pool size.
STORAGE_POOL_SNAPSHOT_USAGE_INCREASED
Severity Description
variable Usage by snapshots of Storage Pool with name'pool.name' has reached current%.
STORAGE_POOL_SNAPSHOT_USAGE_DECREASED
Severity Description
informational Usage by snapshots of Storage Pool with name'pool.name' has decreased to current%.
HOST_CONNECTED
Severity Description
informational Host 'host' has connected to the system.
HOST_DISCONNECTED
Severity Description
warning Host 'host' has disconnected from the system.
HOST_MULTIPATH_OK
Severity Description
informational Host 'host' has redundant connections to thesystem. #paths=npaths
482 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
HOST_NO_MULTIPATH_ONLY_ONE_PORT
Severity Description
warning Host 'host' is connected to the system throughonly one of its ports. #paths=npaths
HOST_NO_MULTIPATH_ONLY_ONE_MODULE
Severity Description
informational Host 'host' is connected to the system throughonly one interface module. #paths=npaths
SYSTEM_CAPACITY_USAGE_INCREASED
Severity Description
variable Usage of system physical capacity increased tocurrent%.
SYSTEM_CAPACITY_USAGE_DECREASED
Severity Description
informational Usage of system physical capacity decreased tocurrent%.
POOL_CREATE
Severity Description
informational Storage Pool of size pool.sizeGB was created withname 'pool.name'.
POOL_CREATE_FAILED_TOO_MANY
Severity Description Troubleshooting
warning Storage Pool with name 'name'could not be created. You areattempting to add more StoragePools than the system permits.
Delete Storage Pools to allownew ones to be created.
POOL_RENAME
Severity Description
informational Storage Pool with name 'old_name' was renamed'pool.name'.
POOL_RESIZE
Severity Description
informational Storage Pool with name 'pool.name' was resizedfrom size old_sizeGB to pool.sizeGB.
Chapter 22. Events 483
POOL_RESIZE_SNAPSHOTS
Severity Description
informational Snapshot size of Storage Pool with name'pool.name' was resized from size old_sizeGB topool.snapshot_sizeGB.
POOL_CHANGE_LOCK_BEHAVIOR
Severity Description
informational Lock Behavior of Storage Pool with name'pool.name' is now 'state'.
POOL_CHANGE_PERF_CLASS
Severity Description
informational Performance Class of Storage Pool with name'pool.name' is now 'pool.perf_class'.
POOL_CONFIG_SNAPSHOTS
Severity Description
informational Management policy of Mirroring snapshots ofStorage Pool with name 'pool.name' has changed'.
POOL_DELETE
Severity Description
informational Storage Pool with name 'pool.name' was deleted.
FLASH_VDISK_TOO_SMALL
Severity Description
critical Flash vdisk name on Flash Enclosure is too small.
FLASH_VDISK_LARGER_THAN_EXPECTED
Severity Description
warning Flash vdisk name on Flash Enclosure is larger thanexpected.
DATA_REDUCTION_TIER_IS_OFFLINE
Severity Description
major Data reduction tier moved to offline mode
DATA_REDUCTION_RECOVERY_STARTED
Severity Description
Informational Data reduction recovery process started
484 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
DATA_REDUCTION_RECOVERY_FINISHED
Severity Description
Informational Data reduction recovery process ended
DATA_REDUCTION_RECOVERY_FAILED
Severity Description
Minor Data reduction recovery process failed withreason: 'reason'
DATA_REDUCTION_RECOVERY_ABORT_STARTED
Severity Description
Informational Data reduction recovery abort started
DATA_REDUCTION_RECOVERY_ABORT_FINISHED
Severity Description
Informational Data reduction recovery abort finished
DATA_REDUCTION_TIER_IS_ONLINE
Severity Description
informational Data reduction tier moved to online state
DATA_REDUCTION_TIER_BECOMING_OFFLINE
Severity Description
major Data reduction tier is transitioning to offline mode
DATA_REDUCTION_RESUME_ONLINE_START
Severity Description
informational Data reduction is resuming from offline mode
DATA_REDUCTION_RESUME_ONLINE_FAILED
Severity Description
warning Data reduction failed resuming from offline mode
DATA_REDUCTION_COMPRESSION_ADAPTER_FAILED
Severity Description
Major Data Reduction node reporting_node reportedabout compression adapter failure and will bekilled.
Chapter 22. Events 485
FLASH_COMPONENT_INITIALIZING
Severity Description Troubleshooting
informational Flash Component ID initializing. Please contact support.
FLASH_COMPONENT_OK
Severity Description Troubleshooting
informational Flash Component ID status ok. Please contact support.
FLASH_COMPONENT_FAILED
Severity Description Troubleshooting
minor Flash Component ID has failed. Please contact support.
FLASH_COMPONENT_REPLACED
Severity Description Troubleshooting
minor Component ID replaced. Newserial New Serial Old serial OldSerial
Please contact support.
FLASH_COMPONENT_FW_CHANGED
Severity Description Troubleshooting
minor Component ID fw changed. New:New FW Old: Old FW
Please contact support.
FLASH_COMPONENT_FRU_PART_NUM_CHANGED
Severity Description Troubleshooting
minor Component ID fru numberchanged. New:New FRU. Old:OldFRU
Please contact support.
FLASH_FW_HOT_UPGRADE_STARTED
Severity Description
informational Start upgrade to version version. Enclosure idcomponent id
FLASH_FW_HOT_UPGRADE_FINISHED
Severity Description
informational Finished upgrade to version version. Enclosure idcomponent id
FLASH_UPGRADE_RESUMED
Severity Description
informational Finished upgrade resumed. Enclosure idcomponent id
486 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
FLASH_UPGRADE_STOPPED
Severity Description
major Flash upgrade stopped after percents%, reason:reason. Enclosure id component id
FLASH_FW_HOT_UPGRADE_FAILED
Severity Description
major Flash firmware hot upgrade failed, reason: reason.Enclosure id component id
FLASH_FW_HOT_UPGRADE_TIMEOUT
Severity Description
informational Timeout while upgrading component id, progress:percents
FLASH_RAID_STATUS_CHANGED
Severity Description
informational Raid status changed to status. Enclosure idcomponent id.
FLASH_ENCRYPTION_STATUS_CHANGED
Severity Description
informational Encryption enabled changed to encrypted.Enclosure id component id.
FLASH_BBU_CHARGING_STATUS_CHANGED
Severity Description
informational BBU charging status changed to status. BBU idcomponent id.
FLASH_BBU_CALIBRATION_STARTED
Severity Description
informational BBU calibration started, BBU id component id.
FLASH_BBU_CALIBRATION_STOPPED
Severity Description
informational BBU calibration stopped, BBU id component id.
Chapter 22. Events 487
FLASH_BBU_CALIBRATION_FAILED
Severity Description
informational BBU calibration failed, BBU id component id.
FLASH_CANISTER_CONNECTED_VIA_SERIAL_CABLE
Severity Description
informational Establish serial connection with component id.
NO_CONNECTION_TO_FLASH_CANISTER_VIA_SERIAL
Severity Description Troubleshooting
warning Fail to connect component id viaserial.
Please contact support
FLASH_ENCLOSURE_TIME_UPDATE_FAILED
Severity Description
warning Failed to update time on component id.
FLASH_ENCLOSURE_TIME_IS_SYNCED
Severity Description Troubleshooting
informational Time is updated on component id. Please contact support
NO_CONNECTION_TO_FLASH_CANISTER_VIA_ETH
Severity Description Troubleshooting
warning Fail to connect component id viaethernet.
Please contact support
FLASH_CANISTER_IP_CHANGED
Severity Description Troubleshooting
informational Change connected ip ofcomponent id to IP.
Please contact support
NO_CONNECTION_TO_FLASH_CANISTER_VIA_GW
Severity Description Troubleshooting
warning Fail to connect component id viamodule id.
Please contact support
FLASH_CANISTER_CONNECTED_VIA_GATEWAY
Severity Description Troubleshooting
informational Establish connection tocomponent id via module id.
Please contact support
488 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
FLASH_CANISTER_MCL_CONNECTION_FAILED
Severity Description Troubleshooting
warning Failed to establish MCLconnection to component id.
Please contact support
FLASH_CANISTER_MCL_CONNECTION_OK
Severity Description Troubleshooting
informational Establish new MCL connectionto component id.
Please contact support
FLASH_CANISTER_ETH_LINK_MISWIRE
Severity Description Troubleshooting
warning Flash canister component id ismiswired.
Please contact support
FLASH_CANISTER_ETH_LINK_WIRING_OK
Severity Description Troubleshooting
informational Flash canister component id is nolonger miswired.
Please contact support
FLASH_CANISTER_GET_CONF_FAILED
Severity Description Troubleshooting
warning Failed to get the configurationfrom component id.
Please contact support
FLASH_ENCLOSURE_GET_CONF_FAILED
Severity Description Troubleshooting
warning Failed to get the configurationfrom both canisters of componentid.
Please contact support
FLASH_CANISTER_GET_CONF_OK
Severity Description Troubleshooting
informational Succeeded to get theconfiguration from component id.
Please contact support
FLASH_ENCLOSURE_GET_CONF_OK
Severity Description Troubleshooting
informational Succeeded to get theconfiguration of component id.
Please contact support
Chapter 22. Events 489
FLASH_CANISTER_IN_SERVICE_MODE
Severity Description Troubleshooting
major Flash canister in service modeservice, canister: component id.
Please contact support
FLASH_CANISTER_NO_LONGER_IN_SERVICE_MODE
Severity Description
informational Flash canister is no longer in service mode:component id.
FLASH_COMPONENT_TEMPERATURE_OK
Severity Description
informational Flash component component id temperature iswithin allowed limits.
FLASH_COMPONENT_TEMPERATURE_ABOVE_NORMAL
Severity Description
warning Flash component component id temperature isabove normal.
FLASH_COMPONENT_TEMPERATURE_HIGH
Severity Description
major Flash component component id temperature ishigh, it exceeds operational level.
FLASH_COMPONENT_TEMPERATURE_CRITICALLY_HIGH_SHUTTING_DOWN
Severity Description
critical Flash component component id temperature iscritical. Shutting down the Flash Enclosure.
FLASH_COMPONENT_LED_ON
Severity Description
major Flash component component id led name is on.
FLASH_COMPONENT_LED_OFF
Severity Description
major Flash component component id led name is off.
490 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
FLASH_PASSTHROUGH_EVENT
Severity Description Troubleshooting
informational Flash event for component id.service_type: 'service type' ,Failure: 'failure', Reason: 'reason',Event: 'event_code'
Used by FlashSystems
FLASH_PASSTHROUGH_EVENT_DEACTIVATE
Severity Description Troubleshooting
informational Flash event 'event_code' forcomponent id Not active.
Used by FlashSystems
FLASH_ENCLOSURE_STATUS_CHANGED
Severity Description Troubleshooting
informational component id status changed toNew Status.
Please contact support.
FLASH_PSU_FAN_FAILED
Severity Description
minor component id fan has failed.
FLASH_PSU_FAN_OK
Severity Description
informational component id fan status ok.
FLASH_PSU_HAS_NO_INPUT_POWER
Severity Description
warning PSU power supply has no input (AC) power. PSUid component id.
FLASH_PSU_HAS_INPUT_POWER
Severity Description
informational PSU power supply has input (AC) power. PSU idcomponent id.
FLASH_ENCLOSURE_VERSION_IS_UNEXPECTED
Severity Description
major component id version is version, expected version isexpected.
FLASH_PSU_COMMUNICATION_ERROR
Severity Description
informational PSU communication error. PSU id component id.
Chapter 22. Events 491
FLASH_BBU_VPD_IS_NOT_VALID
Severity Description
major BBU VPD is not valid. BBU id component id.
FLASH_CANISTER_INTERNAL_ERROR
Severity Description
warning Canister has internal error. Canister id componentid.
FLASH_CARD_UNSUPPORTED
Severity Description
informational Flash card is unsupported. Flash card idcomponent id.
FLASH_CARD_HEALTH_LOW
Severity Description
warning Flash card health is low. Flash card id componentid.
FLASH_BBU_END_OF_LIFE
Severity Description
informational Battery is at end of life. BBU id component id.
FLASH_CARD_COMMUNICATION_ERROR
Severity Description
informational Flash card communication error. Flash card idcomponent id.
FLASH_FAN_COMMUNICATION_ERROR
Severity Description
informational FAN communication error. Fan id component id.
FLASH_ENCLOSURE_THERMAL_THREASHOLD_EXCEEDED
Severity Description
critical Flash enclosure component id shutdown due tothermal threshold exceeding.
492 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
FC_PORT_HAS_FAILED
Severity Description Troubleshooting
major FC port service port has faileddue to code (attempt numberNumber of retries)
Please contact support.
NTP_SERVER_TIME_DIFFERENCE_TOO_BIG
Severity Description Troubleshooting
warning NTP server NTP Server sent atransaction with time differenceof Delta seconds which exceedsthe maximal difference of MaxAllowed seconds. Transaction willbe ignored, please check NTPserver's and system's times.
Please contact yourAdministrator.
IPSEC_TUNNEL_OPENED
Severity Description
informational The IPSec tunnel named 'name' between moduleModule and Right IP was opened
IPSEC_TUNNEL_CLOSED
Severity Description
informational The IPSec tunnel named 'name' between moduleModule and Right IP was closed
IP_ACCESS_CANNOT_RESOLVE_ADDRESS
Severity Description
informational Cannot resolve address 'address' added to the IPaccess group IP access group name.
IP_ACCESS_FAILED_SETTING_RULES
Severity Description
informational Failed setting IP access rules.
MIRROR_CREATE
Severity Description
informational A remote mirror was defined for Volume 'localvolume name'on Target 'target name'. RemoteVolume is 'remote volume name'.
CG_MIRROR_CREATE
Severity Description
informational A remote mirror was defined for ConsistencyGroup 'local CG name'on Target 'target name'.Remote Consistency Group is 'remote CG name'.
Chapter 22. Events 493
MIRROR_CREATE_SLAVE
Severity Description
informational A remote mirror was defined by Target 'targetname' for Volume 'local volume name'. RemoteVolume is 'remote volume name'.
CG_MIRROR_CREATE_SLAVE
Severity Description
informational A remote mirror was defined by Target 'targetname' for CG 'local CG name'. Remote CG is 'remoteCG name'.
MIRROR_SCHEDULE_CHANGE
Severity Description
informational Schedule of remote mirror of 'local peer name' isnow 'schedule name'.
MIRROR_CREATE_FAILED_TARGET_NOT_CONNECTED
Severity Description Troubleshooting
warning Target could not be reached.Target with name 'target.name' iscurrently not connected.
Connect the target system to thissystem.
REMOTE_OPERATION_FAILED_TIMED_OUT
Severity Description Troubleshooting
warning Operation on remote machinetimed out. Invoking 'FunctionName' on target 'Target Name'timed out.
Retry operation. If problempersists contact support.
MIRROR_RESYNC_FAILED
Severity Description Troubleshooting
major Synchronization of meta datawith mirror failed. Configurationof remote mirror of volume 'localvolume name' on target 'targetname' does not match localconfiguration.
Make sure configuration on bothmachines is compatible andactivate the mirror. If problempersists contact support.
MIRROR_RESYNC_FAILED_DUE_TO_THIN_PROVISIONING
Severity Description Troubleshooting
major Synchronization of bitmaps withmirror failed. Not enough hardcapacity left in Pool of volume'mirror.local_volume_name'.
Delete unnecessary volumes inpool or enlarge the pool's hardsize.
494 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
MIRROR_SYNC_STARTED
Severity Description
informational Synchronization of remote mirror of volume 'localvolume name' on Target 'target name' has started.
MIRROR_SYNC_ENDED
Severity Description
informational Synchronization of remote mirror of peer 'localpeer name' on target 'target name' has ended.
MIRROR_CANNOT_CREATE_SYNC_JOB_TOO_MANY_VOLUMES
Severity Description
major Synchronization of remote mirror of peer 'localpeer name' on target 'target name' can not be synced, insufficent volume available for this operation.
MIRROR_CANNOT_CREATE_LRS_TOO_MANY_VOLUMES
Severity Description
major Synchronization of remote mirror of peer 'localpeer name' on target 'target name' can not be synced, insufficent volume available for this operation.
MIRROR_REESTABLISH_FAILED_CONFIGURATION_ERROR
Severity Description Troubleshooting
major Mirror reestablish failed. Eitherconfiguration of remote mirrorof peer 'local peer name' on target'target name' does not match localconfiguration.
Make sure configuration on bothmachines is compatible andactivate the mirror. If problempersists contact support.
MIRROR_ACTIVATE
Severity Description
informational The Remote Mirror of peer 'local peer name' onTarget 'target name' was activated.
MIRROR_DEACTIVATE
Severity Description
informational The Remote Mirror of peer 'local peer name' onTarget 'target name' was deactivated.
MIRROR_DEACTIVATE_SECONDARY_LOCKED
Severity Description
minor The Remote Mirror of peer 'local peer name' onTarget 'target name' was deactivated since the Poolon the secondary machine was locked.
Chapter 22. Events 495
MIRROR_DEACTIVATE_CONFIGURATION_ERROR
Severity Description
minor The Remote Mirror of peer 'local peer name' onTarget 'target name' was deactivated since theMirror configuration on the slave machine haschanged.
MIRROR_DELETE
Severity Description
informational The Remote Mirror relation of peer 'local peername' to a peer on Target 'target name' was deleted.
MIRROR_REVERSE_ROLE_TO_SLAVE
Severity Description
informational Local peer 'local peer name' is now Slave of a peeron Target 'target name'.
MIRROR_REVERSE_ROLE_TO_MASTER
Severity Description
informational Local peer 'local peer name' is now Master of a peeron Target 'target name'.
MIRROR_REVERSE_ROLE_OF_PEER_WITH_LCS_TO_MASTER
Severity Description
informational Local peer 'local peer name' is now Master of a peeron Target 'target name' external last consistentsnapshot should be deleted manually .
MIRROR_SWITCH_ROLES_TO_SLAVE
Severity Description
informational Local peer 'local peer name' switched roles withpeer on Target 'target name'. It is now Slave.
MIRROR_SWITCH_ROLES_TO_MASTER
Severity Description
informational Local peer 'local peer name' switched roles withpeer on Target 'target name'. It is now Master.
MIRROR_REESTABLISH_FAILED_TOO_MANY_VOLUMES
Severity Description Troubleshooting
major Last Consistent Snapshot ofSlave peer 'local peer name' couldnot be created. Maximal numberof Volumes are already defined.
Delete Volumes to allow newones to be created. ActivateMirror on the Master Machine.
496 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
MIRROR_END_SYNC_FAILED_CONFIGURATION_ERROR
Severity Description Troubleshooting
major Configuration of remote mirrorof peer 'local peer name' on target'target name' does not match localconfiguration.
Make sure configuration on bothmachines is compatible andactivate the mirror. If problempersists contact support.
MIRROR_CHANGE_DESIGNATION
Severity Description
informational Local peer 'local peer name' switched its designatedrole with peer on Target 'target name'. It is nowdesignation.
MIRROR_CANCEL_SNAPSHOT
Severity Description
informational All mirrored snapshots which were created forMirror of peer 'local peer name' and were not yetsynchronized will not be mirrored in the remotemachine.
DM_DEFINE
Severity Description
informational Data Migration was defined to Volume 'localvolume name' from Target 'target name'.
DM_SYNC_STARTED
Severity Description
informational Migration to volume 'local volume name' fromTarget 'target name' has started.
DM_SYNC_ENDED
Severity Description
informational Migration to volume 'local volume name' fromtarget 'target name' is complete.
DM_SYNC_ENDED_WITH_ERRORS
Severity Description
Critical Migration to volume 'local volume name' fromtarget 'target name' has completed withmedium_errors_in_data_migration error(s). Checkprevious events related to this volume for the listof affected LBAs.'.
Chapter 22. Events 497
DM_ACTIVATE
Severity Description
informational Migration to Volume 'local volume name' fromTarget 'target name' was activated.
DM_DEACTIVATE
Severity Description
informational Migration to Volume 'local volume name' fromTarget 'target name' was deactivated.
DM_DEACTIVATE_LUN_UNAVAILABLE
Severity Description
minor Migration to Volume 'local volume name' fromTarget 'target name' was deactivated since LUN isnot available on one of the active paths to thetarget.
DM_DELETE
Severity Description
informational Definition of Data Migration to Volume 'localvolume name' from Target 'target name' was deleted.
SCHEDULE_CREATE
Severity Description
informational Schedule was created with name 'schedule name'.
SCHEDULE_UPDATE
Severity Description
informational Schedule with name 'schedule name' was updated.
SCHEDULE_RENAME
Severity Description
informational Schedule with name 'old_name' was renamed'schedule name'.
SCHEDULE_DELETE
Severity Description
informational Schedule with name 'schedule name' was deleted.
MIRROR_RPO_OK
Severity Description
informational Mirror of local peer 'local peer name' is now aheadof its specified RPO.
498 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
MIRROR_RPO_LAGGING
Severity Description
informational Mirror of local peer 'local peer name' is now behindits specified RPO.
MIRROR_CHANGE_RPO
Severity Description
informational RPO or Mirror of local peer 'local peer name' isnow RPO.
MIRROR_IS_LAGGING_BEYOND_PERCENT_THRESHOLD
Severity Description
warning Last Replication Time of Mirror of local peer 'localpeer name' is Last Replication Time.
MIRROR_AUTO_FIX_REACHED_LIMIT
Severity Description
warning A remote checksum diff for mirror 'local peer name'cannot be fixed automatically because we reachedthe auto fix limit.
MIRROR_IS_LAGGING_BEYOND_ABSOLUTE_THRESHOLD
Severity Description
warning Last Replication Time of Mirror of local peer 'localpeer name' is Last Replication Time.
MIRROR_INCOMPATIBLE_VERSION_FOR_UNMAP_SUPPORT
Severity Description
warning Mirror of peer 'local peer name' on target 'targetname' cannot support unmap, remote machine hasincompatible version.
XMIRROR_DEFINE
Severity Description
informational A xmirror master 'xmirror name' was defined forvolume 'local volume name'.
XMIRROR_DEFINE_SLAVE
Severity Description
informational A xmirror slave 'xmirror name' was defined forvolume 'local volume name'.
Chapter 22. Events 499
XMIRROR_DEFINE_SMASTER
Severity Description
informational A xmirror smaster 'xmirror name' was defined forvolume 'local volume name'.
XMIRROR_ACTIVATE
Severity Description
informational Xmirror 'xmirror name' was activated.
XMIRROR_DEACTIVATE
Severity Description
informational Xmirror 'xmirror name' was deactivated.
XMIRROR_DELETE
Severity Description
informational Xmirror 'xmirror name' was deleted.
XMIRROR_CHANGE_SLAVE_ROLE_TO_MASTER
Severity Description
informational Xmirror 'xmirror name' was changed to standalone.
XMIRROR_CHANGE_MASTER_ROLE_TO_SLAVE
Severity Description
informational Xmirror 'xmirror name' was changed to slave.
XMIRROR_CHANGE_SMASTER_ROLE_TO_MASTER
Severity Description
informational Xmirror 'xmirror name' was changed to master.
XMIRROR_CHANGE_MASTER_ROLE_TO_SMASTER
Severity Description
informational Xmirror 'xmirror name' was changed to smaster.
XMIRROR_STANDBY_MIRROR_REGISTERED
Severity Description
informational Xmirror 'xmirror name' registered a standby mirroron SMASTER system
500 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
XMIRROR_COMPROMISED
Severity Description
warning Xmirror 'xmirror name' is compromised, reason:Compromise Reason
XMIRROR_RESTORED
Severity Description
informational Xmirror 'xmirror name' restored after beingcompromised
XMIRROR_RENAMED
Severity Description
informational Xmirror 'Old Xmirror Name' was renamed to'xmirror name'.
MAP_VOLUME
Severity Description
informational Volume with name 'volume.name' was mapped toLUN 'LUN' for host_or_cluster with name 'host'.
UNMAP_VOLUME
Severity Description
informational Volume with name 'volume.name' was unmappedfrom host_or_cluster with name 'host'.
SPECIAL_TYPE_SET
Severity Description
informational Type of host_or_cluster with name 'host' was set to'type'.
SERVICE_HAS_FAILED
Severity Description Troubleshooting
major Component ID has failed. Please contact support.
SERVICE_FAILED_TO_PHASEIN
Severity Description Troubleshooting
major Component ID failed to phase-in. Please contact support.
SERVICE_FAILED_TO_RESTART
Severity Description Troubleshooting
major Component ID failed to restart. Please contact support.
Chapter 22. Events 501
MODULE_FAILED
Severity Description Troubleshooting
critical Component ID failed. Please contact support.
DISK_HAS_FAILED
Severity Description Troubleshooting
variable Disk Component ID Failed. Please contact yourAdministrator.
SSD_HAS_FAILED
Severity Description Troubleshooting
major SSD Component ID Failed. Please contact yourAdministrator.
COMPONENT_TEST_OF_DISK_HAS_FAILED
Severity Description Troubleshooting
major Test of Component ID has failedwith error Error.
Please contact yourAdministrator.
COMPONENT_TEST_OF_SSD_HAS_FAILED
Severity Description Troubleshooting
major Test of Component ID has failedwith error Error.
Please contact yourAdministrator.
COMPONENT_TEST_OF_BOOT_MEDIA_HAS_FAILED
Severity Description Troubleshooting
major Test of Component ID has failedwith error Error.
Please contact yourAdministrator.
DISK_STARTED_PHASEOUT
Severity Description
informational System started phasing out Component ID.
DISK_STARTED_PHASEIN
Severity Description
informational System started phasing in Component ID.
DISK_FINISHED_PHASEIN
Severity Description
informational System finished phasing in Component ID.
502 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
DISK_FINISHED_PHASEOUT
Severity Description
informational System finished phasing out Component ID.
DISK_RECOVERED
Severity Description
critical Disk Component ID is functioning again.
MODULE_STARTED_PHASEOUT
Severity Description
informational System started phasing out Component ID.
MODULE_FINISHED_PHASEOUT
Severity Description
informational System finished phasing out Component ID.
MODULE_STOPPED_PHASEOUT_DUE_TO_MANAGEMENT_REQUIREMENT
Severity Description
major System stopped phasing out Component ID due tomanagement requirement.
START_WORK
Severity Description
informational System has entered ON state.
SYSTEM_HAS_ENTERED_MAINTENANCE_MODE
Severity Description
warning System has entered MAINTENANCE state[Reason]
SYSTEM_LEFT_CHARGING_STATE
Severity Description
informational System is sufficiently charged.
USER_SHUTDOWN
Severity Description
major System is shutting down due to a user request.
Chapter 22. Events 503
EMERGENCY_SHUTDOWN_NOW
Severity Description Troubleshooting
critical System is shutting down inemergency shutdown mode dueto: Emergency Shutdown Reason.
Please contact yourAdministrator.
SHOULD_HAVE_BEEN_EMERGENCY_SHUTDOWN
Severity Description
critical An emergency shutdown has been detected, butemergency shutdown is disabled for the detectedreason. Shutdown reason: Shutdown Reason.
DATA_SERVICE_STARTED_PHASEOUT
Severity Description
informational System started phasing out Component ID.
DATA_SERVICE_STARTED_PHASEIN
Severity Description
informational System started phasing in Component ID.
DATA_SERVICE_FINISHED_PHASEIN
Severity Description
informational System finished phasing in Component ID.
DATA_SERVICE_FINISHED_PHASEOUT
Severity Description
informational System finished phasing out Component ID.
TXN_REBUILD_STARTED
Severity Description
informational Start rebuild process of txns.
TXN_REBUILD_ENDED
Severity Description
informational End rebuild process for txns.
TXN_REDIST_STARTED
Severity Description
informational Start redist process for txns.
504 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
TXN_REDIST_ENDED
Severity Description
informational End redist process for txns.
DISK_MARKED_TO_PHASEOUT
Severity Description
informational System started phasing out Component ID.
DISK_MARKED_TO_PHASEIN
Severity Description
informational System started phasing out Component ID.
CANNOT_CREATE_NEW_DATA_DISTRIBUTION
Severity Description
informational System cannot phaseout disks for storage mediumStorage Medium.
DATA_PROTECTION_STATUS_CHANGED
Severity Description
major Data protection status has changed from'old_status' to 'new_status'
VAULT_DEVICE_SECURE_ERASE_PROCESS_SUCCESSFUL
Severity Description
informational Vault device secure erase process successful.
VAULT_DEVICE_SECURE_ERASE_PROCESS_FAILED
Severity Description
major Vault device secure erase process failed [Reason]
VAULT_DEVICE_FAILED_SECURE_ERASE
Severity Description
major Secure erase for Component ID failed. [Reason].
SYSTEM_PHYSICAL_CAPACITY_CHANGED
Severity Description
informational System physical capacity is now CapacityGB.
Chapter 22. Events 505
SYSTEM_EFFECTIVE_CAPACITY_CHANGED
Severity Description
informational System effective capacity is now CapacityGB.
SYSTEM_EFFECTIVE_CAPACITY_LIMIT_CHANGED
Severity Description
informational System effective capacity limit is now CapacityGB.
SYSTEM_OUT_OF_PHYSICAL_SPACE
Severity Description
critical System has run out of physical capacity. Allvolumes are now write-protected.
SYSTEM_NORMAL_OPERATION_RESUMED
Severity Description
informational Normal operation is resumed. Volumes have beenrestored to their original write-protection state.
ENCRYPT_ENABLE_STARTED
Severity Description
informational Starting disk encryption activation. This processcan take several minutes to complete.
ENCRYPT_ENABLE_COMPLETED
Severity Description
informational Disk encryption is in effect.
ENCRYPT_ENABLE_NOT_COMPLETED
Severity Description Troubleshooting
major Cannot complete encryptionactivation. Count vault device(s)and Count flash enclosure(s)could not be enrolled.
Please contact technical support
ENCRYPT_DISABLE_STARTED
Severity Description
informational Starting disk encryption deactivation process.
ENCRYPT_DISABLE_COMPLETED
Severity Description
informational Disk encryption is no longer in effect.
506 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
ENCRYPT_DISABLE_NOT_COMPLETED
Severity Description Troubleshooting
major Cannot complete encryptiondeactivation. Count vaultdevice(s) and Count flashenclosure(s) could not be cryptoerased.
Please contact technical support
ENCRYPT_KEYSERVER_ADDED
Severity Description
informational A key server named 'Key Server Name' was added.
ENCRYPT_KEYSERVER_DELETED
Severity Description
informational Key server 'Key Server Name' was deleted.
ENCRYPT_KEYSERVER_EDITED
Severity Description
informational Details of key server 'Key Server Name' weremodified.
ENCRYPT_KEYSERVER_RENAMED
Severity Description
informational Key server 'Old Name' was renamed to 'NewName'.
ENCRYPT_KEYSERVER_CHECK_STATUS_STARTED
Severity Description
informational Start checking connectivity status of thekeyservers currently defined in the system. Thisprocess can take several minutes to complete.
ENCRYPT_KEYSERVER_CHECK_STATUS_COMPLETED
Severity Description
informational Completed checking connectivity status of thekeyservers currently defined in the systemt.
ENCRYPT_KEYSERVER_REKEY_COMPLETED
Severity Description
informational Key server 'Key Server Name' rekey completed.
Chapter 22. Events 507
ENCRYPT_UNABLE_TO_UPDATE_KEY_DURING_DEACTIVATE_ON_KEYSERVER
Severity Description
major Could not update key server 'Keyserver Name'regarding encryption deactivation. Please checkkey server status.
ENCRYPT_KEYSERVER_REKEY_FAILED
Severity Description
major Cannot complete rekey with key server 'Key ServerName'.
ENCRYPT_KEYSERVER_REKEY_ROLLBACK_FAILED
Severity Description
major Cannot rollback failed rekey with key server 'KeyServer Name'.
ENCRYPT_RECOVERY_KEY_ENTERED
Severity Description
informational Valid recovery key share was entered by user'User Name'.
ENCRYPT_INVALID_RECOVERY_KEY_ENTERED
Severity Description
major Invalid recovery key share was entered by user'User Name'.
ENCRYPT_RECOVERY_KEYS_GENERATED
Severity Description
informational Recovery keys created.
ENCRYPT_RECOVERY_KEY_REKEY_SUCCESS
Severity Description
informational Recovery key rekey was successful.
ENCRYPT_RECOVERY_KEY_REKEY_FAIL
Severity Description
major Recovery key rekey failed.
508 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
ENCRYPT_RECOVERY_KEY_VERIFIED
Severity Description
informational Recovery key verifed successfully for user 'UserName'.
ENCRYPT_RECOVERY_KEY_VERIFY_FAILED
Severity Description
major Recovery key verification failed for user 'UserName'.
ENCRYPT_RECOVERY_KEY_ALL_SHARES_VERIFIED
Severity Description
informational All recovery key shares have been verified.
ENCRYPT_KR_WRITE_FAILED
Severity Description Troubleshooting
critical Key repository write failed witherror code rc.
Please contact technical support
ENCRYPT_KR_READ_FAILED
Severity Description Troubleshooting
major Key repository read failed witherror code rc.
Please contact technical support
ENCRYPT_UNABLE_TO_RETRIEVE_KEY_FROM_KEYSERVER
Severity Description
major Failed to retrieve key from key server 'KeyserverName' via TEXT on module node id. Please verifythat the key server type and version aresupported. If so, please check its status.
ENCRYPT_RECOVERY_KEY_RECOVER_SUCCESSFUL
Severity Description
informational Key recovery was successful, unlocking system.
ENCRYPTION_CERTIFICATE_FOR_XIV_IS_NOT_INSTALLED
Severity Description Troubleshooting
critical XIV certificate is not installed. Check output of pki_list for acertificate named XIV andcontact technical support
Chapter 22. Events 509
ENCRYPT_UNABLE_TO_DELETE_MASTER_KEYSERVER
Severity Description
informational Deletion of master key server 'Keyserver Name' isnot allowed. Please define another key server asmaster first'.
ENCRYPTION_SKMIP_ERROR
Severity Description Troubleshooting
major Module Module reportedKeyserver Name returnederror:error code - TEXT
Please contact the next level ofsupport.
DIMM_FAILED
Severity Description Troubleshooting
major Component ID has failed.Hardware status: Status.
Please contact support.
CPU_FAILED
Severity Description Troubleshooting
major Component ID has failed.Hardware status: Status.
Please contact support.
NIC_FAILED
Severity Description Troubleshooting
major Component ID has failed.Hardware status: Status.
Please contact support.
MODULE_BBU_FAILED
Severity Description Troubleshooting
major BBU id has failed. Hardwarestatus: 'Status'. BBU state: 'State'.
Please contact support.
MODULE_BBU_OK
Severity Description
informational BBU id is now OK.
PSU_CHANGE_DETECTED
Severity Description Troubleshooting
informational Component ID has been changedfrom a serial number 'old_serial',part number 'old_part_number', toserial number 'new_serial' andpart number 'new_part_number'.
Was this PSU actually replaced?
510 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
PSU_WAS_REMOVED
Severity Description Troubleshooting
warning Component ID with a serialnumber 'Serial' and part number'Part Number' was removed fromthe system.
Was this PSU actually removed?
PSU_MISSING_FROM_INSTALL
Severity Description Troubleshooting
major System was installed withoutComponent ID.
This PSU was not in the systemat install time.
PSU_WAS_INSTALLED
Severity Description Troubleshooting
informational Component ID with a serialnumber 'Serial' and part number'Part Number' was installed in thesystem.
Was this PSU actually installed?
NIC_CHANGE_DETECTED
Severity Description Troubleshooting
major Component ID has been changedfrom a serial of old_serial tonew_serial.
Was this NIC actually replaced?
MODULE_BBU_IS_TOO_OLD
Severity Description
major BBU id installed more than max use time monthsago on insert time.
MODULE_BBU_SHELF_TIME_EXCEEDED
Severity Description
major BBU id installed more than max shelf time monthsafter manufacturing date manufacturing date.
TECHNICIAN_WORK_STARTED
Severity Description
informational Technician work has started, expected to end atEnd Time. Comment: Comment.
TECHNICIAN_WORK_ENDED
Severity Description
informational Technician work has ended after Elapsed Timeminutes. Comment: Comment.
Chapter 22. Events 511
TECHNICIAN_WORK_TIMED_OUT
Severity Description
warning Technician work has timed out after Elapsed Timeminutes. Comment: Comment.
XIV_SUPPORT_ENABLED
Severity Description
informational XIV support access from From is enabled fromStart Time until Finish Time. Comment: Comment.
XIV_SUPPORT_ENABLED_NO_TIME_LIMIT
Severity Description
informational XIV support access from From is enabled fromStart Time until explicitly disabled. Comment:Comment.
XIV_SUPPORT_DISABLED
Severity Description
informational XIV support access is disabled.
XIV_SUPPORT_WINDOW_TIMEOUT
Severity Description
informational XIV support work window timeout is expired.
HOST_DEFINE
Severity Description
informational Host of type host.type was defined with name'host.name'.
HOST_UPDATE
Severity Description
informational Host named 'host.name' was updated.
CLUSTER_CREATE
Severity Description
informational Cluster was defined with name 'cluster.name'.
HOST_DEFINE_FAILED_TOO_MANY
Severity Description Troubleshooting
warning Host with name 'name' could notbe defined. You are attemptingto define more hosts than thesystem permits.
Delete Hosts to allow new onesto be defined.
512 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
CLUSTER_CREATE_FAILED_TOO_MANY
Severity Description Troubleshooting
warning Cluster with name 'name' couldnot be defined. You areattempting to define moreClusters than the systempermits.
Delete Clusters to allow newones to be defined.
HOST_RENAME
Severity Description
informational Host with name 'old_name' was renamed'host.name'.
CLUSTER_RENAME
Severity Description
informational Cluster with name 'old_name' was renamed'cluster.name'.
HOST_DELETE
Severity Description
informational Host with name 'host.name' was deleted.
CLUSTER_DELETE
Severity Description
informational Cluster with name 'cluster.name' was deleted.
HOST_ADD_PORT
Severity Description
informational Port of type type and ID 'port_name' was added toHost with name 'host.name'.
CLUSTER_ADD_HOST
Severity Description
informational Host with name 'host.name' was added to Clusterwith name 'cluster.name'.
HOST_REMOVE_PORT
Severity Description
informational Port of type type and ID 'port_name' was removedfrom Host with name 'host.name' was deleted.
Chapter 22. Events 513
CLUSTER_REMOVE_HOST
Severity Description
informational Host with name 'host.name' was removed fromCluster with name 'cluster.name'.
DESTINATION_DEFINE
Severity Description
informational Destination with name 'name' was defined.
DESTINATION_UPDATE
Severity Description
informational Destination with name 'name' was updated.
DESTINATION_DELETE
Severity Description
informational Destination with name 'name' was deleted.
DESTINATION_RENAME
Severity Description
informational Destination with name 'old name' was renamed'new name'.
DESTINATION_GROUP_CREATE
Severity Description
informational Destination Group with name 'name' was created.
DESTINATION_GROUP_UPDATE
Severity Description
informational Destination Group with name 'name' was updated.
DESTINATION_GROUP_DELETE
Severity Description
informational Destination Group with name 'name' was deleted.
DESTINATION_GROUP_RENAME
Severity Description
informational Destination Group with name 'old name' wasrenamed 'new name'.
514 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
DESTINATION_GROUP_ADD_DESTINATION
Severity Description
informational Destination with name 'destination name' wasadded to destination group 'destgroup name'.
DESTINATION_GROUP_REMOVE_DESTINATION
Severity Description
informational Destination with name 'destination name' wasremoved from destination group 'destgroup name'.
RULE_CREATE
Severity Description
informational Rule with name 'name' was created.
RULE_UPDATE
Severity Description
informational Rule with name 'name' was updated.
RULE_DELETE
Severity Description
informational Rule with name 'name' was deleted.
RULE_RENAME
Severity Description
informational Rule with name 'old name' was renamed 'newname'.
SMTP_GATEWAY_DEFINE
Severity Description
informational SMTP gateway with name 'name' was defined.
SMTP_GATEWAY_UPDATE
Severity Description
informational SMTP gateway with name 'name' was updated.
SMTP_GATEWAY_DELETE
Severity Description
informational SMTP gateway with name 'name' was deleted.
Chapter 22. Events 515
SMTP_GATEWAY_RENAME
Severity Description
informational SMTP gateway with name 'old name' was renamed'new name'.
SMTP_GATEWAY_PRIORITIZE
Severity Description
informational SMTP gateways were prioritized; the new order isorder.
SMTP_GATEWAY_FAILED
Severity Description
major SMTP gateway with name 'name' has failed. It willnot be used until Retry Time.
SMTP_GATEWAY_VIA_NODE_FAILED
Severity Description
warning Sending event Event Code (Event Index) throughSMTP Gateway via Module ID has failed; Errormessage: 'Error Message'.
SMS_GATEWAY_DEFINE
Severity Description
informational SMS gateway with name 'name' was defined.
SMS_GATEWAY_UPDATE
Severity Description
informational SMS gateway with name 'name' was updated.
SMS_GATEWAY_DELETE
Severity Description
informational SMS gateway with name 'name' was deleted.
SMS_GATEWAY_RENAME
Severity Description
informational SMS gateway with name 'old name' was renamed'new name'.
SMS_GATEWAY_PRIORITIZE
Severity Description
informational SMS gateways were prioritized; the new order isorder.
516 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
CONS_GROUP_CREATE
Severity Description
informational Consistency Group with name 'cg.name' wascreated.
CONS_GROUP_CREATE_FAILED_TOO_MANY
Severity Description Troubleshooting
warning Consistency Group with name'name' could not be created. Youare attempting to add moreConsistency Groups than thesystem permits.
Delete Consistency Groups toallow new ones to be created.
CONS_GROUP_RENAME
Severity Description
informational Consistency Group with name 'old_name' wasrenamed 'cg.name'.
CONS_GROUP_DELETE
Severity Description
informational Consistency Group with name 'cg.name' wasdeleted.
CONS_GROUP_ADD_VOLUME
Severity Description
informational Volume with name 'volume.name' was added toConsistency Group with name 'cg.name'.
SLAVE_CONS_GROUP_ADD_VOLUME
Severity Description
informational Volume with name 'volume.name' was added toConsistency Group with name 'cg.name' by itsremote peer.
CONS_GROUP_REMOVE_VOLUME
Severity Description
informational Volume with name 'volume.name' was removedfrom Consistency Group with name 'cg.name'.
SLAVE_CONS_GROUP_REMOVE_VOLUME
Severity Description
informational Volume with name 'volume.name' was removedfrom Consistency Group with name 'cg.name' byits remote peer.
Chapter 22. Events 517
CONS_GROUP_SNAPSHOTS_CREATE
Severity Description
informational Snapshot Group for Consistency Group withname 'cg.name' was created with name 'sg.name'.
CONS_GROUP_SNAPSHOTS_CREATE_FAILED_TOO_MANY
Severity Description Troubleshooting
warning Snapshot Group for ConsistencyGroup 'cg.name' could not becreated. You are attempting toadd more Volumes than thesystem permits.
Delete Volumes to allow newones to be created.
CONS_GROUP_SNAPSHOTS_OVERWRITE
Severity Description
informational Snapshot Group named 'sg.name' was overridenfor Consistency Group with name 'cg.name'.
SLAVE_CONS_GROUP_SNAPSHOTS_CREATE
Severity Description
informational Mirrored Snapshot Group for Consistency Groupwith name 'cg.name' was created with name'sg.name'.
SLAVE_CONS_GROUP_SNAPSHOTS_OVERWRITE
Severity Description
informational Mirrored Snapshot Group named 'sg.name' wasoverriden for Consistency Group with name'cg.name'.
MIRROR_CONS_GROUP_SNAPSHOTS_CREATE
Severity Description
informational Mirrored Snapshot Group for Consistency Groupwith name 'cg.name' was created with name'sg.name'.
MIRROR_CONS_GROUP_SNAPSHOTS_OVERWRITE
Severity Description
informational Mirrored Snapshot Group named 'sg.name' wasoverriden for Consistency Group with name'cg.name'.
518 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
MIRROR_SNAPGROUP_CREATE_FAILED
Severity Description
minor Remote snapshot group named 'snapshot groupname' was not created successfully. Error code is'error'
SNAPSHOT_GROUP_RESTORE
Severity Description
informational Volumes were restored from Snapshot Group withname 'sg.name'.
SNAPSHOT_GROUP_RENAME
Severity Description
informational Snapshot Group with name 'old_sg.name' wererenamed to 'sg.name'.
SNAPSHOT_GROUP_DUPLICATE
Severity Description
informational All Snapshots in Snapshot Group with name'sg.name' were duplicated. Duplicate SnapshotGroup is named 'sg.name'.
SNAPSHOT_GROUP_FORMAT
Severity Description
informational All Snapshots in Snapshot Group with name'sg.name' were formatted'.
SNAPSHOT_GROUP_DELETE
Severity Description
informational All Snapshots in Snapshot Group with name'sg.name' were deleted.
SNAPSHOT_GROUP_CHANGE_PRIORITY
Severity Description
informational Deletion Priority of all Snapshots in SnapshotGroup with name 'sg.name' were changed from 'oldpriority' to 'new priority'.
SNAPSHOT_GROUP_LOCK
Severity Description
informational All Snapshots in Snapshot Group with name'sg.name' were locked.
Chapter 22. Events 519
SNAPSHOT_GROUP_UNLOCK
Severity Description
informational All Snapshots in Snapshot Group with name'sg.name' were unlocked.
SNAPSHOT_GROUP_DELETED_DUE_TO_POOL_EXHAUSTION
Severity Description
informational All Snapshots in Snapshot Group with name'snapshot.sg_name' have been deleted becauseStorage Pool with name 'snapshot.pool_name' is full.
SNAPSHOT_GROUP_DISBAND
Severity Description
informational Snapshot Group with name 'sg.name' wasdismantled. All Snapshots which belonged to thatSnapshot Group should be accessed directly.
CONS_GROUP_MOVE
Severity Description
informational Consistency Group with name 'cg.name' has beenmoved from Storage Pool 'orig_pool.name' to Pool'pool.name'.
XCG_CREATE
Severity Description
informational Cross Consistency Group with name 'xcg' wascreated.
XCG_DELETE
Severity Description
informational Cross Consistency Group with name 'xcg' wasdeleted.
XCG_ADD_CG
Severity Description
informational CG with name 'cg.name' was added to CrossConsistency Group with name 'xcg'.
XCG_REMOVE_CG
Severity Description
informational CG with name 'cg.name' was removed from CrossConsistency Group with name 'xcg'.
520 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
TARGET_DEFINE
Severity Description
informational Target was defined named 'target.name'.
TARGET_DEFINE_FAILED_TOO_MANY
Severity Description Troubleshooting
warning Target could not be defined. Youare attempting to define moretargets than the system permits.
Delete targets to allow new onesto be defined.
TARGET_RENAME
Severity Description
informational Target named 'old_name' was renamed 'target.name'.
TARGET_DELETE
Severity Description
informational Target named 'target.name' was deleted.
TARGET_ALLOW_ACCESS
Severity Description
informational Target 'target.name' is allowed to access thismachine.
TARGET_PORT_ADD
Severity Description
informational Port 'port_name' was added to target named'target.name'.
TARGET_PORT_REMOVE
Severity Description
informational Port 'port_name' was removed from target named'target.name'.
TARGET_PORT_ACTIVATE
Severity Description
informational Port 'port_name' in target named 'target.name' wasactivated.
TARGET_PORT_DEACTIVATE
Severity Description
informational Port 'port_name' was deactivated in target named'target.name'.
Chapter 22. Events 521
TARGET_CONNECTIVITY_CREATE
Severity Description
informational Port 'Connection Remote Port Address' of targetnamed 'Connection Target Name' is connected to thesystem through Local FC Port.
TARGET_ISCSI_CONNECTIVITY_CREATE
Severity Description
informational Port 'Connection Remote Port Address' of targetnamed 'Connection Target Name is connected to thesystem through ip interface 'Local IP interface'.
TARGET_CONNECTIVITY_CREATE_FAILED_TOO_MANY
Severity Description Troubleshooting
warning Port could not be connected tothe system. You are attemptingto define more connections thanthe system permits.
Delete Connections to allow newones to be created.
TARGET_CONNECTIVITY_DELETE
Severity Description
informational Port 'Connection Remote Port Address' of targetnamed 'Connection Target Name' was disconnectedfrom Local FC Port.
TARGET_ISCSI_CONNECTIVITY_DELETE
Severity Description
informational Port 'Connection Remote Port Address' of targetnamed 'Connection Target Name' was disconnectedfrom ip interface 'Local IP interface'.
TARGET_CONNECTIVITY_ACTIVATE
Severity Description
informational Connectivity between Port 'Connection Remote PortAddress' of target named 'Connection Target Name'and Local FC Port was activated.
TARGET_ISCSI_CONNECTIVITY_ACTIVATE
Severity Description
informational Connectivity between Port 'Connection Remote PortAddress' of target named 'Connection Target Name'and ip interface 'Local IP interface' was activated.
522 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
TARGET_CONNECTIVITY_DEACTIVATE
Severity Description
informational Connectivity between Port 'Connection Remote PortAddress' of target named 'Connection Target Name'and Local FC Port was deactivated.
TARGET_ISCSI_CONNECTIVITY_DEACTIVATE
Severity Description
informational Connectivity between Port 'Connection Remote PortAddress' of target named 'Connection Target Name'and ip interface 'Local IP interface' was deactivated.
TARGET_CONNECTIVITY_CONFLICT_DETECTED
Severity Description
major Connectivity between Port 'Connection Remote PortAddress' of target named 'Connection Target Name'and FC port 'Local IP interface' will be deleted dueto a connectivity conflict.
TARGET_ISCSI_CONNECTIVITY_CONFLICT_DETECTED
Severity Description
major Connectivity between Port 'Connection Remote PortAddress' of target named 'Connection Target Name'and IP interface 'Local IP interface' will be deleteddue to a connectivity conflict.
TARGET_CONNECTION_ESTABLISHED
Severity Description
informational Target named 'target.name' is accessible throughremote service module_id.
TARGET_CONNECTION_DISCONNECTED
Severity Description
minor Target named 'target.name' is no longer accessiblethrough remote service module_id.
TARGET_DISCONNECTED
Severity Description
major Target named 'target.name' is no longer accessiblethrough any gateway module.
TARGET_CLOCK_SKEW_ABOVE_LIMIT
Severity Description
warning Target 'target.name' has clock skew above theallowed limit relative to local machine.
Chapter 22. Events 523
TARGET_CLOCK_SKEW_RESOLVED
Severity Description
informational Target named 'target.name' clock skew has beenresolved.
TARGET_LINK_DOWN_BEYOND_THRESHOLD
Severity Description
major Target named 'target.name' is not accessible for along time.
SNAPSHOT_CREATE
Severity Description
informational Snapshot named 'snapshot.name' was created forvolume named 'volume.name'.
SNAPSHOT_DELETE
Severity Description
informational Snapshot with name 'snapshot.name' was deleted.
SNAPSHOT_CREATE_MANY
Severity Description
informational Created num_of_vols snapshots.
SNAPSHOT_OVERWRITE
Severity Description
informational Snapshot named 'snapshot.name' was overriden forvolume named 'volume.name'.
SNAPSHOT_FORMAT
Severity Description
informational Snapshot named 'snapshot.name' was formatted.
SNAPSHOT_CREATE_FAILED_TOO_MANY
Severity Description Troubleshooting
warning Snapshot for volume named'volume.name' could not becreated. You are attempting toadd more volumes than thesystem permits.
Delete volumes to allow newones to be created.
524 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
SNAPSHOT_DUPLICATE
Severity Description
informational Snapshot named 'snapshot.name' was created asduplicate of Snapshot named'original_snapshot.name'.
SNAPSHOT_DUPLICATE_FAILED_TOO_MANY
Severity Description Troubleshooting
warning Snapshot named 'snapshot.name'could not be duplicated. You areattempting to add more volumesthan the system permits.
Delete volumes to allow newones to be created.
SNAPSHOT_RESTORE
Severity Description
informational Volume named 'volume.name' was restored fromSnapshot named 'snapshot.name'.
SNAPSHOT_CHANGE_PRIORITY
Severity Description
informational Snapshot Delete Priority of Snapshot named'snapshot.name' was changed from 'old_priority' to'snapshot.delete_priority'.
SNAPSHOT_DELETED_DUE_TO_POOL_EXHAUSTION
Severity Description
warning Snapshot named 'snap.name' has been deletedbecause Storage Pool named 'snap.pool_name' isfull.
MIRROR_SNAPSHOT_CREATE
Severity Description
informational Mirrored Snapshot named 'snapshot.name' wascreated for volume named 'volume.name'.
MIRROR_SNAPSHOT_CREATE_FAILED
Severity Description
minor Remote snapshot named 'snapshot name' was notcreated successfully. Error code is 'error'
MIRROR_SNAPSHOT_OVERWRITE
Severity Description
informational Mirrored Snapshot named 'snapshot.name' wasoverriden for volume named 'volume.name'.
Chapter 22. Events 525
MIRROR_SLAVE_SNAPSHOT_CREATE
Severity Description
informational Mirrored Snapshot named 'snapshot.name' wascreated for volume named 'volume.name'.
MIRROR_SLAVE_SNAPSHOT_OVERWRITE
Severity Description
informational Mirrored Snapshot named 'snapshot.name' wasoverriden for volume named 'volume.name'.
MEDIUM_ERROR_IN_DATA_MIGRATION
Severity Description Troubleshooting
critical Medium error in data migrationinto volume 'Volume Name' atLBA LBA for Length blocks.
Remote machine indicatedMedium Error when read.
USER_DEFINED
Severity Description
informational A user with name 'Name' and category Categorywas defined.
USER_DELETED
Severity Description
informational A user with name 'Name' and category Categorywas deleted.
USER_RENAMED
Severity Description
informational User with name 'Old Name' was renamed 'NewName'.
USER_UPDATED
Severity Description
informational User with name 'Name' was updated.
USER_ADDED_TO_USER_GROUP
Severity Description
informational User 'User Name' was added to user group 'UserGroup Name'.
526 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
USER_REMOVED_FROM_USER_GROUP
Severity Description
informational User 'User Name' was removed from user group'User Group Name'.
USER_GROUP_CREATED
Severity Description
informational A user group with name 'Name' was created.
USER_GROUP_DELETED
Severity Description
informational A user group with name 'Name' was deleted.
USER_GROUP_RENAMED
Severity Description
informational User group with name 'Old Name' was renamed'New Name'.
LDAP_AUTHENTICATION_ACTIVATED
Severity Description
informational LDAP authentication activated.
LDAP_AUTHENTICATION_DEACTIVATED
Severity Description
warning LDAP authentication deactivated.
LDAP_CONFIGURATION_CHANGED
Severity Description
warning LDAP configuration has changed.
LDAP_CONFIGURATION_RESET
Severity Description
warning LDAP configuration has reset.
USER_LOGIN_HAS_SUCCEEDED
Severity Description
informational User 'User Name' from IP 'Client Address'successfully logged into the system.
Chapter 22. Events 527
USER_LOGIN_HAS_FAILED
Severity Description
warning User 'User Name' from IP 'Client Address' failedlogging into the system.
USER_HAS_FAILED_TO_RUN_COMMAND
Severity Description
warning User 'User Name' from IP 'Client Address' failedauthentication when trying to run command'Command Line'.
LDAP_SERVER_INACCESSIBLE
Severity Description
minor LDAP server FQDN is inaccessible.
LDAP_SERVER_ACCESSIBLE
Severity Description
informational LDAP server FQDN is now accessible.
LDAP_SSL_CERTIFICATE_ABOUT_TO_EXPIRE
Severity Description
warning SSL Certificate of LDAP server 'Server FQDN' isabout to expire on Expiration Date (Counternotification).
LDAP_SERVER_WAS_ADDED
Severity Description
informational LDAP server 'Server FQDN' was added to thesystem.
LDAP_SERVER_WAS_REMOVED
Severity Description
informational LDAP server 'Server FQDN' was removed fromthe system.
DESIGNATED_MSM_USER
Severity Description
informational Description
DOMAIN_POLICY_SET
Severity Description
informational Domain policy for Parameter Name set to 'ParameterValue'
528 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
USER_ADDED_TO_DOMAIN
Severity Description
informational User User Name was added to domain DomainName (Exclusive).
USER_REMOVED_FROM_DOMAIN
Severity Description
informational User User Name was removed from domainDomain Name.
APPADMIN_CAPABILITIES_SET
Severity Description
informational Application admin capabilities have been set toCapabilities
ACCESS_TO_HOST_GRANTED_TO_USER_GROUP
Severity Description
informational User group 'User Group Name' was granted accessto host 'Host Name'.
ACCESS_OF_USER_GROUP_TO_HOST_REMOVED
Severity Description
informational Access of User group 'User Group Name' to host'Host Name' was removed.
ACCESS_TO_CLUSTER_GRANTED_TO_USER_GROUP
Severity Description
informational User group 'User Group Name' was granted accessto cluster 'Cluster Name'.
ACCESS_OF_USER_GROUP_TO_CLUSTER_REMOVED
Severity Description
informational Access of User group 'User Group Name' to cluster'Cluster Name' was removed.
COMPONENT_TEST_HAS_FAILED
Severity Description Troubleshooting
minor Test of Component ID has failed.Failure reason: Failure Reason.
Please contact support.
Chapter 22. Events 529
COMPONENT_TEST_SUCCEEDED
Severity Description Troubleshooting
informational Test of Component ID succeeded. Please contact support.
MODULE_COMPONENT_TEST_STARTED
Severity Description
informational Test of Component ID started.
DISK_COMPONENT_TEST_STARTED
Severity Description
informational Test of Component ID started.
IB_SWITCH_COMPONENT_TEST_STARTED
Severity Description
informational Test of Component ID started.
SSD_COMPONENT_TEST_STARTED
Severity Description
informational Test of Component ID started.
BOOT_MEDIA_COMPONENT_TEST_STARTED
Severity Description
informational Test of Component ID started.
BOOT_MEDIA_FAILED
Severity Description Troubleshooting
major Component ID has failed.Hardware status: Status.
Please contact support.
MODULE_BBU_TEST_STARTED
Severity Description
informational Test of Component ID started.
COMPONENT_WAS_PHASED_OUT
Severity Description
informational Component ID was phased-out.
COMPONENT_WAS_FAILED
Severity Description
informational Component Component ID was marked as failed.
530 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
COMPONENT_FAILURE_WAS_CANCELED
Severity Description
informational Component Component ID failure status was reset.
COMPONENT_WAS_PHASED_IN
Severity Description
informational Component ID was phased-in.
COMPONENT_WAS_EQUIPPED
Severity Description
informational Component ID was equipped.
INTERFACE_SERVICES_ACTIVATED
Severity Description
informational Interface services of Module ID were activated.
COMPONENT_FIRMWARE_UPGRADE_ABORTING
Severity Description
warning Aborting Upgrade type upgrade of Firmware typefirmware, version Label, on Scope. Abort reason:Reason. Waiting for current upgrade item tocomplete.
COMPONENT_FIRMWARE_UPGRADE_ABORTED
Severity Description
warning Aborted Upgrade type upgrade of Firmware typefirmware, version Label, on Scope. Abort reason:Reason. Progress Attempted/Total, Successessucceeded, Failures failed, No-Ops no-ops.
COMPONENT_FIRMWARE_UPGRADE_DONE
Severity Description
informational Finished Upgrade type upgrade of Firmware typefirmware, version Label, on Scope. Successessucceeded, Failures failed, No-Ops no-ops.
COMPONENT_FIRMWARE_UPGRADE_STARTED
Severity Description
informational Starting Upgrade type upgrade of Firmware typefirmware, version Label, on Scope.
Chapter 22. Events 531
COMPONENT_FIRMWARE_CANNOT_PHASEOUT_COMPONENT
Severity Description
minor Cannot phase out Component ID: Error. Firmwareupgrade result was: Upgrade result.
COMPONENT_FIRMWARE_CANNOT_FAIL_COMPONENT
Severity Description
minor Cannot fail Component ID: Error. Firmwareupgrade result was: Upgrade result.
MIRRORING_CONNECTIVITY_TO_NON_XIV_TARGET
Severity Description Troubleshooting
warning Gateway Node #Node ID:connection to target name:target'sconnection index mirroringconnection was established, butbeing ignored because theremote end is not an XIV targetor is not properly configured
Please make sure the target'sdesignation is correct, that theconnection's parameters identifythe intended system and that theintended system has atarget_port defined for thissystem.
DM_CONNECTIVITY_TO_XIV_TARGET
Severity Description Troubleshooting
warning Gateway Node #Node ID:connection to target name:target'sconnection index DM connectionwas established, but beingignored because the remote endis an XIV target configured formirroring, rather than a host
Please make sure the target'sdesignation is correct, that theconnection's parameters identifythe intended system and that theintended system has a hostdefined for this system (and nota target_port).
EMERGENCY_ROOT_ACCESS
Severity Description
warning Emergency login to 'root' account on module'Component ID' from 'IP Address' using key number'Authorized Key Number'.
EMERGENCY_CONSOLE_ACCESS
Severity Description
warning Emergency login to 'Unix Account Name' accounton module 'Component ID' from tty 'TTY Device'.
CR_BYPASS_ACCESS
Severity Description
warning Command that bypasses CR mechanism access to'Unix Account Name' account on module'Component ID' from 'IP Address'.
532 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
CR_KEY_SETUP_OK
Severity Description
informational Challenge-response key was successfully set on allmodules in the system.
CR_KEY_UPGRADE_NOT_DONE
Severity Description
warning Challenge-response key was not upgraded on thesystem since a valid key has been previously set.
CR_KEY_SETUP_FAILED
Severity Description
major Failed to set challenge-response key on module'Component ID'.
SSH_REVOKE_KEY_OK
Severity Description
informational Authorized SSH key ending with 'Tail ofAuthorized SSH key' was successfully revoked foruser 'Unix Account Name' on all modules in thesystem.
SSH_REVOKE_KEY_FAILED
Severity Description
major Failed to revoke authorized SSH key ending with'Tail of Authorized SSH key' for user 'Unix AccountName' on module 'Component ID'.
IB_SWITCH_PHASEOUT_STARTED
Severity Description
informational System started phasing out Component ID.
IB_SWITCH_PHASEIN_STARTED
Severity Description
informational System started phasing in Component ID.
IB_SWITCH_PHASEIN_FAILED
Severity Description
warning Component ID has failed to phase-in.
Chapter 22. Events 533
IB_SWITCH_CONFIG_FAILED
Severity Description Troubleshooting
warning Component ID could not beconfigured
Please contact support
IB_SWITCH_VOLTAGE_PROBLEM
Severity Description Troubleshooting
variable Sensor Type voltage is VoltageMilli Volt and deviation fromexpected voltage is VoltageDeviation Milli Volt (which isVoltage Deviation Percent%) forComponent ID.
Check voltage, replace switch
IB_SWITCH_VOLTAGE_RESTORED
Severity Description
informational Sensor Type voltage was restored for ComponentID.
IB_SWITCH_PSU_VOLTAGE_PROBLEM
Severity Description Troubleshooting
variable Voltage is Voltage Milli Volt anddeviation from expected voltageis Voltage Deviation Milli Volt(which is Voltage DeviationPercent%) for Component ID.
Check voltage, replace switchpsu
IB_SWITCH_PSU_VOLTAGE_RESTORED
Severity Description
informational Voltage was restored for Component ID.
IB_SWITCH_BBU_VOLTAGE_PROBLEM
Severity Description Troubleshooting
variable Voltage is Voltage Milli Volt anddeviation from expected voltageis Voltage Deviation Milli Volt(which is Voltage DeviationPercent%) for Component ID.
Check voltage, replace switchbbu
IB_SWITCH_BBU_VOLTAGE_RESTORED
Severity Description
informational Voltage was restored for Component ID.
534 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
IB_SWITCH_FIRMWARE_INCOMPATIBLE
Severity Description Troubleshooting
warning The firmware version ofComponent ID is 'New Version'. Itshould be 'Old Version'.
None
IB_SWITCH_FIRMWARE_UPDATE_IN_PROGRESS
Severity Description Troubleshooting
informational Firmware version of ComponentID is 'Old Version'. It should be'New Version'. Firmware will beupdated. It may take a while.
Wait for IB switch to completeinitialization.
IB_SWITCH_FIRMWARE_UPDATED
Severity Description Troubleshooting
informational The firmware version ofComponent ID was updated to'New Version'.
None.
IB_SWITCH_LOG_COLLECT_OK
Severity Description
informational Log collection for IB switch 'switch_id' completedsuccessfuly. Log can be found in module'log_module' in the following directory:'log_location'.
IB_SWITCH_LOG_COLLECT_FAILED
Severity Description
warning Log collection for IB switch 'switch_id' failed.Failure reason: 'failure_reason'.
IB_SWITCH_MGMT_LINK_AVAILABLE
Severity Description
informational Management link Type of Component ID isavailable.
IB_SWITCH_MGMT_LINK_UNAVAIL
Severity Description
warning Management link Type of Component ID isunavailable.
IB_SWITCH_MGMT_LINK_MISWIRED
Severity Description Troubleshooting
warning Management link Type ofComponent ID is connected toRouter instead of Expected Router.
Check wiring
Chapter 22. Events 535
IB_SWITCH_MGMT_AVAILABLE
Severity Description
informational Management of Component ID is available.
IB_SWITCH_MGMT_UNAVAIL
Severity Description
major Management of Component ID is unavailable.
IB_SWITCH_PSU_POWER_SENSOR_OK
Severity Description
informational Component ID power sensor has returned tonormal state.
IB_SWITCH_PSU_POWER_SENSOR_ERROR
Severity Description
warning Component ID power sensor cannot be read.
IB_SWITCH_PSU_POWER_SENSOR_CRITICAL
Severity Description
major Component ID power sensor failed.
IB_SWITCH_BBU_POWER_SENSOR_OK
Severity Description
informational Component ID power sensor has returned tonormal state.
IB_SWITCH_BBU_POWER_SENSOR_ERROR
Severity Description
warning Component ID power sensor cannot be read.
IB_SWITCH_BBU_POWER_SENSOR_CRITICAL
Severity Description
major Component ID power sensor failed.
IB_SWITCH_FAN_SENSOR_OK
Severity Description
informational Component ID fan sensor Index has returned tonormal state.
536 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
IB_SWITCH_FAN_SENSOR_ERROR
Severity Description
warning Component ID fan sensor Index cannot be read.
IB_SWITCH_FAN_SENSOR_CRITICAL
Severity Description
major Component ID fan sensor Index failed.
IB_SWITCH_PSU_FAN_SENSOR_OK
Severity Description
informational Component ID fan sensor has returned to normalstate.
IB_SWITCH_PSU_FAN_SENSOR_ERROR
Severity Description
warning Component ID fan sensor cannot be read.
IB_SWITCH_PSU_FAN_SENSOR_CRITICAL
Severity Description
major Component ID fan sensor failed.
IB_SWITCH_VOLTAGE_SENSOR_OK
Severity Description
informational Component ID voltage sensor Type has returned tonormal state.
IB_SWITCH_VOLTAGE_SENSOR_ERROR
Severity Description
warning Component ID voltage sensor Type cannot be read.
IB_SWITCH_VOLTAGE_SENSOR_CRITICAL
Severity Description
major Component ID voltage sensor Type failed.
IB_SWITCH_PSU_VOLTAGE_SENSOR_OK
Severity Description
informational Component ID voltage sensor has returned tonormal state.
Chapter 22. Events 537
IB_SWITCH_PSU_VOLTAGE_SENSOR_ERROR
Severity Description
warning Component ID voltage sensor cannot be read.
IB_SWITCH_PSU_VOLTAGE_SENSOR_CRITICAL
Severity Description
major Component ID voltage sensor failed.
IB_SWITCH_BBU_VOLTAGE_SENSOR_OK
Severity Description
informational Component ID voltage sensor has returned tonormal state.
IB_SWITCH_BBU_VOLTAGE_SENSOR_ERROR
Severity Description
warning Component ID voltage sensor cannot be read.
IB_SWITCH_BBU_VOLTAGE_SENSOR_CRITICAL
Severity Description
major Component ID voltage sensor failed.
IB_SWITCH_TEMPERATURE_SENSOR_OK
Severity Description
informational Component ID voltage sensor Type has returned tonormal state.
IB_SWITCH_TEMPERATURE_SENSOR_ERROR
Severity Description
warning Component ID voltage sensor Type cannot be read.
IB_SWITCH_TEMPERATURE_SENSOR_CRITICAL
Severity Description
major Component ID voltage sensor Type failed.
IB_SWITCH_PSU_TEMPERATURE_SENSOR_OK
Severity Description
informational Component ID voltage sensor has returned tonormal state.
538 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
IB_SWITCH_PSU_TEMPERATURE_SENSOR_ERROR
Severity Description
warning Component ID voltage sensor cannot be read.
IB_SWITCH_PSU_TEMPERATURE_SENSOR_CRITICAL
Severity Description
major Component ID voltage sensor failed.
IB_SWITCH_BBU_TEMPERATURE_SENSOR_OK
Severity Description
informational Component ID voltage sensor has returned tonormal state.
IB_SWITCH_BBU_TEMPERATURE_SENSOR_ERROR
Severity Description
warning Component ID voltage sensor cannot be read.
IB_SWITCH_BBU_TEMPERATURE_SENSOR_CRITICAL
Severity Description
major Component ID voltage sensor failed.
IB_PORT_MOVED
Severity Description
informational Infinibind module port 'module_port' moved from'from_port' to 'to_port'.
SYSTEM_TEMPERATURE_IS_ABOVE_NORMAL
Severity Description Troubleshooting
warning System temperature is SystemTemperatureC, which is above thenormal temperature.
Cool the system down.
SYSTEM_TEMPERATURE_IS_HIGH
Severity Description Troubleshooting
minor System temperature is SystemTemperatureC, which is high.
Cool the system down.
Chapter 22. Events 539
SYSTEM_TEMPERATURE_IS_CRITICALLY_HIGH
Severity Description Troubleshooting
critical System temperature is SystemTemperatureC, which exceedsoperational level. Please initiateshutdown sequence. Withoutfurther action, the system willautomatically shut itself down ifit reaches Shutdown ThresholdC.
Cool the system downimmediately or shut down thesystem using 'shutdown -y' andcontact support.
SYSTEM_TEMPERATURE_IS_CRITICALLY_HIGH_SHUTTING_DOWN
Severity Description Troubleshooting
critical System temperature is SystemTemperatureC, which is criticallyhigh. Shutting down the system.
Shut down the system using'shutdown -y' and contactsupport.
SYSTEM_TEMPERATURE_IS_TOO_HIGH
Severity Description Troubleshooting
major System temperature is SystemTemperatureC. It approaches themaximal allowable value.
Cool the system down andcontact support.
SYSTEM_TEMPERATURE_IS_TOO_LOW
Severity Description Troubleshooting
major System temperature is SystemTemperatureC, which is lowerthan the minimal allowablevalue.
Contact support.
SYSTEM_TEMPERATURE_IS_OK_NOW
Severity Description
informational System temperature is System TemperatureC, whichis within allowed limits.
ENCRYPT_ENABLE_DRIVE_FAILED
Severity Description Troubleshooting
major Failed to enable encryption forComponent ID. Error code: FailureReason.
Please contact support.
ENCRYPT_ENABLE_VAULT_DEVICE_FAILED
Severity Description Troubleshooting
major Failed to enable encryption forComponent ID. Error code: FailureReason.
Please contact support.
540 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
VAULT_DEVICE_SECURE_ERASE_FAILED
Severity Description Troubleshooting
major Failed to secure erase ComponentID. Error code: Failure Reason.
Please contact support.
VAULT_DEVICE_SECURE_ERASE_SUCCESSFUL
Severity Description Troubleshooting
informational Secure erase was successful forComponent ID.
Please contact support.
VAULT_DEVICE_SECURE_ERASE_NOT_DONE
Severity Description Troubleshooting
informational Secure erase was not done forComponent ID as it is unsecured.
Please contact support.
MODULE_BBU_LOW_RUNTIME
Severity Description
critical BBU id runtime is runtime minutes, less than theminimum of min_runtime minutes. It must bereplaced.
MODULE_BBU_OVERHEATING
Severity Description Troubleshooting
major bbu reached a temperature oftempC, above critical_setC. BBUwill be disconnected until itcools down belowcritical_releaseC.
Please contact support.
MODULE_BBU_LOW_FULL_CHARGE
Severity Description
critical BBU id full charge has fallen belowmin_full_chargemAh and must be replaced.
MODULE_BBU_IS_DISCHARGING
Severity Description
informational BBU id changed state from 'old_state' to 'new state'.
MODULE_BBU_STOPPED_DISCHARGING
Severity Description
informational BBU id changed state from 'old_state' to 'new state'.
Chapter 22. Events 541
MODULE_BBU_IS_CHARGING
Severity Description
informational BBU id changed state from 'old_state' to 'new state'.
MODULE_BBU_IS_FULL
Severity Description
informational BBU id changed state from 'old_state' to 'new state'.
MODULE_BBU_DRIVER_NOT_LOADED
Severity Description
major BBU driver is not loaded in module Component.modprobe ruby
MODULE_BBU_CONTROLLER_NOT_PRESENT
Severity Description
major BBU controller board not detected in moduleComponent.
MODULE_BBU_CALIBRATION_STARTED
Severity Description
informational BBU id started calibration.
MODULE_BBU_CALIBRATION_ENDED
Severity Description
informational BBU id ended calibration with status 'result'.
CMOS_BATTERY_TOO_WEAK
Severity Description Troubleshooting
major The CMOS battery on Module istoo weak.
Please contact support and havethe battery replaced.
CMOS_BATTERY_IS_OK
Severity Description
informational The CMOS battery on Module is now OK.
FC_LINK_IS_NOW_DOWN
Severity Description Troubleshooting
major FC port Component - linkdisconnected.
Please contact support.
542 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
FC_LINK_IS_NOW_UP
Severity Description Troubleshooting
informational FC port Component - linkregained.
Please contact support.
FC_LINK_SYNC_ERROR
Severity Description Troubleshooting
major FC port Component - errors onthe physical layer.
Please contact support.
COMPONENT_NETWORK_LINK_IS_DOWN
Severity Description Troubleshooting
major Network interface to ConnectedComponent on Component ID -link disconnected.
Please contact support.
COMPONENT_NETWORK_LINK_IS_UP
Severity Description Troubleshooting
informational Network interface to componentConnected Component onComponent ID - link regained.
Please contact support.
MODULE_IS_MISSING_REQUIRED_MEMORY
Severity Description Troubleshooting
major Component ID has less memory(actual_mem GB) than is definedfor use (req_mem GB).
Please contact yourAdministrator.
PERF_CLASS_RESOURCE_EXHAUSTION
Severity Description
warning Exhausted all allowed resources for performanceclasses on Module Id, BUSY until resourcesavailable.
CONNECTED_HOSTS_LIMIT_REACHED
Severity Description
informational Number of connected Hosts was reached for port'port_id' in Module Module Id.
QoS_HAS_BEEN_TRIGGERED
Severity Description
informational Queues on port 'port_id' in Module Module Idcaused QoS to be activated.
Chapter 22. Events 543
PERF_CLASS_RATE_AT_LIMIT
Severity Description
informational Performance class 'perf_class' on Module Id reachedits limit of Limit Limit Name, IOs being throttled.
PORT_PREP_FOR_UPGRADE_TIMED_OUT
Severity Description
warning Preparation of port_type port 'local_port_name' forhot-upgrade timed out due to host 'host_name'port 'host_port_name'host_port_addr
INTERFACE_DISCONNECTED_FROM_TARGET
Severity Description
major Interface node on module module cannot accesstarget 'target' through any gateway module.
INTERFACE_RECONNECTED_TO_TARGET
Severity Description
major Interface node on module module can access target'target'.
METADATA_SERVICE_DB_CREATE
Severity Description
informational Database DB was created
METADATA_SERVICE_DB_DELETE
Severity Description
informational Database DB was deleted
IPINTERFACE_CREATE
Severity Description
informational A new iscsi IP interface was defined with name'interface name' on module module with port 'portlist' and IP address IP address
IPINTERFACE_DELETE
Severity Description
informational ISCSI IP interface with name 'interface name' wasdeleted
544 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
IPINTERFACE_RENAME
Severity Description
informational ISCSI IP interface with name 'old name' and wasrenamed 'interface name'
IPINTERFACE_UPDATE
Severity Description
informational ISCSI IP interface with name 'interface name' wasupdated. Its IP address is IP address
IPINTERFACE_UPDATE_MANAGEMENT
Severity Description
informational Management IP interfaces were updated.Management IPs are IP addresses
IPINTERFACE_UPDATE_MANAGEMENT_IPV6
Severity Description
informational Management IP interfaces were updated.Management IPv6 addresses are IPv6 addresses
IPINTERFACE_UPDATE_VPN
Severity Description
informational VPN IP interfaces were updated. VPN IPs are IPaddresses
IPINTERFACE_UPDATE_VPN_IPV6
Severity Description
informational VPN IPv6 interfaces were updated. VPN IPv6addresses are IP addresses
AUXILIARY_INTERNAL_PORTS_ENABLED
Severity Description
informational Port Count auxiliary internal Ethernet ports wereenabled
AUXILIARY_INTERNAL_PORTS_DISABLED
Severity Description
informational Port Count auxiliary internal Ethernet ports weredisabled
IPSEC_ENABLED
Severity Description
informational IPSec was enabled
Chapter 22. Events 545
IPSEC_DISABLED
Severity Description
informational IPSec was disabled
IPSEC_CONNECTION_ADDED
Severity Description
informational A new IPSec connection named 'name' was added
IPSEC_CONNECTION_UPDATED
Severity Description
informational The IPSec connection named 'name' was updated
IPSEC_CONNECTION_REMOVED
Severity Description
informational The IPSec connection named 'name' was removed
PRIVATE_KEY_ADDED
Severity Description
informational A new private key named 'name' with fingerprint'fingerprint' and size key_size bits was added.
CERTIFICATE_REMOVED
Severity Description
informational The certificate named 'name' was removed.
PKCS12_CERTIFICATE_ADDED
Severity Description
informational A new PKCS#12 named 'name' with fingerprint'fingerprint' was added.
PKI_RENAME
Severity Description
informational PKI with the name 'old name' was renamed to 'newname'
PKI_UPDATED
Severity Description
informational PKI with the name 'name' and fingerprint'fingerprint' was updated
546 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
EMAIL_HAS_FAILED
Severity Description Troubleshooting
variable Sending event Event Code (EventIndex) to Destination List viaSMTP Gateway failed. Module:Module ID; Error message: 'ErrorMessage'; timeout expired:Timeout Expired?.
Please contact support.
BULK_EMAIL_HAS_FAILED
Severity Description Troubleshooting
variable Sending bulk email with EventsNumber events to Destination Listvia SMTP Gateway failed.Module: Module ID; Errormessage: 'Error Message'; timeoutexpired: Timeout Expired?.
Please contact support.
SMS_HAS_FAILED
Severity Description Troubleshooting
variable Sending event Event Code (EventIndex) to Destination List via SMSGateway and SMTP Gatewayfailed. Module: Module ID; Errormessage: 'Error Message'; timeoutexpired: Timeout Expired?.
Please contact support.
HTTPS_HAS_FAILED
Severity Description Troubleshooting
variable Sending event Event Code (EventIndex) to Destination List viaHTTPS address failed. Module:Module ID; Error message: 'ErrorMessage' (HTTP error code);timeout expired: TimeoutExpired?.
Please contact support.
EMAIL_NOT_SENT
Severity Description Troubleshooting
variable Sending event Event Code (EventIndex) to Destination List viaSMTP Gateway was waivedbecause of failed SMTP gateway.It will be not be used until RetryTime.
Please contact support.
Chapter 22. Events 547
SMS_NOT_SENT
Severity Description Troubleshooting
variable Sending event Event Code (EventIndex) to Destination List via SMSGateway and SMTP Gateway waswaived because of failed SMTPgateway. It will be not be useduntil Retry Time.
Please contact support.
HEARTBEAT_EMAIL_HAS_FAILED
Severity Description Troubleshooting
minor Sending heartbeat to DestinationName via SMTP Gateway failed.Module: Module ID; Errormessage: 'Error Message'; timeoutexpired: Timeout Expired?.
Please contact support.
HEARTBEAT_SMS_HAS_FAILED
Severity Description Troubleshooting
minor Sending heartbeat to DestinationName via SMS Gateway andSMTP Gateway failed. Module:Module ID; Error message: 'ErrorMessage'; timeout expired:Timeout Expired?.
Please contact support.
TEST_EMAIL_HAS_FAILED
Severity Description Troubleshooting
minor Sending test to Destination Namevia SMTP Gateway failed.Module: Module ID; Errormessage: 'Error Message'; timeoutexpired: Timeout Expired?.
Please contact support.
TEST_SMS_HAS_FAILED
Severity Description Troubleshooting
minor Sending test to Destination Namevia SMS Gateway and SMTPGateway failed. Module: ModuleID; Error message: 'ErrorMessage'; timeout expired:Timeout Expired?.
Please contact support.
CUSTOM_EVENT
Severity Description
variable Description
548 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
UPGRADE_SOFTWARE_DOWNLOAD_FINISHED
Severity Description
informational Finished downloading software needed forupgrade to version version. Upgrade consequenceis consequence
UPGRADE_FILE_LIST_RETRIEVAL_FAILED
Severity Description Troubleshooting
critical Could not receive new version'sfile list from repository. Errorcode is error.
Contact support
UPGRADE_STARTS
Severity Description
informational System starting an upgrade.
PRE_UPGRADE
Severity Description
informational System preparing an upgrade procedure type type.
UPGRADE_IS_OVER
Severity Description
informational System went up after an upgrade.
IOS_RESTORED_AFTER_HOT_UPGRADE
Severity Description
informational System is able to perform I/Os after a hotupgrade.
UPGRADE_NO_NEW_FILES_FOR_UPGRADE
Severity Description Troubleshooting
warning Repository version does notcontain any new files. currentversion current_version newversion is new_version
Contact support
UPGRADE_DOWNLOAD_REPOSITORY_COPY
Severity Description Troubleshooting
critical Mirroring needed files fromrepository failed. Mirroringmodule is mirroring_module erroris error
Contact support
Chapter 22. Events 549
UPGRADE_LOCAL_VERSION_DOWNLOAD_FAILED
Severity Description Troubleshooting
critical Failure to distribute new sofwareinternally. Error code is error .
Contact support
UPGRADE_WAS_CANCELLED
Severity Description Troubleshooting
informational Upgrade was cancelled withreason reason .
Contact support
HOT_UPGRADE_ABORTED
Severity Description Troubleshooting
critical Hot upgrade aborted withreason reason.
Contact support
HOT_UPGRADE_HAS_FAILED
Severity Description Troubleshooting
critical Hot upgrade failed whileerrorneous_state.
Contact support
PRE_UPGRADE_SCRIPT_INVOCATION_FAILED
Severity Description Troubleshooting
critical Invocation of pre-upgrade scriptfailed with error error.
Contact support
POST_UPGRADE_SCRIPT_INVOCATION_FAILED
Severity Description Troubleshooting
critical Invocation of post-upgradescript failed with error error.
Contact support
UPGRADE_IS_NOT_ALLOWED
Severity Description Troubleshooting
critical One or more of the pre-upgradevalidations failed.
Fix the problems pointed out itprevious events and revalidate.
PRE_UPGRADE_VALIDATION_FAILED
Severity Description Troubleshooting
critical One of the pre-upgradevalidations failed with statuserror.
Contact support
550 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
POST_UPGRADE_SCRIPT_STARTED
Severity Description
informational Post-upgrade script started.
POST_UPGRADE_SCRIPT_FINISHED
Severity Description
informational Post-upgrade script finished successfully.
PRE_UPGRADE_SCRIPT_DISAPPROVES
Severity Description Troubleshooting
critical Upgrade cannot commencebecause some of the validationsin the pre-upgrade script failed.Explanation: explanation.
Correct the system stateaccording to the explanation andtry again
POST_UPGRADE_SCRIPT_REPORTED_FAILURE
Severity Description Troubleshooting
critical Post upgrade script reportedfailure. Script output: explanation.
Correct the system stateaccording to the explanation andtry again
POWER_PROBLEM_CAUSING_MAINTENANCE_MODE
Severity Description
warning Power state causing system to enter maintenancemode.
SYSTEM_ENTERED_CHARGING_STATE
Severity Description
informational System cannot start work until it is sufficientlycharged.
POWER_PROBLEM_CAUSING_MODULE_PHASEOUT
Severity Description
critical Module module was phased out due to a powerproblem.
POWER_REPORT_PROBLEM_CAUSING_MODULE_PHASEOUT
Severity Description
critical Module module did not report power status ontime and hence it was phased out.
Chapter 22. Events 551
POWER_PROBLEM_CAUSING_SYSTEM_SHUTDOWN
Severity Description
critical Power state causing system to shutdown due to:Power Emergency Shutdown Reason.
DELAYING_BACKUP_POWER_FAILURE_HANDLING
Severity Description
informational Delaying backup power failure handling atmodule Module
NO_DELAYED_BACKUP_POWER_FAILURE
Severity Description
informational No delayed backup power failure
MODULE_PHASEOUT_FAILED
Severity Description
informational Phase out of module Module failed
METADATA_SET
Severity Description
warning Object type with name 'Object name' has newmetadata value.
METADATA_DELETE
Severity Description
warning Metadata object deleted for Object type with name'Object name'.
PATCH_SCRIPT_ADDED
Severity Description Troubleshooting
informational Added patch Patch Name. Was patch supposed to havebeen added.
PATCH_SCRIPT_UPDATED
Severity Description
informational Updated patch Patch Name.
PATCH_SCRIPT_DELETED
Severity Description
informational Deleted patch Patch Name.
552 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
MODULE_FAILED_TO_FETCH_PATCH_SCRIPT
Severity Description
warning Module Module failed to fetch patch script PatchName.
PATCH_SCRIPT_FAILED_TO_EXECUTE
Severity Description
informational Patch script Patch Name execution failed onmodule Module
PATCH_SCRIPT_EXECUTION_STARTED
Severity Description
informational Patch script Patch Name execution on moduleModule started with pid Process ID
PATCH_SCRIPT_EXECUTION_ENDED
Severity Description
informational Patch script Patch Name execution on moduleModule with pid Process ID ended with returncode Return Code
DOMAIN_CREATED
Severity Description
informational Domain domain_name has been created.
DOMAIN_UPDATED
Severity Description
informational Domain domain_name has been updated.
DOMAIN_RENAMED
Severity Description
informational Domain old_name has been renamed todomain_name.
DOMAIN_DELETED
Severity Description
informational Domain domain_name has been deleted.
POOL_ADDED_TO_DOMAIN
Severity Description
informational Pool pool_name has been added to domaindomain_name.
Chapter 22. Events 553
POOL_REMOVED_FROM_DOMAIN
Severity Description
informational Pool pool_name has been removed from domaindomain_name.
POOL_MOVED_BETWEEN_DOMAINS
Severity Description
informational Pool pool_name has been moved from domaindomain_name to domain domain_name.
DOMAINS_AUTO_SHIFT_RESOURCES
Severity Description
informational Resources from domain domain_name to domaindomain_name have been auto shifted.
OBJECT_ATTACHED_TO_DOMAIN
Severity Description
informational Object object_name of type object_type has beenadded to domain domain_name.
OBJECT_REMOVED_FROM_DOMAIN
Severity Description
informational Object object_name of type object_type has beenremoved from domain domain_name.
DOMAIN_MANAGED_ATTRIBUTE_SET
Severity Description
informational Domain domain_name managed attribute was setto managed_attribute.
REMOTE_SUPPORT_CONNECTED
Severity Description
informational System connected to remote support centerDestination.
UNABLE_TO_CONNECT_TO_REMOTE_SUPPORT
Severity Description
minor System is unable to connect to any remotesupport center.
554 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
REMOTE_SUPPORT_CONNECTION_LOST
Severity Description
variable Connection to remote support center Destinationfailed while the connection was in stateDisconnected Session State.
REMOTE_SUPPORT_TIMEOUT
Severity Description
variable Connection to remote support center Destinationtimed out while the connection was in stateDisconnected Session State.
REMOTE_SUPPORT_IMMINENT_TIMEOUT
Severity Description
minor System is about to disconnect busy connection toremote support center Destination.
REMOTE_SUPPORT_DEFINED
Severity Description
informational Defined remote support center Name with IPaddress Address and port Port.
REMOTE_SUPPORT_DELETED
Severity Description
informational Deleted remote support center Name.
REMOTE_SUPPORT_DISCONNECTED
Severity Description
variable System disconnected from remote support centerDestination while the connection was in stateDisconnected Session State.
REMOTE_SUPPORT_CLIENT_MOVED
Severity Description
informational The remote support client moved from Old Moduleto New Module.
REMOTE_SUPPORT_CLIENT_NO_AVAILABLE_MODULES
Severity Description
minor No live modules with Port Type ports are availableto run the remote support client.
Chapter 22. Events 555
TIMEZONE_SET
Severity Description
informational Timezone of the system was set to Timezone.
TIME_SET
Severity Description Troubleshooting
informational On Previous Time and Date dateand time of the system were setto Time and Date.
If date and/or time setting wasintended, there is no problem.
TRANSACTION_ROLLED_BACK
Severity Description
warning Configuration transaction was rolled back due tomodule failure. Preceding events may reflectchanges that were not committed.
ELICENSE_ACCEPTED
Severity Description
informational Electronic license was accepted by 'ApproverName'.
ELICENSE_VIOLATION
Severity Description Troubleshooting
warning Latest version of the electroniclicense was not approved.
Please approve the electroniclicense.
AUDIT_ENABLED
Severity Description
informational CLI command auditing activated.
AUDIT_DISABLED
Severity Description
warning CLI command auditing deactivated.
IB_PORT_ENABLE
Severity Description
informational Switch port switch_port has been enabled.
IB_PORT_DISABLE
Severity Description
informational Switch port switch_port has been disabled.
556 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
IB_PORT_MISWIRE
Severity Description Troubleshooting
warning Switch port miswired:switch_port shall connect toexpected_component but connectsto component with GUID guid.
Please contact support.
IB_PORT_MISWIRE_CORRECTED
Severity Description
informational Miswire on switch port switch_port has beencorrected.
IB_PORT_SHUTDOWN
Severity Description Troubleshooting
warning Infiniband port component hasbeen shutdown with reasonshutdown_reason.
Please contact support.
IB_PORT_TEST_FAILED
Severity Description Troubleshooting
warning Infiniband port component hasfailed component test withreason reason.
Please contact support.
IB_PORT_TEST_SUCCESS
Severity Description Troubleshooting
informational Infiniband port componentcompletes component test.
Please contact support.
IB_PORT_PHASEIN_FAILED
Severity Description Troubleshooting
warning Infiniband port component hasfailed to phase-in with reasonreason.
Please contact support.
IB_PORT_PHASEIN_SUCCESS
Severity Description Troubleshooting
informational Infiniband port componentcompletes phase-in.
Please contact support.
IB_LINK_DOWN
Severity Description
warning Link on switch_port (that connects to component) isdown.
Chapter 22. Events 557
IB_LINK_UP
Severity Description
informational Link on switch_port (that connects to component) isup.
IB_SWITCH_MISSING
Severity Description Troubleshooting
warning Switch ib_switch is missing. Please contact support.
IB_SWITCH_LOST
Severity Description Troubleshooting
warning Switch ib_switch that wasmissing is considered lost.
Please contact support.
IB_MISSING_SWITCH_FOUND
Severity Description
informational A previously missing switch ib_switch is nowfound.
IB_CONFIGURE_COMMAND_ERROR
Severity Description
warning Infiniband configuration command command hasfailed on component.
IB_PERF_COUNTER_RESET
Severity Description
informational Performance counter counter will be reset oncomponent.
PERF_CLASS_MAX_IO_RATE_UPDATED
Severity Description
informational Performance Class name max IO rate was changedto IO rate
PERF_CLASS_MAX_BW_RATE_UPDATED
Severity Description
informational Performance Class name max BW rate waschanged to BW rate
PERF_CLASS_CREATE
Severity Description
informational Performance Class with name 'name' was created
558 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
PERF_CLASS_DELETE
Severity Description
informational Performance Class with name 'name' was deleted
PERF_CLASS_ADD_HOST
Severity Description
informational Host with name 'host_name' was added toPerformance Class with name 'name'
PERF_CLASS_REMOVE_HOST
Severity Description
informational Host with name 'host_name' was removed fromPerformance Class with name 'name'
PERF_CLASS_ADD_POOL
Severity Description
informational Pool with name 'pool.name' was added toPerformance Class with name 'pool.perf_class'
PERF_CLASS_REMOVE_POOL
Severity Description
informational Pool with name 'pool.name' was removed fromPerformance Class with name 'name'
PERF_CLASS_ADD_VOLUME
Severity Description
informational Volume with name 'volume.name' was added toPerformance Class with name 'volume.perf_class'
PERF_CLASS_REMOVE_VOLUME
Severity Description
informational Volume with name 'volume.name' was removedfrom Performance Class with name 'name'
PERF_CLASS_ADD_DOMAIN
Severity Description
informational Domain domain_name was added to PerformanceClass name
PERF_CLASS_REMOVE_DOMAIN
Severity Description
informational Domain domain_name was removed fromPerformance Class name
Chapter 22. Events 559
VOLUME_MODIFIED_DURING_IO_PAUSE
Severity Description Troubleshooting
warning Volume 'vol_name' of CG'cg_name' was modified duringPause IO with token 'token'
Retry after completing CGchanges.
CONS_GROUP_MODIFIED_DURING_IO_PAUSE
Severity Description Troubleshooting
warning CG 'cg_name' was modifiedduring Pause IO with token'token'
Retry after completing CGchanges.
IO_PAUSED_FOR_CONS_GROUP
Severity Description
Informational Pause IO on CG with name 'cg_name' was startedwith timeoutms timeout . Token is 'token'.
IO_RESUMED_FOR_CONS_GROUP_EXPLICITLY
Severity Description
Informational Pause IO on CG with name 'cg_name' and token'token' was resumed by user request.
IO_RESUMED_FOR_CONS_GROUP_AUTOMATICALLY
Severity Description
Informational Pause IO on CG with name 'cg_name' and token'token' was resumed after snapgroup creation.
IO_RESUMED_FOR_CONS_GROUP_UPON_SYSTEM_ERROR
Severity Description
warning Pause IO on CG with name 'cg_name' and token'token' was resumed after system error.
IO_RESUMED_FOR_CONS_GROUP_UPON_TIMEOUT_EXPIRATION
Severity Description Troubleshooting
warning Pause IO on CG with name'cg_name' and token 'token' wascanceled after timeout.
Use longer timeout value orrequire less time for performingaction.
ALU_CREATE
Severity Description
informational ALU was defined with name 'ALU name'associated with host 'ALU host name' lun 'ALUlun'.
560 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
ALU_DELETE
Severity Description
informational ALU with name 'ALU name' associated with host'ALU host name' lun 'ALU lun' was deleted.
ALU_UNBOUND_ALL
Severity Description
informational All SLUs of ALU with name 'ALU name' wereunbound.
TXN_NODE_FLASH_CONNECTION_LOST
Severity Description
warning TXN node on 'module' is disconnected from flashsystem 'flash system'.
TXN_NODE_FLASH_CONNECTED
Severity Description
informational TXN node on 'module' is fully connected to flashsystem 'flash system'.
POD_IB_LINK_DETECTION_LINK_PERSISTENTLY_DISCONNECTED
Severity Description
critical IB link from Source to Target has reported aspersistently disconnected
POD_IB_LINK_DETECTION_LINK_PERSISTENTLY_CONNECTED
Severity Description
informational IB link from Source to Target has detected aspersistently connected
Chapter 22. Events 561
562 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Chapter 23. Return codes
This section contains descriptions of CLI return codes.
Return Code Error Description
0 Success.
1 Command execution failed.
2 No connection to the system.
3 Password is required.
4 Password does not match system password.
7 Command not allowed from this client.
8 Bad XCLI option.
9 Internal XCLI error.
© Copyright IBM Corp. 2016 563
564 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
Notices
This information was developed for products and services offered in the U.S.A.This material may be available from IBM in other languages. However, you may berequired to own a copy of the product or product version in that language in orderto access it.
IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:
IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.
For license inquiries regarding double-byte character set (DBCS) information,contact the IBM Intellectual Property Department in your country or sendinquiries, in writing, to:
Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.1623-14, Shimotsuruma, Yamato-shiKanagawa 242-8502 Japan
The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law:INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express orimplied warranties in certain transactions, therefore, this statement may not applyto you.
This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.
© Copyright IBM Corp. 2016 565
Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way itbelieves appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:
IBM CorporationAlmaden Research650 Harry RoadBldg 80, D3-304, Department 277San Jose, CA 95120-6099U.S.A.
Such information may be available, subject to appropriate terms and conditions,including in some cases, payment of a fee.
The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.
Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurements may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.
All statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.
This information is for planning purposes only. The information herein is subject tochange before the products described become available.
This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.
566 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
If you are viewing this information softcopy, the photographs and colorillustrations may not appear.
TrademarksIBM, the IBM logo, and ibm.com are trademarks or registered trademarks ofInternational Business Machines Corp., registered in many jurisdictions worldwide.Other product and service names might be trademarks of IBM or other companies.A current list of IBM trademarks is available on the Copyright and trademarkinformation website (www.ibm.com/legal/us/en/copytrade.shtml).
Other product and service names might be trademarks of IBM or other companies.
Notices 567
568 IBM FlashSystem A9000: Command-Line Interface (CLI) Reference Guide
IBM®
Printed in USA
SC27-8559-00