Télécharger et modifier le fichier d'installation MSI

Le fichier d'installation MSI peut être utilisé pour l'installation en masse de l'Agent de robot. Après avoir téléchargé le fichier d'installation MSI de l'Agent de robot à partir de la Control Room, modifiez-le pour ajouter la clé d'enregistrement et l'URL de la Control Room. Cela vous permet d'installer à distance l'Agent de robot sur plusieurs périphériques.

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 que le kit de développement logiciel Windows 10, y compris Orca et Control Room sont installés sur votre 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.

  • Configurez également la stratégie de groupe Microsoft Active Directory pour installer le Agent de robot à distance sur plusieurs périphériques.

    Utilisation de la stratégie de groupe de Microsoft Active Directory pour installer des logiciels à distance

Les paramètres requis pour l'installation sur plusieurs périphériques sont disponibles dans le fichier MSI de l'Agent de robot. Consultez les instructions suivantes pour savoir comment télécharger le fichier MSI à partir de la Control Room et le modifier. Cela permet à l'administrateur de la Control Room de mettre en œuvre la règle de mise à jour automatique de l'Agent de robot.

Procédure

  1. Téléchargez le fichier AutomationAnywhereBotAgent.msi à partir de l'un des emplacements suivants :
    • Dans la Control Room, cliquez sur Administrateur > Paramètres > Installation en bloc de l'agent de robots.

      L'option Télécharger le programme d'installation 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.

    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.
  2. Modifiez le fichier AutomationAnywhereBotAgent.msi à l'aide de l'outil Orca.
  3. Cliquez sur l'option Propriété.
    Différents paramètres s'affichent. Consultez le tableau suivant pour comprendre à quoi sert chaque paramètre :
    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 de la Control Room à 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.
  4. Modifiez la valeur pour AA_CRTOKEN et AA_CRURL.
  5. Enregistrez vos 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.
    Consultez également l'onglet Services dans le Gestionnaire des tâches pour vous assurer que le service Agent de robot n'est pas en cours d'exécution.
    Remarque : Un fichier autoregistration.properties sera généré :
    C:\Windows\System32\config\systemprofile\AppData\Local\AutomationAnywhere\autoregister

    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

Afin de 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.

Étapes suivantes

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

Résolution des problèmes

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.