Upgrade eines AE-Systems von Version 9

Gehen Sie auf jeden Fall nach dieser Anleitung vor! Ein erfolgreiches Upgrade Ihres Automation Engine Systems ist ansonsten nicht gegeben!

Das Upgrade darf niemals sofort in einem produktiven Automation Engine System erfolgen! Ein umfangreicher Test der neuen AE-Version muss zuallererst immer in einer gesonderten Umgebung durchgeführt werden!

Einzelheiten zur Installation von Hotfixes, siehe Hotfix-Installation.

Für das Upgrade eines Automation Engine Systems ist ein strukturiertes Vorgehen enorm wichtig, um ohne große Verzögerungen weiter produktiv bleiben zu können.
Der folgende Leitfaden zeigt Ihnen die Schritte, die bei einem Update notwendig sind, und weist Sie auf mögliche sensible Punkte hin. Der Umstieg auf eine neue Automation Engine-Version geht damit zügig voran und Sie können schon in Kürze die vielen neuen Funktionalitäten nutzen.

Bei einem Versionswechsel der Automation Engine werden alle für das Ausführen der Änderungen an der Datenbank notwendige Schritte durch das Dienstprogramm AE DB Load durchgeführt und überwacht. Das ist notwendig, da mit diesem auch Veränderungen an den Daten vorgenommen werden, die mit reinem SQL nicht möglich sind. Die vom Dienstprogramm ausgeführten Schritte beim Upgrade sind einerseits in der Datei uc_upd.txt ersichtlich und dokumentiert. Zudem gibt die Datei chngdb.sql auf jeden Fall darüber Auskunft welche Anweisungen gegen die Datenbank abgesetzt werden. Die Ausführung muss jedoch nach wie vor über das Dienstprogramm erfolgen. Die Vorbereitung der Datenbank ist bei jedem Automation Engine-Versionswechsel den Release Notes zu entnehmen.

Der Upgrade-Vorgang umfasst mehrere Phasen:

1. Installation und umfangreiche Test in einer Testumgebung.
2. Planen des Umstiegszeitpunktes und Erstellen eines Konzeptes für einen möglichen Rückstieg.
   Wechseln Sie auf keinen Fall ohne Rückstiegsszenario auf eine neue Automation Engine-Version!
3. Sicherstellen der Datenbank sowie aller Verzeichnisse der Komponenten
4. Schrittweises Upgrade OHNE die Verwendung der neuen Funktionalitäten
5. Erst nachdem jede Komponente auf die neue Version umgestellt und ein Beobachtungszeitraum eingehalten worden ist, können die neuen Funktionen verwendet werden.

Jede Phase besteht aus vielen kleinen Schritten, d.h. Ihr Automation Engine System wird nicht auf einmal, sondern Stück für Stück aktualisiert. Dabei werden die alten Komponenten nicht überschrieben, sondern parallel in eigene Verzeichnisse installiert. Lediglich die Datenbank wird mit Hilfe des Dienstprogrammes AE DB Load direkt aktualisiert. Diese Methode bietet zwei wesentliche Vorteile:

1. Treten Probleme in Ihrer Systemumgebung auf, so können Sie rasch auf die alte Version der Komponente zurücksteigen. Eine Gefährdung Ihrer Verarbeitung ist damit minimal.
2. Der gesamte Upgradevorgang nimmt je nach Umfang des Automation Engine Systems einige Zeit in Anspruch. Durch die schrittweise Aktualisierung können Sie anstatt eines großen Zeitfensters einzelne, kleinere Zeitpunkte wählen und so das Upgrade besser mit anderen Abteilungen und Prozessen koordinieren. Zudem lassen sich somit eventuell auftretende Fehler besser lokalisieren.

