Enregistrer manuellement un Agent Robots sur site

L'Agent Robots doit être enregistré au moyen d'un fichier de clé (registration.key). En général, vous enregistrez l'Agent Robots dans le cadre du processus d'installation. Toutefois, vous devez enregistrer manuellement l'agent séparément de l'installation ou, dans certaines situations, le réenregistrer.

L'enregistrement manuel d'un Agent Robots comporte deux étapes distinctes :

  1. Générer et télécharger le fichier de clé d'enregistrement.
  2. Installer manuellement le fichier de clé d'enregistrement de la structure du répertoire de l'Agent Robots, puis démarrer ou redémarrer le service de l'Agent Robots

Remarque

Les informations de cette rubrique s'appliquent uniquement aux organisations ayant recours à un Agent Robots sur site pour exécuter des scripts ACL dans des robots ACL.

Les personnes ou organisations disposant d'ACL Robotics Professional Edition n'ont pas l'agent Robots sur site. Les scripts Python/HCL qui s'exécutent dans des robots HighBond et des robots de flux de travail n'utilisent pas l'Agent Robots.

Enregistrement manuel requis

L'enregistrement ou le réenregistrement manuel de l'Agent Robots est requis dans les situations suivantes :

  • Changement du compte de service après l'installation Lors de l'installation de l'Agent Robots, vous laissez la case Copier le fichier d'enregistrement décochée. Après l'installation, vous envisagez de mettre immédiatement à jour le compte utilisé pour exécuter le service de l'Agent Robots.
  • Changement de l'adresse IP du serveur L'adresse IP du serveur Windows qui héberge l'Agent Robots change.
  • Problème avec un fichier de clé Certains problèmes existent avec le fichier de clé d'enregistrement existant.

Enregistrement manuel non requis

Vous ne devez pas réenregistrer manuellement un Agent Robots existant ni générer un nouveau fichier de clé d'enregistrement dans les situations suivantes :

  • Changement d'un compte de service de production Vous avez besoin de changer le compte de service qui a exécuté un Agent Robots installé. Pour plus d'informations, consultez la section Changer le compte de service de l'Agent Robots.
  • Mise à niveau de l'Agent Robots Le fichier de clé d'enregistrement n'est pas concerné par la mise à niveau de l'Agent Robots.

Dans de telles situations, la génération d'un nouveau fichier de clé d'enregistrement est inutile et peut perturber la configuration de l'instance de Robots de votre organisation (voir l'explication ci-dessous).

Conséquences de la regénération d'une clé d'enregistrement

Les effets de la génération d'une nouvelle clé d'enregistrement pour un Agent Robots déjà en service sont les suivants :

  • Tous les mots de passe enregistrés dans les tâches du robot sont supprimés et doivent être re-saisis.
  • Tous les agents sont supprimés de la liste des agents sur l'écran Gestion de l'agent.
  • Tous les agents doivent être réinscrits, y compris en migrant la clé RSA Agent Robots entre les serveurs pour les installations multi-agents.

Générer le fichier clé d'enregistrement de l'agent Robots

Remarque

Vous devez avoir l'autorisation de gestion d'agent pour générer un fichier clé d'enregistrement de l'agent Robots. Pour plus d'informations, consultez la section Autorisations de l'application Robots.

  1. Connectez-vous à Diligent One (www.highbond.com).
  2. Depuis la page d’accueil de la barre de lancement, sous Audit et analyses de données, sélectionnez l’application Robots.
  3. Dans le coin supérieur droit du tableau de bord, cliquez sur Paramètres.
  4. Dans le panneau gauche, assurez-vous que Gestion de l'agent est sélectionné.
  5. Si l'instance de Robots utilise actuellement un Agent Robots basé dans le cloud, procédez comme suit :
    1. Cliquez sur Remplacer l'agent cloud.
    2. Cliquez sur Enregistrer un agent et générer la clé.
  6. Si l'instance de Robots utilise actuellement un Agent Robots sur site, ou si aucun Agent Robots n'est indiqué, procédez comme suit :
    1. Cliquez sur Générer une nouvelle clé d'inscription.

      La boîte de dialogue d'avertissement qui s'affiche vous concerne si vous avez un ou plusieurs agents sur site déjà installés.

    2. Cliquez sur Générer une nouvelle clé d'inscription.

  7. Cliquez sur Télécharger le fichier clé et fermer.

    Attention

    Ne fermez pas la fenêtre du navigateur pendant le téléchargement du fichier clé.

  8. Enregistrez le fichier de clé téléchargé à un emplacement sécurisé sur le serveur Windows qui héberge l'Agent Robots.

    Remarque

    La génération d'un fichier clé constitue la première étape de l'enregistrement d'un agent Robots. Le processus d'enregistrement prend fin lorsque vous placez le fichier de clé à l'emplacement requis dans la structure de répertoire de l'Agent Robots, que vous lancez ou relancez le service de l'Agent Robots et que réussissez à vous connecter à l'application Robots.

Installez le fichier clé d'enregistrement manuellement

  1. Dans le serveur Windows qui exécute l'Agent Robots, copiez le fichier clé d'enregistrement depuis son emplacement d'enregistrement.
  2. Accédez au répertoire d'installation de l'Agent Robots et collez le fichier de clé d'enregistrement dans le sous-dossier agent.

    Le répertoire d'installation par défaut est : C:\Program File (x86)\ACL Software\Robots Agent\agent

    Si nécessaire, supprimez ou écrasez un fichier de clé existant.

  3. Dans le Gestionnaire des services Windows, redémarrez le service de l'Agent Robots.

    Commentaires

    Si vous ne redémarrez pas le service, les scripts analytiques ne s'exécutent pas.

  4. Vérifiez le fichier journal de l'application pour confirmer que l'Agent Robots est bien connecté à l'application Robots.

    Rendez-vous à la fin du fichier journal et recherchez une entrée INFO|Connected dont la date et l'heure correspondent au lancement du service Agent Robots.

    L'emplacement par défaut du fichier journal est : C:\acl\robots\logs\application.log

  5. Dans l'application Robots, accédez à l'écran Gestion de l'agent et appuyez sur F5 pour recharger la page.

    Si l'agent Robots figure dans la liste avec un statut En ligne, il est enregistré.