[AIX]

Uninstalling a single maintenance level update on AIX

You can remove a single maintenance level update by using the installp command.

About this task

For example, you have installed IBM® MQ for AIX® 9.1.0.0 base, the IBM MQ for AIX 9.1.0.7 fix pack and the IBM MQ for AIX 9.1.0.8 fix pack.

You want to remove the 9.1.0.8 fix pack and leave the 9.1.0.7 fix pack.

Look at the installp command in the AIX manual, and specifically the information on the -r (reject) parameter.

The AIX manual lists a number of options for the installp -r parameter, and the one that is relevant is the -f ListFile option.

The description of the -f ListFile option includes the following statement: Output from the installp -l command is suitable for input to this flag.

You need to obtain a text file using the installp -l command. The AIX manual shows the following invocation for installp -l parameter:

installp { -l | -L } [ -eLogFile ] [ -d Device ] [ -B ] [ -I ] [ -q ] [-E ] 
[ -zBlockSize ] [ -O { [ s ] [ u ] } ]
Note: The principles apply to a User Specified Installation Location (USIL) by using the -R usil-directory option, and to other IBM MQ fix packs.

See Life cycle for a USIL in AIX for non-default installations of MQ for more information on a USIL.

Carry out the following procedure to remove the latest 9.1.0.8 fix pack, and leave the base IBM MQ for AIX 9.1.0.0 and 9.1.0.7 fix packs in place.

Procedure

  1. Issue the following command, # lslpp -la "mqm*":
    You see the following output:
    
+-----------------------------------------------------------------------------+ 
INSTALL ROOT PATH = / 
+-----------------------------------------------------------------------------+ 
Fileset Level State Description 
---------------------------------------------------------------------------- 
Path: /usr/lib/objrepos 
mqm.amqp.rte             9.1.0.0 COMMITTED IBM MQ AMQP Service    
                  9.1.0.7 APPLIED IBM MQ AMQP Service 
                  9.1.0.8 APPLIED IBM MQ AMQP Service 
mqm.ams.rte              9.1.0.0 COMMITTED IBM MQ Advanced - Advanced Message Security  
                  9.1.0.7 APPLIED IBM MQ Advanced - Advanced Message Security  
                  9.1.0.8 APPLIED IBM MQ Advanced - Advanced Message Security 
mqm.base.runtime         9.1.0.0 COMMITTED IBM MQ Runtime for Client and Server 
                  9.1.0.7 APPLIED IBM MQ Runtime for Client and Server 
                  9.1.0.8 APPLIED IBM MQ Runtime for Client and Server
  2. Go to the original directory where the IBM MQ for AIX tar.Z file with the fix pack code, that was downloaded, was stored in the machine and unpacked; for example, cd /downloads/mq9108.
    Expand 9.1.0-IBM-MQ-AixPPC64-FP0008.tar.Z and you see:
    
