Installer manuellement sur Agent Client Collector un Windows ordinateur

Installez-le Agent Client Collector manuellement sur un Windows ordinateur lorsque vous souhaitez tester l’agent sur un seul système.

Avant de commencer

1. Assurez-vous d’avoir configuré le Agent Client Collector serveur Web. Pour plus de détails, voir Configurez le serveur websocket sur le Serveur MID.
2. Vérifiez le système d’exploitation et la version de votre serveur.
3. Lorsque vous utilisez Microsoft Internet Explorer, procédez comme suit pour préparer le fichier d’installation Agent Client Collector :
   1. Accédez à la Gestionnaire de serveur > Serveur local.
   2. Désactivez la configuration de la sécurité améliorée d’IE.
   3. Téléchargez le fichier d’installation.
   4. Remplacez l'extension du fichier d'installation .man par .msi

Assurez-vous que .NET Framework 4.6.2 ou version ultérieure est installé sur l’ordinateur cible.

Remarque :

Si .NET Framework ne s’exécute pas efficacement, utilisez le programme d’installation VBSript hérité en exécutant la commande suivante sur l’ordinateur cible : msiexec /i <msi_file_path> /quiet /qn /norestart USE_VBS_CA=1 ACC_API_KEY=<key_value> ACC_MID=wss ://<mid_ip> :<websocket_port>/ws/events ACC_ALLOW_LIST=False

Activez le mode d’image standard pour cloner des agents supplémentaires en définissant la propriété GOLDEN_IMAGE=truemsi .

Rôle requis : agent_client_collector_admin

Procédure

1. Accédez à la Agent Client Collector > Téléchargements de l'agent.
2. Pour effectuer l’installation à l’aide de l’assistant :
   1. Téléchargez le fichier .msi accessible à partir du lien sur l’interface utilisateur.
      L’assistant d’installation s’ouvre.
   2. Sélectionnez Suivant jusqu’à ce que vous atteigniez la page Paramètres de connexion au serveur Web MID .

      
      

      

      
      

   3. Entrez les paramètres pertinents dans les champs de la boîte de dialogue :

      Tableau 1. Champs de paramètres de connexion au serveur Web MID

      Nom de champ	Description
      Nom/adresse IP du serveur Web MID	Adresse IP du serveur Web MID.
      Port de serveur Web MID	Numéro de port du serveur Web MID. Utilisez un numéro entre 1024 et 49151.
      Clé API du serveur Web MID	Clé API permettant d’accéder au serveur Web MID.

   4. Sélectionnez Suivant.
      La page Créer un compte d’utilisateur local s’affiche.

      
      

      

      
      

   5. Sélectionnez l’option pertinente dans la boîte de dialogue.

      Tableau 2. Boîte de dialogue Créer un compte d’utilisateur local

      Option	Description
      Utiliser l’utilisateur par défaut (ServiceNow)	Utilisateur par défaut avec lequel exécuter sur Agent Client Collector un ordinateur Windows. La sélection de cette option crée un utilisateur local appelé servicenow dans le cadre de l’installation. Le mot de passe de l’utilisateur ServiceNow est généré de façon aléatoire et n’est pas stocké dans le système. Un événement de sécurité est créé sur l’ordinateur hôte et, s’il se répète, nécessite l’ouverture d’un ticket de support. Pour plus d’informations , consultez KB1649116 article de la base de connaissances HI.
      Sélectionner un utilisateur existant	Lorsque vous sélectionnez cette option, configurez les sous-champs suivants : Nom d’utilisateur : nom d’utilisateur pour se connecter à l’environnement Windows. Mot de passe : mot de passe de l’utilisateur sélectionné. L’utilisateur peut être l’un des éléments suivants : Utilisateur local (créé par le propriétaire de l’ordinateur virtuel ; fournit une résilience accrue). Utilisateur du domaine (créé par le personnel informatique). Compte de service géré de groupe (gMSA) : saisissez le nom du compte de service géré du groupe dans le champ Nom d’utilisateur et laissez le champ Mot de passe vide. Compte de service local : entrez LOCALSERVICE dans le champ Nom d’utilisateur et laissez le champ Mot de passe vide. Compte système local : saisissez SYSTEM dans le champ Nom d’utilisateur et laissez le champ Mot de passe vide. En raison des restrictions de contrôle de compte d’utilisateur Windows , l’exécution de l’agent en tant que compte SYSTEM local est nécessaire pour effectuer une mise à niveau via msiexec.

      Remarque :

      L’utilisation d’un compte système local crée le groupe ServiceNow Userslocal et ajoute l’utilisateur créé au groupe. Le groupe d’utilisateurs ServiceNow a accès aux Agent Client Collector répertoires et dispose des privilèges suivants :

      • Moniteur de performances : Fourni avec le système de base ; active l’affichage de tous les compteurs de performances du système.
      • Log on as a service (Ouvrir une session en tant que service) : active le démarrage des services réseau et des services qui s’exécutent en continu, même lorsque personne n’est connecté à la console.
      • Programmes de débogage : permet de déboguer les processus et de lire les détails des processus pour les utilisateurs extérieurs au groupe d’utilisateurs ServiceNow .
   6. Sélectionnez Créer un utilisateur.
      Le système crée un utilisateur Windows avec les informations d’identification spécifiées et la page Configuration s’affiche Agent Client Collector .
   7. Pour activer la liste d’autorisation contenant les vérifications activées pour s’exécuter après la configuration, cochez la case Activer la liste d’autorisation de la commande d’exécution sur la page résultante.

      
      

      

      
      

   8. Sélectionnez Suivant pour ouvrir la page d’installation.

      Une fois l’installation terminée, cliquez sur Suivant pour terminer et quitter l’assistant.

      Après une installation réussie, le service démarre automatiquement et génère les éléments suivants :

      • Utilisateur : Par défaut = ServiceNow (un utilisateur existant peut également être configuré pour gérer le service). L’utilisateur ServiceNow appartient au groupe d’utilisateurs local Utilisateurs ServiceNow.
      • Service : AgentClientCollector
      • Emplacement du fichier :
        • Valeur par défaut pour l’installation = C :\Program Files\ServiceNow\agent-client-collector
        • Valeur par défaut pour les fichiers de service = C :\ProgramData\ServiceNow\agent-client-collector, qui contient les dossiers cache, config et journal .
