Installation de la passerelle de gestion

Suivez ces instructions pour installer la passerelle de gestion.

Téléchargement du logiciel de passerelle de gestion

Pour télécharger le logiciel de passerelle, procédez comme suit :

  1. Sur la page d'accueil Agents de gestion, cliquez sur Téléchargements et clés dans le menu de gauche pour afficher le panneau Téléchargement du logiciel.

    Le panneau Téléchargement du logiciel est affiché en haut de la page.

  2. Le panneau Téléchargement du logiciel répertorie tous les logiciels disponibles en téléchargement pour l'agent de gestion et la passerelle de gestion.

    Sélectionnez le système d'exploitation sur lequel la passerelle de gestion sera installée dans la colonne Télécharger.

  3. Cliquez sur le lien correspondant à votre système d'exploitation pour télécharger le fichier du logiciel de passerelle de gestion.

    Par exemple, cliquez sur Passerelle pour LINUX pour Linux ou sur Passerelle pour WINDOWS pour Windows.

Page Téléchargements et clés affichant la section Téléchargement du logiciel en haut avec un lien permettant de télécharger le fichier du logiciel.

Le fichier du logiciel de passerelle de gestion est désormais enregistré sur votre hôte.

Pour vérifier l'intégrité du fichier, assurez-vous que la valeur de la colonne Checksum SHA-256 correspond à la sortie de la commande suivante : sha256sum <fichier_téléchargement.rpm>

Remarque

L'URL de téléchargement de l'image logicielle Gateway est disponible uniquement via la commande d'interface de ligne de commande agent-image list ou l'API ListManagamentAgents avec une authentification OCI valide. Pour plus d'informations, reportez-vous à Téléchargement du logiciel Gateway à l'aide de l'interface de ligne de commande.

Téléchargement du logiciel Gateway à l'aide de la CLI

Pour télécharger le logiciel Management Gateway à l'aide de l'interface de ligne de commande, procédez comme suit :
  1. Obtenez la valeur object-url à l'aide de la commande CLI agent-image list avec l'option --install-type GATEWAY.
    oci management-agent agent-image list --compartment-id <tenancyId> --install-type GATEWAY

    La valeur object-url renvoyée est semblable à la suivante :

    https://objectstorage.<region_identifier>.oraclecloud.com/n/<namespace>/b/<bucketName>/o/Linux-x86_64/latest/oracle.mgmt_gateway.rpm

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

  2. Téléchargez le logiciel Management Gateway avec l'identité utilisateur authentifiée OCI à l'aide des valeurs <namespace> et <bucketName> de l'étape 1 :
    oci os object get --namespace <namespace> --bucket-name  <bucketName> --name Linux-x86_64/latest/oracle.mgmt_gateway.rpm  --file oracle.mgmt_gateway.rpm

    Pour vérifier l'intégrité du fichier, vérifiez si la valeur de la colonne SHA-256 Checksum correspond à la sortie de la commande suivante : sha256sum <download_file>

L'interface de ligne de commande Oracle Cloud Infrastructure (OCI) est un outil d'interface de ligne de commande. Pour plus d'informations, reportez-vous à interface de ligne de commande (CLI).

Remarque

Pour obtenir la valeur object-url, vous pouvez également utiliser l'API d'agent de gestion ListManagementAgentImages avec l'option installType=GATEWAY.

Création d'une clé d'installation

Vous devez créer une clé d'installation avant d'effectuer l'installation de la passerelle de gestion.

Une clé d'installation est émise pour votre domaine d'identité et valide l'authenticité de l'installation. Veillez à l'avoir créée avant de lancer le processus d'installation de la passerelle de gestion.

Pour plus d'informations sur la création d'une clé d'installation, reportez-vous à Création d'une clé d'installation.

Remarque

Cette étape ne peut être effectuée qu'une seule fois. Vous pouvez utiliser la même clé d'installation pour l'installation de la passerelle de gestion et celle de l'agent de gestion.

Configuration d'un fichier de réponses pour la passerelle de gestion

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

Examen des paramètres de passerelle de gestion

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

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

Tableau 7-2 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.
AgentDisplayName Facultatif Nom d'affichage de la passerelle en cours d'installation. Il s'agit d'une valeur unique. Si elle n'est pas indiquée, le système affecte une valeur par défaut.
BatchingEnabled Facultatif Il active la fonction de traitement par lots lors de l'installation de la passerelle de gestion.

Utilisez BatchingEnabled=true pour l'activer et permettre une gestion plus efficace et plus rapide des téléchargements de journalisation vers le service Log Analytics.

CredentialWalletPassword Facultatif Mot de passe du portefeuille de la passerelle si l'utilisateur fournit un mot de passe personnalisé pour le portefeuille afin de stocker les informations sensibles.
La longueur minimale du mot de passe est de 8 caractères avec les caractéristiques suivantes :
  • Au moins une lettre minuscule (a-z)
  • Au moins une lettre majuscule (A-Z)
  • Au moins un chiffre (0-9)
  • Au moins un caractère spécial de la liste suivante : !, @, #, %, ^, &, *

Tous les caractères du mot de passe doivent figurer parmi les caractères définis ci-dessus. Par exemple, si le mot de passe contient le caractère $, la vérification de la validité échouera car $ ne fait pas partie des caractères spéciaux répertoriés ci-dessus.

GatewayPort Facultatif Numéro de port utilisé par les agents, y compris les agents de gestion, lors de la connexion à la passerelle de gestion. Si aucun numéro de port n'est indiqué, la valeur sera définie sur 4480 par défaut.
GatewayUsername Facultatif Nom utilisateur employé pour l'authentification auprès du serveur de la passerelle. S'il est fourni, tous les clients doivent fournir ce nom utilisateur pour l'authentification. S'il n'est pas fourni, l'authentification ne sera pas requise pour la passerelle.
GatewayPassword Facultatif Mot de passe utilisé pour l'authentification auprès du serveur de la passerelle. S'il est fourni, tous les clients doivent fournir ce mot de passe pour l'authentification. S'il n'est pas fourni, l'authentification ne sera pas requise pour la passerelle.
GatewayCertOcid Facultatif

OCID du certificat OCI qui sera utilisé pour la prise en charge de Gateway HTTPS.

Le certificat doit se trouver dans le même compartiment que celui dans lequel la passerelle est installée.

GatewayCertCommonName Facultatif Nom de domaine complet (FQDN) fourni par l'utilisateur de l'hôte Management Gateway qui sera utilisé comme "Nom commun" lors du processus de création automatique de certificat (voir Processus de création automatique de certificat) dans le cadre de l'installation.

Par défaut, la passerelle de gestion utilise hostname -f comme valeur pour cette propriété.

ProxyHost Facultatif Adresse ou nom d'hôte du pare-feu ou du proxy externe. La passerelle de gestion utilisera cet hôte proxy (serveur) pour se connecter à OCI.

Si ce paramètre est fourni, ProxyPort doit également l'être.

ProxyPort Facultatif Numéro de port du serveur proxy du pare-feu ou du proxy externe. Si ce paramètre est fourni, ProxyHost doit également l'être.
ProxyUser Facultatif Nom utilisateur pour l'authentification auprès du pare-feu ou du proxy externe. Si ce paramètre est fourni, ProxyPassword doit également l'être.
ProxyPassword Facultatif Mot de passe utilisateur pour l'authentification auprès du pare-feu ou du proxy externe. Si ce paramètre est fourni, ProxyUser doit également l'être.
ProxyRealm Facultatif Domaine de sécurité d'authentification pour le pare-feu ou le proxy externe.
DefinedTags = [{"namespace1":{"<clé1>":"<valeur1>"}}, {"namespace2":{"<clé2>":"<valeur2>"}}] Facultatif Association de métadonnées de balise en cas d'utilisation de balises dans OCI. L'administrateur de balises crée et gère toutes les balises que les utilisateurs appliquent aux ressources. Les utilisateurs doivent avoir défini des stratégies de balise.

L'espace de noms de balise est un conteneur pour vos clés de balise. La clé de balise est une clé dans votre espace de noms. Vous devez créer des clés de balise pour les balises définies dans un espace de noms.

Pour les balises définies, la valeur de balise peut être de type Chaîne ou Liste de chaînes. Lors de la définition du type de valeur de balise, si le type défini était une chaîne, n'importe quelle valeur peut être saisie. En revanche, s'il s'agissait d'une liste de chaînes, cette valeur doit être l'une des chaînes de cette liste.

FreeFormTags = [{"<clé1>":"<valeur1>"}, {"<clé2>":"<valeur2>"}] Facultatif Association de métadonnées de balise en cas d'utilisation de balises dans OCI.

