Bot-Agent-Masseninstallation auf Geräten

Die Installation von Bot-Agent über mehrere Geräte wie lokale Rechner, virtuelle Maschinen (VM) und nicht-persistente virtuelle Desktop-Infrastrukturen (VDI) einschließlich Amazon WorkSpaces wird als Masseninstallation (oder Silent-Installation) bezeichnet. Sie müssen die Bot-Agent-MSI-Datei für die Masseninstallation bearbeiten.

Vorbereitungen

Um die Aufgabe ausführen zu können, müssen Sie ein Control Room-Administratorkonto haben und über die erforderlichen Rechte und Berechtigungen verfügen.

  • Vergewissern Sie sich, dass Sie die MSI-Datei vom Control Room heruntergeladen haben und dass die für die Installation der Geräte erforderlichen Parameter in der MSI-Datei des Bot-Agenten enthalten sind.
    Anmerkung: Wenn Sie versuchen, die MSI-Datei zum ersten Mal herunterzuladen, müssen Sie auf Einstellungen > Masseninstallation des Bot-Agenten > Bearbeiten > Änderungen speichern klicken, um einen Registrierungsschlüssel zu generieren und Installationsprogramm herunterladen für die MSI-Datei anzuzeigen. .
  • Vergewissern Sie sich, dass das Windows 10 Software Development Kit einschließlich Orca auf dem Gerät installiert ist.

    Sie können Orca über C:\Program Files (x86)\Windows Kits\10\bin\10.0.18362.0\x86\Orca-x86_en-us.msi installieren.

Anmerkung: Zu Ihrer Information finden Sie am Ende der Seite eine autoregistration.properties-Beispieldatei.

Prozedur

  1. Verwenden Sie die neueste AutomationAnywhereBotAgent.msi-Datei, die an folgenden Orten zu finden ist:
    • Laden Sie die Datei über den Control Room herunter (Administrator > Einstellungen > Masseninstallation des Bot-Agenten).

      Die Download-Option ist bei On-Premises- und Cloud-Bereitstellungen verfügbar.

    • Wählen Sie die Datei im Ordner <application filepath>\crui\asset aus. Beispiel: C:\Program Files\Automation Anywhere\crui\asset

      Diese Option ist nur bei On-Premises-Bereitstellungen verfügbar.

  2. Bearbeiten Sie die Datei AutomationAnywhereBotAgent.msi mit dem Orca-Tool.
  3. Klicken Sie auf die Option Eigenschaft.
  4. Geben Sie die entsprechenden Werte für die folgenden Parameter ein:
    Parameter Beschreibung
    AA_CRURL Geben Sie die Control Room-Instanz ein, mit der der Bot-Agent verbunden wird.
    Anmerkung: Fügen Sie am Ende der Control Room-URL keinen Backslash (\) ein. Zum Beispiel mycr.mydomain.com/.
    AA_CRTOKEN Geben Sie den entsprechenden Registrierungsschlüsselwert für jeden Control Room ein. Den Registrierungsschlüssel erhalten Sie vom Control Room-Admin.
    Sie können bis zu 20 Control Room-URLs konfigurieren. Stellen Sie Folgendes sicher:
    • Sie müssen die entsprechenden Registrierungstoken unter AA_CRTOKEN, AA_CRTOKEN2 bis AA_CRTOKEN20 für jede konfigurierte Control Room-URL angeben.
    • Es muss eine Eins-zu-eins-Übereinstimmung zwischen CR_URL und CR_TOKEN bestehen.
    • CR_URL und CR_TOKEN dürfen nicht übersprungen werden und müssen fortlaufend ausgefüllt werden.

      Um zum Beispiel drei Control Room-URLs zu konfigurieren, müssen sie in der folgenden Reihenfolge eingegeben werden: AA_CRURL, AA_CRURL2, AA_CRURL3.

    Einzelheiten finden Sie unter Registrierungsschlüssel für die Installation großer Mengen von Bot-Agenten.

    AA_DELAY_REGISTRATION_UNTIL_LOGIN Geben Sie True ein, um die Bot-Agenten-Registrierung bei einem Control Room zu verzögern, bis sich ein Nutzer bei diesem Control Room angemeldet hat.

    Meldet sich ein Nutzer bei einer Control Room-Instanz an, die von dem Gerät aus konfiguriert wurden, auf dem der Bot-Agent installiert ist, wird der Bot-Agent auf diesem Gerät automatisch beim zugehörigen Control Room registriert. Wenn die eingeloggte Control Room-URL nicht konfiguriert ist, ist kein Bot-Agent bei diesem Control Room registriert.

    AA_DEVICE_TYPE Geben Sie einen der folgenden Werte für den Gerätetyp ein:
    • SINGLE_USER
    • MULTIPLE_USERS
    Anmerkung: Achten Sie darauf, dass Sie die Werte in Großbuchstaben eingeben.
    AA_LIFESPAN Geben Sie einen der folgenden Werte für ein nicht dauerhaftes oder dauerhaftes Gerät ein.
    • TEMPORARY
    • PERSISTENT
    Anmerkung: Achten Sie bei der Installation des Bot-Agenten darauf, dass Sie die Werte in Großbuchstaben eingeben.
    AA_CONCURRENT_SESSIONS Geben Sie die Anzahl der zulässigen gleichzeitigen Sitzungen von 1 bis 99 ein. Der Standardwert lautet 1.
    Anmerkung: Gleichzeitige Sitzungen sind nur für Mehrnutzergeräte möglich (AA_DEVICE_TYPE = Multiuser)
    AA_INSTALL_ONLY Wählen Sie aus, ob der Bot-Agent installiert werden soll, ohne ihn beim Control Room zu registrieren.
    • Geben Sie True ein, damit der Bot-Agent nur installiert, aber nicht registriert wird.
      Anmerkung:

      Die Datei autoregistration.properties wird erstellt, wenn AA_INSTALL_ONLY auf True gesetzt ist. Sie können AA_INSTALL_ONLY nur für die Installation auf Systemebene auf True setzen.

    • Geben Sie False ein, damit der Bot-Agent installiert und registriert wird.
    AA_DEVICE_POOL_NAME Geben Sie den Namen des Gerätepools an. Der Standardwert lautet 0.
    Anmerkung: Stellen Sie sicher, dass Sie einen bestehenden Gerätepool verwenden.
  5. Speichern Sie die Änderungen.
  6. Kopieren Sie die Datei AutomationAnywhereBotAgent.msi in die VM-Instanz (Golden Image), auf der Sie den Bot-Agent installieren möchten.
    Anmerkung: Stellen Sie sicher, dass Sie die VM-Instanz (Golden Image) nicht neu starten.
  7. Führen Sie die Datei AutomationAnywhereBotAgent.msi aus.
  8. Überprüfen Sie, ob der Bot-Agent auf der VM-Instanz installiert wurde und der Bot-Agent-Dienst nicht auf der Registerkarte „Dienste“ im Task-Manager ausgeführt wird.
    Anmerkung: Die Datei autoregistration.properties wird erstellt unter:
    C:\Windows\System32\config\systemprofile\AppData\Local\AutomationAnywhere\autoregister 

