MSI-Installationsdatei herunterladen und bearbeiten

Die MSI-Installationsdatei kann für die Masseninstallation des Bot-Agenten verwendet werden. Nachdem Sie die MSI-Installationsdatei des Bot-Agenten über den Control Room heruntergeladen haben, bearbeiten Sie sie, um den Registrierungsschlüssel und die Control Room-URL hinzuzufügen. So können Sie den Bot-Agenten auf mehreren Geräten installieren.

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 das Windows 10-SDK sowie Orca und Control Room auf Ihrem Gerät installiert sind.

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

  • Richten Sie die Microsoft Active Directory-Gruppenrichtlinie ein, um den Bot-Agent per Fernzugriff auf mehreren Geräten zu installieren.

    Use Microsoft Active Directory Group Policy to remotely install software

Die Parameter, die für die Installation über mehrere Geräte hinweg erforderlich sind, sind in der MSI-Datei des Bot-Agenten verfügbar. Lesen Sie die folgenden Anweisungen dazu, wie Sie die MSI-Datei über den Control Room herunterladen und bearbeiten können. So kann der Control Room-Administrator die Bot-Agenten-Richtlinie für die automatische Aktualisierung implementieren.

Prozedur

  1. Laden Sie die Datei AutomationAnywhereBotAgent.msi von einem der folgenden Speicherorte herunter:
    • Klicken Sie in Control Room auf Administrator > Einstellungen > Masseninstallation des Bot-Agenten.

      Die Option Installationsprogramm herunterladen ist für Lokal- 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 Lokal-Bereitstellungen verfügbar.

    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.
  2. Bearbeiten Sie die Datei AutomationAnywhereBotAgent.msi mit dem Orca-Tool.
  3. Klicken Sie auf die Option Eigenschaft.
    Es werden verschiedene Parameter angezeigt. Lesen Sie die folgende Tabelle, um zu verstehen, wofür die einzelnen Parameter verwendet werden:
    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 Control Room-Registrierungsschlüssel für die Masseninstallation von Bot-Agenten generieren.
    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.
  4. Ändern Sie den Wert für AA_CRTOKEN und AA_CRURL.
  5. Speichern Sie Ihre Ä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 ist.
    Prüfen Sie auch die Registerkarte Dienste im Task-Manager, um sicherzustellen, dass der Bot-Agenten-Dienst nicht ausgeführt wird.
    Anmerkung: Die Datei autoregistration.properties wird erstellt unter:
    C:\Windows\System32\config\systemprofile\AppData\Local\AutomationAnywhere\autoregister

    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

Um den Bot-Agenten 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.

Nächste Maßnahme

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

Problembehandlung

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.