Installer la passerelle de gestion

Suivez ces instructions pour installer la passerelle de gestion.

Télécharger le logiciel de la passerelle de gestion

Pour télécharger le logiciel de la passerelle, procédez de la façon suivante :

  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 Téléchargement du logiciel.

    Le volet Téléchargement du logiciel s'affiche en haut de la page.

  2. Le volet Téléchargement du logiciel répertorie tous les logiciels pouvant être téléchargés 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 de votre système d'exploitation pour télécharger le fichier du logiciel de la passerelle.

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

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

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

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

Note

L'URL de téléchargement de l'image logicielle de passerelle est disponible uniquement au moyen de la commande de la CLI agent-image list ou de l'API ListManagamentAgents avec une authentification OCI valide. Pour plus de détails, voir Télécharger le logiciel de passerelle à l'aide de l'interface de ligne de commande.

Télécharger le logiciel de la passerelle à partir de l'interface de ligne de commande

Pour télécharger le logiciel de la passerelle de gestion à l'aide de l'interface de ligne de commande, procédez de la façon suivante :
  1. Obtenez la valeur object-url à l'aide de la commande de l'interface de ligne de commande 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 retournée est similaire à la suivante :

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

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

  2. Téléchargez le logiciel de la passerelle de gestion avec le principal authentifié 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 d'Oracle Cloud Infrastructure est un outil d'interface de ligne de commande. Pour plus d'informations, voir interface de ligne de commande.

Note

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

Créer une clé d'installation

Vous devez créer une clé d'installation avant de procéder à 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. Assurez-vous qu'elle a été créée avant de démarrer le processus d'installation de la passerelle de gestion.

Pour plus de détails sur la création d'une clé d'installation, voir Créer une clé d'installation.

Note

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

Configurer 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 de la passerelle propres à votre environnement.

Vérifier les paramètres de la passerelle de gestion

Un fichier de réponses contenant les paramètres de la 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. Cette valeur est unique. Si elle n'est pas précisé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 fournir une gestion améliorée et plus rapide des chargements de journalisation dans le service Log Analytics.

CredentialWalletPassword Facultatif Mot de passe du portefeuille de la passerelle 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.

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 ce numéro de port n'est pas spécifié, la valeur est réglée à 4480 par défaut.
GatewayUsername Facultatif Nom d'utilisateur utilisé pour l'authentification auprès du serveur de passerelle. S'il est fourni, tous les clients doivent fournir ce nom d'utilisateur pour l'authentification. S'il ne l'est pas, l'authentification n'est pas exigée pour la passerelle.
GatewayPassword Facultatif Mot de passe utilisé pour l'authentification auprès du serveur de passerelle. S'il est fourni, tous les clients doivent fournir ce mot de passe pour l'authentification. S'il ne l'est pas, l'authentification n'est pas exigée pour la passerelle.
GatewayCertOcid Facultatif

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

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 de la passerelle de gestion 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 par défaut pour cette propriété.

ProxyHost Facultatif Nom d'hôte ou adresse du mandataire ou du pare-feu externe. La passerelle de gestion utilise cet hôte mandataire (serveur) pour se connecter à OCI.

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

ProxyPort Facultatif Numéro de port du serveur mandataire du mandataire ou du pare-feu externe. Si ce paramètre est indiqué, ProxyHost doit l'être également.
ProxyUser Facultatif Nom d'utilisateur à authentifier auprès du mandataire ou du pare-feu externe. Si ce paramètre est indiqué, ProxyPassword doit l'être également.
ProxyPassword Facultatif Mot de passe de l'utilisateur pour l'authentification auprès du mandataire ou du pare-feu externe. Si ce paramètre est indiqué, ProxyUser doit l'être également.
ProxyRealm Facultatif Domaine d'authentification du mandataire ou pare-feu externe.
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.

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 Haute disponibilité, il est recommandé de configurer ce paramètre. Pour plus de détails, voir Configurer un fichier de réponses pour la haute disponibilité de la passerelle de gestion.

Pour Agent associé, si un agent de gestion se connecte au moyen de cette passerelle de gestion, ajoutez un marqueur nommé "GatewayGroup".

Par exemple : "GatewayGroup":"<User_Defined_ClusterName>

importTrustedCertsDirectory Facultatif

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

Utilisez ce paramètre pour ajouter des certificats d'autorité de certification racine supplémentaires au format PEM. La passerelle de gestion a effectué une recherche à cet emplacement et a ajouté les certificats lors de l'installation.

Par exemple : importTrustedCertsDirectory=/tmp/crt

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

Avant de continuer, assurez-vous d'avoir lu et compris les informations présentées dans Vérifier les paramètres de la passerelle.

