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

• Sous Observabilité et gestion, cliquez sur Agent de gestion.

• Dans le menu de gauche, sélectionnez un compartiment dans la liste déroulante compartiment.

  La console des agents de gestion s'affiche.

1. Créez un répertoire pour stocker les certificats d'autorité de certification racine de confiance supplémentaires au format PEM. Dans l'exemple suivant, le répertoire tmp est un exemple. Vous pouvez utiliser n'importe quel répertoire et vérifier que l'utilisateur Agent dispose d'un accès en lecture à chaque répertoire du chemin d'accès aux certificats.

   mkdir /tmp/crt

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

   cp *.pem /tmp/crt

3. Définissez les autorisations pour le répertoire et son contenu pour 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 spécifier 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 ce qui suit par des valeurs pour votre environnement afin de vérifier que les certificats approuvés ont été importés avec succès dans le magasin de clés de l'agent. Remplacez <CUSTOM_CERTIFICATE_FILE_NAME> par le nom du 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é qui est ajouté au magasin de certificats approuvés de l'agent.

1. Utilisez les commandes suivantes pour créer un répertoire trustedcerts pour importer les certificats approuvés à cet emplacement : /var/lib/oracle-cloud-agent/plugins/oci-managementagent/. Vérifiez que l'utilisateur oracle-cloud-agent est un responsable 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 OCA.
4. Après l'installation, vous pouvez utiliser la commande suivante pour vérifier que les certificats approuvés ont été importés avec succès dans le magasin de clés de l'agent. Remplacez le <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é qui est ajouté au magasin de certificats approuvés de l'agent.

• Déployer un plugiciel à l'aide de la page Agents
• Déployer un plugiciel pendant 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 sur lequel vous souhaitez déployer le plugiciel.

   La page de détails de l'agent s'affiche.

   
   
   

3. Cliquez sur Déployer les plugiciels.

   La fenêtre Deploy Plug-ins s'affiche.

4. Sélectionnez le plugiciel et sélectionnez Mettre à jour.

   Maintenant, le plugiciel sélectionné sera déployé sur l'agent souhaité.

1. Suivez les instructions pour télécharger le logiciel de l'agent et créer une clé d'installation d'agent, comme décrit dans Télécharger le logiciel de l'agent de gestion et Créer une clé d'installation.

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

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

   L'option Télécharger la clé vers le fichier vous permet de télécharger un modèle de fichier de réponses. Pour plus de détails, voir Télécharger la 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 pour créer un fichier de réponses à l'aide de l'option de téléchargement d'un modèle de fichier de réponses, comme décrit sous Option 1 : Télécharger un modèle de fichier de réponses pour créer un fichier de réponses.

   Le modèle de fichier de réponses contient les paramètres de l'agent, y compris le paramètre du plugiciel de service, qui est requis pour déployer un plugiciel.

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

   Par exemple, si vous voulez déployer le plugiciel du service de sécurité des données lors de l'installation de l'agent, indiquez : Service.plugin.datasafe.download=true

   Pour plus d'informations sur les paramètres d'agent pris en charge dans le fichier de réponses, voir Vérifier les paramètres de l'agent.

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

• Vérifier le statut du plugiciel de service
• Vérifier le statut de la demande de travail

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

  La page de détails de l'agent s'affiche.

• 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 nouveau 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. Après, cliquez sur Créer.

• Cliquez sur Activer.

• Naviguez jusqu'à Observabilité et gestion et allez à Log Analytics.
• Dans la page Log Analytics, allez à Administration.

  Dans le menu de gauche, sélectionnez Sources.

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

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

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

• Cliquez sur Désactiver.

• L'agent de gestion a été déployé à l'aide de l'agent de gestion version 231231.0001 ou ultérieure.
• Pour Prometheus Exportateur, l'agent de gestion doit être sur la même machine virtuelle (VM) ou sur une VM avec accès au point d'extrémité de l'exportateur. Cet agent de gestion est configuré pour brouiller les mesures à partir de l'exportateur Prometheus en cours d'exécution.

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

  La page de détails de l'agent s'affiche.

• 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 : Prometheus.
  • État : 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 Voir la source de données s'affiche.

  Utilisez Voir 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 Exportateur.

