Documentation sur Oracle Cloud Infrastructure

Installer les agents de gestion

Après avoir terminé les préalables décrits dans Exécuter les préalables au déploiement d'agents de gestion, procédez comme suit pour installer les agents de gestion.

Regardez les vidéos suivantes pour voir comment installer l'agent de gestion pour ces exemples spécifiques :

Pour plus de détails, notamment sur l'installation de l'agent de gestion sur tous les systèmes d'exploitation et sur plusieurs façons de télécharger l'agent de gestion, vous pouvez suivre les instructions ci-dessous.

Téléchargez le logiciel de l'agent de gestion

Vous pouvez télécharger le logiciel de l'agent de gestion à l'aide de l'une des options suivantes :

Option 1 : Télécharger le logiciel de l'agent de gestion à l'aide de la console Oracle Cloud

Dans la console Oracle Cloud, vous pouvez effectuer les étapes suivantes pour télécharger le logiciel de l'agent de gestion :

  1. Dans la console Oracle Cloud, cliquez sur le menu de navigation, allez à Observabilité et gestion, puis, sous Agents de gestion, sélectionnez Téléchargements et clés.
  2. Les options de téléchargement de logiciel, sélectionnez le système d'exploitation.
  3. Dans le volet Téléchargement du logiciel, sélectionnez le système d'exploitation sur lequel l'agent de gestion sera installé dans la colonne Télécharger.
  4. Cliquez sur le lien de votre système d'exploitation pour télécharger le fichier du logiciel de l'agent.
    Environnements Exadata : Pour installer l'agent de gestion sur Exadata et Exadata Cloud, y compris Cloud@Customer et sur Oracle Cloud Infrastructure, vous devez uniquement suivre les instructions d'installation de l'agent de gestion sur un volume externe à l'aide d'un fichier ZIP Linux.
    Note

    Le type d'ensemble RPM pour Linux n'est pas pris en charge dans Exadata.

    Par exemple, cliquez sur Agent pour WINDOWS (X86_64) pour Windows.

Le fichier du logiciel est maintenant enregistré sur votre hôte.

Après avoir téléchargé le fichier, vous pouvez vérifier l'intégrité du fichier en vérifiant la valeur de la colonne SHA-256 Checksum. Par exemple, si vous utilisez Linux, il doit correspondre à la sortie de la commande suivante : sha256sum <download_file>

Option 2 : Télécharger le logiciel de l'agent de gestion à l'aide de l'interface de ligne de commande

Vous pouvez utiliser l'interface de ligne de commande d'Oracle Cloud Infrastructure (OCI) pour télécharger le logiciel de l'agent de gestion en effectuant les étapes suivantes. L'interface de ligne de commande d'Oracle Cloud Infrastructure est un outil d'interface de ligne de commande. Pour plus d'informations, voir Interface de ligne de commande.
  1. Obtenez la valeur object-url à l'aide de la commande de l'interface de ligne de commande agent-image list. 
    oci management-agent agent-image list --compartment-id <tenancyId>

    La valeur object-url retournée est similaire à la suivante :

    https://objectstorage.<region_identifier>.oraclecloud.com/n/<namespace>/b/<bucketName>/o/Linux-x86_64/latest/oracle.mgmt_agent.rpm<! [CDATA[ ]]>

    Dans ce qui précède, notez les valeurs <namespace> et <bucketName>.

  2. Téléchargez le logiciel de l'agent de gestion avec le principal authentifié OCI à l'aide des valeurs <namespace> et <bucketName> de l'étape 1 :
    • Pour Linux : 
      oci os object get --namespace <namespace> --bucket-name <bucketName> --name Linux-x86_64/latest/oracle.mgmt_agent.rpm --file oracle.mgmt_agent.rpm
    • Pour Windows Server : 
      oci os object get --namespace <namespace> --bucket-name <bucketName> --name Windows-x86_64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
    • Pour Solaris : 
      oci os object get --namespace <namespace> --bucket-name <bucketName> --name Solaris-Sparc64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
    • Pour AIX :
      oci os object get --namespace <namespace> --bucket-name  <bucketName> --name AIX-ppc64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
    • Pour Linux ARM :
      oci os object get --namespace <namespace> --bucket-name  <bucketName> --name Linux-Aarch64/latest/oracle.mgmt_agent.rpm  --file oracle.mgmt_agent.rpm

    • Pour le bureau macOS et Windows : L'agent de gestion est pris en charge lors de l'utilisation du service de gestion Java. Pour plus de détails, voir Service de gestion Java, en particulier la section Installation d'un agent de gestion.

    3 Après avoir téléchargé le fichier, vous pouvez vérifier l'intégrité du fichier en vérifiant la valeur de la colonne SHA-256 Checksum. Par exemple, si vous utilisez Linux, il doit correspondre à la sortie de la commande suivante : sha256sum <download_file>

Option 3 : Télécharger le logiciel de l'agent de gestion à l'aide de l'API REST

Pour télécharger le logiciel de l'agent de gestion, vous pouvez :

  1. Pour plus de détails, utilisez l'API REST ListManagamentAgentImages avec une authentification OCI valide, voir la documentation sur l'API REST ListManagementAgentImages.
  2. Obtenez la valeur de object-url à partir de la sortie et utilisez cette URL pour télécharger le logiciel de l'agent de gestion. Pour plus de détails, consultez l'opération GetObject dans la documentation sur l'API du service de stockage d'objets.

Créer une clé d'installation

Vous devez créer une clé d'installation avant d'installer l'agent de gestion.

Une clé d'installation est émise pour votre domaine d'identité et valide l'authenticité de l'installation. Assurez-vous de créer la clé d'installation avant de démarrer l'installation de l'agent de gestion.

