|MANUFACTURER’S MODEL||DESCRIPTION||EMC BRANDED VERSION|
|BROCADE 12000||64 Port 2g Director||ED-12000B-64|
|ADD-ON 16 PORTS||Blade with SFPs||PB-12000B-16|
|BROCADE 3900||2G, 32 PORT with SFPs||DS-32B2|
|BROCADE 3800||2B, 16 PORT with SFPs||DS-16B2|
|BROCADE 3200||2G, 8 PORT with SFPs||DS-8B2|
|BROCADE 2800||1G, 16 PORT with GBICs||DS-16B|
|BROCADE 2400||1G, 8 PORT with GBICs||DS-8B|
|MCDATA 3232||2G, 32 PORT with GBICs||DS-32M2|
|MCDATA 3216||2G, 16 PORT with GBICs||DS-16M2|
|MCDATA 3016||1G, 16 PORT with GBICs||DS-16M|
|MCDATA 3032||1G, 32 PORT with GBICs||DS-32M|
|MCDATA 4500-8||2G, 8 PORT with SFPs||DS-8M2|
|MCDATA 4500-16||2G, 16 PORT with SFPs||DS-16M2|
|MCDATA 4500-24||2G, 24 PORT with SFPs||DS-24M2|
symapierr – Used to translate SYMAPI error code numbers into SYMAPI error messages.
symaudit – List records from a symmetrix audit log file.
symbcv – Perform BCV support operations on Symmetrix BCV devices.
symcfg – Discover or display Symmetrix configuration information. Refresh the host’s Symmetrix database file or remove Symmetrix info from the file. Can also be used to view or release a ‘hanging’ Symmetrix exclusive lock.
symchg – Monitor changes to Symmetrix devices or to logical objects stored on Symmetrix devices.
symcli – Provides the version number and a brief description of the commands included in the Symmetrix Command Line
symdev – Perform operations on a device given the device’s Symmetrix name. Can also be used to view Symmetrix device locks.
symdg – Perform operations on a device group (dg).
symdisk – Display information about the disks within a Symmetrix.
symdrv – List DRV devices on a Symmetrix.
symevent – Monitor or inspect the history of events within a Symmetri
symgate – Perform operations on a gatekeeper device.
symhost – Display host configuration information and performance statistics.
syminq – Issues a SCSI Inquiry command on one or all devices. Interface.
symlabel – Perform label support operations on a Symmetrix device.
symld – Perform operations on a device in a device group (dg).
symlmf – Registers SYMAPI license keys.
sympd – Perform operations on a device given the device’s physical name.
symstat – Display statistics information about a Symmetrix, a Director, a device group, or a device.
symreturn – Used for supplying return codes in pre-action and post-action script files.
SYMCLI CONTROL Commands
symacl – Administer symmetrix access control information.
symauth – Administer symmetrix user authorization information.
symcg – Perform operations on an composite group (cg).
symchksum – Administer checksum checks when an Oracle database writes data files on Symmetrix devices.
symclone – Perform Clone control operations on a device group or on a device within the device group.
symconfigure – Perform modifications on the Symmetrix configuration.
symconnect – Setup or Modify Symmetrix Connection Security functionalit
symmask – Setup or Modify Symmetrix Device Masking functionality.
symmaskdb – Backup, Restore, Initialize or Show the contents of the device masking database.
symmir – Perform BCV control operations on a device group or on a device within the device group.
symoptmz – Perform Symmetrix Optimizer control operations.
symqos – Perform Quality of Service operations on Symmetrix Devices
symrdf – Perform RDF control operations on a device group or on a device within the device group.
symreplicate – Perform automated, consistent replication of data given a pre-configured SRDF/Timefinder setup.
symsnap – Perform Symmetrix Snap control operations on a device group or on devices in a device file.
symstar – Perform SRDF STAR management operations.
symrcopy – Perform Symmetrix Rcopy control operations on devices in a device file.
SYMCLI SRM(Mapping) Commands
symhostfs – Display information about a host File, Directory, or host File System.
symioctl – Send IO control commands to a specified application.
symlv – Display information about a volume in Logical Volume Group (vg).
sympart – Display partition information about a host device.
symrdb – Display information about a third-party Relational Database.
symrslv – Display detailed Logical to Physical mapping information about a logical object stored on Symmetrix devices.
symvg – Display information about a Logical Volume Group (vg).
During installation on Solaris hosts, the powercf utility configures PowerPath devices by scanning the host adapter buses for both single-ported and multiported Symmetrix volumes. (A multiported volume shows up on two or more host bus adapters with the same Symmetrix subsystem/device identity. The identity comes from the serial number for the volume.) For each Symmetrix volume found in the scan of the host adapter buses, powercf creates a corresponding emcpower device entry in the emcp.conf file, and saves a primary path and an alternate primary path to that device. The powermt config command, run at boot time by init (1M), adds additional paths to the Symmetrix volume.
After PowerPath is installed, you only need to run the powercf command when the physical configuration of the Symmetrix or the host changes. The configuration changes that require you to reconfigure PowerPath devices include:
• Adding or removing host bus adapters
• Adding, removing, or changing Symmetrix logical devices
• Changing the cabling routes between host bus adapters and Symmetrix ports
• Adding or removing Symmetrix channel directors
Scans the host adapter buses for single-ported and multiported Symmetrix volumes. Compares those volumes with the PowerPath device entries in the emcp.conf file. Prompts you to accept or reject any addition or deletion of Symmetrix devices in the emcp.conf file.
Scans the host adapter buses for single-ported and multiported Symmetrix volumes. Compares those devices with the emcpower entries in the emcp.conf file. Prints information on any inconsistencies.
Scans the host adapter buses for single-ported and multiported Symmetrix volumes. Compares those volumes with the PowerPath device entries in the emcp.conf file. Updates the emcp.conf file by removing PowerPath devices that were not found in the host adapter scan and by adding new PowerPath devices that were found. Saves a primary and an alternate primary path to each PowerPath device.
The powermt Commands
This section describes each powermt command. Refer to the preface of this document for information on the conventions used in the command syntax. You can run powermt commands from either the command line.
Displays the syntax for the commands in the powermt management utility.
Verifies that all paths are connected to the correct Symmetrix volumes.
powermt check [dev=power#|all] [adapter=adapter#|all]
The dev parameter and the adapter parameter are optional. You must, however, specify at least one in the powermt check command.
Provides PowerPath license registration information. The powermt check_registration command is available from the command line only. It does not have an equivalent SMIT command.
Configures paths to all known Symmetrix logical devices for maximum accessibility.
Displays a table that shows the state of all host adapters found by PowerPath.
powermt display dev
Displays a table that shows the state of the specified PowerPath device or all PowerPath devices.
powermt display dev=power#|all
Attempts to reopen, or restore to service, all device paths currently marked as Closed.
Saves changes to the PowerPath devices’ policy and priority attributes to the ODM so that the new values are in effect at system startup.
powermt set adapter_switch
Enables or disables the specified host adapter.
powermt set adapter_switch=disabled|enabled adapter=adapter#
Does not allow the specified host adapter to accept I/O traffic for any device path it serves.
Allows the specified host adapter to accept I/O traffic for any device path it serves.
The host adapter number shown in the ## column in the table displayed when you enter the powermt display dev command.
powermt set mode
Sets device path(s) to either active or standby mode for the specified PowerPath device or for all PowerPath devices on the specified adapter.
powermt set mode=active|standby adapter=adapter# [dev=power#|all]
The dev parameter is optional. If you do not include the dev parameter, the powermt set mode command changes the mode of all PowerPath devices on the specified adapter.
powermt set policy
Sets the load balancing policy for the specified PowerPath device or all PowerPath devices.
powermt set policy=rr|io|lb|so [dev=power#|all]
The dev parameter is optional. If you do not include the dev parameter, the powermt set policy command changes the policy of all PowerPath devices.
Rr Round-robin. Future I/O requests are assigned to each of the available paths in rotation.
Io I/O. Load balance is based on the number of pending I/Os.
Lb Least blocks. Load balance is based on the number of blocks in the pending I/Os.
powermt set priority
Sets the I/O priority for the specified PowerPath device or for all PowerPath devices.
powermt set priority= [dev=power#|all]
The dev parameter is optional. If you do not include the dev parameter, the powermt set priority command changes the priority of all PowerPath devices.
The powermt set priority command is only meaningful when the load-balancing policy is Symmetrix optimized (so). This setting allows the I/O performance of a few, individual PowerPath devices to be improved at the expense of the rest of the devices, while otherwise maintaining the best possible load balance across all paths.
Verifies that the primary path opened for each PowerPath device is connected to the correct Symmetrix volume.
Displays a table that shows the state of the host adapters for the specified PowerPath device or all PowerPath devices.
powermt watch every=#seconds
powermt watch dev
Displays a table that shows the state of the specified PowerPath device or all PowerPath devices.
powermt watch dev=power#|all every=#seconds
ECC General Commands
Command Options Notes
-f Refresh database
-k Kill existing SymmConsole processes
symcfg discover (must run first time)
Symm ser. # = SSVVVDDP
SS Symm ser. Num
V Symm dev. Num
DD Symm dir. num.
P Symm port
PdevName Issue SCSI inq command on one or all devices
symcli Cmd’s Common Options
Offline flag (obtain info from local host database)
Unique Symm ID, last 2 digits of ser num
symcli cmd’s Example
symdg -type RDF1 create DgName
symld -g DgName -sid ## add dev ###
symbcv list pd
symbcv -g DgName associate dev ###
symmir -g DgName -full establish LdevName bcv dev SymDevName
symrdf -g DgName refresh R# -force
symmir -g DgName -full restore –remote
bcv, then with link resumed the data will be copied
to all devices on the source side.
ECC paths & misc stuff
Symm Lic. Mgmt. Facility
/usr/symcli is a link to /opt/emc/SYMCLI/4.#.#/
symmappsrc.sh or .csh add to .profile or .dtprofile
/usr/emc/ECC/Symmappsrc.sh or .csh
upate if necessaru for /usr/symcli path
Symmetrix Command Line Interface (SYMCLI)
SYMCLI optional environmental variables:
can be set as the default Symmetrix ID.
can be set as the default device group name.
can be set as the default consistency group name.
can be set as the default logical volume group name.
can be set to 1 to disable logging.
can be set to 1 for offline access.
can be set to 1 to disable prompting.
can be set to 1 to enable verbose mode for SRDF and BCV control operations.
can be set to 1 to convert names that the user enters to uppercase.
can be set to the host’s Symmetrix database pathname.
can be set to 1 to cause discover to skip loading devices from any Symmetrix units when errors are encountered when loading from those units.
can be set to 1 to cause the SYMCLI to block when getting information from the Symmetrix if all GateKeeper devices are currently busy. The process will wait until a GateKeeper becomes available.
can be set to 1 to cause the SYMCLI to block when it needs to exclusively lock the symapi database file. The process will wait until the lock on the database file can be obtained. The default is to NOT wait on the lock.
can be set to either EXCLUSIVE or PARALLEL to specify how to obtain a lock on the symapi database file before starting a Symmetrix control operation. The default is to obtain an EXCLUSIVE lock.
can be set to DEFAULT, SYMDEV or PDEV to specify the naming
preference for Logical Device Names. The default is to name devices DEV001, DEV002 for standard devices and BCV001, BCV002…. for BCV devices.
can be set to specify the SYMAPI Server connection information.
can be set to specify the SYMAPI Server connection type. Valid values are: LOCAL, REMOTE, and REMOTE_CACHED. The default is LOCAL when SYMCLI_CONNECT is not set. When it is set, the default is REMOTE_CACHED When the SYMAPI full client is installed and the default is REMOTE when the SYMAPI thin client is installed.
can be set to specify compatibility mode for SYMCLI utilities output. Valid modes are limited to ‘V32’ and V40.
Specifies the BCV pair cancel policy, that SYMCLI uses when establishing A new BCV pair and the maximum number of BCV pairs has been reached. Can be set to CANCEL_OLDEST, CANCEL_NEWEST or
DON’T_CANCEL. The default is to automatically cancel the oldest BCV
By default, SYLCLI allows up to 8 BCV pairs to be incrementally paired
With a standard device. This variable can be used to set a new maximum (other than 8) in the range of 1 to 16.
Prints return code mnemonics and error strings concluding the execution of SYMCLI commands. Possible values are DEFAULT and FORMATTED. DEFAULT is equivalent to an unset SYMCLI_RETURN_MODE. FORMATTED enables the printing of return code mnemonics and error Strings
can be set as the default relational database type.
can be set as the default relational database connection information. Format: user/passwd@service.
can be set as the default relational database name.
be set as the default relational database schema name.
can be set as the default relational database table space name.
can be set as the version reported by the SYMCLI OSM SRDF Compatibility Mode.