Installation en masse du Agent de robot sur les appareils

L'installation de l'Agent de robot sur plusieurs périphériques tels que les machines sur site, les machines virtuelles et l'infrastructure de bureau virtuel (VDI) non persistante y compris Amazon WorkSpaces est appelée « installation en masse » (ou installation silencieuse). Vous devez modifier le fichier MSI de l'Agent de robot pour une installation en masse.

Prérequis

Pour effectuer la tâche, vous devez être un administrateur de la Control Room et disposer des droits et autorisations requis.

  • Assurez-vous d'avoir téléchargé le fichier MSI à partir de la Control Room et vérifiez que les paramètres requis pour installer les périphériques sont disponibles dans le fichier MSI de l'Agent de robot.
    Remarque : Si vous essayez de télécharger le fichier MSI pour la première fois, vous devez cliquer sur Paramètres > Installation en masse d'agent robot > Modifier > Enregistrer les modifications pour générer une clé d'enregistrement et afficher l'option Télécharger le programme d'installation pour le fichier MSI. .
  • Assurez-vous que le kit de développement logiciel Windows 10, y compris Orca, est installé sur le périphérique.

    Vous pouvez installer Orca à partir de C:\Program Files (x86)\Windows Kits\10\bin\10.0.18362.0\x86\Orca-x86_en-us.msi.

Remarque : Un exemple de fichier autoregistration.properties se trouve à la fin de la page à titre de référence.

