IBM Support

IBM Virtual I/O Server support for Power Systems

Fix Readme


Abstract

Downloads for Workload Partition Manager for AIX

Content

Package information

PACKAGE: Update Release 2.2.4.40
IOSLEVEL: 2.2.4.40

VIOS level is NIM Master level must be equal to or higher than
Update Release 2.2.4.40 AIX 6100-09-09 or AIX 7100-04-04 or AIX 7200-01-02

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.4.40.

To take full advantage of all the functions 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.4.40.

Microcode or system firmware downloads for Power Systems

The VIOS Update Release 2.2.4.40 includes the IVM code, but it will not be enabled on HMC-managed systems. Update Release 2.2.4.40, like all VIOS Update Releases, can be applied to either HMC-managed or IVM-managed VIOS.

Update Release 2.2.4.40 updates your VIOS partition to ioslevel 2.2.4.40. To determine if Update Release 2.2.4.40 is already installed, run the following command from the VIOS command line:

$ ioslevel

If Update Release 2.2.4.40 is installed, the command output is 2.2.4.40.

For additional details, including known capabilities, limitations, and additional install considerations, as well as some additional instructions, reference the readme for 2.2.4.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.4.40. 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.4.10 must be applied to bring the VIOS to the latest Fix Pack VIOS 2.2.4.10 level. The Update Release 2.2.4.40 can then be applied to bring the VIOS to the latest level.

Note that with this Update Release 2.2.4.40, 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.4.40.

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:

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:

Upgrading from VIOS version 2.1.0 and above

VIOS Update Release 2.2.4.40 may be applied directly to VIOS level between 2.2.4.0 and 2.2.4.10.

On a VIOS level between 2.2.1.1 and 2.2.3.x, a Single Step update procedure can be used to update to level 2.2.4.40.

Instructions: Single step update

To update to Update Release 2.2.4.40 from a level between 2.2.1.1 and 2.2.3.x in a single step, put the 2.2.4.10 updates in the same location as your 2.2.4.40 updates and do the update using the updateios command.

Before installing the VIOS Update Release 2.2.4.40

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.

  1. To check for loaded images, run the following command:

    $ lsvopt
    The Media column lists any loaded media.

  2. To unload media images, run the following commands on all Virtual Target Devices that have loaded images.

    $ unloadopt -vtd <file-backed_virtual_optical_device >

  3. 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.4.40 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:

Instructions: Verify the cluster is running at the same level as your node.

  1. Run the following command:

    $ cluster -status -verbose

  2. 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:

  1. $ oem_setup_env
  2. Create a link to openssl
    # ln -s /usr/bin/openssl /usr/ios/utils/openssl
  3. Verify the link to openssl was created
    # ls -alL /usr/bin/openssl /usr/ios/utils/openssl
  4. Verify that both files should display similar owner and size
  5. # 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.3.x

You must put the 2.2.4.10 and 2.2.4.40 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

  1. Log in to the VIOS as the user padmin.
  2. 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.
  3. If you use Shared Storage Pools, then Shared Storage Pool Services must be stopped.

    $ clstartstop -stop -n <cluster_name > -m <hostname >

  4. 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:

    1. 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:

    1. Place the CD-ROM into the drive assigned to VIOS.
    1. Create a directory on the Virtual I/O Server.
      $ mkdir <directory_name >
    2. Using ftp, transfer the update file(s) to the directory you created.
  • 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.40.

    $ 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:

  1. Unload any media images

    $ unloadopt -vtd <file-backed_virtual_optical_device>

  2. 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

  3. Restart the VIOS.

    $ shutdown –restart

  4. Verify that the Media Repository is operational by running this command:

    $ lsrep

Additional information

For additional details, including known capabilities, limatations, and additional install considerations, as well as some additional instructions, please reference the Readme for 2.2.4.10 located here.

Fixes included in this release

This version will include all fixes found in all previous 2.2.4.X releases. The fixes for the previous release can be found here.

