Sun Java System Access Manager Policy Agent 2.2 Guide for BEA WebLogic Server/Portal 9.2

Chapter 5 Installing and Configuring Policy Agent 2.2 for BEA WebLogic Server/Portal 9.2: Cluster

Installing the Agent for BEA WebLogic Server/Portal 9.2 in a clustered environment is very similar to the installation process for a stand-alone environment. However, take great care configuring the BEA WebLogic Server/Portal 9.2 Administration Server and its Managed Servers. You must install an agent instance on each the Administration Server in addition to each Managed Server that you want the agent to protect.


Caution – Caution –

The installation and configuration of the agent bits on the Administration Server are required to set up the Agent Authenticator for the entire domain. First, install the agent on the Administration Server. Next configure the Agent Authenticator. These two tasks must be complete before you install a Managed Server that is associated with the same domain. You do not need to configure the Agent Authenticator for any Managed Servers. Failure to follow these guidelines can render the BEA WebLogic Server/Portal 9.2 deployment inaccessible.


Installing Agent for BEA WebLogic Server/Portal 9.2 on the Administration Server

Install the first instance of Agent for BEA WebLogic Server/Portal 9.2 on the Administration Server. The following is a relatively involved task description that directs you to other sections of this guide. When finished, install any subsequent agent instances on Managed Servers.

ProcedureTo Install Agent for BEA WebLogic Server/Portal 9.2 on the Administration Server

  1. Ensure that the BEA WebLogic Server/Portal 9.2 Administration Server is not running.

  2. Install Agent for BEA WebLogic Server/Portal 9.2 as you would in a stand-alone environment.

  3. Configure the agent classpath for BEA WebLogic Server/Portal 9.2 Administration Server as described in this guide.

  4. Start the BEA WebLogic Server/Portal 9.2 Administration Server.

  5. Configure the Agent Authentication Provider.

Installing Agent for BEA WebLogic Server/Portal 9.2 on a Managed Server

You can start Managed Servers in a clustered environment using command-line scripts or using BEA WebLogic Server/Portal 9.2 Administration Console, specifically using the Node Manager. Both options are supported by Agent for BEA WebLogic Server/Portal 9.2. This section describes installing and configuring the agent on a Managed Server to enable you to start a Managed Server with scripts. For information on installing and configuring Node Manager in order to start a Managed Server using Node Manager, see Configuring Node Manager With Agent for BEA WebLogic Server/Portal 9.2: Clustered Setup.

ProcedureTo Install Agent for BEA WebLogic Server/Portal 9.2 on a Managed Server


Note –

Throughout this guide scripting files apply to both UNIX platforms and Windows platforms even when the script for Windows platforms is not expressly mentioned. The difference is that scripts for UNIX platforms have the .sh extension while scripts for Windows platforms have the .cmd extension.


  1. Ensure that the BEA WebLogic Server/Portal 9.2 Managed Server is not running.

  2. Install Agent for BEA WebLogic Server/Portal 9.2 as you would in a stand-alone environment.

    During the installation, enter the same start up script location you provided when installing the agent instance on the Administration Server. Therefore, for the Administration Server and the Managed server, your response should be the same for the following prompt:

    Enter the Startup script location

    However, enter the instance name of the Managed server, such as server0, when presented with the following prompt:

    Enter the WebLogic Server/Portal instance name
  3. Start the Managed Server using the appropriate start up script.

    For this scenario, the appropriate start up script is the startManagedWeblogic.sh script in the following directory:

    domain-directory/bin

    For the example provided thus far in this task, the following would be the appropriate command:

    ./startManagedWeblogic.sh server0 http://adminHost.example.com/:7001

    Alternatively, you can start the Managed Servers via the Node Manager. To configure the Node Manager for this purpose, follow the instructions in Configuring Node Manager With Agent for BEA WebLogic Server/Portal 9.2: Clustered Setup.

Post-Installation Tasks of Agent for BEA WebLogic Server/Portal 9.2 in a Clustered Environment

This section describes the post-installation tasks involved with Agent for BEA WebLogic Server/Portal 9.2 in a clustered environment. This deployment involves the configuration of the Administration Server and of one or more Managed Servers. These tasks have, generally, already been documented in Chapter 4, Post-Installation Tasks of Policy Agent 2.2 for BEA WebLogic Server/Portal 9.2. This section directs you to sections in that chapter while discussing details specific to a clustered environment in this chapter.

Add a WebLogic Administrator to the Bypass List of Agent for BEA WebLogic Server/Portal 9.2: Cluster

For information on this task, see Adding a WebLogic Administrator to the Bypass List of Agent for BEA WebLogic Server/Portal 9.2.

