Stand-alone

Stand-alone

Mit Applicationsserver

---

Agent für J2EE/JMX einrichten

Der JMX-Agent kann auch außerhalb eines Applikationsservers laufen. Diese Installationsanleitung beschreibt welche Schritte dazu notwendig sind.

Installieren Sie den Agenten unbedingt in ein eigenes Verzeichnis (z.B: UC4/Agent/jmx or C:\AUTOMIC\Agent\jmx).

Ausgelieferte Dateien

Die Dateien, die zum J2EE/JMX Agenten gehören, finden Sie im Verzeichnis IMAGE:AGENTS\JMX.

Ablauf

	1.	Java Standard Edition installieren

Ist die Java Standard Edition bereits in der erforderlichen Version vorhanden, kann dieser Installationsschritt entfallen.

• Admin-Rechner und/oder Benutzer-Rechner
• Die Version der aktuellen Java Virtual Machine (VM) des Systems kann mit dem folgenden Kommando geprüft werden.

java -version

Sind mehrere Versionen von JRE oder Java SDK auf dem Rechner installiert, so ist bei der Einstellung von %PATH% bzw. $PATH darauf zu achten, dass die Reihenfolge der angegebenen Verzeichnisse relevant ist. Es wird die Java Runtime Umgebung verwendet, die in der Auflistung der Verzeichnisse zuerst gefunden wird.

• Laden Sie das erforderliche Java Runtime Environment von der Seite http://java.sun.com herunter und installieren Sie es.

	2.	Einrichten des Agenten

• Host
• Legen Sie einen eigenen Ordner für den JMX-Agenten an und kopieren Sie in diesen die ausgelieferten Dateien sowie den Unterordner "Logs". Es ist auch möglich, die Installation mit dem Programm SETUP.EXE durchzuführen, welches Sie im Auslieferungsverzeichnis des Agenten finden.
• Der JMX-Agent besitzt mehrere Einstellungen, die Sie an Ihre Systemumgebung anpassen können. Besonders wichtig sind hierbei der Name für den Agenten und der Rechnername sowie der Port des Kommunikationsprozesses, zu dem sich der Agent verbinden soll. Die Konfiguration erfolgt über die INI-Datei des Agenten.

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

• AE unterstützt Sie dabei automatisiert Reports zu erzeugen. Das von uns ausgelieferte MBean namens "CrystalReports" stellt diese Funktionalität zur Verfügung und kann vom Agent für J2EE/JMX aufgerufen werden.
• Verwenden Sie für die Entschlüsselung der Datei ucxbo.jar.ucc das Programm UCYBCRYP.EXE, welches sich auf der CD im Ordner CD:\TOOLS\ENCRYPT befindet. Rufen Sie nun das Programm über die Kommandozeile mit folgenden Parametern auf:

UCYBCRYP.EXE -d -f ucxbo.jar.ucc -lLizenzdatei

Die Lizenzdatei wurde Ihnen vom UC4-Support geliefert (Kundennummer.TXT).

• Als Ergebnis erhalten Sie eine Datei namens ucxbo.jar. Kopieren Sie diese in den Ordner, in dem sich die Datei ucxjjmx.jar befindet.

	4.	Starten des Agenten

• Starten Sie den Agenten über die Kommandozeile (UNIX und Windows) mit folgendem Befehl:

java -jar -Xrs -Xmx256M ucxjjmx.jar

Der Agent kann auch mit dem ServiceManager gestartet werden.

Beachten Sie, dass beim Start der Java-Agenten (Datenbanken, RA, JMX, SAP) das Speicherlimit auf mindestens 256 MB (oder 512 MB) gesetzt werden sollte. Sie können den Wert für die Speicherbegrenzung von Java-Anwendungen mit dem Startparameter -XmX festlegen. Wird dieser Wert zu klein gewählt, kann es zum Absturz des Agenten kommen. Der Standardwert hängt von der verwendeten Java-Version ab.

Durch den Java-Parameter -Xrs wird sichergestellt, dass der Agent bei einer normalen Beendigung auch ordnungsgemäß endet. Wir empfehlen daher, diesen Parameter zu verwenden. Mehr Informationen dazu finden Sie in der Dokumentation von Java.

	5.	Wichtige Hinweise zum Anlegen von Jobs

• Host
• Wählen Sie in der Registerkarte JMX des Job-Objektes die Option Lokale Java VM aus.
• Die Unterpunkte "Benutze vorhandenen MBean Server" und "Erzeuge neue Instanz..." sind zu aktivieren.