Pour ouvrir la console Agents de gestion, procédez comme suit :

• Connectez-vous à OCI et ouvrez le menu de navigation à partir de la console OCI.

• Sous Observation & gestion, cliquez sur Agent de gestion.

• Accédez au menu de gauche et sélectionnez un compartiment dans la liste déroulante Compartiment.

  La console Agents de gestion apparaît.

1. Créez un répertoire pour stocker les certificats d'autorité de certification racine (CA) sécurisée supplémentaires au format PEM. Dans l'exemple suivant, le répertoire tmp en est un exemple. Vous pouvez utiliser n'importe quel répertoire et confirmer que l'utilisateur de l'agent dispose d'un accès en lecture à tous les répertoires du chemin des certificats.

   mkdir /tmp/crt

2. Ensuite, entrez la commande suivante pour copier tous les certificats sécurisés personnalisés au format PEM dans le nouveau répertoire créé à l'étape précédente.

   cp *.pem /tmp/crt

3. Définissez les droits d'accès pour le répertoire et son contenu afin de permettre à l'agent autonome d'accéder aux certificats.

   chmod 644 /tmp/crt

4. Pour ajouter des certificats sécurisés personnalisés à l'agent de gestion lors de l'installation ou de la configuration, vous devez indiquer le répertoire des certificats dans le fichier de réponses input.rsp.

   importTrustedCertsDirectory=/tmp/crt

5. Vous pouvez maintenant exécuter l'installation pour importer les certificats dans l'agent de gestion.
6. Après l'installation, vous pouvez utiliser la commande suivante et remplacer les éléments suivants par des valeurs pour votre environnement, afin de vérifier que les certificats sécurisés ont bien été importés dans le fichier de clés de l'agent. Remplacez <CUSTOM_CERTIFICATE_FILE_NAME> par le nom de fichier de certificat personnalisé dans votre environnement, par exemple : my-cert.pem

   keytool -list -keystore /opt/oracle/mgmt_agent/agent_inst/config/security/comm/commwallet.jks -alias <CUSTOM_CERTIFICATE_FILE_NAME>

   Le fichier commwallet.pem est un certificat personnalisé ajouté à la banque de certificats sécurisés de l'agent.

1. Utilisez les commandes suivantes pour créer un répertoire trustedcerts afin d'importer les certificats sécurisés à cet emplacement : /var/lib/oracle-cloud-agent/plugins/oci-managementagent/. Vérifiez que l'utilisateur oracle-cloud-agent est propriétaire du répertoire.

   cd /var/lib/oracle-cloud-agent/plugins/oci-managementagent/
   mkdir trustedcerts
   chown oracle-cloud-agent:oracle-cloud-agent trustedcerts/

2. Copiez tous les certificats sécurisés personnalisés au format PEM dans le nouveau répertoire créé à l'étape précédente.

   cp *.pem /var/lib/oracle-cloud-agent/plugins/oci-managementagent/trustedcerts

3. Vous pouvez maintenant exécuter l'installation de l'agent OCA pour importer les certificats dans l'agent de gestion.
4. Après l'installation, vous pouvez utiliser la commande suivante pour vérifier que les certificats sécurisés ont été correctement importés dans le fichier de clés de l'agent. Remplacez <CUSTOM_CERTIFICATE> par le nom du fichier de certificat personnalisé dans votre environnement, par exemple : my-cert.pem

   keytool -list -keystore /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/security/comm/commwallet.jks -alias <CUSTOM_CERTIFICATE>

   Le fichier commwallet.pem est un certificat personnalisé ajouté à la banque de certificats sécurisés de l'agent.

Vous pouvez déployer un module d'extension de service à l'aide de l'une des méthodes suivantes :

• Déploiement d'un module d'extension à l'aide de la page Agents
• Déploiement d'un module d'extension lors de l'installation de l'agent de gestion

1. Dans le menu de gauche, cliquez sur Agents pour ouvrir la page Agents.

2. Dans la liste Agents, cliquez sur l'agent vers lequel déployer le module d'extension.

   La page de détails de l'agent apparaît.

   
   
   

3. Cliquez sur Déployer les modules d'extension.

   La fenêtre Déployer les modules d'extension apparaît.

4. Sélectionnez le module d'extension et sélectionnez Mettre à jour.

   Désormais, le module d'extension sélectionné sera déployé sur l'agent souhaité.

1. Suivez les instructions permettant de télécharger le logiciel d'agent et de créer une clé d'installation d'agent décrites dans Téléchargement du logiciel d'agent de gestion et dans Création d'une clé d'installation.

2. Téléchargez le fichier de la clé d'installation de l'agent.

   Accédez à la page Clés d'installation d'agent et, dans le menu d'actions, sélectionnez l'option Télécharger la clé dans un fichier.

   L'option Télécharger la clé dans un fichier vous permet de télécharger un modèle de fichier de réponses. Pour plus de détails, reportez-vous à Téléchargement d'une clé d'installation.

3. Modifiez le modèle de fichier de réponses à l'aide d'un éditeur de texte et créez un fichier de réponses personnalisé.

   Suivez les instructions permettant de créer un fichier de réponses en téléchargeant un modèle de fichier de réponses décrites dans Option 1 : téléchargement d'un modèle de fichier de réponses pour créer un fichier de réponses.

   Le modèle de fichier réponse contient les paramètres de l'agent, y compris le paramètre de plug-in de service requis pour déployer un plug-in.

   Pour déployer un module d'extension de service dans le cadre du processus d'installation de l'agent de gestion, personnalisez le paramètre Service.plugin.<nom_module_extension>.download.

   Par exemple, si vous voulez déployer le module d'extension Data Safe lors de l'installation de l'agent, la valeur du paramètre sera Service.plugin.datasafe.download=true.

   Pour plus d'informations sur les paramètres d'agent pris en charge dans le fichier de réponses, reportez-vous à Examen des paramètres d'agent.

4. Installez l'agent de gestion comme décrit dans Installation de l'agent de gestion pour terminer l'installation.

Après avoir déployé un module d'extension de service, vous pouvez effectuer les opérations suivantes :

• Vérifier le statut du plug-in de service
• Vérifier le statut de la demande de travail

Pour activer les journaux, procédez comme suit :

• Dans la page de liste Agents, cliquez sur l'agent souhaité.

  La page de détails de l'agent apparaît.

• Cliquez sur Activer les journaux d'agent.

  La fenêtre Activer les journaux : Agent s'affiche pour l'agent sélectionné.

• Sélectionnez un compartiment de groupe de journaux dans la liste déroulante.
• Sélectionnez un groupe de journaux dans la liste déroulante.

  Pour créer un groupe de journaux, cliquez sur Créer un groupe de journaux.

  Dans la fenêtre Créer un groupe de journaux, entrez le nom du groupe de journaux et une description. Cliquez ensuite sur Créer.

• Cliquez sur Activer.

Une fois les journaux activés, l'association peut être consultée dans Log Analytics.

• Accédez à Observation & gestion et à Log Analytics.
• Sur la page Log Analytics, accédez à Administration.

  Dans le menu de gauche, sélectionnez Sources.

  Dans le panneau central, sélectionnez Journaux d'agent de gestion Oracle et vérifiez que l'agent est répertorié dans la liste Entités associées.

Pour désactiver les journaux, procédez comme suit :

• Cliquez sur Désactiver les journaux d'agent.

  La fenêtre de désactivation des journaux d'agent pour l'agent sélectionné s'affiche.

• Cliquez sur Désactiver.

Prérequis pour la source de données Prometheus :

• L'agent de gestion a été déployé à l'aide de l'agent de gestion version 231231.0001 ou supérieure.
• Pour l'exportateur Prometheus, l'agent de gestion doit se trouver sur la même machine virtuelle (VM) ou sur une machine virtuelle ayant accès à l'adresse de l'exportateur. Cet agent de gestion est configuré pour extraire les mesures de l'export Prometheus en cours d'exécution.

