Administratorhandbuch > Installation > Service-Pack- und Hotfix-Installation > Agent für BS2000 installieren

Agent für BS2000 installieren

In diesem Dokument finden Sie den Ablauf der Hotfix Installation für den 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.

Beenden Sie unbedingt den Agenten bevor Sie die Update-Installation beginnen!

Voraussetzungen

Der Code $UC4 existiert aus der vorigen Version.
Mit den bereits installierten Programmen BS2-TAR bzw. BS2-TOOLS (ab Version 2.00W) kann das von der Auslieferungs-CD übertragene TAR-File entpackt werden.

Ausgelieferte Dateien

Die Files sind in TAR-Files gepackt. Das jeweilige TAR-File finden Sie in einem zur BS2000-Variante passenden Unterverzeichnis von IMAGE:AGENTS\BS2000. Im Namen der Files 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.

Dateiname		Beschreibung
x.xxx.UCX2?.LIB		Programmbibliothek
	Bibliotheks-Elemente:
	UCXBB2?C	CallAPI Dienstprogramm
	UCXEB2?U	Dienstprogramm für das Konsolen-Ereignis (UCON-Anbindung)
	UCXJB2?	Agent
	UCXJB2?M	Meldeprogramm des BS2000-Agenten
	UCYBRFC?	Dienstprogramm für RFC-Task
x.xxx.UCXJB2?.INI		INI-Datei für BS2000-Agent
x.xxx.UCXEB2?U.INI		ini-Datei für das Dienstprogramm
x.xxx.UCYEBXXZ		Dienstprogramm zum Absetzen von Kommandos über eine Konsole (nur für Konsolen-Ereignis)
x.xxx.E.UCXJB2?		Muster-Enterdatei für BS2000-Agent
x.xxx.E.UCXEB2?U		Muster-Enterdatei für das Dienstprogramm
x.xxx.UCX.MSL		Meldungsbibliothek

Die Dateien des CallAPI und dessen Implementierung werden gesondert beschrieben.

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 das TAR-File 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:

Entpacken mit BS2-TAR:
/FILE UCXJB2?.TAR,LINK=TAR oder /FILE UCXJB2?NK4.TAR,LINK=TAR
/EXEC BS2-TAR
Entpacken mit BS2-TOOLS:
$UC4 anzeigen. Eingabe des Kommandos TAR in die Kommandospalte vor der TAR-Datei.

Dadurch entstehen die eigentlichen Auslieferungsfiles (mit der Versionsnummer als Präfix). Das TAR-File kann später gelöscht werden.
Existierende Dateien der Vorgängerversion (außer INI-Datei und Enter-Job) löschen oder umbenennen.
Der bereits angepasste Enter-Job ist im Normalfall nicht durch den ausgelieferten Muster-Job zu überschreiben.
Eventuell notwendige Änderungen im Job sind in der Änderungshistorie vermerkt.
Die INI-Datei ist ebenfalls nur anzupassen, falls dies in der Änderungshistorie gefordert wird.
Entfernen des Präfixes bei den Auslieferungsfiles.
Durch Namensänderungen oder ähnliches können alte Dateien "übrigbleiben". Beachten Sie dazu die Änderungshistorie.
Das File UCXJB2?M muss shareable sein und der Name inklusive Kennung mit dem Eintrag in der INI-Datei UC_EX_JOB_MD zusammenstimmen.
Die Datei UCYBRFC? muss shareable sein, wenn der RFC-Mechanismus aktiviert wird.

Admin-Rechner oderBenutzer-Rechner
Eventuell HEADER.BS2000, TRAILER.BS2000 und RESTART.BS2000 anpassen. Siehe:Job - Ausführen.

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support