You are on page 1of 6

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

 The ratio is expressed as a percentage.   . 6G:1 means the device is mapped to FA port 6G:1). Enabled MBs — Shows the total capacity of the enabled DATA devices in the pool. 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. Subs % — Stands for subscribed percentage. use the symcfg list  command with the Symmetrix ID.  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.   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. 00A4 ­ is the VCM  (ACLX) …device which holds all the masking information…it is write disabled. ***:* means the device is mapped to multiple FA ports.  Alloc MBs — Shows the amount of space that has been allocated to thin devices bound to this pool. 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.             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 . 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.

 The allocated tracks and written tracks adjust accordingly as the space is reclaimed. 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.Raid level. Subscription ratio . Rebalance variance etc.This command gives you detailed information. about thin devices and data devices. how much space has been allocated as well as thin devices in each pool. However.   Monitoring a device pool To monitor a device pool’s usage. This column indicates the number of tracks on which data has been written. Displays Enabled datadevs.Also displays thin pool metrics like Pool Reserved capacity(PRC. as follows symcfg ­sid xxxx monitor ­thin ­pool VP_TIER_SATA   . all the allocated tracks may not have data written on them.   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). When a user attempts to write data to a thin device. Written Tracks — The number of tracks on which data has actually been written. tracks are allocated in chunks. the symcfg monitor command has been added.     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. The device status of Reclaiming indicates that the thin devices are in the process of being reclaimed.

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

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