Um den Bot-Agent auf befristeten oder nicht dauerhaften Geräten bereitzustellen, müssen Sie die SysPrep-Einstellungen konfigurieren und Maschinen-Images auf der VM-Instanz erstellen.

  1. Fahren Sie die VM-Instanz ohne SysPrep herunter, nachdem Sie befristete oder nicht dauerhafte Computernamenseinstellungen für die VM aktiviert haben.
    Ein Beispiel für die Verwendung von SysPrep für eine AWS EC2-Instanz finden Sie unter Use Sysprep to create and install custom reusable Windows AMIs.
  2. Erstellen Sie nach Bedarf Maschinen-Images auf der VM-Instanz.
    Ein Beispiel dafür, wie Sie Amazon Machine Images (AMI) aus einer AWS EC2-Instanz erstellen, finden Sie unter Create an AMI from an Amazon EC2 Instance.
Wenn ein Bot-Agent versehentlich auf einer VM-Instanz registriert wurde, gehen Sie wie folgt vor, um das Maschinen-Image wiederherzustellen:
  1. Deinstallieren Sie den Bot-Agent über die Windows-Systemsteuerung der VM-Instanz.
  2. Löschen Sie alle Dateien aus C:\Windows\System32\config\systemprofile\AppData\Local\AutomationAnywhere.
  3. Geben Sie für den Parameter AA_INSTALL_ONLY in der Datei AutomationAnywhereBotAgent.msi, mit der Sie zuvor den Bot-Agent installiert haben, True ein.
  4. Führen Sie die Datei AutomationAnywhereBotAgent.msi erneut aus.

autoregistration.properties-Beispieldatei

url=http://ec2-myexampleCR.com
url2=URL2
url3=URL3
url4=URL4
token=eyJhbGciOiJSUzUxMiJ9.eyJjbGllbnRUeXBlIjoiQk9UX0FHRU5UX0FVVE9fUkVHSVNUUkFUSU9OIiwidGVuYW50VXVpZCI6ImI4ZjVmNDE0LWMzZDMtNGRhNy04NDljLWMxOGUwOGNiM2Q5ZCIsImlhdCI6MTY1NTg3NTgyMiwiZXhwIjoxOTcxMjM1ODIyLCJpc3MiOiJBdXRvbWF0aW9uQW55d2hlcmUiLCJuYW5vVGltZSI6NzMxMDYzMzkwNzQ5NX0.BA2bPiIECl9PE34BC1mj2iePLuTlSd8y8Fe1LtIkOKYrD8mR-KVOnMeupDQF4IQ3oZbjpyk73vrLI2k0UeTVpvKuURbZhz8bPIBYer4zlzRjEB-9nOID8MtNRcpzlXgkQ27GEN2pOn4Xs_k198rPJEYHcTwaHRbQ8Mv5UF0eGd8_Q9sLgZB6jt1BhnzMNS3qwZBl1aG1xbOc7orlfyBfTGSvAxnlsRa3_fF7QeFKiw7EdfJDGsIVmIZ58-IMzer-R8sxMnr7hSfi_aYDx8emyoH2XtFAQAYuXiw6vOXWa1o-TYDtPknIJsga6aAiFJ9-w6ndJAov0JvTClmeyLQgBA
token2=t2
token3=t3
token4=t4
device_type=MULTIPLE_USERS
concurrent_sessions=4
lifespan=TEMPORARY
delay_registration_until_login=true

Nächste Maßnahme

Überprüfen Sie, ob die Geräte auf der Seite Control Room Geräte hinzugefügt wurden.