Agent für Datenbanken installieren

Agent für Datenbanken installieren

Agent für Datenbank-Variablen installieren

---

Agent für Datenbank-Jobs und -Ereignisse installieren

Folgende Anleitung erläutert die Installation des Agenten für die Durchführung von Datenbank-Jobs und -Ereignissen.

Diese Installationsanleitung gilt sowohl für Windows als auch für Unix.

Der Datenbank-Agent für Jobs und Ereignisse dient nur für einen bestimmten Datenbank-Typ (z.B.: MS SQL) und kann in derINI-Datei des Agenten gesetzt werden. Für jeden Datenbank-Typ, auf den Jobs oder Ereignisse zugreifen sollen, ist daher ein eigener Agent zu installieren. Der Name der Datenbank, Servers usw. ist im jeweiligen Job oder Ereignis-Objekt festzulegen.

Die folgende Anleitung beschreibt die Installation des Agenten in einem Automation Engine System, das keine Authentifizierung einsetzt. Wenn Sie eine der Authentifizierungsmethoden nutzen möchten, sind noch zusätzliche Schritte nötig, bevor Sie den Agenten starten und einsetzen können. Lesen Sie näheres im Dokument zur Advanced Security.

Installieren Sie den Agenten unbedingt in ein eigenes Verzeichnis!

Stellen Sie vor der Installation sicher, dass sich Java-Agenten nur zu CP-Ports bis maximal 65535 verbinden können. Bei höheren Portnummern bricht der Agent beim Start mit einer entsprechenden Fehlermeldung ab. Diese Einschränkung ist durch Java bedingt und betrifft die Agenten für JMX, Datenbanken, SAP und RA.

Ausgelieferte Dateien

Die Dateien des Datenbank-Agenten finden Sie im Verzeichnis IMAGE:AGENTS\SQL.

Zusätzlich werden noch die leeren Ordner temp und jdbc ausgeliefert. Ersterer nimmt die Logdateien auf und in letzterem müssen Sie den JDBC-Treiber installieren.

Ablauf

	1.	Java Runtime Environment (JRE) installieren

Ist JRE 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. Bei der Installation wird automatisch das Java Plug-in für Web-Browser installiert. Da die AE dieses nicht benötigt, können Sie es in der Systemsteuerung deaktivieren.

	2.	Installieren des Agenten

• Host
• Legen Sie für den Agenten ein eigenes Verzeichnis an (z.B: C:\AUTOMIC\AGENTS\SQL\BIN bzw. UC4/AGENTS/SQL/BIN).
• Kopieren Sie den Inhalt von IMAGE:AGENTS\SQL in dieses Verzeichnis. Unter Windows ist es auch möglich, die Installation mit dem Programm SETUP.EXE durchzuführen, welches Sie im Verzeichnis IMAGE:AGENTS\SQL\WINDOWS finden.

	3.	Installieren des JDBC-Treibers

• Host
• Für alle Datenbanken, die der Agent verwenden soll, muss ein passender JDBC-Treiber installiert werden. Verwenden Sie dazu die Installationsanleitungen des Herstellers.
• Legen Sie im BIN-Ordner des Datenbank-Agenten einen Ordner namens „JDBC“ an. Kopieren Sie nach der Installation des JDBC-Treibes die Dateien in diesen Ordner.

• Microsoft SQL Server
• Installieren Sie den Microsoft JDBC Treiber für SQL Server oder den Microsoft JDBC Treiber 4.0 für SQL Server
• Kopieren Sie nach der Installation des Treibers die Datei sqljdbc4.jar in das jdbc-Verzeichnis.
• 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.
• Wird der Agent unter Windows gestartet, so kann der jeweilige Betriebssystem-Benutzer für die Anmeldung an der MS SQL Datenbank verwendet werden (Windows Authentication). Zusätzlich ist bei Installation des JDBC-Treibers die Datei "sqljdbc_auth.dll" in das BIN-Verzeichnis des Datenbank-Agenten zu kopieren. Achten Sie darauf, dass die Architektur dieser Datei, mit jener der verwendeten JVM übereinstimmt (z.B.: x64).

• Oracle
• Installieren Sie den Treiber.
• Kopieren Sie nach der Installation des Treibers die Datei ojdbc5.jar bzw. ojdbc6.jar in das jdbc-Verzeichnis.
• Beachten Sie, dass der JDBC Treiber der Version 9.0.1 und darunter aufgrund eines Programmfehlers im Treiber nicht mit dem Agenten verwendet werden können!
• Der Agent durchsucht die jar-Dateien im jdbc-Ordner nach den entsprechenden Klassen. Der Dateiname spielt dabei keine Rolle. Wichtig ist, dass immer die aktuellste jar-Datei verwendet wird, die verfügbar ist. Es wird empfohlen, dass sich immer nur eine jar-Datei im JDBC - Ordner befindet.

