U4 - ESCALA Update of AIX 5.1 to 5.1.0.61 (ML 5100-07)

Release 14.1 (17/07/2006)

Preliminary Remarks

Français

English

Ce document décrit la procédure à suivre pour mettre à jour un système en AIX 5.1 au dernier indice technique. Le dernier indice est 5.1.0.61 (il correspond au niveau du package bos.mp).
Il est demandé, dans ce cas, de mettre à jour également les Bull Enhancements.

Si vous mettez à jour un ESCALA de type E230/350, T430/450 ou EPC430/450, il est impératif de récupérer le PTF Z004314. Voir section U4.10 pour son installation.

Si le système comporte des DAS tels que DAS 5300, DAS 4500, DAS 4700, CX 200/400/600 et (ou) des sous-systèmes EMC Symmetrix, lisez attentivement ce qui suit car la migration éventuelle du stockage associé est une opération délicate qui demande une lecture précise des instructions.

ATTENTION
si vous avez besoin d'une procédure de migration pour le stockage (voir ci-après) telle que MS1 : Migration Guide for Storage Environment of a system running BULL drivers and Atf Failover Software ou MS4 : Migration guide from an Aix5.1/Aix5.2 + PowerPath environment , seuls des membres du personnel BULL pourront y accéder.

si vous utilisez déjà les drivers fibre IBM :

si vous ne modifiez pas le stockage géré par votre système, vous n'aurez pas besoin d'autre procédure que U4
si vous voulez ajouter un CX 300/500/700 à votre système, vous aurez également besoin de la procédure MS4 : Migration guide from an Aix5.1/Aix5.2 + PowerPath environment

Attention : les DAS 5300 et 4500 ne peuvent pas cohabiter avec les nouveaux CX300/500/700

si vous utilisez les drivers fibre Bull :

si vous ajoutez des NDAS de type CX200/300/400/500/600/700 :

les DAS 5300 et 4500 ne pouront pas cohabiter avec les nouveaux CX300/500/700
les drivers fibre doivent être migrés vers les drivers IBM
Atf doit être migré vers Powerpath

MS1 : Migration Guide for Storage Environment of a system running Bull drivers and Atf Failover Software

si vous n'ajoutez pas de NDAS, vous pouvez continuer à utiliser les drivers fibre Bull avec Atf, mais il est conseillé de migrer quand même vers les drivers IBM car Atf est en fin de support en juin 2004 et avec AIX5L Powerpath ne peut fonctionner qu'avec les drivers IBM. Pour effectuer cette migration, il faudra également utiliser la procédure de migration stockage MS1 : Migration Guide for Storage Environment of a system running BULL drivers and Atf Failover Software

This document describes the procedure to follow when updating an already existing AIX 5.1 system. The Latest Technical Level is currently 5.1.0.61 (according to the bos.mp fileset Level number).

It is mandatory, in that case, to update the Bullenh product too.

The OSI products are now delivered on several separate CD-ROMs (see U4.1).
You can migrate your storage environment from Bull to IBM drivers and from Atf to Powerpath
If you are updating E230/E250, T430/T450 or EPC430/450 models, downloading

PTF Z004314 is mandatory. See section U4.10 for installation.

If your system includes Fibre Channel DAS such as DAS 5300, DAS 4500, DAS 4700, CX 200/400/600 and (or) EMC Symmetrix Sub-systems, read carefully the following because if need be to migrate the storage, it is very important to follow each instruction given in this documentation.

WARNING
if you need a Storage Migration procedure (see hereafter) such as MS1 : Migration Guide for Storage Environment of a system running BULL drivers and Atf Failover Software or MS4 : Migration guide from an Aix5.1/Aix5.2 + PowerPath environment , only BULL employees will be able to acceed it.

if you already use IBM Fibre channel drivers:

if the storage managed by your system does not change, you will need no other procedure than U4