Ce paramètre est composé d'une clé et d'une valeur. La clé est le nom que vous utilisez pour faire référence à la balise. La valeur est celle que l'utilisateur appliquant la balise ajoute à la clé de balise.

Pour Haute disponibilité, il est recommandé de configurer ce paramètre. Pour plus de détails, reportez-vous à Configuration d'un fichier de réponses pour la haute disponibilité de la passerelle de gestion.

Pour Agent associé, si un agent de gestion se connecte via cette passerelle de gestion, ajoutez une balise nommée "GatewayGroup".

Par exemple : "GatewayGroup":"<User_Defined_ClusterName>

importTrustedCertsDirectory Facultatif

Emplacement des certificats CA racine supplémentaires au format PEM.

Utilisez ce paramètre si vous souhaitez ajouter des certificats CA racine supplémentaires au format PEM. La passerelle de gestion a effectué une recherche dans cet emplacement et a ajouté les certificats pendant l'installation.

Par exemple : importTrustedCertsDirectory=/tmp/crt

Création d'un fichier de réponses pour l'installation de la passerelle de gestion

Avant de continuer, vérifiez que vous avez lu et compris les informations fournies dans Examen des paramètres de passerelle de gestion.

Afin d'installer et de configurer des passerelles, vous devez créer un fichier de réponses et exécuter un script en utilisant ce dernier, qui pointera la passerelle vers la région OCI correcte et permettra la création d'une ressource pour la passerelle.

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

Option 1 : téléchargement d'un modèle de fichier de réponses pour créer un fichier de réponses

Vous pouvez télécharger un modèle de fichier contenant les paramètres de passerelle, qui peut être enregistré et utilisé comme fichier de réponses lors de l'installation de la passerelle.

Pour télécharger un modèle de fichier de réponses, utilisez l'option de menu Télécharger la clé dans un fichier de la liste Clés d'installation.
  • Cliquez sur Téléchargements et clés dans le menu de gauche pour ouvrir le panneau Clés d'installation. Dans la liste des clés d'installation, sélectionnez la clé à télécharger.

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

    Un fichier est téléchargé. Pour plus d'informations, reportez-vous à Téléchargement d'une clé d'installation.