Procédure

  1. Utilisez le fichier AutomationAnywhereBotAgent.msi le plus récent à partir des emplacements suivants :
    • Téléchargez le fichier à partir de la Control Room (Administrateur > Paramètres > Installation en masse d'agent robot).

      L'option de téléchargement est disponible pour les déploiements Sur site et Cloud.

    • Sélectionnez le fichier dans le dossier <application filepath>\crui\asset. Par exemple, C:\Program Files\Automation Anywhere\crui\asset

      Cette option n'est disponible que pour les déploiements Sur site.

  2. Modifiez le fichier AutomationAnywhereBotAgent.msi à l'aide de l'outil Orca.
  3. Cliquez sur l'option Propriété.
  4. Entrez les valeurs appropriées pour les paramètres suivants :
    Paramètre Description
    AA_CRURL Entrez l'instance de Control Room à laquelle l'Agent de robot va être connecté.
    Remarque : Assurez-vous de ne pas ajouter de barre oblique inverse (/) à la fin de l'URL de la Control Room. Par exemple, mycr.mydomain.com/.
    AA_CRTOKEN Saisissez la valeur de la clé d'enregistrement correspondante pour chaque Control Room. La clé d'enregistrement est fournie par l'administrateur de la Control Room.
    Vous pouvez configurer jusqu'à 20 URL de Control Room. Assurez-vous que :
    • Vous fournissez les jetons d'enregistrement correspondants sous AA_CRTOKEN, AA_CRTOKEN2 à AA_CRTOKEN20 pour chaque URL de Control Room configurée.
    • Il y a une correspondance biunivoque entre CR_URL et CR_TOKEN.
    • Il n'y a pas de saut entre CR_URL et CR_TOKEN, et ils sont renseignés consécutivement.

      Par exemple, pour configurer trois URL de Control Room, il faut les renseigner dans l'ordre suivant : AA_CRURL, AA_CRURL2, AA_CRURL3.

    Reportez-vous à la rubrique Générer une clé d'enregistrement à utiliser pour l'installation de l'Agent de robot en masse.

    AA_DELAY_REGISTRATION_UNTIL_LOGIN Saisissez True pour retarder l'enregistrement de l'Agent de robot à une Control Room jusqu'à ce qu'un utilisateur se connecte à cette Control Room.

    Si un utilisateur se connecte à l'une des instances de Control Rooms configurées à partir du périphérique sur lequel l'Agent de robot est installé, l'Agent de robot sur ce périphérique sera automatiquement enregistré avec cette Control Room associée. Si l'URL de connexion à la Control Room n'est pas configurée, l'Agent de robot n'est pas enregistré avec cette Control Room.

    AA_DEVICE_TYPE Entrez l'une des valeurs suivantes pour le type d'appareil :
    • SINGLE_USER
    • MULTIPLE_USERS
    Remarque : Saisissez les valeurs en majuscules.
    AA_LIFESPAN Entrez l'une des valeurs suivantes pour un périphérique non persistant ou persistant :
    • TEMPORARY
    • PERSISTENT
    Remarque : Saisissez les valeurs en majuscules lorsque vous installez l'Agent de robot.
    AA_CONCURRENT_SESSIONS Entrez les sessions simultanées autorisées, de 1 à 99. La valeur par défaut est 1.
    Remarque : Les sessions simultanées ne s'appliquent qu'aux périphériques multi-utilisateurs (AA_DEVICE_TYPE = Multi-utilisateurs)
    AA_INSTALL_ONLY Choisissez si vous souhaitez installer l'Agent de robot sans vous enregistrer auprès de la Control Room.
    • Saisissez True pour installer uniquement et ne pas enregistrer l'Agent de robot.
      Remarque :

      Le fichier autoregistration.properties est créé lorsque AA_INSTALL_ONLY a pour valeur True. Vous pouvez définir AA_INSTALL_ONLY sur True uniquement pour l'installation au niveau du système.

    • Saisissez False pour installer et enregistrer l'Agent de robot.
    AA_DEVICE_POOL_NAME Spécifiez le nom du pool de périphériques. La valeur par défaut est 0.
    Remarque : Veillez à utiliser un pool de périphériques existant.
  5. Enregistrez les modifications.
  6. Copiez le fichier AutomationAnywhereBotAgent.msi sur l'instance de machine virtuelle (golden image) sur laquelle vous souhaitez installer l'Agent de robot.
    Remarque : Veillez à ne pas redémarrer l'instance de machine virtuelle (image dorée).
  7. Exécutez le fichier AutomationAnywhereBotAgent.msi.
  8. Vérifiez que l'Agent de robot est installé sur l'instance de machine virtuelle et que le service de l'Agent de robot n'est pas en cours d'exécution dans l'onglet Services du gestionnaire de tâches.
    Remarque : Un fichier autoregistration.properties sera généré :
    C:\Windows\System32\config\systemprofile\AppData\Local\AutomationAnywhere\autoregister 

Pour déployer l'Agent de robot sur des périphériques temporaires ou non persistants, vous devez configurer les paramètres SysPrep et créer des images machine sur l'instance de machine virtuelle.

  1. Arrêtez l'instance de machine virtuelle sans SysPrep après avoir activé les paramètres de nom d'ordinateur temporaires ou non persistants pour la machine virtuelle.
    Pour obtenir un exemple d'utilisation de SysPrep sur une instance AWS EC2, consultez Utilisation de Sysprep pour créer et installer des AMI Windows réutilisables et personnalisées.
  2. Créez des images machine sur l'instance de machine virtuelle selon les besoins.
    Pour obtenir un exemple de création d'Amazon Machine Images (AMI) à partir d'une instance AWS EC2, consultez Création d'une AMI à partir d'une instance Amazon EC2.
Si un Agent de robot est enregistré dans l'instance de machine virtuelle par erreur, effectuez les étapes suivantes pour restaurer l'image de la machine :
  1. Désinstallez l'Agent de robot du Panneau de configuration Windows de l'instance de machine virtuelle.
  2. Supprimer tous les fichiers de C:\Windows\System32\config\systemprofile\AppData\Local\AutomationAnywhere.
  3. Saisissez True pour le paramètre AA_INSTALL_ONLY dans le fichier AutomationAnywhereBotAgent.msi que vous avez utilisé précédemment pour installer l'Agent de robot.
  4. Exécutez à nouveau le fichier AutomationAnywhereBotAgent.msi.

Exemple de fichier autoregistration.properties

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

Étapes suivantes

Confirmez que les périphériques sont ajoutés sur la page Périphériques de la Control Room.