• MySQL
• Installieren Sie den Treiber.
• Kopieren Sie nach der Installation des Treibers die Datei mysql-connector-java-5.0.3-bin.jar in das jdbc-Verzeichnis.

• DB2
• Der JDBC-Treiber ist Teil der DB2-Installation und befindet sich im Verzeichnis SQLLIB/java (unter Windows z.B.: C:\Program Files\IBM\SQLLIB\java).
• Kopieren Sie die folgenden beiden Dateien in das jdbc-Verzeichnis des Agenten:
• db2jcc.jar (JDBC Typ 4 Treiber)
• db2jcc_license_cu.jar (Server-Lizenz)
• Der JDBC Treiber kann auch von der IBM-Homepage heruntergeladen werden.
  Klicken Sie auf den Eintrag "DB2 Personal Developers Edition: Redistributable JDBC Type 4 Driver".

• Sybase
• Installieren Sie den Treiber (jConnect 5.5/6.05)
• Kopieren Sie nach der Installation des Treibers die Datei jconn2.jar bzw. jconn3.jar in das jdbc-Verzeichnis.

• Informix
• Installieren Sie den Treiber (V3.5).
• Kopieren Sie nach der Installation des Treibers die Datei ifxjdbc.jar und ifxlang.jar in das jdbc-Verzeichnis des Agenten.
• Beachten Sie, dass der Agent Informix-Datenbanken mit Transaktionsunterstützung benötigt!
•  Aufgrund des Informix-Fehlers muss bei bestimmten Versionen der Wert für die Umgebungsvariable DB_LOCALE mitgegeben werden. Wird DB_LOCALE nicht richtig gesetzt, dann kommt es zu dem Fehler "Database locale information mismatch".
  Setzen Sie in diesem Fall den entsprechenden Wert in der INI-Datei des Agenten mit dem Parameter db_locale= (auf Kleinschreibung achten!) in der Sektion [INFORMIX].
  Beispiel: [INFORMIX] db_locale=EN_US.CP1252 

• Ingres
• Installieren Sie den JDBC Treiber.
• Kopieren Sie nach der Installation des Treibers die Datei iijdbc.jar in das jdbc-Verzeichnis des Agenten.

• SAP HANA
• Kopieren Sie die Datei ngdbc.jar, welche sich im Installationsverzeichnis des HANA Clients befindet, in das jdbc-Verzeichnis des Agenten.

	4.	Weitere wichtige Hinweise

• Oracle RAC
• Der Agent kann auch so konfiguriert werden, dass er sich mit einer Oracle-Datenbank im RAC verbindet.

	5.	Einrichten des Systemumfeldes

• Host
• Anpassen der INI-Datei UCXJSQLX.INI an die Systemumgebung.
• Wird der Agent unter Windows gestartet und auf eine MS SQL Datenbank zugegriffen, so kann der jeweilige Windows-Benutzer für die Datenbank-Anmeldung verwendet werden. Dazu sind folgende Vorkehrungen zu treffen:
• Installieren Sie den JDBC-Treiber nach der obigen Anleitung
• INI-Datei des Agenten: WindowsAuthentication=1
• UC_HOSTCHAR_DEFAULT: ANONYMOUS_JOB = Y
• Verwenden Sie die Windows-Authentifizierung, so ist in Datenbank-Jobs trotzdem ein Login-Objekt anzugeben, dass einen passenden Eintrag für den jeweiligen Agenten enthält! Benutzer und Passwort im Login-Objekt werden nicht verwendet bzw. geprüft.

• Admin-Rechner oder Server-Rechner
• Eventuell HEADER.SQL, TRAILER.SQL und RESTART.SQL anpassen. Siehe: Job - Ausführen

	6.	Starten des Agenten

• Server-Rechner
• Automation Engine System muss laufen.
• Host
• Starten Sie den Agenten mit folgendem Kommando:
  java -jar -Xrs -Xmx256M ucxjsqlx.jar
  
  Es wird im Systemmandant 0000 ein Agenten-Objekt automatisch angelegt und im Ordner "HOST" gespeichert.

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.

.
• Admin-Rechner oder Server-Rechner
• Prüfen, ob sich der Agent angemeldet hat.
  • UserInterface für Mandant 0000 starten. In der Systemübersicht die Informationen über Agenten abrufen. Da ein neu angemeldeter Agent noch keinem Mandanten zugewiesen ist, wird er nur im Mandant 0000 sichtbar. Der neu installierte Agent kann nun über das Agenten-Objekt den Mandanten mit den gewünschten Rechten zugewiesen werden.

Verwenden Sie den ServiceManager, um den Agenten als Dienst zu starten bzw. zu beenden.