IBM Java for AIX HowTo: Uninstall IBM Java

This document provides step-by-step instructions for uninstalling IBM Java for AIX software, collecting the required diagnostic files (in cases of a failed uninstall), then uploading the data to the IBM testcase server. Collecting and uploading this information at the time the IBM support call is opened will help expedite the resolution of the issue being reported.

The instructions in this document make references to generic terms in Italics that will need to be replaced with information specific to the support call and the environment. It is very important that consistent and accurate values be used in place of the Italicized generic terms when collecting the data to ensure the prompt and correct delivery of the data when uploaded.

Overview

Step-by-Step Instructions

Step 1:

Pre-Uninstall

A. Confirm that IBM Java 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 java

{Sample output when Java 6 32-bit or Java 6 64-bit is installed}
..
/usr/lib/objrepos:Java6.sdk:6.0.0.471::COMMIT:COMPLETE:07/15/15:08;57;18
/usr/lib/objrepos:Java6_64.sdk:6.0.0.474::COMMIT:COMPLETE:07/15/15:09:06;27
..

If no output is returned after executing the above command, IBM Java 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.

B. Confirm if dependent software for IBM Java 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:

# lslpp -d "JavaX.*"

and/or

# lslpp -d "JavaX_64.*"

{Sample output when there is Java6_64.sdk installed and it has dependent software}

Fileset Dependents
----------------------------------------------------------------------------
is a requisite of
Path: /usr/lib/objrepos
Java6_64.sdk 6.0.0.592

csm.gui.dcem 1.7.1.0
lwi.runtime 5.3.10.0

{Sample output when there is Java6)64.sdk installed and it has no dependent software}

Fileset Dependents
----------------------------------------------------------------------------
is a requisite of
Path: /usr/lib/objrepos
Java6.sdk 6.0.0.590 NONE
Java6_64.sdk 6.0.0.570

C. When in doubt, open an IBM support call to validate if and how to remove IBM Java for AIX for dependent software

If it is determined that the dependent software IS NOT being used on the system, it can simply be disabled and/or removed.
If there is any doubt whether or not the dependent software can be disabled or removed, it is recommended to open an IBM support call to the appropriate team. When opening the IBM support call, please indicate the Feature/Product Name, the Matching Fileset Name, and the IBM Support Team for correct routing of the support call (and faster service).

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)
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
IBM Java specific issues (unrelated to above components)	Java*	AIX Java

Step 2:

Uninstall

A. ** Important Notice **

When uninstalling the *.jre filesets (e.g., JavaX.jre, or JavaX_64.jre) for Java7, Java71, Java8, or higher versions, the corresponding *.sdk filesets (e.g., JavaX.sdk and/or JavaX_64.sdk) must also be uninstalled as these are dependent filesets.

B. To begin the uninstall of IBM Java 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 "JavaX.jre", "JavaX.sdk", "JavaX_64.jre", and/or "JavaX_64.sdk" filesets by pressing the F7 key (or ESC+7 keys). Once all the desired IBM Java 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 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.B.1 to Step 2.B.8 for other systems that have IBM Java for AIX installed.

Step 3:

Post-Uninstall

Confirm the IBM Java for AIX has been successfully uninstalled

From a command prompt, and while logged in as the root user, execute the commands:

# lslpp -hac | grep -i javaX

No output should be displayed.

Step 4:

Troubleshoot

If the uninstall of IBM Java 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.B:

# mkdir -p /TMP_PATH/MM-DD/javaX_uninstall/data

# cd /TMP_PATH/MM-DD/javaX_uninstall/data

# cp ${HOME}/smit.* ./

# cd /TMP_PATH/MM-DD/javaX_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 AIXMustGather: How to upload diagnostic data and testcases to IBM" web page:

http://www-01.ibm.com/support/docview.wss?uid=isg3T1022619

Step 5:

ACTION

Step 6:

ACTION

Step 7:

ACTION

Step 8:

ACTION

Step 9:

ACTION

Step 10:

ACTION

Step 11:

ACTION

Step 12:

ACTION

Step 13:

ACTION

Step 14:

ACTION

Step 15:

ACTION

Step 16:

ACTION

Step 17:

ACTION

Step 18:

ACTION

Step 19:

ACTION

Step 20:

ACTION

Step 21:

ACTION