Lors du téléchargement de la clé d'installation dans un fichier, le fichier téléchargé contient différents paramètres, y compris la valeur de la clé d'installation 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, consultez-le et modifiez les paramètres de passerelle obligatoires. Reportez-vous à Examen des paramètres de passerelle de gestion.
  • Enlevez le paramètre Service.plugin.*. Il s'agit d'un paramètre propre aux agents. Il n'est utilisé que pour les installations d'agent.
  • Annulez la mise en commentaire (enlevez le symbole # du début de la ligne) des paramètres de passerelle requis pour votre configuration de passerelle spécifique et mettez à jour les valeurs des paramètres de passerelle. Par exemple, les paramètres suivants doivent être ajoutés au fichier : GatewayPort, GatewayUsername et GatewayPassword.
  • Mettez en commentaire (ajoutez le symbole # au début de la ligne) ou enlevez les paramètres dont vous n'avez pas besoin pour votre configuration de passerelle spécifique.
  • Enregistrez le fichier de réponses mis à jour. Par exemple, il peut être enregistré en tant que fichier de réponses gateway.rsp.

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

Vous pouvez créer un fichier de réponses manuellement à l'aide d'un éditeur de texte. Par exemple, vous pouvez créer un fichier à l'aide de l'éditeur de texte de votre choix, ajouter les paramètres de passerelle requis pour votre configuration d'agent au fichier de réponses et l'enregistrer. Par exemple, le fichier de réponses peut être enregistré sous gateway.rsp.

Exemple de fichier de réponses gateway.rsp :
managementAgentInstallKey = MS4wLHVzLWFzaGJ1cm4tMSxvY2lkMS50ZW5hbmN5

Après avoir créé le fichier de réponses à l'aide de l'une des options ci-dessus, vérifiez les droits d'accès du fichier et assurez-vous qu'il dispose de droits d'accès en lecture pour l'utilisateur mgmt_agent.

Installation de la passerelle de gestion

Installation de la passerelle de gestion dans le fichier RPM de Linux

Pour installer le logiciel de passerelle de gestion sous Linux, procédez comme suit :
  1. Connectez-vous en tant qu'utilisateur disposant de privilèges sudo.

  2. Installez le logiciel de passerelle de gestion.

    Accédez au répertoire dans lequel vous avez téléchargé le fichier RPM de la passerelle 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_gateway-<VERSION>.rpm

    La sortie obtenue ressemble à ce qui suit :
    
    Preparing...        ################################# [100%]
    Checking pre-requisites
         Checking if any previous gateway service exists        
    Checking if OS has systemd or initd
         Checking available disk space for gateway 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 gateway version
    Updating /  installing...
       1:oracle.mgmt_gateway-<VERSION>################################# [100%]
    
    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_gateway' daemon        
            Gateway Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0
    
            Setup gateway using input response file (run as any user with 'sudo' privileges)
            Usage:
                    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=[FULL_PATH_TO_INPUT.RSP]
    
             Gateway install successful
    Le processus d'installation effectue les opérations suivantes :
    • Un utilisateur nommé mgmt_agent est créé. Il sera l'utilisateur de passerelle de gestion. Si l'utilisateur mgmt_agent existe déjà, le processus d'installation l'utilisera pour installer le logiciel de passerelle.
    • Tous les fichiers de passerelle sont copiés et installés par l'utilisateur mgmt_agent. Le répertoire de base de l'installation est le répertoire dans lequel la passerelle est installée. Le répertoire est créé dans le cadre du processus d'installation de la passerelle sous /opt/oracle/mgmt_agent.
    • Par défaut, le service/démon mgmt_gateway est activé et démarré automatiquement après l'installation de la passerelle.
    Les fichiers journaux de l'installation de la passerelle se trouvent sous le répertoire /opt/oracle/mgmt_agent/installer-logs. Pour afficher les fichiers journaux ou tout autre fichier d'installation, connectez-vous en tant qu'utilisateur mgmt_agent en exécutant la commande suivante :
    sudo -u mgmt_agent sh
  3. Configurez la passerelle de gestion en exécutant le script setupGateway.sh avec un fichier réponse.
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<full_path_of_response_file>
    La sortie obtenue ressemble à ce qui suit :
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<user_home_directory>/gateway.rsp
    
    Executing configure
           Parsing input response file
           Validating install key
           Generating communication wallet
           Generating security artifacts
           Registering Management Gateway
                   Found service plugin(s): [GatewayProxy]
    
    Starting gateway...
    Gateway started successfully
    
    Starting plugin deployment for: [GatewayProxy]
    Deploying service plugin(s)......Done.
            GatewayProxy : Successfully deployed external plugin
    
    Gateway setup completed and the gateway is running.
    In the future gateway can be started by directly running: sudo systemctl start mgmt_gateway
    
    Please make sure that you delete <user_home_directory>/gateway.rsp or store it in secure location.
    
    Creating Wallets
    Wallets created successfully
    Waiting for Gateway to start...
    Gateway Proxy started successfully
    

Pour plus d'informations sur la création de fichiers de réponses, reportez-vous à Création d'un fichier de réponses pour l'installation de la passerelle de gestion.

Installation de la passerelle de gestion dans le fichier ZIP de Linux

Pour installer le logiciel de passerelle de gestion sous Linux à l'aide d'un fichier ZIP, procédez comme suit :
Remarque

L'emplacement d'installation par défaut se trouve sous le volume /opt. Si vous préférez utiliser un volume externe pour installer la passerelle de gestion, reportez-vous à Installation de la passerelle de gestion sur un volume externe à l'aide d'un fichier ZIP Linux.
  1. Extrayez le logiciel de passerelle de gestion.

    Accédez au répertoire dans lequel vous avez téléchargé le fichier ZIP du logiciel de passerelle de gestion et décompressez-le à l'emplacement de votre choix.

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

  3. Installez et configurez la passerelle de gestion en exécutant le script installer.sh fournissant un fichier de réponses. Pour obtenir des informations sur la création d'un fichier de réponses, reportez-vous à Création d'un fichier de réponses.

    Accédez au répertoire dans lequel vous avez décompressé le fichier ZIP du logiciel de passerelle de gestion et exécutez la commande suivante :
    sudo ./installer.sh

    Par exemple : sudo ./installer.sh

    La sortie obtenue ressemble à ce qui suit :
    sudo ./installer.sh
    Checking pre-requisites    
        Checking if any previous gateway service exists    
        Checking if OS has systemd or initd    
        Checking available disk space for gateway install    
        Checking if /opt/oracle/mgmt_agent directory exists    
        Checking if 'mgmt_agent' user exists        
            'mgmt_agent' user already exists, the gateway will proceed installation without creating a new one.    
        Checking Java version        
            JAVA_HOME is not set or not readable to root        
            Trying default path /usr/bin/java        
            Java version: 1.8.0_272 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    
        Checking if JavaScript engine is available to use    
        Creating 'mgmt_gateway' daemon    
        Gateway Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0    
        Setup gateway using input response file (run as any user with 'sudo' privileges)    
        Usage:        
            sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=[FULL_PATH_TO_INPUT.RSP] 
    
    Gateway install successful
  4. Configurez la passerelle de gestion en exécutant le script setupGateway.sh avec un fichier réponse.
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<full_path_of_response_file>
    La sortie obtenue ressemble à ce qui suit :
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=/u01/oracle/management_agent/input.rsp
    Validating response file
    Successfully validated response file
    /opt/oracle/mgmt_agent/agent_inst/bin/setupAgent.sh opts=/u01/oracle/management_agent/input.rsp 
    
    Executing configure     
        Parsing input response file        
        Validating install key    
        Generating communication wallet    
        Generating security artifacts    
        Registering Management Gateway        
            Found service plugin(s): [GatewayProxy] 
    
    Starting gateway...
    Gateway started successfully 
    
    Starting plugin deployment for: [GatewayProxy]
    Deploying service plugin(s).........Done.    
        GatewayProxy : Successfully deployed external plugin 
    
    Gateway setup completed and the gateway is running.
    In the future gateway can be started by directly running: sudo systemctl start mgmt_gateway
    Please use OCI CLI or OCI Management Agent console to validate the successful activation of your agent. 
    
    Please make sure that you delete /u01/oracle/management_agent/input.rsp or store it in secure location. 
    
    Checking for plugin to be deployed
    Plugin deployed successfully
    Setting up Gateway
    Creating gateway system properties file
    Creating properties file
    Creating or validating certificates
    Waiting for Management Gateway to create or validate certificates ...
    Creating wallets
    Wallets created successfully
    Waiting for Management Gateway to setup ...
    Management Gateway Plugin set up successfully.

Pour plus d'informations sur la création de fichiers de réponses, reportez-vous à Création d'un fichier de réponses pour l'installation de la passerelle de gestion.

Installation de la passerelle de gestion sur un volume externe à l'aide du fichier ZIP Linux

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

Pour installer la passerelle de gestion sur un volume externe sous Linux, procédez comme suit :

  1. Créez le répertoire d'installation de la passerelle 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 ZIP du logiciel de passerelle de gestion Linux a été téléchargé. Pour plus de détails, reportez-vous à Téléchargement du logiciel d'agent de gestion.
  4. Passez à un shell root, définissez la variable d'environnement OPT_ORACLE_SYMLINK = true et installez le logiciel de passerelle de gestion en tant qu'utilisateur root.
    sudo /bin/bash
    export OPT_ORACLE_SYMLINK=true
    ./installer.sh
    Par exemple :
    sudo /bin/bash
    export OPT_ORACLE_SYMLINK=true
    ./installer.sh 
  5. Une fois le processus d'installation terminé, vérifiez que l'utilisateur Linux mgmt_agent est le propriétaire de l'emplacement d'installation de la passerelle de gestion.
    stat -c '%U' /opt/oracle/mgmt_agent
    mgmt_agent
    
    sudo stat -c '%U' /opt/oracle/mgmt_agent/agent_inst
    mgmt_agent

Installation de la passerelle de gestion sous Windows

Pour installer le logiciel de passerelle de gestion sous Windows, procédez comme suit :
  1. Extrayez le logiciel de passerelle de gestion.

    Accédez au répertoire dans lequel vous avez téléchargé le fichier ZIP du logiciel de passerelle de gestion et décompressez-le à l'emplacement de votre choix.

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

  3. Installez la passerelle de gestion en exécutant le script installer.bat.
    installer.bat
    La sortie obtenue ressemble à ce qui suit :
    Checking pre-requisites
            Checking if previous gateway service exists
            Checking if C:\Oracle\mgmt_agent\agent_inst directory exists       
            Checking if C:\Oracle\mgmt_agent\agent_inst\plugins directory exists
            Checking Java version
                    Java version: 1.8.0_371 found at C:\Program Files\Java\jdk-1.8
            Checking if C:\Oracle\mgmt_agent\231214.1713 directory exists
    Executing install
            Unpacking software zip
            Copying files to destination dir (C:\Oracle\mgmt_agent) 
            Initializing software from template
            Checking if JavaScript engine is available to use
            Creating mgmt_gateway service
    Gateway install successful
    Setup gateway using input response file
           Usage:         
           C:\Oracle\mgmt_agent\agent_inst\bin\setupGateway.bat [FULL_PATH_TO_INPUT.RSP]
  4. Configurez la passerelle de gestion en exécutant le script setupGateway.bat avec le fichier de réponses.
    <Management_Agent_path>\setupGateway.bat <full_path_of_response_file>
    Par exemple :
    C:\Oracle\mgmt_agent\agent_inst\bin\setupGateway.bat c:\tmp\input.rsp
    Le résultat ressemble à ce qui suit :
    Validating response file
    Validating certificate properties
    Successfully validated response file
    
    Executing configure     
            Parsing input response file
            Validating install key       
            Generating communication wallet
            Generating security artifacts     
            Registering Management Gateway
                    Found service plugin(s): [GatewayProxy]
    
    The Oracle Management Gateway service is starting...
    The Oracle Management Gateway service was started successfully.
    
    Starting plugin deployment for: [GatewayProxy]
    Deploying service plugin(s)...Done.
            GatewayProxy : Successfully deployed external plugin
    
    Management Gateway setup completed and is running
    In the future agent can be started by directly running: NET START mgmt_gateway
    Please use OCI CLI or OCI Management Agent console to validate the successful activation of your agent."
    
    Please make sure that you delete C:\tmp\input.rsp or store it in secure location.
    
    Checking for plugin to be deployed
    Plugin deployed successfully
    Setting up Gateway
    Creating gateway system properties file
    Creating properties file
    Creating or validating certificates
    Waiting for Management Gateway to create or validate certificates ...
    Waiting for Management Gateway to create or validate certificates ...
    Waiting for Management Gateway to create or validate certificates ...
    Waiting for Management Gateway to create or validate certificates ...
    Waiting for Management Gateway to create or validate certificates ...
    Wallets created successfully
    Waiting for Management Gateway to setup ...
    Management Gateway Plugin set up successfully.
Le processus d'installation de la passerelle :
  • Un 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 le répertoire dans lequel la passerelle sera installée.

    Par défaut, la passerelle est installée sous le répertoire C:\Oracle. Vous pouvez changer le répertoire par défaut en définissant la variable d'environnement AGENT_INSTALL_BASEDIR avant d'exécuter le script installer.bat.

  • Les fichiers journaux de l'installation de la passerelle de gestion se trouvent sous les répertoires C:\Oracle\mgmt_agent\installer-logs et C:\Oracle\mgmt_agent\plugins\GatewayProxy\stateDir\logs.

Vérification de l'installation de la passerelle de gestion

Vérification de l'installation de la passerelle de gestion à l'aide de l'interface utilisateur

Pour vérifier l'installation de l'agent à l'aide de l'interface utilisateur, procédez comme suit :

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

    La page Agents et passerelles apparaît avec la liste de tous les agents et de toutes les passerelles installés.

    Pour afficher uniquement les passerelles, accédez au menu de gauche et employez les filtres : utilisez le filtre Type d'installation et sélectionnez Passerelle.

    Toutes les passerelles sont affichées.

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

Vérification de l'installation de la passerelle de gestion à l'aide de l'interface de ligne de commande sous Linux

  1. Connectez-vous à l'hôte à l'aide d'un utilisateur disposant de privilèges sudo.
  2. Exécutez la commande suivante :

    Pour Oracle Linux 6 : sudo /sbin/initctl status mgmt_gateway

    Pour Oracle Linux 7 : sudo systemctl status mgmt_gateway

    Pour plus de détails, consultez le fichier journal /opt/oracle/mgmt_agent/plugins/GatewayProxy/stateDir/log/mgmt_gateway.log.

Vérification de l'installation de la passerelle de gestion à l'aide de l'interface de ligne de commande sous Windows

  1. Connexion à l'hôte
  2. Exécutez la commande suivante :
    sc query mgmt_gateway

    Pour plus de détails, consultez le fichier journal /opt/oracle/mgmt_agent/plugins/GatewayProxy/stateDir/log/mgmt_gateway.log.