SYMCLI Command Line Examples

To check symcli version ­ symcli
To check Microcode version ­ symcfg list 
To check the Build version of microcode ­ symcfg list ­v
 
To check the FA's on the symmetrix ­ symcfg ­sid 1234 ­fa all list
 
To check the FA connectivity status ­ symcfg ­sid 1234 ­fa all list ­port 
Note :(X) : Fibre Port is Connected to a Fibre Port (HBA, Switch or RF Director) 
(­) : Fibre Port is Not Connected.

 
To check the wwn of an FA port
symcfg ­sid 1234 ­fa 5e ­p 0 list
 

To check both wwpn and wwn of an FA port
symcfg ­sid 1234 ­fa 5e ­p 0 list ­v
Note : For a VMAX array wwnn is the same for all FA ports and wwpn is unique., whereas in a DMX array both wwpn
and wwnn is the same for every FA port
 

To view Port Flags
You can display the possible port flags and their current status with the following
command ­ symcfg ­sid 1234 ­fa 5e ­p 0 list ­v
The following is a partial example of output:   
 
  SCSI Flags 
           {
             Negotiate_Reset(N)           : Disabled
             Soft_Reset(S)                : Disabled
             Environ_Set(E)               : Disabled
             HP3000_Mode(B)               : Disabled
             Common_Serial_Number(C)      : Enabled
             Disable_Q_Reset_on_UA(D)     : Disabled
             Sunapee(SCL)                 : Disabled
             Siemens(S)                   : Disabled
             Sequent(SEQ)                 : Disabled
             Avoid_Reset_Broadcast(ARB)   : Disabled
             Server_On_AS400(A4S)         : Disabled
             SCSI_3(SC3)                  : Enabled
             SPC2_Protocol_Version(SPC2)  : Enabled
             SCSI_Support1(OS2007)        : Enabled
             WP_Bypass(WPBP)              : Disabled
           }

 
         Fibre Specific Flags
           {
             Volume_Set_Addressing(V)     : Disabled
             Non_Participating(NP)        : Disabled

  Alloc % — Shows the percentage of space that has been allocated in the pool. This includes the sum of the enabled and disabled DATA devices in the pool. 00A4 ­ is the VCM  (ACLX) …device which holds all the masking information…it is write disabled. use the symcfg list  command with the Symmetrix ID.   To list only thin devices ­ add the ­tdev option symdev ­sid 1234 list ­tdev   To list free and unused tdevs ­add the ­noport option symdev ­sid 1234 list ­tdev ­noport    To list free tdevs not bound to any thin pool ­ add the ­unbound option symdev ­sid 1234 list ­tdev ­noport ­unbound Note : NR means Not Ready ( the device is not bound to a thin pool )   Viewing Thin Pools To display all pools. Enabled MBs — Shows the total capacity of the enabled DATA devices in the pool.             Unique_WWN(UWN)              : Enabled              Access_Logix(ACLX)           : Enabled              OpenVMS(OVMS)                : Disabled              AS400(AS4)                   : Disabled              Auto_Negotiate(EAN)          : Enabled              VNX_Gateway_Direct_Attach    : Disabled            } To enable/disable FA flags use the following syntax Example : If you want to enable SCSI3 protocol on FA 5e:1 Create a file and add the below line and then run symconfigure preview and commit ­  set port 05E:1 SCSI_3=enable;   Certain FA flags like SPC2 . V bit need the FA port to be off lined first before enabling /disabling the flag To offline an FA port ­ symcfg ­sid 1234 ­fa 5e ­p 0 offline To enable SPC2 protocol ­  set port 05E:1 SPC2_Protocol_Version=enable;   To list used and unused devices (both thin and thick devices) symdev ­sid 1234 list Note : The 3rd column shows the state of the devices whether its free or not (???:? denotes that the device is free.  Alloc MBs — Shows the amount of space that has been allocated to thin devices bound to this pool. ***:* means the device is mapped to multiple FA ports. Subs % — Stands for subscribed percentage. as shown in the following example command and output: symcfg ­sid xxxx list ­thin ­pool ­detail ­tb     The Virtual Provisioning pool output has the following additional information in it that is particularly relevant for thin devices and thin device pools: Total MBs — Indicates the total capacity of the pool. The ratio is expressed as a percentage. This indicates the ratio of the capacity of the thin devices that are bound to this pool with respect to the total enabled capacity of this pool.   . 6G:1 means the device is mapped to FA port 6G:1).

    Display locks on the symmetrix ­ symcfg ­sid 1234 list ­lockn all   To release the lock ­ symcfg ­sid 1234 release ­lockn 15 ­force   To list all thin devices  and also their associated thin pools  (Quite Useful Command) ­ symcfg ­sid xxxx list ­tdev ­gb ­detail   The symcfg list ­tdev command can be used to monitor the progress of space reclamation. However.   Monitoring a device pool To monitor a device pool’s usage. When a user attempts to write data to a thin device. all the allocated tracks may not have data written on them. Written Tracks — The number of tracks on which data has actually been written. Rebalance variance etc. as follows symcfg ­sid xxxx monitor ­thin ­pool VP_TIER_SATA   .Also displays thin pool metrics like Pool Reserved capacity(PRC.Raid level. about thin devices and data devices. Subscription ratio . Displays Enabled datadevs. how much space has been allocated as well as thin devices in each pool. tracks are allocated in chunks. The following is an example output showing thin devices that are in the process of being reclaimed to free up unwritten allocated space as a result of using the symconfigure free command.   symcfg ­sid 2466 list ­tdev ­pool TIER1 ­thin |more   Symmetrix ID: 000192602466   Enabled Capacity (Tracks) : 1209575088 Bound   Capacity (Tracks) : 1188481020                     S Y M M E T R I X   T H I N   D E V I C E S        ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­                                    Pool        Pool           Pool                                Dev       Total  Subs     Allocated       Written             Sym  Pool Name    Emul     Tracks   (%)   Tracks (%)     Tracks (%) Status      ­­­­ ­­­­­­­­­­­­ ­­­­­ ­­­­­­­­­ ­­­­­ ­­­­­­­­­ ­­­ ­­­­­­­­­ ­­­ ­­­­­­­­­­­ 0274 TIER1        FBA      552120     0    552132   0    119017   0 Bound       0275 TIER1        FBA      552120     0    552132   0     47614   0 Bound       0276 TIER1        FBA      552120     0    552132   0     60669   0 Bound           Total                   ­­­­­­­­­ ­­­­­ ­­­­­­­­­ ­­­ ­­­­­­­­­ ­­­ Tracks                  1188481020    98 1142768712  94  73763546   6   Allocated Tracks — The number of tracks that have been allocated (and hence these many tracks have been used from the data pool to which this thin device belongs). the symcfg monitor command has been added. This column indicates the number of tracks on which data has been written. The device status of Reclaiming indicates that the thin devices are in the process of being reclaimed. The allocated tracks and written tracks adjust accordingly as the space is reclaimed.This command gives you detailed information.

 In most cases Data devs will be created by EMC engineers.  symcfg ­sid 1234 list ­datadev ­nonpooled   Symmetrix ID: 000192601234                  S Y M M E T R I X   D A T A   D E V I C E S ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­      Dev   Dev          Pool                        Total      Used Full Sym  Emul  Config       Type Pool Name    State    Tracks    Tracks  (%) ­­­­ ­­­­­ ­­­­­­­­­­­­ ­­­­ ­­­­­­­­­­­­ ­­­­­ ­­­­­­­­­ ­­­­­­­­­ ­­­­ 0998 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 0999 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0     Creating thin pools Thin pools can be created at the same time as creating the DATA devices . You can add the data devs to the  appropriate thin pools. type = thin [. . max_subs_percent= <n>] [. rebalance_variance = n].   To create a thin pool. use the following form: create pool PoolName.Data Device examples : The following example returns a list of DATA devices for a specific Symmetrix array: symcfg ­sid 1234 list ­datadev   Symmetrix ID: 000192601234                  S Y M M E T R I X   D A T A   D E V I C E S ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­      Dev   Dev          Pool                        Total      Used Full Sym  Emul  Config       Type Pool Name    State    Tracks    Tracks  (%) ­­­­ ­­­­­ ­­­­­­­­­­­­ ­­­­ ­­­­­­­­­­­­ ­­­­­ ­­­­­­­­­ ­­­­­­­­­ ­­­­ 00D7 FBA   RAID­5(7+1)   TH  TIER1         Ena    3939984   3939984  100 00D8 FBA   RAID­5(7+1)   TH  TIER1         Ena    3939984   3939984  100 00D9 FBA   RAID­5(7+1)   TH  TIER1         Ena    3939984   3939984  100 00DA FBA   RAID­5(7+1)   TH  TIER1         Ena    3939984   3939984  100 09F3 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F4 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F5 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F6 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F7 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F8 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F9 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0   Total                                           ­­­­­­­­­ ­­­­­­­­­ ­­­­ Tracks                                          ­1871877136 1731691896   71   The displayed output can be filtered further using the ­nonpooled option to show only the DATA or SAVE devices that are not associated with a pool. and the ­RANGE option to display only a range of devices.

◆ DATA device pools must have the same disk type (EFD. This can have a value between 0 and 65534. reclaiming allocated persistent tracks is also supported.3 and higher supports allocating persistent tracks during the creation of a thin device. ◆ All DATA devices in a thin pool must have the same protection. ◆ A thin pool can only contain DATA devices with one emulation type. In addition. Solutions Enabler V7. or into a pool that only contains DATA devices that have the same protection and emulation type. pool_resv_cap = n] [. SRDF/A DSE pools are for SRDF/A operations. max_subs_percent — Specifies the maximum total capacity that can be bound to the pool. A value of 200 indicates that the total capacity of the thin devices bound to a pool cannot exceed twice the amount of the actual capacity of the pool. It can be set in the range of 2 to 1024. ◆ DATA devices cannot be disabled and moved from a thin pool in the same session. pool_resv_cap — (FAST use only) The pool reserved capacity (PRC) is a percentage of the capacity of the virtual pool that will be reserved for non­FAST activities. thin pools are for Virtual Provisioning operations with thin devices. The default value is 1. ◆ DATA devices created from external provisioning can only be added to pools of devices created from external provisioning. Instead. vp_compression = <ENABLE>]; Where: type — Specifies the type of device pool. Its default value is 256. A value of 100 indicates that the total capacity of the thin devices bound to a pool cannot exceed 100 percent of the actual capacity of the pool. if a thin pool has the first DATA device defined as a 2­Way­Mir. If the free space in this pool (as a percentage of pool­enabled capacity) falls below the PRC. rebalance_variance — Specifies the value (in %) for the pool Rebalance Variance. It can be from 1 to 12 alphanumeric characters long and include hyphens ( ­ ). ◆ A DATA device of a specific protection and emulation can be put only into an empty thin pool. ◆ If the total pool capacity needed to store existing thin device data will be insufficient as a result of a disable dev SymDevStart:SymDevEnd command.   Creating Thin devices and Binding to thin Pools. and underscore ( _ ) characters. max_dev_per_rebalance_scan — Specifies the maximum limit (in %) for the pool rebalance scan device range. A value of 1 will allow only a maximum thin capacity that totals 1/100th the actual physical capacity of the pool. they look like regular devices with their configured capacity. The host treats them as regular devices and writes and reads from these devices like regular devices. ◆ A DATA device can only be removed from a thin pool if it is disabled and has no used tracks on it. Valid PRC values range from 1 to 80 percent. the FAST controller does not move any more chunks into the pool. To a host operating system.[. SATA). the first DATA device added to the thin pool defines its emulation type.   Note: PRC values set at the pool­level override any globally set PRC values   Thin pool restrictions The following restrictions apply to thin pools: ◆ The last DATA device cannot be removed from a pool if the pool is enabled for compression. all subsequent added DATA devices must be 2­Way­Mir devices. Thin devices are devices that may or may not have storage allocated to them when they are created. FC. binding a thin device to a pool. none of the devices in the requested range will be disabled. The largest number 65534 indicates that the total capacity of the thin devices bound to a pool can be 65534 percent of the total physical capacity of the pool. and during the allocation of a thin device. For example.Use a command file (symconfigure) to create thin devices. It can be set in the range of 1 to 50. Snap pools are for TimeFinder/Snap operations. . The pool itself is not defined to be a pool for an emulation type. PoolName — Specifies the name of the device pool.

 If it is not supplied. unbind the thin device or execute a symconfigure start reclaim on dev  command with a persistent type qualifier. If MB or GB is not specified. the size defaults to cylinders. CKD 3390. the device size must be less than or equal to the available space in the pool. . [. as well as clone. size = n [MB | GB | CYL]. emulation  — Indicates FBA.RDF2+TDEV (remote SRDF thin device). preallocate size  — Specifies the amount of space preallocated to the devices. ◆ If a specific preallocate size is mentioned. which is the entire device. The amount of space must be less than or equal to the available space in the pool and less than or equal to the allocated size of the thin device. or higher. remote_pool  — Specifies the name of the remote thin pool. the allocations are unaffected by any reclaim operations. Note: Thin CKD devices require Enginuity V5876 or higher.3. cylinders are used by default. binding to pool=PoolName [preallocate size = <ALL | n [ MB | GB | CYL>] [allocate_type=persistent]] [remote_pool=PoolName]];  Where: create dev count  — Specifies the number of thin devices you are creating. Note: If you are running Solutions Enabler V7. config  — Specifies TDEV (local thin device). the space must be less than or equal to the available space in the pool and less than or equal to the specified size of the thin device. use the preallocate ALL option.The syntax related to creating thin devices is shown below: create dev count=n. snap. The remote_config  option is only used when creating both local and remote SRDF thin devices. or BCV+TDEV. RDF1+TDEV (local SRDF thin device). allocate_type  — An optional parameter that can be specified along with the preallocate_size  option. symconfigure  will preallocate non persistent tracks which can be reclaimed without any additional reclaim flags. or SRDF copy operations. remote_config  — Specifies RDF2. If MB or GB is not specified. With this option. config=DeviceConfig [. or AS/400 D910_099 devices. ◆The preallocate size  can only be specified when the newly created device is also being bound to a pool. Restrictions when preallocating the size ◆ If the ALL option is used. remote_config=DeviceConfig. emulation=EmulationType. size= n [MB |GB |CYL]  — Specifies the size of each thin device. binding to pool  — Specifies the name of the local thin pool.   Note: To remove the persistent allocation.