if you intend to add a CX 200/300/400/500/600/700 to you system, the MS4: Migration guide from an Aix5.1/Aix5.2 + PowerPath environment procedure will be used too (Warning : DAS 5300 and 4500 will not be able to coexist with the NDAS CX300/500/700)

if you use the Bull Fibre Channel drivers :

if you intend to add NDAS CX200/300/400/500/600/700 :

DAS 5300 and 4500 will not be able to coexist with the NDAS CX300/500/700

the Fibre Channel drivers must migrate to the IBM drivers

Atf must migrate to Powerpath

In that case, the MS1: Migration Guide for Storage Environment of a system running Bull drivers and Atf Failover Software procedure will be used.

If you do not intend to add a NDAS, you can still use the Bull Fibre Channel drivers with ATF, but because of the ATF end of support in June 2004, it is recommended to migrate to Powerpath, so to migrate to the IBM drivers (with AIX5L, Powerpath runs only with the IBM drivers). To perform that migration, the MS1 : Migration Guide for Storage Environment of a system running BULL drivers and Atf Failover Software procedure will be used too.

Procedure Contents

U4.1 - Media and SRB
U4.2 - Cluster Node Upgrade
U4.3 - Precautions
U4.4 - Fibre Channel Disks Sub-systems Preparation
U4.5 - SAN manager
U4.6 - Disks Sub-systems
U4.7 - OSI Update
U4.8 - Installation of AIX bundle
U4.9 - Fibre Channel installation
U4.10 - Install AIX updates using "AIX 5.1 Updates" CD-ROM
U4.11 - Install the Bull Enhancement
U4.12 - Reboot the system
U4.13 - Perform DAS with Atf installation (BULL Fibre Channel driver)
U4.14 - Perform DAS with PowerPath installation (IBM Fibre Channel driver)

U4.1 - Media and SRB

To perform that update, you may need some documentation and possibly some firmwares, available on the Bull Open Systems Support WEB (epicentre ). (for BULL employees only)

CDROM : AIX 5L for Power V5.1 ( 76741380-001 ) (5 volumes)
CDROM : AIX 5L V5.1 Updates (76741505-001) (2 volumes)
CDROM : Bullenh 510_14 ( 76741660-001) or Bull ADD-ONs 51_14 (76741661-001) if you add a NDAS to your configuration
SRB : AIX 5L for POWER Version 5.1 & Bull Enhancement 510_14 (86 A2 97EE Rev.17)
if you are updating E230/E250, T430/T450 or EPC430/450 models, PTF Z004314 is mandatory
if you are running a SAN Manager :

CDROM : S@N.IT! V5 Limited Edition (76741433-001) (see U4.4)
CDROM : S@N.IT! V5 Data Center (76741434-001) (see U4.4)

if you need to migrate from Bull to IBM Fibre Channel drivers :

Media and requisite binaries are described in the ATF To Powerpath basic migration Checklist (for BULL employees only)
Required Procedure : MS1 - Migration Guide for storage environment (target system : AIX 5L) (for BULL employees only)

CDROM : Power Sream X25 for AIX 5.1 (76723991-001) (see U4.10)
if you are running OSI software (see U4.6) :

CDROM : CPIC-OSI (76741062-001)
CDROM : OSI Layers 1 to 4 & Netshare - Library (76741106-001)
CDROM : OSI Layers 5 to 7 & TPAD/HPAD - Library (76741060-001)
CDROM : APIs - Library (incl. XTI-API & MAX3) (76741061-001)

U4.2 - Cluster Node Upgrade

If you are running HAS ES 4.4.1, please, be sure you have got the HAS ES 4.4.1 and Bull Cluster Management 4.3.3 Latest Technical Level , looking at the following URL :

http://epicentre.frec.bull.fr/info/topics/HA/FAQS/faq_ha_upgrade.html (for BULL employees only)

then stop HACMP with takeover option on that node, using the smit clstop command.

U4.3 - Precautions

In any case, perform a bootable backup of your configuration (rootvg) and save other Volume Groups.
Make sure that there are no user connected on the system

U4.4 - Fibre Channel Disks Sub-systems Preparation

If your system does not include Fibre Channel Disk Sub-systems, just ignore this section.

If your system includes Fibre Channel DAS as DAS 5300, DAS 4500, DAS 4700 and (or) EMC Symmetrix Sub-systems and if the Fibre Channel drivers in use are the BULL one :

if you need to migrate to IBM Fibre Channel drivers, you will have to execute some sections of the following procedure : MS1 - Migration Guide for storage environment (target system : AIX 5L) all along the AIX migration. At this point, go to the DAS preparation section of MS1 (for BULL employees only)
if you keep on running the BULL Fibre Channel drivers, you will have nothing to do at this point of the update procedure

If your system already includes NDAS CX200/400/600 and (or) if you already use the IBM Fibre Channel Drivers :

if you intend to add a CX 300/500/700 to your configuration, you will have to execute some sections of the following procedure : MS4 : Migration guide from an Aix5.1/Aix5.2 + PowerPath environment all along the AIX migration (for BULL employees only).

DAS preparation

MS4

if you do not modify your storage configuration, check the flare and base software release at the EMC CLARiiON Storage Subsystems WEB site.(for BULL employees only) You can, at this point :

update the DAS flares
update Navisphere 6 to the latest level
update Powerpath to the latest level

MS4 : Migration guide from an Aix5.1/Aix5.2 + PowerPath environment

U4.5 - SAN Manager

If you are not using any SAN Manager, jump to next step

To know which SAN Manager Release is running on your system, run : lslpp -l | grep -i san

You could get :
S@N.IT! V1 or V2 ==> san_it.all 1.x.x
or
S@N.IT! V4 ==> san_it.all 4.x.x
or
S@N.IT! V5 ==> san_it.all 5.x.x

If you are using S@N.IT! earlier than V4 (Release less than 4.0), you have to upgrade it now to the S@N.IT! V5 product using the following procedure :

on the server, install the S@N.IT! Limited Edition + S@N.IT! Data Center CD-ROMs (see the procedures described in S@N.IT! Data Center SRB ref. 86 A2 86 EE or S@N.IT! Limited Edition ref. 86 A2 94 EE, section "Compatibility with Earlier Versions and Migration" )

on the agents, install the S@N.IT! Limited Edition CD-ROM, the procedure for installation is also described in the S@N.IT! Data Center SRB (do not worry if you get a failed installation )

on the server and the agents :

in case of AIX host, install the last S@N.IT! PTF from the Bull Enhancement CD-ROM, following the procedure :

Insert the Bull Enhancement CD-ROM and run then :

mount /cdrom
cd /cdrom/S@N.IT
smit update_all

select : INPUT device/directory for software : .

do not change any parameter of the next menu and press enter twice.

run then :

cd /
umount /cdrom

in case of other hosts (Linux, Windos NT), install the appropriate PTF from http://www-opensup.bull.com/software/sanitfixes/

Beware of updating the server before the agents !

If your are already using S@N.IT! V4 or S@N.IT! V5

on AIX hosts, the minimum Technical Level is :

san_it.all 4.0.4.4 and san_it.devices 4.0.4.2 for S@N.IT! V4.0
san_it.all 4.1.3.8 and san_it.devices 4.1.3.1 for S@N.IT! V4.1
san_it.all 5.0.2.6 and san_it.devices 5.0.2.5 for S@N.IT! V5..0
if you do not get it, you have to update your S@NIT! product following the procedure :

Insert the Bull Enhancement CD-ROM and run then :

mount /cdrom
cd /cdrom/S@N.IT
smit update_all

select : INPUT device/directory for software : .

do not change any parameter of the next menu and press enter twice.

run then :

cd /
umount /cdrom