The list of fixes in 2.2.4.40
APAR Description
IV82022 LU -RESIZE NOT RECOGNIZED ON CLIENT AND SCF LOCK ERROR
IV83866 cluster restore fails at secondary site
IV85465 SYSTEM HANG IN PMSVCS'S MINSLIH IN POWER6 COMPACT MODE
IV85546 LSLV MAY FAIL WITH MALLOC ERROR
IV85970 MISLEADING ECH_MAIN_CHAN_FAIL ERRORS REPORTED
IV87032 JFS2 MOUNT COMMAND ERRORS WITH "PARAMETER THAT IS NOT VALID"
IV87064 DSI IN SEAHA_CTLRECV
IV87358 Handling of WWNN changes in PDISC accept Response
IV87533 CRASH IN BPF_FILTER/M_XHALF
IV87747 PWD MAY RETURN INCORRECT PATH FOR NFSV4 MOUNT TO Z/OS
IV87755 Possible fcstat command hang
IV87786 HANG IN QLFC_EARLY_CLEANUP
IV88358 SERIALIZATION LOCKING HANG IN PORT VALIDATION CODE
IV88408 AUDIT MIGHT LEAK KERNEL HEAP WHEN TE IS ON WITH CHKSHLIB ON
IV88570 REJECTING A FILESET UPDATE IN A USIL MAY FAIL WITH TCB ERRORS
IV88624 AFTER VIOS UPGRADE TO 2.2.4.21 VNIC ADAPTER CONFIGURATION FAILS
IV88866 WRITING TO A USB DVDRAM DEVICE USING UDF IS VERY SLOW
IV88913 NETWORK SWITCH MAY SEND OVER BROKEN LINK IN ETHERCHANNEL
IV88977 SAVEVG FAILS USING -T FLAG AND FILES BEING REMOVED IN /TMP
IV89108 VIO_ALERT_EVENT CAUSED BY MEMORY LEAK IN VIO_CHGMGT DAEMON
IV89122 Queries failing due to failure to connect to database
IV89140 SHARED STORAGE POOL CAN CRASH AT STARTUP WHEN MEMORY IS LOW
IV89491 VIOSBR MAY GENERATE EXTRA LOGS THAT ARE NOT CLEANED UP
IV89526 CAA DMS SHOULD NOT OCCUR DURING SHUTDOWN/REBOOT
IV89527 ALT_DISK_COPY LEAVES DUPLICATE ODM ENTRIES IF ROOTVG WAS MOVED
IV89618 INVALID MSS FOR LARGESEND PKT CAN CAUSE FIRMWARE HANG
IV89619 SYSTEM CRASH AT PRGETPSINFO+000470
IV89620 Machine crashes during LPM operation.
IV89622 SAVEVG DISPLAYS A USAGE ERROR WHEN A NON-USAGE ERROR OCCURS
IV89629 PASSWD -NO_INT FAILS BEHAVES INCORRECTLY
IV89720 COULD NOT FIND "/" AND/OR "/USR" FILESYSTEMS DURING MAINT BOOT
IV89817 NIMADM -J SHOULD FAIL IN PHASE 3 IF OS IS NOT COMPLETELY COPIED
IV89932 CHROLE -R LDAP FAILS WITH 3004-733 ROLE XXX DOESN'T EXISTS
IV89946 UNUSED LNC2ENTDD BASED ADAPTERS CAUSE EXCESSIVE INTERRUPT DELAYS
IV90093 CAA AHAFS EVENTS MAY BE LOST UNDER RARE CIRCUMSTANCES
IV90168 CRASH IN SEADD:SEA_VIRT_INPUT_POST_Q
IV90168 CRASH IN SEADD:SEA_VIRT_INPUT_POST_Q
IV90208 RULES COMMAND RETURNS 0590-102 INCORRECT PROFILE ERROR FOR VEA
IV90239 CFGMGR FAILS TO MAKE DIRECT-ATTACHED DISKS 'AVAILABLE'
IV90278 UNABLE TO ADD CAPACITY TO SSP FROM HMC GUI FOR EMC POWERPATH
IV90380 ARTEXSET FAILED TO RESTORE BACKUP MKTCPIPPROFILE.XML
IV90387 SYSTEM CRASHED IN IKILL WHEN DELETING A JFS2 FILE
IV90392 Possible system crash in exec
IV90593 SHUTDOWN SHOULD ALWAYS ISSUE ALT_ROOTVG_OP SLEEP OPERATION
IV90594 MIGRATION WILL FAIL IF ROOTVG HAS OVER 2 TB FREE PPS
IV90605 system crash on kernel heap page storage key exception
IV90644 Handle SRIOV VF deletes correctly
IV90753 NFSV4 CRASH DUE TO MEMORY LEAK IN GETUSERATTRS WITH KERBEROS
IV90754 SECLDAPCLNTD CORE IN _GETATTRS
IV90756 SECLDAPCLNTD MEMORY LEAK WITH NESTED GROUPS ON AD LDAP SERVERS
IV90790 OWNERSHIP OF VIOSBR BACKUP FILE BECOMES ROOT.STAFF
IV90808 SECLDAPCLNTD MAY FAIL TO HANDLE AD NESTED GROUPS CORRECTLY
IV90897 Drivers lncentdd,lnc2entdd may show, TEMP Hardware error as PERM
IV90972 SWAPON COMMAND CORES, UNABLE TO MALLOC DUE TO LIMITED MAXDATA
IV91048 FCSTAT -Z DOES NOT CLEAR VIRTUAL INITIATORS STATISTICS
IV91199 DMA errors after increasing num_cmd_elems
IV91283 LARGE_SEND AND LARGE_RECEIVE CAUSES COMMUNICATION ERRORS
IV91290 PROCESS HANG ON DVD WRITE ERROR W/VIO CLIENT
IV91293 NON-ROOT USER WITH UID 0 GETTING ADMCHG WHEN USING PAM
IV91337 ICM_TEMP_ERROR CAUSED BY DOUBLE FREED ICM MAD BUFFER
IV91338 UP: UP SHOWN INSTEAD OF BRIDGE STATUS: UP in VIOENT
IV91339 POTENTIAL DATA ANOMALY FOR LINUX USING VSCSI IF LPM FAILS
IV91374 AUTH_DOMAIN AND AUTH_NAME NOT USED IF USER IS BOTH LOCAL/LDAP
IV91375 REDUCE LOCK CONTENTION ON /ETC/UTMP
IV91384 ADAPTER INITIALIZATION COULD FAIL AFTER EEH EVENT
IV91386 dfcscsi might core dump if INT signal is recv'd at right moment
IV91422 SYSTEM CRASH DUE TO DATA CORRUPTION BY SISRAID DRIVER.
IV91583 Open of unmapped virtual Fibre Channel adapter hangs
IV91584 SINGLE THREADED PROCESS HANGS IN LDAP_REQUEST MUTEX LOCK
IV91609 LSTUN CORE DUMPED
IV91610 Enabling poll_uplink may cause memory corruption.
IV91611 MIRRORVG COMMAND RETURNS ERROR WHEN VG MODE IS SUPER STRICT
IV91801 SNAP -AC ADDS "+" TO /ETC/PASSWD AND ETC/GROUP FILE
IV91806 RoCE adapter marked dead upon receiving async events
IV91808 MEMORY LEAK IN KERBEROS LOAD MODULE FUNCTION
IV91809 CHGRPMEM AND CHGROUP FAIL TO ADD A USER TO AN EMPTY LDAP GROUP
IV92121 LPM FAILS WHEN PCIV3(SECURITY HARDENING PROFILE)IS ENABLED
IV92262 MULTIBOS FAILS WHEN ERRORS WITH CANNOT ACCESS
IV92263 Perform link status callback for VF port physical link down.
IV92350 INSTALLP IS NOT UPDATING TSD.DAT WHEN YOU REMOVE A FILESET
IV92355 SYSTEM CRASH IN TSTART IN VFC_HOST NPIV_SEND_MESSAGE
IV92461 BKPROFDATA MAY FAIL WITH VIOSE01040523-0618 ON POWER8
IV92497 MUSENT ERRORS WITH VIOS 2.2.5.X AND IBM I-SERIES CLIENT
IV92517 GETLVODM -F NOT REPORTING DISKS WITH NO PVID
IV92518 CLRCP PUSHING FILE SETS DIFFERENT GID THAN PULLING FILE
IV92895 ABEND IN ENTCORE_KPROC
IV92941 Fixing possible direct attach storage path failure
IV92994 Fsck incorrectly reported bmap corrupt.
IV93074 TRACEMAY ASSERT WITH TARGET_CONFIG OR NPIV_CONFIG IN STACK
IV93101 Fixdata for the 6100-09-09 Service Pack
IV93332 FC disks may not be visible in direct attach configuration.
IV93610 BOTH PATHS IN DUAL ADPT SISSAS CONFIG ARE NON-OPTIMIZED
IV93613 IPV6 route lost during Oracle RAC HAIP failover/failback
IV93721 Unable to connect EtherChannel adapters in point-2-point topo
IV93787 The adapter at defined state after firmware upgraded
IV93840 ORA 600 ERRORS AND ORACLE (V11) CORE DUMPS AFTER AIX SP UPGADE
IV93930 ipv6 largesend fails in inter-CEC communication.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSPHKW","label":"PowerVM Virtual I\/O Server"},"Component":"","Platform":[{"code":"PF002","label":"AIX"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Document Information

Modified date:
19 February 2022

UID

hpc1viosaf3d736