Agenten für Datenbankjobs und -ereignisse installieren

Diese Seite führt Sie durch die Installation des Agenten, der verwendet wird, um Datenbank-Jobs und -Ereignisse unter Windows und UNIX auszuführen.

Tipp! Diese Seite bezieht sich nur auf den manuellen Installationsprozess. Anweisungen zum Installieren eines Container-Java-Agenten finden Sie unter Container-Java-Agenten installieren.

Hinweise:

Am besten installieren Sie den Agenten in einem separaten Verzeichnis.
Der Datenbank-Agent für Jobs und Ereignisse ist nur für einen bestimmten Datenbanktyp (z. B. MS SQL) verfügbar und kann in der INI-Datei des SQL-Agenten eingestellt werden. Für jeden Datenbanktyp, auf den Jobs oder Ereignisse zugreifen können, muss ein eigener Agent installiert werden. Datenbank- und Servernamen müssen im jeweiligen Job- oder Ereignisobjekt definiert sein. Weitere Informationen finden Sie unter Agent SQL
In diesem Abschnitt wird die Installation des Agenten in einem System beschrieben, in dem keine Authentifizierung verwendet wird. Wenn Sie eine Authentifizierungsmethode verwenden möchten, müssen Sie zusätzliche Schritte durchführen. Weitere Informationen finden Sie unter Agenten-Authentifizierung.

Diese Seite beinhaltet Folgendes:

Mitgelieferte Dateien

Die Dateien, die zum Datenbankagenten gehören, werden im Verzeichnis IMAGE:AGENTS\SQL gespeichert. Darüber hinaus werden die Ordner Temp und JDBC (leer) bereitgestellt. Der Temp-Ordner speichert Logdateien, während der JDBC-Ordner die JDBC-Treiberinstallation speichern soll.

Eine Verbindung zur Automation Engine herstellen

Die Automation Engine und die Windows-, UNIX- und Java-Agenten kommunizieren unter Verwendung von TLS/SSL. Diese Agenten richten eine Verbindung zum Java-Kommunikationsprozess (JCP) ein, der vertrauenswürdige Zertifikate verwendet, um ihre Identität gegenüber anderen Kommunikationspartnern nachzuweisen.

Hinweis: Die TLS/SSL-Implementierung gilt nicht für den HP-UX-Agenten, da er in dieser Version nicht mehr unterstützt wird.

Sie können die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= in der jeweiligen INI-Datei verwenden, um auf die relevanten Zertifikate zu verweisen. Wenn der Parameter trustedCertFolder= nicht festgelegt ist, sollten die Zertifikate im jeweiligen Speicher installiert werden; das ist der Java-Truststore für Java-Agenten, der Windows-Betriebssystemspeicher für Windows-Agenten oder der TLS/SSL-Speicher für UNIX-Agenten. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

Weitere Informationen zu den verschiedenen Zertifikattypen und ausführliche Anweisungen zur Erstellung und Verwendung finden Sie unter Welche Art von Zertifikaten sollte ich für Automic Automation v21 verwenden?

TLS/SSL-Agenten (in Containern und lokal) und das TLS Gatewayrichten bei Verwendung für die Automic Automation Kubernetes Editioneine Verbindung zu einem Ingress-/HTTPS-Load Balancer ein, und nicht direkt zum JCP. Der Ingress-/HTTPS-Load Balancer muss erreichbar sein und benötigt ein Zertifikat zur Authentifizierung. Die Adresse des Load Balancers muss auf beiden Seiten definiert werden: Automation Engine und Agent/TLS Gateway.

Wichtig! Wenn Sie Agenten für ein Automic Automation Kubernetes Edition-System manuell installieren oder aktualisieren, müssen Sie sicherstellen, dass Sie Ihre Agenten und/oder das TLS Gateway konfigurieren, um den TCP- oder HTTPS-Load Balancer zu erreichen, und nicht direkt den CP oder JCP. Stellen Sie außerdem sicher, dass ihr HTTPS-Load Balancer die erforderlichen Zertifikate besitzt. Weitere Informationen finden Sie unter Eine Verbindung zum AAKE-Cluster herstellen.

Agenten für Datenbankjobs und -ereignisse installieren

Installieren Sie auf dem Admin- und/oder Benutzercomputer die Java Runtime Environment (JRE).

Wenn Sie die JRE installiert haben, können Sie diesen Schritt ignorieren. Eine Liste der kompatiblen Java-Versionen finden Sie unter compatibility matrix.