Führen Sie zuerst das Upgrade in Ihrem Testsystem durch. Mögliche Probleme lassen sich auf diese Weise erkennen und beheben bevor Sie später im Produktivsystem auftreten. Spielen Sie die einzelnen Schritte des Upgrades in Ihrem Testsystem durch und erstellen Sie dabei gleich einen Plan für die Aktualisierung Ihres Produktivsystems.

Während des Updates der Datenbank steht das Automation Engine System nicht zur Verfügung!

Nach jedem Teilschritt des Upgrades sind die neuen Komponenten über einen gewissen Zeitraum zu beobachten. Erst wenn deren Stabilität erwiesen ist, kann mit dem Aktualisieren weiterer Komponenten fortgesetzt werden.

Beachten Sie, dass der von uns empfohlene Weg des Upgradevorgangs jederzeit eine Wiederaufnahme der Produktion in der alten Automation Engine-Version erlaubt. Dafür ist es notwendig, die Komponenten parallel zu installieren sowie eine zweite Datenbankinstanz bereit zu stellen.

Sollten Sie eine Aufstellung über die Änderungen der Meldungen benötigen, können Sie das Vergleichsprogramm dazu verwenden.

Unsere Berater sind Experten für das Upgraden von AE-Systemen. Zögern Sie bitte nicht, uns zu kontaktieren, wenn Sie Unterstützung benötigen.

Die Tabelle unten listet neue Funktionen, die Kompatibilitätsprobleme verursachen könnten oder bei einem Upgrade zu berücksichtigen sind, auf – sie enthält nicht alle neue Funktionen dieser AE-Version.
Neue Funktionen werden in den Release Notes detailliert beschrieben.

Erklärung der Tabellenspalten:

• Thema – Bezeichnung des generellen Themas oder der neuen Funktion
• Geändertes Verhalten – Was geändert wurde
• Mögliche Inkompatibilitäten – Mögliche Auswirkungen der Änderungen
• Maßnahmen/Gegenmaßnahmen – Was kann getan werden, um mögliche Inkompatibilitäten zu identifizieren und/oder zu beheben?

Allgemeine DB-Änderung

Informationen und Prüfanweisungen gelten für alle Versionen und betreffen jeweils Ihre bestehende Installation und die neueste Version, auf die Sie upgraden möchten.

Schema/Struktur der DB wurde geändert.

Benutzerdefinierte SQL-Abfragen auf AE DB funktionieren nicht mehr.

• Überprüfung von chngdb.sql auf allgemeine Änderungen
• Überprüfung und entsprechende Anpassung von SQL/SQLI/SQLJOBS-Objekten
• Überprüfen und passen Sie relevante DB-Abfragen an, die in externen Tools/Programmen eingesetzt werden.

Release-Paket

Das Release-Paket (.zip-Dateien, Ordnerstruktur und deren Inhalte) wurde geändert.

Folgende Dateien und Ordner wurden entfernt:

• Ordner ./11/ (der Inhalt, z.B. UserInterface, AutomationEngine) befindet sich jetzt direkt im Hauptverzeichnis und nicht mehr im Unterordner.
• Die uc4setup-Dateien und die CD-Imagedateien wurden entfernt.
• In den Produkt-Bundles steht ein neues Installationsprogramm für eine Einzelfeld-Installation zur Verfügung.

Möglicherweisen werden automatisierte Installationsroutinen mithilfe von Release-Images nicht funktionieren.

Falls Scripts auf die alte Paketstruktur angewiesen sind, müssen Sie die Pfade anpassen.

CP/WP-Routing 

FORMS Anfragen für das Routing zu RA Agenten wurde geändert.

Wenn Sie RA-Verbindungsobjekte bearbeiten, muss ein entsprechender RA-Agent im gleichen Mandanten aktiv sein, um Daten abrufen zu können.

Weisen Sie einen RA-Agenten für relevante Mandanten zu.

Drittüberwachung über External Monitoring Interface

Die neue, hochmoderne JMX-Schnittstelle EMI (External Monitoring Interface) wurde eingeführt.