Install the Agent Filter for the Deployed Application on Agent for BEA WebLogic Server/Portal 9.2: Cluster

Install the Agent Filter for each application deployed in an Administration Server or Managed Server protected by Agent for BEA WebLogic Server/Portal 9.2. For information on this task, see Installing the Agent Filter for the Deployed Application on Agent for BEA WebLogic Server/Portal 9.2.

Deploy the Agent Application of Agent for BEA WebLogic Server/Portal 9.2: Cluster

Before preceding to this task description, documented in Deploying the Agent Application of Agent for BEA WebLogic Server/Portal 9.2, take note of the information provided in this section.

You must deploy the agent application on every instance on which the agent has been installed. Failing to do so might disable the agent notification system on the Managed Servers, which in turn would prevent the agent from receiving important notifications. All agent applications hosted on the same instance use the agent application deployed in that instance. Each Managed Server needs to have the agent application deployed so that no Managed Server instance is dependent upon another Managed Server instance for notifications.

You also have the option of deploying the agent application using the BEA WebLogic Server/Portal 9.2 Administration Console as detailed in the following task description.

ProcedureTo Deploy the Agent Application in the BEA WebLogic Server/Portal 9.2 Administration Console

If the agent was installed and configured on more than one managed instance, the agent housekeeping application agentapp.war has to be deployed on each and every Managed Server instance. This can be done through the Administration Console. The deployment can have multiple applications protected by the same agent running on the same Managed Server instance. All the applications in the same BEA WebLogic Server/Portal 9.2 server instance use the agent application deployed with this instance.

If more than one instance is being configured and protected by the agent, each Managed Server instance requires that the agent application be deployed. Thereby, no BEA WebLogic Server/Portal 9.2 instance is dependent on any other instance for agent housekeeping operations.

  1. Expand the Deployments tab.

  2. Click Lock & Edit.

  3. In the right pane, click Install.

  4. Click “upload your file(s).”

    This action uploads the agentapp.war file from the following directory:

    PolicyAgent-base/etc/agentapp.war

    When selecting the target for the Web Application module, you have the option of selecting the entire cluster or individual servers. Deploy the agentapp.war file for every server node on which you will install the agent.

Configuring Node Manager With Agent for BEA WebLogic Server/Portal 9.2: Clustered Setup

You have the option of starting a cluster of Managed Servers using BEA WebLogic Server/Portal 9.2 Node Manager.

ProcedureTo Configure Node Manager With Agent for BEA WebLogic Server/Portal 9.2: Clustered Setup


Note –

Throughout this guide scripting files apply to both UNIX platforms and Windows platforms even when the script for Windows platforms is not expressly mentioned. The difference is that scripts for UNIX platforms have the .sh extension while scripts for Windows platforms have the .cmd extension.


For the following task description, server-instance is a place holder that represents the Managed Server instance name entered during installation. For example, ManagedServer1.

  1. In the BEA WebLogic Server/Portal 9.2 Administration Console, expand the Servers node.

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

  3. Configure the agent classpath in Node Manager

    1. In the BEA WebLogic Server/Portal 9.2 Administration Console, select the Configuration tab.

    2. Select the Server Start tab.

    3. Locate the agent classpath for the specific Managed Server as found in setAgentEnv_sever-instance.sh.

    4. Add the agent class path to the following Classpath text field:


      Note –

      A safe practice is to cut and paste agent classpath entries from the setAgentEnv_sever-instance.sh file to avoid any misconfiguration due to typographical errors.


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

      where AgentInstance-Dir represents an agent instance directory, such as agent_001.

      For information about PolicyAgent-base, see J2EE Agent Directory Structure in Policy Agent 2.2.

    5. To the same Classpath text field referred to in the preceding substep, prepend the following classpath entries:

      DeployContainer-base/BEA-Java-Home/lib/tools.jar:
      DeployContainer-base/weblogic92/server/lib/weblogic.jar
      DeployContainer-base

      represents the directory in which BEA WebLogic Server/Portal 9.2 was installed.

      BEA-Java-Home

      represents the directory that contains the JDK for the BEA WebLogic Server/Portal 9.2 instance.

    6. Click Save.

    7. Click Activate Changes.

  4. Configure the agent Java options in Server Start.

    1. In the BEA WebLogic Server/Portal 9.2 Administration Console, select the Configuration tab.

    2. Select the Server Start tab.

    3. Locate the Java options as found in setAgentEnv_sever-instance .sh for the specific Managed Server.

    4. Add the Java options to the Arguments text field as shown:


      Note –

      A safe practice is to cut and paste agent Java option entries from the setAgentEnv_sever-instance.sh file to avoid any misconfiguration due to typographical errors.


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

    6. Click Activate Changes.