Agenten für Datenbankjobs und -ereignisse installieren

Im Folgenden wird der Installationsprozess für den Agenten beschrieben, mit dem Datenbankjobs und -ereignisse ausgeführt werden.

Hinweise:

Diese Seite beinhaltet Folgendes:

Mitgelieferte Dateien

Die Dateien, die zum Datenbankagenten gehören, werden im Verzeichnis IMAGE:AGENTS\SQL gespeichert.

Zusätzlich werden zwei leere Ordner (Temp und JDBC) bereit gestellt. Der Ordner Temp speichert Logdateien und der JDBC-Treiber muss im JDBC-Ordner installiert sein.

Agenten für Datenbankjobs und -ereignisse installieren

  1. Installieren Sie die Java-Laufzeitumgebung (JRE) (Administrator- und/oder Benutzercomputer)

    Wenn JRE in der gewünschten Version bereits vorhanden ist, kann dieser Schritt des Installationsprozesses ignoriert werden.

    • Die Version der aktuellen Java Virtual Machine (VM) des Systems kann mit dem folgenden Kommando überprüft werden:

      java -version

      Wenn mehrere JRE- oder Java-SDK-Versionen auf dem Computer installiert sind, ist die Reihenfolge der Verzeichnisse wichtig, die in den Einstellungen von %PATH% oder $PATH angegeben ist. Dabei wird die jeweilige Java-Laufzeitumgebung verwendet, die in der Liste der Verzeichnisse an erster Stelle steht.

    • Laden Sie die erforderliche Java-Laufzeitumgebung von http://java.sun.com herunter und installieren Sie sie. Der Installationsprozess beinhaltet die automatische Installation des Java-Plug-Ins für Webbrowser. Sie können die automatische Installation in der Systemsteuerung deaktivieren. Für die Automation Engine ist dies nicht erforderlich.

  2. Installieren Sie den Agenten (Host).

    • Erstellen Sie ein eigenes Verzeichnis für den Agenten (z. B. C:\AUTOMIC\AGENTS\SQL\BIN oder UC4/AGENTS/SQL/BIN).
    • Kopieren Sie den Inhalt von IMAGE:AGENTS\SQL in das Verzeichnis, das Sie gerade erstellt haben. Bei Windows können Sie für die Installation auch das Programm SETUP.EXE verwenden. Es ist im Verzeichnis IMAGE:AGENTS\SQL\WINDOWS verfügbar.

  3. Installieren Sie den JDBC-Treiber (Host)

    • Für alle Datenbanken, die der Agent verwenden wird, muss ein geeigneter JDBC-Treiber installiert sein. Beachten Sie die Installationsanleitung des jeweiligen Herstellers.
    • Erstellen Sie den Ordner JDBC im BIN-Ordner des Datenbankagenten. Kopieren Sie die JDBC-Treiberdateien nach erfolgreicher Installation 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 die Datei sqljdbc4.jar in das JDBC-Verzeichnis des Ordners, nachdem Sie den Treiber installiert haben.
    • Hinweis: Wenn mehrere JRE- oder Java-SDK-Versionen auf dem Computer installiert sind, ist die Reihenfolge der Verzeichnisse wichtig, die in den Einstellungen von %PATH% oder $PATH angegeben ist. Dabei wird die jeweilige Java-Laufzeitumgebung verwendet, die in der Liste der Verzeichnisse an erster Stelle steht.
    • Wenn Sie den Agenten unter Windows starten, können Sie sich mit dem entsprechenden OS-Benutzer an der MS SQL-Datenbank anmelden (Windows-Authentifizierung). Wenn Sie den JDBC-Treiber installieren, müssen Sie auch die Datei "sqljdbc_auth.dll" in das BIN-Verzeichnis des Datenbankagenten kopieren. Stellen Sie sicher, dass die Architektur dieser Datei mit der Architektur der verwendeten JVM (z. B. x64) übereinstimmt.
    • Oracle
    • Treiber installieren
    • Kopieren Sie die Datei ojdbc5.jar oder ojdbc6.jar in das JDBC-Verzeichnis des Ordners, nachdem Sie den Treiber installiert haben.

      • Der JDBC-Treiber der Version 9.0.1 oder früher kann mit diesem Agenten aufgrund eines Programmfehlers im Treiber nicht verwendet werden.

      Der Agent durchsucht die relevanten jar-Dateiklassen im JDBC-Ordner. Der Dateiname ist irrelevant. Es ist wichtig, die aktuellste jar-Datei zu verwenden. Speichern Sie nur eine jar-Datei im JDBC-Ordner.

    • MySQL
    • Treiber installieren
    • Kopieren Sie die Datei mysql-connector-java-5.0.3-bin.jar in das JDBC-Verzeichnis des Ordners, nachdem Sie den Treiber installiert haben.
    • DB2
    • Der JDBC-Treiber ist Teil der DB2-Installation. Sie befindet sich im Verzeichnis SQLLIB/java (unter Windows: C:\Programmdateien\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 (Serverlizenz)
    • Der JDBC-Treiber kann auf der IBM-Website heruntergeladen werden.
      Klicken Sie auf den Eintrag "DB2 Personal Developers Edition: Re-distributable JDBC Type 4 Driver".
    • Sybase
    • Installieren Sie den Treiber (jConnect 5.5/6.05).
    • Kopieren Sie die Datei jconn2.jar oder jconn3.jar in das JDBC-Verzeichnis des Ordners, nachdem Sie den Treiber installiert haben.
    • Informix
    • Installieren Sie den Treiber (V3.5).
    • Wenn der Treiber installiert ist, kopieren Sie die Dateien ifxjdbc.jar und ifxlang.jar in das jdbc-Verzeichnis des Agenten.

      • Bitte beachten Sie, dass der Agent Informix-Datenbanken mit Transaktionsunterstützung benötigt.

      Aufgrund eines Informix-Fehlers ist es erforderlich, in bestimmten Versionen den Wert für die Umgebungsvariable DB_LOCALE anzugeben. Der Fehler "Datenbank-Umgebungsinformationen stimmen nicht überein" tritt auf, wenn DB_LOCALE nicht korrekt gesetzt wurde. Setzen Sie in diesem Fall den entsprechenden Wert in der INI-Datei des Agenten im Abschnitt [INFORMIX] mit dem Parameter db_locale=(in Kleinbuchstaben).
      Beispiel: [INFORMIX] db_locale=EN_US.CP1252 

    • Ingres
    • Installieren Sie den jdbc-Treiber.
    • Wenn der Treiber installiert ist, kopieren Sie die Datei iijdbc.jar in das JDBC-Verzeichnis des Agenten.
    • SAP HANA
    • Kopieren Sie die Datei ngdbc.jar aus dem Installationsverzeichnis des HANA-Clients 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 in RAC verbinden kann. Weitere Informationen finden Sie unter Verbindung zu Oracle-Datenbanken.

    Hinweis: Die Verbindungsinformationen des Agenten selbst müssen über Verbindungsobjekte (z. B. in SQL-Variablen) definiert werden. Im Connection-Objekt würden Sie Oracle oder Oracle OCI als Verbindungstyp verwenden.

  5. Einrichten der Systemumgebung (Host)

    • Passen Sie die INI-Datei des SQL-Agenten (UCXJSQLX.INI) an die Systemumgebung an, siehe Agent SQL.
    • Wenn der Agent unter Windows startet und auf eine MS SQL-Datenbank zugreift, können Sie sich mit dem entsprechenden Windows-Benutzer an der Datenbank anmelden. Die folgenden Maßnahmen sind erforderlich:
    • Admin-Computer oder Server-Computer
    • Passen Sie HEADER.WINDOWS, TRAILER.WINDOWS und RESTART.WINDOWS bei Bedarf an. Weitere Informationen finden Sie unter Jobs ausführen.

  6. Starten Sie den Agenten

    • Das AESystem muss laufen (Servercomputer). Weitere Informationen finden Sie unter Multi-Server-Vorgänge.
    • Starten Sie den Agenten mit folgendem Befehl (Host):
      java -jar -Xrs -Xmx256M ucxjsqlx.jar

      Ein Agent-Objekt wird automatisch in Systemmandanten 0000 erstellt und im Ordner HOST gespeichert.

      • Die maximale Größe der Speicherzuweisungspools sollte für das Starten von Java-Agenten (Datenbanken, Rapid Automation, JMX, SAP) auf mindestens 256 MB eingestellt werden. Sie können einen Wert für die Speicherbegrenzung von Java-Anwendungen mit dem Startparameter -Xmx angeben. Die Angabe eines zu niedrigen Wertes kann zum Absturz des Agenten führen. Der Standardwert hängt von der verwendeten Java-Version ab. Dieser Wert muss ein Vielfaches von 1024 größer als 2MB sein. Fügen Sie den Buchstaben k oder K an, um Kilobyte anzugeben, oder m oder M, um Megabyte anzugeben. Wenn große Spool-Listen oder Job-Protokolle übertragen werden, sollte der Wert viel höher sein (z. B. -Xmx1024M).

      Der Java-Parameter -Xrs stellt sicher, dass der Agent im Service Manager weiterläuft, wenn sich ein Benutzer abmeldet. Es ist am besten, diesen Parameter nur unter Windows zu verwenden. Detailliertere Informationen finden Sie in der Java-Dokumentation.

    • Stellen Sie sicher, dass der Agent am AE-System (Admin- oder Servercomputer) angemeldet ist.
      • Starten Sie das AWI für den Mandanten 0000. Informationen über Agenten finden Sie in der Administration-Perspektive. Neu angemeldete Agenten sind noch keinem Mandanten zugeordnet; sie können nur im Mandanten 0000 eingesehen werden. Der neu installierte Agent kann nun über das Agentenobjekt den Mandanten mit den erforderlichen Rechten zugewiesen werden. Weitere Informationen finden Sie auf der Seite "Berechtigungen".

    Verwenden Sie den ServiceManager, um den Agenten als Service zu starten oder zu beenden. Weitere Informationen finden Sie unter ServiceManager.