Documentación de Oracle Cloud Infrastructure

Registro de una instancia no OCI

Registre una instancia en la nube de terceros local o soportada instalando los paquetes necesarios, agregando un perfil de registro e instalando Management Agent.

Importante

La clonación de una VM que ya está registrada con el hub de gestión del sistema operativo no está soportada.

Antes de empezar

Antes de registrar una instancia con OS Management Hub, debe realizar lo siguiente:

Adición del perfil de registro a la instancia

  1. En la consola, copie el contenido del origen de software, el grupo o el perfil de ciclo de vida.
    1. Abra el menú de navegación y seleccione Observación y gestión. En OS Management Hub, seleccione Perfiles.
    2. Seleccione el nombre del perfil.
    3. Verifique que la información de perfil identifique una estación de gestión. Esto confirma que el perfil es para instancias locales o de nube de terceros.
    4. Si el perfil es del tipo correcto, seleccione Ver.
    5. 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. Management Agent utiliza el plugin de OS Management Hub para registrar instancias 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. 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.

    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. 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:
    Oracle Linux 8 o 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

Configuración del agente de gestión

Active Management Agent con el plugin de OS Management Hub. Tras la activación, la instancia se registra con el servicio OS Management Hub en el compartimento especificado en la clave de instalación y con el contenido asociado al perfil.

  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. 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.
  4. 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
GatewayServerHost = <STATION_OR_LOAD_BALANCER_HOSTNAME>
GatewayServerPort = <STATION_PROXY_PORT>
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.

    Para utilizar la estación de gestión como proxy para toda la comunicación del hub de gestión del sistema operativo con la instancia, agregue los siguientes parámetros en el archivo input.rsp.

    Para identificar el nombre de host y el puerto de proxy de la estación de gestión, siga estos pasos en la consola:

    1. Abra el menú de navegación y seleccione Observación y gestión. En OS Management Hub, seleccione Perfiles.
    2. Seleccione el perfil asociado a la instancia.
    3. En la sección Información de perfil, seleccione el nombre de la estación de gestión.
    4. Seleccione el separador Configuración.
    5. Registre los valores Hostname (Nombre de host) y Proxy listen port (Puerto de recepción de proxy) para utilizarlos en el archivo input.rsp.
  5. 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.

Verificar registro y detalles de instancia

Verifique la instancia registrada con OS Management Hub.

  1. Abra el menú de navegación y seleccione Observación y gestión. En Hub de gestión del sistema operativo, seleccione Instancias.
  2. En Ámbito de lista, seleccione el compartimento que contiene la instancia.
  3. Confirme que la instancia aparece en la tabla y verifique que el estado es 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 instancia para ver sus detalles.

    En Información de instancia, puede ver detalles sobre la instancia, como el perfil de registro que ha utilizado para registrarse en el servicio y si es miembro de un grupo o entorno de ciclo de vida, si procede.

    Nota

    La instancia puede tardar unos minutos en informar el inventario inicial de paquetes y módulos al servicio.