Question & Answer
Question
IBM Java for AIX HowTo: Uninstall IBM Java
Answer
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.
Pre-Uninstall
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 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 |
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.
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.
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
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
ACTION
Was this topic helpful?
Document Information
Modified date:
17 June 2018
UID
isg3T1022690