Pour gérer les sources de données, procédez comme suit :

• Dans la page de liste Agents, cliquez sur l'agent souhaité.

  La page de détails de l'agent apparaît.

• Cliquez sur Gérer les sources de données.

  La fenêtre Sources de données affiche une table avec les colonnes suivantes :

  • Nom : Nom de la source de données.
  • Type : type de la source de données. Par exemple : Prométhée.
  • Etat : statut de la source de données.
  • Heure de création : horodatage de la création de la source de données.
  • : Affiche d'autres actions disponibles pour une source de données spécifique.
• Si vous cliquez sur un nom de source de données spécifique, la fenêtre Visualiser la source de données apparaît.

  Utilisez l'option Visualiser la source de données pour afficher toutes les informations sur une source de données.

  Par exemple, vous pouvez afficher les données de mesure à partir de Prometheus Export.

• Utilisez Ajouter une source de données pour ajouter une source de données.

  • Sélectionnez le type de source de données dans la liste déroulante. Par exemple : Prométhée.
  • Utilisez Nom pour entrer le nouveau nom de la source de données.
  • Sélectionnez Compartiment de mesure dans la liste déroulante.
  • Entrez l'espace de noms de mesure.
  • Entrez l'URL utilisée par Prometheus Exportateur pour publier ses mesures.
  • Utilisez les dimensions de mesure personnalisées pour ajouter une dimension de mesure.
  • Si nécessaire, utilisez les propriétés facultatives.
• Supprimer la source de données : utilisez le menu d'actions pour supprimer une source de données.
• Modifier la source de données : utilisez le menu d'actions pour modifier les propriétés d'une source de données.

  Par exemple, vous pouvez modifier l'URL de l'exportateur Prometheus qui publie les données de mesure dans le service OCI Monitoring.

Sous Linux :

1. Connectez-vous en tant qu'utilisateur disposant de droits d'accès sudo.

2. Exécutez la commande suivante :

   Pour Oracle Linux 6 : sudo /sbin/initctl start mgmt_agent

   Pour Oracle Linux 7 : sudo systemctl start mgmt_agent

Sous Windows :

1. Connectez-vous en tant qu'utilisateur Administrator et ouvrez une fenêtre d'invite de commande.

2. Exécutez la commande suivante : net start mgmt_agent

Sous Solaris :

1. Connectez-vous en tant qu'utilisateur disposant des droits d'accès sudo pour exécuter des commandes en tant qu'utilisateur root.

2. Exécutez la commande suivante :

   sudo /etc/init.d/mgmt_agent start

Sous Linux :

1. Connectez-vous en tant qu'utilisateur disposant de droits d'accès sudo.

2. Exécutez la commande suivante :

   Pour Oracle Linux 6 : sudo /sbin/initctl stop mgmt_agent

   Pour Oracle Linux 7 : sudo systemctl stop mgmt_agent

Sous Windows :

1. Connectez-vous en tant qu'administrateur et ouvrez une fenêtre d'invite de commande.

2. Exécutez la commande suivante : net stop mgmt_agent

Sous Solaris :

1. Connectez-vous en tant qu'utilisateur disposant du privilège sudo pour exécuter des commandes en tant qu'utilisateur root.

2. Exécutez la commande suivante :

   sudo /etc/init.d/mgmt_agent stop

Sous Windows :

1. Connectez-vous en tant qu'administrateur et ouvrez une fenêtre d'invite de commande.

2. Exécutez la commande suivante : sc query mgmt_agent

   Pour plus de détails, consultez le fichier journal C:\Oracle\mgmt_agent\agent_inst\log\mgmt_agent.log.

Sous Solaris :

1. Connectez-vous en tant qu'utilisateur disposant du privilège sudo pour exécuter des commandes en tant qu'utilisateur root.

