Installation von AE - UNIX

Die folgenden Schritte helfen Ihnen bei der Installation der Automation Engine auf UNIX.

Hinweise:

Die Automation Engine für UNIX ist für verschiedene Plattformen verfügbar; für jede unterstützte UNIX-Plattform wird ein dreistelliger Code geliefert. Die Codes sind die gleichen wie bei Agenten. In diesem Dokument wird der spezifische Code durch das Zeichen "???" ersetzt. Dieses Dokument beschreibt die Installation der Automation Engine für Oracle und DB2 Datenbanken. Spezifische Unterschiede werden in den einzelnen Verarbeitungsschritten beschrieben. MS SQL Server wird nicht unterstützt.
Am besten installieren Sie die Automation Engine in einem separaten Verzeichnis (z. B. /opt/automic/server).
Die Standardbibliotheken (libstdc++.so und libgcc_s.so) gehören nicht mehr zum TAR-Ball von AE. Dafür befinden sie sich im Automic Automation-Angebot unter External.Resources/unix_libraries/unix_libraries.tar.gz. Stellen Sie sicher, dass diese Bibliotheken verfügbar sind, damit AE sie verwenden kann. Entpacken Sie dazu zunächst die TAR-Datei der Komponenten (Agent, Service Manager, Dienstprogramme usw.). Entpacken Sie anschließend die TAR-Datei der Bibliotheken, und kopieren Sie die für Ihr Betriebssystem relevanten Dateien in den Ordner bin der Komponente. Erstellen Sie zusätzlich mithilfe des Befehls ln -s ./libstdc++.so.6 symbolische Verknüpfungen für die Bibliotheken im Ordner bin.

Diese Seite beinhaltet Folgendes:

Voraussetzungen

Informationssicherheitsdienste, wie die TLS/SSL-Implementierung des ServiceManagers, erfordern Funktionen, die vom CAPKI-Paket bereitgestellt werden. Sie müssen CAPKI auf allen Computern installieren, auf denen die Automation Engine-Server-Prozesse oder der ServiceManager und alle seine Clients laufen. Weitere Informationen finden Sie unter CAPKI - Sicherung des ServiceManagers, Serverprozesse und ServiceManager.
OpenSSL muss installiert sein. Verwenden Sie die compatibility matrix um die relevanten Informationen zu unterstützten Versionen zu finden.
Nach der Installation ist ein Neustart des UNIX-Systems NICHT erforderlich.
Eigene UNIX-Benutzer-ID für die Automation Engine (Standard: uc4, Home = /opt/uc4).
Für Solaris: Der aktuellste Patch-Cluster für Sun OS wurde installiert.

Befolgen Sie unbedingt den Hinweis, der Prozesse auf AIX beschreibt. Weitere Informationen finden Sie unter Abbruch von AIX-Prozessen bei Speichermangel.
Stellen Sie für AIX 64-Bit sicher, dass Sie die Systembibliotheken IBM XL C++ Runtime, V16.1 (libc++, xlC, xlC.aix61) mit/auf mindestens 16.1.0 Fix Pack 6 installiert/aktualisiert haben; andernfalls funktioniert AIX nicht. Detaillierte Informationen zur Installation/zum Upgrade des Pakets finden Sie in der offiziellen Dokumentation zu den C- und C++-Compilern von IBM.

Mit dem Befehl lslpp -L libc++.rte xlC.rte xlC.aix61.rte können Sie prüfen, welche Versionen Sie gegebenenfalls installiert haben.

Bei Verwendung einer Oracle-Datenbank

Funktionierende Oracle-Installation (Zugriff auf die Datenbank muss möglich sein)
Benutzer-ID für die Oracle-Datenbank

Bei Verwendung einer DB2-Datenbank

Funktionierende DB2-Installation
Benutzer-ID für die DB2-Datenbank
Berechtigungen überprüfen oder zuweisen:
Öffnen Sie das Control Center, und wählen Sie den richtigen Host aus. Wählen Sie die Datenbank für AE aus, und wählen Sie Benutzer- und Gruppenobjekte aus. Wenn Sie Benutzer auswählen, werden alle Benutzer im rechten Fenster angezeigt. Öffnen Sie über das Kontextmenü das Berechtigungsfenster des gewünschten Benutzers.
Mindestens die folgenden Optionen sollten auf der Registerkarte Datenbank aktiviert sein:

