Registro de una estación de gestión

Registre una estación de gestión con OS Management Hub utilizando el perfil de la estación de gestión e instalando Management Agent.

Tras el registro, OS Management Hub asocia los orígenes de software mínimos necesarios a la instancia de estación (Oracle Linux 8 BaseOS y Oracle Linux 8 Appstream). Esto garantiza que OS Management Hub pueda proporcionar actualizaciones a la instancia que actúa como estación.

Antes de empezar

Para registrar correctamente una estación de gestión con el servicio OS Management Hub, complete lo siguiente:

Instalación de los paquetes necesarios

La estación de gestión se ejecuta como una aplicación de servidor Apache en su rol como proxy de red y reflejo de yum local para el servicio OS Management Hub. Debe instalar el servidor web Apache necesario e iniciar y activar el servicio httpd.

Si la estación de gestión utiliza SELinux, también debe instalar el paquete policycoreutils-python-utils, que proporciona las utilidades necesarias para gestionar SELinux.

  1. Conéctese a la instancia como usuario con privilegios sudo.
  2. Instale los paquetes de Apache requeridos.
    sudo dnf install -y httpd mod_ssl openssl
  3. Inicie y active el servicio httpd.
    sudo systemctl start httpd
    sudo systemctl enable httpd
  4. Instale el paquete SELinux necesario y cualquier dependencia.
    sudo dnf install -y policycoreutils-python-utils
    

Adición del perfil de estación a la instancia

Agregue el perfil de estación a la instancia. El perfil identifica la instancia como una estación de gestión. El perfil se puede utilizar para registrar solo una única estación de gestión. No puede reutilizar perfiles de estación de gestión.
  1. En la consola, copie el contenido del perfil de la estación de gestión.
    1. En OS Management Hub, seleccione Estaciones de gestión.
    2. Seleccione el nombre de la estación de gestión cuyo perfil desea utilizar.
    3. Seleccione Ver perfil.
    4. Copie el contenido del perfil.
  2. Conéctese a la instancia como usuario con privilegios sudo
  3. Cree el archivo /etc/osmh-profile (sin extensión de archivo en el nombre de archivo) mediante un editor de texto. Por ejemplo:
    sudo vi /etc/osmh-profile
  4. Pegue el contenido del perfil que ha copiado de la consola y guarde el archivo.

Instalación de Management Agent

Instale el software Management Agent en la instancia de la estación de gestión. OS Management Hub requiere que Management Agent se instale en la instancia y proporciona un plugin de servicio al servicio Management Agent.
Nota

Para obtener más información sobre la instalación del software del agente de gestión, consulte Instalación de agentes de gestión.
  1. Verifique que /etc/sudoers incluye /etc/sudoers.d:
    sudo visudo

    Confirme que están presentes las siguientes líneas. Si no es así, agréguelos y guarde el archivo.

    ## Read drop-in files from /etc/sudoers.d (the # here does not mean a comment)
    #includedir /etc/sudoers.d
  2. Instale los paquetes necesarios. Esto incluye Java 8 (como mínimo 1.8u281 o una versión posterior de 1.8).

    Java 8 se debe instalar en la instancia antes de instalar el software Management Agent.

    sudo dnf install -y java-1.8.0-openjdk
  3. Defina la variable de entorno JAVA_HOME para que utilice Java 8. La configuración de la variable garantiza que MACS utilice la versión correcta de Java cuando haya versiones más recientes en el sistema.
    JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk ; export JAVA_HOME
  4. Vaya al directorio que contiene el archivo RPM downloaded Management Agent y ejecute el siguiente comando para instalar el archivo RPM:
    sudo --preserve-env=JAVA_HOME dnf install -y <rpm_file_name>.rpm

Configuración del agente de gestión

Cree el archivo de respuesta de Management Agent en la instancia de la estación de gestión y configure el archivo de respuesta para utilizar Management Agent con el plugin de servicio OS Management Hub para registrar la instancia con el servicio OS Management Hub

Nota

