Previous Contents Index Next |
Setup Util Programmer's Guide |
Chapter 11 Uninstalling
This chapter shows you how to uninstall products using the Setup Util and Common Install Shell. It contains the following sections:
How the Setup Util Uninstalls Products
The Uninstallation Shell provides a common interface for removing all products installed by the Common Install Shell. The Uninstallation Shell provides a user interface that is consistent with the Common Install Shell.
During installation, the Common Install Shell logs the destination of each copied file. The uninstallation shell uses this information to remove the installed software. As with installation, if you have special uninstallation requirements, you can write pre- and post-uninstallation programs.
The Uninstallation Shell works in conjunction with the Common Install Shell. Before any files are removed, the Common Shell prepares the environment and writes any necessary directives to the appropriate Package Information Files. These Information Files are placed in the serverroot/setup/componentNickname directories for use by the Uninstallation Shell. When the Uninstallation Shell reads a Package Information Files, it has all the information it needs to remove a product.
You cannot remove the base package or the Administration Server until you have uninstalled all other server binaries.
Writing Pre- and Post-Uninstallation Programs
If you want to perform certain operations before or after uninstallation, you can do so through the use of pre- and post-uninstallation programs.
A pre-uninstallation program is typically used to gather necessary information, such as user names and passwords, before removing directory entries and files. A post-uninstallation program uses the results of a pre-uninstallation program to display status messages or update system configuration settings.
Pre- and post-uninstallation programs are written in the same way as pre- and post-installation programs. On UNIX, they are stand-alone applications; on Windows NT, they are part of a DLL.
For more information on pre- and post-installation programs, see Chapter 4 "Writing Pre-Installation Programs" and Chapter 6 "Writing Post-Installation Programs."
Performing an Uninstallation
When you install a product, the Uninstallation Shell is copied to the server root. Launch this shell to uninstall a product.
Note You cannot remove the base package or Administration Server until you have uninstalled all other servers.
If you are using pre- and post-uninstallation programs, you must specify them in your Package Information File through the use of the PreUninstall and PostUninstall directives. For more information on using directives, see Chapter 3 "Information Files."
To Invoke the Uninstallation Shell
UNIX: At the server root, enter the following:
uninstall [-s -t -u adminID -p password]
Windows NT: From the server root, run the following:
uninst.exe [-s -t -u adminID -p password]
On both platforms, you can specify the following arguments:
Previous Contents Index Next
Copyright (C) 2005 Red Hat, Inc. All rights reserved.
This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/
Last Updated September 21, 2001