Agent für Siebel installieren (Windows)

Agenten installieren

Agent für VMS installieren

---

Agent für UNIX installieren

Hier finden Sie eine Anleitung für die Neuinstallation eines UNIX Agenten.

Für jede unterstützte UNIX-Variante wurde ein dreistelliges Kürzel vergeben. Dieses kommt in allen Dateinamen des Agenten vor und ist in der Terminologie beschrieben. In diesem Dokument wird das relevante Kürzel durch die Zeichen "???" ersetzt.

Betrifft 64-Bit UNIX-Plattformen: Es wird empfohlen den 64-Bit Agenten zu installieren, wenn Sie über diesen 64-Bit Programme / Anwendungen starten wollen. Wird der 32-Bit Agent verwendet, kann es dabei zu Problemen kommen.

Die folgende Anleitung beschreibt die Installation des Agenten in einem Automation Engine System, das keine Authentifizierung einsetzt. Wenn Sie eine der Authentifizierungsmethoden nutzen möchten, sind noch zusätzliche Schritte nötig, bevor Sie den Agenten starten und einsetzen können. Lesen Sie näheres im Dokument zur Advanced Security.

Installieren Sie den Agenten unbedingt in ein eigenes Verzeichnis!

Es wird empfohlen den UNIX-Agenten mit root-Rechten zu betreiben. Ohne root-Rechte kann der Agent nicht zum Kontext eines anderen Benutzers wechseln und Dateiübertragungen müssen immer unter dem Benutzer laufen, unter dem der Agent gestartet wurde.
Berechtigen Sie den Agenten entsprechend, indem Sie diesen unter dem realen Benutzer "root" starten. Eine andere Möglichkeit besteht darin, für den Agenten das s-Bit setzen und als Eigentümer auf "root" einzutragen. Dadurch sind alle Benutzer der Gruppe, die dem Agenten zugeordnet wurde, berechtigt, diesen auch zu starten.

Voraussetzungen

• Die Benutzerkennung "AE" wurde angelegt.
• Die Verzeichnisse "out" und "temp" benötigen folgende Berechtigungen:
  
  Für owner: Schreibrecht und Ausführrecht
  Für group: Ausführrecht
  Für world: Ausführrecht

  Beachten Sie, dass Berechtigungen nicht mehr geändert werden dürfen, wenn der Agent läuft!

  Ist im Script-Sprachmittel PREP_PROCESS ein Login angegeben, wird die Ereignisdatei aus Sicherheitsgründen im HOME-Verzeichnis des Benutzers erstellt. Ist kein Login angegeben, geht das System davon aus, dass der nachfolgende Ereignis-Job mit Agenten-Rechten läuft. Daher erstellt PREP_PROCESS den Dateinamen mit dem temporären Pfad des Agenten.
  Zum Zeitpunkt der Verarbeitung von PREP_PROCESS weiß das System nicht, ob der Job ein Login verwenden wird oder nicht. Aus technischer Sicht kann dies derzeit nicht ermittelt werden, da der Ereignis-Job ein Login auch dynamisch angeben könnte (über eine PUT_ATT Script-Anweisung). Es gibt zwei mögliche Lösungen:

  1. Geben Sie einen Login in PREP_PROCESS an (sichere Lösung, von Automic empfohlen).
  2. Ordnen Sie dem Benutzer, der im Ereignis-Job festgelegt ist, Lese- und Schreibrechte auf das temporäre Verzeichnis des Agenten zu.

  Berechtigungen für die Dateien des Jobreports können Sie mit dem Parameter ReportMode= in der INI-Datei definieren.

• Wir empfehlen, das Verzeichnis "$HOME/bin" der Umgebungsvariablen PATH hinzuzufügen.

  Siehe: Arbeitsschritt 1 Entladen der TAR-Dateien und Einrichten des Systemumfeldes

  Beachten Sie unbedingt den Hinweis zu Prozessen auf AIX!

  Beachten Sie, dass auf AIX die Größe für Core-Dateien erweitert werden muss!

Ausgelieferte Dateien

Die Dateien des Agenten werden in tar-Dateien komprimiert ausgeliefert:
ucxj???.tar.gz ...Dateien des eigentlichen Agenten,
ucxb???c.tar.gz ...Dateien für die CallAPI

Die jeweilige tar-Datei finden Sie in einem zur UNIX-Variante passenden Unterverzeichnis von IMAGE:AGENTS\UNIX.

Die Dateien des CallAPI und deren Implementierung werden gesondert beschrieben.

Ablauf

	0.	Rechte der Kennung "AE"

• Host
• Sie haben die Möglichkeit, die Jobs entweder mit der Funktion "fork" oder mit dem "batch"-Kommando zu starten. Setzen Sie in der INI-Datei des Agenten den Parameter start_type= auf den entsprechenden Wert. Abhängig von dieser Einstellung gilt folgendes für den Agenten:
• Bei "fork" - Wenn der Agent unter einer Benutzerkennung gestartet wird, die root-Rechte besitzt, können die Jobs unter beliebigen Benutzerkennungen gestartet werden. Möchten Sie kein root-Recht vergeben, so müssen die Jobs unter der Benutzerkennung laufen, unter der dieser Agent gestartet worden ist.
• Bei "batch" - Der Agent muss unter einer Benutzerkennung gestartet werden, die root-Rechte besitzt.

	1.	Übertragen der tar-Datei zum Host und Einrichten des Systemumfeldes

