Previous Contents Index Next |
Sun Java Enterprise System 2004Q2 Installation Guide

> ## Chapter 10
> Uninstalling Software

> This chapter provides instructions for uninstalling Java Enterprise System component products from your system. Before starting the tasks in this chapter, you should read the entire chapter and also be familiar with the Java Enterprise System installation processes.

> This chapter contains the following sections:

> - Planning for Uninstallation
> - Running the Uninstaller in Graphical Mode
> - Running the Uninstaller in Text-Based Mode
> - Running the Uninstaller in Silent Mode
> - Post-uninstallation Tasks

> Caution | Do not use the Java Enterprise System uninstaller to uninstall Sun Cluster software. For more information, see Sun Cluster Software and Sun Cluster Agents for Sun Java System.

> ##

> Planning for Uninstallation

> The Java Enterprise System uninstallation modes are the same as the modes available for installation: interactive graphical and text-based interface as well as silent uninstallation using a parameter file you provide. During installation, the Java Enterprise System installation program places the Java Enterprise System uninstaller at the following location:

> /var/sadm/prod/entsys/uninstall

> This section provides an overview of Java Enterprise System uninstallation. The following topics are addressed:

> - Overview
> - How Product Interdependencies Affect Uninstallation
> - Pre-uninstallation Checklist

> ### Overview

> The Java Enterprise System uninstaller might behave differently depending on which component products you installed and how they are interrelated. Keep the following in mind when running the uninstaller:

> - The uninstaller must be run separately on each host that contains Java Enterprise System components. For each host on which you run the uninstaller, you can select one or more component products for removal.
> - The uninstaller only removes component products that were installed by the Java Enterprise System installer. To remove component products that were not installed by the Java Enterprise System installer, follow instructions in the component product documentation.
> - The uninstaller checks product dependencies only for the system on which it is running, issuing warnings when it discovers a dependency. For more information on dependencies that affect removal of software, refer to How Product Interdependencies Affect Uninstallation.
> - The uninstaller does not remove Java Enterprise System shared components.
> - The uninstaller might remove configuration and user data files.

> The configuration and user data files that are removed by the uninstaller varies for each component product. After uninstallation completes, you might have to remove some additional files and directories. For product-by-product information, refer to Component Product Uninstallation Details.

> ### How Product Interdependencies Affect Uninstallation

> Before uninstalling, you need to plan how to handle the impact of uninstallation on the component products that are installed. The following interdependencies must be planned for:

> - What component products depend on the product you are uninstalling?

> If one component product depends on another component product, the dependent product cannot function if you uninstall the component product it needs.

> - What component products are supported by the product you are uninstalling?

> In most cases, you can uninstall a supported component product without affecting the functionality of the component product it depends on.

> #### Recognized Dependencies

> The Java Enterprise System uninstaller recognizes dependencies only among products that are installed on the same host. If you attempt to uninstall a component that has dependent products on the same host, the uninstaller issues a warning before proceeding with the uninstallation.

> For example, if you attempt to uninstall Identity Server from the host where Portal Server is also installed, the uninstaller warns you that Portal Server depends on Identity Server.

> Also, prior to uninstalling a Messaging Server that has been installed on its own system, you should unconfigure the Administration Server by running:

> /usr/bin/mpsadmserver unconfigure

> Then run the uninstaller.

> #### Unrecognized Interdependencies

> The Java Enterprise System uninstaller does not recognize the following interdependencies:

> - Product Dependencies from Remote Hosts
> - Products That Support Other Component Products
> - Product Dependencies Resulting from Configuration

> ##### Product Dependencies from Remote Hosts

> Some component product dependencies can be satisfied with component products deployed on remote hosts. However, the uninstaller does not recognize these dependency relationships.

> For example, the following dependencies can be satisfied by component products deployed on remote hosts:

> - Identity Server dependency on Directory Server
> - Administration Server dependency on Directory Server
> - Calendar Server dependency on Directory Server
> - Directory Proxy Server dependency on Directory Server

> For example: if you uninstall Directory Server, the uninstaller does not warn you that Identity Server depends on Directory Server, even if both products are deployed on the same host. This is because another Directory Server instance on another host could support Identity Server. This example could apply to any of the dependencies in the bulleted list above.

> ##### Products That Support Other Component Products

> The uninstaller does not recognize when one component product supports another component product.

> For example, Identity Server supports Portal Server. If you attempt to uninstall Portal Server, the uninstaller does not warn you of this dependency because Identity Server can function without Portal Server.

> Caution | When uninstalling a component product, you must identify which products support that component and perform any additional configuration required. Otherwise, you may have component products on your system that are configured to support products that are no longer present.

> ##### Product Dependencies Resulting from Configuration

> The uninstaller does not recognize a product dependency that is the result of post-installation configuration.

> For example, suppose you install both Portal Server and Calendar Server on the same host, and then configure Portal Server to use Calendar Server for the Portal Server’s calendar channel. Portal Server now depends on Calendar Server. If you uninstall Calendar Server, the uninstaller does not warn you that Portal Server depends on Calendar Server.

> Caution | Identify product dependencies that result from configuration and take appropriate measures, such as backing up data, unconfiguring the dependent product from the supporting product, or uninstalling the components in the proper order.

> ### Pre-uninstallation Checklist

> The following table lists the tasks that you should perform before beginning uninstallation. The left column lists the order in which you should perform the tasks, the middle column describes the action to take, and the right column contains other useful information and the location of instructions.

> Table 10-1 Pre-uninstallation Tasks

> Order | Task | Instructions and Helpful Information
> --- | --- | ---
> 1 | Review the software that has been installed on your system by the Java Enterprise System installer. | Reviewing the Installed Java Enterprise System Components
> 2 | Review the needs and behaviors of each component product you are going to uninstall. | How Product Interdependencies Affect Uninstallation Component Product Uninstallation Details
> 3 | Make a copy of the product registry file, /var/sadm/install/productregistry. | The backup copy of the product registry is helpful in recovering if uninstallation fails.
> 4 | Back up or archive configuration or user data for component products you are uninstalling if you plan to reuse this data in subsequent installations. | Component Product Uninstallation Details Component product documentation: http://docs.sun.com/prod/entsys.04q2
> 5 | Make sure the Directory Server instance that hosts the configuration directory is running. | This Directory Server instance must be running so the uninstaller can unconfigure the component products you are uninstalling.
> 6 | If needed, gather administrator access information for Administration Server, Directory Server, and Identity Server. | Administrator Access for the Uninstaller.

> #### Reviewing the Installed Java Enterprise System Components

> Perform one of the following procedures to review the Java Enterprise System component product software that is already installed on each host:

> - To Use the Uninstaller for Viewing Installed Software
> - To Use the prodreg Utility to View Installed Software

> ##### To Use the Uninstaller for Viewing Installed Software

> 1. As root, run the Java Enterprise System uninstaller from the /var/sadm/prod/entsys directory as follows:

> ./uninstall -no

> The optional -no parameter runs the uninstaller but does not uninstall any software. This option is also useful for familiarizing yourself with the uninstaller and for creating a state file for a subsequent silent uninstallation.

> 2. Proceed through the uninstaller pages until you reach the list of installed products.
> 3. After viewing the list of installed component products, exit the uninstaller.

> No software has been uninstalled.

> ##### To Use the prodreg Utility to View Installed Software

> You can use the prodreg utility to view information about all packages installed on your system, including Java Enterprise System components. The prodreg utility opens a window that provides information about installed packages. This information is useful when checking for product dependencies. The prodreg utility also indicates packages that are incomplete and might need special handling. The prodreg utility is available with Solaris 9 operating system and some versions of Solaris 8 operating system.

> #### Administrator Access for the Uninstaller

> Depending on the components you elect to uninstall, you might need to grant the uninstaller administrator access to Administration Server, Directory Server, and Identity Server.

> - Administration Server and Directory Server administrator access is required to manage the configuration directory during uninstallation
> - Identity Server administrator access is required to undeploy the Identity Server web applications from the Application Server and to remove the Identity Server schema.

> The table in this section describes the information the uninstaller needs in order to be granted administrator access for Administration, Directory, and Identity Servers. The left column of each table lists the graphical mode labels and state file parameters for the information you must provide. The right column describes the information.

