Update eines Automation Engine Systems - Details

Hier finden Sie die einzelnen Schritte für die Vorbereitung und Durchführung eines Automation Engine System-Updates.

Vorbereitungen

Vor dem eigentlichen Update sind folgende Vorbereitungen zu treffen:

	1.	Lesen der Release Notes

• Lesen Sie zuerst die Release Notes der Automation Engine-Version auf, die Sie updaten wollen. Sie befinden sich im Kapitel "Änderungshistorie" der Automation Engine-Dokumentation.
•  Der Abschnitt "Hinweise zur Update-Installation" ist besonders wichtig! Er enthält Informationen zu Inkompatibilitäten und weist auf zusätzliche Arbeitsschritte hin, die während oder sogar vor der Update-Installation zu berücksichtigen sind. Bereiten Sie Ihr Automation Engine System und Ihre Systemumgebung entsprechend vor.

	2.	Letzte Veränderungen in der Verarbeitung

•  Während der gesamten Update-Phase, dürfen keine Veränderungen in der Verarbeitung stattfinden. Stoßen Sie bei einem Schritt auf Probleme in Ihrer Systemumgebung, so können Sie die Datenbank zurücksichern bzw. direkt verwenden, wenn Sie ein Duplikat erstellen. Die Gefährdung Ihrer Verarbeitung ist dadurch minimal. Beachten Sie hierbei, dass Statistiken, Reports, insbesondere Änderungen an Objekten sowie Variablen- und Sync-Inhalte verloren gehen.
• Informieren Sie alle betroffenen Personen über den Update-Prozess und stellen Sie sicher, dass die Verarbeitung ab jetzt unverändert bleibt.

Erstellen Sie eine BenutzerGruppe, die explizit alles verbietet, und weisen Sie alle Benutzer dieser Gruppe zu. Falls Sie in Ihrem Automation Engine System den Revisionsreport aktiviert haben, müssen Sie die Gruppenmitgliedschaft direkt im Benutzer-Objekt vornehmen, da die Registerkarte im BenutzerGruppen-Objekt in diesem Fall gesperrt ist.

	3.	Zeitpunkt für das Update der Kernkomponenten vorbereiten

• Wählen Sie einen Zeitpunkt für das Update der Kernkomponenten aus. Beachten Sie, dass der Automation Engine-Server kurzzeitig abgeschalten werden muss. Ihre Verarbeitung wird dadurch unterbrochen! Entscheiden Sie sich aus diesem Grund für einen Zeitpunkt an dem möglichst wenig Aktivitäten laufen. Die Dauer des Updates hängt vom Umfang des Automation Engine Systems ab. Ihre Erfahrungen beim Update des Testsystems geben Richtwerte für das benötigte Zeitfenster beim Aktualisieren des Produktivsystems.
• Legen Sie die Telefonnummer und E-Mail-Adresse des Automic-Supports sowie die Anmeldedaten zur Automic Customer Support-Zone bereit. Erwägen Sie auch vorübergehend 24x7 Support anzufordern, wenn das Update sensible Systeme betrifft oder außerhalb der Öffnungszeiten unseres Automic-Supports liegt.
• Unsere Consultants stehen Ihnen zur Verfügung, wenn Sie vor Ort Unterstützung beim Update Ihres Automation Engine Systems benötigen. Wenden Sie sich direkt an Ihren Account Manager oder unseren Automic-Support. Ihre Anfrage wird weitergeleitet, um einen Termin festzusetzen.
• Weiters benötigen Sie während des Update-Zeitfensters Zugang auf die Datenbank sowie auf alle Rechner mit AE-Kernkomponenten (Automation Engine, Dienstprogramme, usw.). Bei einer verteilten Serverumgebung brauchen Sie Zugang zu allen beteiligten Rechnern! Stellen Sie sicher, dass die Administratoren verfügbar und die Anmeldedaten wie z.B. Passwörter korrekt sind.
• Die UserInterfaces können auch schon im nächsten Schritt aktualisiert werden. Wird dies erst beim Update der Kernkomponenten durchgeführt, so brauchen Sie Zugang zu den entsprechenen Rechnern.

	4.	Update der UserInterfaces