Pour créer une clé d'installation :

  1. Dans la page d'accueil Agents de gestion, cliquez sur Téléchargements et clés dans le menu de gauche pour afficher le volet Clés d'installation.

    Le volet clés d'installation s'affiche au bas de la page.

  2. Dans le volet Clés d'installation, cliquez sur Créer une clé pour créer une clé.

  3. Entrez les détails requis dans la fenêtre Créer une clé.

    1. Dans le champ Nom de la clé, spécifiez un nom pour identifier la clé.

    2. Dans le champ Compartiment, sélectionnez le compartiment dans la liste déroulante. Il s'agit du compartiment dans lequel la ressource d'agent sera créée.

    3. Dans le champ Nombre maximal d'installations, spécifiez le nombre maximal d'installations pouvant être associées à la clé. La valeur par défaut est 1000.

    4. Dans le champ Valide pour, spécifiez un nombre qui indique la période pendant laquelle la clé est valide. La valeur par défaut est 1 semaine.

    5. La case à cocher Inlimité est facultative.

      Si cette option est sélectionnée, la clé peut être utilisée pour un nombre illimité d'installations d'agent et de passerelle et la clé n'expire jamais.

      Risques d'utilisation de clés illimitées : Oracle recommande de conserver la durée de vie d'une clé d'installation à un temps minimal requis et à un nombre limité d'agents. Assurez-vous de conserver la clé téléchargée dans un emplacement sécurisé afin de protéger la confidentialité. Si la clé d'installation illimitée est compromise, un attaquant peut installer des agents malveillants dans votre location. Une vérification régulière des agents de votre location peut aider à atténuer les risques potentiels associés à un nombre illimité de clés d'installation. Lorsqu'une clé d'installation illimitée n'est plus nécessaire, veillez à la supprimer à l'aide de la console des agents de gestion ou de l'interface de ligne de commande.

    Boîte de dialogue Créer une clé.

    Une nouvelle clé est créée.

Le volet Clés d'installation offre différentes options pour gérer les clés. Lors d'une étape ultérieure, l'option Télécharger la clé vers le fichier est utile pour télécharger un fichier pouvant être utilisé comme modèle de fichier de réponse, comme décrit dans Configurer un fichier de réponses.

Pour plus d'informations sur la gestion des clés d'installation, voir Gérer les clés d'installation.

Note

Si vous installez une passerelle de gestion, vous pouvez utiliser la même clé d'installation pour installer la passerelle de gestion et l'agent de gestion. Pour plus d'informations sur la passerelle de gestion, voir Passerelle de gestion.

Configurer un fichier de réponses

Le script d'installation de l'agent de gestion utilise un fichier de réponses pour lire les paramètres de l'agent propres à votre environnement.

Vérifier les paramètres de l'agent

Un fichier de réponses contenant les paramètres de l'agent est requis lors de l'exécution du script de configuration de l'agent.

La section suivante décrit les paramètres pris en charge dans le fichier de réponses :

Tableau 3-1 Paramètres du fichier de réponses

Nom du paramètre Type de paramètre Description
ManagementAgentInstallKey Obligatoire Clé d'installation requise pour valider l'identité du domaine et l'authenticité de l'installation.
CredentialWalletPassword Facultatif Mot de passe du portefeuille de l'agent lorsque l'utilisateur fournit un mot de passe personnalisé pour le portefeuille afin de stocker des informations sensibles.
La longueur minimale du mot de passe est de 8 caractères, avec les spécifications suivantes :
  • Au moins un caractère minuscule (a-z)
  • Au moins un caractère majuscule (A-Z)
  • Au moins un chiffre (0-9)
  • Au moins un caractère spécial parmi les suivants : '!', '@', '#', '%', '^', '&', '*'

Seuls les caractères ci-dessus peuvent être utilisés pour le mot de passe. Par exemple, si le mot de passe comporte le caractère $, la vérification de validité échoue car $ ne fait pas partie des caractères spéciaux ci-dessus.

GatewayServerHost Facultatif Nom d'hôte ou adresse du serveur de passerelle de gestion ou du serveur mandataire.

Le cas échéant, GatewayServerPort doit l'être également.

Si la passerelle de gestion est configurée en mode de haute disponibilité, vous devez spécifier le nom d'hôte de l'équilibreur de charge en tant que valeur GatewayServerHost. Pour plus d'informations, voir Configurer la haute disponibilité pour la passerelle de gestion.

GatewayServerPort Facultatif Numéro de port du serveur de passerelle de gestion ou du serveur mandataire.

Le cas échéant, GatewayServerHost doit l'être également.

Si la passerelle de gestion est configurée en mode de haute disponibilité, vous devez spécifier le numéro de port de l'équilibreur de charge comme valeur GatewayServerPort. Pour plus d'informations, voir Configurer la haute disponibilité pour la passerelle de gestion.

GatewayServerUser Facultatif Nom d'utilisateur, si le serveur de la passerelle de gestion ou le serveur mandataire nécessite une authentification.

Le cas échéant, GatewayServerPassword doit l'être également.

GatewayServerPassword Facultatif Mot de passe, si le serveur de la passerelle de gestion ou le serveur mandataire requiert une authentification.

Le cas échéant, GatewayServerUser doit l'être également.

GatewayServerRealm Facultatif Domaine d'authentification du serveur mandataire.

Si vous utilisez la passerelle de gestion, cette valeur n'est pas nécessaire.
AgentDisplayName Facultatif Nom d'affichage de l'agent. Si ce paramètre est laissé vide, la valeur par défaut est réglée à "Agent (host-name)".
Service.plugin.<plugin_name>.download=true Facultatif Nom du plugiciel à déployer lors de l'installation de l'agent. <plugin_name> est un plugiciel pris en charge par le service d'agent de gestion.

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
FreeFormTags = [{"<key1>":"<value1>"}, {"<key2>":"<value2>"}] Facultatif Association de métadonnées de marqueur si vous utilisez des marqueurs dans OCI.

