EMC Solutions Enabler Symmetrix Array Controls CLI Product Guide

EMC Solutions Enabler Symmetrix Array Controls CLIVersion 7.1.1Product GuideP/N 300-002-940REV A08EMC CorporationCorporate Headquarters:Hopkinton, MA 01748-91031-508-435-1000www.EMC.com

Copyright 2005 - 2010 EMC Corporation. All rights reserved.Published April, 2010EMC believes the information in this publication is accurate as of its publication date. The information is subject to changewithout notice.THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATION MAKES NOREPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION,AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULARPURPOSE.Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.For the most up-to-date regulatory document for your product line, go to the Technical Documentation and Advisories sectionon EMC Powerlink.For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.All other trademarks used herein are the property of their respective owners.2EMC Solutions Enabler Symmetrix Array Controls Version 7.1.1 CLI Product Guide

ContentsPart 1Concepts and ProceduresChapter 1Managing Configuration ChangesIntroduction .Mixed array environments.Configuration change session overview .Making configuration changes safely .Impact on I/O .Configuration operations supported .Setting Symmetrix metrics.Subsystem IDs for mainframe systems .Planning system protection configurations .Device mirrors.2-Way mirror protection.Parity RAID protection .SRDF remote protection .Managing disk groups .Naming a disk group .Managing devices .Creating devices.Copying a device .Managing metadevices .Creating metadevices.Meta configuration restrictions .Expanding an existing metadevice .Removing metamembers.Dissolving a metadevice.Configuring thin metadevices .Binding a thin metadevice to a pool .Data preservation concerns.Managing spare disks .Adding a spare disk .Deleting a spare disk.Viewing existing spares .Converting devices .Converting thin devices.Converting a metadevice.Changes to mirror protection .VDEV configuration restrictions .EMC Solutions Enabler Symmetrix Array Controls Version 7.1.1 CLI Product 9595959606161616162636565663

ContentsSAVE device configuration restrictions. 66RDF configuration changes . 66Device locking . 66Held devices . 67Setting device attributes . 68Setting device geometry . 69Showing device geometry . 70Setting device identifiers . 72Identifier exclusions. 72Viewing device identifiers . 73Deleting devices . 75Managing device reservations. 77Reserving devices. 77Committing changes on reserved devices. 78Viewing existing reserved devices . 79Releasing reserved devices . 80Configuring Virtual Provisioning . 81Creating DATA devices . 82Creating thin devices (TDEVs). 83Creating thin pools . 85Thin pool restrictions. 85Setting up Virtual Provisioning . 86Allocating space on a thin device . 87Space reclamation . 87Setting pool limits . 88Draining a thin pool. 89Automated pool rebalancing. 92Automated Pool Rebalancing. 93Managing device pools. 95Creating a device pool. 96Deleting a device pool . 97Adding devices to a pool . 97Removing devices from a pool . 97Enabling/disabling devices. 97Monitoring a device pool. 98Viewing a device pool . 99Viewing a thin pool . 99Mapping devices . 101Mapping CKD devices . 103Mapping a range of devices . 103Copying the mapping of a range of devices . 104Assigning PAV alias addresses to mapped devices . 104Removing PAV alias addresses from mapped devices . 105Unmapping devices . 106Unmapping a range of devices . 106Configuring dynamic RDF-capable devices. 108Enabling dynamic RDF on the device. 108Setting RDF group attributes. 110Adding/removing RDF mirrors . 112Add/remove mirror restrictions . 113Swapping RA groups. 115Swapping RDF devices. 116Setting port characteristics. 1174EMC Solutions Enabler Symmetrix Array Controls Version 7.1.1 CLI Product Guide

ContentsChapter 2Masking Devices with Auto-provisioning GroupsAuto-provisioning Groups .What’s different?.How it works.Discovering host HBAs.Creating groups and views .Creating storage groups .Creating port groups.Creating initiator groups .Creating a masking view.Managing masking views.Deleting masking views .Naming groups and views.Backing up and restoring views .Copying groups and views .Managing storage groups.Adding devices .Removing devices.Deleting storage groups.Managing port groups .Adding ports .Removing ports.Deleting port groups .Locking down a Fibre Channel ID .Managing initiator groups.Adding initiators .Removing initiators .Deleting initiator groups .Setting initiator group flags .Setting HBA flags .Replacing an HBA .Renaming an HBA.Using CHAP authentication .Displaying Auto-provisioning Group information .Listing masking views .Listing groups with verbose (-v) .Viewing group details.Listing device assignments .Listing initiator group devices.Auto-provisioning Groups examples .Chapter 145145147148149151Device MaskingDevice masking overview .How Symmetrix device masking works .Host access examples .Managing access for unsupported host platforms .Device masking controls overview .Database device locking .Supported topologies .Fibre Channel topology .Native iSCSI topology.Using the device masking database .Configuring device masking.Access control environment setup .EMC Solutions Enabler Symmetrix Array Controls Version 7.1.1 CLI Product Guide1541541541561571571581581591601611615

ContentsConfiguration steps . 161Identify configuration components. 161Initialize and update the database. 162Enable authentication . 163Recommendations for activating the configuration . 163Discovering host HBAs . 164Using alias names . 164Adding masked devices . 166Adding devices. 166Removing masked devices . 169Maintaining the device masking database . 171Initializing the database . 171Preventing unauthorized modification of the VCMDB . 171Managing a backup VCMDB file. 172VCMDB database types . 172Converting a VCMDB type . 173Restoring a backup VCMDB . 173Restoring a backup and converting its type. 173Blocking direct writes to the VCMDB. 173Viewing the VCMDB . 174Viewing the database . 174Viewing device capacity . 176Viewing HBA assignments. 176Viewing the login history table. 177Refreshing the database . 177Managing HBA initiators . 180Creating and renaming aliases. 180Swapping a new HBA for a failed HBA . 180Deleting HBA associations . 181Managing the Fibre Channel-to-host interface . 182Locking down a Fibre Channel ID . 182Setting device LUN visibility . 184Setting the LUN base/offset skip adjustment . 184Setting the HBA port flags. 186Setting the heterogeneous host configuration . 187Chapter 4Device Masking: iSCSI SetupiSCSI authentication overview . 192iSCSI CHAP authentication: Enginuity version 56xx . 193Requirements . 193Setting iSCSI authentication with the SYMCLI . 193Showing authentication information . 193Restoring authentication data and updating the iSCSI driver . 194iSCSI CHAP authentication: Enginuity version 57xx . 195Setting one-way CHAP authentication. 195Setting two-way CHAP authentication . 196Initializing an authentication database. 196Displaying authentication information . 197Backing up and restoring authentication information . 198iSCSI software driver configuration . 199Requirements . 199Installing the iSCSI software initiator . 199Configuring iSCSI with CHAP authentication. 200Configuring iSCSI for two-way chap authentication . 2076EMC Solutions Enabler Symmetrix Array Controls Version 7.1.1 CLI Product Guide

ContentsConfiguring iSCSI without CHAP authentication . 208RADIUS server configuration. 213Chapter 5Managing Network IPsecIntroduction .IPsec standard .IPsec and Symmetrix .SYMCLI IPsec management component .Viewing policy information .Command file scripting for creating/modifying policies .Command file syntax adding/modifying policies .Committing a policy-scripted command file.Deleting a policy-scripted command file .Chapter 6216216217219220224224229230Fully Automated Storage TieringWhat is FAST? .FAST configuration overview.Managing Symmetrix tiers .Tier restrictions.Creating Symmetrix tiers.Adding disk groups to a tier.Removing disk groups from a tier .Renaming tiers .Deleting tiers .Listing and showing tier information.Managing policies.Policy restrictions.Creating a FAST policy .Adding a tier to a policy .Modifying the storage group’s limit in a tier .Removing a tier from a policy .Renaming a policy .Deleting a policy .Listing and showing policies .Managing storage groups.FAST storage group and device restrictions.Creating storage groups .Adding and removing devices .Associating a storage group to a policy .Disassociating a storage group from a policy .Modifying the storage group priority .Displaying storage group associations.Managing the FAST controller .Enabling and disabling FAST .Displaying the FAST state .Managing time windows.Setting FAST control parameters .Displaying FAST control parameters .Displaying FAST plans .Approving a FAST plan.Declining a FAST plan .Displaying FAST information .FAST activity .EMC Solutions Enabler Symmetrix Array Controls Version 7.1.1 CLI Product 42552562582582602607

ContentsAudit log messages. 264FAST reports. 266Compliance report . 266Technology demand reports . 268Chapter 7Optimizing Array PerformanceWhat is Symmetrix Optimizer?. 276Configuration requirements . 277Enginuity 5773 and earlier. 278Enginuity 5874 and later . 278How does Symmetrix Optimizer work? . 279Performance metrics . 279Modeling service time . 279The analysis. 280Finding the best swap. 281Swap procedure for Enginuity 5874 and later . 281Swap procedure for Enginuity 5773 and earlier. 282Legality of swaps . 283Symmetrix Optimizer operations using SYMCLI . 284Enabling and Disabling Optimizer. 285Committing command file changes . 285Clearing the Optimizer statistics . 285Setting control parameters . 286Setting advanced parameters . 287Setting time windows . 288Clearing a time window.

EMC Corporation Corporate Headquarters: Hopkinton, MA 01748-9103 1-508-435-1000 www.EMC.com EMC Solutions Enabler Symmetrix Array Controls CLI Version 7.1.1 Product Guide P/N 300-002-940 REV A08