on other hosts (Linux, Windows NT), install the appropriate PTFs from : http://www-opensup.bull.com/software/sanitfixes/

Beware of updating the server before the agents !

U4.6 - Disks Sub-systems

does not include Disk Sub-systems,

includes Disk Sub-systems

if your system includes Fibre Channel DAS as DAS 5300, DAS 4500, DAS 4700 and (or) EMC Symmetrix Sub-systems and if the Fibre Channel drivers in use are the BULL one :

if you need to migrate to IBM Fibre Channel drivers, go now to section : " To be followed before modifying the Fibre Channel adapter jumpers" of the MS1 Guide.

if you keep on running the BULL Fibre Channel drivers, just perform the following commands :

Unmount all the files system.

umount <filesystem*>

lsps -a

Vary off the Volume Groups :

varyoffvg <vg>

if your system includes NDAS CX200/400/600 and (or) if you already use the IBM Fibre Channel Drivers :

if you intend to add a CX 300/500/700 to your configuration, go now to section : "Existing components migration" of the MS4 Guide .
if you do not modify your storage configuration, just perform the following :

Unmount all the files system, if you have not already done it

umount <filesystem>

lsps -a

Varyoff the Volume Groups :

varyoffvg <vg>

if your system includes SCSI DAS, just perform the following :

Unmount all the files system, if you have not already done it

umount <filesystem>

lsps -a

Varyoff the Volume Groups :

varyoffvg <vg>

U4.7 - OSI Update

If you use OSI products it is recommended to update them now, using the OSI CD-ROMs and the Bull Enhancement CD-ROM.. See the description in the U4.1 section.

Insert the OSI CD-ROMs and type the command:

smit update_all

Insert the Bull Enhancement CD-ROM and run then:

mount /cdrom

cd /cdrom/OSI

smit update_all

select: INPUT device/directory for software: .

run then:

cd /

umount /cdrom

to get more information about the OSI CD-ROMs, see Chapter OSI Products in the AIX 5L for POWER Version 5.1 & Bull Enhancement 510_11 SRB

U4.8 - Installation of AIX bundle

Depending on the first AIX 5 installation on your system, the AIX bundle may have changed, please re-install it before updating the already installed filesets.

AIX bundle is located on the AIX 5.1 CD-ROM, Vol 1

Install the fileset bundle_aix510 with the following command :

installp -acgXd /dev/cd0 bundle_aix510

AIX_5.1

" smit install_bundle "

Note : do not worry if you get the message : "nothing to install"

U4.9 - Fibre Channel installation

LP7000, LP8000 and LP9000

BULL Fibre Channel driver

IBM Fibre Channel driver :

check that the devices.pci.df1000f7* and devices.pci.df1000f9* are installed. Otherwise install them from the AIX 5L CD-ROM.

U4.10 - Install AIX updates using "AIX 5.1 Updates" CD-ROM

Insert the "AIX 5.1 Updates" CD-ROM , and run:

 smit  update_all

select :

INPUT device/directory for software: [/dev/cd0]

press <enter>
a new menu is displayed, if you can select:

ACCEPT new license agreements? yes

in this menu, you just have to press <enter> twice and AIX updating will run.

If the ACCEPT new license agreements? is not proposed in this menu, then proceed as follows :

always using the "AIX 5.1 Updates" CD-ROM, enter:

smit install_latest

select:

INPUT device/directory for software:             [/dev/cd0]
SOFTWARE to install                    [ devices.pci.14106602.ucode devices.pci.14107802.ucode]
ACCEPT new license agreements?                        yes   <---

Let the AIX 5L for POWER V5.1 Updates CD-ROM inserted

Enter:

smit update_all

select:

INPUT device/directory for software: [/dev/cd0]

and press <enter> three times to run the AIX updating.

if you are updating E230/E250, T430/T450 or EPC430/450 models, install now PTF Z004314 running the smit update_all command. WARNING : do not reboot before installing this PTF, your system would be broken !

