Chapter 7 Uninstalling the WebLogic Server/Portal 10 Agent

To uninstall the WebLogic Server/Portal 10 agent, use the agentadmin program with the --uninstall option. This chapter includes:

• Preparing to Uninstall the WebLogic Server/Portal 10 Agent

• Uninstalling the WebLogic Server/Portal 10 Agent

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

Preparing to Uninstall the WebLogic Server/Portal 10 Agent

Before you uninstall the WebLogic Server/Portal 10 agent, perform the following tasks:

• Removing the Agent Authentication Provider

• Performing Unconfiguration Tasks

Removing the Agent Authentication Provider

Use the WebLogic Server/Portal 10 Administration Console to remove the Agent Authentication Provider that was configured after the agent was installed.

To Remove the Agent Authentication Provider

1. Log on to the Administration Console.

2. In the left pane, under Domain Structure and under the host name of the server you are configuring, click Security realms.

3. In the right pane, click the name of the realm you are configuring.

4. Click Providers.

5. Click the Authentication tab.

6. Click Lock & Edit in the left pane.

7. In the right pane, specify the Policy Agent Authentication Provider.

8. Click Delete.

9. Click Yes.

10. In the left pane, click activate changes.

    The Agent Authentication Provider is not removed from the configuration until you restart the WebLogic Server/Portal 10 instance. The best practice is to restart the WebLogic Server/Portal 10 instance after you perform the following additional tasks.

Performing Unconfiguration Tasks

To Perform Various Unconfiguration Tasks

1. Undeploy any protected applications from WebLogic Server/Portal 10. Refer to the BEA documentation for more information.

2. Restore the deployment descriptors of these applications to their original deployment descriptors.

3. Ensure that the WebLogic Server/Portal 10 instance protected by the agent is shut down.

4. Undeploy the agent application, which was installed during the post-installation steps.

5. (Conditional) If the WebLogic Server/Portal 10 instance was originally configured using Node Manager, remove the classpath and agent Java options using the WebLogic Server/Portal 10 Administration Console.

   1. Expand the Servers node.

   2. Select the node for the server you want to manage with Node Manager.

   3. Remove the agent classpath entries in Node Manager.

      1. Select the Configuration tab.

      2. Select the Server Start tab.

      3. Remove the following classpath entries:

         ${CLASSPATH}:PolicyAgent-base/lib/agent.jar:
         PolicyAgent-base/lib/amclientsdk.jar:
         PolicyAgent-base/locale:
         PolicyAgent-base/AgentInstance/config

         where AgentInstance represents an agent instance directory, such as Agent_001.

      4. Remove the agent Java options in Node Manager.

         1. In the BEAWebLogic Server/Portal 10 Administration Console, select the Configuration tab.

            Select the Server Start tab.

         2. Remove the following Java options from the Arguments text field:

            -Djava.util.logging.config.file=
            PolicyAgent-base/config/AMAgentLogConfig.properties
            -DLOG_COMPATMODE=Off 

6. Shut down the WebLogic Server/Portal 10 domain.

Uninstalling the WebLogic Server/Portal 10 Agent

To Uninstall the WebLogic Server/Portal 10 Agent

1. Change to the following directory:

   PolicyAgent-base/bin

   This directory contains the agentadmin program, which is used for uninstalling a J2EE agent and for performing other tasks. For more information on the agentadmin program, see Key Features and Tasks Performed With the J2EE agentadmin Program.

2. Issue one of the following commands:

   ./agentadmin --uninstall

   or

   ./agentadmin --uninstallAll

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

3. The uninstall program launches and prompts you for the following information:

   • Startup script location

   • WebLogic domain secured by the agent

     Enter the appropriate values or accept the default values.

4. The uninstall program displays your choices and then asks if you want to continue:

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

Example 7–1 Uninstallation Sample for the WebLogic Server/Portal 10 Agent

************************************************************************
Welcome to the Access Manager Policy Agent for BEA WebLogic 10.0 Platform.
If the Policy Agent is used with Federation Manager services, User needs to
enter information relevant to Federation Manager.

************************************************************************
Enter the path to the location of the script used to start the WebLogic domain.
Please ensure that the agent is first installed on the admin server instance
before installing on any managed server instance.
[ ? : Help, ! : Exit ]
Enter the Startup script location
[C:\bea\user_projects\domains\mydomain\startWebLogic.cmd]:

Enter the name of the WebLogic Server instance secured by the agent.
[ ? : Help, < : Back, ! : Exit ]
Enter the WebLogic Server instance name [myserver]:

-----------------------------------------------
SUMMARY OF YOUR RESPONSES
-----------------------------------------------
Startup script location :
/usr/local/bea/user_projects/domains/mydomain/startWebLogic.sh
WebLogic domain name : myserver

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]:

Next Steps

After you uninstall the agent, when the server is stopped, edit the WebLogic Server/Portal 10 start up script (startWebLogic.sh or startWebLogic.cmd) to remove the line that adds the agent environment variable script path, as described in Configuring WebLogic Server/Portal 10 Instance With the Agent Classpath and Agent Java Options.