EMC
01. Symmmetrix Device masking Command line interface
1.1 Adding HBA access to Symmetrix Devices 1.2 Removing HBA Access to Symmetrix Devices 1.3 Mapping Symmetrix devices to a director and port
02. EMC Powerpath - Multipathing Software
Powerpath CLI commands Powermt command options Powermt command examples Powermt Command Examples with outputs
Symcli commands
To list all the Symmetrix systems
# syscfg list
To list all the Logical volumes assigned to director 9b
# symcfg -dir 9b -address -available list
# symcfg -sid 0039 -sa all list # syscfg -sid 0880 -fa 16A -p1 -address -available list
Adding HBA Access to Symmetrix Devices
01. List devices mapped to the FA director that you will be configuring (for example, director 16A).
# symcfg -sid 0280 list -FA 16A -addr
02. Make an entry for the HBA-to-FA connection in the VCMDB2, specifying devices that the HBA can access. For example, add a range of devices (0030 through 0034and 0038) to the VCMDB on the Symmetrix array (sid 814), specifying the HBA's WWN and the FA director/port that the HBA connects to.
# symmask sid 814 -wwn 20000000c920b484 add devs 0030:0034,0038 -dir 16A -p 0
03. Back up the revised VCMDB to a file (for example, a file called MyDevMaskBackup).
# symmask -sid 814 backup file MyDevMaskBackup
04.Refresh the WWN-related profile tables in the Symmetrix cache with the latest VCMDB data
# symmak -sid 814 refresh
Removing HBA Access to Symmetrix Devices
To remove 0030 and 0031 devices that was added previously:
# symmask sid 814 -wwn 20000000c920b484 remove devs 0031,0033 -dir 16A -p 0
To remove the remaining devices in the 0030-to-0034 device range, you can specify individual devices or the range with an option (force) that allows you to remove a noncontiguous range. For example:
# symmask sid 814 -wwn 20000000c920b484 remove devs 0030:0034 -dir 16A -p 0 -force
To remove the entire set of devices that an HBA can access, use symmask delete and specify the WWN of the HBA. The delete action removes the HBA entry completely, including any attributes set previously. For example:
# symmask sid 814 delete -wwn 20000000c920b484
Mapping Symmetrix devices to a director and port
1a. Obtain a list of used addresses, including the next available address
# symcfg list -SA all -address -available
1b. Obtain list of used addresses, including the next available mapped to director 13B
# symcfg -sid 1188 list -dir 13b -address -available list
02. Create a mapfile (map_1) with list of LUNs to be mapped to director 13bA
map dev 02c7 to dir 13B:0 target=0 lun=0f8 ; map dev 02c8 to dir 13B:0 target=0 lun=0f9 ; map dev 02c9 to dir 13b:0 target=0 lun=0fa ;
03. run the symconfigure command
# symconfigure -sid 1188 -f map_1 commit
Other commands
To list all the LUNS accessible by HBA with WWN 10...xxxxxx
# symmaskdb -sid 0665 -wwn 10...xxxxxx list devs
To delete client HBA form VCMDB
# symmask -sid 0665 -wwn 10.....xxxxxx delete # symmask -sid 0665 refresh
To list all the HBAs logged in to DIR 4b and port 0 (4bA)
# symmask -sid 0280 -dir 4b -p1 list logins
fpath commands
# fpath adddev # fpath chgname
To refresh Volume Logic Database
# fpath refresh
To backup Volume logix database
# fpath backupdb
Powerpath
Powerpath CLI Commands
| Command | Description |
| powermt | Manages a PowerPath environment |
| powercf | Configures PowerPath devices |
| emcpreg -install | Manages PowerPath license registration |
| emcpminor | Checks for free minor numbers |
| emcpupgrade | Converts PowerPath configuration files |
| Command | Description |
| powermt check | Checks for, and optionally removes, dead paths. |
| powermt check_ registration | Checks the state of the PowerPath license. |
| powermt config | Configures logical devices as PowerPath devices. |
| powermt display
powermt watch | Displays the state of HBAs configured for PowerPath.
powermt watch is deprecated. |
| powermt display options | Displays the periodic autorestore setting. |
| powermt load | Loads a PowerPath configuration. |
| powermt remove | Removes a path from the PowerPath configuration. |
| powermt restore | Tests and restores paths. |
| powermt save | Saves a custom PowerPath configuration. |
| powermt set mode | Sets paths to active or standby mode. |
| powermt set
periodic_autorestore | Enables or disables periodic autorestore. |
| powermt set policy | Changes the load balancing and failover policy. |
| powermt set priority | Sets the I/O priority |
| powermt version | Returns the number of the PowerPath version for which powermt was created. |
powermt command examples
powermt display:
# powermt display paths class=all # powermt display ports dev=all # powermt display dev=all
powermt set:
To disable a HBA from passing I/O
# powermt set mode=standby adapter=<adapter#>
To enable a HBA from passing I/O
# powermt set mode=active adapter=<adapter#>
To set or validate the Load balancing policy
To see the current load-balancing policy and I/Os run the following command
# powermt display dev=<device>
- so = Symmetrix Optimization (default)
- co = Clariion Optimization
- li = Least I/Os (queued)
- lb = Least Blocks (queued)
- rr = Round Robin (one path after another)
- re = Request (failover only)
- nr = No Redirect (no load-balancing or failover)
To set to no load balancing
# powermt set policy=nr dev=<device>
To set the policy to default Symmetrix Optimization
# powermt set policy=so dev=<device>
To set the policy to default Clariion Optimization
# powermt set policy=co dev=<device>
pprootdev
To bring the rootvg devices under powerpath control
# pprootdev on
To bring back the rootvg disks back to hdisk control
# pprootdev off
To temporarily bring the rootvg disks to hdisk control for running "bosboot"
# pprootdev fix
powermt command examples with output
To validate the installation
# powermt check_registration
Key B3P3-HB43-CFMR-Q2A6-MX9V-O9P3
Product: PowerPath
Capabilities: Symmetrix CLARiiON
To display each device's path, state, policy and average I/O information
# powermt display dev=emcpower6a Pseudo name=emcpower6a Symmetrix ID=000184503070 Logical device ID=0021 state=alive; policy=SymmOpt; priority=0; queued-IOs=0 ---------------- Host --------------- - Stor - -- I/O Path - -- Stats --- ### HW Path I/O Paths Interf. Mode State Q-IOs Errors 0 sbus@2,0/fcaw@2,0 c4t25d225s0 FA 13bA active dead 0 1 1 sbus@6,0/fcaw@1,0 c5t26d225s0 FA 4bA active alive 0 0
To show the paths and dead paths to the storage port
# powermt display paths Symmetrix logical device count=20 ----- Host Bus Adapters --------- ------ Storage System ----- - I/O Paths - ### HW Path ID Interface Total Dead 0 sbus@2,0/fcaw@2,0 000184503070 FA 13bA 20 20 1 sbus@6,0/fcaw@1,0 000184503070 FA 4bA 20 0 CLARiiON logical device count=0 ----- Host Bus Adapters --------- ------ Storage System ----- - I/O Paths - ### HW Path ID Interface Total Dead
To display the storage ports information
# powermt display ports
Storage class = Symmetrix
----------- Storage System --------------- -- I/O Paths -- --- Stats ---
ID Interface Wt_Q Total Dead Q-IOs Errors
000184503070 FA 13bA 256 20 20 0 20
000184503070 FA 4bA 256 20 0 0 0
Storage class = CLARiiON
----------- Storage System --------------- -- I/O Paths -- --- Stats ---
ID Interface Wt_Q Total Dead Q-IOs Errors
Powerpath on HP-UX
powermt display dev=all CLARiiON ID=APM00080702201 [AEMSAQC1] Logical device ID=6006016035901E000ABE8A31B53CDD11 [LUN 12] state=alive; policy=BasicFailover; priority=0; queued-IOs=0 Owner: default=SP A, current=SP B ============================================================================== ---------------- Host --------------- - Stor - -- I/O Path - -- Stats --- ### HW Path I/O Paths Interf. Mode State Q-IOs Errors ============================================================================== 10 0/3/1/0.1.0.0.0.0.1 c10t0d1 SP A5 unlic alive 0 0 11 0/3/1/0.2.0.0.0.0.1 c11t0d1 SP B5 unlic alive 0 0 12 0/7/1/0.1.0.0.0.0.1 c12t0d1 SP A4 active alive 0 0 13 0/7/1/0.2.0.0.0.0.1 c13t0d1 SP B4 active alive 0 0 powermt set policy=co dev=all powermt display dev=all CLARiiON ID=APM00080702201 [AEMSAQC1] Logical device ID=6006016035901E000ABE8A31B53CDD11 [LUN 12] state=alive; policy=CLAROpt; priority=0; queued-IOs=0 Owner: default=SP A, current=SP B ============================================================================== ---------------- Host --------------- - Stor - -- I/O Path - -- Stats --- ### HW Path I/O Paths Interf. Mode State Q-IOs Errors ============================================================================== 10 0/3/1/0.1.0.0.0.0.1 c10t0d1 SP A5 active alive 0 0 11 0/3/1/0.2.0.0.0.0.1 c11t0d1 SP B5 active alive 0 0 12 0/7/1/0.1.0.0.0.0.1 c12t0d1 SP A4 active alive 0 0 13 0/7/1/0.2.0.0.0.0.1 c13t0d1 SP B4 active alive 0 0