if you are migrating an Escala T model, you will get the following error running the bosboot command :

/usr/lib/boot/bin/mkboot_Bull_rspc: Not a recognized flag: K
usage: /usr/lib/boot/bin/mkboot_Bull_rspc -d device [[-N -i -s -l lvdev -p address]]
-f filesys {-k kernel | -e expander} [-D |-I] [-b -c -h -L -r -w]
[-A module [-m mode] [-F]]
0301-158 bosboot: mkboot failed to create bootimage.
0301-165 bosboot: WARNING! bosboot failed - do not attempt to boot device.
The installation or updating script is unable to continue
0503-407 installp: An error occurred during bosboot processing.
Please correct the problem and rerun installp.

The only way to correct the problem is to modify the bosboot command as follows :

cd /usr/sbin
cp bosboot bosboot.ref
vi bosboot
+964      $lock_instr -k $1 $boothdr $rosemu -f $2 $norm $serv $boot_lv \
+965      $set_start $wrtblv -A ${softROS} -K ${kernel} 2>$mkbout | \
+966      dd ibs=1b obs=64b of=$outimage 2>$ddout

and modify line 965 :

+964      $lock_instr -k $1 $boothdr $rosemu -f $2 $norm $serv $boot_lv \
+965      $set_start $wrtblv -A ${softROS} 2>$mkbout | \
+966      dd ibs=1b obs=64b of=$outimage 2>$ddout

then re-run the bosboot command :

bosboot -a -d /dev/ipldevice

U4.11 - Install the Bull Enhancement

WARNING :

The psx25 product is no more delivered with the Bull Enhancement CD-ROM. You can install it from the Power Sream X25 for AIX 5.1 CD (Ref. 76723991-001).

If your configuration includes DAS Subsystems, read carefully the AIX SRB PART 3, "DAS Subsystems-DiskArray, fcDiskArray"

If your configuration includes NDAS CX600 or CX400 Subsystems, read carefully the AIX SRB PART 3, "NDAS CX600 or CX400 Subsystems-CLArrayS3"

Bull Enhancement

if your configuration includes neither SCSI DAS, nor Fibre Channel DAS

run :

smit install_latest

select : INPUT device/directory for software : [/dev/cd0]

if your configuration includes only SCSI DAS

run :

mount /cdrom

cd /cdrom/DAS_scsi

smit install_latest

select : INPUT device/directory for software : .

run then :

cd /

umount /cdrom

AIX SRB

if your configuration includes Fibre Channel DAS

check if the BULL Fibre Channel adapters are in used, running the command :

lsdev -Ccadapter

fchan<x>

run :

mount /cdrom

cd /cdrom/FC_ATF

smit install_latest

select : INPUT device/directory for software : .

Symmetrix.ha.rte

run then :

cd /

umount /cdrom

If you are using (or will use) the IBM fiber channel drivers and i f you intend to add a CX 200/300/400/500/600/700 to your system, go now to the section " Fibre Channel and DAS software installation" of the Storage Migration Guide you are using, either MS1 Guide or MS4 Guide .

If you are using (or will use) the IBM fiber channel drivers and i f you do not add any new NDAS

if your system includes DAS 5300 and (or) DAS 4500 subsystems, run the following commands :

mount /cdrom

cd /cdrom/CLARRAY

smit install_latest

select : INPUT device/directory for software : .

run then :

cd /

umount /cdrom

in any other case, run :

smit install_latest

INPUT device/directory for software : [/dev/cd0]

The requisite failure message relating to the EMC.Symmetrix.ha.rte and EMC.CLARiiON.ha.rte filesets is normal since you do not have any High Availability software installed on your machine.

For all that concerns the Navisphere 5 product, it is strongly recommended to read :

Configuring and Managing a DAS and using ATF : 86 A2 20PN 13

