Administration Guide > Installation > New Installation > Setting up the Agent for Java EE/JMX (Oracle Weblogic)

Setting Up the Agent for J2EE/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. More detailed information is provided in the document Advanced Security.

Automic strongly recommends installing the agent in a separate directory (such as UC4/Agent/jmx or C:\AUTOMIC\Agent\jmx).

Supplied Files

The files that belong to the J2EE/JMX agent are stored in the directory IMAGE:AGENTS\JMX.

Procedure

	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 agent's INI file.
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.

	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.