Uninstalling the WebSphere Application Server/Portal Server Agent

• Preparing to Uninstall the WebSphere Application Server/Portal Server Agent

• Uninstalling the WebSphere Application Server/Portal Server Agent Using the agentadmin Program

• Uninstalling the WebSphere Application Server/Portal Server Agent in a Network Deployment Environment

Preparing to Uninstall the WebSphere Application Server/Portal Server Agent

To Prepare to Uninstall WebSphere Application Server/Portal Server Agent

1. Undeploy any applications protected by the WebSphere Application Server/Portal Server agent.

2. Restore the deployment descriptors of these applications to their original deployment descriptors. (Backup files are useful here if you have them.)

3. Conditionally, if you are permanently removing the WebSphere Application Server/Portal Server agent, undeploy the agent application.

   However, if you plan to re-install this agent , you don't need to undeploy the agent application.

4. Ensure that the WebSphere Application Server 6.1/7.0 instances that is being protected by the agent is stopped.

Uninstalling the WebSphere Application Server/Portal Server Agent Using the agentadmin Program

To Uninstall the WebSphere Application Server/Portal Server Agent

1. Change to the following directory:

   PolicyAgent-base/bin

2. Issue one of the following commands:

   # ./agentadmin --uninstall

   or

   # ./agentadmin --uninstallAll

   The --uninstall option removes only one instance of the agent, while the --uninstallAll option prompts you to remove all configured instances of the agent.

3. The uninstall program prompts you for the following values for the WebSphere Application Server 6.1/7.0 instance you are unistalling:

   • Configuration directory path

   • Server instance name

   • Install root directory

4. The uninstall program displays a summary of your responses and then asks if you want to continue:

   To continue with the uninstallation, select 1 (the default).

Example 2 Uninstallation Sample for the WebSphere Application Server/Portal Server Agent

************************************************************************
Welcome to the OpenSSO Policy Agent for IBM WebSphere Application Server 6.1
************************************************************************

Enter the fully qualified path to the configuration directory of the Server
Instance for the WebSphere node.                 
[ ? : Help, ! : Exit ]
Enter the Instance Config Directory
[/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/
  Node01Cell/nodes/Node01/servers/server1]: 
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/
  agenthostNode01Cell/nodes/agenthostNode01/servers/server1

Enter the Server Instance name.
[ ? : Help, < : Back, ! : Exit ]
Enter the Server Instance name [server1]: 

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/AppSrv01/config/cells/
  agenthostNode01Cell/nodes/agenthostNode01/servers/server1
Instance Server name : server1 
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,openssoclientsdk.jar from
/opt/IBM/WebSphere/AppServer/lib/ext...DONE.
Deleting the config directory
/agents/j2ee_agents/websphere_v61_agent/Agent_001/config
...DONE.
Unconfigure server.xml file
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/Node01Cell/nodes/
Node01/servers/server1/server.xml
...DONE.

Uninstall log file location:
/agents/j2ee_agents/websphere_v61_agent/installer-logs/audit/uninstall.log
Thank you for using OpenSSO Policy Agent

After You Finish the Uninstall

• The /config directory is removed from the agent instance directory, but the /installer-logs directory still exists.

• The uninstall program creates an uninstall log file in the PolicyAgent-base/installer-logs/audit directory.

• The agent instance directory is not automatically removed. For example, if you uninstall the agent for Agent_001, a subsequent agent installation creates the Agent_002 instance directory. To remove an agent instance directory, you must manually remove the directory.

Uninstalling the WebSphere Application Server/Portal Server Agent in a Network Deployment Environment

To remove each WebSphere Application Server/Portal Server agent instance, follow the steps in Uninstalling the WebSphere Application Server/Portal Server Agent. After running agentadmin --uninstall, copy each server instance's server.xml file to overwrite its corresponding copy in the Deployment Manager's profile, as described in Installing and Configuring the WebSphere Application Server/Portal Server Agent in a Network Deployment Environment.