Die vorhandene SNMP-Schnittstelle ist nach wie vor verfügbar, aber Drittintegration mit BMC Patrol, HP OpenView und Tivoli wird nicht mehr unterstützt.

Es besteht zwar keine Inkompatibilität, aber die Integration mit BMC Patrol, HP OpenView und Tivoli ist nicht mehr verfügbar.

Integrieren Sie Überwachungssysteme Dritter über die neue EMI-Schnittstelle.

Verdoppelung der MQ-Tabellen

Die MQ-Tabellen wurden verdoppelt und umbenannt.

Wenn Sie DB Reorg nutzen, werden MQ-Tabellen u.U. nicht berücksichtigt und vorhandene Scripts können aufgrund geänderter Tabellennamen fehlschlagen.

Passen Sie DB Reorg-Scripts an.

Proxy INI-Dateierweiterungen

Aufgrund von Funktionalitätsverbesserungen wurden Parameter und Formate einiger Parameterwerte in der INI-Datei geändert.

Ohne Anpassung können Sie die INI-Dateien der Proxy-Versionen vor Version 2 nicht nutzen.

Passen Sie INI-Dateiparameter entsprechend der Proxy-Benutzerdokumentation an.

Die Tabelle unten listet neue Funktionen, die Kompatibilitätsprobleme verursachen könnten oder bei einem Upgrade zu berücksichtigen sind – sie enthält nicht alle neue Funktionen dieser AE-Version.
Neue Funktionen werden in den Release Notes detailliert beschrieben.

Erklärung der Tabellenspalten:

• Thema – Bezeichnung des generellen Themas oder der neuen Funktion
• Geändertes Verhalten – Was geändert wurde
• Mögliche Inkompatibilitäten - Mögliche Auswirkungen der Änderungen
• Maßnahmen/Gegenmaßnahmen - Was kann getan werden, um mögliche Inkompatibilitäten zu identifizieren und/oder zu beheben?

Meldungsnummern

(Genauere Informationen zu einzelnen möglichen Auswirkungen finden Sie im Thema Änderungen der Meldungsnummer)

Meldungsnummern sind nun acht Zeichen lang, statt wie bisher sieben.

Altes Format: Unnnnnn
Neues Format Unnnnnnn

Filterung auf Unnnnnn Nummern funktioniert nicht mit

• PREP_PROCESS_REPORT
• PREP_PROCESS_FILE
• Output Scan-Filter
• Protokollierung von Scan-Scripts oder benutzerdefinierten Tools
• Job-Reports alter, javabasierter Agenten enthalten Meldungen mit 7 und 8 Ziffern
• Agenten älterer Versionen senden/protokollieren 7-stellige Meldungsnummern

• Suchen der Scriptfunktionen PREP_PROCESS_REPORT und PREP_PROCESS_FILE in Scripts über die Suchfunktion; Ändern von z. B. PREP_PROCESS_REPORT(,,’ACT’,’*U1234567*’) in PREP_PROCESS_REPORT(,,’ACT’,’*U01234567*’) 
• Manuelle Überprüfung von Filter-Objekten oder mithilfe eines SQL-Statements wie
  SELECT OH_Name FROM OH,OFC WHERE OH_Idnr=OFC_OH_Idnr AND OFC_Filtertext LIKE 'U001%' AND OH_DeleteFlag = 0

Variablenwerte, Textfelder 

• Die Beschränkung auf 1024 Zeichen für textbasierte Felder/Variablen wurde entfernt
• Der Datentyp von DB-Feldern wurde von VARCHAR (1024) in CLOB (unbegrenzt) geändert

• Oracle DBMS_LOB Package muss für die Verarbeitung von CLOB installiert sein  
• Ergebnisse, die auf String-Operationen basieren, können 1024 Zeichen überschreiten, anstelle einer String-Verkürzung oder Ausgabefehlermeldung
• Abfragen von SQL/SQLI-Objekten können in Tabellen mit Textfeldern von geändertem Datentyp ausgeführt werden -> siehe chngdb.sql

