Agent für BS2000 installieren

Agenten installieren

Agent für GCOS8 installieren

---

Agent für Datenbanken installieren

Folgendes Dokument enthält die Beschreibung der Hotfix Installation des Datenbank-Agenten.

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

Der Agent für Datenbanken kann entweder für die Durchführung von Jobs und Ereignissen oder für die Ermittlung von Werten für dynamischen Variablen-Objekten (Quelle: SQL) installiert werden. Unterschiedlich ist dabei die Konfiguration und der Start (Startparameter).

• Datenbank-Agent für Jobs, Ereignisse
  Der Datenbank-Agent für Jobs und Ereignisse dient nur für einen bestimmten Datenbank-Typ (z.B.: MS SQL), der in der INI-Datei des Agenten gesetzt wird. Für jeden Datenbank-Typ, auf den über Jobs oder Ereignisse zugegriffen werden soll, ist daher ein eigener Agent zu installieren. Der Name der Datenbank, Servers usw. ist im jeweiligen Job oder Ereignis-Objekt festzulegen.
  
• Datenbank-Agent für Variablen
  Der Agent für SQL-Variablen kann auf jeden unterstützten Datenbank-Typ zugreifen. Der Typ ist im Verbindungs-Objektfür Datenbanken festzulegen, dass den Variablen zugeordnet wird. Somit ist nur ein Agent für Variablen zu installieren. Im DB Verbindungs-Objekt wird auch der Name der Datenbank und die Verbindungsparameter (Servername, Portnummer, usw.) festgelegt. Weiters wird der Agent nicht über seine eigene sondern die INI-Datei der Automation Engine konfiguriert!
  Der Agent ist nur für Variablen-Objekte mit der Quelle SQL erforderlich. SQLI-Variablen benötigen keinen Agenten!

Installieren Sie den Agenten unbedingt in ein eigenes Verzeichnis!

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 Treiber.
• Kopieren Sie nach der Installation des Treibers die Datei sqljdbc.jar in das jdbc-Verzeichnis.
• Beachten Sie, dass der SQL-Server 2000 JDBC-Treiber aufgrund eines Programmfehlers im Treiber nicht mit dem Agenten verwendet werden können!
• 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). Bei der Installation des JDBC-Treibers ist zusätzlich die Datei "sqljdbc_auth.dll" in das BIN-Verzeichnis des 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 ojdbc14.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!

• 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.

• EXASOL
• Laden Sie den Treiber von EXASOL herunter.
• Kopieren Sie den JDBC-Treiber exajdbc.jar in das JDBC-Verzeichnis des Agenten.
• Stellen Sie den Daten-Typ in der Konfigurationsdatei auf EXASOL ein.
• Setzen Sie die Werte für
  connect=60
  und
  retention_time=180

• PostgreSQL
• Laden Sie den Treiber von PostgreSQL herunter.
• Kopieren Sie den JDBC-Treiber in das JDBC-Verzeichnis (postgresql-9.3-1100.jdbc4.jar, zum Beispiel).
• Stellen Sie den Daten-Typ in der Konfigurationsdatei auf POSTGRESQL ein.
• Setzen Sie die Werte für
  connect=60
  und
  retention_time=180

	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

Datenbank-Agent für Jobs, Ereignisse 

• 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

Datenbank-Agent für Variablen

• Server-Rechner
• Der Datenbank-Agent für Variablen verwendet die INI-Datei der Automation Engine. Passen Sie die Sektion [DB_SERVICE] an, die spezielle Parameter für den Datenbank-Agenten enthält. Die INI-Datei des Agenten wird nicht benötigt.
• Legen Sie danach für jede verwendete Datenbank ein DB-Verbindungsobjekt im Automation Engine System an. Dabei können auch Verbindungen für verschiedene Datenbank-Typen erstellt werden.
• Wird der Agent unter Windows gestartet, kann für die Anmeldung an MS SQL Datenbanken der Windows-Benutzer verwendet werden. Tragen Sie dazu im entsprechenden DB Verbindungs-Objekt als zusätzlichen Parameter "IntegratedSecuirty" ein und setzen Sie den zugehörigen Wert auf "true".

	6.	Starten des Agenten

• Server-Rechner
• Automation Engine System muss laufen.
• Host
• Starten des Agenten für Jobs oder Ereignisse:
  java -jar ucxjsqlx.jar
  
  Um den Agenten im Modus für Datenbank-Variablen zu starten, ist der Parameter -service und der Pfad und Name der INI-Datei der Automation Engine anzugeben.
  Beispiel: java -jar ucxjsqlx.jar -iC:\AUTOMIC\server\bin\ucsrv.ini -service
  
  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.