Configuring a WebLogic Server 10 Instance With the Agent classpath and Java Options

This section applies to WebLogic Server 10 only. For instructions specific to WebLogic Portal 10, see Post-Installation Tasks for the WebLogic Server/Portal 10 Agent on WebLogic Portal 10.

During the agent installation, the installer creates the following environment variable script in domain-directory:

• Solaris and Linux systems: setAgentEnv_server-instance.sh

• Windows systems: setAgentEnv_server-instance.cmd

where:

• domain-directory represents the domain name associated with the WebLogic Server 10 instance. The default path name of domain-directory is:

  /usr/local/bea/user_projects/domains/domain-name

• server-instance represents the WebLogic Server 10 instance name entered during installation. For example: server1 or server2.

The agent environment variable script is called during the server's startup sequence and sets the classpath and Java options for the agent.

To Configure a WebLogic Server 10 Instance With the Agent classpath and Java Options

1. Using a text editor, edit the following WebLogic Server 10 instance startup script, depending on your platform:

   • Solaris and Linux systems: domain-directory/bin/startWebLogic.sh

   • Windows systems: domain-directory\bin\startWebLogic.cmd

   domain-directory represents the domain name associated with the WebLogic Server 10 instance.

2. Add the path of the agent environment variable script to the WebLogic Server 10 startup script:

   • Solaris and Linux systems: After the line, . ${DOMAIN_HOME}/bin/setDomainEnv.sh $*, add the path:

     . domain-directory/setAgentEnv_${SERVER_NAME}.sh

     For example, for a domain directory named base_domain:

     . /usr/local/bea/user_projects/domains/base_domain/setAgentEnv_${SERVER_NAME}.sh

     Therefore, the startup script would then contain these two lines:

     . ${DOMAIN_HOME}/bin/setDomainEnv.sh $* . /usr/local/bea/user_projects/domains/base_domain/setAgentEnv_${SERVER_NAME}.sh

   • Windows systems: After the line, call "%DOMAIN_HOME%\bin\setDomainEnv.cmd" %*, add the path:

     call "domain-directory\setAgentEnv_%SERVER_NAME%.cmd"

     For example, for a domain directory named base_domain:

     call "C:\bea\user_projects\domains\base_domain\setAgentEnv_%SERVER_NAME%.cmd"

     Therefore, the startup script would then contain these two lines:

     call "%DOMAIN_HOME%\bin\setDomainEnv.cmd" %*
     call "C:\bea\user_projects\domains\base_domain\setAgentEnv_%SERVER_NAME%.cmd"

   The ${SERVER_NAME} or %SERVER_NAME% variable represents the WebLogic Server 10 instance and is dynamically replaced when the script is executed.

3. Restart the WebLogic Server 10 instance.