Pour installer et configurer des passerelles, vous devez créer un fichier de réponses et exécuter un script à l'aide du nouveau fichier de réponses, dans lequel la passerelle pointe vers la région OCI appropriée et qui autorise 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é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 la passerelle qui peuvent être enregistrés et utilisés en tant que fichier de réponses pendant 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é vers le fichier de la liste Clés d'installation de la passerelle.
  • Cliquez sur Téléchargements et clés dans le menu de gauche pour ouvrir le volet Clés d'installation de la passerelle. Dans la liste des clés d'installation, 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 la passerelle vers un fichier, le fichier téléchargé contient les paramètres de la passerelle, y compris la valeur de la clé d'installation de la passerelle 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 de passerelle obligatoires. Voir Vérifier les paramètres de la passerelle de gestion.
  • Supprimez le paramètre Service.plugin.*. Il s'agit d'un paramètre propre à l'agent. Il n'est utilisé que pour les installations d'agent.
  • Annulez la mise en commentaire (supprimez le symbole # du début de la ligne) des paramètres requis pour votre configuration de passerelle spécifique et mettez à jour les valeur des paramètres de la passerelle. Par exemple, les paramètres suivants : GatewayPort, GatewayUsername et GatewayPassword doivent être ajoutés au fichier.
  • 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 de passerelle spécifique.
  • Enregistrez le fichier de réponses mis à jour. Par exemple, ce fichier de réponses peut être enregistré sous le nom gateway.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 de passerelle au fichier de réponses, puis l'enregistrer. Par exemple, ce fichier de réponses peut être enregistré sous le nom 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 autorisations du fichier et assurez-vous que l'utilisateur mgmt_agent dispose de l'autorisation de lecture.

Installer la passerelle de gestion

Installer la passerelle de gestion dans le fichier RPM de Linux

Pour installer le logiciel de la passerelle de gestion sous Linux, procédez de la façon suivante :
  1. Connectez-vous en tant qu'utilisateur disposant des privilèges sudo.

  2. Installez le logiciel de la passerelle de gestion.

    Accédez au répertoire où 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 se présente comme 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 de la passerelle effectue les opérations suivantes :
    • Un nouvel utilisateur nommé mgmt_agent est créé. Il s'agit de l'utilisateur de la passerelle de gestion. Si l'utilisateur mgmt_agent existe déjà, le processus d'installation de la passerelle l'utilise pour installer le logiciel de la passerelle.
    • Tous les fichiers de la passerelle sont copiés et installés par l'utilisateur mgmt_agent. Le répertoire de base d'installation est celui où la passerelle est installée. Ce répertoire est créé dans le cadre du processus d'installation de la passerelle sous /opt/oracle/mgmt_agent.
    • Par défaut, le service 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 dans le répertoire /opt/oracle/mgmt_agent/installer-logs. Pour voir les fichiers journaux ou tout autre fichier d'installation de la passerelle, connectez-vous en tant qu'utilisateur mgmt_agent à l'aide de la commande suivante :
    sudo -u mgmt_agent sh
  3. Configurez la passerelle de gestion en exécutant le script setupGateway.sh à l'aide d'un fichier de réponses.
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<full_path_of_response_file>
    La sortie se présente comme 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éponse, voir Créer un fichier de réponses pour l'installation de la passerelle de gestion.

Installer la passerelle de gestion dans le fichier ZIP de Linux

Pour installer le logiciel de la passerelle de gestion sous Linux à l'aide d'un fichier ZIP, effectuez les étapes suivantes :
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 la passerelle de gestion, voir Installer la passerelle de gestion sur un volume externe à l'aide d'un fichier ZIP Linux.
  1. Extrayez le logiciel de la passerelle de gestion.

    Accédez au répertoire dans lequel vous avez téléchargé le fichier ZIP du logiciel de la passerelle 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 la passerelle 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.

    Naviguez jusqu'au répertoire où vous avez décompressé le fichier ZIP du logiciel de la passerelle de gestion et exécutez les opérations suivantes :
    sudo ./installer.sh

    Par exemple : sudo ./installer.sh

    La sortie se présente comme 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 à l'aide d'un fichier de réponses.
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<full_path_of_response_file>
    La sortie se présente comme 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éponse, voir Créer un fichier de réponses pour l'installation de la passerelle de gestion.

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

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 la passerelle de gestion sur un volume externe à l'aide du fichier Linux ZIP et de la création d'un lien symbolique.

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

  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 Linux ZIP du logiciel de la passerelle 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 la passerelle de gestion en tant qu'utilisateur racine.
    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 responsable 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 la passerelle de gestion sous Windows :
  1. Extrayez le logiciel de la passerelle de gestion.

    Accédez au répertoire dans lequel vous avez téléchargé le fichier ZIP du logiciel de la passerelle 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 la passerelle de gestion en exécutant le script installer.bat.
    installer.bat
    La sortie se présente comme 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 à l'aide du 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
    La sortie ressemble à la suivante :
    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 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ù la passerelle est installée.

    Par défaut, la passerelle est installée sous C:\Oracle. Le répertoire par défaut peut être modifié en réglant 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 dans les répertoires C:\Oracle\mgmt_agent\installer-logs et C:\Oracle\mgmt_agent\plugins\GatewayProxy\stateDir\logs.

Vérifier l'installation de la passerelle de gestion

Vérifier 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 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 et passerelles affiche la liste des agents et des passerelles installés.

    Pour voir uniquement les passerelles, utilisez la section Filtres du menu de gauche : Utilisez le filtre Type d'installation et sélectionnez Passerelle.

    Toutes les passerelles s'affichent.

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

Vérifier l'installation de la passerelle de gestion à 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_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érifier l'installation de la passerelle de gestion à l'aide de l'interface de ligne de commande sous Windows

  1. Se connecter à 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.