• Der Einsatz von UserInterfaces in einem Automation Engine System der Vorgängerversion wird nur als eine kurzfristige Übergangslösung (einige Tage) im Rahmen des Umstiegs empfohlen. UserInterfaces können ab 9.00A in der jeweiligen Vorgängerversion eingesetzt werden. Beispiel: Ein 9.00A UserInterface kann sich auch an das neueste 8.00A Automation Engine System anmelden. Voraussetzung dafür ist, dass sich Ihr Automation Engine System auf dem aktuellsten Hotfix-Stand befindet. Wir weisen jedoch ausdrücklich darauf hin, dass das UserInterface nicht vollständig abwärtskompatibel ist. Einschränkungen in den Funktionen sind immer gegeben.
•  Änderungen in der Oberfläche des UserInterfaces werden erst dann sichtbar, wenn die Kernkomponenten auf die neue Version aktualisiert worden sind.
•  Ältere UserInterfaces können nicht mit Automation Engine Systemen einer neueren Version in Betrieb genommen werden! Deshalb müssen Sie jene spätestens beim Update der Kernkomponenten aktualisieren.
•  Beachten Sie, dass dies NICHT für Agenten gilt! Hier verhält es sich umgekehrt. Neuere Agent-Versionen können nicht in älteren Automation Engine Systemen eingesetzt werden. Allerdings laufen ältere Agent-Versionen auch in der Nachfolgerversion von Automation Engine, d.h. ein 8.00A Agent kann auch in einem 9.00A Automation Engine System eingesetzt werden. Voraussetzung dafür ist, dass sich Ihr Automation Engine System auf dem aktuellsten Hotfix-Stand befindet.

	5.	Wartung der Datenbank

• Wir gehen davon aus, dass Sie Ihre Datenbank sowohl mit unseren Dienstprogrammen als auch mit datenbankspezifischen Tools regelmäßig reorganisieren. Führen Sie vor dem Update der Datenbank noch einmal einen Wartungslauf durch. Je kleiner die Datenbank, desto schneller erfolgt deren Aktualisierung auf die neue Automation Engine-Version.
• Lesen Sie unsere Skripts für die Datenbank sorgfältig durch, um eventuelle Anpassungen wie z.B. Tablespaces vorzubereiten. So sehen Sie auch welche Aktionen vorgenommen werden und können entsprechende Maßnahmen sowohl an der Datenbank als auch dem Rechner auf dem sie läuft vornehmen (z.B. Bereitstellung von Plattenplatz).

Die Skripts befinden sich in den Verzeichnissen IMAGE:DB\GENERAL\<Version> und IMAGE:DB\<Datenbank-Typ>\<Version>. Die Dateien uc_upd.txt und chngdb.sql sind hierbei besonders wichtig!

	6.	Duplizieren der Datenbank

• Bei unternehmenskritischen Verarbeitungen im Automation Engine System empfiehlt sich zusätzlich zu einem Backup das Duplizieren der Datenbank.  Auf diese Weise können Sie eine der beiden Datenbanken unverändert lassen und so ist es Ihnen jederzeit und rasch möglich wieder auf Ihre alte Datenbank zurückzugreifen wenn Probleme in Ihrer Systemumgebung auftreten.
• Das Duplizieren der Datenbank kann auf mehrere Arten erfolgen. Sie können jene beispielsweise im Offline-Modus duplizieren. Für kleinere Datenbanken bietet sich diese Methode an, da sie während des Updates der Kernkomponenten durchführbar ist. Hier steht das Automation Engine System ohnehin nicht zur Verfügung. Das Duplizieren von umfangreichen Datenbanken hingegen kann schon vor dem Update der Kernkomponenten im Online-Modus erfolgen. Sprechen Sie sich aber unbedingt mit Ihrer Datenbank-Administrationsgruppe ab, da die aktuellen Logdateien beim Updatezeitpunkt in die duplizierte Datenbank eingespielt werden müssen!

Update der Kernkomponenten

In dieser Phase werden die Kernkomponenten aktualisiert. Ihr Automation Engine System steht während des Updates der Datenbank nicht zur Verfügung!

	1.	Installieren der Dienstprogramme

• 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

	2.	Installation der Automation Engine und des ServiceManagers

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

	3.	Installation der Framework-Integration (optional)

• Dieser Schritt kann auch nach dem Update der Kernkomponenten erfolgen. Die Funktionalität der Framework-Integration steht bis dahin jedoch nicht zur Verfügung!
•  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.
• Wenn Sie eine Framework-Integration wie z.B. "AE Smart Plug-In for HP OpenView" nutzen, sollten Sie diese in der neuen Automation Engine-Version installieren.  

	4.	Update der UserInterfaces (sofern nicht bereits durchgeführt)

