Agenten installieren

Agenten installieren

Agent für Datenbanken installieren

---

Agent für BS2000 installieren

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

Da für verschiedene BS2000-Versionen ein eigener Agent notwendig ist, wurde für jede unterstützte Version ein einstelliges Kürzel vergeben. Dieses kommt in den Dateinamen des Agenten vor und ist in der Terminologie beschrieben. In diesem Dokument wird das relevante Kürzel durch das Zeichen "?" ersetzt.

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.

Voraussetzungen

• Im BS2000 muss die Kennung $UC4 mit etwa 10.000 PAM-Seiten angelegt sein.
• Das Programm BS2-TAR wurde im BS2000 installiert. Es wird benötigt, um die von der Auslieferungs-CD übertragene TAR-Datei zu entpacken.

  Diese Voraussetzung kann entfallen, wenn Sie BS2-TOOLS ab der Version 2.00W verwenden. Die Übernahme von Dateien in ein Text-Archiv und das Entpacken eines Text-Archives sind in BS2-TOOLS implementiert.

Ausgelieferte Dateien

Die Files sind in TAR-Files gepackt. Die jeweilige TAR-Datei finden Sie in einem zur BS2000-Variante passenden Unterverzeichnis von IMAGE:AGENTS\BS2000. Im Namen der Dateien ist die aktuelle Automation Engine-Version enthalten. Diese wird in der Tabelle durch die Zeichen "x.xxx" ersetzt.

Die TAR-Dateien, deren Namen "NK4" enthalten, sind für NK4-Pubsets und können ebenfalls mit dem Programm BS2-TAR entpackt werden.

Die Dateien des CallAPI und dessen Implementierung werden gesondert beschrieben.

Mögliche Probleme

• TSOS-Rechte
• K, NK
• PUBSET-Rechte (Sysout)
• BCIN für Verbindungsaufbau zum AE-Server und zu FileTransfer-Partnern
• Verwendung frei definierter Portnummern

Ablauf

	1.	Übertragen des TAR-Files zum Host

• Admin-Rechner
• Übertragen Sie die Tar-Datei UCXJB2?.TAR oder UCXJB2?NK4.TAR mittels ftp im Textmodus.
• Alternativ kann die TAR-Datei auch mit FTBS2000 oder dem EDT-FileTransfer, ebenfalls im Textmodus, ins BS2000 übertragen werden.

	2.	Entpacken der TAR-Dateien und Einrichten des Systemumfeldes

• Host
• Das TAR-File kann auf zwei Arten entpackt werden:
1. Entpacken mit BS2-TAR:

   /FILE UCXJB2?.TAR,LINK=TAR oder /FILE UCXJB2?NK4.TAR,LINK=TAR
   /EXEC BS2-TAR

2. Entpacken mit BS2-TOOLS:

   $UC4 anzeigen. Eingabe des Kommandos TAR in die Kommandospalte vor der TAR-Datei.

• Dadurch entstehen die eigentlichen Auslieferungsdateien. Die TAR-Datei kann später gelöscht werden.
• Entfernen des Präfixes bei den Auslieferungsfiles.
• INI-Datei und Enter-Job anpassen.
• Eventuell HEADER.BS2000, TRAILER.BS2000 und RESTART.BS2000 anpassen. Siehe:Job - Ausführen.

  Die Datei UCXJB2?M muss shareable sein und der Name inklusive Kennung mit dem Eintrag UC_EX_JOB_MD in der INI-Datei zusammenstimmen.

Die Datei UCYBRFC? muss shareable sein, wenn der RFC-Mechanismus aktiviert wird.

	3.	Starten des Agenten

• Server-Rechner
• Automation Engine System muss laufen.
  
• Host
• Agent unter $TSOS starten.

  Priorität und Kategorie mit sinnvollen Parametern versehen.
  Es wird im Systemmandant 0000 ein Agenten-Objekt automatisch angelegt und im Ordner HOST gespeichert.
   

• Admin-Rechner oder Server-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.

	4.	Beenden des Agenten

• Host
• Beenden des Agenten mit dem Kommando /INTR Tsn, END oder über den Task-Manager der BS2-TOOLS.