Installation Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Deploy the Guardian Agent

The following sections provide instructions for deploying the Guardian Agent to any WebLogic Server instances you wish to evaluate:

 


Before You Start

 


Deploy the Guardian Agent

For a single instance, you can use the WebLogic Server Administration Console to install and deploy the new Agent. The WebLogic Server Administration Console provides a series of Web-based deployment assistants that guide you through the deployment process. For a summary of the steps involved in deploying the Guardian Agent, see Deploy Guardian Agent from WebLogic Server Administration Console . For complete instructions on deploying applications, see the Administration Console Online Help, and WebLogic Server documentation.

If you want to deploy the Guardian Agent to multiple servers, you can use the WebLogic Scripting Tool to automate this task. For basic instructions, see Deploy Guardian Agent to Multiple Servers. For complete instructions on using the WebLogic Scripting tool to deploy applications, see the WebLogic Scripting Tool documentation.

Deploy Guardian Agent from WebLogic Server Administration Console

You can use the WebLogic Server Administration Console to manually deploy the Guardian Agent to the Administration Server. This section provides a summary of the basic steps involved for WebLogic Server versions 9.0 and above. For complete instructions for your specific version of WebLogic Server, please see your WebLogic Server documentation and Administration Console Online Help. Please also refer to the Release Notes for additional important information.

To use the Administration Console to manually deploy the Guardian Agent, do the following:

  1. Start the WebLogic Administration Console, and select Lock & Edit in the left pane.
  2. Caution: Make sure that Lock & Edit is selected for each of the following procedures.
  3. If necessary, stop the existing Guardian Agent deployment in the WebLogic Server.
  4. By default, the Guardian Agent is named bea-guardian-agent.

    Note: For detailed instructions for this procedure, see “Start and stop a deployed Enterprise Application” in the WebLogic Administration Console Online Help.

    Delete the existing Guardian Agent deployment from the WebLogic Server, and activate your changes.

    Note: For detailed instructions for this procedure, see “Delete an Enterprise Application” in the WebLogic Administration Console Online Help.
  5. Install the new Guardian Agent in the WebLogic Server, and activate your changes.
  6. The Guardian Agent is a WAR file named bea-guardian-agent.war, and is located in the following directory:

    <root>\guardian\plugins\com.bea.guardian.agent.weblogic_<guard-version>\weblogic<wls-version>

    Where:

    <root> is the parent directory for the Guardian installation. For example:
    C:\\Program Files

    <guard-version> is the current (updated) Guardian version.

    <wls-version> is the version of WebLogic Server in which you are deploying this Agent.

    If you are installing the Agent on WebLogic 8.1.x, install the bea-guardian-agent.war file located in the ..\weblogic8 directory. For WebLogic Server 9.x and 10.x, install the bea-guardian-agent.war file located in the ..\weblogic9 directory.

    WARNING: Do not change the name of the Guardian Agent when deploying it. Be sure to use the default name, bea-guardian-agent.war.
    Note: For detailed instructions for this procedure, see the section entitled, “Install an Enterprise Application” in the Administration Console Online Help.
  7. Start the new Guardian Agent in the WebLogic Administration Server.
  8. Note: For detailed instructions for this procedure, see “Start and stop a deployed Enterprise Application” in the WebLogic Administration Console Online Help.
  9. Start Guardian and activate the necessary domains in Guardian.
  10. Note: For detailed instructions for this procedure, see “Activate Domain” in the Oracle Guardian Online Help.

You Guardian deployment is complete. See What’s Next? for information on how to upgrade from previous releases and launch Guardian.

Deploy Guardian Agent to Multiple Servers

If you need to deploy the Guardian Agent to multiple servers, you can use the weblogic.Deployer command in the WebLogic Server Command Line Interface to automate this task. You can also use the WebLogic Scripting Tool (WLST) to deploy the Agent. This section provides basic instructions for using the weblogic.Deployer command for this purpose. For instructions on using WLST, please see the WebLogic Scripting Tool documentation.

WARNING: Do not change the name of the Guardian Agent when deploying it. Be sure to use the default name, bea-guardian-agent.war.

At the WebLogic Server CLI prompt, enter the following command line:

java weblogic.Deployer -debug -adminurl http://<admin_url>:<port> -username <username> -password <password> – targets adminserver,<cluster1>,<cluster2> -deploy -sourcerootforupload <dir_path>\bea-guardian-agent.war

Where:

See the next section for information on how to upgrade from previous releases and launch Guardian.

 


What’s Next?


  Back to Top       Previous  Next