Agent für VMS installieren

Agenten installieren

Agent für z/OS installieren

---

Agent für Windows installieren

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

Der Windows-Agent wird sowohl für 32-Bit als auch 64-Bit unterstützt. Zur Unterscheidung wurden die dreistelligen Kürzel vergeben. Sie kommen in allen Dateinamen des Agenten vor und sind auch in der Terminologie beschrieben. In diesem Dokument wird das relevante Kürzel durch die Zeichen "???" ersetzt.

Betrifft 64-Bit Windows-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 (z.B: C:\AUTOMIC\AGENTS\WINDOWS).

Ausgelieferte Dateien

Die Dateien des Windows-Agenten finden Sie im Verzeichnis IMAGE:AGENTS\WINDOWS.

Weitere Dateien aus diesem Unterverzeichnis sind Bestandteil des Installationsprogramms und des AE-Laufzeitsystems. Siehe: Knowledge Base.

Die Dateien des CallAPI und dessen Implementierung werden gesondert beschrieben.

Mögliche Probleme

• Groß- und Kleinschreibung bei Host-Name
• IP-Adresse mit führenden Nullen.

Windows-Agent für systemweite E-Mail-Kopplung

Über einen Windows-Agenten kann die systemweite E-Mail-Kopplung von AE realisiert werden. Detaillierte Informationen zum Einrichten der E-Mail-Kopplung finden Sie in der Knowledge Base.

Ablauf

	1.	Microsoft Visual C++ 2010 Redistributable Package installieren

Ist das Package bereits in der erforderlichen Version vorhanden, kann dieser Installationsschritt entfallen. Ob und in welcher Version es vorhanden ist, sehen Sie in der Systemsteuerung -> Software.

• Host (32-Bit)
• Das Package aus dem Verzeichnis IMAGE:CRTS\WINDOWS\X86 installieren.

• Host (64-Bit)
• Das Package aus dem Verzeichnis IMAGE:CRTS\WINDOWS\X64 bzw. IMAGE:CRTS\WINDOWS\IA64 installieren.

	2.	Installieren des Agenten

• Host (32-Bit)
• Starten Sie das Programms SETUP.EXE im Verzeichnis IMAGE:AGENTS\WINDOWS\X86.
• Wählen Sie für den Agenten ein eigenes Verzeichnis aus (z.B: C:\AUTOMIC\AGENTS\WINDOWS). Die Installation startet sobald Sie auf den großen Button (Computer, Verpackung und Diskette) klicken.
• Die AE-Programmgruppe wird automatisch angelegt bzw. der Agent eingetragen.

• Host (64-Bit)
• Starten Sie das Programms SETUP.EXE im Verzeichnis IMAGE:AGENTS\WINDOWS\X64 bzw. IMAGE:AGENTS\WINDOWS\IA64.
• Wählen Sie für den Agenten ein eigenes Verzeichnis aus (z.B: C:\AUTOMIC\AGENTS\WINDOWS). Die Installation startet sobald Sie auf den großen Button (Computer, Verpackung und Diskette) klicken.
• Die AE-Programmgruppe wird automatisch angelegt bzw. der Agent eingetragen.

	3.	Einrichten des Systemumfeldes

• Host
• Anpassen der INI-Datei UCXJ???.INI an die Systemumgebung.
• Wenn Sie in der INI-Datei den Parameter logon= auf den Wert "1" gesetzt haben, benötigt der Benutzer mit dem der Agent gestartet wird folgende Rechte:
   
• Einsetzen als Teil des Betriebssystems
• Anpassen von Speicherkontingenten für einen Prozess
• Lokale Anmeldung zulassen
• Dateien und Ordner sichern **)
• Anmelden als Batchauftrag *)
• Als Dienst anmelden
• Ersetzen eines Tokens auf Prozessebene
• Wiederherstellen von Dateien und Verzeichnissen

*) Dieses Recht ist nur dann notwendig, wenn Jobs mit der Startoption "Anmeldung als Batch-Benutzer" gestartet werden.

**) Dieses Recht ist für das Ausführen von Job-Objekten erforderlich.
Beim Job-Objekt FileTransfer ist dieses Recht im Allgemeinen optional. Es wird allerdings benötigt, um die Übertragung verschlüsselter Dateien mit dem erweiterten FileTransfer (seit Version 9) zu ermöglichen, da der Agent die WinAPI "LoadUserProfile" nutzt.

In Windows rufen Sie dafür die Lokale Sicherheitsrichtlinie über Systemsteuerung -> Verwaltung auf. Die Rechte werden in "Lokale Richtlinien" unter "Zuweisen von Benutzerrechten" definiert.

Alle Windows-Benutzer, die Jobs mit dem Typ "BAT" ausführen sollen, benötigen das Recht "Lesen & Ausführen" auf das "bin"- und "temp"-Verzeichnis des Agenten. Ansonsten kommt es beim Starten des Jobs zu einer Fehlermeldung (Zugriff verweigert). Dies ist nur notwendig, wenn in der INI-Datei des Agenten der Parameter LOGON=1 oder in der UC_HOSTCHAR_* die Einstellung ANONYMOUS_JOB auf den Wert "N" gesetzt ist.

	4.	Starten des Agenten

• Server-Rechner
• Automation Engine System muss laufen.
• Host
• Starten des Agenten aus der AE-Programmgruppe.
  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.

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

	5.	Beenden des Agenten

• Host
• Beenden des Agenten.
  Rechte Maustaste auf Agent-Symbol in der Taskleiste. Befehl Exit wählen.

Kommentare

Zum besseren Verständnis der Notwendigkeit zusätzlicher Berechtigungen für die Installation des Windows-Agenten, die im Abschnitt "Ablauf / Einrichten des Systemumfeldes" aufgezählt sind, folgen hier Detailinformationen.

Für den Windows-Agenten sind bestimmte zusätzliche Privilegien unter Windows für die Nutzung der Windows-APIs notwendig, die weiter unten aufgezählt werden.

Der Agent benötigt diese Berechtigungen, um in einem anderen Benutzerkontext FileTransfers auszuführen und Jobs zu starten. Die Benutzer werden zwar in den Jobs in der Automation Engine definiert, aber der Agent muss sich mit Berechtigungen dieses Benutzers beispielsweise anmelden, Benutzerprofile auslesen und Jobs starten können. Deshalb wird im Allgemeinen empfohlen, den Agenten als SYSTEM-Benutzer über den ServiceManager zu starten.

Wenn der Agent allerdings als normaler Benutzer gestartet wird, sollten Sie ihn mit den empfohlenen zusätzlichen Berechtigungen installieren, um dem Agenten die Ausführung der oben genannten Aufgaben zu ermöglichen:

• Als Teil des Betriebssystems agieren
• Als Dienst anmelden
• Dateien und Verzeichnisse wieder herstellen
• Backups von Dateien und Verzeichnissen erstellen
• Anpassen der Arbeitsspeicherquoten für einen Prozess
• Ein Prozess-Level Token ersetzen

Die Berechtigung 'als Batch-Job anmelden' ist dann notwendig, wenn die Option "Anmeldung als Batch-Benutzer" in den Windows-Jobs der Automation Engine Job-Objekte aktiviert wurde.

Siehe auch:

Konfiguration des Debuggers für eventuelle Programmabbrüche