Upgrade eines AE-Systems von Version 11.1

• Verwenden Sie immer ein eigenes Verzeichnis, um die Dateien der Automation Engine-Versionen nicht zu vermischen. Abhängig vom Rechner werden Sie entweder nur eine oder mehrere Komponenten installieren. Legen Sie zuerst einen Ordner an, dessen Name die Automation Engine-Version wiederspiegelt. Erstellen Sie danach für jede Komponente einen eigenen Unterordner. Das Kapitel zur Neuinstallation enthält eine Beispielabbildung dazu.
•  Entfernen oder überschreiben Sie auf keinen Fall die Installationsverzeichnisse Ihrer Dienstprogramme! Sichern Sie die entsprechenden Ordner, damit Sie bei einem Problem rasch wieder auf die bisherige Version zurücksteigen können.
• Installieren Sie die Dienstprogramme (UNIX oder Windows).
• Kopieren Sie den Ordner namens "DB" von der CD in das Verzeichnis der Dienstprogramme. Er enthält Dateien für das Laden der AE-Datenbank. Der DB-Ordner muss sich unbedingt parallel zum BIN-Verzeichnis der Dienstprogramme befinden!

Beispiel für Windows:

Dienstprogramme in C:\AUTOMIC\UTILITY\BIN

Datenbankdateien in C:\AUTOMIC\UTILITY\DB

•  Entfernen oder überschreiben Sie auf keinen Fall die Installationsverzeichnisse Ihrer Automation Engine und des ServiceManagers! Sichern Sie die entsprechenden Ordner, damit Sie bei einem Problem rasch wieder auf die bisherige Version zurücksteigen können.
• Installieren Sie danach den Automation Engine (UNIX oder Windows) in ein neues Verzeichnis.
• Installieren Sie auch die neue Version des ServiceManagers. Verwenden Sie hierbei eine neue Bezeichnung für die ServiceManager-Umgebung (Phrase).

• Alternately, you can carry out this step after the core components have been upgraded. The function Framework Integration is not available until it has been installed.
•  Do not remove or overwrite the installation directories of your utilities. Back up the corresponding folders in order to make sure that you can quickly return to your old version if any problems occur.
• If you use a Framework Integration such as "AE Smart Plug-In for HP OpenView", Automic recommends installing it in the new Automation Engine version.  

If you didn't upgrade during the preparation process, do so now.
Details you find above under "Prepare for Upgrade > Upgrade UserInterfaces".

If you didn't upgrade during the preparation process, do so now.
Details you find above under "Prepare for Upgrade > Upgrade the Enterprise Control Center".

•  Starting with this step, your AE system is no longer available until the database has successfully been upgraded.
• Stop all clients when the upgrading time is ripe. This is easily done in the system control of client 0000.

•  Stop all server processes. If you work in a distributed Server environment, note that all server processes on all participating computers are deactivated.
•  Pay attention to programs such as Watchdogs, cluster monitoring etc. before ending the server processes. They might raise an alarm or restart the Automation Engine.  

•  Back up your AE database.
• As already described in the section on preparations, creating a database copy provides many advantages. Duplicate it now if you have opted for this step but have not yet executed it. If a database duplicate was already made at an earlier point in time, check if this duplicate must be upgraded.

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

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

• Cold-start the server processes when all installation and configuration step have successfully been completed. Do so in the INI file of the server processes by setting the parameter StartMode= to COLD. Now the processes can start.
• All clients can be started from the System Overview of client 0000.

• Do not yet replace the agents. Older agent versions run smoothly with newer Automation Engine versions.
  In order to take advantage of new features to the full make sure to upgrade agents as well.
•  Do not change anything in your processing and carefully monitor your AE system over an extended period of time. A few hours or days are not enough. It can take a while before problems occur, especially if they are the result of a particular constellation in your processing.

•  Entfernen oder überschreiben Sie auf keinen Fall die Installationsverzeichnisse Ihrer Agenten! Sichern Sie die entsprechenden Ordner, damit Sie bei einem Problem rasch wieder auf die bisherige Version zurücksteigen können.
• Die Installation der neuen Agenten muss ebenfalls jeweils in ein eigenes Verzeichnis erfolgen. Auch hier steht eine Beobachtungsphase an erster Stelle. Tauschen Sie nicht sofort alle Agenten durch die neue Version aus, sondern eine Plattform nach der anderen. Führen Sie dies zuerst auf einer Plattform wie beispielsweise UNIX durch. Nachdem die Agenten eine Zeit lang stabil gelaufen sind, können Sie andere Plattformen auf dieselbe Weise nach und nach austauschen.
• Ab Version 9 werden die Dateien des UNIX-Agenten in Kleinschreibung ausgeliefert! Damit sichergestellt wird, dass Jobs auch den neuen Jobmelder aufrufen, sollten beim Update folgende Schritte durchgeführt werden:
  1) Empfohlen: Beim Upgrade des Agenten den Dateinamen des Jobmelder in der INI-Datei korrigieren (Variable UC_EX_JOB_MD).
  2) Wichtiger Hinweis: Wird der neue Agent in dasselbe Verzeichnis wie der alte installiert, ist der alte Jobmelder unbedingt nach der Installation zu löschen.
  3) Falls Sie die INI-Datei im Zuge des Updates nicht anpassen wollen, können Sie auch einen Link (mit dem alten Meldernamen in Großbuchstaben) erstellen, welcher auf den neuen Melder zeigt.
  Beispiel für Linux: ln -s ucxjli3m UCXJLI3M

•  Entfernen oder überschreiben Sie auf keinen Fall die Installationsverzeichnisse Ihrer restlichen Komponenten! Sichern Sie die entsprechenden Ordner, damit Sie bei einem Problem rasch wieder auf die bisherige Version zurücksteigen können.
• Jetzt können Sie die restlichen Komponenten wie z. B. CallAPIs austauschen. Halten Sie auch hier eine Beobachtungsphase ein.

•  Beobachten Sie Ihr aktualisiertes Automation Engine System eine Zeit lang! Treten keine Probleme auf, ist der Upgradevorgang soweit beendet.
• Jetzt können Sie das Upgrade auch in Ihrem Produktivsystem vornehmen. Gehen Sie dabei dieselben Schritte wie bei der Aktualisierung des Testsystems durch. Hinsichtlich der Erfahrungen, die Sie bisher gesammelt haben, sind Sie optimal auf das Upgrade Ihres Produktivsystems vorbereitet.
• Nehmen Sie nach dem Upgrade Ihres Produktivsystems nochmals die Release Notes der neuen Automation Engine-Version zur Hand. Die Auflistung enthält alle Neuerungen. Nutzen Sie die Funktionalitäten und erweitern Sie damit Ihre Verarbeitung. Für Fragen und Anregungen steht Ihnen der Automic-Support zur Verfügung.
• Viel Freude beim Einsatz Ihrer neuen Automation Engine-Version!