Installer ou mettre à jour un agent Robots sur site
L'agent Robots exécute les tâches planifiées dans l'application Robots. L'agent exécute les tâches sur le serveur Windows local sécurisé de votre entreprise, proche de la source des données tout en restant dans les limites de protection de votre réseau.
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.
Informations générales
Téléchargez le package d'installation de l'Agent Robots et servez-vous-en pour installer l'Agent Robots sur un serveur Windows. Vous pouvez également vous servir du package d'installation pour mettre à niveau un Agent Robots existant sur le serveur.
Fichiers de clés
Au cours de l'installation, vous enregistrez l'Agent Robots au moyen d'un fichier de clé d'enregistrement (registration.key). Vous générez le fichier de clé dans l'application Robots et le téléchargez sur le serveur Windows où l'Agent Robots est installé.
Le fichier de clé d'enregistrement authentifie la première connexion entre l'Agent Robots et l'application Robots. Les connexions et flux de données suivants sont sécurisés par des clés de chiffrement (une paire de clés publiques-privées RSA). La paire de clés RSA est automatiquement générée lorsque vous démarrez le service de l'Agent Robots.
Le fichier de clé d'enregistrement et les clés de chiffrement sont des objets distincts utilisés à différentes étapes du processus d'enregistrement et de connexion.
Si vous mettez à niveau l'Agent Robots, le fichier de clé d'enregistrement n'est pas concerné et vous ne devez pas générer de nouvelle instance de registration.key.
Agents multiples
Pour augmenter la capacité de traitement d'analyse de données et implémenter l'équilibrage de charge, vous avez la possibilité d'installer des instances supplémentaires de l'agent Robots sur d'autres serveurs Windows.
Comptes et services Windows de l'agent Robots
Lorsque vous installez l'agent Robots, deux services Windows sont alors déployés sur le serveur :
- L'agent Robots exécute des tâches Robots ad hoc et planifiées.
- Le service de données Robots offre la connectivité qui permet aux utilisateurs d'ouvrir les tables de l'agent Robots dans Analytics
Si l'un de ces services ne fonctionne pas, la fonctionnalité qu'il offre n'est pas disponible.
Astuce
Si les tâches demeurent longtemps dans la file d'attente de Robots puis sont ignorées ou échouent, vérifiez que le service Agent Robots fonctionne.
Si les utilisateurs reçoivent une erreur de connexion lorsqu'ils essaient d'ouvrir une table d'agent Robots dans Analytics, vérifiez que le service de données Robots fonctionne.
Comptes de service et ports
Vous utilisez des comptes de service pour exécuter les deux services Windows de l'agent Robots. Pour obtenir des informations détaillées sur les droits de connexion et les autorisations requises pour ce compte, consultez la section Sécurité de l'agent Robots sur site.
Remarque
Si vous modifiez les propriétés de l'un des services Windows une fois que vous avez installé l'agent Robots, vous devez relancer le service pour appliquer la modification.
Service Windows | Compte qui exécute le service | Port |
---|---|---|
Service de l'agent Robots |
Compte de domaine indiqué pendant ou après l'installation |
Uniquement communication sortante 443 |
Service de données Robots | Système local | 10 000 par défaut, configurable pendant et après l'installation |
Assurez-vous que l'Agent Robots peut se connecter à l'autorité de certification
L'Agent Robots utilise un certificat numérique pour valider son authenticité et son intégrité. Le certificat nécessite une connexion Internet à l'autorité de certification tierce DigiCert afin d'être vérifié. Si vous installez l'Agent Robots derrière un pare-feu réseau, celui-ci doit être configuré de sorte à autoriser le certificat à se connecter à DigiCert. L'Agent Robots ne fonctionnera pas sans la connexion requise.
Si nécessaire, collaborez avec le département informatique de votre organisation pour configurer un pare-feu réseau ou un serveur proxy de sorte à autoriser la connexion entre le certificat et DigiCert. Le certificat numérique dans l'Agent Robots utilise les URL suivantes pour se connecter au serveur OCSP et à la liste de révocation de certificats de DigiCert :
- http://cacerts.digicert.com
- http://crl3.digicert.com
- http://crl4.digicert.com
- http://ocsp.digicert.com
Pour obtenir plus d'informations sur les URL, vous pouvez examiner le certificat installé.
Examiner le certificat installé
Après avoir installé l'Agent Robots, examinez le certificat installé pour voir les URL des autorités de certification.
- Dans le répertoire d'installation de l'Agent Robots, cliquez avec le bouton droit de la souris sur Agent.exe, puis sélectionnez Propriétés.
Le répertoire d'installation par défaut est : C:\Program Files (x86)\ACL Software\Robots Agent\agent
- Dans la boîte de dialogue Propriétés Agent.exe, sélectionnez l'onglet Signatures numériques.
- Dans la liste des signatures, double-cliquez sur Diligent Corporation, puis cliquez sur Afficher le certificat.
- Dans l'onglet Détails de la boîte de dialogue Certificat, sélectionnez tous les champs suivants :
- Points de distribution CRL
- Accès aux informations d'autorité
Pour chaque champ, les URL apparaissent dans la zone d'affichage en bas de la boîte de dialogue.
- Dans l'onglet Chemin de certification de la boîte de dialogue Certificat, procédez comme suit :
- Sélectionnez chacune de ces entrées de chemin de certification :
- DigiCert Trusted Root G4
- Signature du code DigiCert Trusted G4…
- Pour chaque entrée, cliquez sur Afficher le certificat.
- Dans l'onglet Détails, sélectionnez tous les champs suivants :
- Accès aux informations d'autorité
- Points de distribution CRL
Pour chaque champ, les URL apparaissent dans la zone d'affichage en bas de la boîte de dialogue.
- Sélectionnez chacune de ces entrées de chemin de certification :
Générer le fichier clé d'enregistrement de l'agent Robots
Si vous venez d'installer l'Agent Robots pour la première fois, vous devez générer un fichier de clé d'enregistrement (registration.key). Le fichier de clé d'enregistrement authentifie la première connexion entre l'Agent Robots et l'application Robots.
Si vous êtes déjà client et que vous avez déjà installé et utilisé un Agent Robots, il n'est généralement pas nécessaire de générer un nouveau fichier de clé d'enregistrement. La génération d'un nouveau fichier est souvent inutile et peut perturber la configuration de l'instance Robots de votre organisation.
Statut de l'Agent Robots | Générer un fichier de clé d'enregistrement |
---|---|
Nouvelle installation de l'Agent Robots, installation à un seul agent | Oui |
Nouvelle installation d'une instance supplémentaire de l'Agent Robots dans un cluster multi-agents |
Non Copier le fichier de clé d'enregistrement existant Pour plus d'informations, consultez la section Installer une instance supplémentaire de l'agent Robots. |
Mettre à niveau un Agent Robots actuellement installé |
Non Le fichier de clé d'enregistrement n'est pas concerné par la mise à niveau |
Problème avec un fichier de clé d'enregistrement existant ; l'Agent Robots ne peut pas se connecter à l'application Robots. | Oui |
Changer le compte Windows qui exécute un Agent Robots actuellement installé |
Non Le fichier de clé d'enregistrement n'est pas concerné par le changement de compte Pour plus d'informations, consultez la section Changer le compte de service 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.
- Connectez-vous à Diligent One (www.highbond.com).
- Depuis la page d’accueil de la barre de lancement, sous Audit et analyses de données, sélectionnez l’application Robots.
- Dans le coin supérieur droit du tableau de bord, cliquez sur Paramètres.
- Dans le panneau gauche, assurez-vous que Gestion de l'agent est sélectionné.
- Si l'instance de Robots utilise actuellement un Agent Robots basé dans le cloud, procédez comme suit :
- Cliquez sur Remplacer l'agent cloud.
- Cliquez sur Enregistrer un agent et générer la clé.
- Si l'instance de Robots utilise actuellement un Agent Robots sur site, ou si aucun Agent Robots n'est indiqué, procédez comme suit :
- 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.
Cliquez sur Générer une nouvelle clé d'inscription.
- Cliquez sur Générer une nouvelle clé d'inscription.
- 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é.
- 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.
Installer l'agent Robots
Utilisez le package d'installation de l'Agent Robots pour effectuer une installation rafraichie de l'Agent Robots.
Remarque
Vous devez avoir des autorisations d'administrateur local sur le serveur Windows pour terminer l'installation.
Si vous utilisez différents comptes Windows pour l'installation de l'Agent Robots et pour l'exécution du service de l'Agent Robots, assurez-vous que vous disposez du mot de passe du compte de service de l'Agent Robots avant de commencer l'installation.
Télécharger le package d'installation
- Téléchargez le package d'installation de l'agent Robots (RobotsAgent17.exe) à partir de la barre de lancement :
- Connectez-vous à Diligent One (www.highbond.com).
- Dans la barre de lancement, sous Audit et analyses, cliquez sur la brique Analytics pour accéder aux téléchargements.
- Dans le menu supérieur, cliquez sur Agent Robots.
- Cliquez sur Télécharger la version 17.
- Lorsque le package d'installation est téléchargé sur votre serveur Windows, double-cliquez sur le package d'installation.
-
Si une boîte de dialogue d'avertissement de sécurité s'affiche, vérifiez les informations indiquées et cliquez sur Oui.
Astuce
La boîte de dialogue d'avertissement de sécurité peut être masquée derrière d'autres fenêtres que vous avez ouvertes.
Extraire et exécuter le programme d'installation
- Sélectionnez la langue que vous voulez utiliser pour votre installation, puis cliquez sur OK.
- Sur la page Configurer l'emplacement de l'installation, indiquez le dossier dans lequel les fichiers d'installation seront extraits, puis cliquez sur Extraire.
Vous pouvez cliquer sur Parcourir pour sélectionner un dossier, ou accepter l'emplacement par défaut :
C:\Users\nom_compte_utilisateur\Downloads\ACL Installers\RobotsAgent17
Les fichiers de configuration sont extraits vers le dossier de destination que vous avez indiqué. Le programme d'installation se lance automatiquement après l'extraction des fichiers.
Commentaires
Si le programme d'installation ne parvient pas à se lancer automatiquement pour une raison quelconque, accédez au dossier où les fichiers de configuration ont été extraits depuis l'explorateur Windows et double-cliquez sur setup.exe.
Installer les logiciels prérequis, si nécessaire
Si vous êtes invité(e) à installer des composants requis, cliquez sur Installer.
Après leur installation, le programme d'installation se poursuit automatiquement.
Pour obtenir la liste des conditions préalables, consultez la section Configuration minimale requise pour l'agent Robots sur site.
Configurer les propriétés d'installation
- Sur la page Bienvenue, cliquez sur Suivant.
- Sur la page Accord de licence, sélectionnez J'accepte les conditions générales ci-dessus, puis cliquez sur Suivant.
- Sur la page Sélection de l'édition d'agent Robots, sélectionnez l'édition à installer et cliquez sur Suivant :
- Non Unicode
- Unicode
Attention
Assurez-vous que vous installez l'édition adéquate pour votre entreprise. Pour ouvrir les tables de l'Agent Robots dans Analytics, les éditions doivent correspondre.
Si vous paramétrez un cluster multiagents, tous les agents du cluster doivent avoir la même édition. Tous non-unicode ou tous unicode.
Pour plus d'informations, consultez la rubrique Produits Unicode Diligent.
- Dans la page Connecteurs de données Analytics facultatives, laissez l'option Installer sélectionnée à moins que vous n'ayez un motif pour ne pas installer les connecteurs facultatifs et cliquez sur Suivant.
Remarque
Si vous choisissez de ne pas installer les connecteurs facultatifs et souhaitez ultérieurement en utiliser un, vous devez désinstaller et réinstaller l'agent Robots.
- Dans la page Activer le machine learning, laissez l'option Activer sélectionnée à moins que vous n'ayez un motif pour ne pas installer le moteur Python et cliquez sur Suivant.
Remarque
Si vous choisissez de ne pas installer le moteur Python et souhaitez l'utiliser ultérieurement pour exécuter des commandes de machine learning, vous devez désinstaller et réinstaller l'agent Robots.
- Dans la page Paramètres des services d'agent Robots, renseignez les paramètres du compte de service suivant puis cliquez sur Suivant :
- Numéro de port du service de données Robots Indiquez un port pour le service de données ou utilisez la valeur par défaut 10000.
Vous pouvez indiquer n'importe quel port compris entre 0 et 65536.
- Compte du service de l'Agent Robots Sélectionnez un compte de domaine existant pour exécuter le service de l'Agent Robots et indiquez le mot de passe.
Le compte doit correspondre à un compte de domaine, indiqué à l'aide du formulaire Domain\service_account. Le compte requiert une autorisation spécifique pour exécuter les services dans le système d'exploitation du serveur Windows ainsi qu'un accès complet au dossier de données que vous avez indiqué pendant l'installation. Pour plus d'informations, consultez la section Sécurité de l'agent Robots sur site.
Remarque
Si nécessaire, vous pouvez modifier le compte de service de l'Agent Robots après l'installation.
- Numéro de port du service de données Robots Indiquez un port pour le service de données ou utilisez la valeur par défaut 10000.
-
Si vous êtes invité à accorder le droit Se connecter en tant que service sur le compte de service de l'Agent Robots, cliquez sur Oui, puis sur OK.
- Dans la page Dossiers de destination, renseignez les paramètres de connexion et de destination suivants puis cliquez sur Suivant :
- Dossiers de destination de l'agent Robots
- Sélectionnez un dossier de destination pour l'installation de l'agent Robots ou utilisez l'emplacement par défaut.
Par défaut : C:\Program Files (x86)\ACL Software\Robots Agent\
- Sélectionnez un emplacement de dossier de données ou utilisez l'emplacement par défaut.
Par défaut : C:\acl\robots\
Commentaires
Ne placez pas votre dossier de données dans le dossier de destination de l'installation ou dans un autre à proximité. Vous risqueriez de perdre les données lors de la désinstallation de l'agent Robots.
- Sélectionnez un dossier de destination pour l'installation de l'agent Robots ou utilisez l'emplacement par défaut.
- Emplacement du fichier d'enregistrement de l'agent Robots
- Sélectionnez Copier le fichier d'enregistrement puis accédez à l'emplacement où vous avez sauvegardé le fichier registration.key, ou saisissez le chemin d'accès au fichier manuellement.
Pendant l'exécution, le programme d'exécution copie automatiquement le fichier clé dans l'emplacement approprié de la structure de répertoires de l'agent Robots.
Remarque
Laissez la case Copier le fichier d'enregistrement décochée et n'indiquez pas de fichier d'enregistrement si vous prévoyez de modifier le compte de service de l'Agent Robots après l'installation de l'Agent Robots.
- Sélectionnez Copier le fichier d'enregistrement puis accédez à l'emplacement où vous avez sauvegardé le fichier registration.key, ou saisissez le chemin d'accès au fichier manuellement.
- Dossiers de destination de l'agent Robots
Terminer l'installation
- Sur la page Prêt à installer le programme, cliquez sur Installer.
L'Agent Robots est installé.
- Si une invite vous propose d'installer le moteur de base de données Microsoft Access, effectuez l'une des actions suivantes :
- Cliquez sur Oui pour installer le moteur de base de données si vous souhaitez que l'Agent Robots importe depuis, ou exporte vers, d'anciens fichiers Excel (*.xls) ou Microsoft Access (*.mdb).
- Cliquez sur Non pour exclure le moteur de base de données si vous utilisez l'Agent Robots seulement avec la génération actuelle de fichier Excel (*.xlsx), et que vous n'utilisez pas de fichiers Excel antérieurs, ni de fichiers Microsoft Access. Le moteur de base de données peut causer des problèmes d'incompatibilité avec d'autres produits Microsoft Office plus récents. C'est pourquoi nous vous conseillons d'exclure le moteur de base de données, sauf si vous en avez besoin.
- Une fois l'installation achevée, cliquez sur Terminer.
Confirmer que le service de l'Agent Robots est en cours d'exécution
Le service de l'Agent Robots doit être en cours d'exécution pour que l'Agent Robots puisse se connecter à l'application Robots. Sans connexion, l'Agent Robots ne peut pas traiter les tâches et les scripts du robot.
Si nécessaire, vous pouvez changer le compte de service de l'Agent Robots au moment même où vous confirmez que le service de l'Agent Robots est en cours d'exécution.
Utilisez le compte de service de l'Agent Robots que vous avez indiqué lors de l'installation.
- Ouvrez le Gestionnaire des services Windows.
-
Vérifiez que les deux services Windows de l'Agent Robots sont en cours d'exécution :
- Agent Robots
- Service de données Robots
Si nécessaire, démarrez un service ou les deux.
Remarque
Si un message d'erreur apparaît et indique que le service de l'Agent Robots a démarré, puis qu'il s'est arrêté, il se peut que l'enregistrement de l'Agent Robots ait échoué.
Vérifiez que le fichier de clé d'enregistrement (registration.key) est disponible dans le répertoire d'installation de l'Agent Robots. Si le fichier de clé d'enregistrement n'y figure pas, copiez manuellement le fichier de clé de l'emplacement où vous l'avez enregistré vers le répertoire d'installation. Essayez à nouveau de démarrer le service de l'Agent Robots.
Le répertoire d'installation par défaut est : C:\Program Files (x86)\ACL Software\Robots Agent\agent
- 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
- 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é.
Changer le compte de service de l'Agent Robots
Procédez aux étapes suivantes si vous avez laissé la case Copier le fichier d'enregistrement décochée lors de l'installation de l'Agent Robots et que vous souhaitez modifier le compte de service de l'Agent Robots.
Installez le fichier clé d'enregistrement manuellement
- Copiez le fichier de clé d'enregistrement (registration.key) depuis l'emplacement où vous l'avez enregistré.
- 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.
Remplacer le compte de service de l'Agent Robots par un autre compte
- Ouvrez le Gestionnaire des services Windows.
- Effectuez un clic droit sur le service de l'Agent Robots et sélectionnez Propriétés.
- Dans l'onglet Connexion, cliquez sur Parcourir.
- Dans la boîte de dialogue Sélectionner un utilisateur, dans le champ Entrer le nom de l'objet à sélectionner, saisissez le nom du compte de service que vous souhaitez utiliser et cliquez sur Vérifier les noms.
Le compte de service devrait être prérempli dans le champ.
- Cliquez sur OK.
- Dans l'onglet Connexion, saisissez et confirmez le mot de passe du compte de service, puis cliquez sur OK.
- Dans le Gestionnaire des services Windows, redémarrez (ou démarrez) le service de l'Agent Robots.
- Au besoin, démarrez le Service de données Robots.
Confirmer l'enregistrement de l'Agent Robots
- 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
- 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é.
Configurer les paramètres de l'Agent Robots dans l'application Robots
Si cela s'avère nécessaire pour votre organisation, dans l'application Robots, mettez à jour les valeurs par défaut pour les deux paramètres de configuration de l'Agent Robots :
- Chargements de fichiers autorisés Contrôle si les résultats obtenus sont chargés de l'agent Robots vers l'application Robots dans le cloud :
- Configuration de chemins d'accès Indique le serveur Windows ou les répertoires réseau pour les tables de données Analytics et les tables de résultat.
Pour plus d'informations, consultez la section Configurer un agent Robots sur site.
Tester l'agent Robots
Une fois que vous avez installé l'agent Robots, vous pouvez transmettre et exécuter un script simple afin de tester le bon fonctionnement de l'agent Robots.
Remarque
Ce test exige que les chargements de fichier vers Robots soient autorisés. Si nécessaire, activez temporairement les chargements de ficher pour le test. Pour plus d'informations, consultez la section Configurer un agent Robots sur site.
Créer un projet Analytics et télécharger le fichier test
- Créez un nouveau projet Analytics, intitulé Test agent Robots.acl.
- Faites un clic droit sur le lien ci-dessous et enregistrez le fichier dans le même dossier que celui du projet que vous venez de créer :
Copier le script du test
- Dans le projet Analytics, créez un nouveau script intitulé Test_agent_Robots_script.
- Cliquez sur le lien ci-dessous pour ouvrir le script de test dans un navigateur :
- Appuyez sur Ctrl+A pour sélectionner l'intégralité du test et sur Ctrl+C pour le copier dans le presse-papiers.
- Collez le script dans Test_agent_Robots_script et cliquez sur Enregistrer le projet en cours .
Transmettre le script à Robots et créer un robot à la volée
- Dans le menu principal d'Analytics, sélectionnez Fichier > Transmettre les scripts.
- Si nécessaire, dans la boîte de dialogue Sélectionner la destination, double-cliquez sur l'instance Diligent One appropriée.
La collection Robot s'affiche avec la liste des robots existants, le cas échéant. Un robot correspond à un conteneur pour les scripts, les données et les tâches automatisées.
- Saisissez Test Robot dans le champ Nouveau robot et cliquez sur Créer.
Le robot est créé et un ID robot est généré automatiquement.
- Dans la boîte de dialogue Transmettre les scripts, saisissez un message de transmission tel que « Chargement du script test » et cliquez sur OK.
Le script est transmis à Robots et localisé dans le robot que vous venez de créer.
- Dans la boîte de dialogue Transmission des scripts réussie, cliquez sur le second lien.
Résultat L'application Robots s'ouvre dans une fenêtre du navigateur où l'onglet Versions du script est sélectionné. Il est possible que vous deviez vous connecter à Diligent One. Vous devez voir la version du script que vous venez de transmettre.
- Dans Analytics, cliquez sur OK pour quitter la boîte de dialogue Transmission des scripts réussie.
Charger le fichier test
- Dans Robots, sélectionnez l'onglet Entrée/Sortie.
- Cliquez sur parcourir votre ordinateur et accédez à l'emplacement dans lequel vous avez enregistré Test_agent_Robots_file.txt.
- Sélectionnez le fichier et cliquez sur Ouvrir.
Résultat Le fichier est chargé et s'affiche sous Fichiers dans l'onglet Entrée/Sortie.
Créer une tâche et exécuter le script test
- Sélectionnez l'onglet Tâches et cliquez sur Créer la tâche.
- Saisissez le nom Tâche test pour la tâche puis cliquez sur Enregistrer.
- Sélectionnez Script test de l'agent Robots et cliquez sur Ignorer jusqu'à la fin > Confirmer et créer une tâche.
- Dans l'onglet Tâches, au niveau de l'option Tâche test, cliquez sur > Exécuter maintenant.
Résultat La tâche incluant le script test s'exécute.
Si la tâche se termine avec le statut Réussi, l'agent Robots sur site que vous avez installé fonctionne correctement.
Commentaires
En cas d'échec de la tâche, vérifiez que le service de l'Agent Robots s'exécute sur le serveur sur lequel vous avez installé l'Agent Robots. Démarrez le service s'il ne fonctionne pas et essayez à nouveau d'exécuter Tâche test.
Si l'échec persiste, contactez l'assistance Diligent pour obtenir de l'aide.
Vérifier l'édition du script
Vérifiez les emplacements suivants dans Robots afin de vous assurer que le script test s'applique aux fichiers corrects.
Emplacement dans Robots | Fichiers édités par le script test |
---|---|
Onglet Exécutions de tâche Sélectionnez l'entrée Tâche test. |
Dans le panneau latéral Détails de l'exécution de la tâche, sous Édition :
|
Onglet Onglet Entrée/Sortie Sélectionnez l'entrée Test_agent_Robots_file. |
Dans la section Autres tables :
Sélectionnez Test_agent_Robots_file. Dans le panneau latéral Détails de la table, sous Champs : Vous devez voir les informations sur le nom, le type, et la taille (longueur) pour trois champs :
|
Mettre à niveau l'agent Robots
Utilisez le package d'installation de l'agent Robots pour procéder à la mise à niveau d'une installation existante de l'agent Robots vers la version 17.0.
Avant d'effectuer la mise à niveau, assurez-vous qu'aucune tâche du robot n'est en cours d'exécution, en file d'attente ou planifiée pour une exécution prochaine.
Remarque
Vous devez avoir des autorisations d'administrateur local sur le serveur Windows pour terminer la mise à niveau.
Arrêter les services Windows de l'Agent Robots
- Sur le serveur Windows où se trouve l'Agent Robots, ouvrez le gestionnaire de services Windows.
- Arrêtez les deux services Windows de l'Agent Robots :
- Agent Robots
- Service de données Robots
Télécharger le package d'installation
- Téléchargez le package d'installation de l'agent Robots (RobotsAgent17.exe) à partir de la barre de lancement :
- Connectez-vous à la Barre de lancement (www.highbond.com).
- Sous Ressources, cliquez sur Téléchargements.
- Dans le menu supérieur, cliquez sur Agent Robots.
- Cliquez sur Télécharger la version 17.
- Lorsque le package d'installation est téléchargé sur le serveur Windows, double-cliquez sur le package d'installation.
-
Si une boîte de dialogue d'avertissement de sécurité s'affiche, vérifiez les informations indiquées et cliquez sur Oui.
Astuce
La boîte de dialogue d'avertissement de sécurité peut être masquée derrière d'autres fenêtres que vous avez ouvertes.
Extraire et exécuter le programme d'installation
- Sélectionnez la langue que vous voulez utiliser pour votre installation, puis cliquez sur OK.
- Sur la page Configurer l'emplacement de l'installation, indiquez le dossier dans lequel les fichiers d'installation seront extraits, puis cliquez sur Extraire.
Vous pouvez cliquer sur Parcourir pour sélectionner un dossier, ou accepter l'emplacement par défaut :
C:\Users\nom_compte_utilisateur\Downloads\ACL Installers\RobotsAgent17
Les fichiers de configuration sont extraits vers le dossier de destination que vous avez indiqué. Le programme d'installation se lance automatiquement après l'extraction des fichiers.
Commentaires
Si le programme d'installation ne parvient pas à se lancer automatiquement pour une raison quelconque, accédez au dossier où les fichiers de configuration ont été extraits depuis l'explorateur Windows et double-cliquez sur setup.exe.
- Cliquez sur Oui dans l'invite de mise à niveau.
- Dans la boîte de dialogue Informations sur le programme d'installation de l'Agent Robots, cliquez sur OK seulement si vous avez respecté les exigences indiquées.
Si vous n'avez pas encore satisfait à ces exigences, faites-le maintenant avant de poursuivre la mise à niveau. Au besoin, désactivez temporairement les tâches du robot dont l'exécution est prévue prochainement.
Installer les logiciels prérequis, si nécessaire
Si vous êtes invité(e) à installer des composants requis, cliquez sur Installer.
Après leur installation, le programme d'installation se poursuit automatiquement.
Pour obtenir la liste des conditions préalables, consultez la section Configuration minimale requise pour l'agent Robots sur site.
Configurer les propriétés d'installation
- Sur la page Bienvenue, cliquez sur Suivant.
- Sur la page Accord de licence, sélectionnez J'accepte les conditions générales ci-dessus, puis cliquez sur Suivant.
- À la page Sélection de l'édition d'agent Robots, cliquez sur Suivant.
Le programme d'installation applique l'édition de l'Agent Robots qui est actuellement installée (non-Unicode ou Unicode).
Remarque
Vous ne pouvez pas modifier l'édition lors d'une mise à niveau. Pour modifier l'édition, vous devez désinstaller la version actuelle de l'agent Robots, puis installer la version 17.0.
- Dans la page Connecteurs de données Analytics facultatives, laissez l'option Installer sélectionnée à moins que vous n'ayez un motif pour ne pas installer les connecteurs facultatifs et cliquez sur Suivant.
Remarque
Si vous choisissez de ne pas installer les connecteurs facultatifs et souhaitez ultérieurement en utiliser un, vous devez désinstaller et réinstaller l'agent Robots.
- Dans la page Activer le machine learning, laissez l'option Activer sélectionnée à moins que vous n'ayez un motif pour ne pas installer le moteur Python et cliquez sur Suivant.
Remarque
Si vous choisissez de ne pas installer le moteur Python et souhaitez l'utiliser ultérieurement pour exécuter des commandes de machine learning, vous devez désinstaller et réinstaller l'agent Robots.
- Dans la page Paramètres des services d'agent Robots, renseignez les paramètres du compte de service suivant puis cliquez sur Suivant :
- Numéro de port du service de données Robots Gardez le port existant spécifié pour le service de données ou indiquez un port différent.
Vous pouvez indiquer n'importe quel port compris entre 0 et 65536.
- Compte du service de l'Agent Robots Conservez le compte de domaine existant qui exécute le service de l'Agent Robots ou indiquez un compte différent. Saisissez le mot de passe du compte.
Le compte doit correspondre à un compte de domaine, indiqué à l'aide du formulaire Domain\service_account. Le compte requiert une autorisation spécifique pour exécuter les services dans le système d'exploitation du serveur Windows ainsi qu'un accès complet au dossier de données de l'agent Robots. Pour plus d'informations, consultez la section Sécurité de l'agent Robots sur site.
Remarque
Si vous devez modifier le compte de service de l'Agent Robots, mieux vaut le faire après la mise à niveau.
Si vous changez le compte dans le programme d'installation au cours de la mise à niveau, vous devez enregistrer à nouveau l'Agent Robots. Le nouvel enregistrement d'un agent installé peut perturber la configuration de l'instance Robots de votre organisation.
Pour plus d'informations, consultez la section Changer le compte de service de l'Agent Robots.
- Numéro de port du service de données Robots Gardez le port existant spécifié pour le service de données ou indiquez un port différent.
- Vérifiez les informations de configuration dans l'écran suivant et cliquez sur Suivant.
Effectuer la mise à niveau
- Sur la page Prêt à installer le programme, cliquez sur Installer.
L'Agent Robots est mis à niveau.
- Si une invite vous propose d'installer le moteur de base de données Microsoft Access, effectuez l'une des actions suivantes :
- Cliquez sur Oui pour installer le moteur de base de données si vous souhaitez que l'Agent Robots importe depuis, ou exporte vers, d'anciens fichiers Excel (*.xls) ou Microsoft Access (*.mdb).
- Cliquez sur Non pour exclure le moteur de base de données si vous utilisez l'Agent Robots seulement avec la génération actuelle de fichier Excel (*.xlsx), et que vous n'utilisez pas de fichiers Excel antérieurs, ni de fichiers Microsoft Access. Le moteur de base de données peut causer des problèmes d'incompatibilité avec d'autres produits Microsoft Office plus récents. C'est pourquoi nous vous conseillons d'exclure le moteur de base de données, sauf si vous en avez besoin.
- Une fois la mise à niveau achevée, cliquez sur Terminer.
- Cliquez sur Oui pour redémarrer le serveur et terminer la mise à niveau.
-
Dans le gestionnaire de services Windows, vérifiez que les services Windows Agent Robots sont exécutés :
- Agent Robots
- Service de données Robots
Si nécessaire, démarrez un service ou les deux services.
Installer une instance supplémentaire de l'agent Robots
Utilisez le package d'installation de l'agent Robots pour installer des instances supplémentaires de l'agent Robots sur d'autres serveurs Windows.
Grâce à l'installation de plusieurs agents, vous pouvez augmenter la capacité de traitement d'analyse de données et implémenter un équilibrage de charge entre les agents. Lorsque vous exécutez plusieurs tâches de robot simultanément, le traitement des scripts d'analyse de données est automatiquement réparti entre les différents agents sur les multiples serveurs Windows. Cette fonctionnalité vous permet d'exécuter un plus grand nombre de tâches dans une période de temps plus courte.
Remarque
La fonctionnalité d'agent multiple n'est pas liée aux modes développement et production dans Robots. Lorsque vous exécutez des tâches, les deux modes ont un accès identique à tous les agents.
Important
L'installation de plusieurs agents exige que tous les agents disposent de la version 15 ou supérieure et qu'ils utilisent tous le même encodage : tous non-Unicode ou tous Unicode.
Tous les agents doivent aussi pouvoir accéder au(x) répertoire(s) spécifiés pour les tables de sortie de script à l'écran Gestion de l'agent. Pour chaque répertoire spécifié, le compte de service exécutant l'agent doit présenter des autorisations en Lecture/Ecriture/Liste. Pour plus d'informations, consultez la section Configurer un agent Robots sur site.
Remarque
Vous devez avoir des autorisations d'administrateur local sur chaque serveur Windows sur lequel vous installez l'Agent Robots.
Ces instructions se rapportent à Serveur #1 et Serveur #2 :
- Serveur #1 Serveur Windows sur lequel vous avez installé la première instance de l'agent Robots
- Serveur #2 Serveur Windows supplémentaire sur lequel vous installez une instance supplémentaire de l'agent Robots
Remarque
Vous pouvez répéter le processus pour autant d'agents et serveurs supplémentaires que nécessaire.
Installer l'agent Robots sur le serveur #2
- Sur le serveur #2, exécutez le même processus d'installation que celui utilisé pour l'installation de l'agent Robots sur le serveur #1.
-
Dans la page Dossiers de destination du programme d'installation, ne sélectionnez pas Copier le fichier d'enregistrement et ne renseignez pas le champ Emplacement du fichier d'enregistrement de l'Agent Robots.
Pour les étapes d'installation, voir Installer l'agent Robots.
Récupérer le nom de la clé RSA depuis l'application Robots
- Connectez-vous à Diligent One (www.highbond.com).
- Depuis la page d’accueil de la barre de lancement, sous Audit et analyses de données, sélectionnez l’application Robots.
- Dans le coin supérieur droit du tableau de bord, cliquez sur Paramètres.
- Dans le panneau gauche, assurez-vous que Gestion de l'agent est sélectionné.
- Cliquez sur Comment ajouter des agents supplémentaires.
- Cliquez sur pour copier le nom de clé RSA dans le presse-papier.
- Collez le nom de clé RSA dans le fichier texte pour un stockage temporaire.
Groupe la clé RSA de l'agent Robots dans un fichier
Utilisez l'utilitaire EncryptionKeyCLI.exe sur le serveur #1 pour grouper la clé RSA de l'agent Robots dans un fichier.
Remarque
Si vous avez déjà installé un autre agent Robots et créé un fichier zip qui contient la clé RSA, utilisez le fichier existant. Vous n'avez pas besoin de créer une autre copie.
- Sur le serveur #1, ouvrez l'invite de commande Windows en tant qu'administrateur.
- Exécutez la commande suivante pour modifier le répertoire d'installation de l'agent Robots :
cd C:\Program Files (x86)\ACL Software\Robots Agent\agent
Indiquez le chemin d'accès approprié si vous n'avez pas installé l'agent Robots dans le répertoire par défaut.
- Exécutez la commande suivante pour grouper la clé RSA de l'agent Robots dans un fichier zip :
EncryptionKeyCLI.exe export RSAKeyfile ACL_XXXXXXXX
For ACL_XXXXXXXX , remplacez le nom actuel de la clé RSA que vous avez copié dans l'écran Gestion de l'agent dans Robots.Vous pouvez attribuer n'importe quel nom de fichier, sans espace, à
RSAKeyfile. Vous pouvez éventuellement spécifier un chemin de fichier vers un dossier existant sur le serveur. Si le chemin contient des espaces, entourez le chemin et le nom de fichier entiers de guillemets doubles.
- Si besoin, saisissez Y pour écraser un fichier existant.
Résultat La clé RSA est groupée dans un fichier zip et enregistré à l'emplacement par défaut (C:\ProgramData\robots\RSAKeyfile.zip) ou à l'emplacement que vous avez spécifiée.
Remarque
Si vous ne voyez pas le dossier ProgramData, c'est qu'il est peut-être masqué. Pour rendre le dossier visible, dans l'Explorateur de fichiers Windows, sélectionnez Éléments masqués dans le répertoire racine C:\ (onglet Vue > Éléments masqués).
Migrer le fichier de clé RSA vers le serveur #2
L'utilitaire EncryptionKeyCLI.exe disponible sur le serveur #2 vous permet d'extraire la clé RSA de l'agent Robots depuis le fichier zip et de l'importer vers le magasin de clés Microsoft.
- Copiez RSAKeyfile.zip du serveur #1 vers le répertoire d'installation de l'agent Robots sur le serveur #2.
Le répertoire d'installation par défaut est : C:\Program Files (x86)\ACL Software\Robots Agent\agent
- Sur le serveur #2, ouvrez l'invite de commande Windows en tant qu'administrateur.
- Exécutez la commande suivante pour modifier le répertoire d'installation de l'agent Robots :
cd C:\Program Files (x86)\ACL Software\Robots Agent\agent
Indiquez le chemin d'accès approprié si vous n'avez pas installé l'agent Robots dans le répertoire par défaut.
- Exécutez la commande suivante pour extraire la clé RSA de l'agent Robots du fichier zip et importez-la vers le magasin de clés Microsoft sur le serveur #2 :
EncryptionKeyCLI.exe import RSAKeyfile
Si vous n'utilisez pas RSAKeyfile comme nom du fichier zip, remplacez le nom que vous avez utilisé.
Copier le keyfile d'enregistrement vers le serveur #2
Copiez le keyfile d'enregistrement (registration.key) du repertoire d'installation de l'agent Robots sur le serveur #1 vers le répertoire d'installation de l'agent Robots sur le serveur #2.
Le répertoire d'installation par défaut est : C:\Program Files (x86)\ACL Software\Robots Agent\agent
Relancer le service de l'agent Robots Agent sur le serveur #2
Sur le serveur #2, ouvrez le Gestionnaire des services Windows et relancez (ou lancez) le service de l'Agent Robots.
Vérifier que l'agent supplémentaire a été correctement enregistré
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é. L'agent fait désormais partie du cluster d'agents utilisé pour le traitement d'analyse de données et l'équilibrage de charge.