Installer manuellement le Agent Client Collector sur une Windows machine

Installez manuellement la Agent Client Collector 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.
2. Vérifiez le système d'exploitation et la version de votre serveur.
3. Lors de l'utilisation de Microsoft Internet Explorer, procédez comme suit pour préparer le fichier d'installation d'Agent Client Collector :
   1. Accédez à la Gestionnaire de serveur > Serveur local.
   2. Désactivez l'option Configuration de sécurité renforcée d'Internet Explorer.
   3. Téléchargez le fichier d'installation.
   4. Remplacez l'extension du fichier d'installation .man par .msi

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 à l’extension MID Web Server .

      
      

      

      
      

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

      Tableau 1. Champs des paramètres de connexion à l'extension MID Web Server

      Nom de champ	Description
      Nom/adresse IP de l'extension MID Web Server	Adresse IP de l'extension MID Web Server.
      Port de l'extension MID Web Server	Numéro de port de l'extension MID Web Server. Utilisez un numéro compris entre 1 024 et 49 151.
      Clé API de l'extension MID Web Server	Clé API pour accéder à l'extension MID Web Server.

   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 Agent Client Collector sur un ordinateur Windows.
      Sélectionner un utilisateur existant	Lors de la sélection de 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 ; offre une résilience accrue). Utilisateur de domaine (créé par le personnel informatique). Compte de service géré : entrez le nom du compte de service géré dans le champ Nom d’utilisateur et laissez le champ Mot de passe vide. Compte de service local : entrez LOCALSERVICE le champ Nom d’utilisateur et laissez le champ Mot de passe vide. Compte système local : entrez SYSTEM le champ Nom d’utilisateur et laissez le champ Mot de passe vide.

      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 : livré avec le système de base ; permet d'afficher tous les compteurs de performances dans le système.
      • Se connecter en tant que service : permet de démarrer des services réseau et des services qui s’exécutent en continu, même lorsque personne n’est connecté à la console.
   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 d'Agent Client Collector s'affiche.
   7. Pour activer la liste d'autorisation contenant les vérifications devant s'exécuter après la configuration, cochez la case Activer la liste d'autorisation de la commande d'exécution sur la page qui s'affiche.

      
      

      

      
      

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

      À l'issue de l'installation, cliquez sur Suivant pour 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 locaux Utilisateurs ServiceNow.
      • Service : AgentClientCollector
      • Emplacement du fichier :
        • Par défaut pour l'installation = C:\Program Files\ServiceNow\agent-client-collector
        • Par défaut pour les fichiers de service = C:\ProgramData\ServiceNow\agent-client-collector, qui contient les dossiers cache, config et log.
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 <chemin_fichier_msi> /quiet /qn /norestart ACC_API_KEY=<valeur_clé> ACC_MID=wss://<ip_mid>:<port_websocket>/ws/events ACC_ALLOW_LIST=False

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

4. Pour en configurer plusieurs Serveurs MID avec l’installation silencieuse, exécutez la ligne de commande figurant dans la section Installation silencieuse de la procédure en séparant les valeurs par des virgules, comme suit :
   msiexec /i <chemin_fichier_msi> /quiet /qn /norestart ACC_API_KEY=<valeur_clé> ACC_MID="wss://<mid1_ip>:<port_socket_web1>/ws/events,wss://<ip_mid2>:<port_socket_web2>/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 au socket Web Serveur MID.
   ACC_MID	URL du socket Web Serveur MID.
   DENY_LOCAL_LOGON	Lorsqu’elle 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
   PASSWORD_NEVER_EXPIRES	Lorsqu’il est défini sur True, le mot de passe de l’utilisateur ServiceNow par défaut n’expire jamais. Valeur par défaut : faux
   START_SERVICE	Lorsqu’il est défini sur True, le service démarre automatiquement après l’installation Agent Client Collector . Valeur par défaut : true
   NOM D’UTILISATEUR LOCAL	Nom d’utilisateur du compte avec lequel le Agent Client Collector service est installé et s’exécute.
   MOT DE PASSE LOCAL	Mot de passe de l’utilisateur spécifié dans le paramètre LOCALUSERNAME.

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

   Pour configurer un MID Server secondaire, saisissez la syntaxe suivante dans la section backend-url du fichier acc.yml, conformément à la norme .yml : - "wss://<Adresse IP MID>:<Port du socket Web>/ws/events" (avec les guillemets).

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