•  Entfernen oder überschreiben Sie auf keinen Fall die Installationsverzeichnisse Ihrer UserInterfaces! Sichern Sie die entsprechenden Ordner, damit Sie bei einem Problem rasch wieder auf die bisherige Version zurücksteigen können.
• Spätestens jetzt muss zumindest ein UserInterface auf die neue Automation Engine-Version aktualisiert werden. Verwenden Sie auch hier jeweils ein eigenes Verzeichnis. Ältere UserInterfaces können sich nach dem Update der Kernkomponenten nicht mehr anmelden.

	5.	Stoppen aller Mandanten

•  Ab diesem Schritt steht Ihr Automation Engine System bis zum erfolgreichen Update der Datenbank nicht zur Verfügung!
• Stoppen Sie alle Mandanten, wenn der Update-Zeitpunkt gekommen ist. Dies geht bequem in der Systemsteuerung des Mandanten 0000.

	6.	Stoppen der Automation Engine

•  Stoppen Sie alle Serverprozesse. Bei einer verteilten Serverumgebung müssen Sie darauf achten auch wirklich auf allen beteiligten Rechnern die Serverprozesse zu deaktivieren!
•  Achten Sie vor dem Beenden der Serverprozesse auf Programme wie z.B: Watchdogs, Clusterüberwachungen etc. Sie erzeugen sonst Alarme oder starten den Automation Engine erneut.  

	7.	Sichern der Datenbank

•  Sichern Sie unbedingt die Datenbank!
• Wie in den Vorbereitungen bereits erwähnt hat die Erstellung eines Datenbankduplikats viele Vorteile. Nehmen Sie das als nächstes in Angriff sofern Sie sich für diese Vorsichtsmaßnahme entschieden, sie aber noch nicht durchgeführt haben. Wurde bereits zu einem früheren Zeitpunkt ein Datenbankduplikat erstellt, so sollten Sie es gegebenenfalls auf den letzten Stand bringen.

	8.	Update der Datenbank

• Lesen Sie vor dem Datenbank-Update unbedingt die Hinweise betreffend Datenbankänderungen im Zuge der Automation Engine-Versionen.
• Aktualisieren Sie Ihre Datenbank mit dem AE DB Load. Die Anleitung dazu finden Sie im Kapitel Hotfix-Installation.
• Haben Sie ein Duplikat erstellt, sollten Sie die Aktualisierung hier durchführen, um sicherzugehen, dass die ursprüngliche Instanz funktionstüchtig bleibt. Achten Sie darauf in den INI-Dateien der Dienstprogramme die korrekte Datenbankverbindung einzutragen.
• Beim Update auf Version 8.00A werden die Statistiken und Reports (Datenbank-Tabelle RT/RH) speziell umgesetzt. Da es sich dabei um ein große Datenmenge handelt, kann dieser Prozess sehr lange dauern (mehrere Stunden). Um das System nicht so lange herunterfahren zu müssen, können Sie diesen Prozess überspringen und anschließend durchführen. Die ausführliche Anleitung dazu finden Sie in dem Dokument: Reports nach einem Update auf 8.00A umsetzen 

	9.	Automation Engine und Mandanten starten

• Sind alle Installations- und Konfigurationsschritte abgeschlossen, können die Serverprozesse mit einem Kaltstart hochgefahren werden. Setzen Sie dazu in der INI-Datei Ihrer Serverprozesse UCSRV.INI den Parameter StartMode=COLD. Anschließend kann deren Start erfolgen.
• In der Systemübersicht des Mandanten 0000 lassen sich alle Mandent wieder starten.

	10.	Überwachung des Automation Engine Systems

• Tauschen Sie vorerst die Agenten nicht aus. Ältere Agenten laufen auch reibungslos mit einer neueren Automation Engine-Version.
•  Ändern Sie, wie zuvor erwähnt, nichts an Ihrer Verarbeitung und beobachten Sie Ihr Automation Engine System gründlich über einen längeren Zeitraum hinweg! Einige Tage oder gar nur einige Stunden sind hierbei zu wenig! Probleme können auch erst nach einiger Zeit auftreten, wenn sie beispielsweise von einer bestimmten Konstellation in Ihrer Verarbeitung herrühren.

Update aller anderen Komponenten

Nach dem Update der Kernkomponenten können Sie die anderen AE-Programme schrittweise aktualisieren.

	1.	Installation der Agenten

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

	2.	Installation der restlichen Komponenten

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

	3.	Nutzung der neuen Funktionalitäten

•  Beobachten Sie Ihr aktualisiertes Automation Engine System eine Zeit lang! Treten keine Probleme auf, ist der Updatevorgang soweit beendet.
• Jetzt können Sie das Update 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 Update Ihres Produktivsystems vorbereitet.
• Nehmen Sie nach dem Update 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!

Siehe auch:

Update eines Automation Engine Systems - Übersicht