Chapter 6 Uninstalling the IBM WebSphere Portal Server 6.0 Policy Agent

To uninstall the IBM WebSphere Portal Server 6.0 agent, use the agentadmin program with the --uninstall option. The uninstallation process involves these steps:

• Preparing to Uninstall the IBM WebSphere Portal Server 6.0 Agent

• All Systems: Uninstalling the IBM WebSphere Portal Server 6.0 Agent

• All Systems: Removing the IBM WebSphere Portal Server 6.0 Agent Files

For more information about the agentadmin program, see Key Features and Tasks Performed With the J2EE agentadmin Program.

You must access the PolicyAgent-base directory for uninstallation-related tasks. For more information about this directory, see J2EE Agent Directory Structure in Policy Agent 2.2.

Preparing to Uninstall the IBM WebSphere Portal Server 6.0 Agent

Perform the steps in this section before you uninstall the IBM WebSphere Portal Server 6.0 agent.

To Prepare to Uninstall the IBM WebSphere Portal Server 6.0 Agent

1. Remove the Access Manager Trust Association Interceptor, as follows:

   1. Start the IBM WebSphere Application Server 6.0 Administration instance, if it is not running.

   2. Login to Administration Console.

   3. Remove the Access Manager Trust Association Interceptor, and then save and apply changes to the Master configuration.

      The Trust Association Interceptor was added as a post-installation step. For more information, see Adding an Access Manager Trust Association Interceptor to IBM WebSphere Portal Server 6.0.

2. Rollback the changes made in Changing the Logout Link Actions for IBM WebSphere Portal Server 6.0:

   1. Remove the comment character (#) from the changed lines and save the changes.

   2. Run the following portal configuration task:

      WPS-base/PortalServer/config/WPSconfig.sh update-properties

      where WPS-base represents the directory where IBM WebSphere Portal Server 6.0 was installed.

3. Stop all IBM WebSphere Application Server 6.0 instances, if they are running.

4. Restore the two web.xml files for the IBM WebSphere Portal Server 6.0 application.

   If backup copies of these web.xml files were made during the post-installation process, replace the current files with the backup files.

   For information about how these files were modified during the post-installation of the agent, see Adding the Agent Filter to the IBM WebSphere Application Server 6.0 Administration Console.

5. Restore the web.xml file for the IBM WebSphere Application Server 6.0 Administration Console.

   If a backup copy was made of this web.xml file during the post-installation process, replace the current file with the backup file.

   For information about how this file was modified during the post-installation of the agent, see Adding the Agent Filter to the IBM WebSphere Application Server 6.0 Administration Console.

6. Undeploy the agent application.

   The agent application must be undeployed from IBM WebSphere Portal Server 6.0 before the agent is uninstalled. The agent application was installed during the post-installation steps. For more information, see Deploying the Agent Application for Version 2.2 J2EE Agents.

7. Restart the associated IBM WebSphere Application Server Administration instance.

All Systems: Uninstalling the IBM WebSphere Portal Server 6.0 Agent

This method for uninstalling the IBM WebSphere Portal Server 6.0 agent applies to all supported platforms.

Launching the Uninstallation Program for the IBM WebSphere Portal Server 6.0 Agent

To Launch the Uninstallation Program for the IBM WebSphere Portal Server 6.0 Agent

1. Change to the following directory:

   PolicyAgent-base/bin

   This directory contains the agentadmin program for UNIX and Linux systems and the agentadmin.bat program for Windows systems. These programs are used for installing and uninstalling an agent as well as for performing other agent tasks. For more information, see Key Features and Tasks Performed With the J2EE agentadmin Program.

2. Issue the agentadmin command. For example, on Solaris systems:

   ./agentadmin --uninstall

   or

   ./agentadmin --uninstallAll

   where --uninstall removes one instance of the agent, and --uninstallAll removes all configured instances of the agent.

   After you issue one of the preceding commands, the uninstallation program launches and presents you with the first prompt as illustrated in the following section.

Using the Uninstallation Program for the IBM WebSphere Portal Server 6.0 Agent

Uninstall the agent from every instance of the underlying IBM WebSphere Application Server.

Example of Uninstallation Program Interaction in Agent for IBM WebSphere Portal Server 6.0

The following example shows the uninstallation of the IBM WebSphere Portal Server 6.0 agent, where WebSphereServer-instance-name represents the WebSphere Server instance name. The default instance is often named server1 and the IBM WebSphere Portal Server instance is often named WebSphere_Portal.

************************************************************************
Welcome to the Access Manager Policy Agent for IBM WebSphere Portal Server
6.0 Agent. If the Policy Agent is used with Federation Manager services,
User needs to enter information relevant to Federation Manager.

************************************************************************


Enter the fully qualified path to the configuration directory of the Server
Instance for the WebSphere node. Please ensure that the installer is run on
the WebSphere instance that will host the WebSphere Administration Console
first before the installer is run on the WebSphere Portal instance.
[ ? : Help, ! : Exit ]
Enter the Instance Config Directory
[/opt/IBM/WebSphere/AppServer/profiles/wp_profile/config/cells/cell01/
nodes/node01/servers/WebSphereServer-instance-name]: 

Enter the Server/Portal Instance name.
[ ? : Help, < : Back, ! : Exit ]
Enter the Server/Portal Instance name [WebSphereServer-instance-name]:


Enter the WebSphere Install Root directory.
[ ? : Help, < : Back, ! : Exit ]
Enter the WebSphere Install Root directory [/opt/IBM/WebSphere/AppServer]: 


-----------------------------------------------
SUMMARY OF YOUR RESPONSES
-----------------------------------------------
Instance Config Directory :
/opt/IBM/WebSphere/AppServer/profiles/wp_profile/config/cells/cell01/
nodes/node01/servers/WebSphereServer-instance-name

Instance Server/Portal name : WebSphereServer-instance-name
WebSphere Install Root Directory : /opt/IBM/WebSphere/AppServer


Verify your settings above and decide from the choices below.
1. Continue with Uninstallation
2. Back to the last interaction
3. Start Over
4. Exit
Please make your selection [1]:

Remove agent.jar,famclientsdk.jar from
/opt/IBM/WebSphere/AppServer/lib/ext...DONE.

Deleting the config directory
/opt/j2ee_agents/websphere_v60portal_agent/Agent_001/config...DONE.

Unconfigure server.xml file
/opt/IBM/WebSphere/AppServer/profiles/wp_profile/config/cells/cell01/
nodes/node01/servers/WebSphereServer-instance-name/server.xml
...DONE.

Uninstall log file location:
/opt/j2ee_agents/websphere_v60portal_agent/logs/audit/uninstall.log

Thank you for using Access Manager Policy Agent

All Systems: Removing the IBM WebSphere Portal Server 6.0 Agent Files

After all instances of the IBM WebSphere Portal Server 6.0 agent have been removed as part of the uninstallation process, you must remove the agent files (unless you want to configure a new agent using the same files).

Therefore, delete the files under the PolicyAgent-base directory.