> Table 10-2 Required Administration Information

> Label and State File Parameter | Description
> --- | ---
> Administration Server
> Administrator User ID ADMINSERV_CONFIG_ADMIN_USER | User ID of the configuration directory administrator. Administration Server uses this identity when managing configuration directory data.
> Administrator User Password ADMINSERV_CONFIG_ADMIN_PASSWORD | Password for the configuration directory administrator.
> Directory Server
> Administrator User ID CONFIG_DIR_ADM_USER | User with administrator privileges for the configuration directory. This user can modify Directory Server configuration, including creating and removing suffixes, but access control restrictions apply.
> Administrator Password CONFIG_DIR_ADM_PASSWD | Password for the Administrator.
> Identity Server
> Administrator User ID IS_IAS7_ADMIN | User ID of the Application Server administrator.
> Administrator Password IS_IAS7_ADMINPASSWD | Password of the Application Server administrator.
> Directory Manager DN IS_DIRMGRDN | Distinguished Name (DN) of the user who has unrestricted access to Directory Server. Default value is cn=Directory Manager.
> Directory Manager Password IS_DIRMGRPASSWD | Password of the Directory Manager.

> ##

> Running the Uninstaller in Graphical Mode

> After you have completed the Pre-uninstallation Checklist, you are ready to run the uninstaller. This section contains the following procedures for uninstalling in graphical mode:

> - To Start the Graphical Uninstaller
> - To Select Components to Uninstall
> - To Grant Administrator Access
> - To Confirm Uninstallation Readiness
> - To Complete the Uninstallation Session

> For instructions on using text-based mode or silent mode to uninstall Java Enterprise System component products, refer to Running the Uninstaller in Text-Based Mode or Running the Uninstaller in Silent Mode.

> If you have problems during uninstallation, refer to Chapter 11, "Troubleshooting".

> ##### To Start the Graphical Uninstaller

> 1. Provide access to your local display.
> - The Java Enterprise System installer may need access to your local display. If you are logging in to a remote machine, or using the su command to become superuser on a local machine, use the xhost command on the local machine to allow access to your local display. For example, use the following command to grant access to all users:

> xhost +

> - If you are logging in to a remote machine, make sure your DISPLAY environment variable is properly set to the local display. If the DISPLAY variable is not set properly, the installer runs in text-based mode.
> - Example for C Shell (machine name myhost):

> setenv DISPLAY myhost:0.0

> - Example for Korn Shell (machine name myhost):

> DISPLAY=myhost:0.0

> 2. If you are not logged in as root, become superuser.
> 3. Navigate to the following directory:

> cd /var/sadm/prod/entsys/

> 4. Start the graphical uninstaller:

> ./uninstall

> The Welcome page is displayed.

> 5. Click Next to proceed.

> ##### To Select Components to Uninstall

> The Select Components page lists all possible Java Enterprise System components on your system.

> 1. Examine the default selections and deselect any component product you do not want to uninstall.
> - Component products that are installed on your system are automatically selected for removal. Component products that are not installed on your system are disabled and cannot be selected.
> - Some component products contain subcomponents. You can expand these components to view the subcomponents.
> - If all the subcomponents for a component are selected, you can deselect them all by deselecting the parent component.
> - To select a component and all its subcomponents, expand the component and select each subcomponent. You cannot simply select the parent component.
> - If you deselect a component that contains subcomponents, expand the component to verify the subcomponent list.
> 2. After you are satisfied with your selections, click Next.
> 3. If the uninstaller detects any recognizable product dependencies among the products selected for removal, a warning about a potential loss of configuration data is displayed. Your choices are:
> 1. Click Continue to continue with uninstallation.
> 2. Click Close to return to the Component Product Selection page.

> ##### To Grant Administrator Access

> Depending on the component products you selected for removal, the uninstaller prompts you for administrator IDs and passwords. For details on the information you must provide the uninstaller, refer to Administrator Access for the Uninstaller.

> 1. Provide the required administrator information.
> 2. Click Next to continue with uninstallation.

> ##### To Confirm Uninstallation Readiness

> Before removing software from your system, the uninstaller displays the Ready to Uninstall page which shows the components you have selected for removal and the total disk space that will be reclaimed.

