U2 - Escala Update from AIX 4.3.X to AIX 4.3.3 Latest Technical Level
Release 8.1 (21/06/2004)
Preliminary Remarks
- This document describes the procedure to follow when updating AIX 4.3.0, AIX 4.3.1 or AIX 4.3.2 systems to AIX 4.3.3 Latest Technical Level, 4.3.3.86 (according to the bos.mp fileset Level number) or Maintenance Level 11.
- It often refers to the AIX TM 4.3.3& Bull Enhancement SRB (see its reference below), do not forget to get this document.
- The OSI products are now delivered on several separate CD-ROMs (see U2.0).
Procedure Contents
U2.0 - Media and SRB
U2.1 - Cluster Node Upgrade
U2.2 - Backup the system
U2.3 - DPT adapter specificities
U2.4 - Single User Mode
U2.5 - File systems operations
U2.6 - Filesets to remove
U2.7 - OSI Migration
U2.8 - SSA adapter specificities
WARNING :
If one of the previous operations fail call your support representative.
If you continue unpredictable results may occur and some updates might not be applied
U2.9 - Check the Filesets
U2.10 - Update AIX using "AIX server 4.3.3" CD-ROM'S
U2.11 - Install AIX bundle using "AIX server 4.3.3" CD-ROM'S
U2.12 - Install AIX updates CD-ROMs
U2.13 - Reboot the system
U2.14 - Install Bull Enhancement CD-ROM
U2.15 - Reboot the system
U2.16 - Perform Disks Sub-systems installation
U2.17 - Check the system
U2.18 - Netscape Communicator
U2.19 - Sendmail Configuration
Appendix 1 - How to update a Fiber Channel Adapter Firmware Level
U2.0 - Media and SRB
- media=CD-ROM 76741108-001 : AIX server 4.3.3 for Escala (4 volumes)
- media=CD-ROM 76741002-001 : AIX 4.3.3 updates
- media=CD-ROM 76741370-001 : AIX 4.3.3 Maintenance Level 10 -> 11 (4.3.3.86)
- media=CD-ROM 76741160-001 : Bullenh 433_15
- SRB 86 A2 98EE Rev 02
- Power Sream X25 for AIX 4.3 : 76723980-001 (see U2.14)
- OSI Media (see U2.7) :
- CPIC-OSI : 76723992-001
- OSI Layers 1 to 4 & Netshare - Library : 76723981-001
- OSI Layers 5 to 7 & TPAD/HPAD - Library : 76723982-001
- APIs - Library (incl. XTI-API & MAX3) : 76723983-001
- GCOS Connectivity - Library : 76723984-001
- Bonus Pack for AIX 4.3 : 76741043-001 (see U2.18)
- Atf for AIX V4 : 76741022-001 (see U2.16)
To get this media, contact your BULL representative.
The following media may be useful :
U2.1 - Cluster Node Upgrade
- If you have to upgrade the HACMP software too, please look at the following URL before starting AIX Update :
-
http://epicentre.frec.bull.fr/info/topics/HA/FAQS/faq_ha_upgrade441.html (for BULL employees only)
- if you just need to upgrade AIX :
- stop HACMP with takeover option on that node, using the
smit clstop
command. - if you are running the HACMP 4.3.1 software, you must install now the HAS ES 4.3.1 and Bull Cluster Management 4.3.3 Latest Technical Level, please look at : http://epicentre.frec.bull.fr/info/topics/HA/FAQS/faq_ha_level.html (for BULL employees only)
- if you are running the HACMP 4.2.software, you must upgrade to HACMP 4.4 to cohabit with AIX 4.3.3 and the new Bull Enhancement CD-ROM. See the above referenced URL
U2.2 - Backup the system
Perform a bootable backup of your configuration (rootvg) and save other Volume Groups.
U2.3 - DPT adapter specificities
-
If the system to update (rootvg) resides on RAID1 DPT disks, and if the adapter firmware level is less than 07M8 (ex: 07L4), the cache must not be validated before updating. To do that, you have to configure the 2 RAID1 disks in "write-through" mode instead of "write-back" mode (See DPT documentation)
To know if a DPT is present, run :
lsdev -Ccadapter
a DPT adapter looks like :
-
sra0 Available 04-07 BULL PCI RAID adapter
lspv
which returns (for example):
-
hdisk3 0000002060b7bd8c rootvg
lsdev -Ccdisk
which returns, in case of DPT lun :
-
hdisk3 Available 04-07-01-0,0 BULL PCI RAID 1
U2.4 - Single User Mode
- Remove smw fileset:
- Check if lft or tty0 is the correct console with a view to reboot the machine on it :
- the system must be in single user mode :
- reboot the system in single mode user after changing this /etc/inittab line
- Check with the "ps -eaf" command to be sure all applications have stopped running.
- If you use lft display perform the following command:
-
Then check to be sure they are not present :
lslpp -l |grep -i smw
lscons (to check)
smit chcons (to assign)
"init:2:initdefault:"
by "init:s:initdefault:"
export TERM=lft
Verify if the devices.mca.8f97.com fileset is installed using the command : Check the Filesets using the following command : WARNING : if , at the end of this update, you get a "Bosboot failed" message, re-run the bosboot command as follow : WARNING : in case of DPT disks use, you have to re-install now the devices.bullraid.rte fileset fchan1 04-01 PCI Fibre Channel Adapter Adresse de réseau...........0000C9205704 ------- Adresse de réseau...........0000C9204986 -------------- Run the following command : Network Address.............0000C920C77A To downgrade microcode level: WARNING : Netscape Communicator 4.76 at least is mandatory in an AIX 4.3.3.81 environment. When updating from the previous version of AIX 4.3, the version 8.9.3 sendmail binary will be installed, but the version 8.9.3 /etc/sendmail.cf file will not. The original /etc/sendmail.cf is kept. However, you can generate an 8.9.3 sendmail.cf if desired. Sendmail version 8.7 (supported on AIX 4.3.0), sendmail version 8.8.8 (supported on AIX 4.3.2) and sendmail version 8.9.3 are somewhat compatible. The version 8.7 /etc/sendmail.cf will work with the the version 8.8.8 and version 8.9.3 sendmail binaries. The version 8.8.8 /etc/sendmail.cf will work with the version 8.9.3 sendmail binary. However, each new version of /etc/sendmail.cf contains new rewrite rules, macros and options that are particular to the updated sendmail binary. So, if you choose to run version 8.7 /etc/sendmail.cf with the version 8.9.3 sendmail binary, you will lose some new features and functionality particular to version 8.9.3. You may wish to merge in the new options, macros, and rewrite rules. The new sendmail.cf should have been saved in /usr/lpp/save.config/etc/sendmail.cf.new. You will have to merge this manually as there are no migration scripts to do this. Warning: .cf file is out of date: sendmail AIX4.3/8.9.3 supports version 8, .cf This is just a warning. Change the version to 8 in the V macro in the /etc/sendmail.cf to get rid of this warning. First solution : Consider upgrading FW on an adapter is a maintenance operation...So:
WARNING : If applications are still running, unpredictable results may occur and some updates
might not be applied.
U2.5 - File systems operations
chlv -x 512 hd2
chfs -a size='+20000' /tmp
WARNING : If the tmp logical volume name is different from /dev/hd3 the update will fail.
/tmp or /etc if they are too small.
If this is the case, make a backup (smit mksysb), and restore with the shrink option.
lsvg rootvg
fsize = 0
means that the file size is unlimited, but within AIX 4.3.3, you must either give a size (default is 2097151 x 512 Bytes), either put the "-1" value that means unlimited.
To check the PP number , run :
lspv -p hdiskXX| grep -i boot (hdiskXX is rootvg)
In the case of only 1 PP, you get the follwing result : 1-1 used outer edge hd5 boot N/A
If you do not extend hd5, you may have the following problem:
>0301-161 bosboot: dd failed to copy boot image
>0301-165 bosboot: WARNING! System not bootable
To extend the hd5 partition:
WARNING : the two hd5 PP have to be contiguous.
extendlv hd5 1
Two PP not contiguous : 1-1 used outer edge hd5 boot N/A
13-13 used outer edge hd5 boot N/A
If it is not, you have to remove hd5 and create it again with the commands:
( Two PP contiguous : 162-163 used outer middle hd5 boot N/A)
rmlv -f hd5
mklv -y hd5 -t boot -u2 rootvg 2 hdiskXX
lspv -p hdiskXX | grep -i boot (for checking)
bosboot -a -d /dev/ipldevice
U2.6 - Filesets to remove
If there are requisite filesets, you can remove them with "-g" option.
installp -ug ifor_ls.base.cli
installp -u bos.net.ncs
installp -u bos.perf.pmr
Before de-installing the bullx25 filesets, run the following command : /usr/lib/methods/udefifxd
rmdev -dl rmtX
installp -u -g Bulltape
installp -u EXB*
installp -u BX11*
installp -u -g ipx.base.rte
(if you don't use netware)
lslpp -l |grep -i exb or bx11 or ipx.base.rte
Check the cda software Release using : lslpp -l cda
(the cda software is used by the EMC disks Sub-system)
If the Release is less than 2.1.9 :
installp -u cda
You have to remove the hdisks attached to these Sub-systems
umount <filesystem*>
varyoffvg <vg>
rmdev -dl hdisk<x>
WARNING: If you do not de-install DAS & ATF the machine may crash during the boot after the migration process.
rmdev -dRl atf*
rmdev -dl sp*
lslpp -l atf.obj
installp -u -g atf.obj
odmdelete -q"uniquetype=array/scsi/CLARiiON" -o PdAt
odmdelete -q"uniquetype=array/fcscsi/CLARiiON" -o PdAt
odmdelete -q"uniquetype=array/scsi/CLARiiON" -o PdDv
odmdelete -q"uniquetype=array/fcscsi/CLARiiON" -o PdDv
installp -u -g DiskArray
installp -u -g ArrayGUIde
umount <filesystem*>
varyoffvg <vg>
rmdev -dl hdisk<x>
installp -u cda
WARNING: r emove the hdisks references in /etc/Navisphere/agent.config file (very important) , they will have to be replaced by the "sp" devices after the new Bull Enhancement installation (see Managing & Configuring a DAS : 86 A2 20PN 11)
U2.7 - OSI Migration
smit update_all
U2.8 - SSA adapter specificities
If it is installed, now run the ssa_pre_i.efix script ., as root.
lslpp -L devices.mca.8f97.com
U2.9 - Check the Filesets
lppchk -v -m3
if you do not use the fileset displayed, remove them using the following command: installp -u "FilesetName"
otherwise call your support representative. U2.10 - Update AIX using "AIX server 4.3.3" CD-ROM'S
/usr/sbin/srcmstr &
(otherwise, some packages will not be installed) bos.rte.install
fileset prior to updating the rest of the system.
where <DEVNAME> represents the device name of your installation device, for example, /dev/cd0 (CD-ROM device), /dev/rmt0.1 (tape device), or a directory where the bos.rte.install 4.3.3.75 is available.
installp -acgXd <DEVNAME> bos.rte.install 4.3.3.75
lslpp -l |grep -i bos.rte.install
WARNING : smit will ask you several times to insert a different CD-ROM volume
smit update_all
Once this PTF is installed, remove the CD-ROM and insert the "AIX server 4.3.3 CD-ROM Vol.1" , then run the following script :
this will cause the update_all command to run automatically, look at the result of the installation in the /tmp/update_433 file .
/usr/local/bin/updt_433_BULL_chrp | tee /tmp/update_433
Do not worry if you get the answer " nothing to de-install "
installp -u devices.pci.isa_Bull_rspc.rte
Then, enter the following on the command line and accept the default menu values:
WARNING : smit will ask you several times to insert a different CD-ROM volume
smit update_all
if you get then "missing proto file /usr/lib/drivers/isa/isa_busBull", perform the following command :
bosboot -a
and then re-run the
ln -sf /usr/lib/drivers/isa/isa_busdd /usr/lib/drivers/isa/isa_busBull
bosboot -a
command.
For any other message, contact your Bull representative.
U2.11 - Install AIX bundle using "AIX server 4.3.3" CD-ROM'S
installp -acgXd /dev/cd0 bundle_aix433
If the result of installation is "Failed" because of bos.perf.perfstat fileset, you will have to re-install it after rebooting (see U2.13)
U2.12 - Install AIX updates CD-ROMs
smit update_all
If the fileset devices.pci.14109f00.rte is installed on your system, you will get a Requisite Failure applying the "AIX 4.3.3 Maintenance Level 10 -> 11 (4.3.3.86)" CD-ROM. smit update_all
If your customer does not use the IBM PCI 4658 CRYPTOGRAPHIC COPROCESSOR ADAPTER SOFTWARE (this adapter is not sold by BULL), the filesets devices.pci.14109f00.* can be removed. If the customer uses such an adapter, he has to download the U480740 PTF which will be installed using smit install_latest.
U2.13 - Reboot the system
remove the devices.pci.00101010.rte
(no more correct for AIX 4.3.3) fileset, running :
In case of AIX mirroring on the LVD additional controller (EPC430 & ESCALA T 430 models), de-installation of this fileset may fail, see TSB 500.00007.00.tsb
installp -u devices.pci.00101010.rte
devices.pci.df1000f7*
filesets (Fiber channel drivers not used), running :
installp -u devices.pci.df1000f7*
shutdown -Fr
bos.perf.perfstat
fileset from the AIX server 4.3.3 CD-ROM Vol.2, running :
installp -acgXd /dev/cd0
bos.perf.perfstat
U2.14 - Install Bull Enhancement CD-ROM
WARNING :
You can install it from the Power Sream X25 for AIX 4.3 CD (Ref. 76723980-001).
/usr/sbin/srcmstr &
(otherwise, some packages will not be installed)
and
/usr/sbin/cron &
If it does, you will get IBM 8-Port EIA-232/RS-422A (PCI) Adapter for one of the "sa<x>" adapters. In that case, take note of the bullasync.pci.rte fileset release using the command:
lsdev -Ccadapter|grep ^sa
lslpp -l bullasync.pci.rte
smit install_latest
and install all or only the filesets you need.
or
if your configuration does not include any DAS at all :
mount /cdrom
cd /cdrom/FC_ATF
smit install_latest
and install all or only the filesets you need.
installp -u -g Navisphere.Agent
installp -u -g Navisphere.CLI
installp -u -g DiskArray
If it is less than 1.8.2, you have to re-install the devices.pci.4f111100 package from the AIX server 4.3.3 CD-ROM.
To verify the type and level of your fiber channel adapter, run the following command : lscfg -vl fchan<x>
You will get :
-----
Configuration which prevents booting :
----------
Niveau de modif. technique..BIU 2
Référence ..................76730052
Message affichable..........Fibre Channel Host Adapter
Niveau microcode télécharg..2202000
Niveau diagnostics..........2322000
Fabricant...................EMULEX
Spécification unité (Z1)....ENDEC 21acb057
Spécification unité (Z2)....SM 11acc057
Right configuration got after firmware updating :
------------
fchan2 04-02 PCI Fibre Channel Adapter
Niveau de modif. technique..BIU 2
Référence ..................76730052
Message affichable..........Fibre Channel Host Adapter
Niveau microcode télécharg..2212000
Niveau diagnostics..........2332000
Fabricant...................EMULEX
Spécification unité (Z1)....ENDEC 21acb057
Spécification unité (Z2)....SM 11acc057 U2.15 -Reboot the system
WARNING : if your configuration includes LP7000 adapters in FC Loop environment, they may not be configured after microcode update (fileset.devices.pci.df1001f7.ucode 1.3.3.7 or later).
"init:s:initdefault:"
by "init:2:initdefault:"
shutdown -Fr
If the fchan are in the defined state, this may be due to connection problem (MIA, cable, hubs, ...) which were tolerated by microcode level 3.20 but no more accepted by microcode levels 3.22 or 3.30.
lsdev -Cc adapter | grep fchan
Solution is to fix connection problem or, as a workaround, go back to microcode level 3.20.
To identify LP7000 (BIU 4) adapter and microcode (322xxxx), run :
fchan1 30-70 PCI Fibre Channel Adapter
lscfg -vl fchan<x>
EC Level....................BIU 4
Part Number.................76730259
Displayable Message.........Fibre Channel Host Adapter
Loadable Microcode Level....322xxxx (or 330xxxx)
See then : How to update a Fiber Channel Adapter Microcode level
cd /usr/lpp/devices.pci.df1001f7
cp df1001f7.awc df1001f7.awc.NEW
cp df1001f7.mcode df1001f7.mcode.NEW
cp df1001f7.awc.320 df1001f7.awc
cp df1001f7.mcode.320 df1001f7.mcode
Don't install further PTFs related to fileset devices.pci.df1001f7.ucode
as long as connection problem is not fixed ... U2.16 - Perform Disks Sub-systems installation
Note :
After the DAS flare upgrading to :
the disks LEDS blink continuously. Do not worry, this is a normal behaviour and will remain forever.
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/info/topics/AIX/compatibility/Atf.html
So to be able to recover the Volume Groups on the upgraded Node:
smit clstop
) and then run :
hdisk<x> is the hdisk where the Volume Group has to be re-imported
/usr/lpp/DiskArray/das_available hdisk<x>
varyonvg -b -u <VGname>
rmdev -dl hdisk<x>
smit clstart
command and verify that the upgraded Node recovers its resources
U2.17 - Check the system
Perform : lppchk -v -m3
oslevel
if you do not get 4.3.3.0 , run oslevel -l 4.3.3.0 to get the filesets which cause the AIX level to be wrong. If you don't use these filesets, remove them (installp -u <Fileset>), otherwise call your support representative.
sysdumpdev -e
to know it), then configure your dump devices. U2.18 - Netscape Communicator
It is recommended to install Netscape Communicator 4.79, delivered in the following CD-ROM :
- Bonus Pack for AIX 4.3 : 76741005-001 U2.19 - Sendmail configuration
NOTE :
When the version 8.9.3 sendmail binary is running with a previous sendmail.cf file, the following warning will appear :
Appendix 1 - How to update a Fiber Channel Adapter Firmware Level
Updating FW on a FC board (whatever the model is) implies loading a specific maintenance and diagnostics driver in AIX for performing the operation. To do that, the adapter must be free of attached devices (i.e rmdev/mkdev of adapter should be possible). So two solutions:
(follow plug/unplug instruction when needed)
diag
command (it will automatically perform a rmdev and mkdev of the adapter, that should succeed if the adapter and the disks are no more used).
Task Selection -> Download Microcode
rmdev -Rl fchan<x>
to check what object is still used (hdisk, fcp, sp ,atf, etc...?). also check IP on FC ( ifconfig fe<x>
down
or detach
) cfgmgr
to put back objects in available state, if needed.
Second solution :
diag
command to download the firmware
For LP7000 and LP8000, an automatic download feature has been added so that, early in the system 's life, and surely before any application is started, the FW version is checked on the FC board, and replaced by a newer one if available. The adapter is free at this time, so the download microcode operation is always possible.