IBM Support

IBM Java for AIX HowTo: Uninstall IBM Java

Question & Answer


Question

IBM Java for AIX HowTo: Uninstall IBM Java

Answer

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.
Generic Term
Replace with
TMP_PATH
A temporary directory with a minimum of 10 GB of free space (e.g. /large_fs).
MM-DD
The current month and day (e.g. ,01-31).
PMR
The full IBM PMR number (e.g. , PMR12345.b678.c000).
JavaX.jre
The IBM Java 32-bit JRE fileset names (e.g. , Java7.jre, Java71.jre, Java8.jre).
JavaX.sdk
The IBM Java 32-bit SDK fileset names (e.g. , Java6.sdk, Java7.sdk, Java8.sdk).
JavaX_64.jre
The IBM Java 64-bit JRE fileset names (e.g. , Java7_64.jre, Java71_64.jre).
JavaX_64.sdk
The IBM Java 64-bit SDK fileset names (e.g. , Java7_64.sdk, Java8_64.sdk).
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

# installp -pug Java*

{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
.....


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 Support 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
(ref: ZAIX,13A)
Pegasus CIM Server and Provides sysmgt.cim.* Pegasus
(ref: 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
Service Agent bos.esagent Service Agent (ref: 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

A. 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.

B. Install and configure a supported version of the IBM Java for AIX (e.g., Java 6, Java 7, Java7.1 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 uninstalled java with the directory for the supported version (e.g., java6, java7, java7.1 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.

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 AIX MustGather: 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

Document Type:
Instruction
Content Type:
HowTo
Hardware:
all Power
Operating System:
all AIX Versions
IBM Java:
all Java Versions
Author(s):
Christopher C Peters
Reviewer(s):
Roger Leuckie

[{"Product":{"code":"SG9NGS","label":"IBM Java"},"Business Unit":{"code":null,"label":null},"Component":"Not Applicable","Platform":[{"code":"PF002","label":"AIX"}],"Version":"Version Independent","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}}]

Document Information

Modified date:
17 June 2018

UID

isg3T1022690