> 1. Review the uninstallation selections you have made.
> 1. If changes are needed, click Back through successive pages until the Component Selection page appears.
> 2. Make changes as needed on the Component Selection page.
> 3. Click Next to proceed again through the uninstaller pages.

> The uninstaller remembers previously-specified values. You can modify any value you previously specified.

> 2. At the Ready to Uninstall page, click Next when you are satisfied with your selections.

> The uninstaller begins removing software from your system and displays the following:

> - A progress bar that displays the overall completion percentage
> - The name of package currently being removed

> ##### To Complete the Uninstallation Session

> After all component product software has been removed, the uninstaller displays the Uninstallation Complete page.

> 1. Click View Summary or View Log for information about the uninstallation.
> - The uninstallation summary lists each component uninstalled and its uninstallation and unconfiguration status.
> - The uninstallation log lists the uninstaller’s log messages.

> You can also review the uninstallation summary and log files at the following location:

> /var/sadm/install/logs

> 2. Click Close to exit the uninstaller.
> 3. If you uninstalled Messaging Server, Portal Server, or Sun Cluster 3.1 4/04 software, proceed to Post-uninstallation Tasks to complete the post-uninstallation tasks.

> ##

> Running the Uninstaller in Text-Based Mode

> The text-based interface allows you to run the uninstaller directly from a terminal window by responding to prompts displayed in the window. Navigation techniques in text-based mode for the uninstaller differ slightly from the navigation techniques for the installer.

> Text-based uninstaller prompts are explained in the following table.

> Table 10-3 Text-Based Uninstaller Prompts

> Action | Input
> --- | ---
> Accept default values Default values are indicated in square brackets ([ ]) | Press Return.
> Select an item from a list | Type the number associated with the item, then press Return
> Accept list selections For example, you are finished selecting from a list and want to continue. | Type the numeral 0 (zero), then press Return.
> Provide a value to a text field For example, when prompted to supply a user name or port number. | Type the value, then press Return.
> Provide a password | Type the password, then press Return. The password is not echoed to the terminal window
> Return to the previous page in the uininstaller | Type the character <, then press Return.
> Exit the uninstaller | Type the character !, then press Return.

> After you have completed the tasks in Pre-uninstallation Checklist, you are ready to run the uninstaller. This section contains the following procedures for uninstalling in text-based mode:

> - To Start the Uninstaller in Text-Based Mode
> - To Select Component Products for Uninstallation
> - To Grant Administrator Access
> - To Confirm Uninstallation Readiness
> - To Complete the Uninstallation Session

> If you have problems during uninstallation, refer to Chapter 11, "Troubleshooting".

> ##### To Start the Uninstaller in Text-Based Mode

> 1. If you are not logged in as root, become superuser.
> 2. Navigate to the following directory:

> cd /var/sadm/prod/entsys/

> 3. Run the uninstaller:

> ./uninstall -nodisplay

> The Welcome message is displayed followed by a list of all possible Java Enterprise System components on your system.

> ##### To Select Component Products for Uninstallation

> Refer to Text-Based Uninstaller Prompts to select and deselect component products for uninstallation.

> Note | The uninstaller automatically selects for removal any Java Enterprise System components it finds on your system.

> 1. To select additional components for removal. Type the corresponding number for a component you want to uninstall and press Return. For example, type 1 to select Web Server for uninstallation.

> The uninstaller does not allow you to select multiple components for uninstallation. You must loop through for each additional component you want to uninstall.

> Note | If you install Java Enterprise System component products in multiple sessions, you must loop through the Product Selection List multiple times to select the products for uninstallation. You cannot specify a comma separated list during the selection.

> 2. To deselect additional components for removal, type the corresponding number and press Return. For example, 1 is corresponding number for Web Server. Type 1 to deselect it for uninstallation and press Return.

> The uninstaller does not allow you to deselect multiple components. You must loop through for each additional component you want to deselect for uninstallation.

> 3. After you are satisfied with your selections, type the number 0 (zero) and press Return.

> If the uninstaller detects product dependencies among the products selected for removal, a warning about a potential loss of configuration data is displayed. Your choices are:

> 1. Type Yes and press Return to continue with uninstallation.
> 2. Type No and press Return to return to the Component Product Selection page.
> 3. Type the character ! and press Return to exit the uninstallation.

> ##### To Grant Administrator Access

> If you selected a product for which the uninstaller needs an administrative ID or password, the uninstaller prompts you for administrator IDs and passwords. For details on the information you must provide the uninstaller, refer to Administrator Access for the Uninstaller.

> 1. Provide the required administrator information.
> 2. Click Next to continue with uninstallation.

> ##### To Confirm Uninstallation Readiness

> Before removing software from your system, the uninstaller displays a summary page, showing the components selected for removal.

> 1. Review your selections.
> 1. If changes are needed, type the < character and press Return to go back through successive pages until the Component Selection list appears.
> 2. Make changes as needed on the Component Selection list.
> 3. Proceed again through the uninstaller screens.
> 2. When you are satisfied with your selections type the number 1 and press Return.

> The uninstaller begins removing software from your system. During uninstallation, the uninstaller displays a progress bar that displays the overall completion percentage.

> ##### To Complete the Uninstallation Session

> After all component product software has been removed, you can view the uninstallation summary and log.

> 1. Type 1 or 2 and press Return to information about the uninstallation.
> - Uninstallation summary. Type 1 to list the component products that were uninstalled and then lists configuration information for the components.
> - Uninstallation log. Type 2 to list all messages generated by the uninstaller during uninstallation.

> You can also view the uninstallation summary and log files at the following location:

> /var/sadm/install/logs

> 2. Type the ! character to exit the uninstaller.
> 3. If you uninstalled Messaging Server, Portal Server, or Sun Cluster 3.1 4/04 software, proceed to Post-uninstallation Tasks to complete the post-uninstallation tasks.

> ##

> Running the Uninstaller in Silent Mode

> Silent uninstallation is useful for uninstalling Java Enterprise System components on multiple hosts that share similar configurations.

> The procedure for uninstalling in silent mode is similar to the procedure for installing in silent mode as described in Chapter 6, "Installing Software in Silent Mode".

> This section contains the following procedures:

> - To Generate a State File
> - To Edit the State File for the Hosts
> - To Run the Uninstaller in Silent Mode
> - To Monitor the Progress of a Silent Uninstallation

> ##### To Generate a State File

> To create a state file for the silent installation, you must generate a state file by first running the uninstaller in either graphical or text-based mode as follows:

> 1. If you are not logged in as root, become superuser.
> 2. Navigate to the following directory:

> cd /var/sadm/prod/entsys/

> 3. If you are using the graphical interface of the uninstaller, provide access to your local display.
> - The Java Enterprise System installer may need access to your local display. If you are logging in to a remote machine, or using the su command to become superuser on a local machine, use the xhost command on the local machine to allow access to your local display. For example, use the following command to grant access to all users:

> xhost +

> - If you are logging in to a remote machine, make sure your DISPLAY environment variable is properly set to the local display. If the DISPLAY variable is not set properly, the installer runs in text-based mode.
> - Example for C Shell (machine name myhost):

> setenv DISPLAY myhost:0.0

> - Example for Korn Shell (machine name myhost):

> DISPLAY=myhost:0.0

> 4. Run the uninstaller with the following command:

> ./uninstall [-no] [-nodisplay] -saveState statefile

> where:

> -no | Prevents the uninstaller from removing software.
> -nodisplay | Starts the uninstaller in interactive text-based mode. If you do not specify this option, the uninstaller starts in graphical mode.
> -saveState | Instructs the uninstaller to generate a state file at the location specified by statefile. Specify an absolute or relative path to the state file you want to create.
> statefile | Specifies an absolute or relative path to the generated state file.

> 5. Proceed through the uninstaller to completion.

> As you respond to the uninstaller, the uninstaller records your answers in the specified state file. When you complete the uninstallation, the state file is available in the location that you specified.

> ##### To Edit the State File for the Hosts

> Edit a copy of the state file for each host on which you are going to perform a silent uninstallation, providing information specific to each host. For information on editing state files, refer to Editing the State File. Editing the state file might also include generating a state file ID, as explained in Creating a Platform-Appropriate State File ID.

