Documentation Oracle Cloud Infrastructure

Exécution des tâches de postinstallation pour la passerelle de gestion

Configurer des agents de gestion avec la passerelle de gestion

Après avoir installé la passerelle de gestion, vous devez configurer chaque agent de gestion pour qu'il utilise la passerelle de gestion qui vient d'être installée et non le proxy d'entreprise.

La passerelle de gestion sera configurée pour se connecter à Internet via n'importe quel pare-feu.

Du côté de l'agent OMA, les mêmes paramètres sont utilisés pour configurer l'accès via une passerelle de gestion que via un proxy standard.

Une fois l'installation de la passerelle de gestion terminée, configurez les agents de gestion.

Il existe deux scénarios :

  • Configuration d'un nouvel agent de gestion pour qu'il utilise la passerelle de gestion

    Dans ce scénario, vous configurez un tout nouvel agent de gestion pour qu'il utilise la passerelle de gestion nouvellement installée.

    L'agent OMA doit être configuré pour pointer vers la passerelle de gestion en définissant les paramètres suivants lors de l'installation de l'agent :
    • GatewayServerHost
    • GatewayServerPort
    • GatewayServerUser
    • GatewayServerPassword
    Pour plus d'informations sur la configuration des paramètres ci-dessus et du fichier de réponses lors du processus d'installation de l'agent de gestion, reportez-vous à Configuration d'un fichier de réponses.

    Pour plus d'informations sur l'installation des agents de gestion, reportez-vous à Installation des agents de gestion.

  • Configurez un agent de gestion existant pour qu'il utilise la passerelle de gestion.

    Dans ce scénario, vous configurez un agent de gestion existant pour qu'il utilise la passerelle de gestion nouvellement installée.

    La configuration de l'agent de gestion existant doit être mise à jour et définie de sorte à pointer vers la passerelle de gestion, en procédant comme suit :

    1. Assurez-vous que l'agent de gestion est en cours d'exécution.
    2. Si la passerelle de gestion est configurée pour exiger une authentification, créez un fichier d'informations d'identification contenant le nom utilisateur et le mot de passe requis pour se connecter à la passerelle de gestion.

      Par exemple, un fichier /opc/my_cred_file.json contenant les informations d'identification à configurer peut être créé. 

      {
  "source":"agent.<OCID_OF_THE_AGENT>",  <---Prefix the OCID of the agent with "agent."
  "name":"ManagementAgent-Gateway",
  "type":"ProxyCreds",
  "description":"These credentials are used to connect to Management Gateway.",
  "tags":["GatewayServerHost:gatewayhost.myco.com","GatewayServerPort:3128"],
  "properties":
  [
    { "name":"ProxyUser", "value":"<USER_NAME>" },
    { "name":"ProxyPassword", "value":"<USER_PASSWORD>" }
  ]
}
    3. Ajoutez les informations d'identification indiquées dans le fichier /opc/my_cred_file.json à l'aide du script credential_mgmt.sh.
      cat /opc/my_cred_file.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s Agent
    4. Supprimez le fichier d'informations d'identification /opc/my_cred_file.json.
    5. Arrêtez l'agent de gestion.
    6. Mettez à jour le fichier emd.properties de l'agent de gestion en ajoutant les paramètres GatewayServerHost et GatewayServerPort.

      Le fichier emd.properties se trouve dans le répertoire /opt/oracle/mgmt_agent/agent_inst/config.

      Par exemple : 

      GatewayServerHost=proxyhost.example.com
GatewayServerPort=3128
    7. Démarrez l'agent de gestion.

    Pour plus d'informations sur les paramètres des agents de gestion, reportez-vous à Examen des paramètres d'agent.

Ajouter ou mettre à jour des informations de proxy pour la passerelle de gestion

Vous pouvez ajouter ou mettre à jour les informations de proxy, telles que l'hôte proxy, le port et/ou les informations d'identification après l'installation de la passerelle de gestion.

Remarque

Au cours de l'installation de la passerelle de gestion, la passerelle de gestion peut être configurée pour acheminer via un serveur proxy en fournissant les informations de proxy (hôte, port et informations d'identification) à l'aide d'un fichier de réponses. Si vous installez la passerelle de gestion, reportez-vous à Configuration d'un fichier de réponses pour la passerelle de gestion pour plus de détails.

Cette section fournit des informations sur l'ajout d'informations de proxy une fois que la passerelle de gestion a déjà été installée.

Voici quelques scénarios courants :
  • Au cours du processus d'installation de la passerelle de gestion, les informations sur le proxy n'ont pas été fournies. Il se peut que vous ayez oublié de l'ajouter au fichier réponse ou que les informations sur le proxy ne soient pas disponibles à l'époque.
  • La passerelle de gestion doit être acheminée via un proxy ou un pare-feu après son installation.
  • Des modifications ont été apportées au serveur proxy. Par exemple, les informations sur le serveur proxy ont été fournies lors de l'installation, mais après, elles doivent être remplacées par un autre serveur proxy. (Il se peut que l'utilisateur souhaite que la passerelle de gestion soit acheminée via une autre passerelle).

Prérequis : la passerelle de gestion doit avoir été installée sans fournir les informations sur le proxy ou installée avec un proxy qui doit maintenant être modifié.

Etape 1 : ajouter ou mettre à jour les informations de proxy dans le fichier emd.properties

Modifiez le fichier /opt/oracle/mgmt_agent/agent_inst/config/emd.properties et ajoutez les propriétés ci-dessous à la fin du fichier :

ProxyHost=<Nom d'hôte ou adresse du serveur proxy ou du pare-feu>

ProxyPort=<Numéro de port du serveur proxy ou du pare-feu>

Par exemple :
ProxyHost=myproxy.example.com
ProxyPort=80

Si la passerelle de gestion était déjà configurée avec un serveur proxy et que l'utilisateur doit la remplacer par un autre serveur proxy, les propriétés ProxyHost et ProxyPort doivent déjà être présentes dans le fichier emd.properties. Mettez à jour les propriétés ci-dessus pour utiliser les nouvelles valeurs du serveur proxy.

Etape 2 (facultatif) : mise à jour des informations d'identification de proxy dans la passerelle de gestion

Si le serveur proxy dispose d'informations d'identification, vous devez les mettre à jour. Pour obtenir des instructions, reportez-vous à Mise à jour des informations d'identification de proxy pour la passerelle de gestion.

Etape 3 : Redémarrage de la passerelle de gestion

Pour Linux, utilisez
sudo systemctl restart mgmt_gateway
Pour Windows, utilisez
net stop mgmt_gateway
net start mgmt_gateway