Datenbank verbinden
Tabellen erstellen
Packages erstellen
Schemas implizit erstellen.

Die LANG-Variable des Benutzers, der die Automation Engine startet, sollte identisch mit der Variable DB2CODEPAGE sein, um Probleme beim Serverstart zu vermeiden.

AE installieren

Oracle-Datenbanken

Anmelden als AE.
Erstellen Sie ein neues Verzeichnis: /opt/automic/server.
Übertragen Sie die Datei ucs???.tar.gz von /cdrom/cdrom0/<version>/AutomationEngine/unix/<Plattform> mit FTP (binär) in das erstellte Verzeichnis.
Entpacken Sie die tar-Datei mit einem der folgenden Befehle:gzip -d ucs???.tar.gz
gunzip ucs???.tar.gz tar xvf ucs???.tar
Stellen Sie die Umgebungsvariablen in $HOME/.profile ein, wenn die Automation Engine nicht auf demselben Computer wie die Dienstprogramme ausgeführt wird. Weitere Informationen finden Sie unter Installation der Dienstprogramme - UNIX.
Benennen Sie die Datei ucsrv.ori.ini in ucsrv.ini um:mv ucsrv.ori.ini ucsrv.ini
Passen Sie die INI-Datei der Automation Engine an Ihre Systemumgebung an, siehe Automation Engine. Die folgende Liste zeigt die Einträge der INI-Datei, die in jedem Fall angepasst werden müssen. Alle anderen Parameter können nach Bedarf konfiguriert werden.

Name des AE-Systems (system=)
Aktivieren Sie die SNMP-Verbindung (snmp=), falls verwendet.
Port-Nummer des primären Arbeitsprozesses (pwpport =)
Ab Version 12.3 hat sich die Zuweisung von Prozessnummern geändert, siehe Serverprozesstypen.
Verbindung zur Datenbank (SQLDRIVERCONNECT= )

Entfernen Sie das AE IMAGE:
umount /cdrom oder eject cdrom
Überprüfen Sie die Bibliotheken:
- AIX:
  1. Überprüfen Sie die Oracle-Bibliothek libclntst*.a.
  2. Bibliotheksprüfung:
    dump -X64 -H ucsrvcp > wk.txt (geben Sie ein Leerzeichen hinter "dump" ein).
  3. Öffnen Sie die erstellte Datei mit einem Text-Editor (sed oder vi). Vergewissern Sie sich, dass alle Bibliotheken gefunden wurden.
  4. Wiederholen Sie den obigen Vorgang mit ucuoci.a und ucsrvwp. Es können einige fehlende Einträge gemeldet werden, die sich auf die Datei ucuoci.a beziehen, da es sich um eine Bibliothek statt um ein Hauptprogramm handelt. Wenn sich diese Meldungen auf die Bibliotheken ucuoci.a, libzu00132.a und libucudb32.a beziehen, können sie ignoriert werden. Wenn ein Eintrag in einer anderen Bibliothek (z. B. Oracle) nicht gefunden werden kann, ist dies ein Fehler.
- Linux, Solaris und zLinux:
  1. Überprüfen Sie die Oracle-Bibliothek libclntsh.so.*.0.
  2. Bibliotheksprüfung:
    ldd -r ucsrvcp > wk.txt
    Für ldd kann die Option -s statt -r verwendet werden.
  3. Öffnen Sie diese Datei mit einem Text-Editor (sed oder vi). Vergewissern Sie sich, dass alle Bibliotheken gefunden wurden.
  4. Wiederholen Sie den obigen Vorgang mit ucuoci.so und ucsrvwp. Es können einige fehlende Einträge gemeldet werden, die sich auf die Datei ucuoci.so beziehen, da es sich um eine Bibliothek handelt. Wenn sich diese Meldungen auf die Bibliotheken ucuoci.so, libzu00132.so oder libucudb32.so beziehen, können sie ignoriert werden. Wenn ein Eintrag in einer anderen Bibliothek (z. B. Oracle) nicht gefunden werden kann, ist dies ein Fehler.
  Weitere Informationen finden Sie unter Die AE-Datenbank vorbereiten - Oracle).