Il s'agit d'une clé et d'une valeur. La clé correspond à tout nom utilisé pour référencer le marqueur. La valeur est celle ajoutée à la clé de marqueur par l'utilisateur qui applique le marqueur.

Pour Agent associé, si cet agent de gestion est configuré pour se connecter au moyen d'une passerelle de gestion, ajoutez un marqueur nommé "GatewayGroup".

Par exemple : "GatewayGroup":"<User_Defined_ClusterName>
DefinedTags = [{"namespace1":{"<key1>":"<value1>"}}, {"namespace2":{"<key2>":"<value2>"}}] Facultatif Association de métadonnées de marqueur si vous utilisez des marqueurs dans OCI. L'administrateur de marqueurs crée et gère tous les marqueurs que les utilisateurs appliquent aux ressources. Les utilisateurs doivent avoir défini des politiques de marqueur.

L'espace de noms de marqueur est un conteneur pour vos clés de marqueur. La clé de marqueur est une clé dans votre espace de noms, vous devez créer des clés de marqueur pour les marqueurs définis dans un espace de noms.

Pour les marqueurs définis, le type de la valeur de marqueur peut être une chaîne ou une liste de chaînes. Lors de la définition du type de valeur de marqueur, si le type défini était une chaîne, une valeur quelconque peut être indiquée. En revanche, s'il s'agissait d'une liste de chaînes, la valeur doit être tirée de cette liste.

Dans l'exemple suivant, il existe 2 espaces de noms admin_namespace et finance_namespace. Chaque espace de noms utilise 2 clés et 2 valeurs environment_type=non-prod, sensitivity=restricted. Pour définir les marqueurs, vous pouvez utiliser les éléments suivants : 

DefinedTags = [{"admin_namespace": {"environment_type": "non-prod",
    "sensitivity": "restricted"}, "finance_namespace": {"environment_type":
    "non-prod","sensitivity": "restricted"}}]
GatewayServerRootCACertOcid Facultatif Ce paramètre est disponible à partir de la version 221019.0021 de l'agent.

Lorsque l'agent se connecte à une passerelle de gestion de la version 221019.0021.1667404647 ou supérieure, la connexion est chiffrée.

Ce paramètre spécifie la valeur OCID du certificat d'autorité de certification racine à utiliser. L'agent et la passerelle doivent tous deux se trouver dans le même compartiment.

importTrustedCertsDirectory Facultatif

Emplacement des certificats d'autorité de certification racine supplémentaires au format PEM.

Utilisez ce paramètre si vous voulez ajouter des certificats d'autorité de certification racine supplémentaires au format PEM. L'agent OMA a effectué une recherche dans cet emplacement et a ajouté les certificats lors de l'installation.

Par exemple : importTrustedCertsDirectory=/tmp/crt
maxHeapInMb Facultatif Quantité de tas maximum en mégaoctets.

La valeur par défaut du tas est de 512 Mo. Utilisez ce paramètre pour régler l'agent afin qu'il utilise plus de tas si vous savez à l'avance que l'agent va être configuré avec un chargement important, tel que les journaux et les bases de données.

Par exemple : maxHeapInMb=1024
BufferingEnabled Facultatif Active la mise en mémoire tampon pour divers points d'extrémité au moyen de la passerelle de gestion, tels que les services Log Analytics et Object Storage OCI.

Créer un fichier de réponses

Avant de continuer, assurez-vous d'avoir lu et compris les informations fournies dans Vérifier les paramètres de l'agent.

Pour installer et configurer des agents, vous devez créer un fichier de réponses et exécuter un script à l'aide du nouveau fichier de réponses, dans lequel l'agent pointe vers la région OCI appropriée et qui autorise la création d'une ressource pour l'agent.

Note

Lors de la création d'un fichier de réponses, vérifiez l'emplacement et les autorisations du fichier. Assurez-vous que le fichier de réponses dispose des autorisations en lecture pour l'utilisateur du système d'exploitation mgmt_agent.

Pour créer un fichier de réponses, utilisez l'une des options suivantes :

Option 1 : Télécharger un modèle de fichier de réponses pour créer un fichier de réponses

Vous pouvez télécharger un fichier modèle contenant les paramètres de l'agent qui peuvent être enregistrés et utilisés en tant que fichier de réponses pendant l'installation de l'agent.

Pour télécharger un modèle de fichier de réponses, utilisez l'option de menu Télécharger la clé vers le fichier de la liste Clés d'installation de l'agent.

  • Cliquez sur Téléchargements et clés dans le menu de gauche pour ouvrir le volet Clés d'installation de l'agent. Dans la liste des clés d'installation de l'agent, sélectionnez la clé à télécharger.

  • Dans la partie droite de la clé sélectionnée, cliquez sur le menu d'actions Menu d'actions et sélectionnez Télécharger la clé vers le fichier.

    Un fichier est téléchargé. Pour plus d'informations, voir Télécharger la clé d'installation.

Lors du téléchargement de la clé d'installation de l'agent vers un fichier, le fichier téléchargé contient les paramètres de l'agent, y compris la valeur de la clé d'installation de l'agent spécifique.