3. Pour exécuter l'installation silencieuse afin de désactiver les rapports d'installation, exécutez la ligne de commande figurant dans la section Installation silencieuse de la procédure, comme suit :
   msiexec /i <msi_file_path> /quiet /qn /norestart ACC_API_KEY=<key_value> ACC_MID=wss ://<mid_ip> :<websocket_port>/ws/events ACC_ALLOW_LIST=False

   Pour activer la liste d’autorisation des vérifications spécifiées lors de l’exécution d’une installation silencieuse, définissez le ACC_ALLOW_LIST paramètre sur Vrai.

4. Pour configurer plusieurs Serveurs MID avec une installation silencieuse, exécutez la ligne de commande apparaissant dans la section Installation silencieuse de la procédure avec des valeurs séparées par des virgules, comme suit :
   msiexec /i <msi_file_path> /quiet /qn /norestart ACC_API_KEY=<key_value> ACC_MID="wss://<mid1_ip> :<websocket1_port>/ws/events,wss ://<mid2_ip> :<websocket2_port>/ws/events »

   Insérez les valeurs de paramètre suivantes dans la commande :

   Tableau 3. Paramètres de commande

   Paramètre	Valeur
   ACC_API_KEY	Clé API utilisée pour accéder à websocket Serveur MID .
   ACC_MID	L’URL du Serveur MID websocket.
   DENY_LOCAL_LOGON	Lorsque la valeur est définie sur True, empêche tout utilisateur autre que l’utilisateur ServiceNow par défaut de se connecter au service. Valeur par défaut : faux
   HTTPS_PROXY	URL complète vers un serveur proxy. Par exemple : https://proxy.url.net
   PAC_FILE	Un chemin d’accès de fichier lisible sur le système. Par exemple : /chemin/vers/servicenow/lisible/fichier
   PASSWORD_NEVER_EXPIRES	Lorsque la valeur est définie sur True, le mot de passe de l’utilisateur ServiceNow par défaut n’expire jamais. Valeur par défaut : faux
   START_SERVICE	Lorsque la valeur est définie sur True, le service démarre automatiquement après l’installation Agent Client Collector . Valeur par défaut : true
   NOM D’UTILISATEUR LOCAL	Compte exécutant en Agent Client Collector tant que Windows service. Valeurs possibles : SYSTÈME SERVICE LOCAL DOMAINE\gMSA$ Chaîne (nom d’utilisateur local) Valeur par défaut = servicenow Lorsque vous utilisez les comptes SYSTEM, LOCALSERVICE ou DOMAIN\gMSA$, vous n’avez pas besoin de configurer un mot de passe.
   MOT DE PASSE LOCAL	Mot de passe de l’utilisateur spécifié dans le paramètre LOCALUSERNAME.

   Les valeurs configurées Serveur MID sont automatiquement ajoutées au fichier acc.yml . L’agent se connecte au premier disponible Serveur MID dans la liste.

   Pour configurer un serveur MID secondaire, entrez la syntaxe suivante dans la section backend-url du fichier acc.yml , conformément à la norme .yml : - « wss://< adresse IP MID> :< port de socket Web >/ws/events » (avec les guillemets).

• Mettre à niveau manuellement sur Agent Client Collector un système Windows
  Effectuez une mise à niveau manuelle de votre version existante Agent Client Collector sur un système exécutant un système d’exploitation Windows.
• Désinstaller manuellement de la Agent Client CollectorWindows machine
  Désinstallez manuellement le d’une Agent Client CollectorWindows machine au lieu d’utiliser la procédure à ligne unique. Utilisez la procédure manuelle si le script de commande n’est pas disponible du fait que l’agent spécifique n’est pas connecté à l’instance.