Enregistrement d'une instance non OCI

Enregistrez une instance en nuage de tierce partie sur place ou prise en charge en installant les ensembles nécessaires, en ajoutant un profil d'enregistrement et en installant l'agent de gestion.

Important

Le clonage d'une machine virtuelle déjà enregistrée dans le centre de gestion du système d'exploitation n'est pas pris en charge.

Avant de commencer

Avant d'enregistrer une instance dans le centre de gestion du système d'exploitation, vous devez effectuer les opérations suivantes :

Ajouter le profil d'inscription à l'instance

  1. Dans la console, copiez le contenu de la source de logiciels, du groupe ou du profil de cycle de vie.
    1. Sous Centre de gestion du système d'exploitation, sélectionnez Profils.
    2. Sélectionnez le nom du profil.
    3. Vérifiez que les informations de profil identifient un poste de gestion. Cela confirme que le profil est destiné aux instances sur place ou de nuage tiers.
    4. Si le type de profil est correct, sélectionnez Voir.
    5. Copiez le contenu du profil.
  2. Connectez-vous à l'instance en tant qu'utilisateur doté des privilèges sudo
  3. Créez le fichier /etc/osmh-profile (sans extension de fichier sur le nom de fichier) à l'aide d'un éditeur de texte. Exemple :
    sudo vi /etc/osmh-profile
  4. Collez le contenu du profil que vous avez copié à partir de la console et enregistrez le fichier.

Installez l'agent de gestion

Installez le logiciel de l'agent OMA sur l'instance. L'agent de gestion utilise le plugiciel du centre de gestion du système d'exploitation pour enregistrer des instances auprès du service du centre de gestion du système d'exploitation.

Note

Pour plus de détails sur l'installation du logiciel de l'agent de gestion, voir Installation des agents de gestion.
  1. Vérifiez que /etc/sudoers inclut /etc/sudoers.d :
    sudo visudo

    Vérifiez que les lignes suivantes sont présentes. Sinon, ajoutez-les et enregistrez le fichier.

    ## Read drop-in files from /etc/sudoers.d (the # here does not mean a comment)
    #includedir /etc/sudoers.d
  2. Installez les ensembles requis. Cela inclut Java 8 (minimum 1.8u281 ou une version 1.8 ultérieure).

    Java 8 doit être installé sur l'instance avant d'installer le logiciel de l'agent de gestion.

    Oracle Linux 9
    sudo dnf install -y java-1.8.0-openjdk chkconfig
    Oracle Linux 8
    sudo dnf install -y java-1.8.0-openjdk
    Oracle Linux 7
    sudo yum install -y java-1.8.0-openjdk
  3. Définissez la variable d'environnement JAVA_HOME pour utiliser Java 8. La définition de la variable garantit que MACS utilise la version Java correcte lorsque de nouvelles versions sont sur le système.
    JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk ; export JAVA_HOME
  4. Accédez au répertoire qui contient le fichier RPM du logiciel de l'agent de gestion téléchargé et exécutez la commande suivante pour installer le fichier RPM :
    Oracle Linux 8 ou 9
    sudo --preserve-env=JAVA_HOME dnf install -y <rpm_file_name>.rpm
    Oracle Linux 7
    sudo --preserve-env=JAVA_HOME yum install -y <rpm_file_name>.rpm

Configurer l'agent de gestion