Überprüfung von Abfragen auf Tabellen mit geänderten Feldern (VARCHAR -> CLOB)

z. B. Suche nach „OVW_Value1“: SELECT OH_Name FROM OH WHERE OH_Idnr IN (SELECT OVD_OH_Idnr FROM OVD WHERE OVD_SQL like '%OVW_Value1%' OR  OVD_SQLOra like '%OVW_Value1%' OR OVD_SQLDB2 like '%OVW_Value1%')

Skriptfunktion GET_OH_IDNR

Der zweite Parameter-Mandant wurde aus Sicherheitsgründen aus dieser Automic Script-Funktion entfernt.

Objekte, die diese Script-Funktion mit dem angegebenen Parameter-Mandant verwenden, werden abgebrochen.

Überprüfen aller Script-Registerkarten in Bezug auf diese Funktion und Entfernen des Parameters/Korrektur des Funktionsaufrufes.

Login-Objekte für Dateisystem-Ereignisse auf Windows, Unix, zOS

Es wurde ein neues Privileg für Benutzer-Objekte eingeführt.

Das neue Privileg wird überprüft und nach der Aktualisierung der AE-Version standardmäßig eingesetzt.

• Bei der Aktualisierung wird der neue Standardwert verwendet. Es sind keine Maßnahmen erforderlich.
• Wenn Benutzer-Objekte jedoch z. B. über Transportkoffer oder XML importiert werden, ist dieses Privileg u.U. nicht gesetzt. Es muss ggf. manuell eingestellt werden.

zOS: ersetzt Jobzeile in JCL

Der Wert des Attributs MVS_JOBTYP wurde deprecated.

Derzeit keine Inkompatibilität, der alte Wert ist nach wie vor kompatibel.

Keine Überprüfungen/Anpassungen erforderlich

XML-Variablen (VARA.XML)

• „Oracle Instant Client“ wird nicht mehr unterstützt.
• „Oracle XML DB Package“ muss installiert werden.

• „Oracle Full Client“ muss installiert sein (anstelle von „Oracle Instant Client“).
• „Oracle XML DB Package“ muss installiert sein.

Kein Überprüfungen/Anpassungen erforderlich; Teil der DB-Installation von AE

FAULT_OTHER Aufgaben

Das Deaktivierungsverhalten von Aufgaben mit Status FAULT_OTHER wurde verändert.

• In früheren AE-Versionen wurden Aufgaben in Aktivitäten standardmäßig deaktiviert. Ab Version 11 unterliegt die Deaktivierung den Deaktivierungsoptionen der Aufgabe.
• Dementsprechend verbleiben mehr Aufgaben im Aktivitätenfenster als in früheren AE-Versionen.

Überprüfung der entsprechenden Deaktivierungsoptionen.

(Bei Bedarf können sie so eingestellt werden, dass das Verhalten früherer AE Version archiviert wird)

Skriptfunktion GET_ATT_SUBSTR(call_text)

In früheren AE-Versionen wurde mindestens ein Leerzeichen zurückgegeben. Ab Version 11 wird bei fehlendem Aufruftext kein Wert zurückgegeben.

Bei leerem Aufruftext tritt ein Fehler auf.

RA-Agenten

Die gemeinsamen Drittanbieterbibliotheken wurden aus dem RA-Agentencore entfernt.

Sie müssen alle benötigten Drittanbieterbibliotheken erhalten und für deren korrekte Installation sorgen.

Oracle JDBC-Treiber herunterladen und in das lib-Verzeichnis des RA-Core kopieren.

Dies ist nur bei einem RA-Agenten erforderlich, der eine Oracle DB-Verbindung benötigt (über JDBC) – z.B. RA Banner, RA Oracle EBS, RA JDE oder RA Oracle Retail.