Verwenden Sie den folgenden Befehl, um die Version der aktuellen Java Virtual Machine (VM) zu prüfen:

java -version

Wenn mehrere JRE- oder Java SDK-Versionen auf dem Computer installiert sind, stellen Sie sicher, dass die Reihenfolge der Verzeichnisse in den Einstellungen %PATH% oder $PATH korrekt ist, weil die erste JRE verwendet wird, die in der Verzeichnisliste gefunden wird.
Installieren Sie auf dem Host den Agenten.
1. Erstellen Sie ein separates Verzeichnis für den Agenten (z. B. C:\AUTOMIC\AGENTS\SQL\BIN oder C:\AUTOMIC\AGENTS\SQL_SERVICE\BIN).
2. Kopieren Sie den Inhalt von IMAGE:AGENTS\SQL in das Verzeichnis, das Sie gerade erstellt haben. Unter Windows können Sie für die Installation auch das Programm SETUP.EXE verwenden. Es ist im Verzeichnis IMAGE:AGENTS\SQL\WINDOWS verfügbar.
Installieren Sie auf dem Host den JDBC-Treiber.

Für alle Datenbanken, die der Agent verwendet, muss ein geeigneter JDBC-Treiber installiert sein. Beachten Sie die Installationsanleitung des jeweiligen Herstellers.
1. Erstellen Sie den JDBC-Ordner im BIN-Ordner des Datenbankagenten.
2. Kopieren Sie die JDBC-Treiberdateien nach der erfolgreichen Installation in den Ordner JDBC.
3. Sie müssen den DB Service Agent neu starten, nachdem Sie einen neuen JDBC-Treiber im JDBC-Ordner installiert haben.
Microsoft SQL Server
1. Installieren Sie den relevanten JDBC-Treiber (Microsoft JDBC-Treiber für SQL Server oder Microsoft JDBC-Treiber 4.0 für SQL Server) von der Microsoft-Site. Der Treiber unterstützt MS SQL Server 2005 und 2008 (2008 R2).
2. Kopieren Sie die Datei sqljdbc4.jar in das JDBC-Verzeichnis des Agenten, nachdem Sie den Treiber installiert haben.
  
  Hinweise:
  - Wenn mehrere JRE- oder Java SDK-Versionen auf dem Computer installiert sind, stellen Sie sicher, dass die Reihenfolge der Verzeichnisse in den Einstellungen %PATH% oder $PATH korrekt ist, weil die erste JRE verwendet wird, die in der Verzeichnisliste gefunden wird.
  - 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 Verzeichnis BIN des Datenbankagenten kopieren. Stellen Sie sicher, dass die Architektur dieser Datei mit der Architektur der verwendeten JVM (z. B. x64) übereinstimmt.
Oracle
1. Installieren Sie den JDBC-Treiber von der Oracle-Site.
2. Kopieren Sie die relevante .jar-Datei (ojdbc5.jar oder ojdbc6.jar) in das JDBC-Verzeichnis des Agenten, nachdem Sie den Treiber installiert haben.
  
  Der JDBC-Treiber Version 9.0.1 oder früher kann nicht mit diesem Agenten 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. Sie sollten nur eine jar-Datei im JDBC-Ordner speichern.
  
  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.
MySQL
1. Installieren Sie den JDBC-Treiber von der MySQL-Site.
2. Kopieren Sie die Datei mysql-connector-java-5.0.3-bin.jar in das JDBC-Verzeichnis des Agenten, nachdem Sie den Treiber installiert haben.
DB2

Der JDBC-Treiber ist Teil der DB2-Installation. Er befindet sich im Verzeichnis SQLLIB/java (in Windows: C:\Programme\IBM\SQLLIB\java). Sie können ihn auch von der IBM-Site herunterladen.

Kopieren Sie die Dateien db2jcc.jar (Treiber JDBC Typ 4) und db2jcc_license_cu.jar (Serverlizenz) in das JDBC-Verzeichnis des Agenten.

Sybase
1. Installieren Sie den JDBC-Treiber (jConnect 5.5/6.05) von der Sybase-Site.
2. Kopieren Sie die relevante .jar-Datei (jconn2.jar oder jconn3.jar) in das JDBC-Verzeichnis des Agenten, nachdem Sie den Treiber installiert haben.
Informix
1. Installieren Sie den JDBC-Treiber (V3.5) von der IBM-Site.
2. Kopieren Sie die Dateien ifxjdbc.jar und ifxlang.jar in das JDBC-Verzeichnis des Agenten, nachdem Sie den Treiber installiert haben.
  
  Hinweise:
  - Der Agent benötigt Informix-Datenbanken mit Transaktionsunterstützung.
  - 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 ordnungsgemäß gesetzt wurde.
    
    Definieren Sie in diesem Fall den Wert im Parameter db_locale= im Abschnitt [INFORMIX] der INI-Datei des Agenten (Kleinbuchstaben verwenden). Zum Beispiel:
    
    [INFORMIX] db_locale=EN_US.CP1252
Ingres
1. Installieren Sie den JDBC-Treiber von der Ingres (ActianX)-Site.
2. Kopieren Sie die Datei iijdbc.jar in das JDBC-Verzeichnis des Agenten, nachdem Sie den Treiber installiert haben.
SAP HANA

Der JDBC-Treiber befindet sich im HANA-Installationsverzeichnis des Mandanten.

Kopieren Sie die Datei ngdbc.jar aus dem Installationsverzeichnis in das JDBC-Verzeichnis des Agenten.
Richten Sie auf dem Servercomputer die Systemumgebung ein.

Der DB-Service-Agent verwendet seine eigene INI-Datei für SQL-Agenten (UCXJSQLX.INI).
1. Passen Sie die INI-Datei des SQL-Agenten (UCXJSQLX.INI) an Ihre Systemumgebung an, siehe Agent SQL.
2. Verwenden Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= in der jeweiligen INI-Datei, um auf die relevanten Zertifikate zu verweisen. Wenn der Parameter trustedCertFolder= nicht festgelegt ist, sollten die Zertifikate im jeweiligen Speicher installiert werden; das ist der Java-Truststore für Java-Agenten, der Windows-Betriebssystemspeicher für Windows-Agenten oder der TLS/SSL-Speicher für UNIX-Agenten. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).
  
  Weitere Informationen zu den verschiedenen Zertifikattypen und ausführliche Anweisungen zur Erstellung und Verwendung finden Sie unter Welche Art von Zertifikaten sollte ich für Automic Automation v21 verwenden?
3. Wenn der Agent unter Windows startet, können Sie den Windows-Benutzer verwenden, um sich an der Datenbank anzumelden. Folgende Schritte sind dazu notwendig:
  - Stellen Sie sicher, dass der JDBC-Treiber wie oben beschrieben installiert ist.
  - Setzen Sie in der INI-Datei des SQL-Agenten den Parameter WindowsAuthentication= auf 1.
  - Setzen Sie in der Variablen UC_HOSTCHAR_DEFAULT den Parameter ANONYMOUS_JOB auf Y. Weitere Informationen finden Sie unter UC_HOSTCHAR_DEFAULT - Host-Charakteristika.
4. Passen Sie auf dem Administrator- oder Servercomputer HEADER.WINDOWS, TRAILER.WINDOWS und RESTART.WINDOWS an, falls erforderlich. Weitere Informationen finden Sie unter Jobs ausführen.
Starten Sie den Agenten.
1. Stellen Sie sicher, dass das AE-System auf dem Servercomputer ausgeführt wird. Weitere Informationen finden Sie unter Multi-Server-Vorgänge.
2. Starten Sie den Agenten mit dem folgenden Befehl auf dem Host: java -Xrs -Xmx1G -jar ucxjsqlx.jar.
  
  Ein Agentenobjekt wird automatisch im Systemmandanten 0 angelegt und im Ordner HOST gespeichert.
3. Stellen Sie auf dem Administrator- oder Servercomputer sicher, dass der Agent bei der Automation Engine angemeldet ist.
  
  Neu eingeloggte Agenten werden einem Mandanten nicht automatisch zugewiesen und können nur in Mandant 0 angezeigt werden. Sobald Sie sich bei Mandant 0 eingeloggt haben, greifen Sie auf die Administration-Perspektive zu und wählen Sie Agenten und Gruppen aus.
  
  Sie können den neuen Agenten nun über die Agentenobjektdefinition Mandanten mit den erforderlichen Rechten zuordnen. Weitere Informationen finden Sie auf der Seite Seite "Berechtigungen".
Verwenden Sie den ServiceManager, um den Agenten als Service zu starten oder zu beenden. Weitere Informationen finden Sie unter ServiceManager.

Siehe auch:

Agenten installieren