Activez l'agent de gestion avec le plugiciel du centre de gestion du système d'exploitation. Lors de l'activation, l'instance s'enregistre auprès du service du centre de gestion du système d'exploitation dans le compartiment spécifié dans la clé d'installation et avec le contenu associé au profil.

  1. Configurez le plugiciel d'agent de gestion pour qu'il s'exécute en tant que racine. Le plugiciel du centre de gestion du système d'exploitation doit s'exécuter en tant que racine pour appliquer des correctifs à l'instance. Exemple :
    sudo tee /etc/sudoers.d/mgmt_agent <<EOF
    ## Allows Management Agent to change ownership of deployed External Plugin
    mgmt_agent ALL=(ALL) NOPASSWD:/opt/oracle/mgmt_agent/agent_inst/bin/chown_recursive_ep.sh
    ## Allows Management Agent to run External Plugin under root user
    mgmt_agent ALL=(root) NOPASSWD:SETENV: /opt/oracle/mgmt_agent/plugins/osmh/*/osmh
    ## Disable requiretty for Management Agent
    Defaults:mgmt_agent !requiretty
    EOF
  2. Définissez les autorisations du fichier sur 440.
    sudo chmod 440 /etc/sudoers.d/mgmt_agent
  3. Dans la console, copiez la clé d'installation de l'agent de gestion à utiliser pour enregistrer l'instance.
    1. Ouvrez le menu de navigation et sélectionnez Observabilité et gestion. Sous Agent de gestion, sélectionnez Téléchargements et clés.
    2. Sous Clés d'installation, recherchez la clé à utiliser pour enregistrer l'instance.
    3. Sélectionnez le menu Actions de la clé et sélectionnez Copier la clé dans le presse-papiers.
  4. Créez un fichier de réponse (input.rsp) manuellement à l'aide d'un éditeur de texte et remplacez <MACS_KEY> par la clé d'installation que vous avez copiée à l'étape précédente.

    Exemple :

    cat >/tmp/input.rsp <<EOF
    ManagementAgentInstallKey = <MACS_KEY>
    Service.plugin.osmh.download = true
    GatewayServerHost = <STATION_OR_LOAD_BALANCER_HOSTNAME>
    GatewayServerPort = <STATION_PROXY_PORT>
    EOF

    Le fichier input.rsp requiert les paramètres obligatoires suivants.

    • ManagementAgentInstallKey : Clé d'installation requise pour valider l'identité du domaine et l'authenticité de l'installation.
    • Service.plugin.osmh.download = true : Déploie le plugiciel de centre de gestion du système d'exploitation (osmh) lors de l'installation de l'agent.

    Pour utiliser la station de gestion comme mandataire pour toutes les communications du centre de gestion du système d'exploitation avec l'instance, ajoutez les paramètres suivants dans le fichier input.rsp.

    Pour identifier le nom d'hôte et le port mandataire de la station de gestion, procédez comme suit dans la console :

    1. Sous Centre de gestion du système d'exploitation, sélectionnez Profils.
    2. Sélectionnez le profil associé à l'instance.
    3. Dans la section Informations sur le profil, sélectionnez le nom de la station de gestion.
    4. Sélectionnez l'onglet Configuration.
    5. Enregistrez les valeurs Nom d'hôte et Port d'écoute du mandataire à utiliser dans le fichier input.rsp.
  5. Configurez l'agent de gestion en exécutant le script setup.sh à l'aide du fichier de réponses.
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=/tmp/input.rsp

    Une configuration réussie retourne le message suivant : Agent setup completed and the agent is running. La configuration du plugiciel du centre de gestion du système d'exploitation peut prendre encore quelques minutes en arrière-plan.

Vérifier l'enregistrement et les détails de l'instance

Vérifiez l'instance enregistrée auprès du centre de gestion du système d'exploitation.

  1. Sous Centre de gestion du système d'exploitation, sélectionnez Instances.
  2. Sous Portée de la liste, sélectionnez le compartiment qui contient l'instance.
  3. Vérifiez que l'instance apparaît dans le tableau et que le statut est Actif.
    Conseil

    Pour dépanner les problèmes d'inscription, voir Échec de l'inscription pour l'instance ou le poste de gestion.

  4. Sélectionnez le nom de l'instance pour en voir les détails.

    Sous Informations sur l'instance, vous pouvez voir les détails de l'instance, tels que le profil d'inscription qu'elle a utilisé pour s'inscrire au service et s'il s'agit d'un membre d'un groupe ou d'un environnement de cycle de vie, le cas échéant.

    Note

    L'instance peut prendre quelques minutes pour signaler l'inventaire initial de l'ensemble et du module au service.