DB2-Datenbanken

Als "AE" anmelden.
Erstellen Sie ein neues Verzeichnis: /opt/automic/server.
Übertragen Sie die Datei ucs???.tar.gz von /cdrom/cdrom0/<version>/AutomationEngine/unix/<Plattform> mit FTP (binär) in das erstellte Verzeichnis.
Entpacken Sie die übertragene TAR-Datei:
gzip -d ucs???.tar.gz
gunzip ucs???.tar.gz
tar xvf ucs???.tar
Setzen Sie die Umgebungsvariablen in $HOME/.profile, wenn die Automation Engine nicht auf dem gleichen Computer wie die Dienstprogramme ausgeführt wird. Weitere Informationen finden Sie unter Installation der Dienstprogramme - UNIX.
Benennen Sie die Datei ucsrv.ori.ini in ucsrv.ini um:
mv ucsrv.ori.ini ucsrv.ini
Passen Sie die INI-Datei der Automation Engine an Ihre Systemumgebung an. Die folgende Liste zeigt die Einträge der INI-Datei, die in jedem Fall angepasst werden müssen. Alle anderen Parameter können nach Bedarf konfiguriert werden. Weitere Informationen finden Sie unter Automation Engine.

Name des AE-Systems (system=)
Aktivieren Sie die SNMP-Verbindung (snmp=), falls verwendet.
Portnummer des primären Arbeitsprozesses (pwpport= )
Zuordnung von Kommunikationsprozessen und Portnummern (cp1= .... cpn= )
Zuordnung von Arbeitsprozessen und Portnummern (wp1= .... wpn= )
Verbindung zur Datenbank (SQLDRIVERCONNECT= )

Entfernen Sie das AE IMAGE:
umount /cdrom oder eject cdrom
Überprüfen Sie die Bibliotheken:
- AIX:
  1. AE verwendet $DB2DIR/lib/libdb2.a.
  2. Bibliotheksprüfung:
    dump -H ucsrvcp > wk.txt
  3. Öffnen Sie die erstellte Datei mit einem Text-Editor (sed oder vi). Vergewissern Sie sich, dass alle Bibliotheken gefunden wurden.
  4. Wiederholen Sie den obigen Vorgang mit ucucli.so und ucsrvwp. Es können einige fehlende Einträge gemeldet werden, die sich auf die Datei ucucli.so beziehen, da es sich um eine Bibliothek statt um ein Hauptprogramm handelt. Wenn sich diese Meldungen auf die Bibliotheken ucucli.a, libzu00132.a oder libucudb32.a beziehen, können sie ignoriert werden. Wenn ein Eintrag in einer anderen Bibliothek (z. B. DB2) nicht gefunden werden kann, ist dies ein Fehler.
- Linux, Solaris und zLinux:
  1. AE verwendet $DB2DIR/lib/libdb2.so.
  2. Bibliotheksprüfung:
    ldd -r ucsrvcp > wk.txt
    Für ldd kann die Option -s statt -r verwendet werden.
  3. Öffnen Sie die erstellte Datei mit einem Text-Editor (sed oder vi). Vergewissern Sie sich, dass alle Bibliotheken gefunden wurden.
  4. Wiederholen Sie den obigen Vorgang mit ucucli.so und ucsrvwp. Es können einige fehlende Einträge gemeldet werden, die sich auf die Datei ucuoci.so beziehen, da es sich um eine Bibliothek statt um ein Hauptprogramm handelt. Wenn sich diese Nachrichten auf die Bibliotheken ucucli.so, libzu00132.so oder libucudb32.so beziehen, können sie ignoriert werden. Wenn ein Eintrag in einer anderen Bibliothek (z. B. DB2) nicht gefunden werden kann, ist dies ein Fehler.