2. Exécutez la commande suivante : sudo /etc/init.d/mgmt_agent status

   Pour plus de détails, consultez le fichier journal /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log.

Deux méthodes sont disponibles pour la mise à niveau des agents de gestion :

• Mise à niveau automatique
• Mise à niveau manuelle

Vous pouvez enlever un agent d'un hôte pour les motifs suivants :

• Un agent déployé sur l'hôte cible n'est plus nécessaire.
• Vous n'avez plus besoin de collecter des données, des mesures de performances ou des journaux à partir d'un hôte cible spécifique.
• Vous avez modifié la topologie de déploiement.

• Suppression d'agents à partir de l'interface utilisateur

• Suppression d'agents à partir de l'interface de ligne de commande

Pour enlever des agents à partir de l'interface utilisateur, procédez comme suit :

1. Sélectionnez l'agent dans la liste Agents et cliquez sur le menu d'actions.

   Figure 4-1 Suppression d'un agent

   

2. Cliquez sur Supprimer l'agent.

3. Cliquez sur Supprimer pour confirmer la sélection.

Supprimez (désinstallez) l'agent de gestion des systèmes d'exploitation suivants :

• Linux à l'aide de la commande RPM
• Linux utilisant un script de désinstallation
• Windows
• Solaris
• AIX

Exécutez la commande rpm avec l'option -e.

sudo rpm -e <rpm_name>

$ sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_agent...
Removing mgmt_agent daemon from systemd...
Removed symlink/etc/systemd/system/multi-user.target.wants/mgmt_agent.service.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

Le résultat ressemble à ce qui suit :

C:\Oracle>mgmt_agent\uninstaller.bat
Removing agent from Management Agent Cloud Service
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Removing agent service from the host
Agent service was removed from the host successfully
Removing agent directories

sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_agent...
Removing mgmt_agent daemon from systemd...
Removed symlink /etc/systemd/system/multi-user.target.wants/mgmt_agent.service.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

sudo sh /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the Agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the Agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected AIX:
Stopping mgmt_agent...
Waiting for mgmt_agent to exit...
Stopped mgmt_agent.
Removing mgmt_agent daemon...
0513-083 Subsystem has been Deleted.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

Vous pouvez ajouter des informations d'identification à un agent de deux manières :

• Option 1. Dans le service d'agent de gestion, Oracle recommande d'utiliser la console ou l'API Oracle Cloud pour ajouter des informations d'identification nommées.
• Option 2. Vous pouvez configurer des informations d'identification source dans les fichiers de configuration de l'agent pour permettre à l'agent de collecter des données provenant de différentes sources.

Pour créer et gérer des informations d'identification nommées, vous pouvez utiliser :

• Oracle Cloud Console
• API des informations d'identification nommées de l'agent de gestion

• Vérifiez que la version de l'agent OMA (250704.1404 ou version ultérieure) est installée.
• Configurez les éléments suivants pour votre utilisateur :
  • Ajoutez les droits d'accès requis pour les informations d'identification nommées. Reportez-vous à Scénarios utilisateur et à Détails de la référence de stratégie de service d'agent de gestion.
  • Ajoutez la stratégie suivante pour les informations d'identification nommées. Reportez-vous au Table 2-1 pour l'agent OMA.

    ALLOW GROUP <group-name> TO MANAGE management-agent-named-credentials IN <compartment_name>

  • Créer une clé secrète dans un coffre. Pour ce faire, vous avez besoin d'un droit d'accès supplémentaire pour créer une clé secrète. Reportez-vous à Création d'une clé secrète dans un coffre et à Détails du coffre, de la gestion des clés et des clés secrètes. Le coffre et la clé secrète peuvent se trouver dans différents compartiments. Le coffre et la clé secrète peuvent se trouver dans un compartiment différent de celui de l'agent.
  • Configurez les droits d'accès suivants afin de pouvoir lire le groupe de clés secrètes. Reportez-vous à Détails du coffre, de la gestion des clés et des clés secrètes.
    • Procédure de liste des droits d'accès VAULT_INSPECT et VAULT_READ des coffres.
    • Pour répertorier les droits d'accès SECRET_INSPECT et SECRET_READ des clés secrètes.