• 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 : Prometheus.
  • Utilisez Nom pour entrer le nouveau nom de la source de données.
  • Sélectionnez Compartiment de mesures 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.
  • Utilisez Propriétés facultatives si nécessaire.
• 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 de surveillance OCI.

1. Connectez-vous en tant qu'utilisateur disposant des autorisations 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

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

1. Connectez-vous en tant qu'utilisateur disposant des autorisations sudo pour exécuter des commandes en tant qu'utilisateur racine.

2. Exécutez la commande suivante :

   sudo /etc/init.d/mgmt_agent start

1. Connectez-vous en tant qu'utilisateur disposant des autorisations 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

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

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

2. Exécutez la commande suivante :

   sudo /etc/init.d/mgmt_agent stop

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.

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

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.

• Mise à niveau automatique
• Mise à niveau manuelle

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

• Supprimer des agents à partir de l'interface utilisateur

• Supprimer des agents à partir de l'interface de ligne de commande

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

   Figure 4-1 Supprimer un agent

   

2. Cliquez sur Supprimer l'agent.

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

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

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.

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.

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

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

• Vérifiez que la version de l'agent de gestion : 250704.1404 ou une version supérieure est installée.
• Configurez les éléments suivants pour votre utilisateur :
  • Ajoutez les autorisations requises pour les données d'identification nommées, voir Scénarios d'utilisateur et Informations détaillées sur les politiques du service d'agent de gestion.
  • Ajoutez la politique suivante pour les données d'identification nommées, voir Tableau 2-1 pour l'agent de gestion.

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

  • Créer une clé secrète dans une chambre forte. Pour ce faire, vous devez disposer d'une autorisation supplémentaire pour créer une clé secrète, voir Création d'une clé secrète dans une chambre forte et Informations détaillées sur la chambre forte, le service de gestion des clés et les clés secrètes. La chambre forte et la clé secrète peuvent se trouver dans des compartiments différents. En outre, la chambre forte et la clé secrète peuvent se trouver dans un compartiment différent de celui de l'agent.
  • Configurez les autorisations suivantes pour pouvoir lire l'ensemble de clés secrètes, voir Informations détaillées sur la chambre forte, la gestion des clés et les clés secrètes.
    • Pour lister les autorisations VAULT_INSPECT et VAULT_READ pour les chambres fortes.
    • Pour lister les autorisations SECRET_INSPECT et SECRET_READ sur les clés secrètes.
• Configurez les autorisations et les politiques pour la ressource d'agent, pour ce faire :

  • Créez un groupe dynamique pour la ressource d'agent à l'aide de l'exemple ci-dessous. Remplacez ocid1.compartment.oc1.agentcompartmentid par l'OCID du compartiment de votre agent, voir Comment créer un groupe dynamique dans la console et Gestion des groupes dynamiques.

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

  • Ajoutez la politique suivante pour permettre au groupe dynamique de lire la clé secrète dans un compartiment spécifique, remplacez ocid1.compartment.oc1.secretcompartmentid par l'OCID du compartiment pour la clé secrète. Voir Mise à jour de l'énoncé d'une politique.

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

  • L'agent doit également disposer des autorisations et des politiques pour toutes les ressources OCI utilisées lors de la création de données d'identification nommées. Par exemple, si l'agent utilise des données d'identification nommées pour interagir avec une base de données autonome, vous devez créer une politique pour permettre au groupe dynamique de l'agent de lire le portefeuille de la base de données autonome. Par exemple :

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

• Un utilisateur opérateur disposant de l'autorisation MGMT_AGENT_NAMED_CREDENTIAL_APPLY, puis les agents auxquels l'utilisateur a accès, peuvent utiliser des données d'identification nommées pour effectuer des actions sans avoir accès aux mots de passe. Un utilisateur disposant de cette autorisation ne pourra pas voir la chambre forte ni les OCID de clé secrète contenus dans les données d'identification nommées.
• Un utilisateur administrateur disposant des autorisations suivantes peut effectuer les opérations CRUD standard sur les données d'identification nommées et n'aura pas accès à la lecture de l'ensemble de clés secrètes à partir de la chambre forte.

  • MGMT_AGENT_NAMED_CREDENTIAL_CREATE

  • MGMT_AGENT_NAMED_CREDENTIAL_UPDATE

  • MGMT_AGENT_NAMED_CREDENTIAL_DELETE

