Stand-alone

Stand-alone

Usage with Application Server

---

Setting Up the Agent for J2EE/JMX

The JMX agent can be run outside of an application server. This installation guide describes the required steps.

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 Standard Edition

This installation step can be omitted if the required version of Java Standard Edition is already available.

• Admin computer and/or user computer
• Check the current version of your system's Java Virtual Machine (VM) using the following command:

java -version

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

• Download the required Java Runtime Environment from http://java.sun.com and install it.

	2.	Setting up the Agent

• Host
• Create a separate folder for the JMX agent and copy the supplied files and the subfolder "Logs" to it. Alternatively, you can also use the program SETUP.EXE for the installation. It is available in the supplied directory (Agent).
• Several settings can be configured in order to adjust the JMX agent to your system environment. Of particular importance are the agent and computer name, and the port of the communication process to which the agent should connect. Configure these settings using the agent's INI file.

	3.	Setting up the MBean for Business Objects XI R2 (optional)

• AE supports the generation of automated reports. This function is provided by MBean "CrystalReports", which is supplied by Automic. It is called with the Agent for J2EE/JMX.
• Use the program UCYBCRYP.EXE to decode the file ucxbo.jar.ucc. It is stored in the folder CD:\TOOLS\ENCRYPT of the AE CD. Now call the program via the command line using the following parameters:

UCYBCRYP.EXE -d -f ucxbo.jar.ucc -lLicense file

The license file is supplied by UC4 Support (customer_number.TXT).

• The result is the packed file ucxbo.jar. Copy it to the folder in which the file ucxjjmx.jar is stored.

	4.	Starting the Agent

• Use the following command to start the agent via the command line (UNIX and Windows): 

java -jar -Xrs -Xmx256M ucxjjmx.jar

The agent can also be started using the ServiceManager.

Note that the storage limit should be set to at least 256MB (or 512MB) for starting Java agents (Databases, RA, JMX, SAP). You can specify a value for the storage limitation of Java applications by using the start parameter -XmX. Specifying a value that is too low can cause the agent to crash. The default value depends on the Java version that is used.The Java parameter -Xrs ensures that the agent ends properly when a normal end is initiated. Automic recommends using this parameter. More detailed information is provided in the Java documentation.

	5.	Important notes for creating jobs

• Host
• Select the option Local Java VM in the Job object's JMX tab.
• Activate the sub-items "Use existing MBean Server" and "Create new instance..."