• Configurez les droits d'accès et les stratégies de la ressource d'agent pour :

  • Créez un groupe dynamique pour la ressource d'agent en utilisant l'exemple ci-dessous. Remplacez ocid1.compartment.oc1.agentcompartmentid par l'OCID de compartiment de l'agent. Reportez-vous à Création d'un groupe dynamique dans la console et à Gestion des groupes dynamiques.

    ALL {resource.type='managementagent', resource.compartment.id='ocid1.compartment.oc1.agentcompartmentid'}

  • Ajoutez la stratégie suivante pour autoriser le groupe dynamique à lire la clé secrète dans un compartiment spécifique, remplacez ocid1.compartment.oc1.secretcompartmentid par l'OCID de compartiment de la clé secrète. Reportez-vous à Mise à jour de l'instruction d'une stratégie.

    allow dynamic-group X to read secret-bundles in compartment ocid1.compartment.oc1.secretcompartmentid

  • L'agent doit également disposer de droits d'accès et de stratégies pour toutes les ressources OCI utilisées dans la création d'informations d'identification nommées. Par exemple, si l'agent utilise des informations d'identification nommées pour interagir avec une base de données autonome, vous devez créer une stratégie pour autoriser le groupe dynamique de l'agent à lire le portefeuille de base de données autonome. Par exemple :

    allow dynamic-group X to read autonomous-databases in compartment DB_COMPARTMENT

Lorsque vous configurez des autorisations pour les informations d'identification nommées, vous pouvez configurer des utilisateurs avec des droits d'accès différents et chaque utilisateur peut disposer de droits d'accès avec des niveaux d'accès différents pour effectuer des tâches. Par exemple, vous pouvez configurer les éléments suivants :

• Un utilisateur opérateur disposant du droit d'accès MGMT_AGENT_NAMED_CREDENTIAL_APPLY, puis les agents auxquels l'utilisateur a accès peuvent utiliser des informations d'identification nommées pour effectuer des actions sans avoir accès aux mots de passe. Un utilisateur disposant de ce droit d'accès ne pourra pas visualiser le coffre ou les OCID de clé secrète contenus dans les informations d'identification nommées.
• Un administrateur disposant des droits d'accès suivants peut effectuer les opérations CRUD standard sur les informations d'identification nommées et n'a pas accès à la lecture du groupe de clés secrètes à partir du coffre.

  • MGMT_AGENT_NAMED_CREDENTIAL_CREATE

  • MGMT_AGENT_NAMED_CREDENTIAL_UPDATE

  • MGMT_AGENT_NAMED_CREDENTIAL_DELETE

• Si un utilisateur dispose du droit d'accès MGMT_AGENT_DELETE, il peut supprimer la ressource d'agent et toutes les informations d'identification nommées associées seront également supprimées.
  Remarque
  
  La suppression d'un agent ou d'informations d'identification nommées n'a aucune incidence sur la clé secrète stockée dans le coffre OCI.

Pour créer des informations d'identification nommées, recherchez l'agent à mettre à jour :

1. Ouvrez le menu de navigation et sélectionnez Observation et gestion. Sous Agent de gestion, sélectionnez Agents.
2. Sélectionnez le compartiment contenant les agents à répertorier. Sélectionnez l'option permettant d'inclure des sous-compartiments pour obtenir un aperçu des détails de l'agent dans le compartiment sélectionné, y compris les compartiments enfant.
3. Dans le menu Actions, sélectionnez Gérer les informations d'identification nommées.
   • Vous pouvez également accéder à la page Détails de l'agent, sélectionner l'option Actions supplémentaires, puis Gérer les informations d'identification nommées.
4. Entrez le nom des informations d'identification. Vous pouvez éventuellement saisir une description.
5. Sélectionnez le type d'informations d'identification à ajouter dans la liste déroulante Type d'informations d'identification.
6. Pour chaque champ ou attribut du type d'informations d'identification sélectionné, entrez une valeur, sélectionnez un identificateur de ressource ou sélectionnez un coffre et un identificateur de clé secrète.

   Si la ressource existe dans un autre compartiment, vous pouvez sélectionner Modifier le compartiment pour modifier le compartiment et rechercher la valeur de la ressource.

7. Pour ajouter des balises, sélectionnez Afficher les options avancées.
   • Pour ajouter des balises, sélectionnez un espace de noms de balise, entrez une clé de balise et une valeur de balise, puis sélectionnez Ajouter une balise. Vous pouvez restreindre l'accès aux informations d'identification en ajoutant des balises. Si vous disposez des droits d'accès requis pour créer des informations d'identification nommées, vous disposez également des droits d'accès nécessaires pour ajouter des balises à format libre. Pour ajouter une balise définie, vous devez également disposer des droits d'accès pour l'espace de noms de la balise. Pour plus d'informations, reportez-vous à Présentation de Tagging et pour savoir comment ajouter une balise lorsque vous créez une ressource, reportez-vous à Utilisation des balises de ressource.
   • Pour supprimer une balise, sélectionnez X.
8. Sélectionnez Enregistrer pour ajouter les informations d'identification nommées à l'agent. Si vous ne pouvez pas enregistrer les informations d'identification nommées, confirmez que vous avez entré tous les champs obligatoires.

   Lorsque les informations d'identification nommées sont enregistrées, une demande de travail est envoyée à l'agent. Une fois la demande de travail terminée, l'agent peut utiliser ces informations d'identification nommées pour effectuer diverses tâches sur plusieurs modules d'extension ou services déployés sur l'agent.

   Remarque
   
   Si la demande de travail échoue, vérifiez que l'agent dispose du droit d'accès SECRET_READ. Pour accéder aux clés secrètes de coffre et effectuer l'opération GetSecret, reportez-vous à Détails du coffre, de la gestion des clés et des clés secrètes.

   Pour modifier ou supprimer des informations d'identification nommées pour un agent, procédez comme suit :

   1. Recherchez l'agent à mettre à jour pour effectuer les opérations suivantes :
      • Accédez à la page de liste Agents. En regard de l'agent à mettre à jour, sélectionnez le menu Actions, puis Gérer les informations d'identification nommées.
      • Vous pouvez également accéder à la page Détails de l'agent, sélectionner l'option Actions supplémentaires, puis Gérer les informations d'identification nommées.
   2. Sélectionnez Edition ou Supprimer. Vous pouvez modifier les détails du coffre pour le nom d'utilisateur et le mot de passe. Vous ne pouvez pas modifier le nom ou le type des informations d'identification.
      Remarque
      
      Si vous supprimez des informations d'identification nommées qui sont activement utilisées, la surveillance de la source sur l'agent peut être interrompue.

• Types d'informations d'identification source
• Ajout ou mise à jour d'informations d'identification
• Suppression d'informations d'identification
• Ajout ou mise à jour d'un alias d'informations d'identification
• Suppression d'un alias d'informations d'identification

Vous pouvez utiliser la console OCI pour visualiser les événements de journal du service Management Agent.

• Ouvrez le menu de navigation. Sous Gouvernance et administration, accédez à Gouvernance et cliquez sur Audit.

  Le service Audit s'affiche.

• Mise à niveau d'un environnement JRE sous Linux
  • Mise à niveau d'un environnement JRE à l'aide d'un package RPM
  • Mise à niveau d'un environnement JRE à l'aide d'une archive compressée
• Mise à niveau d'un environnement JRE sous Windows
• Mise à jour d'un emplacement JAVA_HOME personnalisé