+++ROOT+++ aglet: /downloads/mq9108
# ls
.toc mqm.msg.Zh_CN.9.1.0.8.U202341
9.1.0-IBM-MQ-AixPPC64-FP0008.tar mqm.msg.Zh_TW.9.1.0.8.U202343
mq9108.installpl.txt mqm.msg.cs_CZ.9.1.0.8.U202327
mqm.amqp.rte.9.1.0.8.U202313 mqm.msg.de_DE.9.1.0.8.U202328
mqm.ams.rte.9.1.0.8.U202312 mqm.msg.en_US.9.1.0.8.U202329
mqm.base.runtime.9.1.0.8.U202314 mqm.msg.es_ES.9.1.0.8.U202330
mqm.base.samples.9.1.0.8.U202315 mqm.msg.fr_FR.9.1.0.8.U202331
mqm.base.sdk.9.1.0.8.U202316 mqm.msg.hu_HU.9.1.0.8.U202332
mqm.client.rte.9.1.0.8.U202317 mqm.msg.it_IT.9.1.0.8.U202333
mqm.ft.agent.9.1.0.8.U202318 mqm.msg.ja_JP.9.1.0.8.U202334
mqm.ft.base.9.1.0.8.U202319 mqm.msg.ko_KR.9.1.0.8.U202336
mqm.ft.logger.9.1.0.8.U202320 mqm.msg.pl_PL.9.1.0.8.U202337
mqm.ft.service.9.1.0.8.U202321 mqm.msg.pt_BR.9.1.0.8.U202338
mqm.ft.tools.9.1.0.8.U202322 mqm.msg.ru_RU.9.1.0.8.U202339
mqm.gskit.rte.9.1.0.8.U202323 mqm.msg.zh_CN.9.1.0.8.U202340
mqm.java.rte.9.1.0.8.U202324 mqm.msg.zh_TW.9.1.0.8.U202342
mqm.jre.rte.9.1.0.8.U202325 mqm.server.rte.9.1.0.8.U202344
mqm.man.en_US.data.9.1.0.8.U202326 mqm.web.rte.9.1.0.8.U202346
mqm.msg.Ja_JP.9.1.0.8.U202335 mqm.xr.service.9.1.0.8.U202345
  3. Issue the following command to obtain the text file mq9108.installpl.txt, to be used later in the procedure: # installp -l -d /downloads/mq9108 > mq9108.installpl.txt
    The output text file looks like the following text.
    Note: Only the first few lines are shown here.
    
 Fileset Name Level I/U Q Content
 ====================================================================
 mqm.amqp.rte 9.1.0.8 S N usr (R)
# IBM MQ AMQP Service
 mqm.ams.rte 9.1.0.8 S N usr (R)
# IBM MQ Advanced - Advanced Message Security
 mqm.base.runtime 9.1.0.8 S N usr,root (R)
# IBM MQ Runtime for Client and Server
 mqm.base.samples 9.1.0.8 S N usr (R)
# IBM MQ Samples
  4. Use the output file from Step 3 as input to the following command: # installp -r -f mq9108.installpl.txt 
    Verifying selections...
done
Verifying requisites...done
Results...
SUCCESSES
---------
 Filesets listed in this section passed pre-reject verification
 and will be rejected.
 Selected Filesets
 -----------------Page 5 of 5
 mqm.amqp.rte 9.1.0.8 # IBM MQ AMQP Service
 mqm.ams.rte 9.1.0.8 # IBM MQ Advanced - Advanced M...
 mqm.base.runtime 9.1.0.8 # IBM MQ Runtime for Client an...
... 
+-----------------------------------------------------------------------------+
Installation Summary
--------------------
Name         Level   Part       Event Result
-------------------------------------------------------------------------------
mqm.amqp.rte 9.1.0.8 USR REJECT SUCCESS
mqm.ams.rte 9.1.0.8 USR REJECT SUCCESS
mqm.base.runtime 9.1.0.8 ROOT REJECT SUCCESS
    Attention: Note the following:
    1. There will be around 30-40 blank lines following "Verifying selections..." and it took some time. you need to wait until the command produces meaningful output.
    2. The output in the preceding text shows only a few lines of the final summary at the end and the result column shows SUCCESS.
  5. Issue the command # lslpp -la "mqm*" again, and you see that the ones for 9.1.0.8 are no longer included:
    You see the following output:
    
+-----------------------------------------------------------------------------+ 
INSTALL ROOT PATH = / 
+-----------------------------------------------------------------------------+ 
Fileset Level State Description 
---------------------------------------------------------------------------- 
Path: /usr/lib/objrepos 
mqm.amqp.rte             9.1.0.0 COMMITTED IBM MQ AMQP Service    
                  9.1.0.7 APPLIED IBM MQ AMQP Service 
mqm.ams.rte              9.1.0.0 COMMITTED IBM MQ Advanced - Advanced Message Security  
                  9.1.0.7 APPLIED IBM MQ Advanced - Advanced Message Security  
mqm.base.runtime         9.1.0.0 COMMITTED IBM MQ Runtime for Client and Server 
                  9.1.0.7 APPLIED IBM MQ Runtime for Client and Server