Von Version 9 SP4 bis Version 10 SP4 wird GET_VAR rekursiv aufgelöst. D. h.: Wenn ein Wert „&“ enthält, versucht der Script-Prozessor, dies aufzulösen. Dies wurde geändert.
Beispiel:
Statische Variable 'MYVAR', Key = 1 Value = 'Schmidt&Partners'
Script
:set &partners = 'no'
:set &value# = get_var('MYVAR','1')

Die Variable &value# wird daher Folgendes enthalten:
v9 SP4 bis v10: Schmidtno
V11 : Schmidt&Partners

Ab Version 10 SP4 HF1 konnte das Verhalten konfiguriert werden (Key RESOLVE_GET_VAR in UC_SYSTEM_SETTINGS).

In Version 11 wurde die Konfigurationsoption entfernt. Daher müssen alle rekursiv aufzulösenden variablen Werte die Scriptfunktion RESOLVE_VAR verwenden.

Alle Scripts, die GET_VAR und einen Variablenwert, der "&" Zeichen enthält, verwenden, sind davon potenziell betroffen.
Es ist nicht einfach, festzustellen, welche Scripts/Variablen betroffen sind, besonders bei dynamischen Variablen.
Automic empfiehlt, umfangreiche Tests durchzuführen.

Mit dieser SQL-Abfrage können Sie die betroffenen Variablen-Objekte ermitteln:

select oh_client, oh_name from oh where oh_idnr in
(select ovw_oh_idnr from ovw where
ovw_value1 like '%&%'
or OVW_Value2 like '%&%'
or ovw_value3 like '%&%'
or ovw_value4 like '%&%'
or ovw_value5 like '%&%'
) order by OH_Client, OH_Name asc

Die Script-Funktion RESOLVE_VAR kann für die rekursive Auflösung eines statischen Variablen-Objekts verwendet werden.

Script-Variablen wurden auf unlimitierte Länge geändert.

Sie können GET_VAR für die Prüfung eines nicht existierenden Keys verwenden, der ein Leerzeichen zurückgibt, wie in diesem Beispiel beschrieben:
:SET &test# = GET_VAR(‚VARA.TEST‘,‘KEY_DOES_NOT_EXIST‘)

Wenn Sie darauffolgend STR_MATCH() mit einer leeren Zeichenkette für die Script-Variable &test# verwenden, wie hier:
:SET &true# = STR_MATCH(&test#,"")

in V10 der Automation Engine ist der Rückgabewert für &true# "Y"
In V11 wird es "N" sein.

Erklärung:
In STR_MATCH() wird eine Variable der Länge 0 erwartet (""). Da die Variable &test# ein Leerzeichen (" ") enthält, ist der Rückgabewert für &true# "N".

Das Verhalten in V11 ist daher korrekt.

Das Ergebnis des folgenden Scripts ist in Version 10 und Version 11.1 unterschiedlich:

