Installieren von Agenten über Fernzugriff

Sie können Agenten installieren, indem Sie die IBM® UrbanCode Deploy-Webanwendung verwenden.

Vorbereitende Schritte

Sie müssen über die Berechtigung zum Anzeigen der Registerkarte Einstellungen verfügen, um Agenten mit dieser Methode zu installieren.
Erstellen Sie für Produktionsumgebungen ein Benutzerkonto, das dafür dediziert ist, den Agenten auf dem Computer auszuführen, auf dem der Agent installiert ist.
Anmerkung: This user must have access to all working directories that are used in the processes that this agent runs. If this user does not have access to the working directory specified in a process step, that step fails.
If you are installing the agent on z/OS, review Security requirements on the IBM z/OS computers.
Stellen Sie sicher, dass jeder Computer, auf dem Sie einen Agenten installieren, über eine unterstützte Version der Java™ Runtime Environment (JRE) oder des Java Development Kit verfügt. Weitere Informationen dazu finden Sie unter IBM UrbanCode Deploy - System Requirements.
Wenn der Zielcomputer über eine JRE oder ein Java Development Kit von IBM verfügt, aktualisieren Sie auf eine unterstützte Version der IBM JRE oder des Java Development Kit.
Make sure that your networks and firewalls allow communication on the required ports. See Firewall and communication configuration.
Ensure that there is no limit on the maximum memory size and virtual memory size. For example, on most Linux systems, you can run the ulimit -m and ulimit -v commands and ensure that both return the value unlimited. To find out how to remove the limit on the maximum memory size and virtual memory size, see the documentation for the operating system.

Anmerkung: Informationen zur Installation von Agenten über Fernzugriff unter Windows finden Sie unter Installing agents on Windows through WinRS.

Anmerkung: Eine weitere Option zur Installation von Agenten über Fernzugriff besteht darin, den Schritt "Agent mit SSH installieren" (Plug-in für IBM UrbanCode Deploy-Ressourcen) oder den Schritt "WinRS Agent-Installation" (Plug-in für WinRS-Agenteninstallation) einem Prozess hinzuzufügen.

Informationen zu diesem Vorgang

Sie können einen Agenten durch Angabe der Zielposition installieren oder einen Agenten installieren, der zuvor über die Agentenerkennungsfunktion erkannt wurde. Mithilfe von Agenteninstallations-Eigenschaftenblättern können Sie mehrere Agenten gleichzeitig installieren. Achten Sie darauf, dass alle Agenten dieselben Basisparameter verwenden.

Sie können Agenten nur auf Computern installieren, auf denen Linux, UNIX, Windows oder Mac OS ausgeführt werden. Informationen zu anderen Systemen, darunter z/OS und IBM i finden Sie unter Installing agents from the command line.

Vorgehensweise

Wählen Sie auf dem Server die Optionsfolge Ressourcen > Agenten.
Führen Sie einen der folgenden Schritte aus, um einen Agenten zu installieren:
- Wenn Ihnen der Zielhost bekannt ist, klicken Sie auf Neuen Agenten installieren.
- Zum Installieren eines mithilfe der Agentenerkennungsfunktion erkannten Agenten klicken Sie bei dem entsprechenden Agenten auf die Aktionsschaltfläche Agent installieren. Erkannte Agenten haben den Status Installierbar.
Informationen zur Agentenerkennungsfunktion erhalten Sie unter Automatisches Erkennen von Agenten.
Wählen Sie im Fenster Neuen Agenten installieren die Option SSH aus.
Anmerkung: Wenn Sie einen erkannten Agenten installieren, wird dieser Schritt übersprungen, da der Systemtyp automatisch bei der Erkennung bestimmt wird.
Geben Sie in das Feld Zielhosts den Hostnamen oder die IP-Adresse des Systems ein, auf dem Sie den Agenten installieren möchten. Geben Sie zur Angabe mehrerer Einträge jede in eine einzelne Zeile ein.
Anmerkung: Wenn Sie einen erkannten Agenten installieren, wird dieser Schritt übersprungen, da die Host- oder IP-Adresse während der Erkennung automatisch bestimmt wird.
Geben Sie die folgenden Parameter an:
1. Geben Sie die SSH-Portadresse des Zielsystems in das Feld SSH-Port ein.
2. Aktivieren Sie das Kontrollkästchen Public-Key-Authentifizierung verwenden, um anstelle eines Kennworts Public-Key-Authentifizierung zu verwenden.
3. Geben Sie einen Namen für den Agenten in das Feld Agentenname ein.
  Anmerkung: Wenn Sie mehrere Hosts in das Feld Zielhosts eingeben, wird dem Agentennamen eine Zahl angehängt. Die Zahl steigt für jeden Host nach dem ersten.
  Wenn Sie zum Beispiel mein_agent als Agentennamen und drei Hosts angeben, ist der Name des Agenten auf dem ersten Host mein_agent, der Name des Agenten auf dem zweiten Host ist mein_agent1 und der Name des dritten Agenten lautet mein_agent2. Hostnamen werden vom Anfang der Liste bis zum Ende verarbeitet.