> ##### To Run the Uninstaller in Silent Mode

> 1. Verify that you have properly prepared and edited the state file for the host where you want to uninstall Java Enterprise System components.
> 2. Open a terminal window.
> 3. If you are not logged in as root, become superuser.
> 4. Navigate to the following directory:

> cd /var/sadm/prod/entsys/

> 5. Start the uninstaller, using the following format:

> ./uninstall -noconsole -state statefile

> where:

> -nodisplay | Suppresses the graphical display.
> -noconsole | Starts the uninstaller in silent mode, suppressing the user interface.
> -state | Uses the specified statefile as input to a silent uninstallation.
> statefile | Specifies an absolute or relative pathname to a statefile.

> ##### To Monitor the Progress of a Silent Uninstallation

> 1. In a terminal window, navigate to the log file directory.

> cd /var/sadm/install/logs

> 2. Locate the log files for the current uninstallation. The log file of interest for monitoring purposes is:

> Java_Enterprise_System_uninstall.Btimestamp

> The timestamp variable represents the time the log was created. It has the format MMddhhmm, where:

> MM | Specifies the month
> dd | Specifies the date
> hh | Specifies the hour
> mm | Specifies the minute

> 3. Use the tail command to watch messages as they are written to the logs.

> For example:

> tail -f log-file-name

> ##

> Post-uninstallation Tasks

> This section provides instructions for tasks that you might need to perform after uninstalling Java Enterprise System component products from your system. The actual tasks required depend on which components you chose to uninstall.

> - Messaging Server Tasks
> - Identity Server Tasks
> - Sun Cluster Software and Sun Cluster Agents for Sun Java System

> ### Messaging Server Tasks

> In some cases, the uninstaller might not be able to remove some or all of your installation files. To do a final cleanup, remove the Messaging Server base directory and its contents. The default base directory is at the following location:

> /opt/SUNWmsgsr

> You can also remove the configuration directory for Messaging Server. The default configuration directory for Messaging Server is at the following location:

> /var/opt/SUNWmsgsr

> #### sendmail Configuration

> After uninstalling Messaging Server, undo any sendmail configuration for Messaging Server.

> ### Identity Server Tasks

> If you uninstall Identity Server but not its web container (Administration Server or Web Server), you need to apply configuration changes to the instance where was Identity Server deployed:

> - For Administration Server:
> 1. If necessary, start the Administration Server admin instance:

> cd /var/opt/SUNWAppserver7/domains/domain1/admin-server/bin
> ./start

> 2. In a browser, go to the Application Server administration console. The default URL is http://hostname:4848.
> 3. In the left navigation frame, click the key to left of App Server Instances.
> 4. Select server1 or the name of the application server instance on which Identity Server was deployed.
> 5. Click Apply Changes.
> - For Web Server:
> 1. If necessary, start the Web Server admin instance:

> cd /opt/SUNWwbsrv
> ./start

> 2. Access the Web Server administration console.
> 3. Click Apply Changes to restart the web container.

> Also, in some cases the uninstaller might not be able to remove some or all of the Identity Server files. To do a final cleanup, remove these two directories and their contents:

> - /opt/SUNWam (or identity_svr_base/SUNWam, if Identity Server was not installed in the default location.

> ### Sun Cluster Software and Sun Cluster Agents for Sun Java System

> Do not use the Java Enterprise System uninstaller to remove Sun Cluster software unless Sun Cluster software was installed but never used to configure a cluster node. Sun Cluster software should be uninstalled using the utilities provided with the Sun Cluster software. Sun Cluster Core and Sun Cluster Agents for Sun Java System must be removed together.

> For more information on unconfiguring and uninstalling Sun Cluster software, refer to your Sun Cluster software documentation at http://docs.sun.com/coll/1124.1 for SPARC or http://docs.sun.com/coll/1125.1 for x86.

> After uninstalling Sun Cluster software, edit the /var/sadm/install/productregistry file to remove references to Sun Cluster software.

> Tip | Before editing the productregistry file, back up the file. This file contains information essential to the proper operation of Java Enterprise System.

> Previous Contents Index Next

> Copyright 2004 Sun Microsystems, Inc. All rights reserved.