• Host
• Anmelden unter der Benutzerkennung "AE".
• Übertragen Sie die TAR-Datei ucxj???.tar.gz mittels FTP.
• Entpacken Sie die TAR-Dateien.
  gzip -d ucxj???.tar.gz oder gunzip ucxj???.tar.gz
  tar -xvf ucxj???.tar
  (Linux: tar -zxvf ucs???.tar.gz)
  
  Die entpackten Dateien werden angezeigt. Die TAR-Datei kann nach dem Entpacken gelöscht werden.
• Achten Sie auf TAR-Meldungen und prüfen Sie, ob alle Dateien ordnungsgemäß entpackt wurden.
• Überprüfen Sie, ob alle Dateien den richtigen Owner- und Group-Eintrag besitzen. UC4 muss Owner sein. Die Gruppe muss der Kennung "AE" entsprechen. Nur ein Benutzer mit entsprechenden Rechten (z.B. root) kann diese Änderungen vornehmen.
  chown UC4 * ändert die Benutzer aller Dateien auf AE.
  chgrp Gruppenname * ändert die BenutzerGruppen aller Dateien.
• Die ini-Datei mit einem Editor, beispielsweise vi, anpassen. Sie können die ini-Datei auch am Admin-Rechner bearbeiten und danach mit FTP übertragen. Das Programm ucxj??? und die ini-Datei müssen im gleichen Verzeichnis stehen.

• Für den Echtbetrieb kann das Programm ucxj??? entsprechend privilegiert werden (muss unter einem privilegierten User, z.B. root, erfolgen).
• Eigentümer auf root ändern

  chown root ucxj???

• S-Bit setzen (Set-Userid)

  chmod 4755 ucxj???

• Admin-Rechner oderServer-Rechner
• Eventuell HEADER.UNIX, TRAILER.UNIX und RESTART.UNIX anpassen. Siehe: Job - Ausführen

	2.	Konfiguration der Authentifizierung mittels PAM (optional)

• Host

• Die Authentifizierung mittels PAM (Pluggable Authentication Modules) ist derzeit für die Agenten folgender UNIX-Plattformen unterstützt: Solaris, Linux und AIX.

1. Installation der PAM-Bibliothek
   Die PAM-Bibliothek muss auf dem System installiert sein. Dies ist abhängig von der verwendeten Plattform.
   
   
2. Konfiguration der PAM-Bibliothek
   Die Konfiguration ist abhängig von der verwendeten UNIX-Plattform, erfolgt jedoch typischerweise über die Dateien /etc/pam.d oder /etc/pam.conf.
   Der Name des Service entspricht dem Namen der ausführbaren Datei des Agenten (ucxj???).
   
   
3. Konfiguration des Agenten
   Setzen Sie in der INI-Datei des UNIX-Agenten den Parameter authentication= (Sektion [MISC]) auf den Wert "pam". Beim Parameter libname= (Sektion [PAM]) ist der Pfad und Dateiname der PAM-Bibliothek anzugeben.
   
   [MISC]
   authentication=pam
   
   [PAM]
   libname=/usr/lib/libpam32.o

	3.	Starten des Agenten

• Server-Rechner
• Automation Engine System muss laufen.
• Host
•  Falls Sie den Agenten zum Test im Dialog starten, beachten Sie bitte:

  Das Beenden mit der DEL-Taste ist ab 1.20 nur mehr möglich, wenn der entsprechende Parameter im INI-File gesetzt ist. Wir empfehlen allerdings nicht, diesen Parameter zu setzen, sondern von einem anderen Terminal aus mit kill -TERM zu beenden!

• Agenten im Hintergrund aus dem Verzeichnis "$HOME/bin" heraus starten.

  Eingabe, wenn das Verzeichnis "$HOME/bin" in der Umgebungsvariable PATH eingetragen ist:
  nohup ucxj??? 1> ucxj???.log 2>&1 &
  Eingabe, wenn das Verzeichnis "$HOME/bin" in der Umgebungsvariable PATH eingetragen ist:
  nohup ./ucxj??? 1> ucxj???.log 2>&1 &
  Ausgegebene Prozess-ID pid merken.
  Auskunft über diesen Prozess mit ps -ppid. Nicht immer vorhanden.
  Auskunft über alle UCX-Prozesse mit ps -ef | grep ucx.
  Auskunft über alle Prozesse mit ps -e.
   

• Es wird im Systemmandant 0000 ein Agenten-Objekt automatisch angelegt und im Ordner "HOST" gespeichert.
• Beim Start des Agenten wird automatisch das Backup-Verzeichnis angelegt, welches für das dateibasierte Rollback dient (verfügbar bei Jobs & FileTransfers). Der Pfad des Backup-Verzeichnisses wird mit der Agenten-Variable UC_EX_PATH_BACKUP festgelegt. Wollen Sie das dateibasierte Rollback nutzen, so benötigen die Betriebssystem-Benutzer, unter welchem die Jobs & FileTransfers dafür gestartet werden, Schreibrechte auf das Backup-Verzeichnis.
• Admin-Rechner oderServer-Rechner
• Prüfen, ob sich der Agent angemeldet hat.
  • UserInterface für Mandant 0000 starten. In der Systemübersicht die Informationen über Agenten abrufen. Da ein neu angemeldeter Agent noch keinem Mandanten zugewiesen ist, wird er nur im Mandant "0000" sichtbar. Der neu installierte Agent kann nun über das Agenten-Objekt den Mandanten mit den gewünschten Rechten zugewiesen werden.

Verwenden Sie den ServiceManager, um den Agenten zu starten bzw. zu beenden.

	4.	Agent beenden

• Host
• Agenten regulär beenden.

  kill-TERM pid

• Agenten im Notfall abbrechen. Dabei werden die Netzverbindungen nicht ordentlich geschlossen.

  kill -KILL pid oder
  kill -9 pid