Port Management Gateway

Pour modifier la valeur du port Management Gateway, modifiez le fichier gateway.properties et remplacez la valeur en cours de la propriété GatewayPort par le numéro de port souhaité.

Si la valeur de la propriété GatewayPort change, tout agent de gestion utilisant cette passerelle de gestion doit être modifié pour utiliser la nouvelle valeur de port. Pour plus de détails, reportez-vous à Mise à jour des agents de gestion après les modifications apportées à la configuration de Management Gateway.

Informations d'identification Management Gateway

La passerelle est généralement configurée pour utiliser les informations d'identification : le nom utilisateur et le mot de passe sont requis pour la connexion.

Ces informations d'identification sont stockées dans les portefeuilles Oracle. Pour plus d'informations sur l'ajout, la mise à jour ou la suppression d'informations d'identification, reportez-vous à Configuration des informations d'identification Management Gateway.

Si les informations d'identification de la passerelle de gestion changent, tous les agents de gestion qui utilisent la passerelle de gestion doivent être modifiés pour utiliser les nouvelles informations d'identification. Pour plus d'informations, reportez-vous à Mise à jour des agents de gestion après les modifications de la configuration de Management Gateway.

Une passerelle de gestion stocke des informations confidentielles, telles que des informations d'identification, dans des portefeuilles Oracle.

Après avoir installé une passerelle de gestion, vous devrez peut-être configurer des informations d'identification.

• Mise à niveau d'une passerelle de gestion sous Linux
• Mise à niveau de la passerelle de gestion sous Linux à l'aide d'un fichier ZIP
• Mise à niveau d'une passerelle de gestion sous Windows

Mise à niveau d'une passerelle de gestion sous Linux

Mise à niveau de la passerelle de gestion sous Linux à l'aide d'un fichier ZIP

Pour mettre à niveau une passerelle sous Linux à l'aide d'un fichier ZIP, procédez comme suit :

• Pour plus de détails, reportez-vous à Téléchargement du 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.
• Pour mettre à niveau la passerelle, exécutez le script installer.sh avec l'option :-u

  installer.sh -u

• Le résultat ressemble à ce qui suit :

  sudo ./installer.sh -u
  Checking pre-requisites
          Checking available disk space for gateway upgrade
          Checking agent version 
  
  Executing install
          Unpacking software zip
          Copying files to destination dir (/opt/oracle/mgmt_agent)
          Updating communication wallet 
          Creating 'mgmt_gateway' daemon
          Starting mgmt_gateway
          Gateway Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log
  
  Gateway upgrade successful

Mise à niveau d'une passerelle de gestion sous Windows

Lors de la suppression d'une passerelle de gestion d'un hôte, celle-ci n'est pas inscrite auprès des agents de gestion Cloud Service avant d'être enlevée de l'hôte.

Pour supprimer ou désinstaller la passerelle de gestion des systèmes d'exploitation suivants, procédez comme suit :

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

Suppression de la passerelle de gestion sous Linux à l'aide de la commande RPM

sudo rpm -e <rpm_name>

Suppression de la passerelle de gestion sous Linux à l'aide d'un script de désinstallation

Exécutez le script uninstaller.sh si vous avez installé la passerelle de gestion à l'aide des fichiers ZIP.

Le résultat se présente comme suit :

$ sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the Gateway from Management Agent Cloud service, please do not interrupt...
Attempting to remove the Gateway from Management Agent Cloud service,please do not interrupt...
Gateway was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_gateway...
Removing mgmt_gateway daemon from systemd...
Removed symlink /etc/systemd/system/multi-user.target.wants/mgmt_gateway.service.
Gateway was removed from the host successfully.
Executing post-remove step from uninstall
Gateway state directory was removed from the host successfully.

Enlever la passerelle de gestion sous Windows

Ouvrez une fenêtre d'invite de commande, accédez au répertoire de base de l'installation de la passerelle de gestion et exécutez le script uninstaller.bat.

C:\Oracle>mgmt_agent\uninstaller.bat
Removing Management Gateway from the OCI service console.
Attempting to remove the agent from Management Agent Cloud service, do not interrupt...
Gateway was removed from the Management Agent Cloud service successfully.
Removing Management Gateway service from the host 
Management Gateway service was removed from the host successfully
Removing Management Gateway directories

Assurez-vous que toutes les autres fenêtres d'invite de commande sont fermées ou qu'elles ne pointent pas vers le répertoire de base de la passerelle de gestion avant d'exécuter le script uninstaller.bat.

