Tâches d'administration des agents de gestion dans les instances de calcul
Vous pouvez effectuer différentes tâches d'administration lorsque des agents de gestion sont déployés sur des instances de calcul.
Désactiver les agents de gestion sur les instances de calcul
Lorsque vous utilisez une instance de calcul, vous pouvez utiliser les capacités d'Oracle Cloud Agent pour désactiver le plugiciel d'agent de gestion.
L'agent de gestion peut être désactivé à l'aide de la console OCI ou des API de calcul.
Avant de continuer, vérifiez que vous avez effectué les tâches préalables requises décrites dans Exécuter les préalables au déploiement d'agents de gestion sur des instances de calcul.
- Supprimez les répertoires suivants sur le disque en tant qu'utilisateur disposant de privilèges élevés :
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris /var/lib/oracle-cloud-agent/plugins/oci-managementagent/download
Ce qui précède ne devrait être fait que si vous avez cessé d'utiliser l'agent de gestion et que vous n'avez pas l'intention de le ressusciter à l'avenir. Si vous prévoyez d'utiliser l'agent de gestion ultérieurement, activez la mise à niveau automatique ou obtenez-le régulièrement mis à niveau manuellement.
Désactiver l'agent de gestion à l'aide de la console
- Ouvrez le menu de navigation et cliquez sur Calcul. Sous Calcul, cliquez sur Instances.
- Cliquez sur l'instance qui vous intéresse.
- Cliquez sur l'onglet Oracle Cloud Agent.
- Activez/désactivez le commutateur Désactivé pour le plugiciel d'agent de gestion.
Désactiver l'agent de gestion à l'aide de l'API de calcul
Pour des informations sur l'utilisation de l'API, voir API REST.
Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.
-
LaunchInstance - Active ou désactive les plugiciels, ou arrête tous les plugiciels, lorsque vous créez une instance.
-
UpdateInstance - Active ou désactive des plugiciels individuels et arrête ou démarre tous les plugiciels pour une instance existante.
Voici un extrait de l'exemple Java compris dans les opérations d'API LaunchInstance
ou UpdateInstance
, qui permet à l'utilisateur d'activer l'agent de gestion lors du lancement ou de la mise à jour de l'instance de calcul, respectivement :
...
.agentConfig(LaunchInstanceAgentConfigDetails.builder()
.isMonitoringDisabled(false)
.isManagementDisabled(true)
.areAllPluginsDisabled(false)
.pluginsConfig(new ArrayList<>(Arrays.asList(InstanceAgentPluginConfigDetails.builder()
.name("Management Agent")
.desiredState(InstanceAgentPluginConfigDetails.DesiredState.esiredState.Disabled).build()))).build())
...
Où .name("Management Agent")
indique que le plugiciel d'agent de gestion est concerné et .desiredState(InstanceAgentPluginConfigDetails.DesiredState.Disabled).build()))).build())
indique de désactiver le plugiciel d'agent de gestion.
Mettre à niveau les agents de gestion sur les instances de calcul
Mise à niveau manuelle
- L'agent de gestion est activé à partir de l'interface d'Oracle Cloud Agent.
- Les politiques requises ont été configurées correctement pour que l'agent de gestion soit entièrement fonctionnel.
sudo -u oracle-cloud-agent /usr/libexec/oracle-cloud-agent/plugins/oci-managementagent/oci-managementagent -cli -upgrade-native-agent
Mise à niveau automatique
Le service d'agents de gestion prend en charge la mise à niveau automatique.
La fonction d'activation de la mise à niveau automatique est définie au niveau de la location : Les utilisateurs peuvent activer la mise à niveau automatique pour tous les agents de gestion qui résident dans leur location courante.
Statut de mise à niveau automatique par défaut : Désactivez.
Exigences :
-
Autorisation : L'autorisation
MGMT_AGENT_UPDATE
sur le compartiment racine de la location est requise pour activer la fonction de mise à niveau automatique. Utilisez la syntaxe de politique suivante :ALLOW GROUP <group_name> TO USE management-agents IN TENANCY
Pour plus d'informations sur les politiques de l'agent de gestion, voir Informations détaillées sur le service Agent de gestion.
-
Version minimale de l'agent de gestion : 211116.xxxx ou une version supérieure.
Activer la mise à niveau automatique
Vous pouvez activer la mise à niveau automatique à l'aide de la console des agents de gestion.
-
Dans la page d'accueil Agents de gestion, cliquez sur Téléchargements et clés dans le menu de gauche.
Le volet Mise à niveau automatique d'agent s'affiche en haut de la page.
-
Dans le volet Mise à niveau automatique d'agent, cliquez sur Activer la mise à niveau automatique.
La fenêtre Activer la mise à niveau automatique s'affiche.
-
Dans la fenêtre Activer la mise à niveau automatique, cliquez sur OK pour activer la mise à niveau automatique pour tous les agents de gestion de la location courante
Désactiver la mise à niveau automatique
Vous pouvez désactiver la mise à niveau automatique à l'aide de la console des agents de gestion.
-
Dans la page d'accueil Agents de gestion, cliquez sur Téléchargements et clés dans le menu de gauche.
Le volet Mise à niveau automatique d'agent s'affiche en haut de la page.
-
Dans le volet Mise à niveau automatique d'agent, cliquez sur Désactiver la mise à niveau automatique.
La fenêtre Désactiver la mise à niveau automatique s'affiche.
-
Dans la fenêtre Désactiver la mise à niveau automatique, cliquez sur OK pour désactiver la mise à niveau automatique pour tous les agents de gestion de la location courante.
Pour obtenir la liste des commandes d'interface de ligne de commande disponibles pour activer et désactiver la mise à niveau automatique, voir Informations de référence sur les commandes de l'interface de ligne de commande d'Oracle Cloud Infrastructure.
Données d'identification des sources des agents de gestion sur les instances de calcul
Lorsqu'un agent de gestion est exécuté sur une instance de calcul, il doit collecter des données provenant de différentes sources. Dans certains cas, les informations d'identification de ces sources peuvent être nécessaires.
Pour plus d'informations sur la gestion des données d'identification sources, voir Créer et gérer les données d'identification sur l'agent de gestion.
Consulter les journaux et les fichiers de configuration des agents de gestion dans les instances de calcul
L'agent de gestion s'exécute en tant qu'utilisateur du système d'exploitation oracle-cloud-agent
une fois qu'il est activé.
Les répertoires suivants contiennent des fichiers contenant des informations sur le journal et la configuration de votre environnement :
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/log
Répertoire de configuration d'agent :
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config
Répertoire des utilitaires d'agent :
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/bin
Journaux de vérification des agents de gestion sur les instances de calcul
Le service d'agent de gestion prend en charge la journalisation par le service de vérification, qui enregistre automatiquement les appels à tous les points d'extrémité d'API publique d'Oracle Cloud Infrastructure pris en charge en tant qu'événements de journal. Pour plus d'informations, voir Journaux de vérification des agents de gestion.