Installing a J2EE Agent on a Remote Sun Java System Application Server 8.1 Instance

The agent installation for each remote Sun Java System Application Server 8.1 instance requires one installation run on the remote host and one configuration run for the remote agent on the DAS host. The following task is based on the assumption that the remote instance has been set up correctly.

To install Sun Java System Application Server 8.1 on a Remote Application Server 8.1 Instance

Before You Begin

Shutdown both the DAS domain and remote server instance before installing Agent for Sun Java System Application Server 8.1.

1. Install Agent for Sun Java System Application Server 8.1 on a remote server instance.

   For general information on installing the agent, see Using the Installation Program of Agent for Sun Java System Application Server 8.1.

   During the installation of this instance of the agent, answer the following questions as indicated.

   Enable this field only when the agent is being installed on a remote server instance host. [ ? : Help, < : Back, ! : Exit ] Is Domain administration server host remote ? [false]: True Enter true only if agent is being installed on a remote instance from the Domain Administration server host. [ ? : Help, < : Back, ! : Exit ] Is the agent being installed on the DAS host for a remote instance ? [false]: false

2. Install Agent for Sun Java System Application Server 8.1 on DAS host for the same remote server instance.

   During the installation of this instance of the agent, answer the following questions as indicated.

   Enable this field only when the agent is being installed on a remote server instance host. [ ? : Help, < : Back, ! : Exit ] Is Domain administration server host remote ? [false]: false Enter true only if agent is being installed on a remote instance from the Domain Administration server host. [ ? : Help, < : Back, ! : Exit ] Is the agent being installed on the DAS host for a remote instance ? [false]: true

   The following two questions are asked only when the answer to the previous question is true:

   Enter the value of the agent instance name provided by the agent installation on the remote instance. [ ? : Help, < : Back, ! : Exit ] Agent instance name []: agent_001

   ---

   Note –

   agent_001, as indicated as the response to the to the preceding prompt, is the agent instance name generated in Step 1 for the remote server instance. The agent installation generates an agent instance name, which is displayed at the end of the installation and is available in the install log. The instance name must be valid.

   ---

   Enter the value of the agent install directory on the remote instance host. [ ? : Help, < : Back, ! : Exit ] Agent install directory on remote instance host [/opt/j2ee_agents/am_as81_agent]:

   For the preceding prompt, enter the directory where the agent has been installed on the remote server instance host. This is the agent binary directory on the remote server instance host, not the agent binary directory on the DAS host.

3. Edit the appropriate files to allow the agent to work on the remote server instance as indicated in the following substeps:

   1. On the DAS host, open the DAS domain's domain.xml file.

      The following is an example of a full path to the domain.xml file:

      /var/opt/SUNWappserver/domains/domain1/config/domain.xml

   2. Delete the following code snippet:

      <jvm-options>
      -Djava.util.logging.config.file=PolicyAgent-base-on-DAS-host
      /j2ee_agents/am_as81_agent/config/AMAgentLogConfig.properties
      </jvm-options>

   3. Add the following code snippet:

      <jvm-options>
      -Djava.util.logging.config.file=
      PolicyAgent-base-on-remote-server-instance-host
      /j2ee_agents/am_as81_agent/config/AMAgentLogConfig.properties
      </jvm-options> 

   4. On the DAS host, open the DAS domain's server.policy file.

   5. Delete the following code snippet:

      grant codeBase "file:PolicyAgent-base-on-DAS-host/
      j2ee_agents/am_as81_agent/lib/*" {
             permission java.security.AllPermission;
      };

   6. Add the following code snippet:

      grant codeBase "file:PolicyAgent-base-on-remote-server-instance-host/
      j2ee_agents/am_as81_agent/lib/*" {
             permission java.security.AllPermission;
      };