Documentation Oracle Cloud Infrastructure

Inscrire une station de gestion

Inscrivez une station de gestion auprès d'OS Management Hub à l'aide du profil correspondant et installez l'agent de gestion.

Lors de l'inscription, OS Management Hub associe les sources logicielles minimales requises à l'instance de station (Oracle Linux 8 BaseOS et Oracle Linux 8 Appstream). Ainsi, OS Management Hub peut fournir des mises à jour à l'instance agissant en tant que station.

Conseil

Des soucis ? Reportez-vous à Echec de l'inscription pour l'instance ou Management Station.

Avant de commencer

Pour enregistrer une station de gestion auprès du service OS Management Hub, procédez comme suit :

Installation des packages requis

La station de gestion est exécutée en tant qu'application serveur Apache dans son rôle de proxy réseau et de miroir yum local pour le service OS Management Hub. Vous devez installer le serveur Web Apache requis et démarrer et activer le service httpd.

Si votre station de gestion utilise SELinux, vous devez également installer le package policycoreutils-python-utils, qui fournit les utilitaires nécessaires pour gérer SELinux.

  1. Connectez-vous à l'instance en tant qu'utilisateur disposant des privilèges sudo.
  2. Installez les packages Apache requis. 
    sudo dnf install -y httpd mod_ssl openssl
  3. Démarrez et activez le service httpd. 
    sudo systemctl start httpd
sudo systemctl enable httpd
  4. Installez le package SELinux requis et toutes les dépendances. 
    sudo dnf install -y policycoreutils-python-utils

Ajouter le profil de station à l'instance

Ajoutez le profil de station à l'instance. Le profil identifie l'instance en tant que station de gestion. Le profil peut être utilisé pour enregistrer une seule station de gestion. Vous ne pouvez pas réutiliser les profils de station de gestion.
  1. Dans la console, copiez le contenu du profil de la station de gestion.
    1. Sous OS Management Hub, sélectionnez Stations de gestion.
    2. Sélectionnez le nom du poste de gestion dont vous souhaitez utiliser le profil.
    3. Sélectionnez Visualiser le profil.
    4. 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 de station de gestion. OS Management Hub requiert l'installation d'un agent de gestion sur l'instance et la fourniture d'un module d'extension de service au service d'agent de gestion.
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.

    sudo dnf 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 : 
    sudo --preserve-env=JAVA_HOME dnf install -y <rpm_file_name>.rpm

Configuration de l'agent de gestion

Créez le fichier de réponses de l'agent de gestion sur l'instance de station de gestion et configurez-le pour qu'il utilise l'agent de gestion avec le module d'extension de service OS Management Hub afin d'inscrire l'instance 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. 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. Assurez-vous que vous avez créé la clé d'installation de l'agent de gestion.
  4. 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.
  5. 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
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.
  6. 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.

  7. Configurez le pare-feu et les paramètres SELinux pour autoriser le trafic et l'accès.

    La station de gestion utilise les ports définis lors de la configuration pour synchroniser le miroir yum et gérer le trafic proxy vers OCI.

    Vous pouvez mettre à jour manuellement les règles de pare-feu et les paramètres SELinux ou utiliser le script station-setup.sh.

    Le script station-setup.sh configure le pare-feu et les paramètres SELinux pour autoriser le trafic sur les ports que vous avez spécifiés dans la configuration de proxy sur la station de gestion et le serveur Web Apache HTTP à servir les packages à partir du chemin dans la configuration miroir. Le script gère le pare-feu et la configuration SELinux pour les miroirs à l'aide du système de fichiers xfs, ext4, btrfs ou nfs.

    Important

    Pour plus de commodité, le script station-setup.sh est disponible pour configurer les paramètres de pare-feu et SELinux. Avant d'exécuter le script dans votre environnement de production, vérifiez le script et comprenez les modifications apportées au pare-feu et aux paramètres SELinux.
    sudo /opt/oracle/mgmt_agent/plugins/osmh/stateDir/station-setup.sh
    Remarque

    Si vous recevez un message d'erreur command not found ou No such file, attendez quelques minutes que la configuration du module d'extension OS Management Hub soit terminée et que le script station-setup.sh soit disponible. Si le problème persiste, l'enregistrement a peut-être échoué. Reportez-vous à Echec de l'inscription pour l'instance ou Management Station.
  8. Si vous n'avez pas exécuté le script station-setup.sh, redémarrez le serveur Web Apache HTTP. 
    sudo systemctl restart httpd

Vérifier l'enregistrement et les détails de la station de gestion

Vérifiez que la station de gestion est inscrite auprès d'OS Management Hub en tant qu'instance et qu'elle est disponible pour mettre en miroir et distribuer du contenu aux instances du centre de données.

  1. Sous OS Management Hub, sélectionnez Stations de gestion.
  2. Sélectionnez le compartiment qui contient la station de gestion.
  3. Vérifiez que la station de gestion est répertoriée dans le tableau et que son statut est Active.
    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 la station de gestion pour afficher ses détails.
    Important

    La liste des sources logicielles mises en miroir est vide jusqu'à ce que vous créiez un profil qui utilise la station. Reportez-vous à Quelles sont les sources logicielles mises en miroir ?.

Prochaines étapes

Après l'enregistrement de la station de gestion, les étapes suivantes peuvent inclure :