Uninstall WebSphere® ESB for z/OS® by running
the shell script zSMPInstall.sh with the keyword
-uninstall. These instructions describe how to run the install script
with the uninstall keyword from a OS/390® UNIX® command shell. Alternatively you can run
the script and keyword from a prompt using telnet. These instructions
assume you are using TSO, if you are using telnet use the equivalent
commands. These instructions also assume that you have the default
key mappings using the CTRL key to enter input. If you have changed
this configuration, use whichever key you have mapped to enter information
into TSO.
Before you begin
Note: There is no support for a partial or incremental uninstall.
Read the latest technote information on uninstalling WebSphere ESB for z/OS before running
the uninstall script.
The
WebSphere ESB for z/OS install process
assumes that you have a working knowledge of z/OS UNIX System Services. Refer to the following documentation if
you need more information:
Procedure
- Access the OS/390® UNIX® command shell. telnet into USS
directly, or from TSO enter the TSO command OMVS at the ISPF Command
Option 6 or TSO OMVS from any other ISPF panel. Once you are in the UNIX shell, a command prompt (usually a dollar ($) or pound
(#) sign) indicates that the system is ready to accept input.
- Switch to the administrator user ID:
- Change to zos.config/bin in the product
installation file system directory:
cd /usr/lpp/zWESB/V6R2/zos.config/bin
- Add the current directory to the path:
- From the command prompt, run the installation script with
the uninstall command, for example:
zSMPInstall.sh -smproot /wps/pathofWPScode/zWPS/V6R2 -runtime
/WebSphere/V6R1M0/AppServer -uninstall -response
/yourdrivename/yourfoldername/responsefilename.rsp
Type in the absolute path name of the response file according
to your system configuration. The path file names above assume the
uninstaller is using the default response files. If the response file
was customized, the path name must represent the absolute path of
the customized file.
- Wait for the 'Configuration Manager for uninstall complete'
message, and for the command prompt to return.
Results
Running the install script with the -uninstall parameter results
in the following actions:
- WebSphere ESB for z/OS product
features are disabled when the configuration manager runs its scripted
actions. The administrative console plug-in extensions are removed
when the WebSphere ESB for z/OS product features are disabled.
- The WSPROFILE script reverses the augment process on the default WebSphere Application Server profile which removes
all WebSphere ESB functionality.
You are warned that the augmented default profile will be deleted
(if underlying WebSphere Application Server for z/OS or WebSphere Application Server network deployment
for z/OS is being uninstalled) or that you can no
longer use other augmented profiles.
- The post install file is deleted.
- Code base permissions are removed.
If any shared common components are being used by other applications
the command line prompting warns that uninstalling the product may
cause other applications to no longer function correctly.
If
the uninstall command was not successful check the associated log
file and trace files:
- Standard out messages
Standard output messages display
directly on the screen. You can choose to redirect these messages
to a file by using redirect symbol and a file name at the end of the
command line. For example, adding the syntax
>run.log to
the end of the install command redirect the standard output messages
to the file named
run.log in the present working directory.
The standard out messages display as follows:
parsing command arguments...
parsing arguments complete
setting up configuration...
runtimeRootDirName is: /WebSphere/V6R1M0/AppServer
WAS_HOME is: /WebSphere/V6R1M0/AppServer
WBI_HOME is: /WebSphere/V6R1M0/AppServer
running Configuration Manager for uninstall...
Configuration Manager for uninstall complete
unaugmenting profile(s)...
unaugmenting profile(s) complete
- Log file
Log messages are written to the zSMPInstall.log file in the run-time directory. The default location of this file
is /WebSphere/V6R1M0/AppServer/logs/wbi/zSMPInstall.log.
- Trace file
Review the zSMPInstall.trace (ASCII) file
in the run-time directory. The default location for this file is/WebSphere/V6R1M0/AppServer/logs/wbi/zSMPInstall.trace..
There must be no error messages that have an "E" suffix..
You can also carry out the following troubleshooting actions: