Realizar Tareas de Requisitos Genéricas

Para configurar Oracle Management Cloud para supervisar el entorno de Oracle E-Business Suite, debe realizar un conjunto de tareas genéricas.

Activar licencia de Enterprise Edition

Las ofertas de Oracle Management Cloud se clasifican y están disponibles en distintas ediciones de licencias, incluido el Enterprise Edition.

Oracle Management Cloud – Enterprise Edition ofrece lo siguiente:

Oracle Application Performance Monitoring: proporciona una plataforma para controlar y gestionar aplicaciones.
Oracle Infrastructure Monitoring: Controla el estado de toda la infraestructura de tecnología de información de una sola plataforma y alerta a los administradores sobre problemas.
Orquestación de Oracle: automatiza la infraestructura local y en la nube y ejecuta tareas llamando a las API de REST o mediante marcos de automatización de terceros.
Oracle IT Analytics: proporciona información detallada de 360-degree sobre el rendimiento, la disponibilidad y la capacidad de las aplicaciones e inversiones en infraestructura.

Activar Oracle Management Cloud: Enterprise Edition para el sistema host Oracle Cloud Infrastructure y para Oracle E-Business Suite.

Inicie sesión en la consola de Oracle Management Cloud como administrador de Oracle Management Cloud.
Si no se muestra el panel de navegación de Management Cloud, haga clic en el icono de navegación de OMC en la esquina superior izquierda.
En el panel de navegación de la consola de Oracle Management Cloud, haga clic en Administración y, a continuación, en Configuración de Entidad.
Haga clic en Licencias y, a continuación, haga clic en Seleccionar entidades .
Busque y seleccione las entidades necesarias y, a continuación, haga clic en el botón Seleccionar .
Seleccione Enterprise Edition para cada entidad de la lista o haga clic en Edición de licencia y seleccione Definir todo en empresa .
Haga clic en Guardar.

Instalar Agentes de Oracle Management Cloud

Instale los agentes de Oracle Management Cloud que recuperan las métricas de supervisión.

Agente de gateway: instale el agente de gateway en un host que tenga acceso a Internet a Oracle Management Cloud y que puedan acceder a todos los hosts en los que se despliegan los agentes de nube. Todos los agentes de Oracle Management Cloud deben utilizar un gateway común.
Agentes de nube: instale agentes de nube en cada host de la topología de Oracle E-Business Suite para supervisar y recopilar datos (por ejemplo, métricas, información de configuración y logs) de entidades que residen en esos hosts.

Antes de Instalar Agentes

Antes de instalar agentes en Oracle E-Business Suite, asegúrese de tener en cuenta las siguientes consideraciones.

Para el directorio base de agente en el que se instala un agente:

Asegúrese de que sólo el usuario de root y el usuario de agent installation tienen permiso de escritura en el directorio base del agente y su directorio principal incluso después de la instalación del agente. Esto garantiza que todas las operaciones de ciclo de vida de agente, como actualizar o suprimir, se hayan completado correctamente.
Si el directorio base del agente se crea antes de la instalación, asegúrese de que el directorio está vacío. El usuario de instalación del agente debe tener acceso de escritura al directorio.
Si el directorio base del agente no se crea antes de la instalación, se crea por defecto en el directorio en el que se extrae el archivo zip del software del agente. Asegúrese de que el usuario de instalación del agente tiene acceso de escritura al directorio principal en el que se crea el directorio base del agente.

Crear o descargar una clave de registro

Se emite una clave de registro para su dominio de identidad y se utiliza cuando se despliegan agentes de nube. Una vez instalado un agente con la clave de registro, puede eliminar la clave de Oracle Management Cloud.

Cuando cree una clave de registro, especifique un recuento de uso para la clave. Una clave caduca cuando el recuento de uso es mayor o igual que el uso máximo especificado al crear la clave.

Inicie sesión en la consola de Oracle Management Cloud como administrador de Oracle Management Cloud.
Si no se muestra el panel de navegación de Management Cloud, haga clic en el icono de navegación de OMC en la esquina superior izquierda.
En el panel de navegación de la consola de Oracle Management Cloud, haga clic en Administración y, a continuación, en Agentes .
Haga clic en el menú de la derecha y, a continuación, seleccione Manage Registration Keys (Gestionar claves de registro).
Cree una nueva clave de registro introduciendo los detalles necesarios en la página Claves de Registro y, a continuación, haciendo clic en Crear Nueva Clave .
Para descargar una clave de registro existente, realice los siguientes pasos:
1. En la lista de claves de registro, localice la clave que desea descargar.
2. Haga clic en el menú de acciones situado en la parte derecha de la página y, a continuación, seleccione Descargar .
  Un archivo de texto registrationKey.txt que contiene el valor de la clave de registro se descarga en la unidad local. Para ver el valor de clave, abra el archivo registrationKey.txt.

Agregará el valor de clave en el parámetro AGENT_REGISTRATION_KEY del archivo de respuesta.

Descargar Agente de Gateway

Utilice la consola de Oracle Management Cloud para descargar los archivos ZIP del paquete de instalación del software del agente de gateway en el host.

Al extraer el archivo ZIP del gateway, se proporciona un archivo de respuesta de ejemplo, gateway.rsp, como plantilla.

Inicie sesión en la consola de Oracle Management Cloud como administrador de Oracle Management Cloud.
Si no se muestra el panel de navegación de Management Cloud, haga clic en el icono de navegación de OMC en la esquina superior izquierda.
En el panel de navegación de la consola de Oracle Management Cloud, haga clic en Administración y, a continuación, en Agentes .
Haga clic en el menú de la derecha y seleccione Descargar Agentes .
Haga clic en Tipo de Agente y, a continuación, seleccione Gateway .
Haga clic en Sistema Operativo y seleccione el sistema operativo en el que desea instalar el agente.
Anote los valores de los parámetros TENANT_NAME y OMC_URL que aparecen bajo el enlace del agente. Al instalar el agente de gateway, debe actualizar el archivo de respuesta con estos valores.
Haga clic en el enlace del software de agente del sistema operativo para descargar el archivo ZIP del software de gateway.
Verifique que el archivo ZIP descargado ha terminado comparando el valor de total de control SHA1 del archivo descargado en el que aparece para el agente en la página de descarga del agente:
```
sha1sum <agent_binary_filename>.zip
```
El valor de la columna Total de Control de SHA1 de la interfaz de usuario debe coincidir con la salida.
Navegue hasta el directorio donde descargó el paquete de software y descomprima el software.
```
unzip <agent_binary_filename>.zip
```

Descargar el agente de nube

Utilice la consola de Oracle Management Cloud para descargar los archivos ZIP del paquete de instalación del software del agente en la nube en su host.

Al extraer el archivo ZIP del agente, se proporciona un archivo de respuesta de ejemplo, agent.rsp, como plantilla.

Inicie sesión en la consola de Oracle Management Cloud como administrador de Oracle Management Cloud.
Si no se muestra el panel de navegación de Management Cloud, haga clic en el icono de navegación de OMC en la esquina superior izquierda.
En el panel de navegación de la consola de Oracle Management Cloud, haga clic en Administración y, a continuación, en Agentes .
Haga clic en el menú de la derecha y seleccione Descargar Agentes .
Haga clic en Tipo de Agente y, a continuación, seleccione Agente de Nube.
Haga clic en Sistema Operativo y seleccione el sistema operativo en el que desea instalar el agente.
Anote los valores de los parámetros TENANT_NAME y OMC_URL que aparecen bajo el enlace del agente. Al instalar el agente de gateway, debe actualizar el archivo de respuesta con estos valores.
Haga clic en el enlace del software de agente del sistema operativo para descargar el archivo ZIP del software de gateway.
Verifique que el archivo ZIP descargado ha terminado comparando el valor de total de control SHA1 del archivo descargado en el que aparece para el agente en la página de descarga del agente:
```
sha1sum <agent_binary_filename>.zip
```
El valor de la columna Total de Control de SHA1 de la interfaz de usuario debe coincidir con la salida.
Navegue hasta el directorio donde descargó el paquete de software y descomprima el software.
```
unzip <agent_binary_filename>.zip
```

Instalar el Agente de Gateway

Un agente de gateway actúa como un canal seguro entre Oracle Management Cloud y todos los demás agentes Oracle Management Cloud.

Para instalar un agente de gateway:

Edite el archivo de respuesta del gateway, gateway.rsp (obtenido al descargar y extraer el archivo ZIP del gateway), en un editor de texto y proporcione valores para los parámetros necesarios para instalar un gateway.

La siguiente tabla muestra los parámetros necesarios para la instalación del gateway.

Parámetro	Descripción
`TENANT_NAME` o `TENANT_ID` (soportado en versiones anteriores y sigue siendo compatible con versiones anteriores)	Nombre del inquilino en el que se está ejecutando Oracle Management Cloud. Puede obtener el valor `TENANT_NAME` de un agente navegando a Administración > Agentes > Descargar y seleccionando un tipo de agente de la lista desplegable Tipo de Agente . El valor `TENANT_NAME` se muestra en la parte inferior de la página.
`OMC_URL` o `UPLOAD_ROOT` (soportado en versiones anteriores y sigue siendo compatible con versiones anteriores)	URL absoluta incluido el protocolo necesario para conectarse a Oracle Management Cloud para cargar datos para `TENANT_NAME` específico. Para obtener este valor, vaya a Administración > Agentes > Descargar y seleccione un tipo de agente de la lista desplegable Tipo de Agente . El valor `OMC_URL` se muestra en la parte inferior de la página.
`AGENT_REGISTRATION_KEY`	Clave para validar la identidad del inquilino y la autenticidad de la instalación. Puede obtener la clave de registro del panel de control de Oracle Management Cloud navegando a Administración > Agentes > Claves de Registro.
`AGENT_BASE_DIRECTORY`	Directorio vacío en el que se debe instalar el agente en la máquina host. Si el directorio proporcionado no está presente, se crea un directorio durante la instalación. Nota: Para Windows, la longitud de la ruta de acceso del directorio que incluye la letra de unidad debe ser inferior a los caracteres 23.

Guarde el archivo de respuesta.
Ejecute una comprobación de requisitos para validar los parámetros. Utilice la interfaz de línea de comandos para ejecutar el archivo de comandos AgentInstall.sh transfiriendo el parámetro EXECUTE_PREREQ=true.
```
$ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed for [Gateway]. 
```
El archivo de comandos ejecuta la comprobación de requisitos. Si la comprobación de requisitos falla, el archivo de comandos se para con el mensaje de error correspondiente.

Consulte el archivo log ubicado en <AGENT_ZIP_FILE_EXTRACTED_DIRECTORY>/AgentInstall_<timestamp>.log para obtener más información. Corrija los errores antes de instalar el gateway.
Instale el agente ejecutando el script AgentInstall.sh con el nombre de archivo de respuesta como parámetro.
./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the gateway.rsp file>

Instalar el agente de nube

Un agente de nube recopila los datos de entidad desde el host donde despliega el agente de nube.

La instalación de agente de nube requiere nombres de dominio completos (FQDN) para los hosts. Para entornos UNIX, agregue el FQDN en el archivo /etc/hosts y asegúrese de que se asigna al nombre de host y la dirección IP correctos del host.

Nota: Instale el agente de nube en cada uno de los hosts de nivel de aplicación y de base de datos.

Para instalar un agente de nube:

Edite el archivo de respuesta del agente de nube, agent.rsp (obtenido al descargar y extraer el archivo ZIP del agente de nube), en un editor de texto y proporcione valores para los parámetros necesarios para instalar un agente de nube.

En la siguiente tabla se muestran los parámetros necesarios antes y encima de los parámetros de instalación de gateway mostrados anteriormente para una instalación de agente de nube que utiliza un gateway para comunicarse con Oracle Management Cloud a través de un servidor proxy.

Parámetro	Descripción
`GATEWAY_HOST`	Si el agente de nube se comunica con Oracle Management Cloud mediante un gateway, proporcione el nombre de dominio totalmente cualificado (FQDN) del gateway. Cuando instale el agente de nube, asegúrese de proporcionar el mismo nombre de host de gateway utilizado para instalar el gateway. Por ejemplo, al desplegar el gateway, si especifica `ORACLE_HOSTANME=abc.xyz.com` y al instalar el agente de nube, especifica `GATEWAY_HOST=abc`, se producirán fallos de registro del agente de nube. Se debe instalar un agente de gateway en el host y estar activo y en ejecución.
`GATEWAY_PORT`	Cuando un agente de nube utiliza un gateway para comunicarse con Oracle Management Cloud, debe especificar el puerto del gateway. Puede obtener el número de puerto ejecutando el siguiente comando: `$Gateway_Agent_Home/agent_inst/bin/omcli status agent`
`OMC_PROXYHOST`	Dirección del servidor proxy que se va a utilizar para la conexión. Asegúrese de que no transfiere el valor `https://` con los detalles del host de proxy.
`OMC_PROXYPORT`	Puerto del servidor proxy.
`OMC_PROXYUSER`	Nombre de usuario necesario para acceder al servidor proxy.
`OMC_PROXYPWD`	Contraseña necesaria para acceder al servidor proxy.
`OMC_PROXYREALM`	Dominio de autenticación (si lo hay) que se va a utilizar para acceder al servidor proxy.
`AGENT_PORT`	Número de puerto al que se enlazará el proceso de agente. La secuencia de comandos `AgentInstall` detiene el proceso de instalación si este puerto está ocupado en el momento de la instalación.

Guarde el archivo de respuesta.
Ejecute una comprobación de requisitos para validar los parámetros. Utilice la interfaz de línea de comandos para ejecutar el archivo de comandos AgentInstall.sh transfiriendo el parámetro EXECUTE_PREREQ=true.
```
$ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed. 
```
El archivo de comandos ejecuta la comprobación de requisitos. Si la comprobación de requisitos falla, el archivo de comandos se para con el mensaje de error correspondiente.
Instale el agente ejecutando el script AgentInstall.sh con el nombre de archivo de respuesta como parámetro.
./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the agent.rsp file>

Verificar Instalación del Agente

Después de instalar el gateway y el agente de nube, verifique que los agentes se hayan desplegado correctamente.

Inicie sesión en la consola de Oracle Management Cloud como administrador de Oracle Management Cloud.
Si no se muestra el panel de navegación de Management Cloud, haga clic en el icono de navegación de OMC en la esquina superior izquierda.
En el panel de navegación de la consola de Oracle Management Cloud, haga clic en Administración y, a continuación, en Agentes .
Haga clic en el separador del tipo de agente, como Gateways o Agentes de Nube.
Verifique que el nombre de host del gateway o agente de nube desplegados existe en la lista de agentes disponibles.