JWP Installation

Folgendes Dokument enthält die Installationsanleitung des javabasierten Arbeitsprozesses (JWP).

Allgemeines

Der JWP ist eine Komponente der Automation Engine, welche für folgende Funktionen erforderlich ist:

Single Sign-On (via KDC)
Adaptive ERT-Berechnung
Funktion Export mit Referenzen...
Automic Release Automation Integration
Globale Suche im ECC

Bereitgestellte Dateien

Der JWP wird im selben Verzeichnis wie alle anderen Automation Engine - Dateien ausgeliefert.

Datei / Verzeichnis	Beschreibung
ucsrvjp.jar	Datei zum Starten des JWPs
/lib/	Verzeichnis mit OSGI-Implementierung und JDBC-Treiber.
/plugins/com.automic.database.jar	Datei für den Datenbankzugriff.
/plugins/com.automic.ara.jar	Öffnet den ARA WebService.
/plugins/com.automic.ert.jar	(Adaptive) ERT-Berechnung
/plugins/com.automic.kernel.jar	JWP-Kernel.
/plugins/com.automic.network.jar	TCP/IP-Verbindungen.
/plugins/com.automic.sso.jar	Single Sign-On.
/plugins/com.automic.util.logging.jar	Protokoll / Trace
/plugins/org.apache* /plugins/org.eclipse*	Zusätzliche OSGI-Bundles für Konsolen und Dienste.

Das Verzeichnis /configuration/ wird automatisch erstellt wenn der JWP erstmals gestartet wird und enthält den Cache des OSGI-Bundles.

Installation

Entpacken der Dateien.

Unter Windows werden die JWP-Dateien automatisch vom SETUP.EXE-Programm in das BIN-Verzeichnis kopiert. Unter UNIX befinden sich die Dateien im zugehörigen TAR-Archiv.

Kopieren Sie die Verzeichnisse „plugin“ und „lib“ in das BIN-Verzeichnis der Automation Engine.

Die Installationsschritte, die folgen, hängen von der Art der verwendeten Datenbank ab.

MS SQL-Server

	1.	Installieren Sie den JDBC Treiber.

Laden Sie den Microsoft JDBC Treiber 4.0 für SQL Server herunter.

Kopieren Sie nach dem Download die Datei „sqljdbc4.jar“ in das lib-Verzeichnis der Automation Engine.

	2)	Aktivieren Sie TCP/IP im MS SQL-Server

Überprüfen Sie nun, ob die verwendete MS SQL-Server-Instanz Zugriff über TCP/IP erlaubt.

Öffnen Sie den SQL Server-Konfigurations-Manager und wählen Sie Protokolle für MSSQLSERVER unter SQL-Server Netzwerk Konfigurierung aus. Der Eintrag „TCP/IP“ muss im Abschnitt rechts auf „aktiviert“ gesetzt sein.

	3)	Legen Sie den MS SQL-Server Port fest

Der standardmäßige Port des MS SQL-Server Ports ist 1433.

Wenn Sie sich bezüglich des Ports Ihrer MS SQL-Server Instanz nicht sicher sind, können Sie dies in der Log-Datei nachsehen. Die Meldung „Server überwacht [ 'any‘<ipv4> Portnummer“ sollte in der aktuellen Log-Datei, die den Port enthält, zu finden sein.

	4)	Bearbeiten Sie die Automation Engine-Konfigurationsdatei

Der JWP verwendet die selbe Konfigurationsdatei (ucsrv.ini) wie andere Arbeitsprozesse des Automation Engine-Systems.

Die Datenbankverbindung muss in der Konfigurationsdatei für den JWP bearbeitet werden. Dafür gibt es zwei verschiedene Optionen:

1) DSN-lose ODBC Verbindung

Beachten Sie, dass bei dieser Variante jener Datenbank-Connection-String in der Konfigurationsdatei geändert werden muss, welchen auch alle anderen WPs des Automation Engine-Systems verwenden. Bei der Installation des JWPs für ein bestehendes System sind anschließend auch alle WPs neu zu starten.

In der Sektion [ODBC] der Konfigurationsdatei ist ein Connection-String erforderlich, dessen Syntax ohne DSN auskommt. Server und Name der Datenbank sind in diesem Fall direkt anzugeben.

SQLDRIVERCONNECT=ODBCVAR=SNNNNNRN,Driver={SQL Server Native Client VERSION};Server=tcp:SRVNAME,PORT;Database=DBNAME;Uid=DBUSER;Pwd=DBPWD

VERSION - Version des SQL Server Native Clients. Wird im SQL Server Configuration Manager angezeigt.
SRVNAME - Name des Datenbank-Rechners.
PORT - Port der MS SQL Server - Instanz.
DBNAME - Datenbank-Name.
DBUSER - Datenbank-Benutzer.
DBPWD - Datenbank-Passwort.

Beispiel:

[ODBC]
SQLDRIVERCONNECT=ODBCVAR=SNNNNNRN,Driver={SQL Server Native Client 11.0};Server=tcp:dbsrv01,1433;Database=AEV10;Uid=user;Pwd=password

Der Eintrag sollte in einer Zeile stehen (ohne Umbruch).

2. Eigener Connection-String für den JWP

Bei dieser Variante wird ein eigener Datenbank-Connection-String für den JWP in der Sektion [JDBC] definiert.

