Port de la passerelle de gestion

Pour modifier la valeur du port de la passerelle de gestion, modifiez le fichier gateway.properties et remplacez la valeur courante 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, voir Mettre à jour les agents de gestion après les modifications apportées à la configuration de la passerelle de gestion

Données d'identification de la passerelle de gestion

La passerelle est généralement configurée pour utiliser les données d'identification : le nom d'utilisateur et le mot de passe sont requis pour s'y connecter.

Ces informations d'identification sont stockées dans les portefeuilles Oracle. Pour plus d'informations sur l'ajout, la mise à jour ou la suppression de données d'identification, voir Configurer les données d'identification de la passerelle de gestion.

Si les données 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 données d'identification. Pour plus d'informations, voir Mettre à jour les agents de gestion après les modifications apportées à la configuration de la passerelle de gestion.

La passerelle de gestion stocke les informations sensibles, telles que les données d'identification, dans des portefeuilles Oracle.

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

• Mettre à niveau la passerelle de gestion sous Linux
• Mettre à niveau la passerelle de gestion sous Linux à l'aide d'un fichier zip
• Mettre à niveau la passerelle de gestion sous Windows

Mettre à niveau la passerelle de gestion sous Linux

Mettre à niveau 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 de la façon suivante :

• Télécharger la dernière version du fichier ZIP contenant le fichier de téléchargement du logiciel de la passerelle. Pour plus de détails, voir Télécharger 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.
• Pour mettre à niveau la passerelle, exécutez le script installer.sh avec l'option :-u

  installer.sh -u

• La sortie ressemble à la suivante :

  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

Mettre à niveau la passerelle de gestion sous Windows

Lors de la suppression d'une passerelle de gestion d'un hôte, celle-ci n'est pas enregistrée dans le service Cloud Service des agents de gestion avant d'être supprimée de l'hôte.

Pour supprimer ou désinstaller la passerelle de gestion des systèmes d'exploitation suivants, vous pouvez suivre les étapes suivantes :

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

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

sudo rpm -e <rpm_name>

Supprimer 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.

La sortie ressemble à la suivante :

$ 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.

Supprimer la passerelle de gestion sous Windows

Ouvrez une fenêtre d'invite de commande, naviguez jusqu'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. Allez à Certificats et sélectionnez Certificats.
3. Cliquez sur Créer un certificat.
4. Sélectionnez le compartiment dans lequel vous voulez importer le certificat. Il doit s'agir du 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. Évitez d'entrer des informations confidentielles.
7. Facultativement, vous pouvez 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 son statut est Actif dans la console Oracle Cloud.

9. Ensuite, vous devez copier l'OCID du 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 à l'aide du format suivant, voir Configurer un fichier de réponses pour la passerelle de gestion.

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

10. Effectuez les étapes suivantes pour importer les mêmes certificats dans l'agent de gestion afin que l'interaction de bout en bout fonctionne.

Préalables

1. Identifiez un utilisateur de système d'exploitation valide pour effectuer l'installation de la passerelle de gestion et utilisez-la comme valeur pour la variable RUN_AGENT_AS_USER.
   Oracle recommande à l'utilisateur du système d'exploitation sélectionné d'avoir le moins de privilèges et aucun interpréteur de commandes de connexion.

   id -un <username>

   Exemple 1 :

   id -un myexistinguser

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

   myexistinguser

   Exemple 2 :

   id -un mytestuser2

   L'utilisateur de système d'exploitation mytestuser2 n'existe pas et n'est pas un utilisateur valide. La sortie ne retourne 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é.

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

   id -gn <username>

   Exemple :

   id -gn myexistinguser

   La sortie ressemble à la suivante :

   staff

Définir les variables d'environnement et installer la passerelle de gestion

1. Définissez 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 définies correctement en exécutant les opérations suivantes :

   sudo su
   echo $RUN_AGENT_AS_USER
   echo $AGENT_USER_GROUP

   Par exemple, la sortie ressemble à ce qui suit :

   myexistinguser
   staff

   Si root ne peut 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, réglez de 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.

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

   Par exemple, suivez les instructions sous Installer la passerelle de gestion sur le fichier RPM Linux. Dans ce cas, ignorez l'étape 1 car vous êtes déjà root et vous n'avez pas besoin de privilèges sudo. Commencez à l'étape 2 : rpm -ivh <rpm_file_name.rpm>