1. Activación de Observability and Management Stack Monitoring para PeopleSoft
  2. Introducción al proceso de despliegue

Introducción al proceso de despliegue

El despliegue de la observabilidad y la supervisión de la pila de gestión para las aplicaciones PeopleSoft requiere tres pasos principales:

  1. Configure las licencias para la edición elegida, Standard o Enterprise, y para los recursos o compartimentos utilizados en el despliegue.
  2. Detectar y promocionar los recursos utilizados en el despliegue.
  3. Utilice la interfaz de línea de comandos (CLI) de OCI para detectar nuevos recursos, crear las asociaciones necesarias entre los recursos de Stack Monitoring o refrescar toda la topología.

Configurar Licencias

Stack Monitoring ofrece dos ediciones: Standard y Enterprise. Standard Edition supervisa las aplicaciones y pilas de tecnología locales y desplegadas en la nube, incluidos WebLogic, Tomcat, Oracle Database y los hosts. Enterprise Edition agrega funciones avanzadas como extensiones de métricas, líneas base de rendimiento, detección de anomalías e integración de recursos de OCI para una supervisión mejorada.

Además de estas dos ediciones, las licencias se deben configurar en el nivel de recurso individual o en el nivel de compartimento, como se describe a continuación.

Note:

Los pasos para asignar licencias en cualquier nivel están fuera del alcance de este manual. Puede acceder a los procedimientos relevantes requeridos para cada nivel de asignación, identificados en la sección específica, a continuación, desde "Explorar más", en otra parte de este manual.

Configuración de licencias para funciones específicas de compartimentos

Puede definir la asignación automática de licencias de recursos en Enterprise o Standard para todos los recursos recién detectados o promocionados en un compartimento. La configuración de la asignación automática de licencias es una forma práctica de asignar automáticamente una licencia en lugar de aplicarla por instancia de recurso. Además, puede activar o desactivar la extensibilidad empresarial para todo un compartimento.

Los procedimientos para configurar licencias para funciones específicas de compartimentos se describen en "Asignación de licencias", en la documentación de Oracle Cloud Infrastructure, a la que puede acceder desde "Explorar más".

Configuración de licencias para funciones específicas de recursos

La asignación de licencias de recursos se puede realizar en el nivel de recurso individual durante la detección o después de la detección mediante la interfaz de usuario de licencias. Los cambios de licencia aplicados a un compuesto se aplican a todos los secundarios; es decir, al aplicar la licencia de Enterprise Edition a un dominio WebLogic, todos los servidores WebLogic asociados al dominio también recibirán Enterprise Edition.

Durante la detección, puede asignar una licencia al recurso seleccionando el botón de radio correspondiente. También puede modificar una licencia de recurso después de detectar un recurso mediante la interfaz de usuario de licencia. Estos procedimientos se describen en "Asignación de licencias", en la documentación de Oracle Cloud Infrastructure, a la que puede acceder desde "Explorar más".

Descubra y promocione recursos para PeopleSoft

Para supervisar los recursos mediante Stack Monitoring, primero debe detectar y promocionar estos recursos. La promoción rellena previamente información relacionada con el recurso. Debe validar esta información para asegurarse de que es correcta. Los requisitos y parámetros de entrada para la promoción son los mismos que para la detección iniciada por el usuario.

La detección PeopleSoft implica tres familias de recursos obligatorias: el dominio del servidor de aplicaciones, el dominio del programador de procesos y la arquitectura de Internet (PIA) PeopleSoft con sus dominios de Weblogic subyacentes. Cada familia de recursos puede incluir uno o más de estos recursos, que pueden abarcar varios servidores.

Para detectar y promocionar recursos para aplicaciones PeopleSoft, debe realizar lo siguiente:
  • Detecte la base de datos PeopleSoft.
  • Establezca privilegios de permiso de base de datos para la supervisión de PeopleSoft.
  • Active PeopleSoft Performance Monitor para Pure Internet Architecture (PIA).
  • Cumpla los requisitos para el servidor de aplicaciones y los dominios del gestor de procesos.
  • Identifique los dominios que se van a detectar.
  • Agregue dominios manualmente.
  • Active la detección de Elasticsearch.
  • Active la detección de supervisión de procesos.

Note:

Los pasos para descubrir y promover recursos están más allá del alcance de este manual. Puede acceder a los procedimientos relevantes requeridos para cada nivel de asignación, identificados en la sección específica, a continuación, desde "Explorar más", en otra parte de este manual.

Detectar la base de datos PeopleSoft

Debe detectar la instancia de Oracle Database que contiene el esquema PeopleSoft antes de detectar la aplicación PeopleSoft.

Al detectar primero la base de datos, se asocia automáticamente a la aplicación PeopleSoft una vez que se completa la detección de recursos PeopleSoft. Si realiza la detección de aplicaciones PeopleSoft antes de detectar la base de datos, deberá crear la asociación manualmente. Consulte Topología de aplicación para obtener más información. Para descubrir la base de datos Oracle, consulte "Oracle Database", a la que puede acceder desde "Explorar más", en otra parte de este manual.

Establecimiento de privilegios de otorgamiento de base de datos para la supervisión de PeopleSoft

Para supervisar PeopleSoft, necesita privilegios específicos para acceder al esquema de base de datos PeopleSoft. La configuración varía según el tipo de base de datos (base de datos sin contenedores frente a base de datos de contenedores y base de datos conectable) utilizada como almacén de datos PeopleSoft.

Al detectar la supervisión de pila PeopleSoft, puede utilizar el propietario del esquema PeopleSoft, normalmente SYSADM, como credenciales de base de datos. Debe crear un usuario de supervisión con solo los privilegios necesarios para supervisar una aplicación PeopleSoft. Utilice el mismo usuario de base de datos para supervisar tanto la base de datos Oracle que contiene el esquema PeopleSoft como la aplicación PeopleSoft.

Para crear un usuario de supervisión de base de datos, consulte la nota de MOS: 2857604.1. Para obtener más información, consulte también "Privilegios de otorgamiento de base de datos para la supervisión de PeopleSoft" en la documentación de OCI. Puede acceder a ambos documentos desde "Explorar más", en otras partes de este manual.

Activar PeopleSoft Performance Monitor para arquitectura de Internet pura (PIA)

Este es un procedimiento opcional y solo es necesario para la detección y el refrescamiento de PeopleSoft; sin embargo, para la supervisión regular y la recopilación de métricas, el agente PeopleSoft Performance Monitor no es necesario. Si decide no activar el agente de PPM por cualquier motivo, utilice cualquiera de estas alternativas:
  • Active el agente PPM hasta que finalice la detección o el refrescamiento y, a continuación, desactívelo y reinicie los dominios.
  • Inserte/suprima manualmente toda la información del dominio PeopleSoft. Esto eliminará la necesidad de activar Activar agente de PPM.
Si necesita activar el PPM para PIA, haga lo siguiente:
  1. Vaya a PeopleTools, vaya a Perfil web, haga clic en Configuración de perfil web y busque el perfil en uso; por ejemplo, PROD.
  2. Si aún no está activado, seleccione Activar Agente de PPM.
  3. Reinicie todos los dominios PIA.

Cumplir los requisitos para el servidor de aplicaciones y los dominios del programador de procesos

A continuación, debe cumplir los requisitos previos para cada servidor de aplicaciones y dominio del gestor de procesos. La detección PeopleSoft asume que el ID/contraseña de usuario de administración remota para el acceso JMX es el mismo para todos los dominios del servidor de aplicaciones y también para todos los dominios del programador de procesos.

Los requisitos que debe completar son:
  • Active el agente PeopleSoft Performance Monitor.
  • Active los agentes JMX.
  • Active la propiedad Performance Collator.

En los siguientes temas, se proporcionan pasos generales para completar estas tareas. Para obtener procedimientos detallados, consulte "Requisitos previos para dominios del servidor de aplicaciones y del programador de procesos" en la documentación de Stack Monitoring de OCI, a la que puede acceder desde "Explorar más", en otra parte de este manual.

Activación del agente de Performance Monitor PeopleSoft

Para activar PeopleSoft Performance Monitor Agent, haga lo siguiente:

  1. Abra los archivos de configuración de dominio en modo de edición. En la interfaz de línea de comandos de PSADMIN. Seleccione Application Server (opción 1) o Process Scheduler (opción 2), Administer a domain (opción 1), Select Domain y, a continuación, Edit configuration/log files menu (opción 6) y Edit domain configuration file (opción 1).
  2. En la sección PSTOOLS, compruebe el valor de Agente EnablePPM.
  3. Active los agentes de PPM, defina el valor en 1 y guarde el archivo.
Activar Agentes JMX

