User Commands PowerMt (1)
Name Powermt - PowerPath 4.x Management Utility
Synopsis Powermt Check [Class = {SYMM | CLARION | HITACHI | HPXP | ESS | All}] [Force] [HBA = HBA # | all] [dev = path | device | all]
Powermt Check_Registration
Powermt Config
Powermt Display | Watch [Paths | Ports] [Class = {SYMM | CLARION | HITACHI | HPXP | ESS | All}] [Every = Seconds] PowerMt Display | Watch [Ports] [dev = device | all] [class = {SYMM Clariion | Hitachi | HPXP | ESS | All}] [every = seconds]
Powermt Display Options
Powermt Display unmanaged
Powermt Load [class = {symm | claraiion | Hitachi | HPXP | ESS | All}] [file = Pathname]
Powermt Management | Class = {Hitachi | HPXP | ESS}}
Powermt Remove [Class = {SYMM | CLARION | HITACHI | HPXP | ESS | All}] [Force] HBA = HBA # | All | Dev = Path | Device | All PowerMt Remove [Class = {SYMM | CLARiION | Hitachi | HPXP | ESS | all}] [Force] HBA = HBA # | All dev = patH | device | all
Powermt Restore [class = {symm | clariion | Hitachi | HPXP | ESS | All}] [Force] [HBA = HBA # | all] [dev = path | device | all]
Powermt Save [file = pathname]
Powermt Set Periodic_AutoRestore = ON | OFF [Class = {SYMM | CLARION | HITACHI | HPXP | ESS | All}]
Powermt Set Mode = Active | Standby | Hitachi | HPXP | Ess | All}] [HBA = HBA # | all] [dev = PATH | Device | all]
Powermt Set Policy = Policy [class = {symm | claraiion | Hitachi | HPXP | ESS | all}] [dev = device | all]
Powermt set priority = priority # [class = {symm | claraiion | Hitachi | HPXP | ESS | all}] [dev = device | all]
Powermt Set Transparent = ON | OFF [dev = device | all]
Powermt set write_throttle = on | OFF [class = symm] [dev = device | all] Sunos 5.8 Last Change: January, 2004 1
User Commands PowerMt (1)
Powermt set write_throttle_queue = queue_depth # [class = symm] [dev = path | device | all]
Powermt unmanage {dev = device | class = {hitachi | hpxp | ess}}
Powermt Update LUN_NAMES
Powermt Version
DESCRIPTION The powermt utility is used to configure and restore paths to logical devices, validate and check logical device serial numbers, display information about HBAs and PowerPath devices, and set load-balancing and failover policies.
A logical device is the smallest addressable storage unit. An entity management and presented by a Storage System, a logical device identical disks or section of physical disks.
A PowerPath device is created by PowerPath for each logical device discovered by the PowerPath driver. There is a one- to-one relationship between a PowerPath device and a logical device. A PowerPath device is also referred to as a pseudo device.
In Contrast, a native device is create and provides ie logical device. The device is "native" in That it is providing by the operation system.
In PowerPath, AN I / O Path, or Path, Refers to the Route Travelled by Data Between A Host And A Logical Device. A path comprises an HBA, One or more Cables, A Switch or Hub (FIBRE CHANNEL ONLY), A Storage System Interface and Port, And A Logical Device. Typically, a Native Device Represents A Single Path To a logical defic.
Prerequisites to Executing powermt By default, the PowerPath installation process sets the file permissions so that only the superuser (root) can run powermt. You can allow other users to run powermt by changing access permissions on the powermt command, by setting the setuid / setgid Bits.executing Powermt to Run Powermt, Type Any of The Commands Listed in "Synopsis" at the shell prompt.
DEV Argument Specification Several Powermt Commands Have a dev argument. depending on the Command, this Argument CAN Specify A Logical Device OR A
Sunos 5.8 Last Change: January, 2004 2
User Commands PowerMt (1)
Path.
DEV ACTS ON PATHS in The Following Commands:
Powermt Check Powermt Remove Powermt Restore Powermt Set Mode PowerMt Set Write_throttle_Queue (ACTS ON PORTS Associated with paths)
DEV ACTS ON Logical Devices in The Following Commands:
Powermt Display Powermt Management Powermt Set Policy Powermt Set Priority PowerMt Set Transparent PowerMT Set Write_throttle PowerMt Unmanage
You can specify either a PowerPath device or a native / path device in the dev argument The dev argument is context specific powermt interprets the meaning of the argument based on the context of the command being executed..:
For commands that act on paths, specifying a PowerPath device causes the command to be applied to all paths associated with the device; specifying an associated native / path device causes the command to be applied only to that path.
For commands that act on logical devices, you can specify the logical device using either the PowerPath device or any of the native / path devices associated with that logical device.Correct dev arguments are as follows:
AIX
To Specify a Device Hdiskpower # or #
To Specify a path hdisk #
Examples hdiskpower3, 3, hdisk3
HP-UX
Sunos 5.8 Last Change: January, 2004 3
User Commands PowerMt (1)
To Specify A Device N / A
To Specify a path c # t # d #
Examples C1T2D2
Solaris
To Specify A Device Emcpower # [A-H] or #
To Specify A Path C # T # D # [S0-S7]
Examples Emcpower2a, 2, C1T1D1
Commands Powermt Check [Class = {SYMM | CLARION | HITACHI | HPXP | ESS | All}] [Force] [HBA = HBA # | all] [dev = path | device | all]
Powermt Check Checks Specified Paths and, IF Desired, Removes from The PowerPath Configuration Any Paths Marked DEAD.
IF a path is marked dead or the serial number inforction do not match the serial number on the logical device, powermt check prospts you to remove the pat:
Warning: storage_system I / o path path_name is dead. Do you want to remove it (y / n / A / q)?
Valid Responses Are:
y Remove The Dead Path, And Continue Checking Remaining Paths.
N do Not Remove The Path, But Continue Checking Remaining Paths.
A Remove The Dead Path and Any Subsequent Paths Marked DEAD.
q do not remove the dead path, and exit the command. Any Paths That WERE Already Removed Remain Removed.if The PowerPath License Is Invalid, PowerMt Check Issues A Warning and Continues ITS Processing. Use
Sunos 5.8 Last Change: January, 2004 4
User Commands PowerMt (1)
Powermt Check_Registration To Determine The Problem with The PowerPath License.
Arguments
class = {symm | clariion | hitachi | hpxp | ess | all}.. Limits the command to the specified type of storage system all specifies all storage-system types The default is all (You can change the default using the PP_DEFAULT_STORAGE_SYS environment variable. .)
IF class is specified along with hba and / or dev, the command is applied to paths....
Force Suppresses the Confirmation Prompt and Silently Removes All Paths Marked Dead.
hba = hba # | all Limits the check to paths from the specified HBA hba # is a number in the Host Bus Adapters ### column of powermt display output all specifies all HBAs under PowerPath control The default is all....
(Adapter Can Be Used Instead of HBA. Adapter is Included Only for Compatibility with prior PowerPath Releases. Use HBa INSTEAD.)
DEV = PATH | DEVICE | All Limits The Check to the specified path or all paths to all specifies all paths to all defifies all paths to all devices. The default is all.
Powermt Check_registrationPowermt Check_registration Checks The State of The PowerPath License On A Host.
Powermt Check_Registration Determines WHETHER THE HOST HAS:
- a Valid Permanent license or evted eviRussion license - An invalid or corrupt license - no license
Evaluation Licenses Provide The Same Functionality As Permanent Licenses, But An Eveation License Expires
SUNOS 5.8 Last Change: January, 2004 5
User Commands PowerMt (1)
On The Last Day of a Specified Month.
Powermt Check_Registration Displays Output Like The Following:
Key Number Product: PowerPath Capabilities: license - Storage_Systems
WHERE NUMBER IS YOUR 24-Digit Registration Key, License IS your license Type and Storage_Systems IS A List of the Storage Systems On Which this license is Valid (for Example, CLARION).
For An Evaluation License, Powermt Check_registration Also Outputs a line Like this:
Expires: Month, Year
For An Expired License, Powermt Check_Registration Also Outputs a line Like this:
Expired: Month, Year
IF the license is expedition or there is no license:
- No Powermt Set Commands Can Be Executed.
- Powermt Save Cannot Be Executed.
At Boot Time, The Load Balancing and Failover Policy Is Set As Follows:
- Symmetrix Optimization. Set for Symmetrix Storage Systems ON Platforms with a Valid PowerPath license.
- Clariion Optimization. Set for Clariiion Storage Systems on Platforms with a Valid PowerPath license.
-.. Adaptive Set for Hitachi Lightning, HP xp, and IBM ESS storage systems on platforms with a valid PowerPath license.- no redirect Set for Symmetrix, Hitachi Lightning, HP xp, and IBM ESS storage systems on platforms without a valid PowerPath license .
- Basic Failover. SET for Clariion Storage Systems on Platforms Without a Valid PowerPath license.
Powermt Config
Sunos 5.8 Last Change: January, 2004 6
User Commands PowerMt (1)
Powermt Config Configures All Detected Symmetrix and Clariion Logical Devices As PowerPath Devices And Adds these Devices to the powerpath configuration.
Powermt Config Also Configures All Detected Third-Party Array Logical Devices AS PowerPath Devices If Their Storage Array Classes Are Set To Managed.
Powermt Config Creates Devices As Required ON AIX and Solaris Platforms (ON HP-UX Platforms, PowerPath Uses ".
Powermt Config Also Configures All Detected Paths to PowerPath Devices and adds these paths to the powerpath configuration.
Powermt Config Does Not Remove Previously Configured Paths When The Become Dead path.
powermt config adds paths to logical devices based on the storage-system frame serial number and the logical device serial number. Together, these values (shown in the output of powermt display dev) uniquely identify a logical device. By default, powermt config adds PowerPath devices with the Symmetrix optimization, CLARiiON optimization, or Adaptive load balancing and failover policy, a priority of 0, write throttling set to off, and a write throttle queue depth of 256. It adds paths with the mode set to active. It adds storage systems with periodic autorestore set to on.After powermt config completes, you can change the configuration with several powermt commands: powermt set policy, powermt set priority, powermt set periodic_autorestore, powermt set mode, powermt set write_throttle, powermt set write_throttle_queue, or powermt load .
If The PowerPath License Is Invalid, Powermt Config Issues A Warning and Continues Its Processing. Use Powermt Check_Registration To Determine The Problem with The PowerPath license.
Platform-Specific Notes
On AIX, if powermt config encounters an error, a general AIX error message is displayed, indicating there is a problem configuring a device. The text of the message depends on the underlying error. For more detailed PowerPath error information, we recommend AIX users run Cfgmgr -vl PowerPath0 INSTEAD OF PowerMT Config. The cfgmgr command Performs The Same Function
Sunos 5.8 Last Change: January, 2004 7
User Commands Powermt (1) AS PowerMT Config But Generetes More Detailed Error Messages (Document ".
On HP-UX, powermt config runs at boot time from / etc / inittab to configure PowerPath. On Solaris, powermt config runs at boot time from startup scripts under /etc/rcS.d. You need to run powermt config only if more paths Areadded after boot time.
Powermt Display [PRHS | Ports] [Class = {SYMM | CLARION | HITACHI | HPXP | ESS | All}] [Every = Seconds] PowerMt Display [Ports] [dev = device | all] [class = {SYMM | CLARION | HITATACHI | HPXP | Ess | All}] [Every = seconds]
Powermt Display Displays Information About HBAS AND / OR DEVICES Configured for and management by PowerPath.
Powermt Watch Is Equivalent To Powermt Display. Powermt Watch Is Included Only for Compatibility With prior PowerPath Releases. Use powermt display instead.
Arguments
class = {symm | clariion | hitachi | hpxp | ess | all}.. Limits the command to the specified type of storage system all specifies all storage-system types The default is all (You can change the default using the PP_DEFAULT_STORAGE_SYS environment variable. .)
IF class is specified along with hba and / or dev, the command is applied to paths....
Paths Displays Information One Line Per path.
Ports Displays Information One Line Per Port.
DEV = Device | All Displays Information About The Specified Device. All Specifies All PowerPath Devices.
If paths, ports, or dev is not specified, a summary HBA listing is displayed, with one line per HBA.every = seconds Integer in the range 1-86400 that specifies, in seconds, how often the display is updated. By default, The display is not updated.
Sunos 5.8 Last Change: January, 2004 8
User Commands PowerMt (1)
The seconds value is the minimum time between refreshes; The actual time is affected by the Overall System Load. On busy systems, display updates can be less frequent tour
Description of the displays
The first form of the command (powermt display) yields the HBA display. The second form of the command (powermt display dev) yields the devices display. The following sections explain the fields in each display.
NOTE: For a more detailed descripting of these displays, incruding example displays and a discussion of the effects of zoning on the displays, see the powerpath product guide.
Fields in the HBA DISPLAY
Storage_System_Type Logical Device Count Value: Non-Negative Integer
That..................
Each Powermt Display Table Contains Information About One Type of Storage System, Such As Symmetrix.
Host bus adapters ### value: non-negative integer
PowerPath Number for the HBA.
................... ..
Host Bus Adapters HW Path Value: Alphaumeric String
Operating-System-Specific Hardware Descriptive Name for the bus:
- AIX: The name of the device. Is the parent of the hdisk; for example, scsi1.
SUNOS 5.8 Last Change: January, 2004 9
User Commands PowerMt (1)
- HP-UX: Hardware path as defined by The Ioscan Command; for Example, 10 / 4.2.0.
- Solaris: Modification of the / dev / rdsk symbolic link target; for example, sbus @ 1f, 0 / fcaw @ 3,0.
I / O Paths Summary Value: Optimal, Degraded, OR Failed
Status of the paths Originating from this HBA:
- Optimal Means All Paths Are Alive (USABLE).
- Degraded Means One or More, But Not All, Paths from this HBA Are DEAD (Not USABLE).
- Failed Means All Paths Are dead and no data is passing through this hba.
I / O Paths Total Value: Non-Negative Integer
Total number of paths that originate from this HBA. The maximum number of logical devices supported by one HBA is platform specific. The total number of paths may exceed the number of logical devices in a complex SAN topology, due to zoning.
I / O Paths Dead Value: Integer in The Range 0 - I / O Paths Total
Total Number of Paths Originating from this HBA That Are DEAD (NOT USABLE).
Stats IO / sec Value: Non-negative integerThis field is blank for powermt display, unless it is used with the every parameter Subsequent powermt display iterations display the average number of I / Os sent across this bus each second..
Stats Q-iOS Value: Non-Negative Integer
Total Number of Outstanding I / OS on this HBA Now.
Stats Errors Value: Non-Negative Integer
Sunos 5.8 Last Change: January, 2004 10
User Commands PowerMt (1)
Total number of times any logical I / O paths on this bus transitioned from alive to dead. This always is equal to or less than the total number of HBA I / O errors. It is cleared at boot time or when powermt restore executes. The PowerPath Periodic AutoStore Feature Does Not Clear This Number But May Cause It To Increase IF The Path Has Intermit Failures (That IS, Some Periodic AutoStore Operations Are Successful and Others Are Not).
Storage System ID Value: Hexadecimal Value or Alpha_Umeric String
Identification Number for the Storage System on Which The Logical Device IS located.
Storage System Interface Value: Alphaumeric String
Storage System-Interface.
For Symmetrix Systems, this Has Three Parts:
- Interface Type: FIBRE CHANNEL (FA) OR SCSI (SA)
- Interface Address: Integer in The Range 1-16
- Interface Port: AA, AB, BA, BB
For Clariion Systems, this Has One Part:
- Interface Port: SP [A-B] [0-3]
For Hitachi Lightning and HP xp systems, this is the port name on the array.For IBM ESS systems, this is a two-digit hexadecimal port ID that can be decoded to a Bay / Adaptor / Port on the ESS system. (IBM ESS Command-line Interface Documentation Describes How to Decode The Port ID.
Storage System WT_Q Value: Non-Negative Integer
Maximum Number of Write I / O Requests That Will Be Serviced Before Any Outstanding READ I / O.
FIELDS in the Devices Display
SUNOS 5.8 Last Change: January, 2004 11
User Commands PowerMt (1)
Pseudo name value: Alphaumeric String
Platform-Specific Value Assigned by PowerPath To The PowerPath Device Associated with The Logical Device. See "dev Argument Specification" for Pseudo Device Naming Formats for Each Platform.
Storage_system_type id value: Hexadecimal Value or Alphaumeric String
Identification Number for the Storage System on Which The Logical Device IS located.
Each Powermt Display Table Contains Information About One Type of Storage System, Such As Symmetrix.
For CLARiiON systems only, the user-specified storage group name, if available, is by default displayed in brackets after this identification number. To suppress display of the name, define the environment variable PP_SHOW_CLAR_LUN_NAMES and set it to "false" or "FALSE" (To RE-enable the default or set it to "true" or "true".) Logical Device ID value: Hexadecimal Value or Alphaumeric String
Identification number for the logical device. Each logical device on each storage system has a unique ID. Each storage system, however, uses the same storage system ID. Together, storage system ID and logical device ID create a unique ID for every logical device in The world.
On a Clariion System, The Logical Device ID IS A 32-DIGIT NUMBER. This is not the same as the standard device ideiff oddy.
For CLARiiON systems only, the user-assignable LUN name, if available, is by default displayed in brackets after this identification number. To suppress display of LUN names, define the environment variable PP_SHOW_CLAR_LUN_NAMES and set it to "false" or "FALSE". (To RE-enable the default behavior, Either remove the variable or set it to "true" or "true".)
State Value: Alive Or Dead
SUNOS 5.8 Last Change: January, 2004 12
User Commands Powermt (1) State of The PowerPath Device:
-. PowerPath marks a PowerPath device dead if it returns certain types of I / O errors and is judged unusable Once a PowerPath device is marked dead (and until it is restored with powermt restore), PowerPath returns subsequent I / O requests with a failure STATUS, WITHOUT Forwarding The THE Associated Logical Device. This prevents further, unrecoverable corruption and allows you to perform data recovery if needed.
- IF a PowerPath Device IS Alive, Either PowerPath Never Marked It Dead, or it. Marked Dead But Restored with Powermt Restore or An Automatic Path Test.
Owner value: default = sp x, current = SP X
DEFAULT AND CURRENT OWNERS OF THE LOGICAL Device (CLARiON Systems Only).
Policy Value: Adaptive, Basicfailover, Claropt, Leastblocks, Leastios, Nored, Request, Roundrobin, or Symmopt
Current Load Balancing and Failover Policy for the PowerPath Device.
Use powermt set policy to change the policy.
Priority Value: Integer in The Range 0-10
Amount of Scheduling Favoritism Shown To The PowerPath Device. Priority Applies Only to The Adaptive, Symmopt and Claropt Load Balancing Policies.
Use Powermt Set Priority to Change the Priority.
Queued-ios Value: Non-Negative Integer
Number of I / O Requests Queued to this PowerPath Device.
WRITE-THROTTLE VALUE: on or off
Sunos 5.8 Last Change: January, 2004 13User Commands PowerMt (1)
WRITE-THROTTLING SETTING for this Logical Device.
Host ### Value: non-negative INTEGER
PowerPath Number for the HBA.
................
This Number is Preserved Across Boots But Is Not Preserved After Configuration Changes.
Host HW path value: Alphaumeric String
The Platform-Specific Hardware Descriptive Name for the Path:
- AIX: The name of the device That it is the parent of the hdisk; for example, fscsi1.
- HP-UX: Hardware path as defined by The Ioscan Command; for Example, 10 / 4.2.0.
- Solaris: Modification of the / dev / rdsk symbolic link target; for example, / pci @ 8,700000 / qlgc, qla @ 3 / sd @ 0, 2.
Host I / O path value: Alphaumeric String
The Platform-Specific Device Name for the Path. See "dev argument specification".
On HP-UX and Solaris, if new devices are added, powermt display every = seconds may display unknown in place of the actual device names due to the creation of device-name mappings at startup. If this occurs, restart powermt display every = seconds .
Stor Interf. Value: Alphaumeric String
Storage System Interface. For Symmetrix Systems, this Has Three Parts:
- Interface Type: FIBRE CHANNEL (FA) OR SCSI (SA)
SUNOS 5.8 Last Change: January, 2004 14
User Commands Powermt (1) - Interface Address: Integer in The Range 1-16
- Interface Port: [Abcd] [AB]
For Clariion Systems, this Has One Part:
- Interface Port: SP [A-B] [0-3]
For Hitachi Lightning and HP XP Systems, this is the port name on the array.
For IBM ESS systems, this is a two-digit hexadecimal port ID that can be decoded to a Bay / Adaptor / Port on the ESS system. (IBM ESS command-line interface documentation describes how to decode the port ID.)
I / O paths mode value: Active, Standby, or Unlic
Current Path Mode:
-.. Active indicates this path can accept I / O Load balancing is performed for a PowerPath device with more than one active path, based on the load balancing and failover policy set for the PowerPath device On active-passive storage systems, I / O Is load-balanced across paths to a single sp for Each Logical Device.
- standby indicates this path is held in reserve Being set to standby does not mean a path will not be used It only means the weight of the path is heavily adjusted to preclude its use in normal operations A standby path still can be selected... IT is the best path for the request.
- unlic indicates that unlicensed PowerPath is running for a CLARiiON array (no license key has been installed) In this scenario, all paths are marked unlicensed except one path to each SP Unlicensed paths can not become candidates for path failover...
Use powermt set mode to change the mode.i / o paths state value: alive or dead
Current path State:
Sunos 5.8 Last Change: January, 2004 15
User Commands PowerMt (1)
- Alive Indicates the path is usable: PowerPath CAN Direct I / O to this path.
- dead indicates the path is not usable: PowerPath will not direct I / O to this path After marking the path dead and incrementing the Errors count, PowerPath tests the path to see whether it is usable If the test succeeds, PowerPath marks the.. path alive;.. the path is then available for I / O If the test fails, the path remains dead, and PowerPath ignores it for subsequent I / O operations If all the paths to a logical device are dead, PowerPath retests each path.
Stats Q-iOS Value: Non-Negative Integer
Total Number of I / O Operations Under Way To this path. This is The Total Number of I / O Requests To this Device That Have Not Completed. The Sum of In-Progress I / OS for All Paths Should Equal The Number of In- Progress I / OS for the PowerPath Device.
Stats Errors Value: Non-Negative Number
Total number of times this path transitioned from alive to dead. This always is equal to or less than the total number of HBA I / O errors. It is cleared at boot time or when powermt restore executes. The PowerPath periodic autorestore feature does not clear this number but may cause it to increase if the path has intermittent failures (that is, some periodic autorestore operations are successful and others are not) .If both the dev and ports options are specified, a compressed version of the devices display is output. The compressed display includes a column listing the write throttle setting (on or off) of each storage- system port and a column listing the write throttle queue depth for each port. To accommodate the extra information, the I / O Paths Mode and I / O Paths State Column of The Normal Devices Display Are Merged Into a path status column. Valid Values for Path Status Are As Follows:
Value Meaning Description
A Active See The Description of Path Mode, Above S Standby See The Description of path Mode, Above
Sunos 5.8 Last Change: January, 2004 16
User Commands PowerMt (1)
U UNLICENSED See The Description of path Mode, Above V Alive See The Description of Path State, Above D Dead See The Description of Path State, Above
Powermt Display Options
powermt display options displays the default storage system class and the following options settings for each storage system class: - Status of the storage system class (managed, unmanaged, manage_incomplete, or unmanage_incomplete)
- WHETHER CLARION User-Assignable Lun Names Are Displayed
- WHETER PERIODIC AutoStore is enabled
Use powermt set periodic_autorestore to change the periodic autorestore setting. Use powermt manage to place logical devices under PowerPath management and powermt unmanage to exclude devices from PowerPath management (third-party storage systems only).
Use the pp_default_storage_sys Environment Variable To Change The Default Storage System Class.
CLARiiON user-assignable LUN names are displayed by default. To suppress display of LUN names, define the environment variable PP_SHOW_CLAR_LUN_NAMES and set it to "false" or "FALSE". (To re-enable the default behavior, either remove the variable or set It to "true" or "true".) An Example Using Bourne Shell Syntax To Suppress The Display of Lun Names IS:
PP_SHOW_CLAR_LUN_NAMES = FALSE EXPORT PP_SHOW_CLAR_LUN_NAMES
Powermt Display unmanaged
powermt display unmanaged displays information about logical devices that have been excluded from PowerPath management using powermt unmanage. You can use the native device as the dev argument to the powermt manage dev = command.
Powermt Load [class = {symm | claraiion | Hitachi | HPXP | ESS | All}] [file = Pathname]
PowerMT Load Applies To the Current Configuration The Following Settings from a Saved Configuration File: PowerPath Device Policies and priorities; Writesunos 5.8 Last Change: January, 2004 17
User Commands PowerMt (1)
throttle setting and write throttle queue depth; periodic autorestore setting;.. and path modes On all platforms, the file is saved when powermt save is run manually On HP-UX and Solaris, the file is also saved at boot time.
If a configuration is saved with powermt save under the default filename, the configuration loads automatically at boot time. (The exception is AIX, which always loads default settings at boot time.) If the default filename is not used, the configuration does not load Automatically At Boot Time; In this case, you mustidide the configuration manually with powermt loading.
Paths added since the last save remain as is. If the configuration file has information about dead paths, they are added in a failed state, allowing them to be restored later. If the file has information about paths that were removed since the last save, They is added.
IF The PowerPath License Is Invalid, Powermt Load Issues A Warning and Continues Its Processing. Use powermt check_registration to determine the problem with the license.
Powermt load behavior is undefined when the HOSTER THAN A Alive. do not useful powermt loading to rest..
Arguments
class = {symm | clariion | hitachi | hpxp | ess | all}.. Limits the command to the specified type of storage system all specifies all storage-system types The default is all (You can change the default using the PP_DEFAULT_STORAGE_SYS environment variable. .) File = pathname Full Pathname of the Saved Configuration File. for the default filename, See Powermt Save.
Powermt Management | Class = {Hitachi | HPXP | ESS}}
Powermt Manage Places A Specified Logical Device, OR A Specified Storage System Class, Under PowerPath Management.
By Default, All Storage System Classes Are Under PowerPath Management. You Can Use PowerMt Unmanage To Exclude A Storage System Class from PowerPath
SUNOS 5.8 Last Change: January, 2004 18
User Commands PowerMt (1)
Management. Use Powermt Manage Class = To Return That Storage System Class to PowerPath Control.
Likewise, by default, when a storage system class is under PowerPath management, all logical devices of that class are under PowerPath management. You can use powermt unmanage to exclude an individual device from PowerPath management. Use powermt manage dev = to return that device to PowerPath Control. Powermt Manage Returns a Device To PowerPath Control Only ITS Storage System Class Is Currently Management by PowerPath.
A powermt manage class = operation is legal only if the class's status is unmanaged or manage_incomplete. If the class status is unmanage_incomplete, the unmanage operation must be completed, or the host rebooted, before powermt manage succeeds. The powermt display options command displays the status of a class.arguments
DEV = Device Specifies The Pathname of a Logical Device To Be Management by PowerPath.
Class = {Hitachi | HPXP | Ess} Specifies The Storage System Class to Be Management by PowerPath.
Powermt Remove [Class = {SYMM | CLARION | HITACHI | HPXP | ESS | All}] [Force] HBA = HBA # | All | Dev = Path | Device | All PowerMt Remove [Class = {SYMM | CLARiION | Hitachi | HPXP | ESS | all}] [Force] HBA = HBA # | All dev = patH | device | all
powermt remove deletes the specified path (or paths) from PowerPath's list of configured paths. It does not delete device the paths refer to. As long as the logical device remains visible on the system, the logical device can be reconfigured via powermt the logical that CONFIG.
CAUTION: DO NOT REMOVE The Last Path to a logical device unless.
On all platforms except AIX, powermt remove does not remove a path if that native path is open - for example, if a file system is mounted on the native path device or an application has opened the native path device Instead, powermt remove removes. All Specified Paths That Are Not Currently Open, Issues An Error Message, And EXITS.
Sunos 5.8 Last Change: January, 2004 19User Commands PowerMt (1)
IF a PowerPath Device IS Open, Powermt Remove Does Not Remove That Device or The Last Path To That Device. If A Device IS IN A PPVM Volume Group, PowerPath Does Not Remove The Last Path To That Device.
In addition, powermt remove operates on paths, so when powermt remove is executed with an HBA or PowerPath device argument, powermt remove iterates through all the associated paths and attempts to remove them. The HBA or PowerPath device is removed only if all the associated paths Are successfully removed.
To Permanently Remove a path from the powerpath configuration:
Run Powermt Check or Powermt Remove.
2. Physically remove the path.
3. Remove The Operating System Objects Associated with The Path and / Or Device.
4. Run Powermt Save.
IF The PowerPath License Is Invalid, Powermt Remove Issues A Warning and Continues ITS Processing. Use powermt check_registration to determine the problem with the license.
ON All Platforms Except AIX and Solaris, IF you Run Powermt Remove on a live path with active I / O, PowerPath Returns the Message
Cannot Remove Alive Device Device_name
And EXITS.
Arguments
class = {symm | clariion | hitachi | hpxp | ess | all}.. Limits the command to the specified type of storage system all specifies all storage-system types The default is all (You can change the default using the PP_DEFAULT_STORAGE_SYS environment variable. .)
IF class is specified along with hba and / or dev, the command is applied to pats.Force Suppresses The Confirmation Prompt and Silently
SUNOS 5.8 Last Change: January, 2004 20
User Commands PowerMt (1)
Removes All Specified Paths, Including The Last Path to a logical device.
hba = hba # | all Limits removal to paths from the specified HBA hba # is a number in the Host Bus Adapters ### column of powermt display dev output all specifies all HBAs under PowerPath control The default is all....
(Adapter Can Be Used Instead of HBA. Adapter is Included Only for Compatibility with prior PowerPath Releases. Use HBa INSTEAD.)
DEV = PATH | Device | All Limits Removal to the specified path or all paths to the specified powerpath device. All specifies all paths to all deflicies. The default is all.
Powermt Restore [class = {symm | clariion | Hitachi | HPXP | ESS | All}] [Force] [HBA = HBA # | all] [dev = path | device | all]
Powermt Restore Tests and RESTORES Specified Paths. It isssues Test I / OS And Responds To The Test Results As Follows:
- IF a Live Path Passs The Test, Powermt Restore Does Nothing.
- IF a dead path passes The Test, Powermt Restore Marks It Alive; PowerPath Can Now Use It. In Addui, Other Dead Paths on The Same HBA and / or Storage System Port May Be Tested.
- If a live path fails the test, powermt restore marks it dead and prints a warning (every time the path fails the test) In addition, other paths that share the same HBA and port may be marked dead, and other paths that share. Only the hba or only the port may be tsted.- if a dead path fails the test, powermt restore prints a warning (every time the path fails the Test).
There May Be a delay in Accessing a recovered path. To Avoid this delay, Run Powermt Restore After a path is physical reason.
In addition to testing and restoring paths, powermt restore attempts to resurrect dead volumes. A volume may be marked dead if write errors occur that could jeopardize the integrity of the data structures, and if subsequent writes could aggravate the problem.
SUNOS 5.8 Last Change: January, 2004 21
User Commands PowerMt (1)
When Applied to Clariion Storage Systems, Powermt Restore Also Relocates Luns To Their Default Storage Processor.
IF The PowerPath License Is Invalid, Powermt Restore Issues A Warning and Continues ITS Processing. Use powermt check_registration to determine the problem..
Arguments
class = {symm | clariion | hitachi | hpxp | ess | all}.. Limits the command to the specified type of storage system all specifies all storage-system types The default is all (You can change the default using the PP_DEFAULT_STORAGE_SYS environment variable. .)
IF class is specified along with hba and / or dev, the command is applied to pats.force attempts to restore dead volumes without prompting for confirmation.
hba = hba # | all Limits restoration to paths from the specified HBA hba # is a number in the Host Bus Adapters ### column of the powermt display dev output all specifies all HBAs under PowerPath control The default is all....
(Adapter Can Be Used Instead of HBA. Adapter is Included Only for Compatibility with prior PowerPath Releases. Use HBa INSTEAD.)
DEV = PATH | DEVICE | All Limits Restoration to the specified path or all paths to the specified powerpath device. All specifies all paths to all deflicies. The default is all.
Powermt Save [file = pathname]
By default, powermt save saves the PowerPath settings in the file powermt.custom. You can specify an alternate file. For each configured logical device, powermt save records its serial numbers, policy, priority, write throttle setting, write throttle queue depth, and Pseudo Device Name. for Each Configured Path (Alive Or Dead), PowerMt Save Records Its Mode. for
Sunos 5.8 Last Change: January, 2004 22
User Commands PowerMt (1)
Each Storage System Class, Powermt Save Records ITS Period AutoStore Setting.
For Performance-Tuning Purposes, You Can Use Powermt Save to Save Different Configurations Under Different FileNames.
A Saved Configuration Can Be Reloaded with Powermt LOAD.
Arguments
File = pathname Full Pathname of the file in which to save the configuration. PowerPath Creates the file if it@less is /etc/powermt.custom.
If a configuration is saved with powermt save under the default filename, the configuration loads automatically at boot time. (The exception is AIX, which always loads default settings at boot time.) If the default filename is not used, the configuration does not load Automatically At Boot Time; In this case, you mustidide the configuration manually with powermt loading.
IF a Configuration IS Saved Under The Default FileName, Any Previously Existing Configuration File Is Overwritten WITHOUT NOTES.
THE Configuration File Is Saved With Read-Only Access for root and no access for ta.
CAUTION: Do Not Modify The Configuration File Manually.
Powermt Set Periodic_AutoRestore = ON | OFF [Class = {SYMM | CLARION | HITACHI | HPXP | ESS | All}]
Powermt Set Periodic_AutoRestore Enables or Disables PowerPath's Periodic AutoStore Feature.
When periodic autorestore is on, PowerPath periodically tests dead paths and, if they are no longer dead, restores them to service. Even when periodic autorestore is off, path testing continues under certain conditions, and automatic path restoration continues to occur based on the results FOR DETAILS ABOUT Periodic AutoStore, Refer to The PowerPath Product Guide.sunos 5.8 Last Change: January, 2004 23
User Commands PowerMt (1)
To DETERMINE The Periodic AutoStore Setting, Use Powermt Display Options.
Arguments
ON | OFF ON Enables Periodic AutoStore. Off Disables it. The default is on.
class = {symm | clariion | hitachi | hpxp | ess | all}.. Limits the command to the specified type of storage system all specifies all storage-system types The default is all (You can change the default using the PP_DEFAULT_STORAGE_SYS environment variable. .)
Powermt Set Mode = Active | Standby | Hitachi | HPXP | Ess | All}] [HBA = HBA # | all] [dev = PATH | Device | all]
Powermt Set Mode Sets Paths To Active or Standby Mode.
For most applications, the best performance is achieved by designating all paths to a PowerPath device as active. By using this command selectively, however, the path usage of PowerPath devices can be controlled. This is helpful if you do not want I / O for One PowerPath Device to Affect The Performance of Another PowerPath Device.
Arguments
Mode = Active | Standby Determines WHETHER A PATH IS AVAILABLE for I / O OR HELD IN RESERVE. I / O Is Delivered to a path. if you designate a path as active, it is contgenuously scheduled for I / O according to the load balancing and failover policy in use. in standby mode, the path is held in reserve.Being set to standby does not mean a path will not be used. It only means the weight of the path is heavily adjusted to preclude its Use in normal operations.
class = {symm | clariion | hitachi | hpxp | ess | all}.. Limits the command to the specified type of storage system all specifies all storage-system types The default is all (You can change the default using the PP_DEFAULT_STORAGE_SYS environment variable. .)
Sunos 5.8 Last Change: January, 2004 24
User Commands PowerMt (1)
IF class is specified along with hba and / or dev, the command is applied to paths....
hba = hba # |. all Sets the mode for paths from the specified HBA hba # is a number in the Host Bust Adapters ### column of powermt display dev and powermt display paths output all specifies all HBAs under PowerPath control The default.. IS all.
(Adapter Can Be Used Instead of HBA. Adapter is Included Only for Compatibility with prior PowerPath Releases. Use HBa INSTEAD.)
dev = path | device | all Sets the mode for the specified path or all paths to the specified PowerPath device all specifies all paths to all devices The default is all.powermt set policy = policy [class = {symm |.. clariion | hitachi | hpxp | Ess | All}] [dev = device | all]
Powermt Set Policy Sets The Load Balancing and Failover Policy for PowerPath Devices.
Arguments
Policy = policy sets the load balancing and failover Policy to One of the Following VALUES:
ad Adaptive. I / O requests are assigned to paths based on an algorithm that takes into account path load and logical device priority. This policy is valid only for Hitachi Lightning, HP xp, and IBM ESS storage systems and is the default policy for them ON Platforms with a valid powerpath license.
bf Basic failover. Load balancing is not in effect. I / O routing on failure is limited to one HBA and one port on each storage processor. When a host boots, it designates one path (through one interface) for all I / O. If an I / O is issued to a logical device that can not be reached via that path (that is, the I / O can not reach that logical device through the device's assigned interface), a trespass is performed: the logical device is assigned to the Other interface.
SUNOS 5.8 Last Change: January, 2004 25
User Commands powermt (1) This policy protects against SP and back-end failures and allows non-disruptive upgrades to work when running PowerPath without a license key. It does not protect against HBA or host loop failures.
.
co CLARiiON optimization (listed in powermt display output as CLAROpt). I / O requests are assigned to paths based on an algorithm that takes into account path load and the priority you set with powermt set policy.
...............................
lb Least blocks. Load balance is based on the number of blocks in the pending I / Os. I / O requests are assigned to the path with the smallest burden in terms of blocks, regardless of the number of requests involved.
LOAD Balance is based on the number of pending I / OS. I / O Requests are assigned to the path with the smallest number of requests, Regardless of Total Block Volume.
NR no redirect. Neither Load Balancing NOR Failover Is In Effect. IF NR IS SET ON A Failed Path and A Native Device IS Used, I / O Errors Will Occur When I / O Is Directed To That Path. if One or More Paths IS failed and nr is set, data I / O errors can occur.This policy is valid only for Symmetrix, Hitachi Lightning, HP xp, and IBM ESS storage systems and is the default policy for them on platforms without a valid PowerPath license.
re Request. For native devices, uses the path that would have been used if PowerPath were not installed. For pseudo devices, uses one arbitrary path for all I / O. For all devices, failover is in effect, but load balancing is
Sunos 5.8 Last Change: January, 2004 26
User Commands PowerMt (1)
NOT.
RR ROBIN. I / O Requests Are Assigned to Each Available Path in Rotation.
so Symmetrix optimization (listed in powermt display output as SymmOpt). I / O requests are assigned to paths based on an algorithm that takes into account path load and the priority you set with powermt set policy.
This Policy Is Valid Only for Symmetrix Storage Systems and is The Default Policy for Themount.
class = {symm | clariion | hitachi | hpxp | ess | all}.. Limits the command to the specified type of storage system all specifies all storage-system types The default is all (You can change the default using the PP_DEFAULT_STORAGE_SYS environment variable. .) IF class is specified along with hba and / or dev, the command is applied to patHs That Meet All Specified CONSTRAINTS.
DEV = Device | All Limits The Policy Change to The Specified PowerPath Device. All Specifies All PowerPath Devices. The default is all.
If neither class nor dev is specified, and the specified policy does not apply to any storage system in the environment (for example, if the bf policy is specified, but there are no CLARiiON storage systems), no policy setting occurs, and no error Message Appears.
Powermt set priority = priority # [class = {symm | claraiion | Hitachi | HPXP | ESS | all}] [dev = | device | all]
Powermt Set Priority Sets The I / O Priority For PowerPath Devices. I / O To Lower Priority Logical devices TENDS TOBE DELIVERED TO PATHS NOT USED BY HIGHER Priority Logical Devices.
This command is relevant only for those PowerPath devices whose load balancing policy and failover is set to Symmetrix optimization, CLARiiON optimization, or Adaptive. Although it sets priorities for PowerPath devices with other policies, it has no effect on load balancing on those devices. If The Policy for a Given
Sunos 5.8 Last Change: January, 2004 27
User Commands powermt (1) device is anything other than Symmetrix optimization, CLARiiON optimization, or Adaptive when a priority for that device is set, the priority setting has no effect; if, however, the policy for that device is later changed to Symmetrix optimization .
Setting a high priority for several PowerPath devices improves their I / O performance at the expense of the remaining PowerPath devices, while otherwise maintaining the best possible load balance across all paths. For example, to favor certain applications over others, assign a higher priority to The PowerPath Devices Used by That Application.
Arguments
PRIORITY # integer in the Range 0 - 10. The default is 0. The Higher The Number, The Higher The Priority. The Same Priority Negates The Effect of The Command.
class = {symm | clariion | hitachi | hpxp | ess | all}.. Limits the command to the specified type of storage system all specifies all storage-system types The default is all (You can change the default using the PP_DEFAULT_STORAGE_SYS environment variable. .)
IF class is specified along with hba and / or dev, the command is applied to paths....
DEV = Device | All sets the priority for the specified powerpath device. All specifies all powerpath defices. The default is all.powermt set transparent = on | OFF [dev = | device | all]
Note: This Command Works Only On Symmetrix Systems.
Powermt Set Transparent Enables or Disables PowerPath's Load Balancing and Failover Features on Specified Devices.
Powermt Set Transparent Is Included Only For Compatibility IPTEPATH Releases. Use PowerMt Set Policy Instead, As INDBELOW:
Sunos 5.8 Last Change: January, 2004 28
User Commands PowerMt (1)
- Powermt Set Transparent = on is equivalent to powermt set policy = NR
- Powermt Set Transparent = Off Is Equivalent to PowerMt Set Policy = SO.
Arguments
ON | OFF On Disables Load Balancing and Failover. Off Enables these Features. The default is off.
DEV = Device | All Limits The Change to the Specified PowerPath Device. All Specifies All PowerPath Devices. The default is all.
Powermt set write_throttle = on | OFF [class = symm] [dev = device | all]
Powermt Set Write_throttle Enables or Disables I / O WRITETTTLING To The Specified PowerPath Device (s).
This Command Is Available Only With Symmetrix Storage Systems.
Write throttling is enabled to limit the number of queued writes to the common I / O queue in the HBA driver; instead, the writes are queued in PowerPath As a result, read requests do not get delayed behind a large number of write requests.. Write Throttling Is Disabled by Default.Arguments
ON | Off on Enables WRITTTLING TO The Specified PowerPath Device. Off Disables It. for New PowerPath Devices, Write THROTTLING IS set to off by default.
Class = Symm Limits The Command To The Specified Type of Storage System.
IF class is specified along with hba and / or dev, the command is applied to paths....
DEV = Device | All Limits The Change To The Logical Device Associated with The Specified Device. All Specifies All Logical Devices. The default is all.
SUNOS 5.8 Last Change: January, 2004 29
User Commands PowerMt (1)
(Volume_Dev can be used instead of dev. Volume_dev is include Only for Compatibility with prior PowerPath Releases. Use dev instead.)
Powermt set write_throttle_queue = queue_depth # [class = symm] [dev = path | device | all]
powermt set write_throttle_queue sets the write throttling queue depths for a storage system port connected to a specified device. The queue depth setting limits the number of writes to all devices enabled for write throttling which can be outstanding (from PowerPath's perspective) on the storage system port ............................ ..
Arguments
queue_depth # Threshold value that limits the number of I / Os sent / written to a port The intent of setting this value is to prevent write operations from delaying the completion of read operations The value of queue_depth # must be in the range 1.. - .........................
Class = Symm Limits The Command To The Specified Type of Storage System.
IF class is specified along with hba and / or dev, the command is applied to paths....
dev = path | device | all Limits the change to the storage system port associated with the specified path, or the port connected to the specified device all specifies all storage-system ports to all devices The default is all...
(Port_DEV CAN BE USED INSTEAD OF DEV. Port_DEV IS INCLUDED Only For Compatibility WITH PRIOR POWERPATH Releases. Use dev instead.)
Powermt unmanage {dev = device | class = {hitachi | hpxp | ess}}
Sunos 5.8 Last Change: January, 2004 30User Commands PowerMt (1)
Powermt Unmanage Excludes a Specified Logical Device or Storage System Class from PowerPath Management.
When applied to a storage system class, powermt unmanage succeeds in completely removing the class from PowerPath control only after you stop applications with open devices of the specified class. If you can not stop applications, you may need to reboot the host.
.
A powermt unmanage class = operation is legal only if the class's status is managed or unmanage_incomplete. If the class status is manage_incomplete, the manage operation must be completed, or the host rebooted, before powermt unmanage succeeds. The powermt display options command displays the status Of a class.
When Applied to a Specific Device, Powermt Unmanage Differs from Powermt Remove:
- Powermt Unmanage Applies To The Entire Device, Not Just The Specified Path.
- The Effect of Powermt Unmanage IS Persistent: Powermt Config Does Not Restore The Device To PowerPath Control.
Arguments
DEV = Device Specifies The Pathname of a Logical Device To Be Excluded from PowerPath Management.
Class = {Hitachi | HPXP | Ess} Specifier The Storage System Class To Be Excluded from PowerPath Management.
Powermt Update LUN_NAMES
powermt update lun_names causes PowerPath to retrieve the latest user-assignable CLARiiON LUN names. A user- assignable LUN name is a character string that a user or system manager associates with a LUN and assigns through Navisphere.powermt version
SUNOS 5.8 Last Change: January, 2004 31
User Commands PowerMt (1)
Powermt Version Prints The Number of The PowerPath Version for Which Powermt Was Created.
EXIT STATUS All Powermt Commands Return 0 to The User Process On Success; 1 On Error.
Files /etc/powermt.custom default pathname of the configuration file.
See Also Emcpminor (1), EMCPREG (1), EMCPUPGRADE (1), PowerCF (1), PowerProtect (1), PowerPath Product Guide
Sunos 5.8 Last Change: January, 2004 32