1. Dans la console Oracle Cloud, ouvrez le menu de navigation et sélectionnez Identité et sécurité.
2. Accédez à Certificats et sélectionnez Certificats.
3. Cliquez sur Créer un certificat.
4. Sélectionnez le compartiment dans lequel importer le certificat, qui doit correspondre au compartiment dans lequel la passerelle de gestion est installée.
5. Pour importer un certificat que vous prévoyez de gérer à l'aide d'une autorité de certification, cliquez sur Importé en tant que type de certificat.
6. Entrez un nom d'affichage unique pour le certificat. Evitez de saisir des informations confidentielles.
7. Vous pouvez éventuellement entrer une description pour le certificat.
8. Vous devez entrer une clé privée et le certificat de chaîne.

   Le certificat est prêt à être utilisé lorsque le statut du certificat est Actif dans la console Oracle Cloud.

9. Ensuite, vous devez copier l'OCID de certificat, puis entrer l'OCID en tant que paramètre dans le fichier de réponses de la passerelle de gestion lors de l'installation de la passerelle de gestion au format suivant. Reportez-vous à Configuration d'un fichier de réponses pour la passerelle de gestion.

   GatewayCertOcid=ocid1.certificate.oc1.iad.<unique-id>

10. Pour importer les mêmes certificats dans l'agent de gestion, procédez comme suit afin que l'interaction de bout en bout fonctionne.

Prérequis

1. Identifiez un utilisateur de système d'exploitation valide pour effectuer l'installation de la passerelle de gestion et utilisez-le comme valeur pour la variable RUN_AGENT_AS_USER.
   Oracle recommande que l'utilisateur du système d'exploitation sélectionné dispose des privilèges les plus faibles et ne dispose d'aucun shell de connexion.

   id -un <username>

   Exemple 1 :

   id -un myexistinguser

   L'utilisateur du système d'exploitation myexistinguser existe. La sortie renvoie la valeur de l'utilisateur sélectionné et ressemble à ce qui suit :

   myexistinguser

   Exemple 2 :

   id -un mytestuser2

   L'utilisateur du système d'exploitation mytestuser2 n'existe pas et n'est pas valide. La sortie ne renvoie aucune valeur utilisateur et ressemble à ce qui suit :

   id: mytestuser2: no such user

2. Identifiez le groupe principal de l'utilisateur à utiliser comme valeur pour la variable AGENT_USER_GROUP.
   Assurez-vous que la valeur de AGENT_USER_GROUP est le groupe d'utilisateurs principal de l'utilisateur de système d'exploitation sélectionné.

   Remarque
   
   L'utilisation d'un groupe secondaire n'est pas prise en charge et peut entraîner une altération de la passerelle de gestion.

   id -gn <username>

   Exemple :

   id -gn myexistinguser

   Le résultat se présente comme suit :

   staff

Définition des variables d'environnement et installation de la passerelle de gestion

1. Configurez les variables d'environnement suivantes :

   RUN_AGENT_AS_USER=<selected_OS_user_for_ManagementGateway_installation>
   AGENT_USER_GROUP=<OS_primary_group_of_selected_OS_user>

   Exemple :

   RUN_AGENT_AS_USER=myexistinguser
   AGENT_USER_GROUP=staff

2. Assurez-vous que la variable d'environnement ci-dessus est accessible par l'utilisateur du système d'exploitation root.

   Par défaut, les variables d'environnement ne sont pas partagées avec l'utilisateur root.

3. Vérifiez que les variables d'environnement sont correctement définies en exécutant la commande suivante :

   sudo su
   echo $RUN_AGENT_AS_USER
   echo $AGENT_USER_GROUP

   Par exemple, la sortie ressemble à ce qui suit :

   myexistinguser
   staff

   Si root ne parvient pas à accéder aux variables d'environnement, modifiez le fichier /etc/sudoers et ajoutez les éléments suivants :

   Defaults env_keep+=RUN_AGENT_AS_USER
   Defaults env_keep+=AGENT_USER_GROUP

   Ce qui précède garantit que les variables d'environnement RUN_AGENT_AS_USER et AGENT_USER_GROUP sont conservées et accessibles par l'utilisateur root.

   Après avoir mis à jour le fichier /etc/sudoers, définissez à nouveau les variables d'environnement et vérifiez que root peut accéder aux variables d'environnement.

4. Une fois la vérification terminée, vous pouvez démarrer l'installation de la passerelle de gestion : connectez-vous en tant que root, définissez les variables d'environnement, puis démarrez l'installation de la passerelle de gestion.

   En fonction de votre méthode préférée, vous pouvez suivre les instructions de Installation de la passerelle de gestion sur le fichier RPM Linux ou de Installation de la passerelle de gestion sur le fichier ZIP Linux.

   Par exemple, suivez les instructions de la section Install Management Gateway on Linux RPM file. Dans ce cas, ignorez l'étape 1 car vous êtes déjà root et vous n'avez pas besoin des privilèges sudo. Commencez à l'étape 2 : rpm -ivh <rpm_file_name.rpm>