Este requisito permite a Stack Monitoring recopilar datos de disponibilidad y rendimiento para una aplicación PeopleSoft. Estos son los pasos generales:

  1. Abra los archivos de configuración de dominio en modo de edición desde la interfaz de línea de comandos de PSADMIN. Seleccione Servidor de aplicaciones (opción 1) o Programador de procesos (opción 2), Administrar un dominio (opción 1) y, a continuación, seleccionar dominio, Editar menú de archivos de configuración/registro (opción 6) y Editar archivo de configuración de dominio (opción 1).
  2. Localice la configuración de la sección PSTOOLS y haga lo siguiente:
    1. Asegúrese de que ningún otro proceso del host esté utilizando el puerto de administración remoto que desea utilizar.
    2. Defina el ID de usuario en formato de texto. Utilice el mismo ID de usuario y contraseña para todos los dominios del servidor de aplicaciones y los dominios del gestor de procesos.
    3. Cifre las contraseñas con la utilidad PSCipher.
    4. Después de configurar el cambio de propiedad de colaborador de rendimiento (como se describe en el siguiente tema), reinicie el servidor de aplicaciones y los dominios del programador de procesos.
  3. Defina los valores de puerto de administración remota y puerto RMI.
    • Si utiliza la versión 8.59 de PeopleSoft y versiones anteriores, solo necesita definir el puerto de administración remoto. El valor del puerto RMI se establece automáticamente, incrementando el valor del puerto de administración remoto en uno.
    • Para PSFT versión 8.60 en adelante, el puerto RMI está controlado por un parámetro adicional en el archivo de configuración. Asegúrese de que el valor esté definido explícitamente. Reinicie el servidor de aplicaciones y los dominios del Gestor de Procesos después de configurar la propiedad Performance Collator.
  4. Asegúrese de que los valores guardados aparezcan correctamente en el archivo de configuración.
Para obtener instrucciones más detalladas, consulte "Activación de agentes JMX" en la documentación de OCI, a la que puede acceder desde "Explorar más", en cualquier otro lugar de este manual.
Activación de la propiedad Performance Collator

Antes de activar la propiedad Performance Collator, compruebe el valor actual de Performance Collator en los archivos de plantilla de dominio psprcsrv.ubx (Programador de procesos) y psappsrv.ubx (Servidor de aplicaciones) ubicados en $PS_CFG_HOME.