Après avoir téléchargé le fichier, vous devez le personnaliser en fonction de votre environnement :
  • Ouvrez le fichier à l'aide d'un éditeur de texte, vérifiez-le et modifiez les paramètres d'agent obligatoires. Voir Voir les paramètres de l'agent.
  • Mettez en commentaire (ajoutez le symbole # au début de la ligne) ou supprimez les paramètres dont vous n'avez pas besoin pour votre configuration d'agent spécifique.
  • Annulez la mise en commentaire (supprimez le symbole # du début de la ligne) des paramètres requis pour votre configuration d'agent spécifique et mettez à jour la valeur du paramètre d'agent si nécessaire.
  • Enregistrez le fichier de réponses mis à jour. Par exemple, ce fichier de réponses peut être enregistré sous le nom input.rsp.

Option 2 : Créer un fichier de réponses à l'aide d'un éditeur de texte

Vous pouvez créer un fichier de réponse manuellement à l'aide d'un éditeur de texte. Par exemple, vous pouvez créer un fichier à l'aide de votre éditeur de texte privilégié, ajouter les paramètres requis pour votre configuration d'agent au fichier de réponses, puis l'enregistrer. Par exemple, ce fichier de réponses peut être enregistré sous le nom input.rsp.

Exemple de fichier de réponses input.rsp :
managementAgentInstallKey = MS4wLHVzLWFzaGJ1cm4tMSxvY2lkMS50ZW5hbmN5
CredentialWalletPassword = Abcdefgh1#

Après avoir créé le fichier de réponses à l'aide de l'une des options ci-dessus, vérifiez les autorisations du fichier et assurez-vous que l'utilisateur mgmt_agent (utilisateur du système d'exploitation créé lors du processus d'installation de l'agent de gestion).

Installer l'agent de gestion

Après avoir téléchargé le logiciel de l'agent, créé une clé d'installation et un fichier de réponses, vous pouvez poursuivre l'installation de l'agent de gestion pour collecter des données à partir des sources à gérer et à surveiller à partir d'Oracle Cloud Infrastructure.

Note

Installer l'agent de gestion sous Linux (fichier RPM)

Note

Exadata : N'utilisez pas l'installation RPM sur les déploiements Exadata, notamment sur place, Cloud@Customer et Oracle Cloud Infrastructure. Pour les instructions d'installation, voir Installer l'agent de gestion sur un volume externe à l'aide d'un fichier ZIP Linux.

Pour installer le logiciel d'agent de gestion sous Linux à l'aide d'un fichier RPM, procédez comme suit :
  1. Connectez-vous en tant qu'utilisateur disposant des privilèges sudo. Pour modifier l'utilisateur par défaut, vous pouvez voir Utiliser un utilisateur du système d'exploitation autre que par défaut pour installer la passerelle de gestion pour plus d'informations.
  2. Installez le logiciel de l'agent.
    Accédez au répertoire où vous avez téléchargé le fichier RPM du logiciel de l'agent de gestion et exécutez la commande suivante pour installer le fichier RPM : 
    sudo rpm -ivh <rpm_file_name.rpm>

    Par exemple : sudo rpm -ivh oracle.mgmt_agent-<VERSION>.rpm

    La sortie se présente comme suit : 
    Preparing... ################################# [100%]
Checking pre-requisites

      Checking if any previous agent service exists
      Checking if OS has systemd or initd
      Checking available disk space for agent install
      Checking if /opt/oracle/mgmt_agent directory exists
      Checking if 'mgmt_agent' user exists
      'mgmt_agent' user already exists, the agent will proceed installation without creating a new one.
      Checking Java version
      JAVA_HOME is not set. Trying default path
      Java version: 1.8.0_281 found at /usr/bin/java

Updating / installing...
      1:oracle.mgmt_agent-<VERSION>################################# [100%]
Executing install
      Unpacking software zip
      Copying files to destination dir (/opt/oracle/mgmt_agent)
      Initializing software from template
      Creating 'mgmt_agent' daemon
      Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer-log-0
      Setup agent using input response file (run as any user with 'sudo' privileges)
      Usage:sudo
      /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=[RESPONSE_FILE]
Agent install successful
    Le processus d'installation de l'agent effectue les opérations suivantes :
    • Un nouvel utilisateur nommé mgmt_agent est créé. Il s'agit de l'utilisateur de l'agent de gestion. Si l'utilisateur mgmt_agent existe déjà, le processus d'installation de l'agent l'utilise pour installer le logiciel de l'agent.
    • Lorsque le démon mgmt_agent est créé, le nombre maximal de descripteurs de fichier (nofile ulimit) variables et fixes est réglé à 5000.
    • Tous les fichiers de l'agent sont copiés et installés par l'utilisateur mgmt_agent. Le répertoire de base de l'installation de l'agent est celui où l'agent est installé. Ce répertoire est créé dans le cadre du processus d'installation de l'agent sous /opt/oracle/mgmt_agent.
    • Par défaut, le service mgmt_agent est activé et démarré automatiquement après l'installation de l'agent.
    Les fichiers journaux de l'installation de l'agent se trouvent dans le répertoire /opt/oracle/mgmt_agent/installer-logs. Pour voir les fichiers journaux ou tout autre fichier d'installation de l'agent, connectez-vous en tant qu'utilisateur mgmt_agent à l'aide de la commande suivante :
    sudo -u mgmt_agent sh
  3. Configurez l'agent de gestion en exécutant le script setup.sh à l'aide d'un fichier de réponses. 
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=<full_path_of_response_file>
    La sortie se présente comme suit : 
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=<response_file_directory>/input.rsp
Executing configure
      Generating communication wallet
      Parsing input response file
      Validating install key
      Generating security artifacts
      Registering management agent
      Configuration Logs: /opt/oracle/mgmt_agent/configure-logs

Agent configuration successful

Starting agent...
Agent started successfully
In future agent can be started by directly running: sudo systemctl start mgmt_agent
Please make sure that you delete input.rsp or store it in a secure location.

Pour plus d'informations sur la création des fichiers de réponses, voir Créer un fichier de réponses.

Installer l'agent de gestion sous Linux (fichier ZIP)

Note

Exadata : Pour installer l'agent de gestion sur Exadata et Exadata Cloud, téléchargez et installez l'agent de gestion à l'aide de la méthode d'installation du fichier ZIP afin d'éviter les problèmes liés aux opérations de gestion du cycle de vie Exadata. N'utilisez pas l'installation RPM sur les déploiements Exadata, y compris sur place, Cloud@Customer et Oracle Cloud Infrastructure. Pour les déploiements Exadata Cloud dans Cloud@Customer et Oracle Cloud Infrastructure, assurez-vous que l'agent de gestion est installé sur le système de fichiers /u02.

Pour les instructions d'installation, voir Installer l'agent de gestion sur un volume externe à l'aide d'un fichier ZIP Linux.

Pour plus de détails et pour des considérations importantes lors de l'installation de l'agent de gestion sur Exadata Cloud, voir OCI : Prise en charge de l'observabilité et de la gestion pour Exadata Cloud ID document 3015115.1 sur My Oracle Support.

Pour installer le logiciel de l'agent de gestion sous Linux à l'aide d'un fichier ZIP, procédez de la façon suivante :
Note

L'emplacement d'installation par défaut se trouve sous le volume /opt. Si vous préférez utiliser un volume externe pour installer l'agent de gestion, voir Installer l'agent de gestion sur un volume externe à l'aide d'un fichier ZIP Linux.

  1. Extrayez le logiciel de l'agent de gestion.

    Accédez au répertoire dans lequel vous avez téléchargé le fichier zip du logiciel de l'agent de gestion et décompressez celui-ci dans l'emplacement privilégié de votre choix.

  2. Connectez-vous en tant qu'utilisateur disposant des privilèges sudo.

  3. Installez et configurez l'agent de gestion en exécutant le script installer.sh fournissant un fichier de réponses. Pour plus d'informations sur la création d'un fichier de réponse, voir Créer un fichier de réponse.

    Accédez au répertoire dans lequel vous avez décompressé le fichier zip du logiciel de l'agent de gestion et exécutez les commandes suivantes :
    sudo ./installer.sh <full_path_of_response_file>

    Par exemple : sudo ./installer.sh /tmp/input.rsp

    La sortie se présente comme suit : 
    sudo ./installer.sh <user_home_directory>/input.rsp 
Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        JAVA_HOME is not set or not readable to root
        Trying default path /usr/bin/java
        Java version: 1.8.0_282 found at /usr/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Creating 'mgmt_agent'daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo systemctl start mgmt_agent 

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
    Le processus d'installation de l'agent effectue les opérations suivantes :
    • Un nouvel utilisateur nommé mgmt_agent est créé. Il s'agit de l'utilisateur de l'agent de gestion. Si l'utilisateur mgmt_agent existe déjà, le processus d'installation de l'agent l'utilise pour installer le logiciel de l'agent.
    • Lorsque le démon mgmt_agent est créé, le nombre maximal de descripteurs de fichier (nofile ulimit) variables et fixes est réglé à 5000.
    • Tous les fichiers d'installation d'agent appartiennent à l'utilisateur mgmt_agent. Le répertoire de base de l'installation de l'agent est celui où l'agent est installé. Ce répertoire est créé dans le cadre du processus d'installation de l'agent sous /opt/oracle/mgmt_agent.
    • Par défaut, le service mgmt_agent est activé et démarré automatiquement après l'installation de l'agent.

    Les fichiers journaux de l'installation de l'agent se trouvent dans le répertoire /opt/oracle/mgmt_agent/installer-logs.

    Les fichiers journaux de l'agent en cours d'exécution se trouvent sous /opt/oracle/mgmt_agent/agent_inst/log.

    Pour voir les fichiers journaux ou tout autre fichier d'installation de l'agent, connectez-vous en tant qu'utilisateur mgmt_agent à l'aide de la commande suivante :
    sudo -u mgmt_agent sh
Installer l'agent de gestion sur un volume externe à l'aide du fichier ZIP de Linux
Note

Exadata : Pour installer l'agent de gestion sur Exadata et Exadata Cloud, téléchargez et installez l'agent de gestion à l'aide de la méthode d'installation du fichier ZIP afin d'éviter les problèmes liés aux opérations de gestion du cycle de vie Exadata. N'utilisez pas l'installation RPM sur les déploiements Exadata, y compris sur place, Cloud@Customer et Oracle Cloud Infrastructure. Pour les déploiements Exadata Cloud dans Cloud@Customer et Oracle Cloud Infrastructure, assurez-vous que l'agent de gestion est installé sur le système de fichiers /u02.

Pour plus de détails et pour des considérations importantes lors de l'installation de l'agent de gestion sur Exadata Cloud, voir OCI : Prise en charge de l'observabilité et de la gestion pour Exadata Cloud ID document 3015115.1 sur My Oracle Support.

Dans certains environnements Linux, le volume /opt a un espace disque limité et ne peut pas être utilisé pour installer un logiciel. Dans ces cas, vous pouvez installer l'agent de gestion sur un volume externe à l'aide du fichier ZIP de Linux et créer un lien symbolique.

Pour installer l'agent de gestion sur un volume externe sous Linux, procédez de la façon suivante :

  1. Créez le répertoire d'installation de l'agent de gestion sur un volume externe.
    Par exemple : 
    sudo mkdir -p /devext/oracle/mgmt_agent

    Dans l'exemple ci-dessus, /devext est un volume externe.

  2. Créez un lien symbolique dans le répertoire /opt/oracle pour pointer vers le volume externe.

    Avant d'exécuter la commande ci-dessous, vérifiez que le répertoire /opt/oracle existe déjà.

    Par exemple :
    sudo ln -s /devext/oracle/mgmt_agent /opt/oracle/mgmt_agent
  3. Vérifiez que le fichier Linux ZIP du logiciel de l'agent de gestion a été téléchargé. Pour plus de détails, voir Télécharger le logiciel de l'agent de gestion.
  4. Passez à un interpréteur de commandes racine, définissez la variable d'environnement OPT_ORACLE_SYMLINK = true et installez le logiciel de l'agent de gestion en tant qu'utilisateur racine.
    sudo /bin/bash
export OPT_ORACLE_SYMLINK=true
./installer.sh <full_path_of_response_file>
    Par exemple :
    sudo /bin/bash
export OPT_ORACLE_SYMLINK=true
./installer.sh ./input.rsp
  5. Une fois le processus d'installation terminé, vérifiez que l'utilisateur Linux mgmt_agent est responsable de l'emplacement d'installation de l'agent de gestion.
    stat -c '%U' /opt/oracle/mgmt_agent
mgmt_agent

sudo stat -c '%U' /opt/oracle/mgmt_agent/agent_inst
mgmt_agent

Installer l'agent de gestion sur Mac

L'installation de l'agent de gestion sur un Mac est prise en charge lors de l'utilisation du service de gestion Java. Pour plus de détails, voir Service de gestion Java, en particulier la section Installation d'un agent de gestion.

Installation de l'agent de gestion sur Windows Server

Pour installer le logiciel de l'agent de gestion sur Windows Server :

  1. Extrayez le logiciel de l'agent de gestion.

    Accédez au répertoire dans lequel vous avez téléchargé le fichier zip du logiciel de l'agent de gestion et décompressez celui-ci dans l'emplacement privilégié de votre choix.

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

  3. Installez et configurez l'agent de gestion en exécutant le script install.bat à l'aide d'un fichier de réponses. 
    installer.bat <full_path_of_response_file>
    La sortie se présente comme suit : 
    installer.bat C:\<user_home_directory>\input.rsp
Checking pre-requisites

        Checking if previous agent service exists
        Checking if C:\Oracle\mgmt_agent\agent_inst directory exists
        Checking if C:\Oracle\mgmt_agent\200820.0751 directory exists
        Checking available disk space for agent install
        Checking Java version
                Java version: 1.8.0_281 found at C:\Program Files\Java\jdk1.8.0_281
 
Executing install
        Unpacking software zip
        Copying files to destination dir (C:\Oracle\mgmt_agent)
        Initializing software from template
        Creating mgmt_agent service 

Agent install successful 

Executing configure

        Parsing input response file
        Generating communication wallet
        Validating install key
        Generating security artifacts
        Registering Management Agent

The mgmt_agent service is starting....
The mgmt_agent service was started successfully.


Agent setup completed and the agent is running
In the future agent can be started by directly running: NET START mgmt_agent
Please make sure that you delete C:\<user_home_directory>\input.rsp or store it in secure location.

Pour plus d'informations sur la création des fichiers de réponses, voir Créer un fichier de réponses.

Le processus d'installation de l'agent effectue les opérations suivantes :
  • Un nouveau répertoire est créé dans le cadre du processus d'installation de l'agent : C:\Oracle\mgmt_agent.
  • Le répertoire de base de l'installation de l'agent est celui où l'agent est installé. Par défaut, l'agent est installé sous C:\Oracle. Ce répertoire par défaut peut être modifié en réglant la variable d'environnement AGENT_INSTALL_BASEDIR avant d'exécuter le script install.bat.

  • Les fichiers journaux de l'installation de l'agent se trouvent dans le répertoire C:\Oracle\mgmt_agent\installer-logs.

Installation de l'agent de gestion sur le bureau Windows

L'installation de l'agent de gestion sur un bureau Windows est prise en charge lors de l'utilisation du service de gestion Java. Pour plus de détails, voir Service de gestion Java, en particulier la section Installation d'un agent de gestion.

Installer l'agent de gestion sous Solaris

Pour installer le logiciel de l'agent de gestion sous Solaris, procédez de la façon suivante :

  1. Extrayez le logiciel de l'agent de gestion.

    Accédez au répertoire dans lequel vous avez téléchargé le fichier zip du logiciel de l'agent de gestion et décompressez celui-ci dans l'emplacement privilégié de votre choix.

  2. Si le chemin d'accès à sudo n'est pas défini dans votre PATH, définissez la variable d'environnement SUDO_PATH avec le chemin d'accès à sudo. Vous pouvez utiliser l'option sudo -E pour conserver les variables d'environnement lors de l'exécution de la commande en tant que sudo.

    Vérifiez que useradd et groupadd se trouvent dans votre variable d'environnement PATH. Par exemple, si useradd se trouve dans l'emplacement /sbin/useradd, vérifiez que celui-ci se trouve dans votre chemin.

    Vérifiez que sudo se trouve dans votre variable d'environnement PATH. Par exemple, si sudo se trouve dans l'emplacement /usr/bin/sudo, vérifiez que la variable d'environnement PATH inclut l'emplacement "/usr/bin".

  3. Connectez-vous en tant qu'utilisateur disposant des privilèges sudo.

  4. Installez et configurez l'agent de gestion en exécutant le script installer.sh à l'aide d'un fichier de réponses.

    Pour plus d'informations sur la création des fichiers de réponses, voir Créer un fichier de réponses.

    Accédez au répertoire dans lequel vous avez décompressé le fichier ZIP du logiciel de l'agent de gestion et exécutez les opérations suivantes :
    sudo ./installer.sh <full_path_of_response_file>
    La sortie se présente comme suit : 
    sudo ./installer.sh <user_home_directory>/input.rsp 
Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        JAVA_HOME is not set or not readable to root
        Trying default path /usr/bin/java
        Java version: 1.8.0_282 found at /usr/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Creating 'mgmt_agent'daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo systemctl start mgmt_agent 

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.

    Le processus d'installation de l'agent effectue les opérations suivantes :
    • Un nouvel utilisateur nommé mgmt_agent est créé. Il s'agit de l'utilisateur de l'agent de gestion. Si l'utilisateur mgmt_agent existe déjà, le processus d'installation de l'agent l'utilise pour installer le logiciel de l'agent.
    • Lorsque le démon mgmt_agent est créé, l'ulimit des fichiers nofile durs et logiciels est réglé à 5000.
    • Tous les fichiers d'installation d'agent appartiennent à l'utilisateur mgmt_agent. Le répertoire de base de l'installation de l'agent est le répertoire où l'agent est installé. Le répertoire est créé dans le cadre du processus d'installation de l'agent sous le répertoire /opt/oracle/mgmt_agent.
    • Par défaut, le service mgmt_agent est activé et démarré automatiquement après l'installation de l'agent.

    Les fichiers journaux de l'installation de l'agent se trouvent sous le répertoire /opt/oracle/mgmt_agent/installer-logs.

    Les fichiers journaux de l'agent en cours d'exécution se trouvent sous /opt/oracle/mgmt_agent/agent_inst/log.

    Pour voir les fichiers journaux ou tout autre fichier d'installation d'agent, connectez-vous en tant qu'utilisateur mgmt_agent exécutant les éléments suivants :
    sudo -u mgmt_agent sh

Installer l'agent de gestion sur AIX

Pour installer le logiciel de l'agent de gestion sur AIX :
Note

sudo, unzip et OpenJDK 8 pour AIX sont requis avant de poursuivre l'installation de l'agent de gestion.

  1. Extrayez le fichier ZIP du logiciel de l'agent de gestion.

    Accédez au répertoire dans lequel vous avez téléchargé le fichier zip du logiciel de l'agent de gestion et décompressez celui-ci dans l'emplacement privilégié de votre choix.

    L'utilitaire unzip est requis pour l'installation. Pour plus d'informations sur unzip pour AIX, voir Boîte à outils AIX pour les logiciels à code source libre.

  2. Connectez-vous en tant qu'utilisateur disposant des privilèges sudo.

  3. Installez et configurez l'agent de gestion en exécutant le script installer.sh fournissant un fichier de réponses.

    Pour plus d'informations sur la création d'un fichier de réponses, voir Créer un fichier de réponses.

    Accédez au répertoire dans lequel vous avez décompressé le fichier zip du logiciel de l'agent de gestion et exécutez les commandes suivantes : 

    sudo sh installer.sh <full_path_of_response_file>

    Par exemple : sudo sh installer.sh /usr/input.rsp

    La sortie se présente comme suit : 
    Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        Trying /tmp/java/jdk8u372-b07
        Java version: 1.8.0_372 found at /tmp/java/jdk8u372-b07/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Checking if JavaScript engine is available to use       
    Creating mgmt_agent daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
0513-059 The mgmt_agent Subsystem has been started. Subsystem PID is 16122232.
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo startsrc -s mgmt_agent 

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
    Le processus d'installation de l'agent effectue les opérations suivantes :
    • Un nouvel utilisateur nommé mgmt_agent est créé. Il s'agit de l'utilisateur de l'agent de gestion. Si l'utilisateur mgmt_agent existe déjà, le processus d'installation de l'agent l'utilise pour installer le logiciel de l'agent.
    • Lorsque le démon mgmt_agent est créé, le nombre maximal de descripteurs de fichier (nofile ulimit) variables et fixes est réglé à 5000.
    • Tous les fichiers d'installation d'agent appartiennent à l'utilisateur mgmt_agent. Le répertoire de base de l'installation de l'agent est celui où l'agent est installé. Ce répertoire est créé dans le cadre du processus d'installation de l'agent sous /opt/oracle/mgmt_agent.
    • Par défaut, le service mgmt_agent est activé et démarré automatiquement après l'installation de l'agent.

    Les fichiers journaux de l'installation de l'agent se trouvent dans le répertoire /opt/oracle/mgmt_agent/installer-logs.

    Les fichiers journaux de l'agent en cours d'exécution se trouvent sous /opt/oracle/mgmt_agent/agent_inst/log.

    Pour voir les fichiers journaux ou tout autre fichier d'installation de l'agent, connectez-vous en tant qu'utilisateur mgmt_agent à l'aide de la commande suivante :
    sudo -u mgmt_agent sh

Installer plusieurs agents de gestion

L'agent de gestion prend en charge l'installation de plusieurs instances d'agent de gestion sur le même ordinateur pour répliquer les données collectées par l'agent entre les régions. Chaque agent de gestion est installé pointant vers une région OCI différente lors de la collecte à partir des mêmes sources.
Note

L'installation de plusieurs agents de gestion est actuellement disponible uniquement sous Linux.

Identificateurs de service d'agent

Les identificateurs de service d'agent sont utilisés pour identifier un service d'agent en présence d'autres instances d'agent sur une machine donnée afin d'éviter toute confusion. Chaque service d'agent de gestion peut être installé avec un identificateur spécifique qui permet de localiser et de gérer cette instance d'agent particulière.

Si l'installation d'un agent de gestion commence sans fournir d'identificateur de service, une installation par défaut est supposée être effectuée.

Tous les identificateurs de service doivent commencer par mgmt_agent-, suivis d'une chaîne composée uniquement de valeurs alphanumériques, de tirets ou de traits de soulignement, comme seuls les caractères autorisés. Par exemple : 
mgmt_agent-oc1_phx-abc123

Pour installer l'agent de gestion avec un identificateur de service, effectuez les étapes suivantes :

  1. Extrayez le logiciel de l'agent de gestion.

    Accédez au répertoire dans lequel vous avez téléchargé le fichier zip du logiciel de l'agent de gestion et décompressez celui-ci dans l'emplacement privilégié de votre choix.

  2. Connectez-vous en tant qu'utilisateur disposant des privilèges sudo.

  3. Pour installer et configurer l'agent de gestion, exécutez le script installer.sh à l'aide d'un fichier de réponses.

    Pour plus d'informations sur la création des fichiers de réponses, voir Créer un fichier de réponses.

    Accédez au répertoire dans lequel vous avez décompressé le fichier zip du logiciel de l'agent de gestion et exécutez les commandes suivantes :
    sudo ./installer.sh <full_path_of_response_file> <service identifier>
    Par exemple : 
    sudo ./installer.sh /tmp/input.rsp mgmt_agent-oc1_phx-abc123
    La sortie se présente comme suit : 
    sudo ./installer.sh <user_home_directory>/input.rsp mgmt_agent-oc1_phx-abc123
Checking pre-requisites
	Checking if any previous agent service exists
	Checking if OS has systemd or initd
	Checking available disk space for agent install
	Checking if /opt/oracle/mgmt_agent-oc1_phx-abc123 directory exists
	Checking if 'mgmt_agent' user exists
	Checking Java version
		JAVA_HOME is not set or not readable to root
		Trying default path /usr/bin/java
		Java version: 1.8.0_282 found at /usr/bin/java
	Checking agent version

Executing install
	Unpacking software zip
	Copying files to destination dir (/opt/oracle/mgmt_agent-oc1_phx-abc123)
	Initializing software from template
	Checking if JavaScript engine is available to use
	Creating mgmt_agent-oc1_phx-abc123 daemon
	Agent Install Logs: /opt/oracle/mgmt_agent-oc1_phx-abc123/installer-logs/installer.log.0

Agent install successful

Executing configure

	Parsing input response file
	Validating install key
	Generating communication wallet
	Generating security artifacts
	Registering Management Agent

Starting agent...
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo systemctl start mgmt_agent-oc1_phx-abc123

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
Le processus d'installation de l'agent effectue les opérations suivantes :
  • Un nouvel utilisateur nommé mgmt_agent est créé. Il s'agit de l'utilisateur de l'agent de gestion. Si l'utilisateur mgmt_agent existe déjà, le processus d'installation de l'agent l'utilise pour installer le logiciel de l'agent.
  • Démon utilisant l'identificateur de service comme nom créé.
  • Les ulimites de non-fichiers durs et souples sont réglés à 5000.
  • Tous les fichiers d'installation d'agent appartiennent à l'utilisateur mgmt_agent. Le répertoire de base de l'installation de l'agent est celui où l'agent est installé. Ce répertoire est créé dans le cadre du processus d'installation de l'agent sous /opt/oracle/<service-identifier> .
  • Par défaut, le service de démon <service-identifier> est activé et démarré automatiquement après l'installation de l'agent.
  • Toute interaction avec le service de démon d'agent, comme le démarrage ou l'arrêt d'un agent, peut être effectuée à l'aide de <service-identifier>. Par exemple : 
    sudo systemctl start <service-identifier>
sudo systemctl stop <service-identifier>

Les fichiers journaux de l'installation de l'agent se trouvent dans le répertoire /opt/oracle/<service-identifier>/installer-logs.

Les fichiers journaux de l'agent d'exécution se trouvent sous /opt/oracle/<service-identifier>/agent_inst/log.

Pour voir les fichiers journaux ou tout autre fichier d'installation de l'agent, connectez-vous en tant qu'utilisateur mgmt_agent à l'aide de la commande suivante :
sudo -u mgmt_agent sh

Vérifier l'installation de l'agent de gestion

Vérifier l'installation de l'agent à l'aide de l'interface utilisateur

Pour vérifier l'installation de l'agent à l'aide de l'interface utilisateur, procédez de la façon suivante :

  1. Dans la page principale des agents de gestion, cliquez sur Agents dans le menu de gauche.

    La page Agents affiche la liste des agents installés.

    Pour voir uniquement les agents, vous pouvez utiliser la section Filtres dans le menu de gauche :

    Allez à Filtres, utilisez la liste déroulante Type d'installation et sélectionnez Agent.

    Tous les agents s'affichent.

    Page de liste Agents montrant tous les agents de gestion installés.

  2. Dans la liste Agents, recherchez l'agent récemment installé à l'aide de la colonne Créé, qui affiche la date d'installation de l'agent, ou de la colonne Hôte, qui affiche le nom de l'hôte sur lequel l'agent a été installé.

Vérifier l'installation de l'agent à l'aide de l'interface de ligne de commande

Vérifier l'installation de l'agent à l'aide de l'interface de ligne de commande sous Linux

  1. Connectez-vous à l'hôte avec un utilisateur doté des privilèges sudo.

  2. Exécutez la commande suivante :

    Pour Oracle Linux 6 :
    sudo /sbin/initctl status mgmt_agent
    Pour Oracle Linux 7 : 
    sudo systemctl status mgmt_agent

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

Vérifier l'installation de l'agent à l'aide de l'interface de ligne de commande sous Windows

  1. Connectez-vous à l'hôte à l'aide de l'interpréteur de commandes d'un compte Administrator.

  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.

Vérifier l'installation de l'agent à l'aide de l'interface de ligne de commande sous Solaris

  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.

Dépanner les problèmes d'installation de l'agent de gestion