Installing the Agent for Java EE/JMX (Oracle WebLogic)

The following guide describes how to install an agent in an AE system in which authentication is not used. Additional installation steps are required before the agent can be started and used if you intend to use one of the available authentication methods. For more information, see Agent Authentication.

Tip: It is best to install the agent in a separate directory (such as UC4/Agent/jmx or C:\AUTOMIC\Agent\jmx).

Installing the Agent for Java EE/JMX (Oracle WebLogic)

  1. Installing Java Runtime Environment (JRE).

    This installation step can be omitted if the required version of JRE is already available.

    • Admin computer and/or user computer
    • Use the command shown below to check the system's version of Java Virtual Machine (VM).

      java -version

      Note that if several versions of JRE or Java SDK are installed on the computer, the order of the indicated directories is relevant when specifying %PATH% or $PATH. The Java Runtime Environment that is listed first is used.

    • No Java installation is required if the agent runs on the same computer as the WebLogic Server (recommended).

  2. Setting up the JMX agent.

    • Host
    • Create a folder for the JMX agent (bin) and copy the supplied files.
    • Various settings of the JMX agent can be adjusted to your system environment. Of particular importance are the agent and computer names and the port of the communication process to which the agent should connect. Configure these settings using the INI file of the JMX agent. For more information, see Agent JMX.
    • Copy the files wclient.jar and wljmxclient.jar from the WebLogic Server directory to the agent's installation folder. It must be available in the same folder as the file ucxjjmx.jar.
    • Start the agent with the file ucxjjmx.exe (Windows) or via the command line (UNIX and Windows) using the following command:

      java -jar ucxjjmx.jar

    You can also start the agent using the ServiceManager. For more information, see ServiceManager.

  3. Important notes for creating jobs.

    • Host
    • Select "Remote Java VM" in the Job object's JMX tab.
    • Enter the term "weblogic" in the field Initial Context Factory .
    • Specify the WebLogic Server for the server URL in the format shown below:

    Name of the WebLogic Server:port of the WebLogic Server

    You can also run the agent without a connection to the Oracle WebLogic Server. In this case, select the option Local Java VM and Use existing MBean Servers in the Job objects.

    The WebLogic Server's default port is 7001.