Si Performance Collator está activado, verá esta entrada: 
{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [y]:
Si Performance Collator está desactivado, verá esta entrada: 
{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [n]:
Si el Collator de rendimiento ya está activado y los cambios se han implantado en los valores de agente EnablePPM o JMX, puede reiniciar todos los dominios. Si el Collator de rendimiento aún no está activado, realice lo siguiente:
  1. En la interfaz de línea de comandos de PSADMIN, seleccione Application Server (Option 1) o Process Scheduler (Option 2), Administer a domain (Option 1), select domain y, a continuación, Configure this domain (Option 4) .
  2. Introduzca y para la pregunta Do you want to continue (y/n). Esta opción cerrará el dominio.
  3. Compruebe el valor de la propiedad Performance Collator.
    • Si el valor se establece en Sí, el colaborador ya está habilitado y no es necesario realizar ninguna acción. 
      Load config as shown
      Puede seleccionar la opción 14 para Application Server u la opción 7 para el Gestor de Procesos.
    • Si define el valor en No, introduzca la opción 10 para Application Server o la opción 3 para el Gestor de Procesos para cambiar el valor a Sí.
  4. Después de confirmar que el Collator de rendimiento está definido en Sí, seleccione Load config as shown (Opción 14 para el programador de aplicaciones o Opción 7 para el programador de procesos).
  5. Por último, seleccione Boot this domain Option 1 para iniciar el dominio.

Identificación de dominios que se van a detectar

Stack Monitoring aprovecha la información almacenada en Oracle Database para identificar los dominios que se van a detectar o refrescar.

Para validar la lista de dominios actuales, utilice esta consulta:
SELECT * FROM PSPMAGENT;
Antes de detectar o refrescar la aplicación PeopleSoft, debe eliminar los dominios devueltos por la consulta que ya no existen.

Note:

Si necesita agregar un dominio que no aparece en la lista, consulte el siguiente tema, "Adición manual de dominios".
Para eliminar los dominios desactualizados, conéctese como SYSADM o un usuario equivalente y ejecute la siguiente consulta SQL. Repita la consulta hasta que haya eliminado todos los dominios obsoletos. Tenga en cuenta lo siguiente:
  • Realice una copia de seguridad de la tabla PSPMAGENT antes de realizar cambios. 
    create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;

    donde DATE con el registro de hora actual

  • Verifique que la tabla de copia de seguridad que ha creado tiene el mismo contenido que la tabla principal. 
    select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
Si el recuento de filas de PSPMAGENT coincide con PSPMAGENT_BKP_DATE, continúe eliminando los dominios anticuados: 
delete from PSPMAGENT WHERE PM_AGENTID='&enter_agent_id_of_stale_domain'; 
Commit;

Agregar Dominios Manualmente

A continuación, compruebe si todos los dominios válidos están visibles desde la tabla PSPMAGENT. Si no aparece ningún dominio válido, utilice las consultas en los siguientes temas. El host del agente debe poder acceder a todos los demás hosts mediante el nombre de host de la columna PM_HOST_PORT almacenada en la tabla PSPMAGENT.

Los dominios que necesita agregar manualmente son:
  • Dominio del Gestor de Procesos
  • Dominio del servidor de la aplicación
  • Servidor PIA
Antes de continuar, haga lo siguiente para realizar una copia de seguridad de la tabla PSPMAGENT:
  1. Antes de realizar cambios, inicie sesión como administrador del sistema o usuario equivalente y realice una copia de seguridad de la tabla: 
    create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;
    donde DATE es el registro de hora actual.
  2. Verifique que la tabla de copia de seguridad que ha creado tiene el mismo contenido que la tabla principal. El recuento de filas de PSPMAGENT debe coincidir con el recuento de filas de PSPMAGENT_BKP_DATE:
    select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
    donde DATE es el registro de hora actual.
Use los siguientes comandos para agregar los dominios:
  • Dominio del Gestor de Procesos
    INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');
  • Dominio del servidor de la aplicación
    INSERT INTO  PSPMAGENT values
('&unique_agent_id','&JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','01','&DOMAIN_DIR','Y','&host_name:&jolt_port','1','1','N');
  • Servidor PIA
    INSERT INTO  PSPMAGENT values
('&unique_agent_id','-1','WEBRESOURCE','&DOMAIN_NAME','02','&DOMAIN_DIR','Y','&host_name:&http_port:&https_port','1','1','N');

Activar detección de Elasticsearch

La detección de búsqueda flexible es opcional. Si Elasticsearch ya está integrado, puede incluirlo en la detección inicial. Para integrar Elasticsearch en el futuro, utilice el comando refresh de la CLI PeopleSoft y agregue los permisos de base de datos de Elasticsearch al usuario de supervisión. Para obtener más información sobre los permisos, consulte "Establecimiento de privilegios de otorgamiento de base de datos para la supervisión de PeopleSoft", arriba, y para obtener más información sobre los comandos de refrescamiento de la CLI, consulte "Refrescar instancias de PeopleSoft", en otra parte de este manual.
Al completar estos requisitos, se activará la integración de Elasticsearch en PeopleSoft:
  • Stack Monitoring solo soporta la supervisión de Elasticsearch configurada con SSL. Su punto final debe ser HTTPS. Para obtener más información sobre la configuración de Elasticsearch, consulte "Configuración de SSL entre PeopleSoft y Elasticsearch", a la que puede acceder desde "Explorar más", en otra parte de este manual.
  • Antes de detectar Elasticsearch, cree un almacén de confianza de JKS (JKS es el único almacén de confianza soportado) en el host del agente de supervisión para almacenar el certificado de Elasticsearch. La ubicación y la contraseña de este almacén de confianza son parámetros necesarios en la interfaz de usuario de detección o en el JSON de detección al intentar la detección mediante la CLI. Además, se debe poder acceder a la ubicación del almacén de confianza en el host del agente.
    Por ejemplo: 
    keytool -keystore truststore.jks -alias ALIAS -import -file ELASTICSEARCH_CERTIFICATE

Activar detección de supervisor de procesos

El monitor de procesos se detecta junto con PeopleSoft y está activado por defecto al detectar una aplicación PeopleSoft. Al seleccionar No en la sección Detectar supervisor de procesos, se excluye el supervisor de procesos de la detección PeopleSoft.

La detección del supervisor de procesos es opcional. Si el supervisor de procesos ya está activado, puede incluirlo en la detección inicial. Para integrar el supervisor de procesos en el futuro, utilice el comando refresh de la CLI PeopleSoft y agregue los permisos de base de datos del supervisor de procesos al usuario de supervisión. Para obtener más información sobre los permisos, consulte "Establecimiento de privilegios de otorgamiento de base de datos para la supervisión de PeopleSoft", arriba, y para obtener más información sobre los comandos de refrescamiento de la CLI, consulte "Refrescar instancias de PeopleSoft", en otra parte de este manual.

No se necesitan propiedades para la detección del supervisor de procesos.

La detección del supervisor de procesos está incluida por defecto. Para excluirse, seleccione No en el panel de detección Discover Process Monitor in the Resource (Detectar supervisor de procesos en el recurso).

Para obtener más información, consulte "Activación de la detección del monitor de procesos para PeopleSoft", a la que puede acceder desde "Explorar más", en otra parte de este manual.

Actualizar Topología de Aplicación

Puede utilizar la CLI de OCI para detectar nuevos recursos, crear las asociaciones necesarias entre los recursos de Stack Monitoring o refrescar toda la topología. En concreto, puede utilizar la CLI para crear asociaciones entre la base de datos y PeopleSoft.

Para PeopleSoft, la actualización de la topología de aplicación requiere estas tareas:
  • Gestione los dominios PeopleSoft.
  • Refresque las instancias de PeopleSoft.

Gestionar dominios PeopleSoft

Stack Monitoring aprovecha la información de dominio incluida en la tabla PSPMAGENT para la detección. Si falta el dominio PeopleSoft, puede crear la información de dominio necesaria manualmente siguiendo los pasos descritos en "Agregar dominios manualmente", en otra parte de este manual.

Refresque las instancias de PeopleSoft

La aplicación PeopleSoft refresca los siguientes tipos de recursos de Stack Monitoring:

oracle_psft
oracle_psft_appserv
oracle_psft_prcs
oracle_psft_pia
weblogic_domain (including members)

El refrescamiento no validará las credenciales para los nuevos dominios encontrados durante el proceso de refrescamiento. Si, durante el proceso de detección, se detectaron dominios fallidos, estos podrían ser dominios obsoletos, es posible que no se pueda acceder a ellos para conexiones JMX desde el agente o por otros motivos. Una vez resueltos los problemas subyacentes, asegúrese de que las credenciales comunes son válidas para cada uno de los nuevos dominios que desea agregar validando mediante una conexión JMX desde el host del agente y, a continuación, realizando una operación de refrescamiento. Una vez que el refrescamiento se realiza correctamente, se agregan los nuevos dominios. Estos dominios utilizan las mismas credenciales comunes con las que se configuran los dominios detectados anteriormente.

Un refrescamiento también refrescará los dominios WebLogic asociados existentes y sus miembros.

Cuando se agregan nuevas instancias de PIA, al realizar el refrescamiento de PeopleSoft se detectará el recurso de PIA recién agregado, pero no se detectará el nuevo dominio WebLogic subyacente. Debe detectar el dominio WebLogic manualmente mediante la CLI para asociar ese nuevo dominio WebLogic con el PIA recién detectado.

Puede refrescar la instancia PeopleSoft desde la interfaz de usuario o mediante la CLI.
  • Para refrescar desde la interfaz de usuario, en la página de inicio del recurso, haga clic en Refrescar debajo del nombre del recurso. En el mensaje de confirmación, haga clic en OK (Aceptar) para abrir el panel Resource Discovery (Detección de recursos) en un nuevo separador. Puede realizar un seguimiento del estado del trabajo de actualización enviado aquí.
  • Para refrescar mediante la CLI, debe ejecutar discovery-job create. Esta opción implica un archivo JSON. Para permitir la supresión de recursos durante la operación de refrescamiento, debe agregar la propiedad allow_delete_resources a la carga útil, junto con la propiedad resource_id property y la propiedad de ID de agente de supervisión. resource_id es el ID del recurso PeopleSoft que se debe refrescar.
    Para refrescar instancias de PeopleSoft mediante la CLI, utilice este comando:
    oci stack-monitoring discovery-job create --compartment-id "Compartment_OCID" --discovery-type REFRESH --discovery-details file:///tmp/psft_refresh_dev.json

Para obtener más información sobre el refrescamiento de instancias de PeopleSoft, consulte "Refrescamiento de PeopleSoft" en la documentación de OCI, a la que puede acceder desde "Explorar más", en otra parte de este manual.