Para obtener más información sobre la instalación del software del agente de gestión, consulte Instalación de agentes de gestión.
  1. Configure el plugin de Management Agent para que se ejecute como raíz. El plugin de OS Management Hub debe ejecutarse como raíz para aplicar parches a la instancia. Por ejemplo:.
    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. Establezca los permisos del archivo en 440.
    sudo chmod 440 /etc/sudoers.d/mgmt_agent
  3. Asegúrese de que ha creado la clave de instalación de Management Agent.
  4. En la consola, copie la clave de instalación de Management Agent que se utilizará para registrar la instancia.
    1. Abra el menú de navegación y seleccione Observación y gestión. En Management Agent, seleccione Descargas y claves.
    2. En Claves de instalación, busque la clave que desea utilizar para registrar la instancia.
    3. Seleccione el menú Acciones de la clave y seleccione Copiar clave en portapapeles.
  5. Cree un archivo de respuesta (input.rsp) manualmente con un editor de texto y sustituya <MACS_KEY> por la clave de instalación que ha copiado en el paso anterior.

    Por ejemplo:

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

    El archivo input.rsp necesita los siguientes parámetros obligatorios.

    • ManagementAgentInstallKey: clave de instalación necesaria para validar la identidad del dominio y la autenticación de la instalación.
    • Service.plugin.osmh.download = true: despliega el plugin de OS Management Hub (osmh) durante la instalación del agente.
  6. Configure el agente de gestión ejecutando el script setup.sh mediante el archivo de respuesta.
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=/tmp/input.rsp

    Una configuración correcta devuelve el siguiente mensaje: Agent setup completed and the agent is running. La configuración del plugin de OS Management Hub puede tardar otros minutos en segundo plano.

  7. Configure el firewall y los valores de SELinux para permitir el tráfico y el acceso.

    La estación de gestión utiliza los puertos definidos durante la configuración para sincronizar el reflejo de yum y gestionar el tráfico de proxy a OCI.

    Puede actualizar manualmente las reglas de firewall y la configuración de SELinux o utilizar el script station-setup.sh.

    El script station-setup.sh configura el firewall y los valores de SELinux para permitir el tráfico en los puertos que ha especificado en la configuración de proxy en la estación de gestión y el servidor web Apache HTTP para servir paquetes desde la ruta en la configuración de reflejo. La secuencia de comandos maneja la configuración de firewall y SELinux para reflejos mediante el sistema de archivos xfs, ext4, btrfs o nfs.

    Importante

    Para su comodidad, el script station-setup.sh está disponible para configurar el firewall y los valores de SELinux. Antes de ejecutar el script en el entorno de producción, asegúrese de revisar el script y comprender los cambios que el script realiza en el firewall y la configuración de SELinux.
    sudo /opt/oracle/mgmt_agent/plugins/osmh/stateDir/station-setup.sh
    Nota

    Si recibe un mensaje de error command not found o No such file, espere unos minutos a que finalice la configuración del plugin del hub de gestión del sistema operativo y que el script station-setup.sh esté disponible. Si el problema persiste, es posible que el registro haya fallado. Consulte Error de registro para la instancia o la estación de gestión.
  8. Si no ha ejecutado el script station-setup.sh, reinicie el servidor web Apache HTTP.
    sudo systemctl restart httpd

Verificación de detalles y registro de Management Station

Verifique que la estación de gestión esté registrada con OS Management Hub como una instancia y que esté disponible para reflejar y distribuir contenido en instancias del centro de datos.

  1. En OS Management Hub, seleccione Estaciones de gestión.
  2. Seleccione el compartimento que contiene la estación de gestión.
  3. Verifique que la estación de gestión aparezca en la tabla y que su estado sea Active (Activo).
    Consejo

    Para solucionar problemas de registro, consulte Error de registro para instancia o estación de gestión.

  4. Seleccione el nombre de la estación de gestión para ver sus detalles.
    Importante

    La lista de orígenes de software reflejados estará vacía hasta que cree un perfil que utilice la estación. Consulte ¿Qué orígenes de software se reflejan?.

Siguientes pasos

Después de registrar la estación de gestión, los siguientes pasos pueden incluir: