Launching soon: The world's first vendor agnostic bug scrubLearn more & join waitlist
OPERATIONAL DEFECT DATABASE
...
...
Document Version Release Date Details 2 April 6, 2023 Revised the title and the last paragraph of the Resolution section. 1 March 30, 2021 Original Document Release. The whitepaper Guidelines for tuning HP-UX 11i v3 to handle transient SAN path failures , states that the LUN attribute "esd_secs," that holds the time credit for an I/O operation across different retries, can be tuned to have better resilience over transient LUN path failures. In an Integrity Virtual Machine (HPVM) environment, N_Port ID Virtualization (NPIV) drives, unlike virtual drives, have multipathing control within the guest. Therefore, the guest should be able to tune "esd_secs" for resilience over transient path failures for these NPIV drives. The following may occur: "/sbin/init.d/hpvmguest start" and "/sbin/init.d/hpvmguest stop" will overwrite any pre-existing "esd_secs" setting with the value HPVMGUEST_ESD_SECS_VIRT_VAL (=300) on an HPVM vPar guest, for both NPIV and non-NPIV drives. "/sbin/init.d/hpvmguest start" and "/sbin/init.d/hpvmguest stop"will overwrite any pre-existing "esd_secs" setting with the value HPVMGUEST_ESD_SECS_DFLT_VAL (=30) on the HPVM host (VSP), for all drives. Any customized parameter in /etc/rc.config.d/hpvmguest, such as HPVMGUEST_ESD_SECS_VIRT_VAL and HPVMGUEST_ESD_SECS_DFLT_VAL are not adopted by /sbin/init.d/hpvmguest script. Below is an example of the top bullet listed above: On a vPar guest where esd_secs has been tuned manually for drive instance 12 to a value other than the default (30), the tuned esd_secs will become 300 after a guest reboot as follows: # scsimgr save_attr -Cdisk -I12 -a esd_secs=10 Value of attribute esd_secs saved successfully # scsimgr get_attr -Cdisk -I12 -a esd_secs SCSI ATTRIBUTES FOR LUN : disk12 name = esd_secs current = 10 default = 30 saved = 10 < Reboot > # scsimgr get_attr -Cdisk -I12 -a esd_secs SCSI ATTRIBUTES FOR LUN : disk12 name = esd_secs current = 300 default = 30 saved = 10 Note : The change to "esd_secs" is not called out in the hpvmguest init script output nor in syslog, though /var/adm/scsimgr.log will keep a record of the scsimgr command performed by the script to overwrite the value.
Any HPE Integrity system running HPVM 6.30.5, 6.40 or 6.50.
For HPVM 6.50, the following patch has been released to address the above issues: PHSS_44764 11.31 HPVM B.06.50 vmGuestLib PATCH 1. Defect QXCR1001744289 Default esd_secs or other guest configuration parameters are not picked from /etc/rc.config.d/hpvmguest and even manually configured values of esd_secs for drives get overwritten by system defaults at startup. 2. Defect QXCR1001747563 VSP defaults parameters as esd_secs for drives get overwritten to system defaults at vsp startup. IMPORTANT : After installing the above HPVM 6.50 patch, the following configuration steps may be performed on the HPVM guests. Below is relevant configurable parameters in /etc/rc.config.d/hpvmguest and details for the configuration steps. 1. HPVMGUEST_NPIV_ESD_SECS_MANUAL_CONFIG_ENABLE=0 It is a switch to enable/disable manual tuning of esd_secs for NPIV disks. By default, it is set to 0, meaning that manual tuning of esd_secs is disabled. Setting it to 1 tells HPVM that esd_secs for NPIV drives may have been customized so HPVM startup should not tamper with esd_secs values set for NPIV drives. 2. HPVMGUEST_ESD_SECS_VIRT_VAL=300 It is the designated default value of "esd_secs" for all VM guest drives and is set to 300 seconds, considering the overhead associated with virtualization for guest IOs. This value is not expected to be changed as it is a proven value that should avoid prematurely timing out a guest I/O. At HPVM guest startup, if HPVMGUEST_NPIV_ESD_SECS_MANUAL_CONFIG_ENABLE=0, esd_secs will be set to this value (300s) for all guest disks, including both NPIV and non-NPIV drives. However, if HPVMGUEST_NPIV_ESD_SECS_MANUAL_CONFIG_ENABLE=1, the startup script will leave the esd_secs of NPIV disks untouched. As such, previously customized esd_secs values for NPIV drives will be retained. 3. HPVMGUEST_ESD_SECS_DFLT_VAL=30 It is the designated default value of "esd_secs" for HPVM host/VSP. On an HPVM host, when HPVM is stopped or removed, esd_secs for all VM guest drives, including both NPIV and non-NPIV disks, will be reset to this value (30s). Configuration steps after applying the patch fix to address defect QXCR1001744289 on HPVM guests: If tuning esd_secs for NPIV drives for customized multipathing control on the guest, follow the steps below. a. In /etc/rc.config.d/hpvmguest script, set HPVMGUEST_NPIV_ESD_SECS_MANUAL_CONFIG_ENABLE to 1 b. Check esd_secs using scsimgr(1M) for the corresponding NPIV drives as follows: # scsimgr get_attr -D /dev/rdisk/disk5 -a esd_secs SCSI ATTRIBUTES FOR LUN : /dev/rdisk/disk5 name = esd_secs current = 300 default = 300 saved = c. Set esd_secs to the desired value using scsimgr(1M) for thecorresponding NPIV drives as follows: # scsimgr save_attr -D /dev/rdisk/disk5 -a esd_secs=20 Value of attribute esd_secs saved successfully # scsimgr get_attr -D /dev/rdisk/disk5 -a esd_secs SCSI ATTRIBUTES FOR LUN : /dev/rdisk/disk5 name = esd_secs current = 20 default = 300 saved = 20 Note : Specify "save_attr" in the first scsimgr command in setting esd_secs for the tuned value to be persistent across reboots. Otherwise, esd_secs will be set to the default (300 in the above example) on the next guest startup. PHSS_44619 (HPVM B.06.30.05 vmGuestLib patch) and PHSS_44745 (HPVM B.06.40 vmGuestLib patch) have been released to address the above issues. Note that HPVM 6.30.5 and HPVM 6.40 have both reached end of support. HPE recommends upgrading to HPVM 6.50 as soon as possible. RECEIVE PROACTIVE UPDATES : Receive support alerts (such as Customer Advisories), as well as updates on drivers, software, firmware, and customer replaceable components, proactively via e-mail through HPE Subscriber"s Choice. Sign up for Subscriber"s Choice at the following URL: Proactive Updates Subscription Form. NAVIGATION TIP : For hints on navigating HPE.com to locate the latest drivers, patches, and other support software downloads for HPE systems and Options, refer to the Navigation Tips document . SEARCH TIP : For hints on locating similar documents on HPE.com, refer to the Search Tips Document . To search for additional advisories related to HP-UX 11iv3, use the following search string: +Advisory +ProLiant -"Software and Drivers" +HP-UX 11iv3