Beispiel:

[JDBC]
SQLDRIVERCONNECT=jdbc:sqlserver://dbsrv01;databaseName=AEV10

Name und Passwort des Datenbank-Benutzers werden vom [ODBC] Eintrag verwendet.

Vorteil dieser Methode ist, dass der Connection-String der anderen WPs (Sektion [ODBC]) nicht verändert werden muss und diese auch nicht neu zu starten sind.

Oracle

	1.	Installieren Sie den JDBC Treiber.

Kopieren Sie den JDBC Treiber "ojdbc6.jar" von der Oracle Datenbank Client Installation in den "lib"-Ordner des JWP.
Die Datei befindet sich unter: ORACLE_HOME/jdbc/lib/ojdbc6.jar

	2)	Konfiguration der Datenbank-Verbindung

Dazu gibt es 2 Möglichkeiten:

1. Verbindung über OCI

Bei dieser Variante ist eine Anpassung der INI-Datei ucsrv.ini nicht notwendig. Der JWP benötigt jedoch genauso Zugriff auf die Oracle Datenbank Libraries wie der WP. Bei UNIX müssen daher je nach Plattform die Umgebungsvariablen LD_LIBRARY_PATH oder SHLIB_PATH entsprechend gesetzt werden.

Mehr Informationen zur Installation des JDBC-Treibers finden Sie in der JDBC-Installationsanleitung von Oracle.

2. Direkte Verbindung zur Datenbank

Mit dem Oracle JDBC Thin Treiber ist es möglich, eine direkte Verbindung zur Datenbank aufzubauen.

Dazu ist die Sektion [JDBC] in der Datei ucsrv.ini entsprechend zu konfigurieren. Beispiel:

[JDBC]
SQLDRIVERCONNECT=jdbc:oracle:thin:@dbserver:1521/service_name

Name und Passwort des Datenbank-Benutzers werden dem [ODBC] Eintrag entnommen.

DB2

	1.	Installieren Sie den JDBC Treiber.

Kopieren Sie die Datei db2jcc4.jar (JDBC-Treiber) in das "lib" Verzeichnis des JWP.

Diese Datei ist Teil des DB2-Clients und befindet sich im Unterverzeichnis "SQLLIB/java".

	2)	Konfiguration der Datenbank-Verbindung

Eine Änderung der Konfigurationsdatei ucsrv.ini Datei ist nicht notwendig.

Falls gewünscht, kann der Datenbank-Connect-String aber in der Sektion [JDBC] der INI-Datei definiert werden.

Beispiel:

[JDBC]
SQLDRIVERCONNECT=jdbc:db2://server:<port>/database

Der Benutzername und das Passwort für den Datenbankzugriff werden dem [ODBC] Eintrag entnommen.

Hinzufügen von SSL-Zertifikaten

Um SSL zu verwenden, muss das/die Zertifikat/e des LDAP-Servers dem Java-Arbeitsprozess zur Verfügung stehen.
Der JWP verwendet die Standard-Keystore-Datei "cacerts" im lib/security-Verzeichnis des JRE.

Es gibt zwei Möglichkeiten, Zertifikate hinzufügen:

1	Hinzufügen von Zertifikaten mit dem Key-Tool

Gehen Sie zum jre\lib\security-Ordner der Java-Installation und importieren Sie das Zertifikat mit dem Key-Tool-Befehl:

keytool -keystore cacerts -importcert -alias ldapServer -file certficate.cer
Wenn Sie aufgefordert werden, diesem Zertifikat zu vertrauen, geben Sie "Y" ein.

2	Hinzufügen von Zertifikaten über Download

Eine weitere Möglichkeit, das Zertifikat zu installieren, ist der Kommandozeilenparameter -installcert des Java-Arbeitsprozesses.

java -jar ucsrvjp.jar -installcert <host>:<sslport>

Dies setzt voraus, dass der Java-Arbeitsprozess Schreibzugriff auf die Datei cacerts der Java-Installation hat.
Dieser Befehl erkennt den Pfad von cacerts, stellt eine Verbindung zum angegebenen Host und Port her und versucht, eine SSL-Verbindung einzurichten.

Bei fehlendem Zertifikat wird die Meldung "unable to find valid certification path to requested target" ausgegeben und das fehlende Zertifikat heruntergeladen und in der Datei carcets gespeichert.

Start des JWP

Verwenden Sie beispielsweise folgenden Befehl, um den JWP via Kommandozeile zu starten:

java -Xmx512M -jar ucsrvjp.jar -IC:\temp\ucsrv.ini

Die Datei ucsrvjp.jar wird im selben Verzeichnis wie die anderen Automation Engine Dateien ausgeliefert. Sie dient ausschließlich dazu, den JWP zu starten.

Es ist auch möglich, den JWP via ServiceManager zu starten.

java -Xmx512M -jar ucsrvjp.jar -svc%port% -IC:\temp\ucsrv.ini

Beim direkten Start über die Kommandozeile sollte der -svc Parameter weggelassen werden.

Der Parameter –I für die Angabe der INI-Datei ist optional. Falls der Parameter fehlt, versucht der JWP die Datei ucsrv.ini im aktuellen Arbeitsverzeichnis (=Verzeichnis, in welchem sich die Datei ucsrvjp.jar befindet) zu finden.