Geben Sie den Namen des Benutzers mit den entsprechenden Berechtigungen für den Zielhost in das Feld Benutzername ein. Dieser Benutzer muss die Berechtigung zum Bearbeiten des Agentenverzeichnisses auf dem Zielhost haben.
Anmerkung: This user must have access to all working directories that are used in the processes that this agent runs. If this user does not have access to the working directory specified in a process step, that step fails.
If you are installing the agent on z/OS, review Security requirements on the IBM z/OS computers.
Geben Sie das dem Benutzer zugeordnete Kennwort in das Feld Kennwort ein.

Wählen Sie ein Agenteninstallations-Eigenschaftenblatt aus der Liste Agenteninstallationseigenschaften aus oder verwenden Sie Neu, um ein neues Eigenschaftenblatt zu erstellen. Agenteninstallations-Eigenschaftenblätter sind Vorlagen, die zum Installieren von Agenten gespeichert und verwendet werden können. Sie können eine beliebige Anzahl an Agenteninstallations-Eigenschaftenblättern erstellen. Die Agenteninstallationseigenschaften sind in der folgenden Tabelle aufgeführt:

Tabelle 1. Installationseigenschaften für fernen Agenten
Feld	Beschreibung
Name	Der Name des Agenteninstallations-Eigenschaftenblatts.Dieser Wert ist erforderlich.
Beschreibung	Die Beschreibung des Eigenschaftenblatts.
Agent-Dir	Das Verzeichnis an der Zielposition, in dem der Agent installiert wird.Dieser Wert ist erforderlich.
Java-Ausgangspfad	Pfad zu Java an der Zielposition. In der Regel geben Sie den Wert der Systemvariablen JAVA_HOME des Agentensystems ein. Verwenden Sie nicht die Variable JAVA_HOME oder eine andere Variable in diesem Feld; Sie müssen den vollständigen tatsächlichen Pfad angeben. Auf einem Microsoft Windows-System kann der Java-Ausgangspfad beispielsweise C:\Programme\Java\jre lauten. Auf einem Linux-System kann der Java-Ausgangspfad /usr/lib/jvm/default-java lauten. Dieser Wert ist erforderlich.
Pfad zu temporärem Verzeichnis	Der Pfad zu dem Verzeichnis, das während der Installation für temporäre Dateien verwendet wird.Dieser Wert ist erforderlich.
Server-Host	Hostname oder IP-Adresse des IBM UrbanCode Deploy-Servers oder Agentenrelays, mit dem sich der Agent verbindet.Dieser Wert ist erforderlich.
Server-Port	Der Port, der vom IBM UrbanCode Deploy-Server oder -Agentenrelay für die Verbindung mit dem Agenten verwendet wird. Der Standardport für die Verbindung mit dem Server ist 7918. Der Standardport für die Verbindung mit dem Agentenrelay ist 7916.Dieser Wert ist erforderlich.
Proxy-Host	Der Hostname oder die IP-Adresse des Agentenrelay, falls vorhanden.
Proxy-Port	HTTP-Proxy-Port des Agentenrelay, falls vorhanden. Der Standardwert ist `20080`.
Automatisches Starten	Wenn Sie den Agenten als Dienst installieren möchten, wählen Sie Automatisches Starten aus, um den Agenten beim Start von Windows automatisch auszuführen. Nur Windows.
Servicename	Wenn ein Agent als Dienst installiert wird, geben Sie den Namen für den Agentenservice ein. Nur Windows.
Servicebenutzer	Wenn ein Agent als Dienst installiert wird, geben Sie den Benutzernamen ein, der die entsprechenden Berechtigungen zum Ausführen eines Diensts hat. Nur Windows.
Servicekennwort	Wenn der Agent als Dienst installiert wird, geben Sie das Kennwort ein, das dem Servicebenutzer zugeordnet ist. Nur Windows.

Optional: Aktivieren Sie Team zuweisen, um den Agenten einem Team zuzuweisen.
1. Klicken Sie auf Hinzufügen .
2. Wählen Sie in der Liste Team das Team aus, dem Sie den Agenten zuweisen möchten.
3. Wählen Sie aus der Liste Rolle eine Agentenrolle aus. Informationen über Teams finden Sie unter Assigning teams directly to items.
Klicken Sie auf Speichern, wenn Sie den Vorgang abgeschlossen haben.

Ergebnisse

Über Fernzugriff installierte Agenten werden automatisch gestartet. Wenn ein über Fernzugriff installierter Agent die Ausführung unterbricht, muss er auf dem System, auf dem der Agent gehostet wird, neu gestartet werden.

Nächste Schritte

Bei der Verwendung von gegenseitiger Authentifizierung müssen Sie zwischen dem Agenten und Server den Schlüssel manuell austauschen. Weitere Informationen zu dieser Option finden Sie im Abschnitt Configuring mutual authentication.

Wenn Sie eine Umgebung mit hoher Verfügbarkeit verwenden, konfigurieren Sie den Agenten für ein Failover auf die anderen Server im Cluster. Siehe Configuring agents for failover.

Feedback