Hinzufügen von Agenten in AWI

Als Administrator haben Sie je nach Typ oder Umgebung verschiedene Optionen zum Installieren von Agenten (siehe Agenten (HOST)). Wenn Sie einen Agenten installieren, wird das zugehörige Agentenobjekt automatisch erstellt und steht in AWI in der Perspektive Administration zur Verfügung (Rapid Automation-Agenten sind eine Ausnahme. Sie werden bei der Installation nicht automatisch erstellt, sondern müssen manuell angelegt werden, nachdem Sie die Rapid Automation-Lösung über das Dienstprogramm "AE DB Load" oder die AE-REST-API in die Datenbank geladen haben. Weitere Informationen finden Sie unter Rapid Automation und Agenten für Rapid Automation installieren.

Es gibt jedoch eine andere Option, um Agenten hinzuzufügen. Sie können ein Agentenobjekt direkt in AWI hinzufügen, entweder in der Administration oder der Perspektive Process Assembly (im Mandanten 0) und dann einen vorkonfigurierten Agenten aus dem Marketplace von Broadcom herunterladen. Dieser Agent enthält bereits alle Definitionen, die der Agent benötigt, um damit zu arbeiten.

Dieses Thema erklärt, wie dies funktioniert.

Tipp: Möglicherweise müssen Sie mit vielen Objekten, Listen und Monitoren gleichzeitig arbeiten. Um sich die Arbeit zu erleichtern, können Sie diese in verschiedenen Browserfenstern öffnen und nebeneinander auf Ihrem Bildschirm anordnen. Weitere Informationen über diese und andere nützliche Funktionen finden Sie unter Mehrere Ansichten öffnen und anordnen.

Weitere Informationen:

Diese Seite beinhaltet Folgendes:

Hinzufügen und Herunterladen von Agenten in AWI

Dies gilt für UNIX-, Windows-, alle Java-basierten Agenten (auch in Containern) und das TLS Gateway.

Stellen Sie sicher, dass das Zertifikat, das der Agent oder der Zugang benötigt, verfügbar ist. Sie können das Zertifikat in der Automation Engine speichern, indem Sie es in das Speicherobjekt UC_TRUSTEDCERTS hochladen . Weitere Informationen finden Sie unter UC_TRUSTEDCERTS - Speicherobjekt.

Wichtig! Sie müssen das relevante Zertifikat mit dem Namen JCP_CERT hochladen. Andernfalls erkennt das System nicht, welches Zertifikat für den heruntergeladenen Agenten verwendet werden soll.

Sobald das Zertifikat hochgeladen wurde, ist es im trustedCertFolder verfügbar, der in der INI-Datei des Agenten definiert ist.

Sehen Sie sich das Video an: Hinzufügen und Herunterladen von UNIX-Agenten in AWI AWI

Voraussetzung! Die für ein Centralized Agent Upgrade (CAU) erforderlichen Packs müssen installiert sein, damit Sie einen Agenten aus der Administration-Perspektive herunterladen können. Sie können die CAU-Packs von https://marketplace.automic.com/ herunterladen. Nachdem Sie sie heruntergeladen haben, müssen Sie sie auf Mandant 0 installieren. Dies kann auf der Seite Packs in der AdministrationPerspektive erfolgen. Weitere Informationen finden Sie unter Centralized Agent Upgrade (CAU).

Hinzufügen von Agenten – Process Assembly

Sie können Agenten in Mandant 0 manuell in der Perspektive "Process Assembly" erstellen. So können Sie ein Agentenobjekt ohne Definition erstellen. Dann können Sie eine vorkonfigurierte Agentendefinition in das Agentenobjekt herunterladen, das Sie erstellt haben.

So fügen Sie einen Agenten hinzu

Sie haben zwei Möglichkeiten:
- Klicken Sie mit der rechten Maustaste auf eine beliebige Stelle in der Liste und wählen Sie Hinzufügen > Objekt hinzufügen aus.
- Klicken Sie in der Symbolleiste auf die Schaltfläche Objekt hinzufügen.
Im Dialogfeld Objekt hinzufügen haben Sie zwei Optionen:
- Erweitern Sie die Liste Agent (AGENT), um alle Agenten anzuzeigen und den entsprechenden Agenten auszuwählen.
- Geben Sie den Objekttyp, den Sie erstellen möchten, in das Suchfeld ein.
Klicken Sie auf die Schaltfläche Hinzufügen. Der Dialog Objektname wird angezeigt.
Geben Sie einen aussagekräftigen Namen ein, siehe Name, Titel und Alias
Geben Sie optional einen kurzen und aussagekräftigen Titel ein, der Ihnen hilft, den Zweck des Objekts zu erkennen.
Klicken Sie auf OK.

Das neue Agentenobjekt ist in der Liste Agenten verfügbar, und Sie können es verwenden, um eine vorkonfigurierte Agentendefinition dafür herunterzuladen, siehe Herunterladen von Agenten.

Weitere Informationen zum Bearbeiten der Agentendefinition in AWI finden Sie unter Konfigurieren der Agenteneigenschaften.

Hinzufügen von Agenten – Administration-Perspektive

Sie können einen neuen Agenten direkt aus der Administration-Perspektive jedes Mandanten im System erstellen. Jedoch ist das Agentenobjekt auch immer in Mandant 0 verfügbar. So können Sie ein Agentenobjekt ohne Definition erstellen. Sie können dann eine vorkonfigurierte Agentendefinition in das Agentenobjekt herunterladen, das Sie erstellt haben. Sie können die vorkonfigurierten Agenten vom Marketplace von Broadcom herunterladen.https://marketplace.automic.com/

Wenn Sie einen vorkonfigurierten Agenten herunterladen, müssen Sie keine zusätzlichen Definitionen erstellen, können Definitionen jedoch bei Bedarf im Mandanten 0 ändern.

So fügen Sie einen Agenten hinzu

Öffnen Sie die Perspektive "Administration" und wählen Sie Agenten & Gruppen > Agenten im Navigationsbereich auf der linken Seite aus.
Sie haben zwei Möglichkeiten:
- Klicken Sie mit der rechten Maustaste auf eine beliebige Stelle in der Liste und wählen Sie Hinzufügen > Agenten hinzufügen aus.
- Klicken Sie in der Symbolleiste auf die Schaltfläche Agenten hinzufügen
Wählen Sie den entsprechenden Agenten aus der Liste aus und klicken Sie auf die Schaltfläche Hinzufügen. Der Dialog Objektname wird angezeigt.
Geben Sie einen aussagekräftigen Namen ein.
Geben Sie optional einen kurzen und aussagekräftigen Titel ein, der Ihnen hilft, den Agenten zu erkennen.
Klicken Sie auf OK.

Das neue Agentenobjekt ist in der Liste Agenten verfügbar, und Sie können es verwenden, um eine vorkonfigurierte Agentendefinition dafür herunterzuladen, siehe Herunterladen von Agenten.

Weitere Informationen zum Bearbeiten der Agentendefinition in AWI finden Sie unter Konfigurieren der Agenteneigenschaften.

Herunterladen von Agenten

Die Java-Agenten erfordern eine JRE (Version 17 oder höher). Der Windows-Java-Agent erfordert auch die neueste Version des Microsoft Visual C++ Redistributable Package.

Sie können einen Agenten entweder in der Perspektive "Process Assembly" oder in der Perspektive "Administration" herunterladen. Dazu müssen Sie den relevanten Agenten finden:

Gehen Sie in der Administration-Perspektive zur Liste Agenten, siehe Informationen zur Liste der Agenten.
Wechseln Sie in der Process Assembly zum relevanten Ordner oder verwenden Sie die Suchfunktion, siehe Verwenden der globalen Suche nach Objekten und Aufgaben.

Sobald Sie den relevanten Agenten gefunden haben, haben Sie die folgenden Optionen:
- Wählen Sie den Agenten aus und klicken Sie auf die Schaltfläche Agent herunterladen in der Symbolleiste.
- Klicken Sie mit der rechten Maustaste auf das relevante Agentenobjekt und wählen Sie Agent herunterladen aus.
Der Dialog Agent herunterladen wird angezeigt. Das Feld Name wird automatisch ausgefüllt.
Definieren Sie das entsprechende Betriebssystem und die Architektur.
Aktivieren Sie optional das Kontrollkästchen ServiceManager.

Hinweis: Wenn das Kontrollkästchen Service Manager nicht aktiviert ist, werden die Felder Betriebssystem und Architektur für Java-basierte Agenten deaktiviert. Wenn Sie einen Windows-Agenten auswählen, ist das Betriebssystem standardmäßig Windows und das Feld ist deaktiviert.
Optional: Aktivieren Sie das Kontrollkästchen Java Runtime Environment. Dadurch können Sie eine kompatible JRE erhalten.

Wichtig! Stellen Sie sicher, dass Sie das JRE-Paket heruntergeladen und in Mandant 0 installiert haben. Das JRE-Paket und das Agentenpaket müssen die gleiche Haupt- und Nebenversion haben, beispielsweise 24.2.x. Wenn Sie mehr als ein JRE-Paket für dieselbe Haupt-/Nebenversion haben, verwendet das System die neueste Version. Wenn es keine JRE oder keine JRE in einer übereinstimmenden Version gibt, wird eine Fehlermeldung angezeigt.
Sobald Sie alle Parameter definiert haben, klicken Sie auf Herunterladen. Ihre Browserbenachrichtigung zeigt an, dass die .zip-Datei des Agenten heruntergeladen wird.
Entpacken Sie die .zip-Datei auf dem gleichen Rechner, auf dem der Agent ausgeführt wird.
Die .zip-Datei enthält auch die INI-Datei des Agenten. Passen Sie die INI-Datei des Agenten an Ihre Systemumgebung an, siehe Agenten – INI-Dateien.
Sobald die Datei entpackt ist, müssen Sie für UNIX- und Windows-Agenten folgende Schritte ausführen:

UNIX (Linux)-Agenten
1. Registrieren Sie sich beim Host mit Ihrer Benutzer-ID, z. B. AE.
2. Stellen Sie sicher, dass alle Dateien über den korrekten Eigentümer- und Gruppeneintrag verfügen. Der Besitzer muss der gleiche Benutzer sein, den Sie verwendet haben, um (AE) zu registrieren, und die Gruppe muss dem Code des Benutzers (AE) entsprechen. Nur ein privilegierter Benutzer, wie beispielsweise Root, kann diese Änderungen vornehmen.
  
  Beispiel
  - chown AE * ändert die Eigentümer aller Dateien auf AE
  - chgrp Gruppenname * ändert die Benutzergruppen aller Dateien.
3. Für den eigentlichen Betrieb können der Datei ucxj??? die Berechtigungen eines privilegierten Benutzers wie Root erteilt werden.
  - Den Eigentümer in root ändern: chown root ucxj???
  - S-Bit festlegen (Set-Userid): chmod 4755 ucxj???
  Hinweis: Sie benötigen mindestens die Berechtigungen 755 für ausführbare Objekte wie Agenten.
4. Setzen Sie die Umgebungsvariablen SSL_CERT_DIR und SSL_CERT_FILE auf den Anwender, der den Agenten startet.
  
  Mit diesen Variablen können Sie die Zertifikate aus dem TLS/SSL-Speicher laden. Die Zertifikate können entweder in einer Datei pro Zertifikat oder alle Zertifikate in einer .pem-Datei gespeichert werden:
  - SSL_CERT_DIR: Speicherort der vertrauenswürdigen CA-Zertifikate, wobei jedes Zertifikat in einer separaten Datei abgelegt wird, z. B. /etc/ssl/certs/
  - SSL_CERT_FILE: Speicherort der .pem-Datei mit allen vertrauenswürdigen CA-Zertifikaten, z. B. /etc/pki/tls/certs/ca-bundle.crt
5. Führen Sie die binäre Datei ucxjlx6 aus, um den Agenten zu starten.
Windows-Agenten

Führen Sie eine der folgenden Aktionen aus:
- Aktualisieren Sie den Parameter trustedCertFolder= im Abschnitt [AUTHORIZATION] der INI-Datei des Windows-Agenten, siehe Agent Windows 64-bit
- Importieren Sie das JCP-Zertifikat in den Windows-Betriebssystemspeicher
Der heruntergeladene Agent ist funktionsbereit.

Verwenden von Scripts

Sie können Scripts verwenden, um Agenten-Packs einfach zu erstellen, herunterzuladen und zu extrahieren sowie Agenten zu starten, die auf einem Windows- oder UNIX-System ausgeführt werden.

Wir haben einige Beispiele für Deployment-Scripts für SQL-, REST-, Windows- und UNIX-Agenten zusammengestellt. Sie ermöglichen es Ihnen, die Agenten bereitzustellen und zu starten, ohne Ihr eigenes Script erstellen zu müssen. Sie können auch separate Scripts, die in den Beispielen verwendet werden, zu einem großen Script zusammenführen.

Weitere Informationen:

Weitere Informationen zum Bearbeiten der Agentendefinition in AWI finden Sie unter Konfigurieren der Agenteneigenschaften.

Siehe auch: