Fix Readme
Abstract
Downloads for Workload Partition Manager for AIX
Content
IBM PowerVM Virtual I/O Server
Contents
This Readme contains installation and other information about VIOS Update Release 2.2.5.30
Package information
PACKAGE: Update Release 2.2.5.30
IOSLEVEL: 2.2.5.30
| VIOS level is | NIM Master level must be equal to or higher than |
|---|---|
| Update Release 2.2.5.30 | AIX 6100-09-10 or AIX 7100-05-01 or AIX 7200-02-01 |
In June 2015, VIOS introduced the minipack as a new service stream delivery vehicle as well as a change to the VIOS fix level numbering scheme. Please refer to the VIOS Maintenance Strategy here for more details regarding the change to the VIOS release numbering scheme.
General package notes
Be sure to heed all minimum space requirements before installing.
Review the list of fixes included in Update Release 2.2.5.30.
To take full advantage of all the function available in the VIOS, it may be necessary to be at the latest system firmware level. If a system firmware update is necessary, it is recommended that the firmware be updated before you update the VIOS to Update Release 2.2.5.30.
Microcode or system firmware downloads for Power Systems
The VIOS Update Release 2.2.5.30 includes the IVM code, but it will not be enabled on HMC-managed systems. Update Release 2.2.5.30, like all VIOS Update Releases, can be applied to either HMC-managed or IVM-managed VIOS.
Update Release 2.2.5.30 updates your VIOS partition to ioslevel 2.2.5.30. To determine if Update Release 2.2.5.30 is already installed, run the following command from the VIOS command line:
$ ioslevel
If Update Release 2.2.5.30 is installed, the command output is 2.2.5.30.
For additional details, including known capabilities, limitations, and additional install considerations, as well as, some additional instructions, please reference the readme for 2.2.5.10 located here.
Installation information
Pre-installation information and instructions
Please ensure that your rootvg contains at least 30GB and that there is at least 4GB free space before you attempt to update to Update Release 2.2.5.30. Run the lsvg rootvg command, and then ensure there is enough free space.
Example:
$ lsvg rootvg VOLUME GROUP: rootvg VG IDENTIFIER: 00f6004600004c000000014306a3db3d VG STATE: active PP SIZE: 64 megabyte(s) VG PERMISSION: read/write TOTAL PPs: 511 (32704 megabytes) MAX LVs: 256 FREE PPs: 64 (4096 megabytes) LVs: 14 USED PPs: 447 (28608 megabytes) OPEN LVs: 12 QUORUM: 2 (Enabled) TOTAL PVs: 1 VG DESCRIPTORS: 2 STALE PVs: 0 STALE PPs: 0 ACTIVE PVs: 1 AUTO ON: yes MAX PPs per VG: 32512 MAX PPs per PV: 1016 MAX PVs: 32 LTG size (Dynamic): 256 kilobyte(s) AUTO SYNC: no HOT SPARE: no BB POLICY: relocatable PV RESTRICTION: none INFINITE RETRY: no
Upgrading from VIOS version lower than 2.1.0
If you are planning to update a version of VIOS lower than 2.1, you must first migrate your VIOS to VIOS version 2.1.0 using the Migration DVD. After the VIOS is at version 2.1.0, the Update/Fixpack 2.2.5.10 must be applied to bring the VIOS to the latest Fix Pack VIOS 2.2.5.10 level. The Update Release 2.2.5.30 can then be applied to bring the VIOS to the latest level.
Note that with this Update Release 2.2.5.30, a single boot alternative to this multiple step process is available to NIM users. NIM users can update by creating a single, merged lpp_source that combines the contents of the Migration DVD with the contents of this Update Release 2.2.5.30.
A single, merged lpp_source is not supported for VIOS that uses SDDPCM. However, if you use SDDPCM, you can still enable a single boot update by using the alternate method described at the following location:
SDD and SDDPCM migration procedures when migrating VIOS from version 1.x to version 2.x
After the VIOS migration is complete, from 1.X to 2.X, you must set the Processor Folding, described here under "Migration DVD":
Instructions to disable Processor Folding are detailed at the link below.
See the "Migration DVD" section:
Virtual I/O Server support for Power Systems
Upgrading from VIOS version 2.1.0 and above
VIOS Update Release 2.2.5.30 may be applied directly to VIOS level between 2.2.5.0 and 2.2.5.10.
On a VIOS level between 2.2.1.1 and 2.2.4.x, a Single Step update procedure can be used to update to level 2.2.5.30.
Instructions: Single step update
To update to Update Release 2.2.5.30 from a level between 2.2.1.1 and 2.2.4.x in a single step, put the 2.2.5.10 updates in the same location as your 2.2.5.30 updates and do the update using the updateios command.
Before installing the VIOS Update Release 2.2.5.30
Warning: The update may fail if there is a loaded media repository.
Instructions: Checking for a loaded media repository
To check for a loaded media repository, and then unload it, follow these steps.
- To check for loaded images, run the following command:
$ lsvopt
The Media column lists any loaded media. - To unload media images, run the following commands on all Virtual Target Devices that have loaded images.
$ unloadopt -vtd <file-backed_virtual_optical_device >
- To verify that all media are unloaded, run the following command again.
$ lsvopt
The command output should show No Media for all VTDs.
Instructions: Migrate Shared Storage Pool Configuration
The Virtual I/O Server (VIOS) Version 2.2.2.1 or later, supports rolling updates for SSP clusters. The VIOS can be updated to Update Release 2.2.4.20 using rolling updates.
Version specific instructions: Version 2.2.1.3 or earlier.
A cluster that is created and configured on a VIOS Version at 2.2.1.3 or earlier must be migrated to version 2.2.1.4 or 2.2.1.5 prior to utilizing rolling updates. This allows the user to keep their shared storage pool devices.
Version specific instructions: Version 2.2.1.4 or later.
The rolling updates enhancement allows the user to apply Update Release 2.2.5.30 to the VIOS logical partitions in the cluster individually without causing an outage in the entire cluster. The updated VIOS logical partitions cannot use the new SSP capabilities until all VIOS logical partitions in the cluster are updated.
To upgrade the VIOS logical partitions to use the new SSP capabilities, ensure that the following conditions are met:
- All VIOS logical partitions must have VIOS Update Release version 2.2.1.4 or later installed.
- All VIOS logical partitions must be running. If any VIOS logical partition in the cluster is not running, the cluster cannot be upgraded to use the new SSP capabilities.
Instructions: Verify the cluster is running at the same level as your node.
- Run the following command:
$ cluster -status -verbose
- Check the Node Upgrade Status field, and you should see one of the following terms:
UP_LEVEL: This means that the software level of the logical partition is higher than the software level the cluster is running at.
ON_LEVEL: This means the software level of the logical partition and the cluster are the same.
Installing the Update Release
There is now a method to verify the VIOS update files before installation. This process requires access to openssl by the 'padmin' User, which can be accomplished by creating a link.
Instructions: Verifying VIOS update files.
To verify the VIOS update files, follow these steps:
- $ oem_setup_env
- Create a link to openssl
# ln -s /usr/bin/openssl /usr/ios/utils/openssl - Verify the link to openssl was created
# ls -alL /usr/bin/openssl /usr/ios/utils/openssl - Verify that both files should display similar owner and size
- # exit
Use one of the following methods to install the latest VIOS Service Release. As with all maintenance, you should create a VIOS backup before making changes.
If you are running a Shared Storage Pool configuration, you must follow the steps in Migrate Shared Storage Pool Configuration.
Note : While running 'updateios' in the following steps, you may see accessauth messages, but these messages can safely be ignored.
Version specific warning: Versions between 2.2.1.1 and 2.2.4.x
You must put the 2.2.5.10 and 2.2.5.30 on the same location to apply updates in single step. The single step approach fixes an update problem with the builddate on bos.alt_disk_install.boot_images fileset.
Version specific warning: Version 2.2.2.1, 2.2.2.2, 2.2.2.3, or 2.2.3.1
You must run updateios command twice to get bos.alt_disk_install.boot_images fileset update problem fixed.
Run the following command after the step of "$ updateios –accept –install –dev <directory_name >" completes.
$ updateios –accept –dev <directory_name >
Depending on the VIOs level, one or more of the LPPs below may be reported as "Missing Requisites", and they may be ignored.
MISSING REQUISITES:
X11.loc.fr_FR.base.lib 4.3.0.0 # Base Level Fileset
bos.INed 6.1.6.0 # Base Level Fileset
bos.loc.pc.Ja_JP 6.1.0.0 # Base Level Fileset
bos.loc.utf.EN_US 6.1.0.0 # Base Level Fileset
bos.mls.rte 6.1.x.x # Base Level Fileset
Warning: If VIOS rules have been deployed.
When the VIOS is the updated, some of the current rules may revert to the system defaults. Additionally, those changes may have been applied to the system.
If you notice this issue, the default rules can be re-deployed and captured to current rules by running the commands below.
$ rules -o deploy -d
$ rules -o capture
Note: This will overwrite any customized rules in the current rules file.
Applying updates
Warning: If the target node to be updated is part of a redundant VIOS pair, the VIOS partner node must be fully operational before beginning to update the target node.
Note: For VIOS nodes that are part of an SSP cluster, the partner node must be shown in 'cluster -status ' output as having a cluster status of OK and a pool status of OK. If the target node is updated before its VIOS partner is fully operational, client LPARs may crash.
Note: The current level of the VIOS must be 2.2.2.1 or later if you use the Share Storage Pool.
Instructions: Applying updates to a VIOS
- Log in to the VIOS as the user padmin.
- If you use one or more File Backed Optical Media Repositories, you need to unload media images before you apply the Update Release. See details here.
- If you use Shared Storage Pools, then Shared Storage Pool Services must be stopped.
$ clstartstop -stop -n <cluster_name > -m <hostname >
- To apply updates from a directory on your local hard disk, follow the steps:
To apply updates from a remotely mounted file system, and the remote file system is to be mounted read-only, follow the steps:
- Mount the remote directory onto the Virtual I/O Server:
$ mount remote_machine_name:directory /mnt
The update release can be burned onto a CD by using the ISO image file(s). To apply updates from the CD/DVD drive, follow the steps:
- Place the CD-ROM into the drive assigned to VIOS.
- Create a directory on the Virtual I/O Server.
$ mkdir <directory_name > - Using ftp, transfer the update file(s) to the directory you created.
- Mount the remote directory onto the Virtual I/O Server:
- Commit previous updates by running the updateios command
$ updateios -commit
- Verify the updates files that were copied. This step can only be performed if the link to openssl was created.
$ cp <directory_path >/ck_sum.bff /home/padmin
$ chmod 755 </home/padmin>/ck_sum.bff
$ ck_sum.bff <directory_path >
If there are missing updates or incomplete downloads, an error message is displayed. - Apply the update by running the updateios command
$ updateios -accept -install -dev <directory_name >
- To load all changes, reboot the VIOS as user padmin .
$ shutdown -restart
Note: If shutdown –restart command failed, run swrole –PAdmin in order for padmin to set authorization and establish access to the shutdown command properly.
- If cluster services were stopped in step 3, restart cluster services.
$ clstartstop -start -n <cluster_name > -m <hostname >
- Verify that the update was successful by checking the results of the updateios command and by running the isolevel command, which should indicate that the ioslevel is now 2.2.4.20.
$ ioslevel
Post-installation information and instructions
Instructions: Checking for an incomplete installation caused by a loaded media repository
After installing an Update Release, you can use this method to determine if you have encountered the problem of a loaded media library.
Check the Media Repository by running this command:
$ lsrep
If the command reports: "Unable to retrieve repository date due to incomplete repository structure," then you have likely encountered this problem during the installation. The media images have not been lost and are still present in the file system of the virtual media library.
Running the lsvopt command should show the media images.
Instructions: Recovering from an incomplete installation caused by a loaded media repository
To recover from this type of installation failure, unload any media repository images, and then reinstall the ios.cli.rte package. Follow these steps:
- Unload any media images
$ unloadopt -vtd <file-backed_virtual_optical_device>
- Reinstall the ios.cli.rte fileset by running the following commands.
To escape the restricted shell:
$ oem_setup_env
To install the failed fileset:
# installp –Or –agX ios.cli.rte –d <device/directory >
To return to the restricted shell:
# exit - Restart the VIOS.
$ shutdown –restart
- Verify that the Media Repository is operational by running this command:
$ lsrep
Additional information
For additional details, including known capabilities, limitations, and additional install considerations, as well as some additional instructions, please reference the Readme for 2.2.5.10 located here.
Fixes included in this release
This version will include all fixes found in all previous 2.2.5.X releases. The fixes for the previous release can be found here.
| APAR | Description |
|---|---|
| IV89340 | 2017 olson timezone database update |
| IV89961 | Create 6.1 IPPs |
| IV89995 | NO SEA FAILOVER ON LNCENT_PLINK_DOWN IN VF MODE |
| IV90612 | SETTING SSP ALERT ON NON-DBN CAUSES MESSAGE STORM |
| IV91185 | VIOSBR RETURN MESSAGE NOT EXPLICIT ABOUT ADDITIONAL STEPS |
| IV91312 | RACE CONDITION FOR IP_MROUTER" LOCK INSIDE "IP_MFORWARD" ROUTINE |
| IV92399 | VIOS CM DAEMON CAN PERFORM EXTRA REPOPULATES IN SOME ODD STATES |
| IV92425 | DK_STAT NOT UPDATED FOR SSP LU |
| IV92465 | CHUSER COMMAND CORRUPTS AFFECTED LDAP GROUPS MEMBER CACHE |
| IV92848 | ALT_DISK_MKSYSB OF MULTIBOS MKSYSB PLACES FILES IN WRONG PATH |
| IV93029 | LDD ERROR "CANNOT FIND LIBTESTLIB.SO" FOR WHITESPACE IN LIBPATH |
| IV93032 | PROBEVUE STACK DEPTH OFTEN INCOMPLETE. |
| IV93143 | SECLDAPCLNTD CORE DUMPS WHEN SERVER GOES DOWN |
| IV93214 | IN SPP CODE IMPROVE ERROR HANDLING FOR TRAVERSAL PHASE OF RMDISK |
| IV93290 | DBX RUN COMMAND DOES NOT PASS -N ARGUMENT TO APP IF USING BASH |
| IV93292 | Incorrect attribute description. |
| IV93455 | multiple nimadm operations fails sometimes |
| IV93504 | Pool meta-root replica set update in infinite retry. |
| IV93561 | WHO FAILS TO HANDLE HUGE UTMP FILE NAME |
| IV93600 | PERFSTAT_SSP ERROR MESSAGE ON THE CONSOLE |
| IV93732 | ICM KERNEL EXTENSION LEAKING TX MAD BUFFERS |
| IV93786 | MKAUTHKEYS FAILS WHEN NON DEFAULT PWD_ALGORITHM IS ENABLED |
| IV93871 | DUPLICATE NIM CLIENT OBJECTS AFTER SWITCHING TO ALTERNATE MASTER |
| IV93873 | NIS HOME DIRECTORY NOT OBTAINED LOCALLY |
| IV94028 | Recovery deadlock during lock rebuild for new MFS |
| IV94032 | su retains krb5 pag value |
| IV94034 | curt error message needs correction. |
| IV94062 | fcstat -z does not clear statistics from virtual |
| IV94087 | change "lsitab failed" message to clarify that it's a warning. |
| IV94162 | default rules for vendor rules lost after VIOS update |
| IV94179 | updating wrap plug PN for PCIE 8GB 4port Fibre Channel adapter |
| IV94263 | LPM lun level validation fails to get Page 83 Inquiry data |
| IV94369 | HBAapi GetFcpTargetMappingV2 may fail after LPM |
| IV94370 | XARGS COMMAND DOES NOT HANDLE -L PARAMETER CORRECTLY |
| IV94416 | LDD FAILS TO FIND CORRECT DEPENDENCY FROM LIBRARY |
| IV94438 | vios update and rulescfgset can save/deploy incorrect settings |
| IV94441 | System crash During USB Device Disconnect |
| IV94442 | MKDVD WILL FAIL WITH PID ENVIRONMENT VARIABLE SET |
| IV94449 | VM recovery fails if VSCSI disk attribute has special characters |
| IV94587 | Hang in the init command while respawning |
| IV94793 | MKSYSB -T WILL ERROR IF NFS MOUNT EXISTS IN NON-ROOTVG |
| IV94893 | Update SSP maxreadservicetime/maxwriteservicetime unit in pcm |
| IV94940 | VNIC queue negotiation fix |
| IV95008 | nmon reports extra columns in data section for SEACHPHY |
| IV95102 | system crash when using procfs for processes closing many files |
| IV95122 | tag file location changes for ILMT tracking |
| IV95155 | LDD COMMAND ERRORS WITH WHITESPACES |
| IV95179 | set_adapter fails if other adapter is not configured with LUNs |
| IV95180 | Network drivers face abend_trap in Ipv6 tx_path. |
| IV95204 | NPIV FCP command gets truncated in VIOS for some physical HBAs. |
| IV95247 | Customer SSP cluster may hang during recovery |
| IV95348 | System may crash during I/O striped LVs with Infinite Retry |
| IV95350 | AggregatedMetrics is blank for big cluster |
| IV95372 | VLAN tagged largesend packets are dropped for some adapters |
| IV95750 | TRUSTED EXECUTION BEING ON MAY RESULT IN INVALID SYSLOG MESSAGES |
| IV95753 | Correct driver flags in entstat output for SEA/etherchannel |
| IV96038 | VIO Server hits CORE_DUMP during create a vnic backing device. |
| IV96144 | When no profile is applied viosecure -c gives error |
| IV96185 | Mirrored SSP, translation is not updated on partition swap |
| IV96336 | pax allows archive filenames > 100 chars |
| IV96479 | The RMC State of VIOS on Novalink is busy |
| IV96494 | WPAR LSATTR -EL SYS0 SHOWS DUPLICATE ATTRIBUTES AFTER LPM |
| IV96496 | System crash during pcishient adapter configuration |
| IV96535 | init_br_chrp miscalculates bootlv offset for second lv mirror |
| IV96553 | Undetected data loss after storage errors with certain adapters |
| IV96641 | Spurious error log from vfchost adapter |
| IV96693 | alt_disk_copy -T invalid FS_JFS2_BS sizes |
| IV96793 | Crash during shrink @ dbBackSplit. |
| IV96877 | updating adapter via port Y fails after port X passes |
| IV96878 | lpm fails with parallel cache_mgt operations on the VIOSes. |
| IV96880 | IPV6 traffic with extension headers may not be transmitted |
| IV96881 | Large send traffic with TCP segment size <224 not transmited |
| IV96882 | Large send traffic with TCP segment size <224 not transmited |
| IV96964 | PV INSERT IN DATABASE FAILS DUE TO SPECIAL CHAR |
| IV97029 | Fix for afdasd max TCQ depth |
| IV97048 | ioslevel changes |
| IV97135 | ETHERCHANNEL LINK PORT IN LACP MODE MAY NOT RECOVER |
| IV97148 | CAA:SLOW GOSSIP TRANSMISSION ON BOOT MAY CAUSE PARTIONED CLUSTER |
| IV97210 | Remove Java6 dependency from IVM |
| IV97269 | DOWN nodeB can gens two NODE_DOWN events for stop nodeA |
| IV97339 | System will be unresponsive during heavy stress. |
| IV97436 | update to bos.esagent fails |
| IV97524 | Requisite failure for ios.artex_profile.rte |
| IV97729 | remove primary site DBN info on DR node during SSP restore |
| IV97991 | VIOS CLIENTS LOSE NETWORK AS SEA REMAINS IN UNHEALTHY |
| IV99024 | HANG OCCURS IN _LIBS_CHILD_POST_FORK |
Was this topic helpful?
Document Information
Modified date:
19 February 2022
UID
hpc1vios-7d338928