Dell EMC PowerPath Family
CLI and System Messages Reference
7.x
July 2020
Rev. 4.0
Notes, cautions, and warnings
NOTE: A NOTE indicates important information that helps you make better use of your product.
CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem.
WARNING: A WARNING indicates a potential for property damage, personal injury, or death.
© 1998 - 2020 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be trademarks of their respective owners.
Revision history
The following table presents the revision history of this document:
Table 1. Revision history
Revision |
Date |
Description |
|
|
|
|
|
|
4.0 |
July 2020 |
Release of PowerPath for Windows 7.0. |
|
|
|
3.0 |
May 2020 |
Release of PowerPath/VE for VMware vSphere 7.0 and updated with |
|
|
PowerStore storage systems support details. |
|
|
|
2.0 |
January 2020 |
Release of PowerPath for Linux 7.1. |
|
|
|
1.0 |
July 2019 |
Release of PowerPath for Linux 7.0. |
|
|
|
Revision history |
3 |
|
Contents |
Revision history............................................................................................................................................................................ |
3 |
Tables.......................................................................................................................................... |
16 |
Chapter 1: PowerPath Command Line Interface Overview................................................................. |
17 |
Welcome to the PowerPath Command Line Interface Reference................................................................................ |
17 |
Installing the PowerPath CLI............................................................................................................................................... |
17 |
PowerPath CLI install directories....................................................................................................................................... |
17 |
PowerPath messages locations.......................................................................................................................................... |
18 |
PowerPath information, warning, and error messages................................................................................................... |
18 |
List of the supported commands by platform.................................................................................................................. |
18 |
Saving and loading a PowerPath configuration................................................................................................................ |
19 |
Automatic license registration on PowerPath/VE for VMware vSphere..................................................................... |
19 |
Class option specification.................................................................................................................................................... |
19 |
Specifying the wide or width option................................................................................................................................. |
20 |
Chapter 2: emcpadm commands..................................................................................................... |
22 |
emcpadm command............................................................................................................................................................ |
22 |
emcpadm check_mappings.......................................................................................................................................... |
22 |
emcpadm export_mappings......................................................................................................................................... |
23 |
emcpadm getfreepseudos............................................................................................................................................ |
23 |
emcpadm getusedpseudos........................................................................................................................................... |
24 |
emcpadm help................................................................................................................................................................ |
24 |
emcpadm import_mappings......................................................................................................................................... |
24 |
emcpadm print_mappings............................................................................................................................................ |
25 |
emcpadm renamepseudo............................................................................................................................................. |
25 |
emcpadm version........................................................................................................................................................... |
26 |
Chapter 3: emcpbfs_linux commands.............................................................................................. |
27 |
emcpbfs_linux command.................................................................................................................................................... |
27 |
emcpbfs_linux config.................................................................................................................................................... |
27 |
emcpbfs_linux remove.................................................................................................................................................. |
27 |
Chapter 4: emcpcfg script commands............................................................................................. |
28 |
emcpcfg script..................................................................................................................................................................... |
28 |
emcpcfg backup............................................................................................................................................................ |
28 |
emcpcfg cleanup........................................................................................................................................................... |
28 |
emcpcfg list cfgs........................................................................................................................................................... |
29 |
emcpcfg restore............................................................................................................................................................ |
29 |
emcpcfg set cfgs limit................................................................................................................................................... |
29 |
Chapter 5: emcphostid commands................................................................................................. |
30 |
emcphostid command........................................................................................................................................................ |
30 |
The emcphostid command on Windows hosts.......................................................................................................... |
30 |
4 Contents
Chapter 6: emcplun commands...................................................................................................... |
32 |
emcplun_linux utility............................................................................................................................................................ |
32 |
emcplun_linux help........................................................................................................................................................ |
32 |
emcplun_linux list........................................................................................................................................................... |
32 |
emcplun_linux remove.................................................................................................................................................. |
32 |
emcplun_linux scan....................................................................................................................................................... |
33 |
Chapter 7: emcpreg commands...................................................................................................... |
35 |
emcpreg utility..................................................................................................................................................................... |
35 |
The emcpreg command on UNIX and Linux.............................................................................................................. |
35 |
The emcpreg command on Windows.......................................................................................................................... |
37 |
Chapter 8: powercf commands....................................................................................................... |
39 |
powercf command.............................................................................................................................................................. |
39 |
powercf........................................................................................................................................................................... |
39 |
Chapter 9: powerkmd commands................................................................................................... |
40 |
powerkmd command.......................................................................................................................................................... |
40 |
powerkmd display.......................................................................................................................................................... |
40 |
powerkmd help.............................................................................................................................................................. |
40 |
powerkmd remove......................................................................................................................................................... |
41 |
powerkmd version.......................................................................................................................................................... |
41 |
Chapter 10: powermig commands................................................................................................... |
42 |
powermig command............................................................................................................................................................ |
42 |
powermig abort.............................................................................................................................................................. |
42 |
powermig cleanup.......................................................................................................................................................... |
43 |
powermig commit.......................................................................................................................................................... |
44 |
powermig getHandle..................................................................................................................................................... |
44 |
powermig help................................................................................................................................................................ |
45 |
powermig info................................................................................................................................................................ |
45 |
powermig options.......................................................................................................................................................... |
46 |
powermig pause............................................................................................................................................................. |
47 |
powermig query............................................................................................................................................................. |
48 |
powermig recover.......................................................................................................................................................... |
49 |
powermig resume.......................................................................................................................................................... |
50 |
powermig selectSource................................................................................................................................................ |
50 |
powermig selectTarget.................................................................................................................................................. |
51 |
powermig setup............................................................................................................................................................. |
52 |
powermig sync............................................................................................................................................................... |
54 |
powermig throttle.......................................................................................................................................................... |
54 |
powermig undoRedirect............................................................................................................................................... |
55 |
powermig version.......................................................................................................................................................... |
56 |
Chapter 11: powermt commands..................................................................................................... |
57 |
powermt command............................................................................................................................................................. |
57 |
powermt check.............................................................................................................................................................. |
57 |
powermt check_registration........................................................................................................................................ |
58 |
Contents 5
powermt config............................................................................................................................................................. |
59 |
powermt disable hba..................................................................................................................................................... |
60 |
powermt display............................................................................................................................................................. |
61 |
powermt display latency............................................................................................................................................... |
64 |
powermt display alua..................................................................................................................................................... |
65 |
powermt display array_serial........................................................................................................................................ |
66 |
powermt display bus...................................................................................................................................................... |
67 |
powermt display bus-ports san-latency..................................................................................................................... |
68 |
powermt display dead................................................................................................................................................... |
69 |
powermt display hba_mode......................................................................................................................................... |
69 |
powermt display nonvirtual........................................................................................................................................... |
70 |
powermt display options................................................................................................................................................ |
71 |
powermt display perf bus............................................................................................................................................. |
74 |
powermt display perf dev............................................................................................................................................. |
77 |
powermt display port_mode......................................................................................................................................... |
81 |
powermt display ports................................................................................................................................................... |
82 |
powermt display unmanaged....................................................................................................................................... |
84 |
powermt enable hba...................................................................................................................................................... |
84 |
powermt help................................................................................................................................................................. |
85 |
powermt load................................................................................................................................................................. |
86 |
powermt manage........................................................................................................................................................... |
86 |
powermt release............................................................................................................................................................ |
87 |
powermt remove........................................................................................................................................................... |
87 |
powermt restore............................................................................................................................................................ |
87 |
powermt save................................................................................................................................................................ |
88 |
powermt set all_paths_dead_retry_timeout............................................................................................................. |
89 |
powermt set auto_host_registration.......................................................................................................................... |
90 |
powermt set autostandby............................................................................................................................................ |
90 |
powermt set autostandby agingperiod....................................................................................................................... |
92 |
powermt set autostandby iopflimit.............................................................................................................................. |
93 |
powermt set device_perf_to_array_report............................................................................................................... |
93 |
powermt set dev_inuse_to_array_report.................................................................................................................. |
93 |
powermt set mode........................................................................................................................................................ |
94 |
powermt set path_latency_monitor........................................................................................................................... |
95 |
powermt set path_latency_threshold........................................................................................................................ |
95 |
powermt set path_retry_timeout............................................................................................................................... |
96 |
powermt set perfmon................................................................................................................................................... |
96 |
powermt set periodic_autorestore.............................................................................................................................. |
97 |
powermt set persist_path_info................................................................................................................................... |
97 |
powermt set policy........................................................................................................................................................ |
98 |
powermt set port_disable............................................................................................................................................ |
98 |
powermt set port_mode.............................................................................................................................................. |
99 |
powermt set reactive_autorestore............................................................................................................................ |
100 |
powermt set streamio_threshold............................................................................................................................... |
101 |
powermt set write_throttle......................................................................................................................................... |
101 |
powermt set write_throttle_queue........................................................................................................................... |
102 |
powermt unmanage..................................................................................................................................................... |
102 |
powermt update host_registration............................................................................................................................ |
103 |
powermt update lun_names....................................................................................................................................... |
103 |
powermt version.......................................................................................................................................................... |
104 |
6 Contents
Chapter 12: pprootdev commands................................................................................................. |
105 |
pprootdev command......................................................................................................................................................... |
105 |
pprootdev...................................................................................................................................................................... |
105 |
Chapter 13: rpowermt commands.................................................................................................. |
106 |
rpowermt command.......................................................................................................................................................... |
106 |
rpowermt check_registration..................................................................................................................................... |
106 |
rpowermt check_served............................................................................................................................................. |
107 |
rpowermt display.......................................................................................................................................................... |
108 |
rpowermt display alua.................................................................................................................................................. |
109 |
rpowermt display array serial....................................................................................................................................... |
110 |
rpowermt display bus.................................................................................................................................................... |
111 |
rpowermt display latency............................................................................................................................................. |
112 |
rpowermt display options............................................................................................................................................. |
113 |
rpowermt display paths................................................................................................................................................ |
116 |
rpowermt display perf bus........................................................................................................................................... |
117 |
rpowermt display perf bus vmname........................................................................................................................... |
119 |
rpowermt display perf dev.......................................................................................................................................... |
120 |
rpowermt display perf vmname.................................................................................................................................. |
122 |
rpowermt display port_mode..................................................................................................................................... |
124 |
rpowermt display ports................................................................................................................................................ |
125 |
rpowermt help............................................................................................................................................................... |
127 |
rpowermt register........................................................................................................................................................ |
128 |
rpowermt restore......................................................................................................................................................... |
128 |
rpowermt set autostandby......................................................................................................................................... |
129 |
rpowermt set autostandby iopflimit............................................................................................................................ |
131 |
rpowermt set autostandby agingperiod..................................................................................................................... |
131 |
rpowermt set auto_host_registration....................................................................................................................... |
132 |
rpowermt set mode..................................................................................................................................................... |
134 |
rpowermt set path_latency_monitor........................................................................................................................ |
135 |
rpowermt set path_latency_threshold..................................................................................................................... |
135 |
rpowermt set perfmon................................................................................................................................................ |
136 |
rpowermt set vm_perfmon......................................................................................................................................... |
137 |
rpowermt set periodic_autorestore........................................................................................................................... |
138 |
rpowermt set policy..................................................................................................................................................... |
138 |
rpowermt set reactive_autorestore.......................................................................................................................... |
139 |
rpowermt set streamio_threshold............................................................................................................................. |
140 |
rpowermt set device_perf_to_array_report............................................................................................................ |
141 |
rpowermt set dev_inuse_to_array_report................................................................................................................ |
141 |
rpowermt set port_mode............................................................................................................................................ |
142 |
rpowermt setup add_host.......................................................................................................................................... |
143 |
rpowermt setup list_hosts.......................................................................................................................................... |
143 |
rpowermt setup remove_host.................................................................................................................................... |
144 |
rpowermt setup update_host..................................................................................................................................... |
144 |
rpowermt setup verify_hosts..................................................................................................................................... |
145 |
rpowermt unregister.................................................................................................................................................... |
146 |
rpowermt update host_registration........................................................................................................................... |
147 |
rpowermt update lun_names...................................................................................................................................... |
147 |
Contents 7
rpowermt version......................................................................................................................................................... |
148 |
Chapter 14: PowerPath family environment variables...................................................................... |
149 |
Disable autosave of configuration.................................................................................................................................... |
149 |
Display time stamp............................................................................................................................................................. |
149 |
Display width...................................................................................................................................................................... |
150 |
Set rpowermt server to location...................................................................................................................................... |
150 |
Migration Enabler Remote SE port.................................................................................................................................. |
151 |
Migration Enabler Remote SE server............................................................................................................................... |
151 |
Disable autoregistration..................................................................................................................................................... |
152 |
Disable the lockbox............................................................................................................................................................ |
152 |
Change lockbox name and location................................................................................................................................. |
152 |
Set a non-default license path directory......................................................................................................................... |
153 |
Chapter 15: PowerPath error codes............................................................................................... |
154 |
PowerPath error messages.............................................................................................................................................. |
154 |
Chapter 16: Multipathing messages............................................................................................... |
162 |
<device_id> is alive............................................................................................................................................................ |
165 |
<device_id> is dead........................................................................................................................................................... |
165 |
/etc/powermt: Permission denied.................................................................................................................................. |
165 |
/opt/emcpower/powercf does not exist....................................................................................................................... |
166 |
/opt/emcpower/powercf: you have to be root to execute this program................................................................. |
166 |
Can't get Pirp_t!................................................................................................................................................................ |
166 |
Cannot install the new configuration files....................................................................................................................... |
166 |
Cannot mount root on <>:<>........................................................................................................................................... |
166 |
Cannot obtain lock on <filename>................................................................................................................................... |
167 |
Cannot obtain driver state................................................................................................................................................ |
167 |
Cannot open /dev/emcp, errno <number> .................................................................................................................. |
167 |
Cannot open /etc/path_to_inst. Cannot continue....................................................................................................... |
167 |
Cannot open <filename>, errno <number>.................................................................................................................... |
168 |
Cannot open configuration file <filename>..................................................................................................................... |
168 |
Cannot open dev dir for reading, errno <number>........................................................................................................ |
168 |
Cannot open string Initialization error............................................................................................................................. |
168 |
Cannot produce new files................................................................................................................................................. |
169 |
Cannot remove device <device_id>, name in use by application................................................................................ |
169 |
Cannot write to file............................................................................................................................................................ |
169 |
Cannot write to <filename> ............................................................................................................................................. |
169 |
CLARiiON device path c3t1d0s0 is currently misconfigured........................................................................................ |
169 |
Configuration database corrupted................................................................................................................................... |
170 |
Configuration files contains a dead path (device)......................................................................................................... |
170 |
Current/Active controller for volume has changed....................................................................................................... |
170 |
Device is unavailable.......................................................................................................................................................... |
170 |
Error number adding pnpath <hdisk_name> for <hdiskpower_name> to CuAt....................................................... |
170 |
Error number getting pnpath attribute for <hdiskpower_name>................................................................................. |
171 |
Error number updating CuDv attribute for <device_id>................................................................................................ |
171 |
Error retrieving minor number(s)...................................................................................................................................... |
171 |
Failed opening adapter <device_number>...................................................................................................................... |
171 |
Failover mode PNR for CLARiiON LUN <WWN#> is not recommended. Please consider PAR or ALUA ............ |
171 |
8 Contents
File deleted. Use -add to create a new file..................................................................................................................... |
172 |
File not deleted. No licenses will be available until file is deleted and re-created...................................................... |
172 |
Get adapter <devno> failed number................................................................................................................................ |
172 |
Incomplete installation detected...................................................................................................................................... |
172 |
Invalid base minor number................................................................................................................................................. |
172 |
Invalid minor number.......................................................................................................................................................... |
173 |
Key <key_number> in license file is bad. Use -edit option to repair............................................................................ |
173 |
Key <key_number> is invalid............................................................................................................................................ |
173 |
Key <key_number> was not found.................................................................................................................................. |
173 |
Key <key_number> is already present, ignored............................................................................................................. |
173 |
License file is full -- cannot add number keys................................................................................................................. |
174 |
mknod of device failed....................................................................................................................................................... |
174 |
MPxIO is enabled. Verify that no arrays are managed by both MPxIO and PowerPath.......................................... |
174 |
Not a multiple of 8.............................................................................................................................................................. |
174 |
Number of minors out of range 1-1000........................................................................................................................... |
174 |
One or more expired PowerPath license key(s) detected. These are typically used...use emcpreg utility to |
|
review your license keys................................................................................................................................................ |
175 |
PRO service, action 46 failed, 0x5/0x80/0x20............................................................................................................. |
175 |
Pseudo Device Name Major# Minor# <ERROR: unexpected internal error>............................................................ |
175 |
Read of file <file> failed..................................................................................................................................................... |
175 |
There are no keys presently registered. Some functions and capabilities may be unavailable................................ |
176 |
This version of PowerPath is NOT binary compatible with your kernel...................................................................... |
176 |
Forceload of drv/sd failed................................................................................................................................................. |
176 |
Get hdisk path data failed................................................................................................................................................. |
176 |
Internal DB read failed ...................................................................................................................................................... |
176 |
Kernel symbol versioning is not enabled in your linux kernel......................................................................................... |
177 |
Killing bus <bus> to Symmetrix <id> port <port>.......................................................................................................... |
177 |
Failed to load extension errno = <number>.................................................................................................................... |
177 |
Recognize (loop) error number on device <device_id>................................................................................................ |
177 |
Storage system <storage_system_name> PowerPath mode disabled...................................................................... |
177 |
Not all paths to <volume> are dead................................................................................................................................. |
178 |
SPx Not Responding on array : Trespassing volumes................................................................................................... |
178 |
ODM PdDv database contains duplicate uniquetypes. Refer to EMC Knowledge Base Article Number: |
|
000084491 or contact EMC Customer Support personnel..................................................................................... |
178 |
Path <path_name> to <device_id> is dead................................................................................................................... |
178 |
<storage_system> path <path_name> is dead. Do you want to remove it (y/n/a/q)?......................................... |
179 |
Path <bus> <tgt> <lun> to <device> is dead................................................................................................................. |
179 |
Open powerpath0 failed number..................................................................................................................................... |
179 |
PRO service action 6 failed, <Sense Key>/<ASC>/<ASCQ> for Bus <bus> Tgt <target> Lun <lun>.................. |
179 |
Restored volume <clariion/vnx_volume> to default: SP<clariion/vnx_ storage_processor>................................ |
179 |
Reviving bus <bus> to Symmetrix <id> port <port>..................................................................................................... |
180 |
Sleeping for memory......................................................................................................................................................... |
180 |
Syscall 8133 to <device_id> failed................................................................................................................................... |
180 |
Trespassed volume <clariion_volume> to SP<clariion_ storage_processor>........................................................... |
180 |
Unable to restore volume <volume> to default controller............................................................................................ |
180 |
Unable to restore volume <clariion_volume> to default SP.......................................................................................... |
181 |
Unable to follow volume <volume> to controller............................................................................................................ |
181 |
Encountered unexpected error 0x<code> on Dek operation command for <device id> on handle |
|
<association_handle>..................................................................................................................................................... |
181 |
Unmanage of device <device> failed............................................................................................................................... |
181 |
Contents 9
Getting unmanaged devices failed with error................................................................................................................ |
182 |
Unsupported configuration (R1/R2 setup detected).................................................................................................... |
182 |
Unsupported HBA.............................................................................................................................................................. |
182 |
Volume <clariion_volume> followed to SP<clariion_ storage_processor>................................................................ |
182 |
Volume <clariion_volume> is unbound............................................................................................................................ |
182 |
Write failed for lack of space, check for filesystem full................................................................................................ |
183 |
Cannot open PowerPath. Initialization error................................................................................................................... |
183 |
Configuration files corrupted/out of date...................................................................................................................... |
183 |
PowerPath configuration files present - exiting............................................................................................................ |
183 |
Major number is already in use......................................................................................................................................... |
184 |
PowerPath modules are not loaded. Ensure that the modules are loaded and try again......................................... |
184 |
An older EMCpower package is already installed. Please exit the installation and remove the old EMCpower |
|
package first................................................................................................................................................................... |
184 |
PowerPath pseudo bus <bus_name> cannot be configured. Uninstall and reinstall PowerPath............................ |
184 |
Unable to create kernel process...................................................................................................................................... |
184 |
Unable to open /etc/PowerPath Extensions................................................................................................................ |
185 |
Unable to start kernel process......................................................................................................................................... |
185 |
EMC registration data is missing or corrupt................................................................................................................... |
185 |
EMCP registration file does not exist. Use -add to create it....................................................................................... |
185 |
EMCP registration file is corrupt...................................................................................................................................... |
185 |
EMCP registration file is corrupt. Delete it?................................................................................................................... |
185 |
License for <storage_system_name> storage system support is missing or expired.............................................. |
186 |
There are no license keys now registered...................................................................................................................... |
186 |
There are no license keys now registered...................................................................................................................... |
186 |
License not installed.......................................................................................................................................................... |
186 |
License not installed.......................................................................................................................................................... |
186 |
Temporary upgrade key has been superseded.............................................................................................................. |
186 |
Key found in old registration file is invalid....................................................................................................................... |
187 |
Mismatch in configuration................................................................................................................................................. |
187 |
Missing configuration files................................................................................................................................................. |
187 |
All paths to vol <volume> are dead.................................................................................................................................. |
187 |
Attempted action for <storage_array> storage system support is not allowed with the current license level.... |
188 |
Attempted action is not allowed for volumes with BF or NR policy............................................................................ |
188 |
"autostandby agingperiod" must be an integer greater than or equal to 0 and less than 24855 days |
|
(596520 hours).............................................................................................................................................................. |
188 |
All paths to <device_id> are dead................................................................................................................................... |
188 |
All paths to <volume> are dead........................................................................................................................................ |
189 |
Array <array> Port <port> is Disabled............................................................................................................................. |
189 |
Array <array> Port <port> is Enabled............................................................................................................................. |
189 |
Assigned volume <clariion/vnx_volume> to SP<clariion/vnx_ storage_processor>............................................... |
189 |
<path> is in Autostandby, force option required........................................................................................................... |
189 |
Bad dev value <device>, or not under Powerpath control........................................................................................... |
190 |
Bad HBA value <hba>....................................................................................................................................................... |
190 |
Bus hba is Disabled............................................................................................................................................................ |
190 |
Bus <bus_id> to <storage_system_name> port <port_name> is alive..................................................................... |
190 |
Bus <bus_id> to <storage_system_name> port <port_name> is dead.................................................................... |
190 |
Cannot assemble drivers for root <>:<>.......................................................................................................................... |
191 |
Cannot manage. verify state of the class........................................................................................................................ |
191 |
Device cannot be managed at this time. Please verify the state of the class <class>.............................................. |
191 |
Cannot open filename........................................................................................................................................................ |
191 |
10 Contents
Cannot remove alive device <device_id>....................................................................................................................... |
192 |
Cannot unmanage. Verify state of the class <class>.................................................................................................... |
192 |
Cannot update persistent store....................................................................................................................................... |
192 |
<storage_system_class> device(s) not found.............................................................................................................. |
192 |
Complete management of class <class> failed.............................................................................................................. |
192 |
Configuration file created by newer version of powermt............................................................................................. |
193 |
Device will be configured on closing all the applications to the device or upon reboot............................................ |
193 |
Get hdiskpower CuAt failed number............................................................................................................................... |
193 |
Get hdiskpower CuDv failed number .............................................................................................................................. |
193 |
Device specified must be a native device....................................................................................................................... |
193 |
Device(s) not found........................................................................................................................................................... |
194 |
Device not found................................................................................................................................................................ |
194 |
Device(s) not found........................................................................................................................................................... |
194 |
disable/enable is not allowed on this hba type............................................................................................................... |
194 |
Error occurred loading saved driver state from file /etc/powermt_custom.xml Loading continues..................... |
194 |
Error occurred loading saved driver state from file <filename>. Loading continues................................................. |
195 |
Error reading configuration file / custom file IO failure................................................................................................. |
195 |
Failed to update CLARiiON user assignable LUN names.............................................................................................. |
195 |
Length of the filename exceeds the maximum limit of: <number> characters......................................................... |
195 |
Invalid option: dev=all is required for this version.......................................................................................................... |
196 |
"autostandby iopflimit" must be a number greater than 1 and less than or equal to 100000000........................... |
196 |
Path Bus <bus> Tgt <tgt> Lun <lun> to <storage_system> is set to asb:iopf ........................................................ |
196 |
powermt load failed............................................................................................................................................................ |
197 |
Manage of device <device> failed................................................................................................................................... |
197 |
Manage of device <device> failed................................................................................................................................... |
197 |
Please run powermt save to persist PowerPath settings in custom file.................................................................... |
197 |
Performance measurement is not enabled & their powermt display perf command exits...................................... |
197 |
Performance monitoring already enabled....................................................................................................................... |
198 |
Policy is not a valid policy for <storage_system_class> storage systems................................................................. |
198 |
bosboot: missing proto file: /usr/lib/boot/network/chrp.hdiskpower.proto............................................................ |
198 |
The current boot logical volume, <device>, does not exist on <device>................................................................... |
198 |
powermt save failed.......................................................................................................................................................... |
199 |
SCSI error on device <device>........................................................................................................................................ |
199 |
Latency Threshold exceeded by UserDev...with a new high latency of <latency_value> msec............................. |
199 |
Unable to unconfigure path Bus X Tgt Y Lun Z as firstpath policy is set................................................................... |
199 |
Unmanage of device <device> failed............................................................................................................................. |
200 |
Renaming of temporary file to file:<filename> failed.................................................................................................... |
200 |
PowerPath cannot disable some of its devices because...two host reboots are required to uninstall |
|
PowerPath..................................................................................................................................................................... |
200 |
An unidentified program wants to access your computer. Don't run the program unless you know where it's |
|
from or you've used it before...................................................................................................................................... |
200 |
Chapter 17: Migration Enabler messages........................................................................................ |
201 |
Already recovered............................................................................................................................................................. |
202 |
Already in the state requested........................................................................................................................................ |
202 |
Couldn't read disk label..................................................................................................................................................... |
202 |
Couldn't write disk label, be sure target is at least as large as source....................................................................... |
202 |
Current node cannot be excluded ................................................................................................................................. |
203 |
Daemon communication error......................................................................................................................................... |
203 |
Daemon failed to create thread....................................................................................................................................... |
203 |
Contents 11
Daemon semaphore error................................................................................................................................................. |
203 |
Daemon socket connection failed................................................................................................................................... |
203 |
Device is inaccessible........................................................................................................................................................ |
204 |
Devices already involved in a migration.......................................................................................................................... |
204 |
An error occurred while using the base daemon, please see the log file................................................................... |
204 |
An internal error occurred during a SYMAPI operation. Please report to EMC........................................................ |
204 |
Failed to fix disk label of the target device.................................................................................................................... |
204 |
Failed to get disk layout of device................................................................................................................................... |
205 |
Failed to get target size................................................................................................................................................... |
205 |
Failed to load EFI support library..................................................................................................................................... |
205 |
Failed to set disk layout of device................................................................................................................................... |
205 |
Failed to validate geometry of target device................................................................................................................. |
206 |
Failed to transfer the source reservation....................................................................................................................... |
206 |
The feature being requested is not currently licensed................................................................................................. |
206 |
A function call exceeded allocated time......................................................................................................................... |
206 |
The gatekeeper device (while using the Base Daemon) has an error (Please see the log file).............................. |
207 |
Handle not found............................................................................................................................................................... |
207 |
Host can still access source device................................................................................................................................ |
207 |
Migration stopped due to IO error - will attempt to restart........................................................................................ |
207 |
Needs recovery................................................................................................................................................................. |
207 |
No migration is in the proper state to perform the requested operation.................................................................. |
208 |
Node <nodename> not found......................................................................................................................................... |
208 |
PPME Resource <Cluster Disk Name> created with powermigcl.............................................................................. |
208 |
PR Keys found on Target disk during Setup.................................................................................................................. |
208 |
Not in proper state to perform this operation............................................................................................................... |
208 |
Possible alternate cylinder overlap detected using native source geometry............................................................ |
209 |
PPME cannot be used with a temporary license.......................................................................................................... |
209 |
Remote SE environment variable(s) not allowed in setup........................................................................................... |
209 |
Source must be a cluster shared volume....................................................................................................................... |
209 |
Source is a CSV (use '-cluster mscsv' to setup a cluster migration)......................................................................... |
209 |
Source disk's dependent PPME resource was changed.............................................................................................. |
210 |
Source device is in use (-force will override)................................................................................................................. |
210 |
Source faulted, must abort migration.............................................................................................................................. |
210 |
Source faulted, must commit migration.......................................................................................................................... |
210 |
Source and target must be from same array................................................................................................................. |
210 |
Source and target are the same device........................................................................................................................... |
211 |
Target faulted, must abort migration............................................................................................................................... |
211 |
Target device is in use........................................................................................................................................................ |
211 |
Target must be at least as large as the source............................................................................................................... |
211 |
Target max_transfer attribute is too small...................................................................................................................... |
211 |
Target is not accessible...................................................................................................................................................... |
211 |
Target device is not attached to some nodes................................................................................................................ |
212 |
Target must be a pseudo.................................................................................................................................................. |
212 |
UMD database not initialized............................................................................................................................................ |
212 |
Unable to scrub the abandoned device........................................................................................................................... |
212 |
Unable to scrub the abandoned device. Device is offline............................................................................................. |
212 |
Unknown device................................................................................................................................................................. |
213 |
Chapter 18: PowerPath/VE messages............................................................................................ |
214 |
Allocation of dummy <ASyncIoDaemon/ TestDaemon/ SyncIoDaemon> entry failed. Not aborting it................. |
215 |
12 Contents
Bad dev value <invalid_value>, or not under PowerPath control............................................................................... |
216 |
Bad dev value emcpower <invalid value>, or not under PowerPath control............................................................. |
216 |
Bad hba value <invalid_value>, or not under PowerPath control............................................................................... |
216 |
Cannot communicate with host, version mismatch too great..................................................................................... |
216 |
Cannot communicate with host, version mismatch too great..................................................................................... |
217 |
Could not allocate SCSI device........................................................................................................................................ |
217 |
Could not claim the path. Status: <status>.................................................................................................................... |
217 |
Could not create vol Daemon........................................................................................................................................... |
217 |
Could not initialize log name: <status>............................................................................................................................ |
217 |
Device <device_bus_path> is currently dead................................................................................................................ |
217 |
Device(s) not found........................................................................................................................................................... |
218 |
<array_type> device(s) not found.................................................................................................................................. |
218 |
<class> device(s) not found............................................................................................................................................. |
218 |
Device(s) not found .......................................................................................................................................................... |
218 |
Enqueued from <ASyncIoDaemon/ TestDaemon/ SyncIoDaemon> to Abort queue Cmd <command>.............. |
218 |
Failed to Create Pirp.......................................................................................................................................................... |
219 |
Failed to create Pirp ......................................................................................................................................................... |
219 |
Failed to create Platform scsicmd .................................................................................................................................. |
219 |
Failed to create scsi Pirp .................................................................................................................................................. |
219 |
Failed to find IP address for <unresolved hostname>................................................................................................... |
219 |
Failed to open host file...................................................................................................................................................... |
219 |
Failed to remove host information from host file.......................................................................................................... |
220 |
Failed to reset the license server count......................................................................................................................... |
220 |
Failed to retrieve host information from host file......................................................................................................... |
220 |
Failed to retrieve host list from host file........................................................................................................................ |
220 |
Failed to store host information into host file................................................................................................................ |
220 |
Failed to store host list into host file................................................................................................................................ |
221 |
Failed to alloc Pirp.............................................................................................................................................................. |
221 |
Failed to create Char device name. Status: <status>................................................................................................... |
221 |
Global PMI disabled............................................................................................................................................................ |
221 |
Host not found................................................................................................................................................................... |
221 |
Inquiry failed. Status: <status>........................................................................................................................................ |
222 |
Invalid option '-d' when upgrading from a previous version of installer..................................................................... |
222 |
Invalid passphrase during host file creation................................................................................................................... |
222 |
License autoregistration is disabled................................................................................................................................ |
222 |
License checkout failed.................................................................................................................................................... |
223 |
License data does not match host data......................................................................................................................... |
223 |
License feature or attribute not found........................................................................................................................... |
223 |
License file does not exist or not found......................................................................................................................... |
223 |
License file format error or misspelling........................................................................................................................... |
223 |
License file is invalid (inconsistent) ................................................................................................................................ |
223 |
License key or feature not found.................................................................................................................................... |
224 |
License not installed.......................................................................................................................................................... |
224 |
License not installed.......................................................................................................................................................... |
224 |
License type mismatch. Hyper-V enabled: PowerPath/VE for Windows license key not found........................... |
224 |
Mpx: pData <data> size <size>....................................................................................................................................... |
224 |
MpxRecognize failed. No resourcescheck system maximum path limits................................................................ |
225 |
MpxRecognize failed......................................................................................................................................................... |
225 |
No valid licenses found..................................................................................................................................................... |
225 |
No active path to the device found................................................................................................................................ |
225 |
Contents 13
No PMI data available for this VM.................................................................................................................................. |
225 |
No standard UID. Using the WWN as volume UID....................................................................................................... |
225 |
Not a valid sense buffer .................................................................................................................................................. |
226 |
The path has already been claimed ................................................................................................................................ |
226 |
Path is in Autostandby, force option required............................................................................................................... |
226 |
Path <path> could not be disabled. It is the last working path to volume................................................................. |
226 |
The Path has not been claimed....................................................................................................................................... |
226 |
Performance Monitor is not enabled.............................................................................................................................. |
227 |
Persistence of SCSI Res fail Value is 0, generating new one...................................................................................... |
227 |
PowerPath driver is already registered........................................................................................................................... |
227 |
PowerPath driver is already unlicensed.......................................................................................................................... |
227 |
PowerPath Not Found...................................................................................................................................................... |
227 |
Probe of <path> path failed. Status <status>............................................................................................................... |
227 |
ProbePath Failed path ..................................................................................................................................................... |
228 |
Path <path>: could not issue sync/async IO command: <status>............................................................................. |
228 |
SCSI-2 reservation/release failed with SCSI status <status>.................................................................................... |
228 |
SCSI-2 Translation command failed after the maximum number of retries.............................................................. |
228 |
Sense Info S: <sc> ASC: <asc> ASCQ: <ascq>............................................................................................................ |
228 |
Status <status>. Failed to register device. User should unclaim paths. ................................................................... |
229 |
Unable to send cmd (cleanup PRI) to device. SCSI status <status>......................................................................... |
229 |
Unable to send cmd (cleanup PRO) to device. SCSI status <status>....................................................................... |
229 |
Could not unregister the device...................................................................................................................................... |
229 |
User Authentication Invalid.............................................................................................................................................. |
229 |
VM either does not exist or is not registered on this host........................................................................................... |
230 |
vmk_LogRegister failed: <status>.................................................................................................................................. |
230 |
Volume is being destroyed. Cannot open....................................................................................................................... |
230 |
Volume not found ............................................................................................................................................................. |
230 |
Volume to be opened not found ..................................................................................................................................... |
230 |
The volume is open. Cannot unclaim last path <path>................................................................................................ |
230 |
The volume is being registered or unregistered. Cannot unclaim last path <path>.................................................. |
231 |
Wait for n IosPending count (count) to become 0........................................................................................................ |
231 |
Wait for volume to be unquiesced .................................................................................................................................. |
231 |
Chapter 19: PowerPath Management Appliance messages.............................................................. |
232 |
Although served license added, there was an error contacting License Server. Check License Server status... |
232 |
License already present.................................................................................................................................................... |
232 |
License key not valid for the domain / IP address of this Virtual Appliance.............................................................. |
232 |
Unable to add new license. Reason: License is invalid or expired............................................................................... |
233 |
Appendix A: PowerPath family new and changed commands........................................................... |
234 |
powermig new and changed commands........................................................................................................................ |
234 |
powermt new and changed commands......................................................................................................................... |
234 |
rpowermt new and changed commands........................................................................................................................ |
235 |
Appendix B: List of the PowerPath load balancing and failover policies............................................ |
237 |
List of the PowerPath load balancing and failover policies.......................................................................................... |
237 |
Appendix C: List of fields used in the powermt and rpowermt display command output.................... |
239 |
List of all fields used in the display output...................................................................................................................... |
239 |
14 Contents
Appendix D: Microsoft Windows IDs.............................................................................................. |
243 |
Microsoft Windows application event IDs...................................................................................................................... |
243 |
Microsoft Windows system event IDs............................................................................................................................ |
247 |
Appendix E: AIX error logging facility messages............................................................................. |
249 |
AIX error logging facility messages................................................................................................................................. |
249 |
Index.......................................................................................................................................... |
251 |
Contents 15
1 |
Revision history............................................................................................................................................................ |
3 |
2 |
CLI install directories................................................................................................................................................... |
17 |
3 |
PowerPath messages locations................................................................................................................................ |
18 |
4 |
PowerPath information, warning, and error messages locations......................................................................... |
18 |
5 |
Supported commands................................................................................................................................................ |
18 |
6 |
Custom file install directory....................................................................................................................................... |
19 |
7 |
Valid values for class option..................................................................................................................................... |
20 |
8 |
Output fields............................................................................................................................................................... |
48 |
9 |
Attributes and description......................................................................................................................................... |
76 |
10 |
Attributes and description........................................................................................................................................ |
80 |
11 |
PowerPath error messages..................................................................................................................................... |
154 |
12 |
New and changed commands in 6.0 and later..................................................................................................... |
234 |
13 |
New and changed commands in 6.0 and later..................................................................................................... |
234 |
14 |
New and changed commands in 6.0 and later..................................................................................................... |
235 |
15 |
Application event IDs............................................................................................................................................... |
243 |
16 |
System event IDs..................................................................................................................................................... |
247 |
17 |
Logging facility messages....................................................................................................................................... |
249 |
16 Tables
1
This chapter contains the following topics:
Topics:
•Welcome to the PowerPath Command Line Interface Reference
•Installing the PowerPath CLI
•PowerPath CLI install directories
•PowerPath messages locations
•PowerPath information, warning, and error messages
•List of the supported commands by platform
•Saving and loading a PowerPath configuration
•Automatic license registration on PowerPath/VE for VMware vSphere
•Class option specification
•Specifying the wide or width option
The PowerPath Command Line Interface (CLI) allows data center personnel to use PowerPath to manage storage resources.
On PowerPath for AIX, HP-UX, Linux, Solaris, and Windows the PowerPath CLI is installed, along with all of the necessary support files, on each PowerPath machine when PowerPath is installed.
On PowerPath/VE for VMware vSphere, you need to install the PowerPath remote multipathing rpowermt (RTOOLS) CLI package or the PowerPath Management Appliance. The PowerPath/VE for VMware vSphere Installation and Administration Guide provides more information.
In a default PowerPath installation, the command utilities reside in the following directories:
Table 2. CLI install directories
Platform |
Directory |
|
|
|
|
AIX |
/usr/sbin (all commands) |
Linux |
/sbin (all commands); /etc/opt/emcpower/ |
Solaris |
/etc (emcpreg, powermt); /etc/emc/bin (emcpcfg, |
|
powermig); /opt/EMCpower/bin (emcpadm) |
VMware |
/opt/emc/powerpath/bin (on Linux) or install_dir |
|
\PowerPath (on Windows) |
Windows |
install_dir\PowerPath (all commands) |
PowerPath Command Line Interface Overview |
17 |
In a default PowerPath installation, the audit, informational, warning, and error messages are logged in the following locations:
Table 3. PowerPath messages locations
Platform |
Directory |
|
|
|
|
AIX |
Output of the errpt -a command (See Appendix |
|
E) /var/log/syslog, if enabled. |
HP-UX |
/var/adm/syslog |
Linux |
/var/log/messages |
Solaris |
/var/adm/messages |
VMware |
/var/log/vmkernel.log |
Windows |
Application and System Event Logs |
|
|
On Linux, PowerPath messages are logged to the following two files:
Table 4. PowerPath information, warning, and error messages locations
Messages |
Location |
|
|
|
|
install/uninstall/upgrade messages |
|
All other messages |
Standard operating system log file - /var/log/messages |
Displays the list of the PowerPath commands by platform.
Table 5. Supported commands
Command |
AIX |
Linux |
Solaris |
VMware |
Windows |
|
|
|
|
|
|
|
|
|
|
|
|
emcpadm |
Yes |
Yes |
Yes |
No |
No |
|
|
|
|
|
|
emcpbfs_linux |
No |
Yes |
No |
No |
No |
|
|
|
|
|
|
emcpcfg |
No |
No |
Yes |
No |
No |
|
|
|
|
|
|
emcphostid |
No |
No |
No |
No |
Yes |
|
|
|
|
|
|
emcplun |
No |
Yes |
No |
No |
No |
|
|
|
|
|
|
emcpreg |
Yes |
Yes |
Yes |
No |
Yes |
|
|
|
|
|
|
powercf |
No |
No |
Yes |
No |
No |
|
|
|
|
|
|
powerkmd |
No |
No |
No |
No |
Yes |
|
|
|
|
|
|
powermig |
Yes |
Yes |
Yes |
No |
Yes |
|
|
|
|
|
|
powermt |
Yes |
Yes |
Yes |
No |
Yes |
|
|
|
|
|
|
pprootdev |
Yes |
No |
No |
No |
No |
|
|
|
|
|
|
rpowermt |
No |
No |
No |
Yes |
No |
|
|
|
|
|
|
18 PowerPath Command Line Interface Overview
You can save the PowerPath configuration details such as the PowerPath device policies and priorities, write throttle setting and write throttle queue depth, periodic autorestore setting, and path modes to a configuration file to persist your configuration details across reboot.
At boot time, PowerPath loads configuration data from the XML formatted file having the default name powermt_custom.xml. Both the powermt load command and the powermt save commands use this configuration file.
On HP-UX, Linux, |
The configuration is saved using the powermt save command and when the host is booted. |
and Solaris |
|
On AIX and |
The configuration is saved only when powermt save is run manually. |
Windows |
|
In a default PowerPath installation, the powermt custom file resides in the following directory.
Table 6. Custom file install directory
Platform |
Directory |
|
|
|
|
AIX, HP-UX, Linux, Solaris |
/etc |
VMware |
N/A |
|
|
Windows |
install-dir\PowerPath |
PowerPath/VE supports the automatic license registration, or autoregistration, feature on served and unserved licenses. Any rpowermt command licenses the vSphere host with a valid PowerPath/VE for VMware vSphere license on the rpowermt server.
Commands excluded from the automatic license registration functionality are:
•rpowermt check_registration
•rpowermt register
•rpowermt setup
•rpowermt unregister
•rpowermt version
On the vSphere host, the PowerPath driver is functional from initial PowerPath/VE installation. There is no concept of unlicensed functionality on the vSphere host with respect to multipathing.
The rpowermt CLI determines the license state on each rpowermt command and if the state is unlicensed, the rpowermt CLI automatically attempts to license.
Successful automatic license registration
# rpowermt display dev=all host=<hostname>
Remote host is not licensed. Attempted to automatically register. PowerPath license is registered using automatic registration. Pseudo name=emcpower6
Symmetrix ID=000192601669 Logical device ID=24BE
Standard UID=naa.60000970000192601669533032344245 state=alive; policy=SymmOpt; queued-IOs=0
Displays the list of supported classes by platform.
Several PowerPath commands have a class option that specifies a storage system type. The following table lists the valid values for the class option added in versions 6.0 and later, with the earliest supported version listed by platform. Support in later versions (including
PowerPath Command Line Interface Overview |
19 |
service packs) can be assumed if no exception in the table notes otherwise. For the list of storage systems that PowerPath currently supports, see the E-Lab Interoperability Navigator.
Table 7. Valid values for class option
Command |
Storage arrays |
AIX |
Linux |
Solaris |
VMware |
Windows |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
all |
All storage arrays |
4.x |
4.x |
4.x |
5.4 |
4.x |
|
|
|
|
|
|
|
clariion |
CLARiiON, VNXe2 (VNXe 3200 and later), |
4.x |
4.x |
4.x |
5.4 |
4.x |
|
Unity arrays |
|
|
|
|
|
|
|
|
|
|
|
|
ess |
IBM arrays |
4.x |
4.x |
4.x |
5.4 |
4.x |
|
|
|
|
|
|
|
generic |
Celerra, VNXe (prior to VNXe 3200) arrays |
5.7 |
5.5 |
5.5 |
5.7 |
5.5 |
|
|
|
|
|
|
|
|
Data Domain |
N/A |
6.1 |
N/A |
6.1 |
N/A |
|
|
|
|
|
|
|
hitachi |
HDS arrays |
4.x |
4.x |
4.x |
5.4 |
4.x |
|
|
|
|
|
|
|
hpxp |
HP arrays |
4.x |
4.x |
4.x |
5.4 |
4.x |
|
|
|
|
|
|
|
invista |
Invista arrays |
4.x |
4.x |
4.x |
5.4 |
4.x |
|
|
|
|
|
|
|
netapp |
NetApp arrays |
5.7 |
5.7 SP3 |
6.0 |
5.9 |
5.7 SP2 |
|
|
|
|
|
|
|
sc |
Dell Compellent arrays |
6.2 |
6.2 |
N/A |
6.2 |
6.1 |
|
|
|
|
|
|
|
symm |
Symmetrix arrays |
4.x |
4.x |
4.x |
5.4 |
4.x |
|
|
|
|
|
|
|
unity |
Unity arrays |
6.1 |
6.1 |
N/A |
6.1 |
6.1 |
|
|
|
|
|
|
|
vnx |
VNX arrays |
5.7 |
5.7 |
5.5 |
5.8 |
5.7 |
|
|
|
|
|
|
|
vplex |
VPLEX arrays |
5.7 |
5.7 |
5.5 |
5.8 |
5.7 |
|
|
|
|
|
|
|
xtremio |
XtremIO arrays |
5.7 SP1 |
5.7 SP3 |
5.5 P03 |
5.9 SP1 |
5.7 SP2 |
|
|
|
|
|
|
|
4.x means that this class was a valid value in PowerPath prior to version 5.0. N/A (not applicable) means that class is not supported for that platform.
You can change the width of the output by specifying the wide or width option. The wide option is not supported on Windows platforms.
The following two examples show how setting the width option changes the output display. The first example uses the default column width (85) while the second example shows the width set to 100.
# powermt display dev=a width=85 Pseudo name=emcpowerz
Symmetrix ID=000192601710 Logical device ID=0806
Device WWN=60000970000192601710533030383036 state=alive; policy=SymmOpt; queued-IOs=0
=====================================================================
----------- Host ----------- |
- Stor - |
-- I/O Path -- |
-- Stats --- |
||
### HW Path |
I/O Paths |
Interf. |
Mode |
State |
Q-IOs Errors |
===================================================================== |
5 |
qla2xxx |
sdat |
FA |
7g:01 active |
alive |
0 |
0 |
|
1 |
qla2xxx |
sdaj |
FA |
7g:01 active |
alive |
0 |
0 |
|
5 |
qla2xxx |
sdy |
FA |
9g:01 |
active |
alive |
0 |
0 |
1 |
qla2xxx |
sdn |
FA |
9g:01 |
active |
alive |
0 |
0 |
# powermt display dev=0 width=100 Pseudo name=emcpower0a
CLARiiON ID=WRE00021400504
Logical device ID=600601760B09000054F4356E2B17D711 state=alive; policy=BasicFailover; priority=0; queued-IOs=0 Owner: default=SP B, current=SP B
==============================================================================
------------------- Host --------------- - Stor - -- I/O Path -- -- Stats --
20 PowerPath Command Line Interface Overview
### HW Path I/O Paths Interf. Mode State Q-IOs Errors
==============================================================================
2308 |
pci@4,4000/lpfc@4 |
c2t0d3s0 |
SP A1 |
unlic |
alive |
0 |
0 |
|
2308 |
pci@4,4000/lpfc@4 |
c2t1d3s0 |
SP |
A0 |
unlic |
alive |
0 |
0 |
2305 |
pci@4,2000/fibre-channel@1 c3t0d3s0 |
SP |
B1 |
active |
alive |
0 |
0 |
PowerPath Command Line Interface Overview |
21 |
2
This chapter contains the following topics:
Topics:
•emcpadm command
The emcpadm command lists available PowerPath pseudo device names and used PowerPath pseudo device names or renames a PowerPath pseudo device from a used pseudo device name to an available pseudo device name.
This command is supported on AIX, Linux, and Solaris and requires root privileges. The emcpadm command cannot rename pseudo devices that are in use. For example, devices that are part of a VxVM disk group are considered in use, and therefore cannot be renamed.
NOTE: Using the rendev command to rename a pseudo device fails. To rename a pseudo device, use only the emcpadm renamepseudo command.
The enhanced emcpadm with XML-formatted mapping data supports importing and exporting of Symmetrix, VNX, and CLARiiON device arrays as well as that of third-party arrays. The importing and exporting of mapping data in non-XML format is limited to the arrays supported by PowerPath.
Displays a comparison of the current mappings and the device remappings in mappings_file.
Syntax
emcpadm check_mappings [-v] [-x] -f <pseudo device/LU mappings file>
Description
Use this command to preview device remappings before importing a mappings file: where -x directs emcpadm to read from or write to the PowerPath pseudo device name to LU mappings in XML format to the file named by the -f option. This command functions similarly to the import_mappings command but only checks which currently mapped devices will be affected by an import of data contained a given mappings file.
Options
-v
Specifies verbose mode.
-x
Specifies XML format for the mappings file data. You must use the XML format to manually edit the mappings file. The XML data is compatible with that viewed via tools such as PowerPath powermt and Symmetrix syminq.
-f pseudo device/LU mappings file
Specifies the file name and location for the mappings file.
Check mappings
# ./emcpadm check_mappings -x -f map1.xml
Imported Device Remapping Status Mapping
---------------- ---------------------
22 emcpadm commands
hdiskpower72 no change hdiskpower73 remaps: hdiskpower83 hdiskpower74 no change hdiskpower75 no change hdiskpower76 remaps: hdiskpower104
hdiskpower76 (* Device name already in use)
For devices which have been unmanaged or removed from PowerPath control, emcpadm will print the Device not found error message:
Imported Device |
Remapping Status |
Mapping |
--------------------- |
---------------- |
|
hdiskpower63 |
no change |
hdiskpower64 |
no change |
hdiskpower65 |
Error: Device not found |
Writes and exports the current mappings to the named file.
Syntax
emcpadm export_mappings [-x] -f <pseudo device/LU mappings file>
Description
Using a mapping file that is not updated with new device IDs would show error messages about mapping failures. Therefore, export and import the mapping file only after the migration is complete.
Options
-x
Specifies XML format for the mappings file data. You must use the XML format to manually edit the mappings file. The XML data is compatible with that viewed via tools such as PowerPath powermt and Symmetrix syminq.
-f pseudo device/LU mappings file
Specifies the file name and location for the mappings file.
Retrieves a list of available PowerPath pseudo devices.
Syntax
emcpadm getfree[pseudos] [-f {i|d|m}] [-n <# of pseudo instances>] [-b <start pseudo device>]
Description
For each device, lists the pseudo device name, instance number, major device number, and minor device number. By default, retrieves the first free pseudo device name. If both -n # of pseudo instances and -b start pseudo device are specified, retrieves information for up to the indicated number of free pseudo devices, starting at the indicated device.
Options
-f {i|d|m}
This command is supported only on Solaris. If you do not include the -f option, the emcpadm command treats a numeric entry (for example, 2) as an instance number. The command recognizes an emcpowerN name without the -f option.
• -f i indicates an instance number, for example, 1.
emcpadm commands |
23 |
•-f d indicates a pseudo device name, for example, emcpower1.
•-f m indicates a minor number, for example, 8.
-n # of pseudo instances
Retrieves information for the indicated number of free pseudo devices, starting with the first free device. -b start pseudo device
Retrieves information for the first available pseudo devices, starting from the indicated device.
Lists the pseudo device name, instance number, major device number, and minor device number for each used device.
Syntax
emcpadm getused[pseudos]
Options
None.
Displays usage summary for the emcpadm command.
Syntax
emcpadm help
Options
None.
Replaces the current mappings with the mappings in mappings file.
Syntax
emcpadm import_mappings [-v] [-x] -f <pseudo device/LU mappings file>
Description
If differences exist among the current mappings and the file mappings, the mappings in mappings file take precedence. When you import the file mappings, current host devices are remapped according to the file mappings, where differences exist.
NOTE: If the pseudo device was renamed earlier with the rendev command, the emcpadm import_mappings command fails to import the mapping file.
Before importing new mappings on a node or server:
•Preview changes with emcpadm check_mappings.
•Shut down all applications and database systems.
•Unmount file systems.
•Deport VxVM disk groups.
Options
-v
Specifies verbose mode.
-x
24 emcpadm commands
Specifies XML format for the mappings file data. You must use the XML format to manually edit the mappings file. The XML data is compatible with that viewed via tools such as PowerPath powermt and Symmetrix syminq.
-f pseudo device/LU mappings file
Specifies the file name and location for the mappings file.
Displays the current mappings.
Syntax
emcpadm print_mappings [-p][-x]|-f <pseudo device/LU mappings file>]
Description
Print mappings displays the mappings in the following ways:
•print_mappings (without options) displays the current mappings on the node or server.
•print_mappings -f pseudo device/LU mappings file displays the exported mappings in pseudo device/LU mappings file.
•print_mappings -p pseudo device/LU mappings file displays the persistent mappings maintained in the PowerPath device-mapping database. These mappings should be the same as the mappings on the current node or server.
Options
-p
Displays the persistent device mappings in the PowerPath database. You can edit an exported XML-formatted mappings file to establish custom mappings. However, care must be taken to ensure that the LUN XML nodes of the file contain pseudo_dev, product_id and logical_devid elements. In the case of Symmetrix LUs, a frame_id element is also required. The imported mappings file must also be constructed using valid XML syntax.
-x
Specifies XML format for the mappings file data. You must use the XML format to manually edit the mappings file. The XML data is compatible with that viewed via tools such as PowerPath powermt and Symmetrix syminq.
-f pseudo device/LU mappings file
Specifies the file name and location for the mappings file.
Print mappings
Device: emcpower1a
Device Id:
Array LU identifier:
4942 |
4d20 |
2020 2020 3231 3035 2020 2020 |
2020 |
2020 |
2020 2020 3745 3131 3537 3438 |
(Output truncated)
Where Array LU identifier matches the device ID displayed in the powermt display dev=device output.
Changes the name of the pseudo device from the pseudo device name specified by source to the pseudo device name specified by target.
Syntax
emcpadm rename[pseudo] [-f {i|d|m}] -s <src pseudo device> -t <tgt pseudo device>
Description
The target pseudo device name must be available (that is, not in use).
emcpadm commands |
25 |
Options
-f {i|d|m}
This command is supported only on Solaris. If you do not include the -f option, the emcpadm command treats a numeric entry (for example, 2) as an instance number. The command recognizes an emcpowerN name without the -f option.
•-f i indicates an instance number, for example, 1.
•-f d indicates a pseudo device name, for example, emcpower1.
•-f m indicates a minor number, for example, 8.
-s src pseudo instance -t tgt pseudo instance
Changes the name of the pseudo device from the pseudo device name specified by -s (source) to the pseudo device name specified by -t (target). The target pseudo device name must be available (that is, not in use)
You can specify for the device name either the instance number (for example, 12) or the complete pseudo device name (for example, emcpower12).
Displays the version of the emcpadm command and the PowerPath base driver.
Syntax
emcpadm version
Options
None.
26 emcpadm commands
3
This chapter contains the following topics:
Topics:
•emcpbfs_linux command
The emcpbfs_linux utility is used to configure, remove, or upgrade PowerPath in Boot from SAN setup.
This command in supported only on Linux.
Configures PowerPath in Boot from SAN setup.
Syntax
emcpbfs_linux config
Options
None.
Uninstalls PowerPath in Boot from SAN setup.
Syntax
emcpbfs_linux remove
Options
None.
emcpbfs_linux commands |
27 |
4
This chapter contains the following topics:
Topics:
•emcpcfg script
The emcpcfg script saves and restores a PowerPath configuration if any of the configuration files have been corrupted or removed. The emcpcfg script is supported only on Solaris.
The files that represent the current configuration are:
•/kernel/drv/emcp.conf
•powermt_custom.xml
•/etc/powermt.custom
•/etc/emcp_devicesDB.dat
•/etc/emcp_devicesDB.idx
Saves the current configuration files for PowerPath as TAR files in the /etc/emc/cfgs directory.
Syntax
emcpcfg backup
Description
The powermt save command is automatically run after emcpcfg backup is run.
Options
None.
Removes or deletes all of the backed up configuration files (which were backed up only using the PowerPath emcpcfg script).
Syntax
emcpcfg cleanup
Options
None.
28 emcpcfg script commands
Lists the available saved configurations.
Syntax
emcpcfg list_cfgs
Options
None.
Restores the specified last good configuration that was saved.
Syntax
emcpcfg restore [-reboot] <saved_PowerPath_configuration>
Description
After running emcpcfg restore, reboot the host to return to the last saved configuration.
Options
-reboot
Performs an automatic reboot. Otherwise, a manual reboot is required. saved_PowerPath_configuration
Last saved configuration file.
Sets the limits on number of configurations that can be backed up.
Syntax
emcpcfg set_cfgs_limit <number>
Description
For example, if the new limit is set to three configurations, as opposed to a previous limit of five configurations, then the two older configurations are removed to maintain only three backups. You do not need to delete the configurations manually.
Options
number
Number of configurations that can be backed up.
emcpcfg script commands |
29 |
5
This chapter contains the following topics:
Topics:
•emcphostid command
PowerPath requires a unique host ID to reserve shared disks in clustered systems. The emcphostid command sets the Host ID.
This command is supported on HP-UX (11i v2.0 and later) and Windows.
On HP-UX hosts, the PowerPath installation sets the host ID to the largest numerical MAC address or the hash of the Machine ID found at the time of installation. PowerPath installation sets the host ID to the largest numerical MAC address or the hash of the Machine ID found at the time of installation. On Windows hosts, run the Microsoft sysprep utility if the same operating system image is used to set up cluster nodes to ensure that each node receives a unique host ID.
The host ID is saved in /etc/emc/emcphostid on HP-UX hosts. On Windows hosts, the host ID is created by hashing the NetBIOS name of the computer on every boot.
PowerPath requires a unique host ID to reserve shared disks in clustered systems.
After it is set by the installation, the host ID rarely needs to be changed. You should, however, use emcphostid to change the host ID in the following circumstances:
•When there is a conflict. The host ID can be overwritten by using a user specified value. This entry is stored in the registry. Setting the host ID to match the default host ID replaces the user specified value with the default ID.
•The same image of Windows operating system is run on several cluster nodes and you do not run the Microsoft sysprep utility.
•The machine security identifiers on two or more cluster nodes produced the same hash values.
Checks the uniqueness of host IDs for the specified list of hosts.
Syntax
emcphostid check -host <HostName1> <HostName2> ...<HostNameN>
Description
Run emcphostid check to check for conflicts after installing PowerPath in cluster environment and after changing the host ID manually.
Options
-host HostName
Retrieves and prints the host ID for the identified host.
Retrieves and prints the host ID that is currently stored in the Windows registry.
Syntax
emcphostid get [-host <HostName>]
30 emcphostid commands