Installing the Application Server 8.2/9.0/9.1 Agent on a Remote Application Server 8.2/9.0/9.1 Instance

The agent installation for each remote Sun Java System Application Sever 9/9.1 instance requires one installation run on the remote host and one configuration run for the remote agent on the DAS host. The following installation steps are based on the assumption that the remote instance has been set up correctly.

For information about installing the agent, see Installing the Application Server 8.2/9.0/9.1 Agent.

To Install the Application Server 8.2/9.0/9.1 Agent on a Remote Application Server 8.2/9.0/9.1 Instance

Before You Begin

Shutdown both the DAS domain and remote server instance before installing the Application Server 8.2/9.0/9.1 agent.

1. Install the Application Server 8.2/9.0/9.1 agent on the remote server instance host.

   During installation, 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 the Application Server 8.2/9.0/9.1 agent on the DAS host for the same remote server instance.

   During installation, 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 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 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]:

   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 instead of the agent binary directory on DAS host.

3. Edit the following files to allow the agent to work on the remote server instance:

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

      For example: /var/opt/SUNWappserver/domains/domain1/config/domain.xml

      In the domain.xml file, find and change the following text:

      <jvm-options>
      -Djava.util.logging.config.file=agent-deploy-directory-on-DAS-host
      /j2ee_agents/appserver_v9_agent/config/AMAgentLogConfig.properties
      </jvm-options>

      to

      <jvm-options>
       -Djava.util.logging.config.file=
      agent-deploy-directory-on-remote-server-instance-host/j2ee_agents/appserver_v9_agent
      /config/AMAgentLogConfig.properties
      </jvm-options>

   2. On the DAS host, edit the DAS domain's server.policy file.

      For example: /var/opt/SUNWappserver/domains/domain1/config/server.policy

      In the server.policy file, find and change the following text:

      grant codeBase "file:agent-deploy-directory-on-DAS-host
      /j2ee_agents/appserver_v9_agent/lib/*" {
             permission java.security.AllPermission;
      };

      to

      grant codeBase "file:agent-deploy-directory-on-remote-server-instance-host
      /j2ee_agents/appserver_v9_agent/lib/*" {
             permission java.security.AllPermission;
      };

4. Start the DAS domain and remote server instance.