Professional Documents
Culture Documents
Contents
This Readme contains installation and other information about VIOS Update Release 2.2.4.20
Installation information
Pre-installation information and instructionsInstalling the Update ReleasePerforming the necessary tasks
after installationAdditional information
Package information
IOSLEVEL: 2.2.4.20
In June 2015, VIOS introduces the minipack as a new service stream delivery vehicle as well as a change
to the VIOS fix level numbering scheme. The VIOS "fix level" (the 4th number) has changed to two digits.
For example, VIOS 2.2.4.2 has been changed to VIOS 2.2.4.20. Please refer to the VIOS Maintenance
Strategy here for more details regarding the change to the VIOS release numbering scheme.
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.4.20.
Microcode or system firmware downloads for Power Systems
The VIOS Update Release 2.2.4.20 includes the IVM code, but it will not be enabled on HMC-managed
systems. Update Release 2.2.4.20, like all VIOS Update Releases, can be applied to either HMC-managed
or IVM-managed VIOS.
Update Release 2.2.4.20 updates your VIOS partition to ioslevel 2.2.4.20. To determine if Update
Release 2.2.4.20 is already installed, run the following command from the VIOS command line:
$ ioslevel
The following requirements and limitations apply to Shared Storage Pool (SSP) features and any
associated virtual storage enhancements.
•Platforms: POWER6 and later (includes Blades), IBM PureFlex Systems (Power Compute Nodes only)
•Storage requirements per SSP cluster (minimum): 1 fiber-channel attached disk for repository, 1 GB
Software Installation
•When installing updates for VIOS Update Release 2.2.4.20 participating in a Shared Storage Pool, the
Shared Storage Pool Services must be stopped on the node being upgraded.
•In order to take advantage of the new SSP features in 2.2.4.00 (including improvements in the min/max
levels), all nodes in the SSP cluster must be at 2.2.4.00.
•Maximum number of physical volumes that can be added to or replaced from a pool at one time: 64
•The Shared Storage Pool cluster name must be less than 63 characters long.
•The Shared Storage Pool pool name must be less than 127 characters long.
•The supported LU size is 4TB. However, it is recommended to limit the size of individual luns to 16 GB
for optimal performance in cases where all of the following conditions are met:
•The server generates a random access pattern for the I/O device.
Network Configuration
•Uninterrupted network connectivity is required for operation. i.e. The network interface used for
Shared Storage Pool configuration must be on a highly reliable network which is not congested.
•A Shared Storage Pool configuration can use IPV4 or IPV6, but not a combination of both.
•A Shared Storage Pool configuration should configure the TCP/IP resolver routine for name resolution
to resolve host names locally first, and then use the DNS. For step by step instructions, refer to the
TCP/IP name resolution documentation in the IBM Knowledge Center.
•The forward and reverse lookup should resolve to the IP address/hostname that is used for Shared
Storage Pool configuration.
•It is recommended that the VIOSs that are part of the Shared Storage Pool configuration keep their
clocks synchronized.
Storage Configuration
•Virtual SCSI devices provisioned from the Shared Storage Pool may drive higher CPU utilization than the
classic Virtual SCSI devices.
•Using SCSI reservations (SCSI Reserve/Release and SCSI-3 Reserve) for fencing physical disks in the
Shared Storage pool is not supported.
•On the client LPAR Virtual SCSI disk is the only peripheral device type supported by SSP at this time.
•When creating Virtual SCSI Adapters for VIOS LPARs, the option "Any client partition can connect" is
not supported.
•VIOSs configured for SSP require that Shared Ethernet Adapter(s) (SEA) be setup for Threaded mode
(the default mode). SEA in Interrupt Mode is not supported within SSP.
•VIOSs configured for SSP can be used as a Paging Space Partition (PSP), but the storage for the PSP
paging spaces must come from logical devices not within a Shared Storage Pool. Using a VIOS SSP logical
unit (LU) as an Active Memory Sharing (AMS) paging space or as the suspend/resume file is not
supported.
Installation information
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.20. Run the lsvg rootvg command, and then ensure
there is enough free space.
Example:
$ lsvg rootvg
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.20
can then be applied to bring the VIOS to the latest level.
Note that with this Update Release 2.2.4.20, 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.20.
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":
VIOS Update Release 2.2.4.20 may be applied to VIOS level between 2.2.4.0 and 2.2.4.10. When the
Single Step update procedure is used the current level of VIOS must be between 2.2.1.1 and 2.2.3.x.
NOTE: In order to update to Update Release 2.2.4.20 from a level between 2.2.1.1 and 2.2.3.x in a single
step, you can put the 2.2.4.10 updates in the same location and do the update using the updateios
command.
To check for a loaded media repository, and then unload it, follow these steps.
$ lsvopt
2. To unload media images, run the following commands on all Virtual Target Devices that have loaded
images.
3. To verify that all media are unloaded, run the following command again.
$ lsvopt
If your current VIOS is running with Shared Storage Pool from 2.2.1.1 or 2.2.1.3, the following
information applies:
A cluster that is created and configured on VIOS Version 2.2.1.1 or 2.2.1.3 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. When VIOS version is equal or greater than 2.2.1.4 and less than 2.2.4.10, the user needs to
download 2.2.4.10 and 2.2.4.20 update images into a directory, then update the VIOS to Update Release
2.2.4.20 using rolling updates.
If your current VIOS is configured with Shared Storage Pool from 2.2.1.4 or later, the following
information applies:
The rolling updates enhancement allows the user to apply Update Release 2.2.4.20 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. After the
update, you can verify that the logical partitions have the new level of software installed by typing the
cluster -status -verbose command from the VIOS command line. In the Node Upgrade Status field, if the
status of the VIOS logical partition is displayed as UP_LEVEL , the software level in the logical partition is
higher than the software level in the cluster. If the status is displayed as ON_LEVEL , the software level in
the logical partition and the cluster is the same.
•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.
The VIOS SSP software monitors node status and will automatically upgrade the cluster to make use of
the new capabilities when all the nodes in the cluster have been updated, "cluster -status -verbose"
reports "ON_LEVEL" .
--------------------------------------------------------------------------------
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.
$ oem_setup_env
# ln -s /usr/bin/openssl /usr/ios/utils/openssl
# 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.
If your current level is between 2.2.1.1 and 2.2.3.x, you have to put the 2.2.4.10 and 2.2.4.20 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.
If your current level is 2.2.2.1, 2.2.2.2, 2.2.2.3, or 2.2.3.1, you need to 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.
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:
--------------------------------------------------------------------------------
Applying updates
WARNING: If the target node to be updated is part of a redundant VIOS pair, ensure that the VIOS
partner node is fully operational before beginning to update the target node. NOTE that 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.
The current level of the VIOS must be 2.2.2.1 or later if you use the Share Storage Pool .
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.
4. To apply updates from a directory on your local hard disk, follow the steps:
•Using ftp, transfer the update file(s) to the directory you created.
To apply updates from a remotely mounted file system, and the remote file system is to be mounted
read-only, follow the steps:
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:
$ updateios -commit
6. Verify the updates files that were copied. This step can only be performed if the link to openssl was
created.
$ 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.
10. 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
--------------------------------------------------------------------------------
After installing an Update Release, you can use this method to determine if you have encountered the
problem of a loaded media library.
$ 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.
To recover from this type of installation failure, unload any media repository images, and then reinstall
the ios.cli.rte package. Follow these steps:
$ oem_setup_env
# exit
$ shutdown –restart
$ lsrep
Additional information
Use of NIM to back up, install, and update the VIOS is supported.
For further assistance on the back up and install using NIM, refer to the NIM documentation.
Note : For install, always create the SPOT resource directly from the VIOS mksysb image. Do NOT update
the SPOT from an LPP_SOURCE.
Ensure that the NIM Master is at the appropriate level to support the VIOS image. Refer to the above
table in the "Package information" section.
On the NIM Master, use the operation updateios to update the VIOS Server.
Sample: "nim –o updateios –a lpp_source=lpp_source1 ... ... ... "
On the NIM Master, use the operation alt_disk_install to update an alternate disk copy of the VIOS
Server.
Sample:
If NIM is not used to update the VIOS, only the updateios or the alt_root_vg command from the padmin
shell can be used to update the VIOS.
This release of VIOS contains several enhancements. These enhancements are in the area of POWER
virtualization. The following list provides the features of each element by product area.
Note: Version 6.1.0, the previous version of Tivoli TSM, is still shipped and installed from the VIOS
installation DVD.
The Tivoli TSM filesets are now being shipped on the VIOS Expansion Pack, with the required GSKit8
libraries.
The following are sample installation instructions for the new Tivoli TSM filesets:
1. Insert the VIOS Expansion DVD into the DVD drive that is assigned to the VIOS partition.
Fileset Name
GSKit8.gskcrypt32.ppc.rte 8.0.14.7
GSKit8.gskcrypt64.ppc.rte 8.0.14.7
GSKit8.gskssl32.ppc.rte 8.0.14.7
GSKit8.gskssl64.ppc.rte 8.0.14.7
..
..
NOTE: Any prerequisite filesets will be pulled in from the Expansion DVD, including for TSM the
GSKit8.gskcrypt fileset.
$ lssw
Sample output:
..
Interface
The cumulative summary of fixes from previous releases (from 2.2.4.00 to 2.2.4.10) APAR Description
IV71031 AIX NFSSTAT COMMAND DOES NOT REPORT ATTR CACHE TIMEOUT VALUES
IV71806 PART FAILS TO CREATE TAR FILE AFTER SETTING HIGH SECURITY LEVEL
IV71857 AIX NFS4 SERVER CRASHES IN SM4_VCM_PURGE_RIGHTS()
IV72122 NO ERRORS SEEN WHEN DUPLICATE FLAGS IN "NO" COMMAND ARE USED
IV72379 SYSTEM MAY CRASH DURING I/O TO STRIPED LV WITH INFINITE RETRY
IV72792 IFUNIT() CRASH WHEN IOCTL CALLED WITH WRONG SIOCGSIZIFCONF VALUE
IV72893 CLCOMD CAN USE TOO MUCH CPU WHEN AHAFS NOT ACCESSIBLE
IV73771 A JFS2 FILE OPENED WITH O_SYNC MAY HAVE ZERO LENGTH AFTER REBOOT
IV73910 KSH RUNS OUT OF MEMORY WHILE ASSIGING FEW MB DATA TO A VARIABLE
IV74173 EXT PARAMETER NOT CORRECTLY DEALT WITH IN DIO
IV74417 LKDEV -L HDISK -D MAY FAIL WITH 0514-518 CANNOT ACCESS THE CULK
IV75013 HANG WHEN TRACE AND DR FOR CPU ADD STARTED AT ONCE
IV75015 DSH SOMETIMES IGNORE LAST BLANK LINES AND SOMETIMES NOT
IV75274 MULTIBOS REPORTS SUCCESS EVEN IF NOT ALL FILES WERE COPIED
IV76151 IKED LOOPS AND CAUSES CPU LOAD WHEN 0-BYTE DATAGRAM IS PRESENT
IV76234 SYMBOL RESOLUTION FAILURE WHEN PERFORMING A MULTIBOS UPDATE
IV76252 PASSWORD AGING DOESN'T WORK FOR LDAP IF LDAP USES LOCAL DEFAULTS
IV76409 CANNOT UNMOUNT FILE SYSTEM AFTER USING SHARED SYMBOL TABLE.
IV76720 USING CHDEF WITH INCORRECT SYNTAX DOES NOT DISPLAY USAGE ERROR
IV76813 JFS2 FILE SYSTEM MAY GET J2_IMAP_CORRUPT ERROR IN ERROR LOG
IV77678 THE MORE COMMAND MAY FAIL TO HANDLE LARGE FILES (>=4GB)
IV77697 CIO/DIO ENABLED FILESYSTEMS CAN CRASH THE SYSTEM WITH ISI_PROC
IV78897 LU-level validation for LPM fails with IBM i or Linux clients
Back to top
IV73495 PACKET LOSS UPON IMMEDIATE SEA FAILBACK AFTER LINK INITIALIZATIO
IV74935 MKTIME()IS RETURNING INCORRECT VALUE FOR OLSON TIME ZONE FORMAT
IV76819 After a DPO operation on a VIOS server, license check can fail.
IV78360 LDAP USER HAS ADMCHG SET AFTER CHANGING OWN PASSWORD
IV79281 CLMIGCHECK MIGHT FAIL ON CLUSTERS WITH MORE THAN TWO NODES.
IV79301 MWC/force syncvg IOs on async GLVM timeed marked PV missing.
IV79472 microcode update on NPIV vfc device may show sw err message
IV79487 WHEN FILE IS DELETED GROUP QUOTA INFO NOT UPDATED IN JFS2
IV79658 LEVEL.OT MIGRATIONS FAIL IF ALL NODES NOT AT THE SAME CAA
IV80426 caa node does not halt on isolation with partial sancomm config
IV80569 MUSENTDD'S RECEIVE PATH HANGS WHEN IT RECEVIES CERTAIN SIZE PKT
IV80689 LNCENTDD: MULTICAST ADDRS LOST WHEN PROMISCUOUS MODE TURNED OFF
IV80845 Trustchk fails to read TEp/TLP paths greater than 1024 bytes
IV81017 GLOBAL ENV VAR S CAN CAUSE TL/SP UPDATES TO APPLY IMPROPERLY
IV81223 HMC reports that VIOS is busy and not responding to queries
IV81224 I/O failure may occur in QLogic FC driver during EEH recovery
IV81241 MELLANOX V2 DRIVER LOGS LINK UP AND LINK DOWN DURING REBOOT
IV81297 VIO CLIENT CRASHES IN DISK DRIVER DURING LPM WITH GPFS AND PR SH
IV81623 NIM install over VNIC with VLAN ACL mode enabled may fail.
IV81739 LPM: MIGMGR(FIND_DEVICES -T VETH) RC=8 ON DESTINATION VIOS
IV81756 VIOS may crash after using SSP image management in IBM Director
IV81758 SYSTEM HANG WHILE EXTENDING JFS2 FILE SYSTEM HAVING DISK ERRORS
IV81851 RECURSIVE POWER FUNCTION CAUSE DBX CORE DUMP "MALLOC ALLOCATION"
IV82461 VIOS may rarely crash during LUN-level validation for LPM
IV82577 UNMIRRORVG ROOTVG MAY HANG WITH FW-ASSISTED DUMP & HD6
IV82983 viosbr -restore not restoring other nodes except initiator node
IV83077 EEH errors observed on ethernet adapter with FC#EN0S and FC#EN0W
Back to top