Effectuer une mise à niveau à volume Agent Client Collector élevé

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • Effectuez la mise à niveau volumineuse de vos Agent Client Collector agents lorsque vous souhaitez mettre à niveau tous vos agents en même temps.

    Avant de commencer

    Configurez le Agent Client Collector serveur Web. Pour plus de détails, voir Configurez le serveur websocket sur le Serveur MID.

    Assurez-vous que , Serveur MIDServeur Web MID et le serveur websocket sont en cours d’exécutionServeur MID.

    Sélectionnez la version vers laquelle vous souhaitez mettre à niveau votre agent.
    1. Accédez à la Tous > Propriétés système > Toutes les propriétés.
    2. Sélectionnez Nouveau.
    3. Affectez les valeurs suivantes :
      • Nom = sn_agent.agent_upgrade_version
      • Type = chaîne
      • Valeur = numéro de version à mettre à niveau, au format <major_version.minor_version.patch_version>. Par exemple : 4.3.2
    4. Sélectionnez Envoyer.
    Si vous ne sélectionnez pas une version, l’agent effectue automatiquement une mise à niveau vers la version actuelle Cadre de travail d'Agent Client Collector de l’application incluse dans le périmètre.
    Rôles requis : agent_client_collector_admin
    • Dans un Windows environnement : Compte SYSTÈME local
    • Dans un Linux environnement : sudo rpm/dpkg
    • Dans un MacOS environnement : sudo pkg

    Pourquoi et quand exécuter cette tâche

    La mise à niveau à haut volume n’est prise en charge que dans un Windows environnement OR Linux .

    La mise à niveau à volume élevé ne prend pas en charge Agent Client Collector la Serveur MID communication via mTLS.

    Lors d’une mise à niveau de volume élevé, tous les agents qui n’utilisent pas la version la plus récente sont mis à niveau. Aucune mise à niveau n’est effectuée sur les agents qui utilisent déjà la version mise à niveau.

    Aucune mise à niveau n’est effectuée sur les agents qui se trouvent en dehors du périmètre de l’application. Pour en savoir plus, voir Application scope.

    Un agent est exclu des mises à niveau à volume élevé lorsque vous atteignez la limite d’échec de mise à niveau pour un agent. La limite d’échec de mise à niveau est spécifiée dans la sn_agent.auto_upgrade.retry_limit propriété système. La valeur par défaut de cette propriété est 3.
    • Cette propriété s’applique à la fois aux mises à niveau volumineuses et sélectives qui ont échoué.
    • Lorsqu’un agent atteint la limite d’échec de mise à niveau, un Agent Client Collector administrateur peut toujours exécuter la mise à niveau sélective sur l’agent.
    • Vous pouvez réinitialiser manuellement la limite d’échec de mise à niveau en sélectionnant l’option Réinitialiser les tentatives de mise à niveau échouées sur la page de l’agent (sélectionner Tous > Agent Client Collector > Agents et sélectionnez un agent).
    • Après une mise à niveau réussie, l’agent mis à niveau est considéré comme ayant échoué zéro mise à niveau (pour les mises à niveau futures).

    Procédure

    1. Vérifiez que le numéro de version vers lequel vous souhaitez effectuer la mise à niveau est disponible.
      1. Accédez à la Tous > Propriétés système > Toutes les propriétés.
      2. Localisez la sn_agent.agent_version propriété.
        Vérifiez que le numéro de version affiché est une version d’agent valide, représentant la version vers laquelle l’agent sera mis à niveau. Si le numéro de version n’est pas valide, la version est mise à jour sur le sn_agent.agent_version numéro.
    2. Activez la propriété dans la table Propriétés système (Tous > Propriétés système > Toutes les propriétés) pour activer la mise à niveau.
      1. Localisez la sn_agent.auto_upgrade.enabled propriété.
      2. Définissez la valeur de la propriété sur vrai.
        La mise à niveau commence dans la minute qui suit l’activation de la propriété.

    Résultats

    • Pour les agents connectés à : Serveur MID La tâche planifiée met à niveau 50 agents Serveur MID par heure. Le nombre maximal d’agents pouvant être mis à niveau simultanément pour tous est Serveurs MID de 1 000.
    • Pour les agents sans MID : par défaut, la tâche planifiée met à niveau jusqu’à 1 000 agents par heure.
    • Pour les agents et les Serveur MID agents sans MID : pour modifier le nombre d’agents en cours de mise à niveau simultanément, mettez à jour la valeur de la sn_agent.auto_upgrade.max_upgrades_per_handler_per_hour propriété (Tous > Propriétés système > Toutes les propriétés). La valeur par défaut est 1 000.
      Remarque :
      La modification de cette valeur peut avoir un impact négatif sur les performances du système.

    Pour modifier la fréquence de la mise à niveau, mettez à jour la valeur de l’intervalle de répétition dans la tâche planifiée de façon incrémentielle des agents de mise à niveau (Tous > Définition du système > Travaux planifiés).