Documentation Oracle Cloud Infrastructure

Inscription d'une instance sans OCI

Inscrivez une instance cloud tierce sur site ou prise en charge en installant les packages nécessaires, en ajoutant un profil d'inscription et en installant l'agent de gestion.

Important

Le clonage d'une machine virtuelle déjà inscrite auprès de OS Management Hub n'est pas pris en charge.

Avant de commencer

Avant d'inscrire une instance auprès d'OS Management Hub, vous devez effectuer les opérations suivantes :

Ajouter le profil d'inscription à l'instance

  1. Dans la console, copiez le contenu de la source logicielle, du groupe ou du profil de cycle de vie.
    1. Sous OS Management Hub, sélectionnez Profils.
    2. Sélectionnez le nom du profil.
    3. Vérifiez que les informations de profil identifient une station de gestion. Cela confirme que le profil est pour les instances sur site ou cloud tiers.
    4. Si le type du profil est correct, sélectionnez Visualiser.
    5. Copiez le contenu du profil.
  2. Connectez-vous à l'instance en tant qu'utilisateur disposant 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 de profil que vous avez copié à partir de la console et enregistrez le fichier.

Installation de l'agent de gestion

Installez le logiciel d'agent de gestion sur l'instance. L'agent de gestion utilise le module d'extension OS Management Hub pour inscrire les instances auprès du service OS Management Hub.

Remarque

Pour plus d'informations sur l'installation du logiciel d'agent de gestion, reportez-vous à 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. Si ce n'est pas le cas, 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 packages requis. Cela inclut Java 8 (version 1.8u281 minimum ou version 1.8 ultérieure).

    Java 8 doit être installé sur l'instance avant d'installer le logiciel d'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 des versions plus récentes sont sur le système. 
    JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk ; export JAVA_HOME
  4. Accédez au répertoire contenant le fichier RPM du logiciel d'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

Configuration de l'agent de gestion

Activez l'agent de gestion avec le module d'extension OS Management Hub. Lors de l'activation, l'instance s'inscrit auprès du service OS Management Hub dans le compartiment indiqué dans la clé d'installation et avec le contenu associé au profil.

  1. Configurez le module d'extension d'agent de gestion pour qu'il s'exécute en tant qu'utilisateur root. Le module d'extension OS Management Hub doit être exécuté en tant qu'utilisateur root pour appliquer des patches à 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 inscrire l'instance.
    1. Ouvrez le menu de navigation et sélectionnez Observation 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 inscrire 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 avec 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 module d'extension OS Management Hub (osmh) lors de l'installation de l'agent.

    Afin d'utiliser la station de gestion comme proxy pour toutes les communications OS Management Hub avec l'instance, ajoutez les paramètres suivants dans le fichier input.rsp.

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

    1. Sous OS Management Hub, 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 proxy à utiliser dans le fichier input.rsp.
  5. Configurez l'agent de gestion en exécutant le script setup.sh avec le fichier de réponses. 
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=/tmp/input.rsp

    Une configuration réussie renvoie le message suivant : Agent setup completed and the agent is running. La configuration du module d'extension OS Management Hub peut prendre encore quelques minutes en arrière-plan.

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

Vérifiez l'instance inscrite auprès d'OS Management Hub.

  1. Sous OS Management Hub, sélectionnez Instances.
  2. Sous Champ d'application de la liste, sélectionnez le compartiment contenant l'instance.
  3. Vérifiez que l'instance apparaît dans la table et que son statut est Actif.
    Conseil

    Pour résoudre les problèmes d'inscription, reportez-vous à Echec de l'inscription pour l'instance ou Management Station.

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

    Sous Informations sur l'instance, vous pouvez visualiser des détails sur l'instance, tels que le profil d'inscription utilisé pour l'inscription auprès du service et s'il est membre d'un groupe ou d'un environnement de cycle de vie, le cas échéant.

    Remarque

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