For all that concerns the Navisphere 6.5 product, it is strongly recommended to read the AIX SRB PART 3, "Navisphere 6.5"
the devices.pci.48110040 package present on the Bull Enhancement CD-ROM is dedicated to PCI FDDI adapters with the label B5-3, B5-4 or B5-5. Consequently, if you have PCI FDDI adapters without such a label, you have first to de-install the devices.pci.48110040 package , then to re-install it from the FDDI media delivered with the adapter (see AIX SRB , PART 1, "Install Bull Enhancement Packages")).

U4.12 - Reboot the system

WARNING : if your system runs on a cluster node, the PM daemon must not be started. To perform that, insert ":" at the begining ot the following line in /etc/inittab :

pmd:2:wait:/usr/bin/pmd > /dev/console 2>&1 # Start PM daemon

if you use NIS, it is strongly recommended to remove the bos.net.nisplus fileset
If you do not have to perform any DAS installation, reboot the system now, running :

shutdown -Fr

If you migrate from the BULL Fibre Channel driver to the IBM Fibre Channel driver, run shutdown -F and go to section : " The Fibre Channel adapter jumpers settings modification" of the MS1 Guide

U4.13- Perform DAS with Atf installation (BULL Fibre Channel driver)

This section has to be followed if your system is still running with the BULL Fibre Channel drivers.

only in case of DAS :

since some important problems have been described in TSBs, please have a look at the suggested URL in the following cases :

using DAS5300 and DAS57X0 arrays with Atf : http://epicentre.frec.bull.fr/opensupdb/TSBS/500.02025.00.tsb/ (for BULL employees only)

using Atf : http://epicentre.frec.bull.fr/opensupdb/TSBS/500.02024.00.tsb/ (for BULL employees only)

the DiskArray and fcDiskArray.com packages have been re-installed with the Bull Enhancement CD, verify the flare Firmware release of your DAS, and re-install it if it has changed (Refer to AIX SRB - PART 3 - DAS Subsystems).

Note :
After the DAS flare upgrading to :

5.11.14 for DAS 5700 , 5.11.64 for 5720

5.24.05 for DAS 5300

5.32.13 for DAS 4500

the disks LEDS blink continuously. Do not worry, this is a normal behaviour and will remain forever.

if you have ordered it, now install the Atf package from the Atf CD-ROM (see the Atf SRB : 86 A2 70WF)

WARNING : compatibility between Atf release and other software packages as DiskArray is important. It is described in the Atf SRB and at the following URL : http://epicentre.frec.bull.fr:80/internal/topics/storage/das/atfmatrix.html (for BULL employees only)
do not reboot the system at this moment

if you have upgraded a Cluster Node :

as other Nodes have taken the upgraded Node resources during the Upgrading process, Volume Groups will be varied on on these Nodes.

So to be able to recover the Volume Groups on the upgraded Node:

on "split_bus" configurations (one SCSI bus by Node to a shared DAS), you have to stop HACMP on the other Node ( smit clstop ) and then run :

/usr/lpp/DiskArray/das_available hdisk<x>
hdisk<x> is the hdisk where the Volume Group has to be re-imported
on other configurations (DAS with Atf, EMC...), it is mandatory to break the disk reservation running the following command on the other Nodes (where the VGs are varied on):

varyonvg -b -u <VGname>

run then, on the upgraded Node, for each hdisk :

rmdev -dl hdisk<x>

reboot the system

verify that all the Volume Group have been recovered

you can now restart HACMP running the smit clstart command and verify that the upgraded Node recovers its resources

otherwise :

reboot the system

run the varyonvg command for each Volume Group

mount the filesystems

U4.14 - Perform DAS with PowerPath installation (IBM Fibre Channel driver)

If you migrate from the BULL Fibre Channel driver to the IBM Fibre Channel driver, go to section : "To be followed after modifying the Fibre Channel adapter jumpers" of the MS1 Guide

If you are using the MS4 Guide to migrate your storage environment, go now to section : "New components installation"