Dell VNX5600 VNX Command Line Interface Reference for Block 5.33
Dell VNX5600 Manual
View all Dell VNX5600 manuals
Add to My Manuals
Save this manual to your list of manuals |
Dell VNX5600 manual content summary:
- Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 1
EMC® VNX® Series Version 5.33 Command Line Interface Reference for Block P/N 300-015-135 REV. 08 March 2020 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 2
Copyright © 2013-2020 Dell Inc. or its subsidiaries. All rights reserved. Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS-IS." DELL MAKES NO - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 3
CONTENTS Preface Chapter 1 Chapter 2 15 About CLI Commands 17 naviseccli...18 VNX CLI for Block 21 Basic commands 22 Storage setup and management overview 22 Shared storage setup and management overview 23 alpa -get 24 alpa -set 25 arraycommpath 26 arrayconfig -capture 27 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 4
luncache -clear 116 luncache -list 117 managedby 118 managefiles -delete 118 managefiles -list 119 managefiles -retrieve 120 ndu -list 121 ndu -install 122 ndu -runrules 125 ndu -commit 126 ndu -status 127 ndu -revert 127 networkadmin -get 128 networkadmin -mib 132 networkadmin -route - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 5
Contents spcollect -set 166 spcollect 166 spportspeed 167 storagegroup 173 systemtype 184 trespass 185 unbind 186 unitserialnumber 187 LUN Expansion (metaLUN) commands 187 MetaLUNs overview 188 CLI metaLUN command functions 189 metalun -destroy 189 metalun -expand 190 metalun -info - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 6
Contents domain -add 251 domain -list 253 domain -remove 254 domain -uninitialize 255 domain -setmaster 256 ntp -list 257 ntp -set 258 security -adduser 260 security -changeuserinfo 261 security -list 262 security -listrole 263 security -rmuser 263 security -ldap -addserver 264 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 7
Chapter 3 Chapter 4 Contents -monitor -getlogsize 294 -monitor -setlogsize 295 -monitor -inserttestevent 295 -monitor -responsetest 296 -monitor -reloadconfig 297 Virtual server commands 298 Virtual server overview 298 server -volmap 299 server -update 301 server -getagent 301 server - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 8
-fast -create 369 cache -fast -destroy 370 cache -fast -info 370 Chapter 7 EMC Unisphere QoS Manager 373 About Unisphere Quality of Service Manager 374 QoS Manager prerequisites 374 QoS Manager CLI commands 374 nqm -getlatestperf 374 nqm -info 375 nqm -ioclass -create 376 nqm - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 9
Contents Chapter 8 Chapter 9 Chapter 10 nqm -archive -retrieve 402 EMC Unisphere Analyzer 405 About Unisphere Analyzer 406 Prerequisites 406 Analyzer CLI commands 406 analyzer -set 407 analyzer -get 408 analyzer -logging 408 analyzer -start 409 analyzer -stop 409 analyzer - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 10
Contents mirror -sync -changeimage 472 mirror -sync -create 473 mirror -sync -deallocatelog 475 mirror -sync -destroy 476 mirror -disablepath 477 mirror -enablepath 478 mirror -sync -fractureimage 479 mirror -sync -info 480 mirror -sync -list 482 mirror -sync -listsyncprogress 484 mirror - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 11
Contents Chapter 12 sancopy -unmark 542 sancopy -updateconnections 543 sancopy -verify 543 EMC SnapView Software 545 SnapView clone CLI commands 546 Setting up SnapView to use clones 546 CLI clone command functions 547 clone | snapview -addclone 548 clone | snapview -allocatecpl 550 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 12
VNX Snapshots 645 snapcli create 646 snapcli destroy 647 snapcli copy 647 snapcli attach 648 snapcli detach 650 EMC Secure Remote Support on the Storage Processor 651 ESRS Device Client on Storage Processor 652 esrsconfig -agentprovision 652 esrsconfig -agentstatus 653 esrsconfig - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 13
Contents Chapter 15 Data at Rest Encryption 659 Data at Rest Encryption overview 660 securedata -feature -activate 661 securedata -feature -info 662 securedata -backupkeys -status 663 securedata -backupkeys -retrieve 664 securedata -auditlog -retrieve 665 securedata -auditlog -cksum - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 14
Contents 14 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 15
as described in this document, please contact your Customer Support representative. Audience This guide is part of the EMC VNX documentation set, and systems. This version of the manual covers up to VNX systems running release 1.3 of Unisphere. Readers of this guide are expected to be familiar with - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 16
manual that service, go to Online Support (registration required) at http:// Support.EMC.com. Troubleshooting-Go to Online Support. After logging in, locate the applicable Support by Product page. Technical support-For technical support and service requests, go to Customer Service on Online Support - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 17
CHAPTER 1 About CLI Commands This chapter explains the EMC VNX CLI for Block commands. Major topic include: l naviseccli...18 EMC® VNX® Series Command Line Interface Reference for Block 17 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 18
About CLI Commands naviseccli Sends status or configuration requests to a system through the command line. PREREQUISITES Anyone that can log in to the server running VNX CLI for Block 4.30 or later. DESCRIPTION The naviseccli command sends system management and configuration requests to a system - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 19
the port number (type) of the system. The default is 443. If you choose to change the default port number, management port 2163 will be supported; however, you will need to specify the -port switch and number 2163 in every subsequent command you issue. -q Suppresses error messages. This switch is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 20
About CLI Commands home directory. If you want to store the security file in an alternative location, you can use the optional -secfilepath switch with the -addusersecurity command. Note: If you use the -secfilepath switch to set up an alternative path for your security file, you must use this - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 21
CHAPTER 2 VNX CLI for Block This chapter includes content for VNX series systems. Major topics include: l Basic commands...22 l LUN Expansion (metaLUN) commands 187 l Reserved LUN Pool commands 204 l iSCSI and FCoE commands 207 l LUN Migration commands 243 l Domain and Security commands 246 l - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 22
VNX CLI for Block Basic commands This section explains each of the basic variations, that is, the CLI commands that are common to all systems. Command variations for Storage Groups (Access Logix) are explained in the following chapter. Storage setup and management overview About this task This - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 23
VNX CLI for Block 3. Get SP memory information to prepare to set up the system cache. naviseccli -h ss1_spa getsp -mem SP A Memory Size For The SP: 12288 SP B Memory Size For The SP: 12288 4. For easy identification in the future, name the system. naviseccli -h ss1_spa arrayname users11 Change - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 24
the SP. We suggest you use a unique SCSI ID for each SP port in your installation. For example, on the first system, for ports 0 and 1, you can specify SCSI for Block software running on the SP does not support this command, a Not supported error message is printed to stderr. Other errors: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 25
the given port on an SP. CAUTION The SP port ID SCSI IDs are initially set by EMC service personnel to work at your site. Do not change any value unless you are installing a new SP and need to change its SCSI IDs from the SP ship values of 0 and 1. If you - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 26
VNX CLI for Block OUTPUT See above. If the version of VNX OE for Block software running on the SP does not support this command, a Not supported error message is printed to stderr. Other errors: VALID_VALUES_0_126 VALID_VALUES_0_3 arraycommpath Sets a communication path to a system that has no LUNs - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 27
VNX OE for Block software running on the SP does not support this command, a Not supported error message is printed to stderr. Other errors: Valid previous configuration is destroyed. The information captured may include: l Software installed in the system (name of the software, revision, and so - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 28
secondary system is used for duplication, then no mirror information will be created in the target system. Note: While the -capture command supports both XML and CSV file formats, the duplicate command processes information only in the XML format. CAUTION This command creates a new configuration - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 29
on the targeted system. -o Executes the command without prompting for confirmation. -recover Used in a disaster recovery situation (if the system in trouble needs to be reconfigured from scratch using a configuration captured from the same system when it was healthy). This assumes that the host - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 30
the arrayname from ss1 to users11? (y/n) y OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Not Supported error message is printed to stderr. backendbus -analyze Displays speed and state information for each back-end bus and the devices on the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 31
VNX CLI for Block Table 1 backendbus -analyze summary analysis (continued) a. If a limiting device or speed-related fault exists on the back-end bus, a listing of the limiting devices and speed-related faults appears before the summary analysis. Devices with speedrelated faults appear as Devices - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 32
VNX CLI for Block Disk 2 6 6 No SAS Disk 3 6 6 No SAS Disk 4 6 6 No SAS Disk 5 6 6 No SAS Disk 6 6 6 No SAS Disk 7 6 6 No SAS Disk 8 6 6 No SAS Disk 9 6 6 No SAS Disk 10 6 6 No SAS Disk 11 6 6 No SAS Disk 12 6 6 No SAS Disk 13 6 6 No SAS - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 33
VNX CLI for Block Disk D10 Unknown Unknown No Unknown Disk D11 Unknown Unknown No Unknown Disk E0 6 3 No SATA Disk E1 6 3 No SATA Disk E2 6 3 No SATA Disk E3 6 3 No SATA Disk E4 6 3 No SATA Disk E5 6 3 No SATA Disk E6 Unknown Unknown No Unknown Disk E7 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 34
VNX CLI for Block DESCRIPTION The naviseccli backendbus command with the -get -physical switches displays the physical location of the back-end bus on the VNX series system. The physical location information includes I/O module and the physical port ID. The backendbus -get -all command also displays - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 35
: TBD SPA SFP/Connector Vendor Serial Number: TBD SPB SFP/Connector Vendor Serial Number: TBD SPA SFP/Connector Supported Speeds: 3Gbps. 6Gbps. SPB SFP/Connector Supported Speeds: 3Gbps. 6Gbps. backendbus -get -sfpstate Displays the current condition of each back-end SFP. PREREQUISITES You must - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 36
VNX CLI for Block backendbus -get -speeds Displays back-end bus speed information for the back-end buses on a system. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli backendbus command with the -get -speeds function - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 37
VNX CLI for Block the back-end bus (I/O module and the physical port ID) only for the VNX series system. You can target a specific back-end bus and display information for only that bus, or you can display backend bus information for all buses on the system. The current speed indicates the speed the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 38
Vendor Part Number: N/A SPA SFP/Connector Vendor Serial Number: N/A SPB SFP/Connector Vendor Serial Number: N/A SPA SFP/Connector Supported Speeds: N/A SPB SFP/Connector Supported Speeds: N/A The following output shows the output for the backendbus -get -all command when the mini-SAS HD cable is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 39
SFP/Connector Vendor Part Number: SPA SFP/Connector Vendor Serial Number: SPB SFP/Connector Vendor Serial Number: SPA SFP/Connector Supported Speeds: 3Gbps. 6Gbps. SPB SFP/Connector Supported Speeds: 3Gbps. 6Gbps. TBD TBD TBD TBD The following example shows the output for the backendbus -get -all - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 40
VNX CLI for Block bus speed reset, the reset occurs. See the table below for the steps you should take before issuing backendbus -resetspeed. Note: This is a disruptive operation and can take several minutes to complete. During this time the system will be offline and no I/O will be performed. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 41
UUID of the system is set to 34. OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Not Supported error message is printed to stderr. Creates a LUN within an existing RAID group. PREREQUISITES For naviseccli, you must have a user account on the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 42
VNX CLI for Block Table 3 LUN parameters for different RAID types (continued) RAID type Bind parameters Write caching Disk (individual disk unit) LUN number Write caching To allow for good choices of available disk modules, bind LUNs in this order: 1. First - RAID 1/0 2. Second - RAID 6, RAID - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 43
VNX CLI for Block Table 5 Caching recommendations for different RAID types RAID type Write caching RAID 0 RAID 1 RAID 1/0 RAID 3 RAID 5 RAID 6 Disk Acceptable Acceptable Acceptable Recommended Highly recommended Highly recommended Acceptable Note: When binding RAID 1/0 LUNs, the order in which - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 44
types are not supported on all systems. lun Specifies a decimal number to assign to the LUN valid range as shown in VNX for Block Concepts guide, in section LUN specifies a number between 0 and the maximum number of RAID groups supported by the RAID group system. -cnt Specifies the number of LUNs - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 45
VNX CLI for Block -sq size-qualifier Sets the default size qualifier. size-qualifier specifies the qualifier as follows: mb megabytes gb gigabytes (the default) tb terabytes bc block count -wc write-cache Enables or disables the system write cache for this specific LUN. writecache values: 0 Disables - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 46
you initialize the cache memory card. The cachecard -initialize command can be issued under any of the following circumstances: l a different cache memory card is installed on the system l live data is on the cache memory card l a LUN with an offline (cache dirty) condition exists on the system 46 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 47
confirmation. EXAMPLE For this example, a different cache memory card is installed on the system. naviseccli -h ss1_spa cachecard -initialize The cache memory card currently installed in this system is not the same as the one previously installed in this system. In order for this system to function - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 48
VNX CLI for Block naviseccli -h ss1_spa cache -sp -info -state SP Read Cache State: Enabled SP Write Cache State: Enabled EXAMPLE #2 This example displays SP Cache performance statistics. naviseccli -h ss1_spa cache -sp -info -perfdata Cache Page size (KB) : 8 Read Hit Ratio : 100 Write Hit - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 49
use at least two switches with chglun and one of the switches must be the LUN number -l lun. Note: The chglun command does not support thin LUNs. To change a metaLUN, use the naviseccli command with the-modify switch, as described in metalun -modify. Table 7 Caching recommendations for different - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 50
LUN name. newname specifies the new name for the LUN. This switch applies only to systems running a version of VNX OE for Block software that supports storage group commands. The LUN name is displayed in the UI and has no other purpose. You cannot use the LUN name as a CLI command - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 51
use only one of the optional switches with chgrg and must specify the RAID group identification number, rgID. Note: The chgrg command does not support private RAID groups used in thin pools. SYNTAX chgrg rgID [-powersavings on|off] OPTIONS rgID Is the RAID group identification number. rgID specifies - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 52
VNX CLI for Block clearlog clearstats Clears the SP's error log. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli clearlog command deletes the contents of the SP's unsolicited error log. The command clears - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 53
date and time at the end of each command execution. The time is displayed at the end of command output. This is an optional switch supported on all CLI commands. This switch cannot work independently. cmdtime switch is used with the CLI commands. You must add the -cmdtime switch for each - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 54
VNX CLI for Block SYNTAX copytodisk sourcedisk [destdisk] [-o] OPTIONS sourcedisk Specifies the source disk. destdisk Specifies the destination disk. Note: The destination disk must be the same type as the source disk, and the same size or larger than the source disk. If the destination disk is not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 55
a RAID 1/0 or RAID 1 configuration, you can manually select the disks for the RAID group in an so on. Refer to the VNX for Block Concepts guide for more information about disk IDs to verify the format of the RAID group during the time of creation. The supported RAID types are r6, r5, r3, r1_0, r0 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 56
VNX CLI for Block -elementsize elementsize Enables the createrg command to accept an element size for RAID groups. However, only the 4+1 RAID5 unit type, on non-Flash drives, accepts an element size as large as 1024 sectors or blocks. If a size of 1024 is requested for RAID groups other than 4+1 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 57
system. -power Displays the input power information. -present Displays the current value, which is a sum of the present input power of all supported systems. The current value is computed as the 30-second average of the power consumption sampled every 3 seconds. -average Displays the average value - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 58
VNX CLI for Block Specifies the standby power supply ID on which to display the information. -all Displays the following: l System input power information l Data Mover enclosure inlet air temperatures and input power information l Array input power information l Disk-array enclosure inlet air - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 59
VNX CLI for Block Present(watts): 114 Rolling Average(watts): 114 Air Inlet Temperature Status: Valid Present(degree C): 24 Rolling Average(degree C): 24 DAE5S Bus 0 Enclosure 0 Input Power Status: Valid Present(watts): 163 Rolling Average(watts): 163 Air Inlet Temperature Status: Valid Present( - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 60
in What are the Initiator, Arraycommpath, and Failovermode settings for PowerPath, DMP, PVLinks, and native failover software, which is on EMC Online Support. The CLI may prompt for confirmation of some changes you specify unless you use the -o (override). To change the setting, enter y. This - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 61
VNX CLI for Block EXAMPLE The following example lists the faulted hardware components and MirrorView software sessions on the system: naviseccli -h ss1_spa faults -list OUTPUT Faulted Subsystem: APM00043806491 Enclosure SPE : Faulted Enclosure SPE Power B : Faulted Bus 0 Enclosure 0 : Faulted Bus 0 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 62
for an physical slot/port located on the targeted SP's I/O module. The physical slot ID refers to the I/O module slot. Note: "basemodule" is not supported on VNX8000 Block systems. -byusage mirrorview Turns flashing on/off for an I/O port depending on how the I/O port is being used. The only option - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 63
"|slotid] [on|off] OPTIONS "onboard"|"basemodule"|slotid If the slotID is not specified, an error message is displayed. Note: "basemodule" is not supported on VNX8000 Block systems. on|off Indicates whether flashing is turned on or off. EXAMPLE #1 naviseccli -h 10.244.211.36 flash -iomodule onboard - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 64
VNX CLI for Block flashleds getagent EXAMPLE #3 naviseccli -h 10.244.211.36 flash -iomodule basemodule 0 on I/O Module Basemodule: ON Turns the LEDs for disks in a specific enclosure or bus on or off. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 65
ESX Server and issuing this command to a virtual machine (VM), it cannot target the host agent because the Unisphere Host Agent is supported only on ESX Server. SYNTAX getagent [-cabinet] [-desc] [-mem] [-model] [-name] [-node] [-peersig] [-prom] [-rev] [-scsiid] [-serial] [-sig] [-type] [-ver] [-os - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 66
SCSI ID number for the SP is determined by switch settings on the SP. For information on these switch settings, see the system installation and maintenance manual. -serial Returns the serial number of the system. -sig Returns the unique SP signature. -spid Returns the SP identifier (A or B). -type - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 67
following output shows the enclosure type for Model VNX5400/VNX5600/VNX5800/ VNX7600 Block systems: Cabinet: DPE9 The if the feature is not activated or not supported. For example, SAN Copy items are displayed only if SAN Copy software is installed and activated. SYNTAX getall [-host] [-array - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 68
VNX CLI for Block OPTIONS -host Displays only information about the host and the agent that manage the system. This is a composite of information displayed by the getagent, remoteconfig, and ndu commands. -array Displays only information about the system and its hardware components such as fan and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 69
: DPE9 Name of the software package: -FASTCache Revision of the software package: Commit Required: NO Revert Possible: NO Active State: YES Is installation completed: YES Is this System Software: NO Name of the software package: -ThinProvisioning Revision of the software package: Commit Required: NO - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 70
VNX CLI for Block Revision of the software package: 05.33.000.1.486 Commit Required: NO Revert Possible: NO Active State: YES Is installation completed: YES Is this System Software: NO Name of the software package: INTERNAL_USE_ONLY-FBEAPIX Revision of the software package: 05.33.000.1.489 Commit - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 71
VNX CLI for Block Returns the iSCSI target name (iqn) for the system on a combo system. -all Returns both the system WWN and the iSCSI target name (iqn). Note: If you do not specify any switches, getarrayuid returns the system WWN on a system with an iSCSI and Fibre Channel combination controller, - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 72
VNX CLI for Block Displays SCSI mode page 8 information. -rep Displays periodic error report information: the number of reported errors or N/A. EXAMPLE naviseccli -h ss1_spa getconfig Sub-System Package Type: 20 Queue Full Status: DISABLED Recovered Errors: DISABLED Target Negotiate: Unknown - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 73
VNX CLI for Block -idle Returns the percentage of time the SP is idle. -read Returns the number of reads received by the SP. -rw Returns the following: Host read requests The number of read requests made by the host to the LUN Host write requests The number of write requests made by the host to the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 74
SP. The CLI lists the faulted components. Note: Command switches -cpua, -cpub, -dimma, -dimmb, -ioa, -iob, -mgmta, and mgmtb are supported only on Secure CLI. SYNTAX getcrus [-fana] [-fanb] [-fanc] [-lcca] [-lccb] [-spa] [-spb] [-lccrevb] [-lccsnb] [-spsa] [-spsb] [-lccreva] [-lccsna] [-cablingspsa - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 75
VNX CLI for Block [-encdrivetype] [-speeds] [-cpua] [-cpub] [-ioa] [-iob] [-dimma] [-dimmb] [-mgmta] [-mgmtb] [-bma] [-bmb] [bbua] [bbub] [-all] OPTIONS -bbua Returns the status of Battery Backup Unit on SP A. -bbub Returns status of Battery Backup Unit on SP B. -bma Returns status of Base Module - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 76
VNX CLI for Block Returns the state information of the LCC for SP B. -lccreva|-lccrevb Returns the revision of the DPE LCC A, LCC B, or both if you specify both switches. -lccsna|-lccsnb Returns the serial number of the DPE LCC A, LCC B, or both if you specify both switches. -mgmta Returns the state - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 77
VNX CLI for Block OUTPUT The following example shows the output from the getcrus -all command for the VNX5400/ VNX5600/VNX5800/VNX7600 Block systems. DPE9 Bus 0 Enclosure 0 Enclosure Drive Type: SAS, NL SAS Current Speed: 6Gbps Maximum Speed: 6Gbps SP A State: Present SP B State: Present - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 78
VNX CLI for Block getdisk Enclosure SPE SPS Module A Cabling State: Valid Enclosure SPE SPS Module B Cabling State: Valid Enclosure SPE CPU Module A State: Present Enclosure SPE CPU Module B State: Present Enclosure SPE SP A I/O Module 0 State: Present Enclosure SPE SP A I/O Module 1 State: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 79
] [-idleticks_SPA] [-idleticks_SPB] [-busyticks_SPA] [-busyticks_SPB] [-que] [-all] OPTIONS disk-position Returns status for a specific disk. Refer the VNX for Block Concepts guide, section on LUN IDs, unique IDs, and disk IDs to verify the format for specifying disks. When the disk-position is not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 80
VNX CLI for Block Returns the cumulative number of requests sent to a disk, while one or more requests were already outstanding. -bind Returns the percentage of the disk that is bound. -bndcrs Returns the number of Stripe Boundary Crossings (string value or Unknown). -busyticks Returns the amount - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 81
VNX CLI for Block Returns the total number of hard write errors for all the disk modules in the LUN that persisted through all the retries. A growing number of hard errors may mean that one or more of the LUN's disk modules is nearing the end of its useful life. -idleticks Returns the amount of - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 82
VNX CLI for Block Returns the RAID group (if any) associated with this disk. -sectors Returns the number of user sectors. -serial Returns the serial number of the disk. -sig Returns the bind signature, which was automatically assigned during the bind process. The Bind Signature value will be shown - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 83
: N/A Remapped Sectors: N/A Number of Reads: 0 Number of Writes: 0 Number of Luns: 1 Raid Group ID: 3 Clariion Part Number: DG118xxxxx3 Request Service Time: N/A Read Requests: 0 Write Requests: 0 Kbytes Read: 0 Kbytes Written: 0 Stripe Enabledary Crossing: 0 Drive Type: SAS Clariion TLA Part Number - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 84
N/A Remapped Sectors: N/A Number of Reads: 0 Number of Writes: 0 Number of Luns: 0 Raid Group ID: 0 Clariion Part Number: DG118032767 Request Service Time: N/A Read Requests: 0 Write Requests: 0 Kbytes Read: 0 Kbytes Written: 0 Stripe Boundary Crossing: None Drive Type: SAS Clariion TLA Part Number - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 85
getlog VNX CLI for Block Gets an SP or Event Monitor log. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli getlog command returns the entire SP or Event Monitor log (default), the newest entries to the log, - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 86
VNX CLI for Block getloop Gets fibre loop information. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli getloop command returns information about the fibre loop. This command is not valid for IRIX hosts. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 87
[-que] [-rc] [-rd3] [-rchm] [-reads] [-remap] [-rh] [-rhist] [-rr] [-rwr] [-service] [-sftscsi] [-srcp] [-stripe][-totque][-type] [-upb] [-was] [-wc] [-wch] [-uid] [-wh] unique IDs, and disk IDs in the VNX for Block Concepts guide for information about identifying LUN numbers. -aa Returns the auto- - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 88
VNX CLI for Block -addroffset Displays the starting LBA (logical block address) of the LUN. This address tells you where a LUN begins within a RAID group. -at Returns auto-trespass status (enabled or disabled). Shows FAST cache properties. -bp* Returns the number of blocks prefetched by read cache. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 89
Returns the MirrorView mirror name. -name Returns the LUN name. This switch applies only to systems running a version of VNX OE for Block software that supports storage group commands. LUN names are displayed in the UI. You cannot use the LUN name as a CLI command argument. Note: The -name switch - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 90
VNX CLI for Block -owner Returns the name of the SP that currently owns the LUN. If neither SP owns the LUN a value of Unknown is returned. -prb Returns the percentage of the LUN that is rebuilt. -private Returns information on all private LUNs in the system. -que Returns the queue length, a number. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 91
VNX CLI for Block -sor* Returns the sum of outstanding requests in SP A and SP B. -sqlah* Returns the sum of queue lengths on arrivals high. -srcp Returns the read cache configuration. -state Returns the state of the LUN. Valid states are: Expanding, Defragmenting, Faulted, Transitional, or bound. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 92
VNX CLI for Block Returns the number of write requests to a previously written address location whose data is still resident in cache. Write rehits form a subset of write cache hits since they overwrite already existing data in the write cache. -wh* Returns the write hit information, if statistics - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 93
VNX CLI for Block EXAMPLE #3 This example retrieves information about LUN number 0: (See sample listing following) naviseccli -h ss1_spa getlun 0 OUTPUT The following is a sample output. Actual output varies depending on the switches you use with the getlun command. LOGICAL UNIT NUMBER 0 Prefetch - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 94
only for the SPE enclosure on VNX systems. This information is displayed only when you use the -all switch. Only Secure CLI supports use of this switch. SYNTAX getresume [-sp] [-lcc busNumber enclosureNumber [lcca|lccb]] [-ps busNumber enclosureNumber|xpe [psa|psb]] [-pc] [-mp] [-sps] [-vendorinfo - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 95
VNX CLI for Block -pc Displays resume information for the SAN personality card. -ps busNumber enclosureNumber | xpe [psa|psb] Displays resume information for the power supply. If you omit psa or psb, information is returned for power supplies A and B. -sp Displays resume information for SPs. -sps - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 96
VNX CLI for Block Programmable Revision: 5.33:3.31:3.21:2.04 OUTPUT The following example shows sample output of resume information for I/O carrier device 0 on both SPs. Storage Processor A I/O Carrier 0 EMC Part Number EMC Artwork Revision EMC Assembly Revision EMC Serial Number Vendor Part - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 97
getrg EMC Product Part Number: 900-XXX-XXX EMC Product Revision: XX.XX.XX Bus 0 Enclosure 0 Chassis/Midplane EMC Part Number: 100-561-622 EMC Artwork Revision: D05 EMC Assembly Revision: A08 EMC Serial Number: FCNST064401287 Vendor Part Number: N/A Vendor Artwork Number: N/A Vendor Assembly Number: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 98
VNX CLI for Block OPTIONS rg Is the RAID group identification number. rg specifies a number between 0 and the maximum number of RAID groups supported by the system. -disks Returns the state of disks in the RAID group. -drivetype Returns information about what drive type the RAID group consists of. - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 99
VNX CLI for Block Returns the percent of expansion that is complete. The Percent expanded value is always shown as N/A on VNX. -state Returns the RAID group state, which may be one of the following: Invalid, Valid_luns, Halted, and Busy. -tcap Returns the raw and logical capacity of the RAID group - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 100
reports. You can retrieve reports for a specific LUN, all LUNs in a RAID group, or all LUNs in a system. Note: The getsniffer command does not support thin LUNs. SYNTAX getsniffer lun-number|-rg rg-number]| [-all] [-curr] [-rec] [-alltot] OPTIONS -all Retrieves reports on all LUNs in the system - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 101
VNX CLI for Block EXAMPLE Retrieves the report of the active full unit verify operation for LUN 0. naviseccli -h ss1_spa getsniffer 0 OUTPUT The following is a sample output. Actual output varies depending on the switches you use with the getsniffer command. VERIFY RESULTS FOR UNIT 0 Currently - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 102
VNX CLI for Block getsp Checksum errors 0 0 Write Stamp errors 0 0 Time Stamp errors 0 0 Shed Stamp errors 0 0 Coherency errors 0 0 Multi Bit CRC errors 0 0 LBA Stamp errors 0 0 Media errors 0 0 Soft Media errors 0 Gets the SP revision and serial number information. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 103
Memory Size For The SP: 131072 SP SCSI ID if Available: 0 EXAMPLE #2 The following command displays the enclosure type for VNX5400/VNX5600/VNX5800/VNX7600 Block systems. naviseccli -h ss1_spa getsp -type SP A Cabinet: DPE9 SP B Cabinet: DPE9 EXAMPLE #3 The following command displays the enclosure - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 104
VNX CLI for Block getsptime Gets the date and time setting on each SP system clock. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli command displays the time on the system clocks in one or both storage - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 105
VNX CLI for Block OUTPUT SP A Uptime: 51 days 10 hours 15 minutes SP B Uptime: 51 days 9 hours 45 minutes "N/A" is shown if the peer information could not be retrieved. getunusedluns Returns the number of LUNs not used by any storage group or by any replication applications. PREREQUISITES For - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 106
VNX CLI for Block OPTIONS -allentries Displays all entries, including those for any disk classes that ever appeared on the array. EXAMPLE This example lists all the hot spare policies for the classes of disks currently residing on the array. naviseccli hotsparepolicy -list OUTPUT The following is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 107
VNX CLI for Block -o Executes the command without prompting for confirmation. EXAMPLE This example changes the hot spare policy ratio to 1/15. naviseccli hotsparepolicy -set 1 -keep1unusedper 15 You are about to change the hotspare policy, do you want to change the ratio to 1/15 for SAS drives with - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 108
module and all I/O ports that exist on the given module. If the slot_num is not provided, the system returns an error. Note: "basemodule" is not supported on VNX8000 Block systems. -sp a | b 108 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 109
VNX CLI for Block Specifies the SP, either A or B. If an -sp switch is not specified, then information about the I/O module with the given slot_num for both SPs will be shown. -label Displays the IO Module Label information. -pportid Displays the physical port number. -portrole Displays whether the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 110
VNX CLI for Block I/O Module Substate: I/O Module Power state: I/O Carrier: I/O Module Label: Good On No 8 Gb Fibre Information about each port on this I/O module: Physical Port ID: 0 Port Role: FE Logical Port ID: 0 Port Usage: Special Port Type: Fibre Channel Port State: Enabled - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 111
VNX CLI for Block Is Persisted: Yes SP ID: I/O Module Slot: I/O Module Type: I/O Module State: I/O Module Substate: I/O Module Power state: I/O Carrier: I/O Module Label: A 3 iSCSI Present Good On No 10 GbE BaseT Information about each port on this I/O module: Physical Port ID: 0 Port Role: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 112
VNX CLI for Block Port Role: Logical Port ID: Port Usage: Port Type: Port State: Port Substate: Is Persisted: FE 11 Normal iSCSI Enabled Good Yes SP ID: I/O Module Slot: I/O Module Type: I/O Module State: I/O Module Substate: I/O Module Power state: I/O Carrier: I/O Module Label: A Base Module - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 113
VNX CLI for Block Logical Port ID: Port Usage: Port Type: Port State: Port Substate: Is Persisted: 1 Normal Fibre Channel Enabled Good Yes Physical Port ID: Port Role: Logical Port ID: Port Usage: Port Type: Port State: Port Substate: Is Persisted: 2 FE 2 Normal Fibre Channel Enabled Good Yes - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 114
VNX CLI for Block Port State: Port Substate: Is Persisted: Enabled Good Yes Physical Port ID: Port Role: Logical Port ID: Port Usage: Port Type: Port State: Port Substate: Is Persisted: 1 FE 7 Normal iSCSI Enabled Good Yes SP ID: I/O Module Slot: I/O Module Type: I/O Module State: I/O Module - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 115
VNX CLI for Block Information about each port on this I/O module: Physical Port ID: 0 Port Role: BE Logical Port ID: 0 Port Usage: Normal Port Type: SAS Port State: Enabled Port Substate: Good Is Persisted: Yes Physical Port ID: Port Role: Logical Port ID: Port Usage: Port Type: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 116
VNX CLI for Block ioportconfig -persist Writes the port configuration information to persistent memory. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli ioportconfig -persist command writes all port - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 117
pending writes on the LUN are lost. You must issue the command to the SP that owns the LUN. The luncache -clear command does not support thin LUNs. SYNTAX luncache lun-number -clear [-o] OPTIONS lun-number Specifies the LUN for which to clear the LUN offline condition. If you do not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 118
the command. DESCRIPTION The naviseccli managefiles command with the -delete function lets you delete SP logging files from supported directories. Note: The dumps and logs directories are supported for managefiles. You can specify the files you want to delete by using the -all or -file switches - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 119
is deleted. OUTPUT None if the command succeeds; status or error information if it fails. managefiles -list Lists SP logging files in supported directories. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 120
use this switch, the file is copied to the current directory. -all Retrieves all files from the supported directory. -file filenames Retrieves the specified files from the supported directory. -o Executes the command without prompting for confirmation. EXAMPLE This command shows you all file index - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 121
nondisruptive upgrades on VNX series systems. This command lets you install and upgrade system software without disrupting any I/O from attached servers. Thirdparty software installation is not supported. This means you can use ndu to install VNX OE for Block software bundles or enablers. Use the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 122
See previous page. If the version of VNX OE for Block software running on the SP does not support this command, a Not supported error message is printed to stderr. ndu -install Transfers SP software driver packages to the system private LUN (PSM LUN). PREREQUISITES For naviseccli, you must have - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 123
guarantee a successful install. In addition to the user access requirements for the ndu command, the validation check has associated configuration requirements that you must follow: l Create the required user accounts on the system (refer to the VNX for Block Concepts guide, section Getting Started - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 124
the original sizes because the new software requires more memory than the version that it replaced. The software prompts for information as needed; then it installs or upgrades the specified software packages and restarts the SPs. The SPs then load and run the new packages. After successful - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 125
YES Disruptive upgrade: NO The requested package(s) will be installed. Do you wish to proceed? : (y/n)?y OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Not supported error message is printed to stderr. Other error message(s): NDU_NOT_SUPPORTED - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 126
package. Every package does not require commit. If a package needs to be committed and it is not committed, all new features of the newly installed package may not be available. A committed package cannot be reverted. It can be uninstalled. Note: You cannot create any new RAID groups or bind - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 127
If the version of VNX OE for Block software running on the SP does not support this command, a Not supported error message is printed to stderr. ndu -status Returns the status of the ndu install, commit, or revert operations. PREREQUISITES For naviseccli, you must have a user account on the system - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 128
cancel the command. Note: Use the naviseccli ndu -list command to display installed package information. SYNTAX ndu -revert [-delay seconds] namelist [-o] OPTIONS -delay Block software running on the SP does not support this command, a Not supported error message is printed to stderr. Other errors - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 129
VNX CLI for Block DESCRIPTION The naviseccli networkadmin command with -get function without switches lists all the network information for an SP. This command supports IPv6 network communication to the management ports of systems with VNX OE for Block version 04.28 or later. If you do not specify - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 130
. -mode Displays the IPv4/IPv6 status. The statuses are automatic, manual, and disabled. -speed Displays the current port speed for a specified no value if the feature is turned off, and a not supported value if the feature is not supported. Note: If you have the auto-negotiate feature turned on, - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 131
half/full duplex 100Mbps half/full duplex 1000Mbps half/full duplex Auto Virtual Port ID: 0 VLAN ID: 102 Storage Processor IP Mode: Manual Storage Processor IP Address: 10.5.2.178 Storage Processor Subnet Mask: 255.255.255.0 Storage Processor Gateway Address: 10.5.2.1 Storage Processor IPv6 Mode - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 132
mib [-enable] [-disable] [-community string] [-o] OPTIONS -enable Enables the SNMP services. -disable Disables the SNMP services. -community newstring Sets the SNMP community string to newstring. Note: The -community switch is supported only with ManagementServer release 28 or later. -o Executes the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 133
the SNMP services on SP A. naviseccli -h ss1_spa networkadmin -mib -disable Disable processing of SNMP read requests on SP A (y/n)[n] OUTPUT Storage Processor: SP A SNMP MIB Status: Disabled Community: public If the version of VNX OE for Block software running on the SP does not support this - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 134
VNX CLI for Block Specifies the IPv4 subnet mask value for the route entry. The default value is 255.255.255.255. It is valid only for an IPv4 destination address. -prefixlength length Specifies the prefix length and the part of the address to compare while determining the route. The default value - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 135
changes one or more network settings for an SP. This command supports IPv6 network communication to the management ports of systems with VNX OE current settings, use the networkadmin command with the -get function. EMC service personnel set the network properties initially to work at your site. Do - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 136
] Specifies whether you want to enable IPv6 on the SP automatically, disable IPv6 on the SP, or enable IPv6 on the SP manually. If you choose manual, also choose whether to set either a global prefix or a specific IPv6 address, and a gateway. -globalprefix prefix Changes the SP's IPv6 global prefix - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 137
the IPv6 Mode to Manual on SP A, Port 0, Virtual Port 0 This operation will cause a management server restart! Do you wish to continue? (y/n) OUTPUT See the description section of this command. If the version of VNX OE for Block software running on the SP does not support this command, a Not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 138
VNX CLI for Block port Invalid command line parameters Invalid speed request Lists SP port information, removes an HBA entry from an SP's initiator list, and provides diagnostic capabilities. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 139
ports connected to this storage group. -usage (CX4 series only) Indicates how the port is used. For example, when either of the MirrorView enablers is installed, it displays MirrorView. -prominfo EMC® VNX® Series Command Line Interface Reference for Block 139 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 140
VNX CLI for Block Displays the new EEPROM information for SFP+ SFPs inserted into the front-end ports. -unitserialnumber Specifies the unitserialnumber mode. -writes Displays the number of writes for each port. The optional port -removeHBA switches are: -hbauid HBAUID Removes a specific initiator - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 141
VNX CLI for Block Initiator Type: 3 StorageGroup Name: Private Information about each HBA: HBA UID: 20:00:00:00:C9:21:FE:D5:10:00:00:00:C9:21:FE:D5 Server Name: 20:00:00:00:C9:21:FE:D5:10:00:00:00:C9:21:FE:D5 Server IP Address: UNKNOWN HBA Model Description: HBA Vendor Description: HBA - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 142
VNX CLI for Block Defined: NO Initiator Type: 128 Information about each HBA: HBA UID: 00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF Server Name: abc.example.com Server IP Address: 10.10.10.2 HBA Model Description: HBA Vendor Description: HBA Device Driver Name: Information about each - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 143
VNX CLI for Block EXAMPLE #2 The following example shows sample output of the port -list -all command targeted to Fibre Channel HBAs and SPs. naviseccli -h ss1_spa port -list -all Total number of initiators: 1 SP Name: SP A SP Port ID: 1 Registered Initiators: 0 Logged-In Initiators: 0 Not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 144
VNX CLI for Block SP Name: SP B SP Port ID: 0 HBA Devicename: \\.\SCSI3:0:0:0 Trusted: NO Logged In: YES Source ID: 8327680 Defined: YES Initiator Type: 3 StorageGroup Name: None ArrayCommPath: 1 Failover mode: 1 Unit serial number: Array EXAMPLE #3 The following example shows - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 145
VNX CLI for Block Port Status: Online Switch Present: Not Applicable EXAMPLE #4 The following example shows sample output of the port -list -mac command targeted to an iSCSI system. naviseccli -h 10.14.80.107 port -list -sp -mac Information about each SPPORT: SP Name: SP B SP Port ID: 0 SP - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 146
VNX CLI for Block SP UID: 50:06:01:60:90:21:26:3D:50:06:01:60:10:21:26:3D Link Status: Up Port Status: Online Switch Present: YES Switch UID: 10:00:08:00:88:60:8E:77:20:0D:08:00:88:60:8E:77 SP Source ID: 7998739 MAC Address: Not Applicable SP Name: SP B SP Port ID: 1 SP UID: 50:06:01:60:90:21: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 147
VNX CLI for Block SP Name: SP Port ID: MAC Address: SP Name: SP Port ID: MAC Address: SP Name: SP Port ID: MAC Address: SP Name: SP Port ID: MAC Address: SP Name: SP Port ID: MAC Address: SP Name: SP Port ID: MAC Address: SP Name: SP Port ID: MAC Address: SP Name: SP Port ID: MAC Address: SP Name: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 148
042 SFP/Connector EMC Serial Number: 000000000000000 SFP/Connector Vendor Part Number: N/A SFP/Connector Vendor Serial Number: AGL1211D3004397 SFP/Connector Supported Speeds: 2Gbps 4Gbps 8Gbps 0 General EXAMPLE #8 The following example shows sample output of the port -list -sfpstate command - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 149
ID: 3 SFP/Connector EMC Part Number: SFP/Connector EMC Serial Number: SFP/Connector Vendor Part Number: SFP/Connector Vendor Serial Number: SFP/Connector Supported Speeds: 2Gbps 4Gbps 8Gbps ... TBD TBD TBD TBD TBD TBD TBD powersaving Enables or disables the power saving settings. PREREQUISITES For - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 150
VNX CLI for Block rebootSP EXAMPLE naviseccli -h IP address powersaving -info System Idle Time: 15 min Global Power Saving Settings: On Reboots an SP. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION This command reboots - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 151
VNX CLI for Block EXAMPLE #2 naviseccli -h ss1_spa rebootSP -both Error: rebootSP command failed Before you can execute the rebootSP command, you need to either disable write cache or override the warning. To disable write cache, run the "naviseccli -h IPAddress cache -sp -modify -wc off" command. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 152
VMware ESX Server and issuing this command to a virtual machine (VM), it cannot target the host agent because the Unisphere Host Agent is supported only on ESX Server. The naviseccli remoteconfig command with -getconfig displays information on the agent running on an SP. To display information on - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 153
VNX CLI for Block remoteconfig -setconfig Changes configuration information for a host or SP agent. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli remoteconfig command with -setconfig changes the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 154
getconfig. If the version of VNX OE for Block software running on the SP does not support this command, a Not supported error message is printed to stderr. Other errors: RAC_AGENT_NOT_RUNNING RAC_REMOTECONFIG_NOT_SUPPORTED INVALID_MEGAPOLL INVALID_USEEXPLICITDEVNAME RAC_FILE_NOT_FOUND Removes a RAID - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 155
return the SP to service. Note: Issue rebootpeerSP after you issue resetandhold, when you are ready to return the SP to service. SYNTAX resetandhold EXAMPLE functions accessed via responsetest are decentralized, providing email and pager support from local systems only. The EMC phone home feature is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 156
with descriptive text using -file. [-sender sender_email_address] Specifies the sender address; optional. If omitted, CLI inserts the agent hostname as the sender_email_address. -modempage (Not supported on AX4-5 series and AX series) 156 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 157
sc_off VNX CLI for Block -destnumber phone-number Specifies the pager phone number (with area code) and is required. -msgnumber phone-number Specifies the number that will appear on the pager display (with area code). [ -comport number ] Specifies the number of the PC COM. If omitted, the CLI - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 158
VNX CLI for Block OPTIONS -o Executes the command without prompting for confirmation. EXAMPLE naviseccli -h ss1_spa sc_off OUTPUT The first time you run the sc_off command, you will see an output similar to the following: You have asked to remove all shared storage components from the indicated - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 159
for the verify process. You can indicate a specific LUN, all LUNs in a RAID group, or all LUNs in a system. Note: The setsniffer command does not support thin LUNs. SYNTAX setsniffer lun-number| [-rg rg-number] [-all] [-bv] [-cr] OPTIONS -all Applies sniffer parameters to all LUNs in the system. The - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 160
VNX CLI for Block EXAMPLE Starts a background verify on LUN 0. naviseccli setsniffer 0 -bv OUTPUT There is no output. Errors are printed to stderr. setsniffverify Enables or disables sniff verify on all the disks on the array. PREREQUISITES For naviseccli, you must have a user account on the system - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 161
VNX CLI for Block setspstime Sets SPS or BBU battery test time. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli setspstime command sets the SPS battery test time. If no switches are specified, the command - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 162
VNX CLI for Block setstats SYNTAX setsptime [-M month-num] [-D day-num] [-Y year-num] [-h hour-num ] [-m minute-num] OPTIONS -M month-num Specifies the month (1-12). -D day-num Specifies the day (1-31). -Y year-num Specifies the year; use four digits. -h hour-num Specifies the hour (0-23). -m - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 163
VNX CLI for Block shutdown OPTIONS setstats -on|-off Enables/disables the performance statistics logging. Note: If statistics logging is off, certain options in other commands are disabled. The options for the other commands specify whether statistics logging must be on for their options to be - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 164
VNX CLI for Block naviseccli -h ss1_spa shutdown Before you shutdown the system, stop all I/O from any servers connected to the system and save all unsaved data to disk. During the shutdown process you will lose access to all data on the LUNs but you will not lose any data. When you power up the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 165
setting appears as Enabled when the SPCollect automated functionality is turned on; Disabled when it is turned off. The automated SPCollect service is part of the Peerwatch service included with VNX OE for Block version 02.19.xxx.5.yyy or higher. SYNTAX spcollect -info EMC® VNX® Series Command Line - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 166
-info OUTPUT AutoExecution: Enabled spcollect -set Sets the automated SPCollect service on or off. PREREQUISITES You must have a user account on automated SPCollect process on or off. The automated SPCollect service is part of the Peerwatch service included with VNX OE for Block version 02.19. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 167
Note: This command is not related to the automated SPCollect service that is part of the Peerwatch service included with VNX OE for Block version 02.19.xxx.5.yyy . For a port speed to work, the HBA, switch, and SP must all support it. You can set the ports of an SP to different speeds if the ports - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 168
off. The CLI returns a yes value if the feature is turned on, a no value if the feature is turned off, and a not supported value if the feature is not supported. Note: If you have the Auto-Negotiate feature turned on, the Speed Value that is generated in the output does not have - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 169
Speeds: 2Gbps 4Gbps 8Gbps Auto Requested Value: Auto Connection Type: Fibre Channel I/O Module Slot: Onboard Physical Port ID: 4 SFP Supported Speeds: 2Gbps 4Gbps 8Gbps Storage Processor : Port ID : 3 Speed Value : Auto Negotiable : Available Speeds: 2Gbps 4Gbps 8Gbps Auto - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 170
EXAMPLE #2 naviseccli spportspeed -get -sfp Storage Processor : SP A Port ID : 0 Speed Value : 8Gbps SFP Supported Speeds: 2Gbps 4Gbps 8Gbps Storage Processor : SP A Port ID : 1 Speed Value : 8Gbps SFP Supported Speeds: 2Gbps 4Gbps 8Gbps Storage Processor : SP A Port ID : 2 Speed Value : N/A SFP - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 171
: No Available Speeds: 2Gbps 4Gbps 8Gbps Auto Requested Value: Auto Connection Type: Fibre Channel I/O Module Slot: 0 Physical Port ID: 1 SFP Supported Speeds: 2Gbps 4Gbps 8Gbps Storage Processor : SP A Port ID : 2 Speed Value : N/A Auto Negotiable : No Available Speeds: 2Gbps 4Gbps 8Gbps Auto - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 172
: No Available Speeds: 2Gbps 4Gbps 8Gbps Auto Requested Value: 4Gbps Connection Type: Fibre Channel I/O Module Slot: 0 Physical Port ID: 3 SFP Supported Speeds: 2Gbps 4Gbps 8Gbps Storage Processor : SP B Port ID : 0 Speed Value : N/A Auto Negotiable : No Available Speeds: 2Gbps 4Gbps 8Gbps Auto - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 173
from 1 Gigabit to 2 Gigabit ? y OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Not supported error message is printed to stderr. storagegroup Creates and configures storage groups. PREREQUISITES For naviseccli, you must have a user account - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 174
VNX CLI for Block The storagegroup command has many switches, some of which have functions that you also indicate with switches. SYNTAX storagegroup [-addhlu switches] | [-addsnapshot switches] | [-chgname switches] | [-connecthost switches] | [-create switch] | [-destroy switch]| [-disconnecthost - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 175
VNX CLI for Block storagegroup command, -addsnapshot switch -addsnapshot -gname StorageGroupName| -uid StorageGroupUID -hlu hlunumber -snapshotname snapshotname| -snapshotuid snapshotuid Adds a snapshot to a storage group. The storage group you choose should be different from the source LUN storage - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 176
VNX CLI for Block Connects the specified host to the specified storage group. It connects all of the host's HBA/SP combinations to the storage group by assigning the host's initiator records to the storage group. To assign a storage group to a specific HBA, use storagegroup -setpath. You may use - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 177
VNX CLI for Block storagegroup command, -list switch -list [-gname StorageGroupName| -uid StorageGroupUID] -host Displays information about the specified storage group. When no storage group is specified, list displays information about each user-defined storage group in the system. You can use one - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 178
needed for failover software. Use this command with certain types of failover software as suggested in the failover software release notice or manual. Changing the failovermode setting may force the system to reboot. The CLI will issue a confirmation request that indicates whether a system reboot is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 179
command. Note: For information about when to use these failover modes, refer to the Installation Roadmap for CLARiiON Storage Systems, which is on EMC Online Support. 0 Failover mode 0. 1 Failover mode 1. 2 Failover mode 2. 3 Failover mode 3. 4 Failover mode 4. Example with failovermode: naviseccli - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 180
VNX CLI for Block 0x13 Dell 0x16 Fujitsu 0x1c Compaq Tru64 -unitserialnumber [array|lun] The unitserialnumber command displays or sets the VDPP80 behavior mode, which defines how subsequent VPDP80 requests will be populated with the system serial number. You might need to do this for software such - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 181
needed for failover software. Use this command with certain types of failover software as suggested in the Installation Roadmap for CLARiiON Storage Systems, which is on EMC Online Support. Changing the failovermode setting may force the system to reboot. The CLI will issue a confirmation request - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 182
storage group unique ID. -unitserialnumber array|lun Sets the unit serial number operation mode. Use this switch if the software instructs you to. -o Executes the command without prompting for confirmation. storagegroup command, -shareable switch -shareable [-gname StorageGroupName [yes|no] | -uid - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 183
VNX CLI for Block 0 20:00:00:00:C9:39:40:C8:10:00:00:00:C9:39:40:C8 SP A 0 HLU/ALU Pairs: HLU Number ALU Number 0 15 1 14 2 13 3 11 4 10 5 9 6 7 7 6 8 5 9 3 10 2 11 1 Shareable: YES EXAMPLE #3 The following examples creates two storage groups, connects them to - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 184
VNX CLI for Block naviseccli -h 10. 4. 78. 184 -user a -password a -scope 0 port -list -failovermode Information about each port of this HBA SP Name : SP A SP Port ID : 0 Failover Mode : 4 naviseccli -h 10. 4. 78. 186 -user a -password a -scope 0 port -list -all HBA UID: 20 : 20 : 20 : 20 : 20 : - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 185
trespass VNX CLI for Block A HP-UX type with auto-trespass off; use this if your HP-UX system does not have the PVLINKS feature. 2 HP-UX type with auto-trespass on; use this if your HP-UX system has the PVLINKS feature. 3 Open system (default) 9 SGI (CX600) 13 Dell 16 Fujitsu 1C HP type -o Executes - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 186
VNX CLI for Block unbind Note: If trespass is executed while I/O processes are active, I/O errors may occur. SYNTAX trespass [all | lun lun-number | mine] OPTIONS all Trespasses all LUNs in the system. lun lun-number Trespasses one LUN (specified by lun-number). mine Performs whatever trespassing - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 187
VNX CLI for Block EXAMPLE #1 This command destroys (deconfigures) LUN 3 without prompting you for permission, and frees its disks to be reconfigured. naviseccli -h ss1_spa unbind 3 -o EXAMPLE #2 This command destroys (deconfigures) LUNs 0, 1, 2, 3, and 4 without prompting you for permission, and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 188
VNX CLI for Block MetaLUNs overview A metaLUN is a type of LUN whose maximum capacity is the combined capacities of all the LUNs that compose it. The metaLUN feature lets you dynamically expand the capacity of a single LUN (primary LUN) into a larger unit called a metaLUN. You do this by adding LUNs - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 189
VNX CLI for Block Note: EMC does not recommend that you expand LUN capacity by concatenating LUNs of different RAID types. Do this only in an emergency situation when you need to add capacity to a LUN and you do not have LUNs of the same RAID type or the disk capacity to bind new ones. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 190
VNX CLI for Block OPTIONS -metalun number| WWN Specifies the unique number or World Wide Name of the metaLUN you want to destroy. Use only one of the identifiers with the -metalun command. Use the metalun -list command to determine the number or WWN of the metaLUN (see metalun -list). -o Executes - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 191
to bind the destination LUN before running the command. See the Prerequisite section above for requirements and recommendations. Note: Thin LUNs do not support metaLUNs, so you cannot create metaLUNs using thin LUNs. For raw device mapping volumes (RDMs), if you are running VMware ESX Server, after - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 192
LUNs. In order for the host to have access to the added capacity, you must wait for the session to complete and then follow the instructions in Using the added capacity of an expanded SnapView, MirrorView or SAN Copy LUN. 192 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 193
system is powered up. If you do not specify a default owner, it defaults to the owner of the primary LUN. -elszm elementSizeMultiplier (Not supported on AX4-5 series systems running Unisphere) Sets the stripe element size for a metaLUN component. You determine this by multiplying the stripe size of - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 194
you can add to the LUN or metaLUN. The size qualifier for the -cap number is the sq switch. -sq tb|gb|mb Mandatory switch, supported with Navisphere Express, that specifies the size qualifier for the capacity of the metaLUN component. where: tb equals terabytes, gb equals gigabytes, and mb equals - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 195
of metaLUNs in the system. -maxmetaluns Displays the maximum number of metaLUNs that the system will support (based on system type). See the EMC Unisphere Release Notes for currently supported values. -maxcomponents Displays the maximum number of components allowed per metaLUN for this system (based - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 196
VNX CLI for Block OUTPUT Can a LUN or a Meta-LUN be expanded on this system: Yes Number of Meta-LUNs in the system: 7 Maximum Number of Meta-LUNs per system: 1024 Luns that are participating in Meta-LUNs: 513 512 515 514 517 516 519 518 521 52 0 523 522 525 524 Luns that are available for expansion - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 197
VNX CLI for Block -metalunnumber metaLUN-number Lists all information for that specific metaLUN. Issuing the -metalunnumber command without a metaLUN-number displays the numbers for all metaLUNs on the system. -aac* Displays the active/active counters associated with the metaLUN. -actualusercap - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 198
VNX CLI for Block No The specified metaLUN cannot be expanded. -defaultowner Lists the default SP owner of all metaLUNs on the system. Issuing the -defaultowner command with a metaLUN name, number or WWN lists the default SP owner of the specified metaLUN. -drivetype Displays the drive type for - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 199
VNX CLI for Block Returns read histogram information for all metaLUNs on the system. Note: A read histogram is an system of 10 locations that contain the number of reads. Element n of the system contains the number of reads that were larger than or equal to 2n-1 and less than 2n blocks in size. For - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 200
VNX CLI for Block write histogram overflows, which are the number of writes that were larger than 512 blocks. Issuing the -whist command with a metaLUN name, number or WWN returns the write histogram for the specified metaLUN. EXAMPLE This command requests information on all metaLUNs that are - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 201
|gb|mb|bc] [-tomaxcap] OPTIONS -metalun number|WWN Specifies the number or WWN of the metaLUN whose properties you want to change. -autoassign 1|0 (Not supported on AX4-5 series systems) Enables or disables auto assign for a metaLUN. Specify 1 to enable auto assign and 0 to disable it. If you do not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 202
VNX CLI for Block -cap capacity Specifies the capacity of usable space in the metaLUN. The capacity must be smaller than the maximum capacity of the metaLUN, and greater than or equal to the current capacity (user capacity of the LUN or metaLUN before adding LUNs). Note: If you want to modify the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 203
VNX CLI for Block For LUNs in a SnapView session About this task To access the added capacity of an expanded snapshot source LUN: Procedure 1. Stop all SnapView sessions and destroy all snapshots associated with the expanded source LUN (see the SnapView Command Line Interface (CLI) Reference and the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 204
It also describes the CLI commands that you can use if SnapView is installed on your system. reserved -lunpool -addlun Adds a LUN to the reserved will be participating in a session. Note: This command does not support the thin LUNs. Replication sessions include SnapView sessions and any reserved - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 205
about the reserved LUN pool. You can obtain more specific information with function switches. Note: This command does not support the thin LUNs. SYNTAX reserved -lunpool -list [-allocatedluns] [-chunksize] [-freeluncount] [-freeluns] [-freesize] [-luncount] [-percentused] [-size] [-used] OPTIONS - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 206
22 4.488281 1.292969 0.017639 0.393005 128 2 249 91.852825 250 0 If the version of software running on the SP does not support this command, a Command is not supported error message is printed to stderr. reserved -lunpool -rmlun Removes one or more LUNs from the reserved LUN pool. PREREQUISITES For - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 207
really want to remove the luns from LUN pool. (y/n)[N]? y OUTPUT If the version of software running on the SP does not support this command, a Command is not supported error message is printed to stderr. iSCSI and FCoE commands This section explains each of the naviseccli Internet SCSI (iSCSI) and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 208
path from a connection set. iSNS commands isns -addserver Adds an iSNS server to a system's iSNS service configuration. isns -deleteserver Deletes an iSNS server from a system's iSNS service configuration. isns -listserver Displays all iSNS servers that are configured in the system's iSNS - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 209
naviseccli iSCSI commands (continued) Command isns -setprimary Description Sets a configured iSNS server as the primary server for a system's iSNS service configuration. connection -adduser Adds a CHAP authentication user. PREREQUISITES You must have a user account on the system on which you want - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 210
VNX CLI for Block Hexadecimal secrets must consist of at least 12 and no more than 16 pairs of data (24 to 32 characters). -hexsecret If initiator user account data is being added, including the -hexsecret parameter specifies that -secret is a hexadecimal value. -o Executes the command without - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 211
VNX CLI for Block -o Executes the command without prompting for confirmation. If you include the -o switch, you will not be prompted to confirm the user account deletion. If you do not use the -o switch, you will be prompted to confirm that you want to delete the user account data. EXAMPLE The - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 212
VNX CLI for Block Specifies the iSCSI CHAP username for the initiator or target user being specified by initiatorName. EXAMPLE The following example gets information on the current user: naviseccli connection -getuser OUTPUT Initiator Name: iqn.1991-05.com.microsoft:cpc7745 User Name: Guest Defined - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 213
VNX CLI for Block -subnetmask Displays the network mask for the specified iSCSI ports. The subnet mask uses the quaddotted notation. For example, 255.255.255.0. -gateway Displays the network gateway address that the specified iSCSI ports use. The gateway address uses the quad-dotted notation. For - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 214
VNX CLI for Block SP: A Port ID: 5 Port WWN: iqn.1992-04.com.emc:cx.apm00093300877.a5 iSCSI Alias: 0877.a5 SP: A Port ID: 6 Port WWN: iqn.1992-04.com.emc:cx.apm00093300877.a6 iSCSI Alias: 0877.a6 IP Address: 172.20.2.140 Subnet Mask: 255.255.255.0 Gateway Address: 172.20.2.1 Initiator - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 215
iSCSI Alias: N/A IP Address: N/A Subnet Mask: N/A Gateway Address: N/A Initiator Authentication: N/A SP: B Port ID: 8 Port WWN: 50:06:01:60:BB:20:13:0D:50:06:01:68:3B:24:13:0D iSCSI Alias: N/A IP Address: N/A Subnet Mask: N/A Gateway Address: N/A Initiator Authentication: N/A EXAMPLE #2 naviseccli - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 216
VNX CLI for Block EXAMPLE #5 naviseccli connection -getport -portid 8 -speed SP: A Port ID: 8 Port WWN: 50:06:01:60:BB:20:13:0D:50:06:01:60:3B:24:13:0D iSCSI Alias: N/A IP Address: N/A Subnet Mask: N/A Gateway Address: N/A Initiator Authentication: N/A Port Speed: 10000 Mb Auto-Negotiate: No - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 217
VNX CLI for Block Port ID: 5 Port WWN: iqn.1992-04.com.emc:cx.apm00093300877.a5 iSCSI Alias: 0877.a5 Port Speed: 0 Mb Auto-Negotiate: Yes Available Speeds: 10 Mb - : 100 Mb - : 1000 Mb - : Auto Current MTU: 0 Available MTU Sizes: "1260","1448","1500","1548","2000","2450","3000","4000 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 218
VNX CLI for Block Port ID: 5 Port WWN: iqn.1992-04.com.emc:cx.apm00093300877.b5 iSCSI Alias: 0877.b5 Port Speed: 0 Mb Auto-Negotiate: Yes Available Speeds: 10 Mb - : 100 Mb - : 1000 Mb - : Auto Current MTU: 0 Available MTU Sizes: "1260","1448","1500","1548","2000","2450","3000","4000 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 219
VNX CLI for Block Enode MAC Address: 00-60-16-3B-55-42 Port Speed: 0 Gb Auto-Negotiate: No Available Speeds: 10 Gb Current MTU: 2240 Available MTU Sizes: "2240" Virtual Port ID: 0 VLAN ID: N/A IP Address: N/A Subnet Mask: N/A Gateway Address: N/A Initiator Authentication: N/A VN_Port MAC Address: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 220
VNX CLI for Block Virtual Port ID: 0 VLAN ID: 101 IP Address: N/A Subnet Mask: N/A Gateway Address: N/A Initiator Authentication: N/A VN_Port MAC Address: 0E:FC:00:2B:0B:04 EXAMPLE #9 naviseccli -h peregrine-spa connection -getport -sp a -mac -all SP: A Port ID: 9 Port WWN: 50:06:01:60:BB:20:13: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 221
VNX CLI for Block Flow Control: Auto Host Window: 256K Replication Window: 256K Available Window Sizes: 64K,128K,256K,512K,1MB Virtual Port ID: 0 VLAN ID: Disabled IP Address: 172.20.1.140 Subnet Mask: 255.255.255.0 Gateway Address: 172.20.1.1 Initiator Authentication: Not Available SP: A Port - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 222
VNX CLI for Block Available Speeds: 10 Mb - : 100 Mb - : 1000 Mb - : Auto Current MTU: 1500 Available MTU Sizes: "1260","1448","1500","1548","2000","2450","3000","4000","4080","4470","5000"," 6000","7000","8000","9000" Flow Control: Auto Host Window: 256K Replication Window: 256K - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 223
VNX CLI for Block 6000","7000","8000","9000" SP: B Port ID: 9 Port WWN: 50:06:01:60:BB:20:13:0D:50:06:01:69:3B:24:13:0D iSCSI Alias: N/A Port Speed: 10 Gb Auto-Negotiate: No Available Speeds: 10 Gb Current MTU: 2240 Available MTU Sizes: "2240" Flow Control: Auto Host Window: 256K Replication Window - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 224
VNX CLI for Block iSCSI Alias: N/A Port Speed: 0 Gb Auto-Negotiate: No Available Speeds: 10 Gb Current MTU: 2240 Available MTU Sizes: "2240" Virtual Port ID: 0 VLAN ID: N/A IP Address: N/A Subnet Mask: N/A Gateway Address: N/A Initiator Authentication: N/A connection -setport Modify the properties - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 225
VNX CLI for Block Disables VLAN tagging on the virtual port. -address address Specifies the IP address of the iSCSI port. The address uses the dotted-quad format. For example: 165.152.36.35. -subnetmask subnetmask Specifies the subnetwork mask for the iSCSI port. The subnet mask uses the dotted-quad - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 226
VNX CLI for Block EXAMPLE #2 naviseccli connection -setport -hostWindow 32K -o Request failed. Invalid window size: 32K. Available Window Sizes: 64K, 128K, 256K, 512K, 1MB OUTPUT None if the command succeeds; status or error information if it fails. connection -delport Deletes a virtual port. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 227
VNX CLI for Block connection -route Sets up the static routes to specific hosts or networks. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli connection command with the -route function is used to set up - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 228
will ping. The address is a 32bit numeric address written as four numbers separated by periods, for example, 128.221.56.52. Network names are not supported. -packetSize packetSize Specifies the size of the packets in bytes. The default is 32 bytes, the minimum is 0 bytes, and the maximum is 2048 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 229
that the iSCSI port will attempt to contact. The address uses the dotted-quad format, for example, 128.221.56.52. Network names are not supported. -portid portid Specifies the port on the SP, either 0 or 1. For example, an SP with one port has port 0; an SP with two ports has - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 230
VNX CLI for Block -sp a|b Specifies either SP A or SP B. -delays delays Specifies a delay in seconds between datagrams. The default is 1 second, the minimum is 1 second, and the maximum is 10 seconds. -packetSize packetSize Specifies the size of the echo packets in bytes. The default is 32 bytes, - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 231
VNX CLI for Block Specifies the CHAP username used by the initiator when challenged by the target system. For CHAP, a username and secret must be defined. -secret secret Specifies the CHAP secret to be used with the username when challenged by the target system. You can specify the secret in ASCII - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 232
VNX CLI for Block OUTPUT None if the command succeeds; status or error information if it fails. connection -getsharedauth Displays the username and status of the shared authentication for the iSCSI initiator system PREREQUISITES You must have a user account on the system on which you want to - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 233
VNX CLI for Block -digest none | Header | Data | Both Indicates the type of digest, a data protection mechanism, which is turned on for connections established through this connection set. Header indicates that the iSCSI packet headers have a checksum applied and verified. Data indicates that the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 234
VNX CLI for Block SYNTAX connection -delset -name name [-o] OPTIONS -name name Specifies a unique identifier for the connection set. It is an arbitrary name supplied by the administrator that indicates the specific connection set using the CLI or UI. -o Executes the command without prompting for - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 235
VNX CLI for Block -authpolicy none | shared | setspecific Defines the type of authentication this connection set uses. none specifies that no credentials are needed to connect to the target system. shared specifies that the system shared authentication credentials are used for authentication. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 236
VNX CLI for Block EXAMPLE The following example lists a specific connection set: connection -getset -name MirrorSet OUTPUT Connection Set Name: MirrorSet User Name: username Authentication Usage: SetSpecific Header Digest: Disabled Data Digest: Disabled IP Address of Target: 192.168.0.1 Listening - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 237
VNX CLI for Block -portid portid Specifies the front-end port number on the storage processor of the initiating system to be used for the session. -vportid vportid Specifies the virtual port number for the session. If you do not specify the virtual port number, then the system defaults to virtual - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 238
VNX CLI for Block OUTPUT None if the command succeeds; status or error information if it fails. connection -modifypath Modifies the parameters of a connection path. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 239
VNX CLI for Block OUTPUT None if the command succeeds; status or error information if it fails. connection -verifypath Tests the parameters of a connection path. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli connection - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 240
.33.44. -o Executes the command without prompting for confirmation. EXAMPLE The following example adds the specified iSNS server, to the system's iSNS service configuration: naviseccli -address ss1_spa isns -addserver 111.222.33.44 Adding an iSNS server with the following IP address: 111.222.33.44 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 241
the command succeeds; status or error information if it fails. isns -listserver Displays all iSNS servers that are configured in the system's iSNS service. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli isns command with - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 242
is not configured, you will receive an error message. Use this command when you want to change the primary server in a system's iSNS service configuration. You can also use this command to re-establish a primary server after a failover. When a failure occurs that takes the existing primary server - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 243
virtual machine will now recognize the completed migration. For configuration specifications, go to the E-Lab Interoperability Navigator on EMC Online Support. SYNTAX migrate -start -source number|WWN -dest number|WWN -rate low|medium| high|ASAP|value [-destroySnapshots] [-o] OPTIONS -source number - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 244
VNX CLI for Block Specifies the LUN migration rate. Valid rates are low or 0, medium or 1, high or 2, and ASAP or 3. Note: Do not use the ASAP migration rate when the system is in production, as the normal host I/O may be interrupted. Use ASAP only when the system is offline (free of any hostlevel - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 245
VNX CLI for Block migrate -modify Modifies a LUN migration session. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli migrate command with the -modify switch modifies a LUN migration session according to the parameters you - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 246
VNX CLI for Block [-rate] [-state] [-percentcomplete] [-timeremaining] OPTIONS -source number|WWN Specifies the source LUN of the migration. You can specify the LUN ID or World Wide Name (WWN). If you specify the -source switch with a LUN, the command lists properties for only that migration. If you - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 247
All domain and system settings, and global and local accounts (cannot delete the last global administrator account) Currently, the following security administrator roles are supported only on CX and CX3 series systems running VNX OE for Block version 02.26.xxx.yyy.zzz or higher. EMC® VNX® Series - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 248
VNX CLI for Block Table 12 Operations that users with different roles can perform (continued) User role Security Administrator Manager Monitor Local Replication Replication Replication and recovery Can view Can add, modify, or delete All security-related features, global and local accounts All - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 249
. You must map groups and/or users from the LDAP-compliant directory service to their roles (Administrator and Monitor) using the security -ldap commands and user groups in the LDAP server directory. This feature also supports advanced functions, such as specifying attributes for which user IDs and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 250
VNX CLI for Block navisecclidomain and security commands provides the list of security -ldap commands used to configure the LDAP settings. Domain and security commands overview The commands in this section include the domain and security commands. The following table identifies the commands. Table - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 251
-setport Sets the http/https ports that Unisphere uses. security -trustedclient -enable Enables or disables IP Filter for all storage systems supporting filtering. security -trustedclient -add Adds an IP Filter to the storage system. security -trustedclient -list Lists the current IP Filters - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 252
them are provided, the user account, sysadmin with global scope is used as a default user to operate on the system. Only one IP address is supported. If multiple IP addresses are provided, displays the error message, Invalid Command. Too many parameters Please also make sure only ONE ip address is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 253
VNX CLI for Block 111.222.33.45 Proceed? (y/n) y EXAMPLE #2 naviseccli -h 10.14.22.33 -user a -password a -scope global domain -add 10.14.33.44 -olduser b -oldpassword b -scope global EXAMPLE #3 If any of the switches, -olduser, -oldpassword, or -oldscope are missing, the following error messages - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 254
VNX CLI for Block EXAMPLE The following example lists the systems in the system domain: naviseccli -address 111.222.33.44 domain -list OUTPUT Node: IP Address: (Master) Name: Port: Secure Port: IP Address: Name: Port: Secure Port: APM00011111111 111.222.33.55 CX300I_33_55 80 443 111.222.33.44 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 255
VNX CLI for Block -o Executes the command without prompting for confirmation. EXAMPLE The following example removes the specified system, from the system domain: naviseccli -address ss1_spa domain -remove 111.222.33.44 WARNING: You are about to remove the following node from the domain: 111.222.33. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 256
VNX CLI for Block -setmaster IPADDRESS -list [-master] naviseccli -h 10.244.211.132 domain -uninitialize 10.244.211.132 WARNING: You are about to remove the domain and security configuration. Proceed? (y/n) y domain -setmaster Sets a system as the master system in a domain. PREREQUISITES You - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 257
ntp -list OUTPUT None if the command succeeds; status or error information if it fails. VNX CLI for Block Lists the NTP configuration settings in effect in a domain. PREREQUISITES You must have a user account on the system on which you want to execute the command. Only a security administrator or - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 258
VNX CLI for Block 0 true NTPProvider - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 259
VNX CLI for Block Specifies the list of IPv4 NTP server addresses. At least one address must be specified. -serverkey sk1 [sk2...] Specifies the list of the integer values (1-65534 inclusive). This option is required if server authentication is desired. An ordered list is in the same order as - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 260
VNX CLI for Block security -adduser Creates a user account. PREREQUISITES You must have a user account on the system on which you want to execute the command. The software package VNX-Block-Operating-Environment must be committed before this operation is allowed. DESCRIPTION The naviseccli security - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 261
VNX CLI for Block EXAMPLE The following example creates the initial global administrator account on the system. You are then prompted to create a domain for the system you specify: naviseccli -address ss1_spa security -adduser -user a -password b -scope global -role administrator Global security is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 262
-list function, lists the username, scope, role of user accounts, and type of account. Note: The security -list command is supported on all Unisphere systems. SYNTAX security -list [-user username] [-scope global|local] [-role administrator|storageadmin|operator|securityadministrator|dataprotection - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 263
VNX CLI for Block EXAMPLE The following example lists users with the specified scope and role: naviseccli -address ss1_spa security -list -role monitor -scope global OUTPUT Username: c Role: monitor Scope: global security -listrole Lists the user's security role. PREREQUISITES You must have a - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 264
new external server login configuration. Only a Unisphere security administrator or administrator can connect your system to an LDAP or Active Directory (AD) service. After defining the server connection settings, and mapping the user's roles, users can log in to the system with their LDAP username - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 265
VNX CLI for Block -portnumber portnumber Specifies the port number that the server will open to allow external programs to access it. If the protocol is LDAP, the default port number is 389. If the protocol is LDAPS, the default port number is 636. -servertype LDAP|AD Specifies whether the server is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 266
The naviseccli security -ldap command with the -modifyserver subcommand modifies the settings that connect your system to an LDAP or AD service. Consult with the LDAP/AD site administrator to determine the correct parameters. Only the security administrator or administrator can execute this - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 267
VNX CLI for Block -bindpassword password Credentials used to authenticate the bind DN. If you specify the length of other options such as -binddn, the length of bindpassword should also be specified here. The bindpassword cannot exceed 512 characters. -ldapserver IPaddress Specifies the network IP - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 268
VNX CLI for Block Name Attribute parameter. The default value for an LDAP directory is uniqueMembers and the default for an AD is member. It cannot exceed 128 characters. -userobjectclass userobjectclass Defines the required and optional attributes so that the user entry can act as a search filter - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 269
have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli security -ldap -listserver command lists the existing service connections, that the IP address of the LDAP server identifies. You can use the optional switches to list a particular server. Only the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 270
VNX CLI for Block groupmemberattribute Alternate Server UserObjectClass(optional): userobjectclass Alternate Server GroupObjectClass: groupclass OUTPUT None if the command succeeds; status or error information if it fails. security -ldap -addrolemapping Creates a new role mapping. PREREQUISITES - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 271
entity from Unisphere for the corresponding external server. Only the Unisphere administrator can remove user or group role mappings to an LDAP or AD service. You can delete all role mappings using the -all switch. To delete a particular role mapping, specify the -name and -type switch. EMC® VNX - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 272
VNX CLI for Block SYNTAX security -ldap -removerolemapping IPaddress [-name name -type group| user] | [-all] [-o] OPTIONS IPaddress Specifies the network IP address (IPv4) of the LDAP or the Active Directory server. -name name -type group|user Deletes role mapping with a specified role mapping name - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 273
ldap command with the -synchronize subcommand manually synchronizes the accounts with the current service. SYNTAX security -ldap -synchronize command imports the certificate from the certificate file. Secure CLI supports BASE64PEM format certificate. SYNTAX security -certificate -add -file filename - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 274
VNX CLI for Block -role role Specifies the role you want to apply to the client certificate. EXAMPLE naviseccli security -certificate -add -file c:\Node1.cer security -certificate -remove Removes the specified certificate. PREREQUISITES You must have a user account on the system on which you want - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 275
VNX CLI for Block OPTIONS -showOnly expired Lists only the expired certificates. -client Lists the client SSL certificates. EXAMPLE naviseccli security -certificate -list OUTPUT Subject: CN=TrustedRoot,C=US,ST=MA,L=Hopkinton,[email protected],OU=CSP,O=RSA Issuer: CN=TrustedRoot,C=US,ST= - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 276
VNX CLI for Block SYNTAX security -certificate -alertBeforeExpiration DAYS OPTIONS -alertBeforeExpiration DAYS Sets the number of days to send an alert before the certificate expires. Valid values are from 0 to 366. EXAMPLE naviseccli security -certificate -alertBeforeExpiration 10 OUTPUT None if - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 277
VNX CLI for Block SYNTAX security -SPcertificate -generate EXAMPLE naviseccli security -SPcertificate -generate OUTPUT None if the command succeeds; status or error information if it fails. security -fipsmode -set Sets the FIPS (Federal Information Processing Standards) mode of Unisphere. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 278
. It is only available for block-only arrays. It is not supported by unified systems. For unified systems, use the nas_tls command on the Control Station. Refer to the "VNX Command Line Interface Reference for File User Guide" for a description of the nas_tls command. PREREQUISITES You must have - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 279
y OUTPUT None if the command succeeds; status or error information if it fails. security -tls -get Gets the TLS protocols that are supported. It is available for Block-only arrays and unified systems. PREREQUISITES You must have a user account with an Administrator role or a Security Administrator - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 280
subcommand enables or disables IP Filtering for all storage systems supporting filtering. SYNTAX security -trustedclient -enable yes|no [-o] OPTIONS or Unisphere Domain. Administrators and security administrators can extend remote service tool access to a storage system's management ports by entering - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 281
VNX CLI for Block Applies the filter to the connected storage system only (single) or all storage systems in the domain (all). -o Executes the command without prompting for confirmation. EXAMPLE naviseccli security -trustedclient -add -ipaddress 10.238.74.171 -applyto all WARNING: You are about to - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 282
Monitoring overview The Event Monitor is an enterprise tool that supports centralized or distributed monitoring of storage systems in a heterogeneous systems. Once configured, the Event Monitor runs continuously as a service or daemon, observing the state of all specified storage systems and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 283
VNX CLI for Block Table 15 naviseccli Event Monitor commands (continued) Command -portal -destroy -template -list -template -import -template -export -template -destroy -template -findconflict -template -swap -monitor -addsystem -monitor -removesystem -monitor -listmapping -monitor -applytemplate - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 284
VNX CLI for Block OPTIONS -system portalsystemname Specifies the portal system. -server hostagentname Specifies the host agent. EXAMPLE eventmonitor -portal -create -system cx380_123_227 -server 10.32.123.205 OUTPUT None if the command succeeds; status or error information if it fails. -portal - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 285
VNX CLI for Block EXAMPLE eventmonitor -portal -migrate -source cx380_123_223 -dest cx380_123_227 OUTPUT None if the command succeeds; status or error information if it fails. -portal -destroy Deletes the host agent from the portal system. PREREQUISITES For naviseccli, you must have a user account - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 286
VNX CLI for Block SYNTAX eventmonitor -template -list OUTPUT The templates in the database are listed; none if the templates are not available. -template -import Imports the template files. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 287
VNX CLI for Block -filepath localfilepath Specifies the local file path. EXAMPLE eventmonitor -template -export -templatename Template_Test -filepath D:\Templates\ OUTPUT None if the command succeeds; status or error information if it fails. -template -destroy Deletes the templates. PREREQUISITES - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 288
VNX CLI for Block OPTIONS -resolve Resolves the template conflict. EXAMPLE eventmonitor -template -findconflict -resolve OUTPUT The sample output is as follows: Event Template from host is in conflict with the template in the database. How do you want to resolve the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 289
VNX CLI for Block -monitor -addsystem Adds the system to be monitored. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli -monitor command with the -addsystem function adds the specified system to the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 290
VNX CLI for Block EXAMPLE eventmonitor -monitor -removesystem -server 10.32.123.205 -system cx380_123_223 OUTPUT None if the command succeeds; status or error information if it fails. -monitor -listmapping Lists the storage template mappings. PREREQUISITES For naviseccli, you must have a user - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 291
VNX CLI for Block SYNTAX eventmonitor -monitor -applytemplate [-server hostname] [-system system name] -templatename templatename OPTIONS -server hostname Applies the template to the specified centralized monitor as a global template. -system system name Applies the template to the specified - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 292
n entries in the log, with the oldest entry first. -N Displays the newest n entries in the log, with the newest entry first. OUTPUT Audit Logging Service 01/27/2009 14:41:46 N/A (4612)NaviCLI.exe application was started by the user, following was the application detail Process Id : 2540 Path :C:\emc - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 293
VNX CLI for Block -monitor -enableresponse Enables the response from the specified monitor. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli -monitor command with the -enableresponse function enables the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 294
VNX CLI for Block -system system name Disables the response from the distributed monitor. -time Specifies the time in minutes. -o Executes the command without prompting for confirmation. EXAMPLE eventmonitor -monitor -disableresponse -system cx380_123_223 -time 30 eventmonitor -monitor - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 295
VNX CLI for Block -monitor -setlogsize Sets the log size of the monitor. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli -monitor command with the -setlogsize function changes the log size of Event Monitor - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 296
VNX CLI for Block OPTIONS -server hostname Specifies the host agent. OUTPUT None if the command succeeds; status or error information if it fails. -monitor -responsetest Creates an artificial event. PREREQUISITES For naviseccli, you must have a user account on the system on which you want to - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 297
VNX CLI for Block The message describes the event and -file specifies a file with descriptive text. [-sender sender_email_address] Specifies the sender address. If omitted, the CLI inserts the agent hostname as the sender_email_address. -destnumber destnumber Specifies the pager phone number (with - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 298
VNX CLI for Block OPTIONS -server hostname Specifies the host agent. OUTPUT None if the command succeeds; status or error information if it fails. Virtual server commands This section explains the virtual server commands to configure virtual center/ESX credentials. Virtual server overview The - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 299
VNX CLI for Block server -volmap Lists the volume map information. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli server -volmap command lists the volume map information. If the host is an ESX server (ESX_1), then it - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 300
VNX CLI for Block Logical Drives: F:\ Physical Device: \\.\PhysicalDrive18 LOGICAL UNIT WWN: 60:06:01:60:36:F7:22:00:2A:48:A4:C1:57:0E:DE:11 SNAPSHOT admhost_snapshot1_0 ----- snapshot name will replace LUN Default Owner: SP A Default Owner: SP A Trespassed: NO LUN Capacity(Gigabytes - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 301
VNX CLI for Block server -update Updates the server information. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli server -update command polls and updates the physical and ESX servers attached to the system. It also - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 302
VNX CLI for Block SYNTAX naviseccli -h sp server -getagent -host ipaddress OPTIONS -host ipaddress Specifies the IP address of an attached host. It is applicable for any host running the agent. OUTPUT Agent Rev: 6.29.75 (0.9) server -remoteconfig Gets the remote configuration information. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 303
VNX CLI for Block Writes an image of the configuration file as it exists on the host. -managedev Adds the SCSI devices in the managed device list. Each device includes a device name, system name, and an optional description. -open Keeps the device handle open between requests. This improves or - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 304
VNX CLI for Block SYNTAX naviseccli -h sp server -register -host ipaddress OPTIONS -host ipaddress Specifies the IP address of an attached host. It is applicable for any host running the agent. OUTPUT None if the command succeeds; status or error information if it fails. hypervisor -addvirtualcenter - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 305
VNX CLI for Block hypervisor -modifyvirtualcenter Modifies virtual center credentials. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli hypervisor -modifyvirtualcenter command modifies an existing virtual center server's - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 306
which you want to execute the command. DESCRIPTION The naviseccli hypervisor -addesx command adds ESX credentials. You must specify the ESX credentials manually if the ESX server is not managed by the virtual center server. SYNTAX naviseccli -h sp server -hypervisor -addesx name|ipaddress -username - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 307
VNX CLI for Block SYNTAX naviseccli -h sp server -hypervisor -modifyesx name | ipaddress username user -password password [-o] OPTIONS name | ipaddress Specifies the name or the IP address of the ESX server to be modified. -username user Specifies the new username of the ESX server. -password - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 308
VNX CLI for Block DESCRIPTION The naviseccli hypervisor -listesx command lists all servers with IP address and description. SYNTAX naviseccli -h sp server -hypervisor -listesx OUTPUT ESX Server(s): Name: nlpc12241.us.dg.com IP Address: 10.14.12.241 Virtual center Managed ESX server(s): Virtual - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 309
VNX CLI for Block OPTIONS -get Gets the bypass certificate verification for virtual servers. OUTPUT None if the command succeeds; status or error information if it fails. Host Agent commands This section explains the host agent commands to configure virtual center/ESX credentials. server -volmap - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 310
VNX CLI for Block Trespassed: N\A LUN Capacity(Gigabytes): LUN Capacity(Blocks): .2 4194304 Logical Drives: P:\ Physical Device: \\.\PhysicalDrive14 LOGICAL UNIT WWN: 60:06:01:60:93:31:19:00:01:DC:1D:0B:07:0D:DB:12 LOGICAL UNIT NUMBER: 4 Current Owner: SP A Default Owner: SP B - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 311
VNX CLI for Block LUN ID: 5 Name: My virtual machine Type: VMX Config File File Size(MB): N/A File Path: \[DataStore1]\VM1\hd1.vmdk LUN Name: N/A LUN ID: N/A server -update Updates the server information. PREREQUISITES You must have a user account on the system on which you want to execute the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 312
VNX CLI for Block server -getagent Gets the agent information. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli server -getagent command lists the agent information on the host. SYNTAX naviseccli -h sp server -getagent - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 313
VNX CLI for Block Gets/sets the contents of the polling interval field. The valid range is 1 to 120. -baudrate Gets/sets the baud rate. -logsize Gets/sets the log size to be transferred. -userexplicitdevnames Gets/sets user explicit device names. -write Writes an image of the configuration file as - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 314
MPIO) for Linux, Solaris, or Windows Server 2008. Generate a high-availability report to: l check the status of a server. l prepare for software installation on a system. Checking the status of a server To periodically check the high-availability status of a server, issue the appropriate command for - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 315
If you are generating a high-availability report as a prerequisite for updating the system software, you need to upload this report to the system prior to installing the software on the system. To generate and upload an HA report, issue the following command from the directory in which you - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 316
to the EMC Navisphere Command Line (CLI) Reference guide. You cannot use this switch in conjunction with the the Unisphere Server Utility installation directory. If the server utility is installed on your server you perform the following manual checks: Verify support of software and hardware Make - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 317
server, use the utility to set network parameters for these ports. You can install the utility on a server or other host such as an off-array management station ] [-storagename storageName] [-ipv6mode |automatic |disable | [manual [-globalprefix prefix [-ipv6gateway ipv6gateway]] [-help] where: eula - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 318
name for the specified system. -help Displays the help screen and does not start the initialization process. -ipv6mode automatic | disable | [manual -globalprefix prefix | -ipv6gateway ipv6gateway] Specifies the configuration type for the IPv6 network. Refer to the IPv6 configuration type table for - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 319
CHAPTER 3 Virtual Pools Commands This chapter provides a brief overview of the Virtual Pools feature and describes the storage pool and thin commands that you can use if this feature is enabled on your system. Major topics include: l Virtual Pools overview...320 l storagepool -create...321 l - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 320
requires that the thin provisioning enabler be installed on the system. Thick LUNs and thin a normal condition typical of most thin provisioning services. A thick LUN reserves all of its LUNs cannot be a component in a metaLUN. l Virtual Pools support RAID 5, RAID 6 and RAID 1/0 types. RAID 5 is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 321
Virtual Pools Commands Table 18 naviseccli thin provisioning commands (continued) Command Description storagepool -modify Modifies thin pool properties. storagepool -expand Expands the thin pool on the system. storagepool -cancelexpand Cancels the expansion, if the expansion has failed. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 322
pool creation may fail due to any error checked in the thin rules. -autoTiering scheduled|manual Sets the auto-tiering state to scheduled or manual for the storage pool. The default autotiering state is manual. -fastcache on|off Enables or disables the FAST Cache for the entire storage pool. The - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 323
Virtual Pools Commands Indicates that the system should check the pool full high water mark for auto delete. Valid values are On or Off. -snapPoolFullHWM Specifies the pool full high watermark that triggers the auto delete process of the storage pool to be created. -snapPoolFullLWM Specifies the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 324
Virtual Pools Commands EXAMPLE #3 naviseccli -h riker-spa storagepool -create -disks 0_0 0_1 0_2 -rtype r_5 - dedupRate high -dedupTieringPolicy autoTier -dedupInitialTier highestAvailable OUTPUT None if the command succeeds; status or error information if initiating the command fails If the user's - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 325
Virtual Pools Commands -consumedCap Displays the total allocated capacity in the shared capacity of the thin pool. The consumed capacity of a thin pool includes storage used by MLU for maintaining metadata (mapping info). -currentOp Displays the current operation. -description Returns the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 326
used percentage. -autoTiering Displays the auto-tiering state (scheduled/manual) -tiers Displays the tier name, RAID type, capacity, be overwritten. -metadataSubscribedCap Specifies the total amount of metadata storage required to support writing to the entire contents of all of the LUNs in the pool - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 327
pool. -all Displays all the storage pool information, including the tiers (always) and auto-tiering state (if the auto-tiering enabler has been installed). EXAMPLE #1 List the RAID type for a storage pool with tiers that are RAID 5 and RAID 6 EMC® VNX® Series Command Line Interface Reference for - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 328
Virtual Pools Commands naviseccli -h riker-spa storagepool -list -id 0 -rtype Pool Name: Pool 0 Pool ID: 0 Raid Type: Mixed EXAMPLE #2 naviseccli -h riker-spa storagepool -list -id 0 -tiers -rdrivecount EXAMPLE #3 List all deduplication properties. naviseccli -h riker-spa storagepool -list - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 329
(Blocks): 25167360 Total Subscribed Capacity (GBs): 12.001 Percent Subscribed: 2.264 Oversubscribed by (Blocks): 0 Oversubscribed by (GBs): 0.000 Auto-Tiering: Manual Tier Name: FC Raid Type: r_5 User Capacity (GBs): 530.03 Consumed Capacity (GBs): 4.00 Available Capacity (GBs): 526.03 Percent - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 330
Virtual Pools Commands Deduplication Status: OK(0x0) Deduplication Percent Completed: 70 Deduplication Remaining Size (Blocks): 12608078 Deduplication Remaining Size (GBs): 3.006 Optimal Deduplicated LUN SP Owner: A Deduplication Rate: Medium Deduplicated LUNs' Tiering Policy: Auto Tier - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 331
poolName[-newName newName] [-description description] [-fastcache on|off] [-prcntFullThreshold threshold] [-autotiering scheduled| manual] [-snapPoolFullThresholdEnabled on|off] [-snapPoolFullHWM poolFullHWM] [-snapPoolFullLWM poolFullLWM] [-snapSpaceUsedThresholdEnabled on|off] [-snapSpaceUsedHWM - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 332
the system generates the alerts. The value ranges from 1 to 84. The default value is 70%. -autotiering scheduled|manual Sets the auto-tiering state to scheduled or manual for the storage pool. -snapPoolFullThresholdEnabled Indicates that the system should check the pool full high water mark for auto - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 333
Virtual Pools Commands Starts a pool-level deduplication operation immediately. All restrictions are bypassed, including the less than 64G threshold, for one deduplication pass. If three deduplication operations are currently running, the new request will wait until one session finishes before - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 334
Virtual Pools Commands -initialverify Allows the user to specify not to have inital background verify during pool creation and expansion in order to improve operation performance of pool creation and expansion. -skipRules Skips the best practices check while expanding thin pools. If you do not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 335
] OPTIONS -isVirtualProvisioningSupported Specifies whether the thin enabler is installed on the system. -maxPools Displays the maximum number of on the system. -minPoolLUNSize Displays the minimum pool LUN size supported (as reported by the MLU driver) in blocks and MBs. -maxPoolLUNSize Displays the maximum - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 336
used in all pools. -availableDisks A line feed separated list of disks that are available for use by the Virtual Pools feature. OUTPUT Is Virtual Provisioning Supported: true Max. Pools: 120 Max. Disks Per Pool: 120 Max. Disks for all Pools: 0 Max. Disks per Operation: 120 Max. Pool LUNs: 4094 Min - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 337
This command is available only on subsystems running Unisphere version 6.30 and later. To create thin LUNs, you must have the Thin Provisioning Enabler installed on the subsystem. DESCRIPTION The naviseccli lun -create command lets you create pool LUNs or thin LUNs in the storage pool. SYNTAX lun - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 338
. The lower limit is 0 and the upper limit is the number of LUNs supported on the platform. The default value is the next lowest available value. -name lunName data relocation between tiers but the initial tier is used to guide initial placement of data. autoTier Slices are subject to relocation - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 339
Virtual Pools Commands The combination of tieringPolicy and initialTier is now compatible for the Start High then Auto-tier option. -deduplication Specifies whether deduplication is enabled on this LUN. Valid values are On or Off. EXAMPLE naviseccli -h riker-spa lun -create -deduplication on OUTPUT - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 340
the auto-tiering policy. The auto-tiering policy can be set to: noMovement No data relocation between tiers but the initial tier is used to guide initial placement of data. autoTier Slices are subject to relocation based on stats collected. This setting requires that the initial tier also be set to - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 341
Virtual Pools Commands Overrides the confirmation message. EXAMPLE naviseccli lun -modify -l LUN3 -deduplication on "SP A" is the optimal owner for the deduplicated LUNs in the storage pool. Enabling deduplication on "LUN3" owned by "SP B" may greatly impact the performance of deduplication. It is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 342
Virtual Pools Commands lun -list DESCRIPTION The naviseccli lun -destroy command lets you destroy a LUN. The LUN number or LUN name is used to destroy any type of LUN since they are unique across all LUNs in the storage pools. SYNTAX lun -destroy -l lunNumber|-name lunName [-o] OPTIONS -l - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 343
Virtual Pools Commands Specifies the types of LUNs to be listed. The value Thin lists all thin LUNs, nonThin lists all non-thin LUNs, Compressed shows all compressed LUNs, nonCompressed shows all noncompressed LUNs, Deduped shows only deduplicated LUNs, and NonDeduped shows only non-deduplicated - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 344
Enabling, On, Disabling, or Off. -all Displays the LUN information along with the auto-tiering policy (if the auto-tiering enabler is installed), the initial tier, and the tier information. EXAMPLE #1 LUN has deduplication enabled. naviseccli -h riker-spa lun -list -dedupState LOGICAL UNIT NUMBER - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 345
Virtual Pools Commands EXAMPLE #2 List only deduplication-enabled LUNs. naviseccli -h riker-spa lun -list -showOnly Deduped -dedupState LOGICAL UNIT NUMBER 0 Name: LUN 0 Deduplication State: On Deduplication Status: OK(0x0) EXAMPLE #3 List all properties. naviseccli -h riker-spa lun -list -all - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 346
the command. DESCRIPTION The naviseccli deduplication -feature -pause command pauses all underlying deduplication processes on the system. You must manually resume deduplication to cancel a pause. The system does not cancel the pause automatically. SYNTAX deduplication -feature -pause EXAMPLE - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 347
SYNTAX deduplication -feature -info EXAMPLE # 1 Deduplication feature is enabled. naviseccli -h deduplication -feature -info Is Deduplication Supported: true Deduplication Feature State: On EXAMPLE # 2 Deduplication feature is paused. naviseccli -h deduplication -feature -info - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 348
Virtual Pools Commands 348 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 349
CHAPTER 4 Auto-tiering Commands This chapter provides a brief overview on the auto-tiering feature and includes a list of commands that you can use if the feature is enabled on your system. Major topics include: l About tiered storage...350 l autotiering -schedule -modify 351 l autotiering - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 350
auto-tiering enabler) l Auto-tiering placement (requires the auto-tiering enabler) Initial tier placement (auto-tiering enabler is not installed) For initial tier placement, you must manually specify the storage tier to place the LUN data. The tier choices are Optimize for Pool Performance, Highest - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 351
Auto-tiering Commands Table 21 Initial tier plus auto-tiering placement settings Initial tier placement Auto-tiering placement Optimize for Pool Performance Highest Available Tier Lowest Available Tier None Auto Tier Highest Available Tier Lowest Available Tier No Data Movement naviseccli auto- - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 352
Auto-tiering Commands Specified as a space separated list containing one or more of the following abbreviations: Sun, Mon, Tue, Wed, Thu, Fri, or Sat. -starttime hh:mm Specifies the scheduled start time. The hours are specified from 0-23 and the minutes are specified from 00-59. The start time is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 353
execute the command. DESCRIPTION The autotiering -relocation -start command manually starts a relocation on a storage pool regardless of the auto default duration is 8 hours. -rate high|medium|low Specifies the rate for a manual relocation. The valid values are high, medium, or low. If the rate is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 354
relocation rate that determines how the scheduled relocations will be performed on the system. If the rate is not specified when starting a manual relocation, it will use this rate. SYNTAX autotiering -relocation -setrate -rate high|medium|low [-o] OPTIONS -rate high|medium|low Sets the scheduled - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 355
all [-o] OPTIONS -poolId poolid|-poolname poolname Specifies the storage pool ID or the storage pool name on which the manual relocation stops. -all Stops the manual relocation on all the storage pools on the system. -o Executes the command without prompting for the confirmation. EXAMPLE autotiering - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 356
Auto-tiering Commands Displays the auto-tiering state. -schedule Displays the auto-tiering schedule. -rate Displays the auto-tiering relocation rate. -opstatus Displays the auto-tiering operations status for all the storage pools on the system or for a given list of storage pools. If a relocation is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 357
Relocation Stop Time: 02/04/13 11:34 Relocation Status: Completed Relocation Type: Rebalance Relocation Rate: Low Data to Move Up (GBs): 7.26 Data to Move Down (GBs): 5.51 Data to Move Within Tiers (GBs): 0.00 Data Movement Completed (GBs): 2.25 Estimated Time to Complete: 3 minutes Schedule - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 358
Auto-tiering Commands 358 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 359
CHAPTER 5 Compression Commands This chapter provides a brief overview of the compression feature and includes a list of compression commands that you can use if this feature is enabled on your system. Major topics include: l About LUN Compression...360 l compression -on...360 l compression -pause... - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 360
presence of multiple copies of the same data. All compression operations perform in the background while continuing to service host I/O. In order to use the compression feature, you must install the compression enabler and the thin provisioning enabler on the system. You can compress classic LUNs as - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 361
Compression Commands DESCRIPTION The naviseccli compression -on command turns on compression for pool LUNs and classic LUNs. The command syntax differs depending on the LUN, either a pool LUN or classic LUN. SYNTAX For pool LUNs: naviseccli -h sp compression -on -l LUN number [-rate low|medium|high| - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 362
Compression Commands OPTIONS -l LUN number Specifies the LUN number of the compressed LUN to be paused. EXAMPLE naviseccli compression -pause -l 10 OUTPUT None if the command succeeds; status or error information if it fails. compression -feature -pause Pauses compression on the system. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 363
Compression Commands Specifies the LUN number of the paused compressed LUN to resume. -o Executes the command without prompting for confirmation. EXAMPLE naviseccli compression -resume -l 10 OUTPUT None if the command succeeds; status or error information if it fails. compression -feature -resume - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 364
Compression Commands OUTPUT Compression Feature State: Paused compression -modify Modifies the compression rate. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli compression -modify command changes the compression rate on - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 365
Compression Commands Executes the command without prompting for confirmation. EXAMPLE naviseccli compression -off -l 10 OUTPUT None if the command succeeds; status or error information if it fails. compression -list Lists compression information. PREREQUISITES You must have a user account on the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 366
Compression Commands -totalcapacity Specifies the total capacity of the LUN. -consumedcapacity Specifies the consumed capacity of the LUN. EXAMPLE naviseccli compression -list OUTPUT LOGICAL UNIT NUMBER 31 Name: Thin LUN 31 UID: 60:06:01:60:5A:E0:21:00:BA:45:01:A3:68:4F:DE:11 Destination Pool ID: 3 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 367
CHAPTER 6 FAST Cache Commands This chapter provides a brief overview of the EMC FAST Cache feature and includes a list of FAST Cache commands that you can use, if the feature is enabled on your system. Major topics include: l Introduction to caching...368 l cache -fast -create...369 l cache -fast - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 368
) disks and with the FAST Cache enabler installed support the FAST Cache. FAST Cache is a private storage pool consisting of two or more to FAST Cache. To use FAST Cache, the system must have: l FAST Cache enabler installed l FAST Cache configured l FAST Cache enabled at the classic LUN and/or storage pool You - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 369
FAST Cache Commands cache -fast -create Creates FAST Cache. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli cache -fast -create command creates the FAST Cache. SYNTAX cache -fast -create -disks disksList [-rtype raidtype] - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 370
FAST Cache Commands cache -fast -destroy Destroys FAST Cache. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli cache -fast -destroy command destroys the FAST Cache. SYNTAX cache -fast -destroy [-o] OPTIONS -o Executes the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 371
Displays FAST Cache statistics. -o Executes the command without prompting for confirmation. EXAMPLE #1 naviseccli cache -fast -info Disks: Bus 0 Enclosure 0 Disk 6 Bus 0 Enclosure 0 Disk 7 Mode: Read/Write Raid Type: r_1 Size (GB): 64 State: Enabled Current Operation: Initializing Current Operation - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 372
FAST Cache Commands Bus 0 Enclosure 0 Disk 7 Mode: Read/Write Raid Type: r_1 Size (GB): 64 State: Enabled Current Operation: Initializing Current Operation Status: Running Current Operation Percent Completed: 20% Percentage Dirty SPA: 1 MBs Flushed SPA: 50 Percentage Dirty SPB: 2 MBs Flushed SPB: 80 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 373
EMC Unisphere QoS Manager This chapter introduces the EMC® Unisphere™ Quality of Service (QoS) Manager application, associated dependencies, and the online help system. Major topics are: l About Unisphere Quality of Service Manager 374 l QoS Manager CLI commands 374 l Client tools...395 EMC® VNX - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 374
Unisphere QoS Manager About Unisphere Quality of Service Manager QoS Manager lets you allocate system Environment (JRE) (see the release notes) must be installed on the client from which you run the browser. For system support and the latest requirements, see the release notes supplied with - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 375
EMC Unisphere QoS Manager nqm -info SYNTAX nqm -getlatestperf [-ioclasses classnames] [-value bw|tt|rt] OPTIONS -ioclasses classnames Specifies an I/O class name. If not specified, all of the I/O classes in the currently running policy will be listed. If the I/O class specified is not a part of a - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 376
EMC Unisphere QoS Manager OUTPUT Current State of NQM: Running Goal Satisfied: N/A NQM Provider Version: 6.24 Total User Defined Classes: 2 Total User Defined Policies: 2 Log Event On: Goal no longer satisfied Fallback Policy:aPolicy Current Policy: aRunningPolicy Current Localized Array Time: 22: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 377
EMC Unisphere QoS Manager Sets a fixed queue depth for an I/O class. -noctrl If specified, creates the I/O class without any control method. -name classname Specifies a new class name. -snapshots name|WWN Lists the COFW snapshot LUN names, the snapshot mount point names, or the WWNs. -luns number| - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 378
EMC Unisphere QoS Manager nqm -ioclass -destroy Removes an existing I/O class. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The nqm -ioclass command with the -destroy switch removes an existing I/O class. Note: The operation is not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 379
EMC Unisphere QoS Manager OPTIONS -ctrlmethod Displays the control method and one or more of the following parameters. For the cruise control method, it displays the goal metric, goal value, and tolerance. For the limit method, it displays the goal metric and goal value. For the fixed-queue-depth - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 380
EMC Unisphere QoS Manager OUTPUT Name: TestClassWithNOGoal Status: Ready Current State: Idle Number of LUNs: 3 LUNs: LUN Number: 0 LUN Name: LUN 0 LUN WWN: 60:06:01:60:4E:22:0E:00:4C:CC:D6:F8:67:6C:D8:11 RAID Type: RAID5 LUN Number: 2 LUN Name: LUN 2 LUN WWN: 60:06:01:60:4E:22:0E:00:4E:CC:D6:F8:67: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 381
EMC Unisphere QoS Manager DESCRIPTION The nqm -ioclass command with the -modify switch modifies an existing I/O class. You can use this command to rename the class, change the properties of a class, or update the contained target lists. Note: This operation is not allowed while the class is in a - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 382
EMC Unisphere QoS Manager Modifies an I/O class without prompting for warning or confirmation. If the user omits this option when modifying an I/O class, a confirmation message appears: The I/O class is contained by a scheduled policy. Do you want to modify it (y/n)? -ctrlmethod limit Limits - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 383
which you want to execute the command. DESCRIPTION The naviseccli nqm -policy command with the -create switch creates a new policy. A maximum of 10 policies are supported on a storage system. EMC® VNX® Series Command Line Interface Reference for Block 383 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 384
EMC Unisphere QoS Manager SYNTAX nqm -policy -create -name policyname [-evalwindow number_of_samples] [-failaction stop|measure|continue] [-ioclasses classnames|-noclass] [-timelimit value_in_min] OPTIONS -name policyname Specifies the policy name. -evalwindow number_of_samples Specifies the number - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 385
EMC Unisphere QoS Manager SYNTAX nqm -policy -destroy -name policyname [-o] OPTIONS -name policyname Specifies the policy name to be destroyed. -o Destroys the policy without prompting for warning/confirmation. If you do not specify the -o switch when destroying a policy, a confirmation message - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 386
EMC Unisphere QoS Manager -name [policyname] Specifies the policy name. If not specified, all policy names will be displayed. -state Displays the policy's current state. -status Displays the policy's current status. -timelimit Specifies the maximum time it should take the system to satisfy the goal - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 387
nqm -run EMC Unisphere QoS Manager OPTIONS -name policyname Specifies the policy name. -evalwindow number_of_samples Specifies the number of sample periods needed to meet (or to fail to meet) the goal in order for the goal to be classified as satisfied (or unsatisfied). This value must be between 3 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 388
EMC Unisphere QoS Manager Specifies which policy to run. EXAMPLE For ss1_spa, this command runs testPolicy. naviseccli -h ss1_spa nqm -run testPolicy OUTPUT None nqm -schedule -create Creates a scheduled task. PREREQUISITES You must have a user account on the system on which you want to execute the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 389
EMC Unisphere QoS Manager Specifies the list of weekdays, separated by spaces, that the task will reoccur. Specify this switch only with the -weekly switch. -norecur Specifies no recurrence of the scheduled task, if specified. EXAMPLE For ss1_spa, this command creates a daily recurring task for - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 390
EMC Unisphere QoS Manager nqm -schedule -list Lists all scheduled tasks. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli nqm -schedule command with the -list switch lists all scheduled tasks in a timely order. If there is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 391
EMC Unisphere QoS Manager Next Start Time: Mon Apr 05 10:10:00 2004 Duration: 2 hours Policy Name: TestCompletePolicy Recurrence Type: Weekly Frequency: Every 2 weeks Pattern: Sunday, Monday and Tuesday Name: TestScheduleRecurring Current State: Running Next Start Time: Mon Apr 05 12:00:00 2004 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 392
EMC Unisphere QoS Manager -policy policyname Indicates the policy name to which the scheduled task is associated. -startdate mm/dd/yyyy Indicates the date the task is scheduled to start. -starttime hh:mm:ss Indicates the time the task is scheduled to start. -duration hours:minutes Indicates the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 393
EMC Unisphere QoS Manager Specifies an existing scheduled task name. EXAMPLE #1 For ss1_spa, this command resumes the scheduled task testSchedule. naviseccli -h ss1_spa nqm -schedule -resume -name testSchedule EXAMPLE #2 For ss1_spa, this command resumes all existing scheduled tasks. naviseccli -h - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 394
EMC Unisphere QoS Manager nqm -setfallback Sets or unsets a fallback policy. PREREQUISITES You must have a user account on the system on which you want to execute the command. DESCRIPTION The naviseccli nqm -setfallback command will set or unset a fallback policy. SYNTAX nqm -setfallback -enable - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 395
EMC Unisphere QoS Manager nqm -stop EXAMPLE For ss1_spa, this command toggles the data logging and the event control switch. Events will be put into the event log if the goal is satisfied, unattainable, or no longer satisfied. naviseccli -h ss1_spa nqm -setoptions -logevent gs gu gn OUTPUT None - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 396
EMC Unisphere QoS Manager DESCRIPTION The naviseccli nqm command with the -archive -dump command dumps the performance data, relationship, configuration, and statistics information in a format that you specify. You can specify the output format, XML or CSV, for the dumped information. The -archive - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 397
EMC Unisphere QoS Manager -out filename(s) Dumps multiple files. Specify multiple output filenames separated by commas. The output filenames list corresponds to the dumped filenames list. Note: You can dump multiple files into a single file using the -join switch. -join Appends the output from - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 398
EMC Unisphere QoS Manager Encloses each performance characteristic within a set of special characters. If you specify the output type as -xml, an error message appears. The possible special characters that you can use for the -enquote switch are listed below: Table 26 Valid -enquote switch special - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 399
EMC Unisphere QoS Manager more of the codes listed below. If you do not specify this switch, all performance characteristics are output in the order listed below: Table 29 Performance characteristics without -format code Performance characteristic Object type Code Object Name All objects on - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 400
not use this switch in scripts. -rel Dumps the relationship information for the various objects in the archive file. Unisphere version 1.0 contains fully provisioned LUN support for QoS Manager. You can dump and display the fully provisioned LUN if it is part of any I/O class. You can also dump and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 401
the al object code. Table 31 Order of dump configuration information Object type Code Policy session ps I/O class cl All LUNs (including all supported public LUNs) al MetaLUN ml Classic LUN l Thin LUN tl Pool LUN (including thin LUN and fully plu provisioned LUN) Snapshot LUN sl - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 402
EMC Unisphere QoS Manager Dumps the statistical information for multiple archive files. A blank line separates dumped information of different files. You can use the following optional switches with the -stats command: -join, -out, -overwrite (which are described above). EXAMPLE #1 This command - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 403
EMC Unisphere QoS Manager -location directorypath Specifies the path location of the archive file once it is retrieved to the client system. If you do not specify a location, QoS Manager uses the current working directory. -overwrite y|n Specifies whether to overwrite an existing archive file on the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 404
EMC Unisphere QoS Manager 404 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 405
CHAPTER 8 EMC Unisphere Analyzer This chapter introduces the EMC® Unisphere™ Analyzer performance monitor application, which measures the performance of disk-array storage systems. Major topics are: l About Unisphere Analyzer 406 l Analyzer CLI commands...406 l Client tools...412 EMC® VNX® Series - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 406
(LUNs), and disks. The new information displaces the old. This manual uses the term LUN to refer to LUNs, metaLUNs, fully provisioned LUNs only) Prerequisites Analyzer requires the following: l Unisphere software must be installed and enabled on at least one of the systems in the system domain that - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 407
EMC Unisphere Analyzer analyzer -set Modifies the performance logging properties. PREREQUISITES You must have a user account on the system on which you want to execute the command. If one of the switches is specified, the user account needs the administrator or manager role. DESCRIPTION The - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 408
EMC Unisphere Analyzer naviseccli -h ss1_spa analyzer -set -default OUTPUT None if the command succeeds; status or error information if it fails. analyzer -get Returns the current values of the performance logging properties. PREREQUISITES You must have a user account on the system on which you want - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 409
EMC Unisphere Analyzer DESCRIPTION The naviseccli analyzer command with the -logging switch lets you reset performance logging. analyzer -logging is used with naviseccli (refer to naviseccli). SYNTAX analyzer -logging [-reset] OPTIONS -reset Stops performance logging. It deletes all the data that - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 410
EMC Unisphere Analyzer DESCRIPTION The naviseccli analyzer command with the -stop switch stops performance logging. It restores the statistics logging state to what it was before logging was started. analyzer -stop is used with naviseccli (refer to naviseccli). SYNTAX analyzer -stop EXAMPLE This - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 411
EMC Unisphere Analyzer SYNTAX analyzer -archive [[-list][-path pathname][-o][-all|-file filenames][-delete]] or analyzer -archive [-new|-statusnew filename] OPTIONS -list Lists all the archive files, ignoring all other switches. -path pathname Retrieves files to the path you specify. If you do not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 412
EMC Unisphere Analyzer 6 70 GMT_M05-00.nar 7 71 GMT_M05-00.nar 8 70 GMT_M05-00.nar 9 70 GMT_M05-00.nar 10 71 GMT_M05-00.nar 11 69 GMT_M05-00.nar 12 72 GMT_M05-00.nar 10/08/2006 20:00:42 10/08/2006 22:36:42 10/09/2006 01:12:42 10/09/2006 03:48:42 10/09/2006 06:24:42 10/09/2006 09: - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 413
EMC Unisphere Analyzer [-join] [-overwrite y|n] [-xml|-delim code] [-enquote code] [-eol code] [-root objcode] [-level depth] [-progress] analyzer -archivedump -config filename(s) [-out filename(s)] [-join] [-overwrite y|n] [-xml|-delim code] [-enquote code] [-eol code] [-object objcode] [-progress - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 414
EMC Unisphere Analyzer Table 32 Delimiter codes (continued) Delimiter Semicolon Colon Tab Slash Backslash Period White space Code sc cl tb sl bs pd ws Note: If you use a slash or a period as a delimiter, you must also use the -enquote switch with an option other than None. -enquote code - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 415
EMC Unisphere Analyzer y Output a header. n Do not output a header. -object codes Specifies the objects for which to collect performance statistics and the order in which to output them. If you do not specify this switch, all object types are dumped in the following order: SPs, public classic LUNs - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 416
EMC Unisphere Analyzer Table 35 Valid object type codes (continued) h. Snap of a consistency group. New objects for VNX snapshots. i. Snapshot mount point for VNX snapshots. -format codes Specifies which performance characteristics to output and the order in which they appear. The -format switch - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 417
ff Disk Crossings (%) LUN, metaLUN dcp Average Busy Queue Length LUN, metaLUN, pool-based LUN, abql disk, SP Disk Crossing/s LUN, metaLUN dc Service Time (ms) LUN, metaLUN, pool-based LUN, st disk, SP LUN Read Crossings/s metaLUN krc LUN Write Crossings/s metaLUN lwc Average Seek - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 418
EMC Unisphere Analyzer Table 36 Performance characteristics without -format code (continued) Performance characteristic Writes Larger Than Snapshot Cache Chunk Size Chunks Used in Snapshot Copy Session Average Transfer Size (KB) Time Lag (min) Data Lag (MB) Cycle Count Average Cycle Time (min) - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 419
EMC Unisphere Analyzer Table 36 Performance characteristics without -format code (continued) Performance characteristic Total 4KB+ Total 8KB+ Total 16KB+ Total 32KB+ Total 64KB+ Total 128KB+ Total 256KB+ Total 512KB+ Queue Full Count FAST Cache Read Hit Ratio FAST Cache Write Hit Ratio FAST Cache - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 420
LUN, metaLUN, poolbased LUN Average Busy Queue Average Busy Queue abqlo/abqln Length-optimal Length-Nonoptimal LUN, metaLUN, poolbased LUN Service Time Optimal [ms] Service Time Nonoptimal [ms] sto/stn LUN, metaLUN, poolbased LUN Explicit Trespass Count etc LUN, metaLUN, pool- based LUN - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 421
EMC Unisphere Analyzer dd is the day of a month (1-31) yyyy is the four-digit year hh is the hour of the day (0-23) mm is the minute in an hour (0-59) ss is the second in a minute (0-59) You must enclose the time in double quotation marks. The -stime switch works in combination with the -ftime - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 422
use the following switches with the -stats command: -out, -join, -overwrite, and -timezone codes (described above). The -stats command does not support -xml format. -rel Dumps the relationship information among the various objects in the archive file. You must provide the archive filename following - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 423
EMC Unisphere Analyzer Table 40 Object types of a root node (continued) Object type Code Snap session RAID group Host Storage System MetaLUN LUN a port Private classic LUNs (CX4 series only)b Host LUN (CX4 series only)c Thin LUNd Thin poole All LUNs Public/private pool LUNs Poolf Snapshot mount - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 424
EMC Unisphere Analyzer -config Dumps the configuration information of objects in the archive file. You must provide the archive filename following the -config command. You can specify multiple archive files separated by commas to dump the configuration information for all of them. You can use the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 425
EMC Unisphere Analyzer naviseccli analyzer -archivedump -stats archive1.nar,archive2.nar EXAMPLE #3 This command lets you dump relationship information of various objects in the archive file archive.nar and outputs it in XML format. naviseccli analyzer -archivedump -rel archive.nar -xml EXAMPLE #4 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 426
EMC Unisphere Analyzer Specifies the number of times to retry a retrieve before giving up completely. A retry occurs only when the actual move of the archive file from the system to the client system fails. -v As the retrieve process progresses, the status of each stage appears. EXAMPLE This - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 427
EMC Unisphere Analyzer naviseccli analyzer -archivemerge -data C:\Temp\archive1.nar C:\Temp\archive2.nar -out C:\Temp\mergedArchive.nar EMC® VNX® Series Command Line Interface Reference for Block 427 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 428
EMC Unisphere Analyzer 428 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 429
™/Asynchronous software and explains the commands for creating and managing the MirrorView/ Asynchronous remote mirrors and consistency groups. This manual refers to the EMC VNX MirrorView/Asynchronous product as MirrorView /A. Major topics include: l MirrorView/A remote mirroring commands 430 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 430
to a distant system server. Note: The commands in this section function only with a system that has the optional MirrorView/A software installed. MirrorView/A operations overview About this task This section provides an overview of MirrorView/A operations and how to manage the systems using the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 431
, go to the E-Lab™ Navigator on EMC Online Support, and under the PDFs and Guides tab, open the VMware ESX server.pdf file. 10 . If access to the secondary storage image fails, the primary system will fracture the remote mirror. If the problem - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 432
EMC VNX MirrorView/A CLI Table 42 naviseccli MirrorView/A command functions Essential functions (in order performed) mirror -enablepath Opens a path between the local and remote system. Required regardless of the type of connection between systems. mirror -async -create Creates a new remote - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 433
LUNs, if all the participating systems support mirroring on thin LUNs. Note: The Thin Provisioning™ enabler must be installed to create thin LUNs. You can mirroruid -arrayuid system-uid -lunuid lun-uid [-recoverypolicy auto|manual] [-syncrate high|medium|low] [-manualupdate|-delaystart time|-enddelay - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 434
|auto Specifies the policy for recovering the secondary mirror image after a system fracture. Values are: manual: The administrator must explicitly start a synchronization operation to recover the secondary mirror image. auto: Recovery automatically resumes as soon as the primary image determines - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 435
:95:DE:7C:E4:71:D4:11 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -async -change Changes mirror properties. PREREQUISITES You must - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 436
to enable the administrator to correct the problem. -o Executes the command without prompting the SP does not support this command, a Command is not supported error message is printed to | -mirroruid uid -imageuid image-uid [-recoverypolicy manual|auto] [[-manualupdate] | [-delaystart time]] [- - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 437
|auto Specifies the policy for recovering the secondary mirror image after a system fracture. Values are: manual: The administrator must explicitly start a synchronization operation to recover the secondary mirror image. auto: Recovery automatically resumes as soon as the primary image determines - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 438
with the -change function. This command supports thin LUNs after you install the latest Unisphere version, which contains thin LUN support for MirrorView. If you specify a minimum to enable the administrator to correct the problem. -o 438 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 439
-create -name db_mirror -lun 112 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -async -destroy Destroys a mirror. PREREQUISITES You - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 440
OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also path will be fractured. Note: If both asynchronous and synchronous mirrors are installed, you need to run the command only once. It will take effect - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 441
Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. mirror -enablepath mirror -info systems command. Note: If both asynchronous and synchronous mirrors are installed, you will need to run the command only once. It will take - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 442
-h ss1_spa mirror -async -info OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. mirror -async -fractureimage Fractures an image in a mirror. PREREQUISITES You must have a user account - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 443
want to execute the command. DESCRIPTION This command, when used with naviseccli and no other switches, lists all general information for asynchronous mirror support. Issuing this command with one or more options displays the information based on the option issued. See the example for sample output - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 444
EMC VNX MirrorView/A CLI OPTIONS -cancreate Indicates whether an asynchronous mirror can be created in this system: yes or no. -maxmirrors Displays the maximum number of mirrors that can be created in this system. -maxremoteimages Specifies the maximum number of secondary images allowed. A maximum - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 445
: 0 Port Type: Fibre OUTPUT If the version of the VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. mirror -async -list Displays information about existing asynchronous mirrors. PREREQUISITES You must have a user - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 446
, WWN of the LUN containing the image, recovery policy, sync rate, image state, image condition, and image transitioning. It also displays the update type (Manual, Time elapsed since the start of last update, and Time elapsed since the end of the last update), the update period in minutes (displays - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 447
: NO Image Transitioning: NO Synchronizing Progress(%): 0 Update Type: Manual Time in secs since previous update: 12550 Time in secs until VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 448
EMC VNX MirrorView/A CLI After promoting an image, you must explicitly add the newly promoted image to an appropriate storage group. EMC recommends that you also remove the old primary from its storage group, if possible. In normal operation when there is no failure, you can (but probably would not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 449
50:06:06:10:00:FD:A1:6 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -async -removeimage Removes a secondary image from a mirror - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 450
50:06:06:10:00:FD:A1:6 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -async -setfeature Adds or removes an asynchronous mirror - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 451
mirror -async -setfeature -on -lun 112 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -async -syncimage Starts an update of the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 452
to sync the image (y/n)? y OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. MirrorView/A consistency group commands This section explains the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 453
in a group after a failure causes a system fracture. Values are: manual: Update of the secondary image does not begin until you explicitly issue OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 454
want to destroy the group dbgroup?(y/n)? y OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages if the command fails. mirror -async -addtogroup Adds - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 455
Accounts Mirror to Europe" OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -async -removefromgroup Removes a mirror from a consistency - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 456
00:00:00:00:00 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -async -changegroup Changes consistency group properties. PREREQUISITES - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 457
a group after a failure causes a system fracture. Values are: manual: Update of the secondary image does not begin until you explicitly issue VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 458
-name dbgroup -synctype startnow OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -async -fracturegroup Fractures all image(s) in - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 459
-async -fracturegroup -name dbgroup OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -async -promotegroup Promotes all secondary images - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 460
mirror -async -promotegroup -name dbgroup OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -async -listgroups Displays information about - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 461
of members per consistency group. -update Displays the type of update as either manual, Time elapsed since the start of the last update (in minutes), or updates in the event of a system fracture, after the problem is corrected. -description Displays the description associated with the consistency - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 462
:06:01:60:88:20:05:C6 Condition: Normal Sync Rate: Medium Recovery Policy: Manual OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. 462 EMC - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 463
MirrorView™/Synchronous software and explains the commands for creating and managing the MirrorView/Synchronous remote mirrors and consistency groups. This manual refers to the EMC VNX MirrorView/Synchronous product as MirrorView/S. Major topics include: l MirrorView/S Remote Mirroring commands 464 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 464
to a distant system server. Note: The commands in this section function only with a system that has the optional MirrorView/S software installed. MirrorView/S operations overview About this task This section provides an overview of MirrorView/S operations and how to manage the systems using the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 465
volumes, go to the E-Lab™ Navigator on EMC Online Support, and under the PDFs and Guides tab, open the VMware ESX server.pdf file. 11 . If access to the secondary storage image fails, the primary system will fracture the remote mirror. If the problem - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 466
EMC VNX MirrorView/S CLI administrator can fix it. Mirroring will recover and resynchronize the image, if the image recovery policy is Automatic. Whenever you want to stop mirroring, you can first fracture and remove the secondary images, and then destroy the mirror. This does not affect any data - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 467
to the system that holds the primary image. This command lets you create primary and secondary images on thin LUNs, if all the participating systems support mirroring on thin LUNs. EMC® VNX® Series Command Line Interface Reference for Block 467 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 468
/S CLI Note: The Thin Provisioning™ enabler must be installed to create thin LUNs. You can use the -info addimage -name name|-mirroruid mirroruid -arrayuid system-uid -lunuid lun-uid [-recoverypolicy auto|manual] [-syncrate high|medium|low] [-nosyncrequired] OPTIONS -name name Specifies the name that - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 469
mirror image after a system fracture. Values are: manual: The administrator must explicitly start a synchronization operation to VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may also receive other - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 470
-allocatelog -spA 122 -spB 124 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may also receive other error messages. mirror -sync -change Changes mirror properties. PREREQUISITES - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 471
this to generate an appropriate warning (for example, e-mail message or page) to the administrator to enable the administrator to correct the problem. -qthresh qthresh Specifies the time delay, in seconds, after the last I/O is received before a mirror will automatically be transitioned to the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 472
for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may sync -changeimage -name name | -mirroruid uid -imageuid image-uid [-recoverypolicy manual|auto] [-syncrate high|medium|low] [-o] OPTIONS -name name Specifies the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 473
mirror image after a system fracture. Values are: manual: The administrator must explicitly start a synchronization operation to the -change function. This command supports thin LUNs after you install the latest Unisphere version, which contains thin LUN support for MirrorView. If you specify - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 474
this to generate an appropriate warning (for example, e-mail message or page) to the administrator to enable the administrator to correct the problem. -qthresh qthresh This specifies the time delay, in seconds, after the last I/O is received before a mirror will automatically transition to the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 475
of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may also receive other error messages. mirror -sync -deallocatelog Removes LUNs from service as write intent log LUNs. PREREQUISITES You must have a user - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 476
EMC VNX MirrorView/S CLI OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may also receive other error messages. mirror -sync -destroy Destroys a mirror. PREREQUISITES You must have - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 477
OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may also path will be fractured. Note: If both asynchronous and synchronous mirrors are installed, you need to run the command only once. It will take effect - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 478
Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. mirror - the mirror -info systems command. Note: If both asynchronous and synchronous mirrors are installed, you will need to run the command only once. It will take effect - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 479
-h ss1_spa mirror -sync -info OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. mirror -sync -fractureimage Fractures an image in a mirror. PREREQUISITES You must have a user account - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 480
want to execute the command. DESCRIPTION This command, when used with naviseccli and no other switches, lists all general information for remote mirror support. Issuing this command with one or more options displays the information based on the option issued. See the example for sample output. For - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 481
EMC VNX MirrorView/S CLI SYNTAX mirror -sync -info [-cancreate] [-maxmirrors] [-mirroredluns] [-mirrorableluns] [-systems [-connectiontype]] [-logs] [-all] OPTIONS -cancreate Indicates whether an remote mirror can be created in this system: yes or no. -maxmirrors Displays the maximum number of - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 482
Port ID: 0 Port Type: Fibre OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. mirror -sync -list Displays information about existing mirrors. PREREQUISITES You must have a user account - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 483
EMC VNX MirrorView/S CLI SYNTAX mirror -sync -list [-name [name]] [-mirroruid] [uid] [-description] [-faulted] [-images] [-imagecount] [-imagesize] [-lun] [-qthresh] [-requiredimages] [-state] [-transition] [-usewriteintentlog] OPTIONS -name name Specifies the name you gave the mirror with the - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 484
: NO Synchronizing Progress (%): N/A OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may also receive other error messages. mirror -sync -listsyncprogress Displays the percentage - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 485
for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may displays nothing. You can direct this command to any system that has MirrorView/S installed. Format of the display is: SP:A/B LUN-number (Number of LUN used - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 486
Processor: SP B LUN Number: 128 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported message is written to sterr. mirror -sync -promoteimage Promotes a secondary image to primary. PREREQUISITES You must have a user account on - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 487
is not in the synchronized state, then the mirror will be out-of-sync and waiting on admin. The recovery policy is changed to manual during the promotion, so that you must initiate the synchronization. If you choose to synchronize the mirror, it will be a full synchronization. Note: A promotion - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 488
50:06:06:10:00:FD:A1:6 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -sync -removeimage Removes a secondary image from a mirror - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 489
version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may also receive other error messages must use this command to do this manually. EMC® VNX® Series Command Line Interface Reference for Block 489 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 490
-sync -setfeature -on -lun 112 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may also receive other error messages. mirror -sync -syncimage Starts an update of the secondary - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 491
to sync the image (y/n)? y OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. You may also receive other error messages. MirrorView/S consistency group commands This section explains - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 492
in a group after a failure causes a system fracture. Values are: manual: Update of the secondary image does not begin until you explicitly issue OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 493
want to destroy the group dbgroup?(y/n)? y OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages if the command fails. mirror -sync -addtogroup Adds - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 494
Accounts Mirror to Europe" OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -sync -removefromgroup Removes a mirror from a consistency - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 495
EMC VNX MirrorView/S CLI or mirror -sync -removefromgroup -name name|-groupid id -localLunUid uid | -localLunnumber number[-force] [-o] OPTIONS -name name Specifies the name of the consistency group from which you want to remove the mirror. -groupid id Specifies the unique ID of the consistency - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 496
OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive in a group after a failure causes a system fracture. Values are: manual: Update of the secondary image does not begin until you explicitly issue - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 497
mirror -sync -syncgroup -name dbgroup OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. EMC® VNX® Series Command Line Interface Reference for - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 498
-sync -fracturegroup -name dbgroup OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also receive other error messages. mirror -sync -promotegroup Promotes all secondary images - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 499
EMC VNX MirrorView/S CLI CAUTION After force promoting a consistency group that is out-of-sync after the promotion, use caution before synchronizing the consistency group. If the group was fractured before the promotion, the new primary system may have data that is much older than the original - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 500
OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also Fractured, Waiting on Sync, Inactive, or Invalid. -recoverypolicy Displays either manual or automatic to describe whether the system will wait for you to - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 501
:00:00 Description: State: Synchronized Role: Secondary Condition: Active Recovery Policy: Manual Mirror Name: vid Mirror WWN: 50:06:01:60:90:60:2C:BA OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stdout. You may also - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 502
EMC VNX MirrorView/S CLI 502 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 503
CHAPTER 11 SAN Copy and its command line utilities This chapter introduces the EMC® SAN Copy™ software and its command line utilities: admhost, with commands that the operating system uses to manage SAN Copy devices; and the CLI, with commands that manage SAN Copy sessions. Major topics are: l - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 504
connects directly or through a SAN, and also supports protocols that let you use the IP WAN ( SAN Copy command line interface described in this manual. Preparing a Block system for a copy session Block Concepts. Note: For all sessions, you must install SAN Copy software on at least one of the Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 505
them. This is the only time we recommend placing the same logical unit in more than one storage group. Note: Some operating systems do not support the same host accessing identical LUNs. Therefore, once SAN Copy completes the copy session, we recommend that you move any LUN copies to different - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 506
group. This is the only time we recommend placing the same logical unit in more than one storage group. Note: Some operating systems do not support the same host accessing identical LUNs. Therefore, once SAN Copy completes the copy session, we recommend that you move any LUN copies to different - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 507
Figure 3 Sample SAN Copy storage group configuration Server Server SAN Copy and its command line utilities Source LUN 1 Source LUN 2 SG 3 Destination LUN SAN Copy Storage System LUN1 LUN3 LUN2 SG 1 LUN4 SG 2 Remote Storage System EMC2693 Preparing a Symmetrix system for a copy session - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 508
SAN Copy software). 2. Use ESN Manager version 2.1 to place the SAN Copy ports on the host side of the topology view. l If this is a new installation of the system, complete steps 2a and 2b. l If ESN Manager has already discovered the system and it is visible on the storage side of - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 509
that the information on the source logical unit is current. Note: Currently, admhost is supported only on the following Microsoft Windows platforms: Windows Server 2003, and Windows 2000. For the supported versions of these operating systems, see the EMC SAN Copy and Admhost Release Notes. EMC - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 510
SAN Copy command functions This section lists the admhost commands and describes their function in SAN Copy sessions. Note: The admhost utility is not supported on a UNIX host. Use the commands your operating system normally uses to discover new logical units, flush buffers, and unmount the logical - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 511
SAN Copy and its command line utilities Table 47 admhost functions and descriptions (continued) Function admhost lun_flush admhost lun_list admhost help Description Syntax and examples On a Windows host, the command flushes all data for the specified object_type so that the data in the write - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 512
SAN Copy and its command line utilities Table 47 admhost functions and descriptions (continued) Function Description Valid operations include: lun_flush, lun_activate, lun_deactivate, lun_list, and help. Valid types include: device and driveletter. Syntax and examples Preparing logical units - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 513
with naviseccli or navicli CLI commands to manage the SAN Copy software. These commands function only with a system that has the optional SAN Copy software installed. SAN Copy command functions The EMC VNX CLI for Block provides one of the two interfaces to the SAN Copy software. The Unisphere UI - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 514
SAN Copy and its command line utilities l sancopy -mark l sancopy -modify l sancopy -pause l sancopy -remove l sancopy -resume l sancopy -settings l sancopy -start l sancopy -stop l sancopy -throttle l sancopy -transfer l sancopy -unmark l sancopy -updateconnections l sancopy -verify The sancopy - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 515
SAN Copy and its command line utilities Table 48 naviseccli or navicli sancopy command functions, listed in order of use (continued) Command Description sancopy -stop Stops a SAN Copy session sancopy -verify Ensures that the SAN Copy software can access a logical unit Optional - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 516
the CLI command (or the target system) is running a committed bundle that supports San Copy with thin LUNs. Note: The destination logical unit(s) must exist when the basic CLI command lunmapinfo explained in the CLI reference manual. SYNTAX sancopy -create [-incremental] -name sessionName -srcwwn - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 517
systems. Specifies the device name of the source LUN or destination LUN. -srcportwwn destportwwn destlunnumber Valid only for specifying source LUNs that reside in supported non-EMC systems. For srcportwwn, specify the World Wide Name of the SP port on the source system that owns the source LUN; for - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 518
Sets the destination logical unit's connection type to iSCSI. -destportwwn destportwwn destlunnumber Valid only for specifying destination LUNs that reside in supported non-EMC systems. For destportwwn, specify the World Wide Name of the SP port on the destination system that owns the destination - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 519
SAN Copy and its command line utilities -incremental The following optional switches are used only with the sancopy -create -incremental command: -changesonly If the source LUN and destination LUNs are synchronized when you create the session, use this switch. When you start the session, SAN Copy - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 520
If the version of VNX OE for Block software running on the SP does not support this command, a command is not supported error message is printed to stderr. Other errors are: DMF_NAME_SPECIFIED_NOT_UNIQUE DMF_CREATE_PARAMS DMF_SRCLUN_WWN_AND_NUMBER_SPECIFIED DMF_DESTLUN_WWN_AND_NUMBER_SPECIFIED - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 521
logical unit. -destportwwn destportwwn lunnumber The switch -destportwwn displays the status of the specified destination LUN that resides in a supported non-EMC system. -complete Displays the percentage complete of the copy session when any destination logical unit(s) failed. Displays N/A when - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 522
Requested Connection Type: Fibre Preferred Actual Connection Type: N/A OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. 522 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 523
. You do not need to stop the copy descriptor before duplicating it. Note: The sancopy -duplicate command is not supported for incremental SAN Copy sessions. SYNTAX sancopy -duplicate -descriptoriddescriptorid|-name name OPTIONS -descriptorid descriptorid | -name name Identifies the descriptor - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 524
SAN Copy and its command line utilities DESCRIPTION Note: In addition to all the sancopy -info command switches listed above, incremental copy sessions use the following optional switches: -copywholelun, -markstatus, srcsize, -link (see Incremental SAN Copy sessions in EMC VNX for Block Concepts ). - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 525
SAN Copy and its command line utilities Displays the WWNs of all source logical units. -length Displays the number of blocks to copy. Displays N/A if the descriptor was created using the source WWN. -numdests Displays the number of destination logical units. -dests Displays the WWNs of all - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 526
SAN Copy and its command line utilities Displays whether the session has been marked, and if yes, displays the time of the mark, and the number of blocks of data that have changed since the mark occurred (these data blocks will not be copied when the session starts). -srcsize Displays the size, in - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 527
: 18 sec Failure Status: No Failure OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. sancopy -mark For incremental sessions only--Makes a point-in-time copy of changes to the source - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 528
thin LUNs only when the system executing the CLI command (or the target system) is running a committed bundle that supports San Copy with thin LUNs. The new session information will not take effect until you start a new session. You must include a copy descriptor ID or - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 529
SAN Copy and its command line utilities SYNTAX sancopy -modify -descriptorid descriptor-id|-name name [-adddestbywwn dest-lun-wwn] [-adddestbylunnumber destsp destlunnumber] [-adddestbyportwwn destportwwn destlunnumber] [-chgdestconnectiontypebywwn destwwn] [-chgdestconnectiontypebylunnumber - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 530
line utilities -iscsi Sets the logical unit's connection type to iSCSI. -adddestbyportwwn destportwwn destlunnumber Adds only destination logical units that reside in supported non-EMC systems. For destportwwn, specify the World Wide Name of the SP port on the destination system that owns the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 531
. -iscsi Sets the source logical unit's connection type to iSCSI. -chgscrbyportwwn srcportwwn srclunnumber Valid only for changing source logical units that reside in supported non-EMC systems. For srcportwwn, specify the World Wide Name of the SP port on the source system that owns the source LUN - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 532
from the specified descriptor by World Wide Name. -rmdestbyportwwn destportwwn destlunnumber Valid only for removing destination logical units that reside in supported non-EMC systems. For destportwwn, specify the World Wide Name of the SP port on the destination system that owns the destination - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 533
version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. Other errors are: DMF_NAME_AND_UID_SPECIFIED DMF_NAME_OR_UID_REQUIRED DMF_UNKNOWN_DESCRIPTOR DMF_INVALID_THROTTLE_VALUE DMF_REMOVED_DEST_DOESNOT_EXIST - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 534
navicli. OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. Other errors are: DMF_NAME_AND_UID_SPECIFIED DMF_NAME_OR_UID_REQUIRED DMF_UNKNOWN_DESCRIPTOR Errors returned from the driver - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 535
(y/n)[n]? y OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. Other errors are: DMF_NAME_AND_UID_SPECIFIED DMF_NAME_OR_UID_REQUIRED DMF_UNKNOWN_DESCRIPTOR Errors returned from the driver - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 536
navicli. OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. Other error messages are: DMF_NAME_AND_UID_SPECIFIED DMF_NAME_OR_UID_REQUIRED DMF_UNKNOWN_DESCRIPTOR Errors returned from the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 537
can track the progress of a copy session by checkpoint interval. If a session fails while checkpointing is enabled, then after correcting the problem, you can direct the software to resume (-resume function). It will continue copying from the last checkpoint, if possible. If checkpointing is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 538
OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. Other errors are: DMF_LIST_AND_SET_SPECIFIED DMF_INVALID_MAX_SESSION_VALUE DMF_INVALID_CHECKPOINT_INTERVAL_VALVE Errors returned from - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 539
with navicli. OUTPUT If the VNX OE for Block software running in the SP does not support the command, the CLI prints a Command is not supported error message to stderr. Other errors are: DMF_NAME_AND_UID_SPECIFIED DMF_NAME_OR_UID_REQUIRED DMF_UNKNOWN_DESCRIPTOR Errors returned from the driver or - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 540
navicli. OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. Other error messages are: DMF_NAME_AND_UID_SPECIFIED DMF_NAME_OR_UID_REQUIRED DMF_UNKNOWN_DESCRIPTOR Errors returned from the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 541
8 OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. Other errors are: DMF_NAME_AND_UID_SPECIFIED DMF_NAME_OR_UID_REQUIRED DMF_INVALID_THROTTLE_VALUE DMF_UNKNOWN_DESCRIPTOR Errors returned - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 542
. OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. Other errors are: DMF_NAME_AND_UID_SPECIFIED DMF_NAME_OR_UID_REQUIRED DMF_UNKNOWN_DESCRIPTOR DMF_PEER_SP_ALIVE Errors returned from - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 543
utilities OUTPUT If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. Other errors are: DMF_NAME_AND_UID_SPECIFIED DMF_NAME_OR_UID_REQUIRED DMF_UNKNOWN_DESCRIPTOR sancopy -updateconnections Updates - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 544
SAN Copy and its command line utilities SYNTAX sancopy -verify -wwn lun-wwn | -lunnumber sp-name lunnumber [-device devicename] [-log] [-iscsi|-fibre] OPTIONS -wwn lun-wwn Specifies the World Wide Name of the logical units. You can specify more than one WWN. -lunnumber sp-name lunnumber An alternate - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 545
or SSD drives), refer to the Best Practices documentation for information on using these disks with SnapView, which is available on EMC Online Support. Major topics are: l SnapView clone CLI commands 546 l Admsnap commands for clones 574 l SnapView Snapshot CLI commands 580 l Admsnap commands for - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 546
with your ESX Server. l For configuration restrictions when using VMFS volumes, go to the EMC E-Lab™ Interoperability Navigator on EMC Online Support and under the PDFs and Guides tab, open the VMware ESX server.pdf file. l For a secondary server to access the clone LUN, the clone must be assigned - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 547
EMC SnapView Software l Create a clone group; see clone - snapview -createclonegroup. l Add a clone to a clone group; see clone - snapview -addclone. CLI clone command functions The naviseccli clone functions, listed alphabetically, are: Note: As of version 6.26, you can issue clone commands using - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 548
whether creating a clone group on this system is supported and other useful information. clone | snapview -listclonegroup an initializing thin LUN as a clone target, provided the bundle containing the thin LUN support is committed in all the systems. The software assigns each clone a clone ID. This - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 549
numbers that can serve as clones. Currently only one LUN is supported per command. -issyncrequired 0|1 Specifies whether the software must synchronize the hardware component (such as an SP) fails. Values are: l manual - Manual recovery. The administrator must act to start synchronization. l auto - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 550
EMC SnapView Software -SyncRate high|medium|low|value Sets the interval between writes to a clone being synchronized to high, medium, or low, or a value in milliseconds. If the value is larger than 100, the interval is in milliseconds. Otherwise, it is the scaled between high rate and medium rate - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 551
operations. You must allocate one clone private LUN for each SP before you can create a clone group. This command supports thin LUNs, provided the bundle containing the thin support is committed in all the systems. Note: The clone -allocatecpl command restricts Clone Private LUNs to 128 element size - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 552
Specifies the synchronization action the system will take after a hardware component (such as an SP) fails. Values are: l manual - Manual recovery. The administrator must act to start synchronization. l auto - Automatic. Synchronization will start automatically using the other path (if available - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 553
- Updates the clone with the I/O. Default. 1 - Does not update the clone with I/O. This property is available only if the option is supported on the targeted system. Note: When you change the property for the -UseProtectedRestore option, SnapView automatically allocates and retains additional memory - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 554
EMC SnapView Software OPTIONS -AllowProtectedRestore 0|1 Enables or disables the ability to use protected restores on LUNs in a system. Be aware that enabling protected restores reserves SP memory and prevents it from being used for any other purpose. 0-Does not allow protected restores on this - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 555
EMC SnapView Software Specifies the 16-byte unique ID the software assigned when the clone group was created. The clone group ID consists of the numbers 0 through 9 and the letters A through F (these letters are not case sensitive). You can use the -listclonegroup command function to obtain the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 556
EMC SnapView Software After the consistent fracture completes, no group association exists between the clones. If a failure occurs on any of the clones, the consistent fracture will fail on all of the clones. If any clones within the group were fractured prior to the failure, the software will - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 557
EMC SnapView Software clone | snapview -createclonegroup Creates a new clone group based on a source LUN. PREREQUISITES You must have a user account on the system on which you want the command executed. You must have allocated a clone private LUN for each SP. Any source LUN that is at least 1 GB in - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 558
EMC SnapView Software EXAMPLE This command creates a clone group named db3_clone for source LUN 22. Refer to the example for -addclone, clone | snapview -addclone. naviseccli -address ss1_spa clone -createclonegroup -name db3_clone -luns 22 -o OUTPUT None if the command succeeds; status or error - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 559
EMC SnapView Software clone | snapview -destroyclonegroup Deletes a clone group. PREREQUISITES You must have a user account on the system on which you want the command executed. Before you can destroy a clone group, you must remove all clones in the clone group. DESCRIPTION The naviseccli clone or - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 560
syncclone function. Note: Unless you have additional software that supports same host access, you must assign the clone LUN to the error persists, contact your EMC service provider. A system fracture will occur source LUN trespasses to the peer SP, either manually or due to an SP failure. If this - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 561
source LUN After you fracture the clone, the software does not copy any server write requests made to the source LUN unless you manually perform a synchronization. Synchronizing a fractured clone unfractures the clone and updates the contents on the clone with its source LUN. SYNTAX clone | snapview - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 562
EMC SnapView Software DESCRIPTION The naviseccli clone or the naviseccli snapview command with -listclone displays information about one clone, not clone groups. You must specify the clone name or clone group ID. You can obtain more specific information with function switches. SYNTAX clone | - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 563
Displays the percentage of the clone that is synchronized with its source. -RecoveryPolicy Indicates the recovery policy (see -addclone), Automatic or Manual. -SyncRate Displays high,medium,low or a user-specified positive integer. -timeoffracture Displays the date/time when the clone images were - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 564
CloneLUNs: 10 UseProtectedRestore: No TimeofFracture: 12/15/09 11:25:19 clone | snapview -listclonefeature Displays general information for a system that supports clones. PREREQUISITES You must have a user account on the system on which you want the command executed. DESCRIPTION The naviseccli clone - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 565
clone with the I/O, or yes, which indicates that it should not update the clone with the I/O. This option is available only if it is supported on the targeted system. -AvailableLUNs Lists LUN numbers currently available to be used as either a source or clone. -CanCreate Indicates if a clone group - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 566
EMC SnapView Software clone | snapview -listclonegroup Displays clone group information. PREREQUISITES You must have a user account on the system on which you want the command executed. DESCRIPTION The naviseccli clone or the naviseccli snapview command with -listclonegroup and no other switches - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 567
of the clone instance that is currently synchronized with its source. Also applies to reverse-synchronizing operations. A user-defined value: Automatic or Manual. A user-defined value: high/medium/low. List of clone LUN numbers. State of the clone Protected Restore option: yes or no. -CloneLUNWWNs - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 568
EMC SnapView Software EXAMPLE naviseccli -address ss1_spa clone -listclonegroup -Name clone_0 -all Name: clone_0 CloneGroupUid: 50:06:01:60:BB:20:10:DD:01:00:00:00:00:00:00:00 InSync: Yes Description: QuiesceThreshold: 60 SourceMediaFailure: No IsControllingSP: No SourceLUNSize: 2097152 CloneCount - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 569
EMC SnapView Software OPTIONS -name name Identifies the clone group. Use the name assigned when the clone group was created with createclonegroup. To identify a clone group, you can use either the clone name or the clone group unique ID. -CloneGroupUid uid Specifies the 16-byte unique ID the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 570
clone in the clone group is not in a synchronizing or reverse synchronizing state. For a Windows operating system, you must disable the indexing service and recycle bin on the source LUN of the clone. This prevents data corruption during reverse synchronization. DESCRIPTION The naviseccli clone or - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 571
EMC SnapView Software Any server writes made to the source LUN after the clone was originally fractured are overwritten with the data on the clone. Any unmodified (unchanged) chunks of data are not rewritten to the source. After the reverse synchronization has completed, the clone that initiated - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 572
source LUN. This property is available only if the option is supported on the targeted system. EXAMPLE naviseccli -address ss1_spa clone - system fractured, you must manually fracture the clone before you can synchronize it. For a Windows operating system, the indexing service and recycle bin must - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 573
EMC SnapView Software writes from the source LUN to the clone LUN. The software does not copy any unmodified chunks to the clone. Note: If the same chunk of data is modified on the source LUN more than once, only the last modification is copied to the clone. While the clone is synchronizing, you: l - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 574
. l The production and secondary servers must have both the Unisphere Host Agent and admsnap software installed. To install the host agent and admsnap, refer to the EMC Block server support products guide for your operating system. 574 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 575
letter to every new device it finds. For Windows Remote Desktop and Terminal Services - If a terminal server is running on the secondary server, you must unload and load the HBA driver. The clone_activate command is not supported. Run the command list_devices or use the command scan_all_LUNs on the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 576
and removes assigned drive letters. This command is supported on Windows systems only. PREREQUISITES You must have administrative server enabled, it prevents the clone_deactivate command from working properly. For Microsoft Cluster Services (MSCS) - When you need to stop I/O to a clone or a - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 577
Administrator to bring the Disk Group(s) back online by right-clicking the Disk Group and selecting Bring Online. The clone_deactivate command is not supported; it is provided for script compatibility between Windows and UNIX only. If you issue the command on this server, admsnap will return an - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 578
writes are in process. If you are unable to unmount the file system, you can issue the admsnap flush commandb. The flush command is not supported. Dismount the file system by using the dismount command on the volume. a. With some operating systems, you may need to shut down the application to - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 579
if it cannot. EXAMPLE Windows example: admsnap flush -o E: admsnap list Performs a list operation and provides the World Wide Name (WWN) of all supported devices on the system. PREREQUISITES You must have administrative privileges on the production and secondary server. DESCRIPTION The admsnap list - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 580
with your ESX Server. l For configuration restrictions when using VMFS volumes, go to the E-Lab Interoperability Navigator on EMC Online Support and under the PDFs and Guides tab, open the VMware ESX server.pdf file. l For a secondary server to access the snapshot, you must assign the snapshot - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 581
the snapshot. 2. Rescan the bus at the ESX Server level. 3. If a virtual machine is already running, power off the virtual machine and use the Service Console of the ESX Server to assign the snapshot to the virtual machine. If a virtual machine is not running, create a virtual machine on the ESX - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 582
. Use VNX CLI for Block to configure the reserved LUN pool (refer to VNX CLI for Block). The CLI Reference also explains how you can manually estimate a suitable LUN pool size. Note: Thin LUNs are not eligible for use as reserved LUNs. SnapView command functions The naviseccli or navicli snapview - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 583
EMC SnapView Software Table 54 naviseccli or navicli SnapView command functions (continued) Command Description snapview -startrollback Starts a rollback on the selected SnapView session. snapview -startsession Starts a single SnapView session. snapview -stopsession Stops a SnapView session - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 584
snapview -activatesnapshot 2pmsession -snapshotname lun20copy OUTPUT If the version of software running on the SP does not support this command, a Command is not supported error message is printed to stderr. snapview -chgrollback Changes the rollback rate. PREREQUISITES For naviseccli, you must - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 585
not rolling back, the software returns an error message. If the version of software running on the SP does not support this command, a Command is not supported error message is printed to stderr. snapview -chgsnapshot Renames a snapshot. PREREQUISITES For naviseccli, you must have a user account on - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 586
must issue this command to the SP that owns the source LUN(s); otherwise, the command will fail. Note: Unless you have additional software that supports same host access, you must assign the snapshot to a storage group other than the storage group that holds the source LUN(s). You also must assign - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 587
snapview -createsnapshot 20 -snapshotname lun20snap OUTPUT If the version of software running on the SP does not support this command, a Command is not supported error message is printed to stderr. snapview -deactivatesnapshot Removes the association between a SnapView session and a snapshot LUN - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 588
-h ss1_spa snapview -deactivatesnapshot -snapshotname lun20copy OUTPUT If the version of software running on the SP does not support this command, a Command is not supported error message is printed to stderr. snapview -listrollback Displays rollback information, such as the rollback status and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 589
EMC SnapView Software OPTIONS -name sessionname Specifies the name for the SnapView session that is rolling back. If you do not specify a session name, the software returns the names for all sessions that are rolling back on that SP. -rate high|medium|low Specifies the rate at which the software - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 590
on this SP is in the process of rolling back. If the version of software running on the SP does not support this command, a Command is not supported error message is printed to stderr. snapview -listsessions Lists session performance statistics. PREREQUISITES For naviseccli, you must have a user - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 591
EMC SnapView Software SYNTAX snapview -listsessions [-name [sessionname]] [-all] [-cacheusage] [-consistent] [-cowwrites] [-creationtime] [-includepeer] [-luns] [-lunwrites] [-persistence] [-readfromcache] [-readslun] [-readssnapshot] [-reserved] [-sessionstate] [-snapshotsname] [-snapshotsuid] [- - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 592
agent. Actual output varies depending on the switches you use with the -listsessions command. Name of the session: rollbackTest Number of read requests serviced by the snapview reserved LUN pool: 65264 Total number of read requests on the snapview logical unit: 0 Number of reads from the Thin LUN - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 593
:56:28 Session state: Normal If the version of VNX OE for Block software running on the SP does not support this command, a Command is not supported error message is printed to stderr. snapview -listsnapshots Displays information on snapshot copies. PREREQUISITES For naviseccli, you must have a user - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 594
:D7:11 Target Logical Unit: 4 State: Active Session Name: sessionAtNoonOnLun4 If the version of software running on the SP does not support this command, a Command is not supported error message is printed to stderr. snapview -listsnapableluns Lists all source LUNs on which you can create a snapshot - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 595
8 Name LUN 9 Name LUN 10 Name LUN 11 Name metaLun67 If the software running in the SP does not support the command, the CLI prints a Command is not supported error message to stderr. snapview -lunpool Lists all reserved LUNs that are currently being used with SnapView. PREREQUISITES For naviseccli - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 596
-rmsnapshot -snapshotname 2pmsnap Do you really want to remove the snapshot (y/n)[N]? y OUTPUT If the version of software running on the SP does not support this command, a Command is not supported error message is printed to stderr. 596 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 597
a session to the source LUN(s). CAUTION Windows operating systems only - To prevent data corruption during the rollback operation, you should disable the indexing service and recycle bin on the source LUN(s) of the session you will roll back. When you confirm the start of a rollback operation, the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 598
EMC SnapView Software it completes all background copying. The software will also terminate any other session that tries to allocate additional reserved LUN pool space. You cannot roll back a SnapView session if the session's source LUN(s) is: l an unfractured clone. You must fracture the clone - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 599
software running on the SP does not support this command, a Command is not supported error message is printed to stderr. start another consistent session using the same source LUNs. l If MirrorView/Asynchronous is installed, the source LUNs that you will use to start the consistent session cannot - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 600
EMC SnapView Software OPTIONS -startsession sessionname Specifies the name of the session to be started. A session name can have as many as 32 characters. A name is required. If you use spaces in the name, enclose the entire name string in quotation marks in this command and in other CLI commands - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 601
persistent session. The session will survive SP reboot or failure, software installation, system reboot or power failure, and server I/O trespassing to the that shipped with your failover software. Note: For information on supported failover software for the system you are managing, refer to the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 602
. Do you really want to stop the session (y/n)[n]? y OUTPUT If the version of software running on the SP does not support this command, a Command is not supported error message is printed to stderr. Other errors: INVALID_SESSION Session does not exist. POSTREQUISITES For a step-by-step overview and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 603
. l The production and secondary servers must have both the Unisphere Host Agent and admsnap software installed. To install the host agent and admsnap, refer to the EMC Block server support products guide for your operating system. l A reserved LUN must be available for each source LUN(s) for which - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 604
are available, then admsnap will activate only one physical disk and an error appears through the command line. For Windows Remote Desktop and Terminal Services - If a terminal server is running on the secondary server, you must remove and disable it before using the activate command. If you have - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 605
for the type of object specified with the -t option. The table below lists the supported object names for your operating system. Table 56 Operating system object names Windows Operating system Supported object name(s) l Drive letter EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 606
EMC SnapView Software Table 56 Operating system object names (continued) Operating system HP-UXa Solaris Linux AIXa Supported object name(s) l Physical drive name l Device name (Legacy and agile views) l File system nameb l Powerpath device l Veritas volume name (disk-based and enclosure-based)c - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 607
EMC SnapView Software You cannot use this option in conjunction with the -d option. [-d driveletter] Specifies the drive letter you want to assign to the snapshot device, and if available, admsnap will assign the specified drive letter to the snapshot device. If the operation resulted in more than - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 608
disks and each physical disk has its own volume, then the drive letter on each volume will be removed. For Windows Remote Desktop and Terminal Services - If a terminal server is running on the secondary server, you must remove and disable it before using the deactivate command. If you have the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 609
object names for your operating system. Table 58 Operating system object names Windows Operating system HP-UXa Supported object name(s) l Drive letter l Physical drive name l Device name (Legacy and agile views) l File system nameb l Powerpath device l Veritas volume name (disk-based and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 610
type, admsnap will attempt to determine the correct object type among the valid object types and report a failure if it cannot. This switch is supported on Windows or Solaris operating systems only. [-f] You can use this option to force a deactivate operation on a physical device name that does not - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 611
you use the -t option, the device name must be a valid name for the type of object specified with the -t option. The table below lists the supported object names for your operating system. EMC® VNX® Series Command Line Interface Reference for Block 611 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 612
spaces, enter the name without spaces. If you do not provide an object type, admsnap will attempt to determine the correct object type from the supported types and report a failure if it cannot. You should use the -t option when the argument for the -o option is not in a standard and recognizable - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 613
the command; it lists the help output only. This option is valid for Windows, and Solaris systems only. [-l lun_wwn] Lists the WWN of all supported devices on the system. The WWN must use a valid WWN format. [-d object_name] Specifies an object name. On Windows systems, the -a option is ignored - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 614
EMC SnapView Software Table 61 Operating system object names (continued) HP-UXa Operating system AIXa Linux Solaris Supported object name(s) l Device name (Legacy and agile) l File system nameb l Veritas volume name (disk-based and enclosure-based)c l Powerpath device l Device name l File - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 615
The admsnap start operation starts a SnapView persistent session with the specified session name. A persistent session survives SP failures, software installation upgrades, and event trespasses. Note: Admsnap version 2.24 or later enables all SnapView sessions to run in persistence mode as - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 616
object names for your operating system. Table 62 Operating system object names Windows Operating system HP-UXa Solaris Linux AIXa Supported object name(s) l Drive letter l Physical drive name l Device name (Legacy and agile views) l File system nameb l Powerpath device l Veritas volume - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 617
session. -p Specifies a persistent session. If you use this option, the session will run in persistence mode and will survive SP failures, software installation upgrades, and trespass events. With admsnap version 2.24 or later, all SnapView sessions run in persistence mode, so the -p switch is no - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 618
you use the -t option, the device name must be a valid name for the type of object specified with the -t option. The table below lists the supported object names for your operating system. 618 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 619
EMC SnapView Software Table 63 Operating system object names Windows Operating system HP-UXa Solaris Linux AIXa Supported object name(s) l Drive letter l Physical drive name l Device name (Legacy and agile views) l File system nameb l Powerpath device l Veritas volume name (disk-based and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 620
EMC SnapView Software EXAMPLE Windows example: admsnap stop -s session1 -o \\.\PhysicalDrive1 620 EMC® VNX® Series Command Line Interface Reference for Block - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 621
CHAPTER 13 EMC VNX Snapshots Software This chapter introduces the EMC VNX Snapshots™ software and the associated commands. The VNX Snapshots commands are divided into two types: Snapshot CLI commands and SnapCLI commands. Major topics include: l VNX Snapshots CLI commands 622 l SnapCLI commands for - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 622
-feature command allows the user to list properties of VNX Snapshots feature. SYNTAX snap -feature -info OUTPUT naviseccli snap -feature -info Is Advanced Snaps Supported: True Max. Snaps: 4096 Max. Snaps Per Source: 256 Max. CGs: 120 Max. Members Per CG: 64 Max. SnapLUNs: 512 Total Number of Snaps - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 623
EMC VNX Snapshots Software SYNTAX snap -create -res resource [-resType type] [-name snapName] [-descr description] [-keepFor number {h|d|m|y} |-allowAutoDelete{yes|no}] [-allowReadWrite {yes|no}] [-ignoreMigrationCheck] [-ignoreDeduplicationCheck] OPTIONS -res resource Specifies the ID of the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 624
EMC VNX Snapshots Software l Yes - attachable l No - non-attachable -ignoreMigrationCheck Executes the command without prompting for confirmation. -ignoreDeduplicationCheck Overrides the error during snapshot creation while the source is enabling deduplication or disabling deduplication. EXAMPLE - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 625
: Ready Allow Read/Write: Yes Modified: Yes Allow auto delete: Yes Expiration date: Never Name: LUN1_2009-04-15-09:01:01_8 Description: Snapshot before installing Visual Studio Creation time: 04/15/09 09:01:01 Source LUNs: 1 Source CG: N/A State: Ready Allow Read/Write: No Modified: No Allow auto - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 626
: Ready Allow Read/Write: Yes Modified: Yes Allow auto delete: Yes Expiration date: Never Name: LUN1_2009-04-15-09:01:01_8 Description: Snapshot before installing Visual Studio Creation time: 04/15/09 09:01:01 Source LUNs: 1 Source CG: N/A State: Ready Allow Read/Write: No Modified: No Allow auto - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 627
EMC VNX Snapshots Software snap -modify Modifies the snapshot's name, description, expiration time, auto delete policy, or attach policy. DESCRIPTION The snap -modify command allows the user to give a different name, description, expiration time, auto delete policy, or attach policy to the Snapshot - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 628
EMC VNX Snapshots Software snap -copy EXAMPLE naviseccli snap -modify -id TLU1_Snapshot1 -name TLU1_Snapshot2 -allowAutoDelete yes OUTPUT There is no output for this command. Replicates a Snapshot. DESCRIPTION The snap -copy command allows the user to replicate a Snapshot. SYNTAX snap -copy -id - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 629
EMC VNX Snapshots Software OPTIONS -id Specifies the ID of the snapshot to be restored. -bakName Specifies the backup snapshot name. Note: To save the current file, a backup snapshot is created on the primary LUN before restoring. -res Specifies the LUN number of the primary LUN, snapshot mount - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 630
EMC VNX Snapshots Software snap -detach Detaches snapshot mount points from a snapshot. DESCRIPTION The snap -detach command allows the user to detach snapshot mount points from a snapshot. SYNTAX snap -detach -id snapName [-res lunNumber] [-o] OPTIONS -id Specifies the ID of snapshot to be - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 631
EMC VNX Snapshots Software l no - disallow auto delete EXAMPLE naviseccli snap -group -create -name CG1_Exchange -res 2,3 OUTPUT There is no output for this command. snap -group -destroy Deletes a consistency group. DESCRIPTION The snap -group -destroy command allows user to delete a consistency - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 632
EMC VNX Snapshots Software -allowSnapAutoDelete Specifies the default auto delete policy that will apply to the Snapshot Set of this Consistency Group. Valid values are: l yes - allow auto delete l no - disallow auto delete EXAMPLE naviseccli snap -group -modify -id CG1_Exchange - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 633
EMC VNX Snapshots Software naviseccli snap -group -list -id CG_SQLServer -detail Name: CG_SQLServer Description: Consistency Group containing all LUNs used in SQL Server Allow auto delete: Yes Member(s): 2, 4 State: Ready Status: N/A snap -group -addmember Adds member LUNs to the consistency group. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 634
EMC VNX Snapshots Software OUTPUT There is no output for this command. snap -group -replmember Replaces member LUNs of the consistency groups with the specified LUNs. DESCRIPTION The snap -group -replmember command replaces member LUNs of the consistency groups with the specified LUNs. SYNTAX snap - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 635
EMC VNX Snapshots Software lun -create Specifies the snapshot mount point number. -name Specifies the snapshot mount point name. -allowSnapAutoDelete Specifies the snapshot auto delete policy of the snapshot mount point. Valid values are: l Yes - allow auto delete l No - disallow auto delete - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 636
EMC VNX Snapshots Software l automatic (default) -ignoreThresholds Forces the non-snap LUN to be created, ignoring possible threshold related error. OUTPUT There is no output for this command. lun -destroy Deletes the primary LUN or snapshot mount point. DESCRIPTION The lun -destroy command - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 637
EMC VNX Snapshots Software OPTIONS -l Specifies the number of LUNs to be modified. -name Specifies the name of LUN to be modified. -aa Specifies the auto assignment. -newName Specifies the new name for the specified LUN. -sp Specifies the new default SP of the LUN to be modified. - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 638
EMC VNX Snapshots Software OPTIONS -ignoreThresholds Force the non-snap LUN to be created, ignoring the possible threshold-related error. OUTPUT There is no output for this command. lun -attach Attaches the snapshot mount point to the specified snapshot. DESCRIPTION The lun -attach command - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 639
EMC VNX Snapshots Software storagepool -create Creates a storage pool by specifying a snapshot auto delete policy and MR-related thresholds. DESCRIPTION The storagepool -create command allows the user to create a storage pool by specifying a snapshot auto delete policy and MR-related thresholds. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 640
EMC VNX Snapshots Software storagepool -modify Modifies the snapshot auto delete policy and MR-related thresholds of an existing storage pool. DESCRIPTION The storagepool -modify command allows the user to modify the snapshot auto delete policy and MR-related thresholds of an existing storage pool. - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 641
as what they would consume if all of the primary LUNs, data was overwritten. -metadataSubscribedCap The total amount of metadata storage that is required to support writing to the entire contents of all of the LUNs in the pool. -compressionSavings The total amount of storage that is being saved by - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 642
EMC VNX Snapshots Software -snapPoolFullThresholdEnabled Shows whether the system should check the pool full high water mark for auto delete. -snapPoolFullHWM Shows the pool full high water mark of the specified storage pool or pools. -snapPoolFullLWM Shows the pool full low water mark of the - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 643
EMC VNX Snapshots Software Snapshot Allocation (GBs): 10.521 Metadata Allocation (Blocks): 22063104 Metadata Allocation (GBs): 10.521 Available Capacity (Blocks): 2206310400 Available Capacity (GBs): 1052.051 Percent Full: 1.777 Total Subscribed Capacity (Blocks): 44126208 Total Subscribed Capacity - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 644
prefetch> - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 645
modified the VNX Snapshot. Failure to do this may result in an inconsistent or unusable point-intime copy. This section lists the snapCLI commands that support the VNX Snapshots feature. EMC® VNX® Series Command Line Interface Reference for Block 645 - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 646
the object-type. The only valid object-types are "device", "filesystem", "volume", and "driveletter". This option is optional for these four supported object types. If not provided, SnapCLI attempts to determine the correct object type and reports a failure if it cannot. -c This option identifies - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 647
specifies the object_type. The only valid object_types are "device", "filesystem", "volume", and "driveletter". This option is optional for these four basic supported object types. If no option is provided, SnapCLI attempts to determine the correct object type among these four object types, and - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 648
EMC VNX Snapshots Software SYNTAX snapcli copy -h | -s object_type-b snap_name -o object_name OPTIONS -h Prints out this message. If this option is present on the command line, no other option validation is performed and this message is printed. -s Specifies a snapshot name for the snap to be - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 649
option is given. The only valid object types are "device", "filesystem", "volume", and "driveletter". This option is optional for these four basic supported object types. If no option is provided, SnapCLI attempts to determine the correct object type among the four object types and reports a failure - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 650
a -o option is given. The only valid object_type are "device", "filesystem", "volume", and "driveletter". This option is optional for these four basic supported object types. If no option is provided, SnapCLI attempts to determine the correct object type among these four object types and reports - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 651
on the Storage Processor This chapter introduces EMC Secure Remote Support (ESRS) on the Storage Processor (SP) and the associated commands for configuring and managing this feature. Major topics include: l ESRS Device Client on Storage Processor - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 652
l EMC professionals are authenticated using two unique factors. l All EMC service professionals have a unique username that is logged with all their actions. be configured with at least one DNS server for EMC Secure Remote Support (ESRS) to function properly. To provision ESRS, you must be logged - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 653
EMC Online Support password. For EMC users, specify an RSA SecureID token password. -emcuser Specified when the user is an administrator or authorized service provider. [email protected] -password Password1 OUTPUT Software installed successfully. ESRS has been provisioned and Template - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 654
EMC Secure Remote Support on the Storage Processor OUTPUT Connecting To: esrs-corestg.emc.com on port 443 Connection Status: Connected Proxy Server: Disabled Policy Manager: Disabled. SSL: Enabled, - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 655
for ESRS on the SP. DESCRIPTION The esrsconfig -configpolicymanager -addpm command configures Policy Manager for EMC Secure Remote Support (ESRS) on the storage processor (SP). SYNTAX esrsconfig -configpolicymanager -addpm [-secure] -host pmhostname | pmipaddress [-port PMportnumber] [-http|-socks - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 656
EMC Secure Remote Support on the Storage Processor OPTIONS -addpm Adds Policy Manager and configuration information. -secure If specified, uses the HTTPS protocol to access the server. -host Specifies - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 657
EMC Secure Remote Support on the Storage Processor OUTPUT Policy Server Enabled: true Host: 10.245.36.202 Port: 8090 SSL Enabled: false Proxy Server Enabled: false esrsconfig -configpolicymanager - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 658
EMC Secure Remote Support on the Storage Processor OUTPUT Agent PM changes successful esrsconfig -configpolicymanager -removepolicyproxy Removes the proxy server for Policy Manager for ESRS on the SP. DESCRIPTION - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 659
CHAPTER 15 Data at Rest Encryption This chapter introduces Data at Rest Encryption (D@RE) and the associated commands for activating and monitoring this feature. Major topics include: l Data at Rest Encryption overview 660 l securedata -feature -activate 661 l securedata -feature -info...662 l - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 660
the DataAtRestEncryption enabler and activate it as described in theSecurity Configuration Guide for VNX. If Encryption Mode appears as Unencrypted, you only keystore is in an inaccessible state. In this case, a service engagement is required for resolution. A separate auditing function is provided - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 661
This example shows output for when the encryption enabler is not yet installed. naviseccli -h securedata -feature -activate Encryption operations are not supported until the DataAtRestEncryption enabler is installed. EXAMPLE #2 This example shows output for when the encryption feature is - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 662
modules cannot support Data at Rest Encryption. Examine other SP Event Log entries for details, gather SPcollects and contact your service provider. ( #1 This example shows output for when the encryption enabler is installed, but the encryption feature has not yet been activated. 662 EMC - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 663
, but a new drive has been added to the array, which must be scrubbed. naviseccli -h securedata -feature -info Is Encryption Supported: Yes Encryption Mode: Controller Based Encryption Encryption Status: Scrubbing Percent Encrypted: 100.00 EXAMPLE #4 This example shows output for an - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 664
backup operation is required. SYNTAX securedata -backupkeys -status EXAMPLE #1 This example shows the output for when the encryption enabler is installed, but the encryption feature has not yet been activated on the array. naviseccli -h securedata -backupkeys -status Status: No operation - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 665
EXAMPLE #1 This example shows output for when the encryption enabler is installed, but the feature has not yet been activated. naviseccli -h securedata -backupkeys -retrieve This operation is not supported until the encryption feature has been activated. EXAMPLE #2 This example shows - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 666
Data at Rest Encryption -path Specifies the path on the local system where the auditlog and checksum files will be saved. EXAMPLE #1 This example shows output if the command succeeds, but with a partial file retrieval as the full log file exceeds 100 MBs. naviseccli -h securedata - - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 667
failed SP A: The checksum file retrieval process failed. Examine other SP Event Log entries for details, gather SPcollects and contact your service provider. (0x71408019) EXAMPLE #3 This example shows output if the command fails because the request has timed out. naviseccli -h securedata - Dell VNX5600 | VNX Command Line Interface Reference for Block 5.33 - Page 668
Data at Rest Encryption 668 EMC® VNX® Series Command Line Interface Reference for Block
EMC
®
VNX
®
Series
Version 5.33
Command Line Interface Reference for Block
P/N 300-015-135 REV. 08
March 2020