A. ** Important Notice: IBM Java 5 for AIX support ends September 30, 2015. For more information, please read the web page:
https://www.ibm.com/developerworks/java/jdk/lifecycle/index.html
B. Confirm that IBM Java 5 for AIX is currently installed on the system
From a command prompt, and while logged in as the root user (or a user with system authority), execute the commands:
# lslpp -hac | grep -i java5
{Sample output when Java 5 32-bit or Java 5 64-bit is installed}
..
/usr/lib/objrepos:Java5.sdk:5.0.0.592::APPLY:COMPLETE:04/27/15:08;40;50
/usr/lib/objrepos:Java5_64.sdk:5.0.0.570::COMMIT:COMPLETE:03/15/15:10;46;42
..
If no output is returned after executing the above command, IBM Java 5 for AIX is not installed as part of the base operating system, and there is no need to continue with these instructions.
If there output similar to the above is displayed, then proceed with the remainder of these instructions.
C. Confirm if dependent software for IBM Java 5 for AIX is installed on the system
From a command prompt, and while logged in as the root user (or a user with system authority), execute the command:
# installp -pug Java5_64.sdk
{Sample output when there is dependent software}
------------------
.....
Dependency Failures
(Deinstall Operation)
---------------------
SELECTED FILESETS: The following is a list of filesets that you asked to remove. They cannot be removed until all of their dependent filesets are also removed. See subsequent lists for details of dependents.
Java5_64.sdk 5.0.0.430 # Java SDK 64-bit
INSTALLED DEPENDENTS: The following filesets are dependents of one or more of the selected filesets listed above. These must be removed before or with the filesets that you selected. To remove these dependents with the selected filesets, specify the option to automatically remove dependent software (-g flag).
bos.perf.gtools.perfwb 7.1.0.0 # Performance Workbench
eclipse2.rte 2.1.3.0 # Eclipse Integrated Tool Plat...
End of Failure Section
If any dependents are listed in the output of the above command, to check for any dependents for those dependent filesets, run:
# lslpp -d /DEPENDENT/
{Sample output when there is dependent software}
Fileset Dependents
------------------------------------------------------------------------
/DEPENDENT/ is a requisite of /DEPENDENTS/
Path: /usr/lib/objrepos
bos.perf.gtools.perfwb 7.1.0.0 bos.perf.gtools.procmon 7.1.1.0
If there are no dependent(s) of the software that is an installed dependent of Java5, run command below to uninstall Java and its installed dependents:
# installp -ug Java5_64.sdk
{Sample output}
......
Installation Summary
--------------------
Name Level Part Event Result
------------------------------------------------------------------------ -------
bos.perf.gtools.perfwb 7.1.0.0 USR DEINSTALL SUCCESS
eclipse2.rte 2.1.3.0 USR DEINSTALL SUCCESS
Java5_64.sdk 5.0.0.430 ROOT DEINSTALL SUCCESS
Java5_64.sdk 5.0.0.430 USR DEINSTALL SUCCESS
-----------------------------------
......
D. When in doubt, open an IBM support call to validate if and how to remove IBM Java 5 for AIX for dependent software
Feature/Product Name | Matching Fileset Name | IBM Supprt Team |
WebSM pconsole (IBM System Director Console) |
pconsole: lwi.runtime WebSM: sysmgt.sguide.rte sysmgt.websm.framework sysmgtlib.framework.core |
AIX Install |
Cluster Systems Management (CSM) | csm.* cas.* |
Cluster Mgmt (Queue: ZAIX,13A) |
Pegasus CIM Server and Provides | sysmgt.cim.* | Pegasus (Queue: PEGCIM,163) |
System Management Services Library | sysmgtlib.framework.core | AIX Install |
AIXPert websm component | bos.aixpert.websm.* | AIX Commands and Libraries |
IPSEC websm component | bos.net.ipsec.websm | AIX Network Application |
Electronic Customer Care (ECC) | bos.ecc_client.rte | Power Systems Hardware Management Console (HMC) (Queue: HMC,308) |
License Use Management | lum.base.gui ifor_ls.java.gui |
AIX Install |
Service Agent | bos.esagent | Service Agent (Queue: ESER6,163) |
License Use Management | lum.base.gui ifor_ls.java.gui |
AIX Install |
General AIX uninstall Issues | Issues with uninstalling the Java5 filesets | AIX Install |
Solution Install | bos.installers.si | AIX Install |
Distributed Systems Management | dsm.core | AIX Install |
Eclipse Integrated Tool Platform (References not expected) |
eclipse2.rte | Not Available |
Lpar Deployment Wizard (HMC) | ios.ldw.* | AIX VIrtualization |
PowerVM / VIOS | No known fileset dependencies | AIX Virtualization |
Java 5 specific issues (unrelated to above components |
Java5* | AIX Java |
A. To begin the uninstall of IBM Java 5 for AIX, from a command prompt, and while logged in as the root user, execute the command:
# smitty remove
{Follow these instructions to complete the uninstall using the SMIT utility}
1. On the panel "Remove Installed Software", scroll to the "SOFTWARE name" field, then press the F4 key (or ESC+4 keys) to view the list of installed software
2. Scroll down and select "Java5.sdk" and/or "Java5_64.sdk" filesets by pressing the F7 key (or ESC+7 keys). Once all Java5 filesets have been selected, press the ENTER key to return the previous panel
3. Scroll to the "PREVIEW only" field , then press the TAB key to change the value to "no"
4. Scroll to the "REMOVE dependent software?" field, then press the TAB key to change the vlaue to "yes" or "no" depending on whether or not the dependent software should be removed
5. In most cases, using the default values for the remainder of the items is adequate. However, do change the values that are appropriate for the situation.
6. Press the ENTER key twice to proceed with the uninstall of IBM Java 5 for AIX
7. Once the uninstall process begins, monitor the "COMMAND STATUS" section (upper left corner of screen) for the progress of the uninstall
{Sample output for different stages of the uninstall process}
{While the process is running}
COMMAND STATUS
Command: Running stdout: yes stderr: no
.......
{Return message for a successful uninstall}
COMMAND STATUS
Command: OK stdout: yes stderr: no
.......
{Return message for an unsuccessful uninstall}
COMMAND STATUS
Command: Failed stdout: yes stderr: no
.......
8. Exit the smitty utility once the process has completed by pressing the F10 key (or ESC+0 keys)
9. Repeat Step 2.A.1 to Step 2.A.8 for other systems that have IBM Java 5 for AIX installed.
A. Confirm the IBM Java 5 for AIX has been successfully uninstalled
1. From a command prompt, and while logged in as the root user, execute the commands:
# lslpp -hac | grep -i java5
No output should be displayed.
B. Install and configure a supported version ofthe IBM Java for AIX (e.g., Java 6, Java 7, or Java 8)
1. Use the "IBM Java for AIX Reference: Service Information and Download Guide" web page:
http://www-01.ibm.com/support/docview.wss?uid=isg3T1022644
to download and install a supported version of the IBM Java for AIX.
2. Using a command line text editor (such as "vi" or "emacs"), modify the "/etc/environment" file by replacing the references to "java5" with the directory for the supported version (e.g., java6, java7, or java8) in the "PATH" environment variable. Save the file once the changes are complete.
{Example of an existing PATH variable before being updated}
PATH=/usr/bin:/etc:/usr/sbin:/usr/ucb:/usr/bin/X11:/sbin:/usr/java5/jre/bin:/usr/java5/bin:/usr/local/bin:/usr/vacpp/bin:/usr/vac/bin
{Example of the PATH variable after being updated, assuming that IBM Java 7 for AIX was installed)
PATH=/usr/bin:/etc:/usr/sbin:/usr/ucb:/usr/bin/X11:/sbin:/usr/java7/jre/bin:/usr/java7/bin:/usr/local/bin:/usr/vacpp/bin:/usr/vac/bin
3. For the changes to take effect, relogin as the required user id, then restart the processes from the new login session.
A. If the uninstall of IBM Java 5 for AIX failed and the issue could not be resolved, it is recommended that the following data be collected and uploaded to a new IBM support call which has been routed to the "AIX Install" team or "AIX Java" team.
1. Collect and package the SMIT log files by executing the following commands from a command prompt using the user id used to run the SMIT in Step 2.A:
# mkdir -p /TMP_PATH/MM-DD/java5_uninstall/data
# cd /TMP_PATH/MM-DD/java5_uninstall/data
# cp ${HOME}/smit.* ./
# cd /TMP_PATH/MM-DD/java5_uninstall
# tar -cf - data | gzip -c > PMR.MM-DD.tgz
2. Upload the packaged data using one of the IBM secure upload methods listed on the "IBM Java for AIX MustGather: How to upload diagnostic data and testcases to IBM" web page:
http://www-01.ibm.com/support/docview.wss?uid=isg3T1022619