- Notes, cautions, and warnings
- Revision history
- PowerPath Command Line Interface Overview
- 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
- emcpadm commands
- emcpbfs_linux commands
- emcpcfg script commands
- emcphostid commands
- emcplun commands
- emcpreg commands
- powercf commands
- powerkmd commands
- powermig commands
- powermt commands
- powermt command
- powermt check
- powermt check_registration
- powermt config
- powermt disable hba
- powermt display
- powermt display latency
- powermt display alua
- powermt display ana
- powermt display array_serial
- powermt display bus
- powermt display bus_ports all
- powermt display bus_ports san_latency_values
- powermt display bus_ports speed
- powermt display bus_ports wwn
- powermt display dead
- powermt display hba_mode
- powermt display nonvirtual
- powermt display options
- powermt display perf bus
- powermt display perf dev
- powermt display port_mode
- powermt display ports
- powermt display unmanaged
- powermt enable hba
- powermt help
- powermt load
- powermt manage
- powermt release
- powermt remove
- powermt restore
- powermt save
- powermt set addon_policy
- powermt set all_paths_dead_retry_timeout
- powermt set auto_host_registration
- powermt set autostandby
- powermt set autostandby agingperiod
- powermt set autostandby iopflimit
- powermt set device_perf_to_array_report
- powermt set dev_inuse_to_array_report
- powermt set mode
- powermt set new_lun_probe_interval
- powermt set path_latency_monitor
- powermt set path_latency_threshold
- powermt set path_retry_timeout
- powermt set perfmon
- powermt set periodic_autorestore
- powermt set persist_path_info
- powermt set policy
- powermt set port_disable
- powermt set port_mode
- powermt set reactive_autorestore
- powermt set streamio_threshold
- powermt set write_throttle
- powermt set write_throttle_queue
- powermt unmanage
- powermt update host_registration
- powermt update lun_names
- powermt update san_latency
- powermt version
- powermt command
- pprootdev commands
- rpowermt commands
- rpowermt command
- rpowermt check_registration
- rpowermt check_served
- rpowermt display
- rpowermt display alua
- rpowermt display array serial
- rpowermt display bus
- rpowermt display bus_ports speed
- rpowermt display bus_ports wwn
- rpowermt display latency
- rpowermt display options
- rpowermt display paths
- rpowermt display perf bus
- rpowermt display perf bus vmname
- rpowermt display perf dev
- rpowermt display perf vmname
- rpowermt display port_mode
- rpowermt display ports
- rpowermt help
- rpowermt register
- rpowermt restore
- rpowermt set autostandby
- rpowermt set autostandby iopflimit
- rpowermt set autostandby agingperiod
- rpowermt set auto_host_registration
- rpowermt set mode
- rpowermt set path_latency_monitor
- rpowermt set path_latency_threshold
- rpowermt set perfmon
- rpowermt set vm_perfmon
- rpowermt set periodic_autorestore
- rpowermt set policy
- rpowermt set reactive_autorestore
- rpowermt set streamio_threshold
- rpowermt set device_perf_to_array_report
- rpowermt set dev_inuse_to_array_report
- rpowermt set port_mode
- rpowermt setup add_host
- rpowermt setup list_hosts
- rpowermt setup remove_host
- rpowermt setup update_host
- rpowermt setup verify_hosts
- rpowermt unregister
- rpowermt update host_registration
- rpowermt update lun_names
- rpowermt update san_latency
- rpowermt version
- rpowermt command
- powerssl commands
- PowerPath family environment variables
- PowerPath error codes
- Multipathing messages
- <device_id> is alive
- <device_id> is dead
- /etc/powermt: Permission denied
- /opt/emcpower/powercf does not exist
- /opt/emcpower/powercf: you have to be root to execute this program
- Can't get Pirp_t!
- Cannot install the new configuration files
- Cannot mount root on <>:<>
- Cannot obtain lock on <filename>
- Cannot obtain driver state
- Cannot open /dev/emcp, errno <number>
- Cannot open /etc/path_to_inst. Cannot continue
- Cannot open <filename>, errno <number>
- Cannot open configuration file <filename>
- Cannot open dev dir for reading, errno <number>
- Cannot open string Initialization error
- Cannot produce new files
- Cannot remove device <device_id>, name in use by application
- Cannot write to file
- Cannot write to <filename>
- CLARiiON device path c3t1d0s0 is currently misconfigured
- Configuration database corrupted
- Configuration files contains a dead path (device)
- Current/Active controller for volume has changed
- Device is unavailable
- Error number adding pnpath <hdisk_name> for <hdiskpower_name> to CuAt
- Error number getting pnpath attribute for <hdiskpower_name>
- Error number updating CuDv attribute for <device_id>
- Error retrieving minor number(s)
- Failed opening adapter <device_number>
- Failover mode PNR for CLARiiON LUN <WWN#> is not recommended. Please consider PAR or ALUA
- File deleted. Use -add to create a new file
- File not deleted. No licenses will be available until file is deleted and re-created
- Get adapter <devno> failed number
- Incomplete installation detected
- Invalid base minor number
- Invalid minor number
- Key <key_number> in license file is bad. Use -edit option to repair
- Key <key_number> is invalid
- Key <key_number> was not found
- Key <key_number> is already present, ignored
- License file is full -- cannot add number keys
- mknod of device failed
- MPxIO is enabled. Verify that no arrays are managed by both MPxIO and PowerPath
- Not a multiple of 8
- Number of minors out of range 1-1000
- One or more expired PowerPath license key(s) detected. These are typically used...use emcpreg utility to review your license keys
- PRO service, action 46 failed, 0x5/0x80/0x20
- Pseudo Device Name Major# Minor# <ERROR: unexpected internal error>
- Read of file <file> failed
- There are no keys presently registered. Some functions and capabilities may be unavailable
- This version of PowerPath is NOT binary compatible with your kernel
- Forceload of drv/sd failed
- Get hdisk path data failed
- Internal DB read failed
- Kernel symbol versioning is not enabled in your linux kernel
- Killing bus <bus> to Symmetrix <id> port <port>
- Failed to load extension errno = <number>
- Recognize (loop) error number on device <device_id>
- Storage system <storage_system_name> PowerPath mode disabled
- Not all paths to <volume> are dead
- SPx Not Responding on array : Trespassing volumes
- ODM PdDv database contains duplicate uniquetypes. Refer to EMC Knowledge Base Article Number: 000084491 or contact EMC Customer Support personnel
- Path <path_name> to <device_id> is dead
- <storage_system> path <path_name> is dead. Do you want to remove it (y/n/a/q)?
- Path <bus> <tgt> <lun> to <device> is dead
- Open powerpath0 failed number
- PRO service action 6 failed, <Sense Key>/<ASC>/<ASCQ> for Bus <bus> Tgt <target> Lun <lun>
- Restored volume <clariion/vnx_volume> to default: SP<clariion/vnx_ storage_processor>
- Reviving bus <bus> to Symmetrix <id> port <port>
- Sleeping for memory
- Syscall 8133 to <device_id> failed
- Trespassed volume <clariion_volume> to SP<clariion_ storage_processor>
- Unable to restore volume <volume> to default controller
- Unable to restore volume <clariion_volume> to default SP
- Unable to follow volume <volume> to controller
- Encountered unexpected error 0x<code> on Dek operation command for <device id> on handle <association_handle>
- Unmanage of device <device> failed
- Getting unmanaged devices failed with error
- Unsupported configuration (R1/R2 setup detected)
- Unsupported HBA
- Volume <clariion_volume> followed to SP<clariion_ storage_processor>
- Volume <clariion_volume> is unbound
- Write failed for lack of space, check for filesystem full
- Cannot open PowerPath. Initialization error
- Configuration files corrupted/out of date
- PowerPath configuration files present - exiting
- Major number is already in use
- PowerPath modules are not loaded. Ensure that the modules are loaded and try again
- An older EMCpower package is already installed. Please exit the installation and remove the old EMCpower package first
- PowerPath pseudo bus <bus_name> cannot be configured. Uninstall and reinstall PowerPath
- Unable to create kernel process
- Unable to open /etc/PowerPath Extensions
- Unable to start kernel process
- EMC registration data is missing or corrupt
- EMCP registration file does not exist. Use -add to create it
- EMCP registration file is corrupt
- EMCP registration file is corrupt. Delete it?
- License for <storage_system_name> storage system support is missing or expired
- There are no license keys now registered
- There are no license keys now registered
- License not installed
- Temporary upgrade key has been superseded
- Key found in old registration file is invalid
- Mismatch in configuration
- Missing configuration files
- All paths to vol <volume> are dead
- Attempted action for <storage_array> storage system support is not allowed with the current license level
- Attempted action is not allowed for volumes with BF or NR policy.
- "autostandby agingperiod" must be an integer greater than or equal to 0 and less than 24855 days (596520 hours)
- All paths to <device_id> are dead
- All paths to <volume> are dead
- Array <array> Port <port> is Disabled
- Array <array> Port <port> is Enabled
- Assigned volume <clariion/vnx_volume> to SP<clariion/vnx_ storage_processor>
- <path> is in Autostandby, force option required.
- Bad dev value <device>, or not under Powerpath control.
- Bad dev value <device>, or not under Powerpath control.
- Bad HBA value <hba>
- Bus hba is Disabled.
- Bus <bus_id> to <storage_system_name> port <port_name> is alive.
- Bus <bus_id> to <storage_system_name> port <port_name> is dead.
- Cannot assemble drivers for root <>:<>
- Cannot manage. verify state of the class
- Device cannot be managed at this time. Please verify the state of the class <class>
- Cannot open filename
- Cannot remove alive device <device_id>
- Cannot unmanage. Verify state of the class <class>
- Cannot update persistent store
- <storage_system_class> device(s) not found
- Complete management of class <class> failed
- Configuration file created by newer version of powermt
- Device will be configured on closing all the applications to the device or upon reboot
- Get hdiskpower CuAt failed number
- Get hdiskpower CuDv failed number
- Device specified must be a native device.
- Device(s) not found.
- Device not found
- Device(s) not found
- disable/enable is not allowed on this hba type
- Error occurred loading saved driver state from file /etc/powermt_custom.xml Loading continues
- Error occurred loading saved driver state from file <filename>. Loading continues
- Error reading configuration file / custom file IO failure
- Failed to update CLARiiON user assignable LUN names
- Length of the filename exceeds the maximum limit of: <number> characters
- Invalid option: dev=all is required for this version
- "autostandby iopflimit" must be a number greater than 1 and less than or equal to 100000000
- Path Bus <bus> Tgt <tgt> Lun <lun> to <storage_system> is set to asb:iopf
- powermt load failed
- Manage of device <device> failed
- Manage of device <device> failed
- Please run powermt save to persist PowerPath settings in custom file
- Performance measurement is not enabled & their powermt display perf command exits
- Performance monitoring already enabled.
- Policy is not a valid policy for <storage_system_class> storage systems
- bosboot: missing proto file: /usr/lib/boot/network/chrp.hdiskpower.proto
- The current boot logical volume, <device>, does not exist on <device>
- powermt save failed
- SCSI error on device <device>
- Latency Threshold exceeded by UserDev...with a new high latency of <latency_value> msec
- Unable to unconfigure path Bus X Tgt Y Lun Z as firstpath policy is set
- Unmanage of device <device> failed
- Renaming of temporary file to file:<filename> failed
- PowerPath cannot disable some of its devices because...two host reboots are required to uninstall PowerPath
- 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.
- Migration Enabler messages
- Already recovered
- Already in the state requested
- Couldn't read disk label
- Couldn't write disk label, be sure target is at least as large as source
- Current node cannot be excluded
- Daemon communication error
- Daemon failed to create thread
- Daemon semaphore error
- Daemon socket connection failed
- Device is inaccessible
- Devices already involved in a migration
- An error occurred while using the base daemon, please see the log file
- An internal error occurred during a SYMAPI operation. Please report to EMC
- Failed to fix disk label of the target device
- Failed to get disk layout of device
- Failed to get target size
- Failed to load EFI support library
- Failed to set disk layout of device
- Failed to validate geometry of target device
- Failed to transfer the source reservation
- The feature being requested is not currently licensed
- A function call exceeded allocated time
- The gatekeeper device (while using the Base Daemon) has an error (Please see the log file)
- Handle not found
- Host can still access source device
- Migration stopped due to IO error - will attempt to restart
- Needs recovery
- No migration is in the proper state to perform the requested operation
- Node <nodename> not found
- PPME Resource <Cluster Disk Name> created with powermigcl
- PR Keys found on Target disk during Setup
- Not in proper state to perform this operation
- Possible alternate cylinder overlap detected using native source geometry
- PPME cannot be used with a temporary license
- Remote SE environment variable(s) not allowed in setup
- Source must be a cluster shared volume
- Source is a CSV (use '-cluster mscsv' to setup a cluster migration)
- Source disk's dependent PPME resource was changed
- Source device is in use (-force will override)
- Source faulted, must abort migration
- Source faulted, must commit migration
- Source and target must be from same array
- Source and target are the same device
- Source has extended partitions but target does not support extended partitions
- Target faulted, must abort migration
- Target device is in use
- Target must be at least as large as the source
- Target max_transfer attribute is too small
- Target is not accessible
- Target device is not attached to some nodes
- Target must be a pseudo
- UMD database not initialized
- Unable to scrub the abandoned device
- Unable to scrub the abandoned device. Device is offline
- Unknown device
- PowerPath/VE messages
- Allocation of dummy <ASyncIoDaemon/ TestDaemon/ SyncIoDaemon> entry failed. Not aborting it
- Bad dev value <invalid_value>, or not under PowerPath control
- Bad dev value emcpower <invalid value>, or not under PowerPath control
- Bad hba value <invalid_value>, or not under PowerPath control
- Cannot communicate with host, version mismatch too great
- Cannot communicate with host, version mismatch too great
- Could not allocate SCSI device
- Could not claim the path. Status: <status>
- Could not create vol Daemon
- Could not initialize log name: <status>
- Device <device_bus_path> is currently dead
- Device(s) not found
- <array_type> device(s) not found
- <class> device(s) not found
- Device(s) not found
- Enqueued from <ASyncIoDaemon/ TestDaemon/ SyncIoDaemon> to Abort queue Cmd <command>
- Failed to Create Pirp
- Failed to create Pirp
- Failed to create Platform scsicmd
- Failed to create scsi Pirp
- Failed to find IP address for <unresolved hostname>
- Failed to open host file
- Failed to remove host information from host file
- Failed to reset the license server count
- Failed to retrieve host information from host file
- Failed to retrieve host list from host file
- Failed to store host information into host file
- Failed to store host list into host file
- Failed to alloc Pirp
- Failed to create Char device name. Status: <status>
- Global PMI disabled
- Host not found
- Inquiry failed. Status: <status>
- Invalid option '-d' when upgrading from a previous version of installer
- Invalid passphrase during host file creation
- License autoregistration is disabled
- License checkout failed
- License data does not match host data
- License feature or attribute not found
- License file does not exist or not found
- License file format error or misspelling
- License file is invalid (inconsistent)
- License key or feature not found
- License not installed
- License not installed
- License type mismatch. Hyper-V enabled: PowerPath/VE for Windows license key not found
- Mpx: pData <data> size <size>
- MpxRecognize failed. No resources- check system maximum path limits
- MpxRecognize failed
- No valid licenses found
- No active path to the device found
- No PMI data available for this VM
- No standard UID. Using the WWN as volume UID
- Not a valid sense buffer
- The path has already been claimed
- Path is in Autostandby, force option required
- Path <path> could not be disabled. It is the last working path to volume
- The Path has not been claimed
- Performance Monitor is not enabled
- Persistence of SCSI Res fail Value is 0, generating new one
- PowerPath driver is already registered
- PowerPath driver is already unlicensed
- PowerPath Not Found
- Probe of <path> path failed. Status <status>
- ProbePath Failed path
- Path <path>: could not issue sync/async IO command: <status>
- SCSI-2 reservation/release failed with SCSI status <status>
- SCSI-2 Translation command failed after the maximum number of retries
- Sense Info S: <sc> ASC: <asc> ASCQ: <ascq>
- Status <status>. Failed to register device. User should unclaim paths.
- Unable to send cmd (cleanup PRI) to device. SCSI status <status>
- Unable to send cmd (cleanup PRO) to device. SCSI status <status>
- Could not unregister the device
- User Authentication Invalid
- VM either does not exist or is not registered on this host
- vmk_LogRegister failed: <status>
- Volume is being destroyed. Cannot open
- Volume not found
- Volume to be opened not found
- The volume is open. Cannot unclaim last path <path>
- The volume is being registered or unregistered. Cannot unclaim last path <path>
- Wait for n IosPending count (count) to become 0
- Wait for volume to be unquiesced
- PowerPath Management Appliance messages
- PowerPath family new and changed commands
- List of the PowerPath load balancing and failover policies
- List of fields used in the powermt and rpowermt display command output
- Microsoft Windows IDs
- AIX error logging facility messages
Dell EMC PowerPath Family CLI and System Messages Reference
Revision history
The following table presents the revision history of this document:
| Revision | Date | Description |
|---|---|---|
| 12.0 | January 2022 | Release of PowerPath for Linux 7.4. |
| 11.0 | October 2021 | Release of PowerPath for Windows 7.1. |
| 10.0 | July 2021 | Release of PowerPath/VE for VMware vSphere 7.2. |
| 9.0 | June 2021 | Updated with Dell EMC PowerStore storage systems support details. |
| 8.0 | April 2021 | Release of PowerPath for Linux 7.3. |
| 7.0 | November 2020 | Release of PowerPath/VE for VMware vSphere 7.1. |
| 6.0 | October 2020 | Updated this guide with the following new sections:
|
| 5.0 | September 2020 | Release of PowerPath for Linux 7.2. |
| 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. |
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please select whether the article was helpful or not.
Comments cannot contain these special characters: <>()\