IBM FlashSystem A9000 Version 12.0.3 Command-Line Interface (CLI) Reference Guide IBM SC27-8559-03 Note Before using this document and the product it supports, read the information in “Notices” on page 629. Edition notice Publication number: SC27-8559-03. This publication applies to version 12.0.3 of IBM FlashSystem A9000 and to all subsequent releases and modifications until otherwise indicated in a newer publication. © Copyright IBM Corporation 2017. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About this guide ........... ix Removing a volume from its performance class .. 46 Intended audience ............ ix Adding a domain to a performance class .... 47 Conventions used in this guide ........ ix Removing a domain from its performance class .. 48 Related information and publications ...... ix Setting the rate for a performance class ..... 48 IBM Publications Center .......... x Listing host profiles ........... 50 Sending or posting your comments ....... x Updating the host profile .......... 50 Getting information, help, and service ...... x Removing the profile of the specified host .... 51 Enabling the host profiler.......... 52 Chapter 1. Overview of the Disabling the host profiler ......... 52 command-line interface (CLI) ..... 1 Chapter 3. Volume management Overview of the XCLI utility ......... 1 Installing and starting the XCLI ....... 1 commands ............. 55 Exiting an interactive XCLI session ...... 3 Clearing reservations of a volume ....... 55 Using the CLI .............. 3 Listing reservation keys .......... 55 Interactive and basic modes ........ 4 Listing volume reservations ......... 56 Understanding the command syntax ..... 5 Copying volumes ............ 57 Using identification parameters ....... 7 Creating a volume ............ 60 Display options ............ 10 Deleting a volume ............ 62 Running commands in batch mode ..... 13 Formatting a volume ........... 64 Displaying CLI help and the XCLI utility version 14 Listing volumes ............. 65 Listing a volume's extended attributes ..... 67 Chapter 2. Host and cluster Locking a volume ............ 68 management commands ....... 15 Renaming a volume ........... 70 Resizing a volume ............ 71 Adding a host to a cluster ......... 15 Unlocking a volume ........... 73 Creating a cluster ............ 16 Deleting clusters............. 17 Chapter 4. Volume snapshot Listing clusters ............. 18 Removing a host from a cluster........ 19 management commands ....... 77 Renaming clusters ............ 20 Changing a snapshot deletion priority ..... 77 Adding a port to a host .......... 20 Creating a snapshot ........... 78 Defining a new host ........... 22 Deleting a snapshot ........... 81 Deleting a host ............. 23 Duplicating a snapshot .......... 83 Listing hosts .............. 24 Formatting a snapshot ........... 84 Listing ports .............. 25 Listing snapshot information ........ 86 Removing a port from a host ........ 26 Restoring a volume from a snapshot ...... 87 Renaming a host............. 27 Updating a host definition ......... 28 Chapter 5. Consistency group Mapping a volume to a host or cluster ..... 30 management commands ....... 91 Listing the mapping of volumes to hosts or clusters 32 Adding a volume to a consistency group .... 91 Setting the special type of hosts or clusters .... 33 Creating consistency groups ......... 93 Listing hosts/clusters to which a volume is mapped 34 Deleting a consistency group ........ 94 Unmapping a volume from a host or cluster ... 35 Listing consistency groups ......... 96 Setting the default idle time before unmapping a Removing a volume from a consistency group... 97 volume ................ 37 Renaming a consistency group ........ 98 Retrieving the default idle time before unmapping a Suspending I/O execution on a consistency group 99 volume ................ 37 Resuming I/O execution ......... 101 Creating a performance class ........ 38 Listing the status of consistency groups with Deleting a performance class ........ 38 paused I/O .............. 102 Renaming a performance class ........ 40 Creating a cross-system consistency group.... 103 Listing details of performance classes...... 40 Associating an existing consistency group with a Adding a host to a performance class...... 41 cross-system consistency group definition .... 104 Removing a host from its performance class ... 42 Removing a consistency group from a cross-system Adding a pool to a performance class ..... 43 consistency group ............ 105 Removing a pool from its performance class ... 44 Adding a volume to a performance class .... 45 © Copyright IBM Corp. 2017 iii Adding a remote system name to a cross-system Setting the time zone ........... 163 consistency group definition ........ 106 Printing the current system version ...... 164 Removing a remote system from a cross-system Displaying the values of VPD parameters .... 164 consistency group ............ 107 Setting VPD parameters .......... 165 Listing cross-system consistency group definitions 108 Displaying the system's MIB file ....... 167 Retrieving remote systems in a specified Retrieving the electronic license acceptance status 168 cross-system consistency group ....... 109 Retrieving a fragment of the electronic license file 169 Deleting a cross-system consistency group.... 110 Accepting the electronic license agreement ... 170 Listing cross-system consistency group definitions 110 Enabling command auditing ........ 170 Disabling command auditing ........ 171 Chapter 6. Snapshot set management Displaying the command audit state...... 172 commands ............ 113 Configuring audit servers ......... 172 Checking the command audit state ...... 173 Snapshotting a consistency group....... 113 Enabling CIM service........... 174 Changing a snapshot group deletion priority ... 116 Disabling the CIM service ......... 175 Deleting a snapshot group ......... 117 Displaying the CIM service state ....... 175 Disbanding a snapshot group ........ 118 Duplicating a snapshot group ........ 119 Formatting a snapshot group ........ 121 Chapter 9. Remote target connectivity Listing snapshot groups .......... 122 commands ............ 177 Locking a snapshot group ......... 123 Setting the threshold of a link disruption duration Renaming a snapshot group ........ 124 that triggers an event........... 177 Restoring a consistency group from a snapshot Updating the target's mirroring configuration .. 178 group ................ 125 Activating connectivity to a remote target .... 179 Unlocking a snapshot group ........ 127 Deactivating connectivity to a remote target ... 180 Setting a snapshot group descriptor ...... 128 Defining connectivity to a remote target .... 181 Returning a snapshot group's descriptor .... 129 Deleting connectivity to a remote target .... 183 Listing target connectivity definitions ..... 184 Chapter 7. Storage pool management Defining a remote target.......... 185 commands ............ 131 Deleting a remote target .......... 187 Listing remote targets .......... 187 Moving a consistency group between storage pools 131 Allowing remote mirroring access ...... 188 Changing the pool limitation, performance class, or Activating a port ............ 189 threshold parameters ........... 133 Adding a new port to a remote target ..... 190 Changing pool settings for snapshots ..... 135 Deactivating a port ........... 191 Creating storage pools .......... 136 Deleting a port from a remote system ..... 193 Deleting a storage pool .......... 138 Listing the ports of a remote target ...... 194 Listing storage pools ........... 139 Renaming a remote target ......... 194 Renaming a storage pool ......... 141 Updating the target configuration ...... 195 Resizing a storage pool .......... 142 Moving a volume between storage pools .... 143 Chapter 10. Remote mirroring Chapter 8. System management commands ............ 197 commands ............ 147 Canceling a snapshot mirror (ad hoc sync job) .. 197 Creating a snapshot mirror (ad hoc sync job) ... 199 Displaying the values of configuration parameters 147 Activating mirroring ........... 204 Setting configuration parameters ....... 148 Changing the RPO for local or remote system .. 206 Testing the DNS ............ 150 Changing the designation of mirroring peers ... 208 Displaying help ............ 151 Changing the mirroring schedule for remote slave Displaying the current maintenance urgency ... 152 peers ................ 210 Shutting down the system ......... 152 Changing the roles of a mirrored volume .... 212 Listing the operational state ........ 154 Changing a mirroring schedule for local peers .. 215 Displaying system usage and data reduction Creating a mirroring definition ....... 217 statistics ............... 154 Deactivating mirroring .......... 223 Displaying information about effective and Deleting a remote mirroring definition ..... 225 physical capacity ............ 155 Viewing the mirroring status ........ 227 Displaying information about effective capacity 157 Obtaining statistics on past sync jobs ..... 230 Displaying system capacity thresholds ..... 157 Switching roles between master and slave .... 232 Changing a system capacity threshold ..... 159 Retrieving RPO thresholds ......... 234 Resuming the system's normal operation .... 160 Setting an RPO threshold ......... 235 Displaying the current time ........ 161 Changing the interval of a schedule ...... 236 Setting the system's time ......... 161 Creating a schedule