: SET &TEST# = ' 0000000050'
:IF FORMAT(&TEST#, "0") = 50
:P "valid"
:ENDIF

In Version 10 erhält dieses Script im Report das Ergebnis „gültig“.

In Version 11.1 erhalten Sie die Fehlermeldung, dass eine unzulässige nicht-numerische Eingabe vorliegt.

Die Tabelle unten listet neue Funktionen, die Kompatibilitätsprobleme verursachen könnten oder bei einem Upgrade zu berücksichtigen sind, auf – sie enthält nicht alle neue Funktionen dieser AE-Version.
Neue Funktionen werden in den Release Notes detailliert beschrieben.

Erklärung der Tabellenspalten:

• Thema – Bezeichnung des generellen Themas oder der neuen Funktion
• Geändertes Verhalten – Was geändert wurde
• Mögliche Inkompatibilitäten – Mögliche Auswirkungen der Änderungen
• Maßnahmen/Gegenmaßnahmen – Was kann getan werden, um mögliche Inkompatibilitäten zu identifizieren und/oder zu beheben?

In Version 9 führten die Standardwerte dieser Einstellungen dazu, dass Dateiübertragungen synchron verarbeitet wurden.
Beachten Sie, dass sie nach einem Update auf Version 10 nach wie vor synchron verarbeitet werden.

In der Dokumentation zu beachten: Der Name der Datei, über welche die Dokumentation aufgerufen wird, hat sich geändert. Die neuen Namen lauten:

• HtmlHelp: help.chm
• WebHelp: help.htm
• Messages-Dokumentation: Messages.chm / Messages.htm

• Verwenden Sie die Suchfunktion CANCEL_UC_OBJECT, um Objekte in Prozess-Registerkarten zu finden (gehen Sie zu Weitere Optionen / [x] Suchen in Process, Text: CANCEL_UC_OBJECT)
• Ersetzen Sie die Funktion CANCEL_UC_OBJECT durch DEACTIVATE_UC_OBJECT in Fällen, wo eine Aufgabe durch die Funktion zwar deaktiviert, jedoch nicht abgebrochen werden soll.

Nun müssen Sie stattdessen die Script-Funktion DEACTIVATE_UC_OBJECT nutzen.

Upgrade-Dienstprogramme

Upgrade von AE und ServiceManager

Upgrade Framework Integration (optional)

Upgrade UserInterfaces (if they have not yet been upgraded)

Upgrade the Enterprise Control Center (if it has not yet been upgraded)

Stop all clients

Stop the Automation Engine

Back up the AE database

Upgrade the AE database

• Automic strongly recommends reading the notes concerning database modifications below before starting the upgrading process.
• Upgrade your AE database using the utility AE DB Load. The individual steps you find below.
• If you have created a duplicate, Automic recommends upgrading it now in order to make sure that the original instance remains operable. Keep in mind to enter the correct database connection in the INI files of the utilities.

Notes on Upgrading the AE Database   Wichtige Hinweise:   Wir empfehlen, die folgenden Schritte von einem Datenbank-Administrator durchführen zu lassen!  Beachten Sie, dass direkte Änderungen am Datenbankinhalt, d.h. ohne den Einsatz von AE-Programmen, zu einer inkonsistenten Datenbank führen!  Führen Sie die Arbeitsschritte erst durch, wenn die Datenbank gesichert wurde.  Je nach Größe der Datenbank und Umfang des Upgrades kann dieser Vorgang entsprechend dauern. Eventuell müssen auch sehr große Datenmengen bewegt werden.  Sorgen Sie dafür, dass für das \AUTOMIC\DB-Verzeichnis entsprechend viel Plattenplatz frei ist und der LOG-Bereich der Datenbank diese Datenmengen aufnehmen kann.  Die Schemarechte, die der verwendete Datenbank-Benutzer benötigt, sollten nach dem Update wieder entfernt werden. Dadurch sind ungewollte Datenbankveränderungen vermeidbar. DB2: After updating the AE database, check the size of the tablespaces and if required, run the following SQL statement: alter tablespace <UC4 tablespace name> reduce max;

Database Upgrade with AE DB Load Utility Hinweise: Auf der Auslieferungs-CD können im DB-Verzeichnis mehrere Versionen von SQL-Scripts und Datenbank-Dateien vorhanden sein. Diese werden dazu benötigt, wenn ein Upgrade über mehrere Versionen erfolgt. Wenn im Dokument <vers> angegeben, so verwenden Sie bitte jene Version, die Sie jetzt installieren wollen. Lesen Sie dazu auch unbedingt die obigen Hinweise für das Upgrade der AE-Datenbank. Die Änderungen, die vorgenommen werden müssen, befinden sich in der Datei special_rt.sql. Zusätzlich muss aber auch die Datei new_mq.sql ausgeführt werden. Suchen Sie in der Datei UC_UPD.TXT nach den Zeilen und entfernen Sie das Kommentarkennzeichen „message“ am Beginn. Auszug aus der angepassten UC_UPD.TXT: process_sql_file new_mq.sql process_sql_file special_rt.sql Die Datei special_rt.sql setzt die gespeicherten Reports in der Datenbank um. Je nachdem wieviele Report-Datensätze von der Umsetzung betroffen sind, müssen Sie darauf achten, dass genügend Speicher und ein entsprechend großes Transactionlog zur Verfügung steht. Die Tabelle wird kopiert und ist daher kurzfristig doppelt vorhanden. Die Umsetzung dauert dadurch auch länger. Es empfiehlt sich vor dem Ausführen der UC_UPD.TXT die Reports zu reorganisieren, damit möglichst wenig Reportdatensätze vorhanden sind. Vorgang: 1. Datenbankschema ändern und neue Initial-Daten in die Datenbank laden Server-Rechner Alle Serverprozesse müssen heruntergefahren werden! Achten Sie besonders darauf, wenn Sie Serverprozesse auf mehreren Rechnern verteilt haben! Erst dann dürfen die folgenden Schritte vorgenommen werden! Admin-Rechner Das Verzeichnis mit den Datenbank-Dateien muss sich an jenem Ort befinden, der mit dem Parameter INPUT in der INI-Datei des AE DB Load angegeben wurde. Standardmäßig ist dies der Ordner, in dem das BIN-Verzeichnis der Dienstprogramme liegt.  Beispiel für Windows: Dienstprogramme in C:\AUTOMIC\UTILITY\BIN Datenbankdateien in C:\AUTOMIC\UTILITY\DB Dienstprogramme - Windows: Die Dateien für die AE-Datenbank befinden sich in IMAGE:DB. Kopieren Sie den gesamten DB-Ordner in das oben genannte Verzeichnis. Dienstprogramme - UNIX: Die Datenbank-Dateien sind im Archiv db.tar.gz enthalten, welches im Ordner IMAGE:DB ausgeliefert wird. Entpacken Sie das Archiv mit folgenden Befehlen: gzip -d db.tar.gz bzw. gunzip db.tar.gz tar xvfo db.tar (Linux: tar -zxvf db.tar.gz) Kopieren Sie anschließend die entpackten Dateien in das dafür festgelegte Verzeichnis. Programm AE DB Load zum Upgrade der Datenbank starten. Datei <DB-Verzeichnis>\GENERAL\<vers>\UC_UPD.TXT auswählen. Es wird die gegenwärtige Datenbankversion bestimmt und die Datenbank auf den aktuellen Stand gebracht. Dabei werden sowohl die Datenbankstruktur als auch die Daten verändert. Die Objekte im Mandant 0000 werden automatisch ersetzt bzw. ergänzt. 2. Authentifizierungsmethode auswählen Admin-Rechner Das Dienstprogramm AE DB Load zeigt Ihnen eine Maske an, in der Sie eine Authentifizierungsmethode auswählen müssen. Diese Maske wird nur dann angezeigt, wenn ein Datenbank-Upgrade auf eine neue Automation Engine-Version durchgeführt wird. 3. Partitionierung mit ILM installieren (optional) Admin-Rechner Anschließend öffnet sich eine Maske, in der Sie Einstellungen für die Partitionierung mit ILM konfigurieren können. Dieser Schritt ist optional. Eine Partitionierung der Datenbank kann nicht mehr rückgängig gemacht werden!

Configure and start the Java Work Process (JWP)

• As of version 11.2 of the Automation Engine the function Export with references and the full text search in the ECC require a 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.

Start the Automation Engine and clients

Monitor the AE system

Installieren Sie die Agenten

Installieren Sie die übrigen Komponenten

Verwenden Sie die neuen Funktionen