Installieren des AE SNMP-Subagenten (optional)

(Server-Computer). Möglicherweise möchten Sie den AE SNMP-Subagenten installieren, um die verschiedenen Bedingungen zu überwachen, die innerhalb eines AE-Systems auftreten (z. B. Verfügbarkeit der Automation Engine und Agenten, aktive Benachrichtigungen oder Blockierungsaufgaben). Weitere Informationen finden Sie unter Automation Engine-SNMP-Subagenten installieren (UNIX).

Starten der Automation Engine

Starten Sie die Automation Engine für einen Test manuell. (Server-Computer).

Melden Sie sich mit der AE-Benutzer-ID an.
Wechseln Sie in das Installationsverzeichnis des ausführbaren Programms:
cd $UC4/bin
Starten Sie den Kommunikationsprozess im Hintergrund:
./ucsrvcp &
Starten Sie den Arbeitsprozess im Hintergrund:
./ucsrvwp &
Überprüfen Sie, ob die Automation Engine läuft:
ps -ef|grep ucsrv oder ps -fu uc4
Es sollte nun möglich sein, sich in der aktiven Automation Engine mit einem AWI anzumelden. Die relevanten Informationen über aktive Automation Engine sind in der Administration-Perspektive verfügbar.

Herunterfahren von Automation Engine

(Server-Computer). Verwenden Sie den ServiceManager , um Serverprozesse zu starten und zu beenden. Weitere Informationen finden Sie unter ServiceManager und Startparameter - ServiceManager.

Herunterfahren

Finden Sie die Prozess-ID pid:ps -ef|grep ucsrv
Beenden eines Serverprozesses:kill -TERM pid

Abbrechen

Finden Sie die Prozess-ID pid:
Beenden Sie einen Serverprozess:kill -KILL pid

Mögliche Probleme

Beim Programmstart:

Automation Engine endet beim Start:
Aktivieren Sie Traces (die Datenbank-Trace ist die wichtigste).

Fehlende Bibliotheken oder andere Fehler finden Sie am schnellsten, indem Sie die Automation Engine wie folgt starten:
truss 2>truss.out -f ucsrvcp
Die resultierende Datei, truss.out, enthält alle Systemaufrufe der Automation Engine und alle Versuche, gemeinsam genutzte Objekte zu laden.

Wenn eine Bibliothek fehlt, kann das Problem sein, dass sie im System vorhanden ist, ihr Pfad aber nicht in der Umgebungsvariablen (LIBPATH, SHLIB_PATH oder LD_LIBRARY_PATH) angegeben wurde. Suchen Sie die Bibliothek als "root" mit:
find / -name 'Bibliothek' -print
(Platzhalterzeichen sind erlaubt).
Fügen Sie den gefundenen Pfad zur Umgebungsvariablen hinzu. Wenn die Bibliothek nicht gefunden wird, wurde sie nicht auf diesem System installiert oder gelöscht. Durchsuchen Sie die Bibliothek, um zu prüfen, ob sie verfügbar ist:
AIX, Linux, Solaris und zLinux: /var/sadm/install/contents

Wenn es hier nicht gefunden werden kann, wurde es gelöscht. Die Namen der Packages, in denen die Bibliotheken verfügbar sind, finden Sie am Ende der entsprechenden Zeilen. Die beste Lösung ist in diesem Fall, das Package erneut zu installieren.
Automation Engine hängt.
Verwenden Sie truss -f -p pid 2>&1 | tee - a truss.out
, um die Systemaufrufe eines laufenden Prozesses zu verfolgen. "tee" kennzeichnet die verfügbare Ausgabe auf dem Bildschirm und in der Datei truss.out.
Entfernen Sie <CR> (^M) aus den Textdateien:
vi Text file
%s/<Ctrl-V><Ctrl-M>$//g
:wq!

Nächster Schritt:

Installation des ServiceManagers (empfohlen)
Einrichten einer verteilten Serverumgebung wenn Sie mehr als einen Server verwenden
Installation des JWP