• Si un utilisateur dispose de l'autorisation MGMT_AGENT_DELETE, il peut supprimer la ressource d'agent et toutes les données d'identification nommées associées seront également supprimées.
  Note
  
  La suppression d'un agent ou d'une donnée d'identification nommée n'a pas d'incidence sur la clé secrète stockée dans la chambre forte OCI.

1. Ouvrez le menu de navigation et sélectionnez Observabilité et gestion. Sous Agent de gestion, sélectionnez Agents.
2. Sélectionnez le compartiment qui contient les agents à lister. 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 enfants.
3. Dans le menu Actions, sélectionnez Gérer les données d'identification nommées.
   • Vous pouvez également accéder à la page Détails de l'agent, sélectionner l'option Actions supplémentaires, puis sélectionner Gérer les données d'identification nommées.
4. Entrez Nom des données d'identification. Au besoin, vous pouvez entrer une description.
5. Sélectionnez le type de données d'identification à ajouter dans la liste déroulante Type de données d'identification.
6. Pour chaque champ ou attribut du type de données d'identification sélectionné, entrez une valeur ou sélectionnez un identificateur de ressource, ou sélectionnez une chambre forte et un identificateur de clé secrète.

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

7. Pour ajouter des marqueurs, sélectionnez Afficher les options avancées.
   • Pour ajouter des marqueurs, sélectionnez un espace de noms de marqueur, entrez une clé de marqueur et une valeur de marqueur, puis sélectionnez Ajouter un marqueur. Vous pouvez restreindre l'accès aux données d'identification en ajoutant des marqueurs. Si vous disposez des autorisations requises pour créer des données d'identification nommées, vous disposez également des autorisations nécessaires pour ajouter des marqueurs à structure libre. Pour ajouter un marqueur défini, vous devez également disposer des autorisations pour l'espace de noms du marqueur. Pour plus d'informations, voir Aperçu du service de marquage et pour savoir comment ajouter un marqueur lors de la création d'une ressource, voir Utilisation des marqueurs de ressource.
   • Pour supprimer un marqueur, sélectionnez le X.
8. Sélectionnez Enregistrer pour ajouter les données d'identification nommées à l'agent. Si vous ne pouvez pas enregistrer les données d'identification nommées, confirmez que vous avez entré tous les champs obligatoires.

   Lorsque les données 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 données d'identification nommées pour effectuer diverses tâches sur plusieurs plugiciels ou services déployés sur l'agent.

   Note
   
   Si la demande de travail échoue, vérifiez que l'agent dispose de l'autorisation SECRET_READ, pour accéder aux clés secrètes de chambre forte et effectuer l'opération GetSecret, voir Informations détaillées sur la chambre forte, la gestion des clés et les clés secrètes.

   Pour modifier ou supprimer des données d'identification nommées pour un agent :

   1. Recherchez l'agent à mettre à jour. Pour ce faire, vous pouvez :
      • Allez à la page de liste Agents. À côté de l'agent à mettre à jour, sélectionnez le menu Actions, puis sélectionnez Gérer les données d'identification nommées.
      • Vous pouvez également accéder à la page Détails de l'agent, sélectionner l'option Actions supplémentaires, puis sélectionner Gérer les données d'identification nommées.
   2. Sélectionnez Edit (Modifier) ou Delete (Supprimer). Vous pouvez modifier les détails de la chambre forte pour le nom d'utilisateur et le mot de passe. Vous ne pouvez pas modifier le nom ou le type des données d'identification.
      Note
      
      Si vous supprimez des données d'identification nommées qui sont activement utilisées, la surveillance de la source sur l'agent peut être interrompue.

• Types de données d'identification sources
• Ajouter ou mettre à jour des données d'identification
• Supprimer des données d'identification
• Ajouter ou mettre à jour un alias de données d'identification
• Supprimer un alias de données d'identification

• Ouvrez le menu de navigation. Sous Gouvernance et administration, sélectionnez Gouvernance et cliquez sur Vérification.

  Le service de vérification s'affiche.

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