1. Ativar o Observability and Management Stack Monitoring para PeopleSoft
  2. Conceitos Básicos do Processo de Implantação

Conceitos Básicos do Processo de Implantação

A implantação do monitoramento da pilha de observabilidade e gerenciamento para aplicativos PeopleSoft requer três etapas principais:

  1. Configure o licenciamento para sua edição escolhida, Standard ou Enterprise, e para quaisquer recursos ou compartimentos usados em sua implantação.
  2. Descubra e promova os recursos usados em sua implantação.
  3. Use a CLI (interface de linha de comando) do OCI para descobrir novos recursos, criar associações necessárias entre os recursos do Stack Monitoring ou atualizar toda a topologia.

Configurar Licenciamento

O Stack Monitoring oferece duas edições: Standard e Enterprise. A Standard Edition monitora aplicativos locais e implantados na nuvem e pilhas de tecnologia, incluindo WebLogic, Tomcat, Oracle Database e hosts. A Enterprise Edition adiciona recursos avançados como Extensões de Métricas, linhas de base de desempenho, detecção de anomalias e integração de recursos do OCI para monitoramento aprimorado.

Além dessas duas edições, as licenças devem ser configuradas no nível de recurso individual ou no nível de compartimento, conforme descrito abaixo.

Observação:

As etapas para atribuir licenças em ambos os níveis estão além do escopo deste manual. Você pode acessar os procedimentos relevantes necessários para cada nível de atribuição, identificados na seção específica, abaixo, em "Explorar Mais", em outro lugar neste manual.

Configurar Licenciamento para Recursos Específicos do Compartimento

Você pode definir a atribuição automática da licença de recursos como Enterprise ou Standard para todos os recursos recém-descobertos ou promovidos em um compartimento. A configuração da atribuição automática de licença é uma maneira conveniente de atribuir automaticamente uma licença, em vez de aplicá-la por instância de recurso. Além disso, você pode ativar ou desativar a extensibilidade da empresa para um compartimento inteiro.

Os procedimentos para configurar o licenciamento para recursos específicos do compartimento são descritos em "Designação de Licenciamento", na documentação do Oracle Cloud Infrastructure, que você pode acessar em "Explorar Mais".

Configurar Licenciamento para Recursos Específicos

A atribuição de licença de recurso pode ser feita no nível de recurso individual durante a descoberta ou após a descoberta usando a IU de Licenciamento. As alterações de licença aplicadas a um composto aplicam-se a todos os filhos; ou seja, ao aplicar a Licença Enterprise Edition a um Domínio de WebLogic, todos os Servidores WebLogic associados ao domínio também receberão a Enterprise Edition.

Durante a descoberta, você pode atribuir uma licença ao recurso selecionando o botão de opção correspondente. Você também pode modificar uma licença de recurso depois que um recurso for descoberto usando a Interface do Usuário da Licença. Esses procedimentos são descritos em "Atribuição de Licenciamento", na documentação do Oracle Cloud Infrastructure, que você pode acessar em "Explorar Mais".

Descubra e Promova Recursos para PeopleSoft

Para monitorar recursos usando o Stack Monitoring, primeiro você deve descobrir e promover esses recursos. A promoção preenche previamente as informações relacionadas ao recurso. Você deve validar essas informações para garantir que elas estejam corretas. Os pré-requisitos e os parâmetros de entrada para promoção são os mesmos da descoberta iniciada pelo usuário.

A descoberta PeopleSoft envolve três famílias de recursos obrigatórios: o domínio do servidor de aplicativos, o domínio do process scheduler e a Arquitetura de Internet (PIA) PeopleSoft com seu(s) domínio(s) subjacente(s) do Weblogic. Cada família de recursos pode incluir um ou mais desses recursos, que podem abranger vários servidores.

Para descobrir e promover recursos para aplicativos PeopleSoft, faça o seguinte:
  • Descubra o banco de dados PeopleSoft.
  • Estabeleça privilégios de concessão de banco de dados para monitoramento PeopleSoft.
  • Ative o PeopleSoft Performance Monitor para Arquitetura Pura da Internet (PIA).
  • Atenda aos pré-requisitos do servidor de aplicativos e dos domínios do Process Scheduler.
  • Identifique os domínios a serem descobertos.
  • Adicione domínios manualmente.
  • Ative a descoberta do Elasticsearch.
  • Ative a descoberta do monitor de processos.

Observação:

Os passos para descobrir e promover recursos estão além do escopo deste manual. Você pode acessar os procedimentos relevantes necessários para cada nível de atribuição, identificados na seção específica, abaixo, em "Explorar Mais", em outro lugar neste manual.

Descobrir o Banco de Dados PeopleSoft

Você precisa descobrir o Oracle Database que contém o esquema PeopleSoft antes de descobrir o aplicativo PeopleSoft.

Ao descobrir o banco de dados primeiro, ele se torna automaticamente associado ao aplicativo PeopleSoft quando a descoberta de recursos PeopleSoft é concluída. Se você executar a descoberta de aplicativo PeopleSoft antes que o banco de dados seja descoberto, será necessário criar a associação manualmente. Consulte Topologia do Aplicativo para obter mais informações. Para descobrir o banco de dados Oracle, consulte "Oracle Database", que você pode acessar em "Explorar Mais", em outro lugar neste manual.

Estabelecer Privilégios de Concessão do Banco de Dados para o Monitoramento de PeopleSoft

Para monitorar PeopleSoft, você precisa de privilégios específicos para acessar o esquema de banco de dados PeopleSoft. A configuração difere dependendo do tipo de banco de dados (banco de dados não contêiner versus banco de dados contêiner e plugável) usado como seu armazenamento de dados PeopleSoft.

Ao descobrir o PeopleSoft Stack Monitoring, você pode usar o proprietário do esquema PeopleSoft, geralmente SYSADM, como as credenciais do banco de dados. Você deve criar um usuário de monitoramento com apenas os privilégios necessários para monitorar um aplicativo PeopleSoft. Use o mesmo usuário do banco de dados para monitorar o banco de dados Oracle que contém o esquema PeopleSoft e o aplicativo PeopleSoft.

Para criar um usuário de monitoramento de banco de dados, consulte a Observação do MOS: 2857604.1. Para obter mais informações, consulte também "Privilégios de Concessão de BD para Monitoramento de PeopleSoft" na documentação do OCI. Você pode acessar ambos os documentos de "Explore mais", em outro lugar neste manual.

Ative o PeopleSoft Performance Monitor para Arquitetura Pura da Internet (PIA)

Este é um procedimento opcional e só é necessário para descoberta e atualização do PeopleSoft; no entanto, para monitoramento regular e coleta de métricas, o agente do Performance Monitor PeopleSoft não é necessário. Se você optou por não ativar o agente PPM por algum motivo, use uma destas alternativas:
  • Ative o agente PPM até que a descoberta ou atualização seja concluída, desative-o e reinicie os domínios.
  • INSERIR/EXCLUIR manualmente todas as informações de domínio PeopleSoft. Isso eliminará a necessidade de ativar a opção Ativar agente do PPM.
Se você precisar ativar o PPM para PIA, faça o seguinte:
  1. Navegue até PeopleTools, vá para Perfil da Web, clique em Configuração do Perfil da Web e procure o perfil em uso; por exemplo, PROD.
  2. Se ainda não estiver marcada, selecione Ativar Agente do PPM.
  3. Reinicie todos os domínios do PIA.

Atender a Pré-requisitos para Domínios do Servidor de Aplicativos e do Process Scheduler

Em seguida, você precisa atender aos pré-requisitos para cada servidor de aplicativos e domínios do Process Scheduler. A descoberta PeopleSoft pressupõe que o ID/senha do usuário de administração remota para acesso JMX seja o mesmo para todos os domínios do servidor de aplicativos e também para todos os domínios do process scheduler.

Os pré-requisitos que você precisa concluir são:
  • Ative o agente do Performance Monitor PeopleSoft.
  • Ativar agentes JMX.
  • Ative a Propriedade do Performance Collator.

Os tópicos a seguir fornecem etapas de alto nível para concluir essas tarefas. Para obter procedimentos detalhados, consulte "Pré-requisitos para Domínios do Servidor de Aplicativos e do Process Scheduler" na documentação do Stack Monitoring OCI, que você pode acessar em "Explorar Mais", em outro lugar neste manual.

Ativar o Agente do Performance Monitor PeopleSoft

Para ativar o Agente do Performance Monitor PeopleSoft, faça o seguinte:

  1. Abra os arquivos de configuração do domínio no modo de edição. Na interface de linha de comando PSADMIN, selecione Application Server (Opção 1) ou Process Scheduler (Opção 2), Administre um domínio (Opção 1), Selecione Domínio e, em seguida, Edite o menu de arquivos de configuração/log (opção 6) e, em seguida, Edite o arquivo de configuração de domínio (Opção 1).
  2. Na seção PSTOOLS, verifique o valor do Agente EnablePPM.
  3. Ative os Agentes PPM, defina o valor como 1 e salve o arquivo.
Ativar Agentes JMX

Esse pré-requisito permite que o Stack Monitoring colete dados de disponibilidade e desempenho para um aplicativo PeopleSoft. Estas são as etapas de alto nível:

  1. Abra os arquivos de configuração de domínio no modo de edição na interface da linha de comando PSADMIN. Selecione Application Server (Opção 1) ou Process Scheduler (Opção 2), Administrar um domínio (Opção 1), selecionar domínio, Editar menu de arquivos de configuração/log (opção 6) e Editar arquivo de configuração de domínio (Opção 1).
  2. Localize as configurações da seção PSTOOLS e faça o seguinte:
    1. Certifique-se de que a Porta de Administração Remota que você pretende usar não esteja sendo usada por nenhum outro processo no host.
    2. Defina o ID do usuário em um formato de texto. Use o mesmo ID de usuário e senha para todos os domínios do servidor de aplicativos e domínios do process scheduler.
    3. Criptografe as senhas usando o utilitário PSCipher.
    4. Depois de configurar a alteração da Propriedade do Performance Collator (conforme descrito no tópico a seguir), reinicie o servidor de aplicativos e os domínios do process scheduler.
  3. Defina os valores da porta de administração remota e da porta RMI.
    • Se você estiver usando o PeopleSoft versão 8.59 e anterior, só precisará definir a Porta de Administração Remota. O valor da porta RMI é definido automaticamente, incrementando o valor da Porta de Administração Remota em um.
    • Para PSFT versão 8.60 em diante, a porta RMI é controlada por um parâmetro adicional no arquivo de configuração. Certifique-se de que o valor esteja definido explicitamente. Reinicie o servidor de aplicativos e os domínios do Process Scheduler após a configuração da propriedade Performance Collator.
  4. Certifique-se de que as definições salvas apareçam corretamente no arquivo de configuração.
Para obter instruções mais detalhadas, consulte "Ativar Agentes JMX" na documentação do OCI, que você pode acessar em "Explorar Mais", em outro lugar neste manual.
Ativar a Propriedade do Performance Collator

Antes de ativar a propriedade Performance Collator, verifique o valor atual do Performance Collator nos arquivos de modelo de domínio psprcsrv.ubx (Process scheduler) e psappsrv.ubx (Application Server) localizados em $PS_CFG_HOME.

Se o Performance Collator estiver ativado, você verá esta entrada: 
{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [y]:
Se o Performance Collator estiver desativado, você verá esta entrada: 
{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [n]:
Se o Performance Collator já estiver ativado e as alterações tiverem sido implementadas nos valores do Agente EnablePPM ou JMX, você poderá reiniciar todos os domínios. Se o Performance Collator ainda não estiver ativado, faça o seguinte:
  1. Na interface da linha de comando PSADMIN, selecione Application Server (Option 1) ou Process Scheduler (Option 2), Administer a domain (Option 1), select domain e Configure this domain (Option 4) .
  2. Digite y para a pergunta Do you want to continue (y/n). Essa opção fará shutdown do domínio.
  3. Verifique o valor da propriedade do Performance Collator.
    • Se o valor for definido como Sim, o Collator já estará ativado e nenhuma ação será necessária. 
      Load config as shown
      Você pode selecionar a Opção 14 para o Servidor de Aplicativos ou a Opção 7 para o Process Scheduler.
    • Se você definir o valor como Não, insira a Opção 10 para o Servidor de Aplicativos ou a Opção 3 para o Process Scheduler para alternar o valor para Sim.
  4. Depois de confirmar que o Performance Collator está definido como Sim, selecione Load config as shown (Opção 14 para o Programador de Aplicativos ou Opção 7 para o Process Scheduler ).
  5. Por fim, selecione Boot this domain Option 1 para iniciar o domínio.

Identificar Domínios a Serem Descobertos

O Stack Monitoring aproveita as informações armazenadas no Oracle Database para identificar domínios a serem descobertos ou atualizados.

Para validar a lista de domínios atuais, use esta consulta:
SELECT * FROM PSPMAGENT;
Antes de descobrir ou atualizar o aplicativo PeopleSoft, remova todos os domínios retornados pela consulta que não existem mais.

Observação:

Se você precisar adicionar um domínio que não esteja listado, consulte o tópico a seguir, "Adicionando domínios manualmente".
Para remover os domínios desatualizados, faça log-in como SYSADM ou um usuário equivalente e execute a consulta SQL a seguir. Repita a consulta até remover todos os domínios desatualizados. Lembre-se destas considerações:
  • Faça backup da tabela PSPMAGENT antes de fazer alterações. 
    create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;

    em que DATE com o timestamp atual

  • Verifique se a tabela de backup criada tem o mesmo conteúdo que a tabela pai. 
    select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
Se a contagem de linhas de PSPMAGENT corresponder a PSPMAGENT_BKP_DATE, continue removendo domínios desatualizados: 
delete from PSPMAGENT WHERE PM_AGENTID='&enter_agent_id_of_stale_domain'; 
Commit;

Adicionar Domínios Manualmente

Em seguida, verifique se todos os domínios válidos estão visíveis na tabela PSPMAGENT. Se algum domínio válido não estiver aparecendo, use as consultas nos tópicos a seguir. O host do agente deve ser capaz de acessar todos os outros hosts usando o nome do host na coluna PM_HOST_PORT armazenada na tabela PSPMAGENT.

Os domínios que você precisa adicionar manualmente são:
  • Domínio do Process Scheduler
  • Domínio do Application Server
  • Servidor PIA
Antes de continuar, faça o seguinte para fazer backup da tabela PSPMAGENT:
  1. Antes de fazer alterações, faça login como administrador do sistema ou usuário equivalente e faça backup da tabela: 
    create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;
    em que DATE é o timestamp atual.
  2. Verifique se a tabela de backup criada tem o mesmo conteúdo que a tabela pai. A contagem de linhas de PSPMAGENT deve corresponder à contagem de linhas de PSPMAGENT_BKP_DATE:
    select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
    em que DATE é o timestamp atual.
Use os seguintes comandos para adicionar os domínios:
  • Domínio do Process Scheduler
    INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');
  • Domínio do Application Server
    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');

Ativar Descoberta do Elasticsearch

A descoberta de pesquisa elástica é opcional. Se o Elasticsearch já estiver integrado, você poderá incluí-lo na descoberta inicial. Para integrar o Elasticsearch no futuro, use o comando refresh da CLI PeopleSoft e adicione as concessões de banco de dados do Elasticsearch ao usuário de monitoramento. Para obter mais informações sobre concessões, consulte "Estabelecer Privilégios de Concessão de Banco de Dados para Monitoramento de PeopleSoft", acima, e para obter mais informações sobre comandos de atualização de CLI, consulte "Atualizar Instâncias PeopleSoft", em outro lugar neste playbook.
A conclusão desses pré-requisitos ativará a Integração do Elasticsearch em PeopleSoft:
  • O Stack Monitoring só suporta o monitoramento do Elasticsearch configurado com SSL. Seu ponto final deve ser HTTPS. Para obter mais informações sobre a configuração do Elasticsearch, consulte "Configurando SSL entre PeopleSoft e Elasticsearch", que você pode acessar em "Explorar Mais", em outro lugar neste manual.
  • Antes de descobrir o Elasticsearch, crie um armazenamento confiável JKS (o JKS é o único armazenamento confiável suportado) no host do agente de monitoramento para armazenar o certificado do Elasticsearch. A localização e a senha desse armazenamento confiável são parâmetros obrigatórios na IU de descoberta ou no JSON de descoberta ao tentar a descoberta por meio da CLI. Além disso, o local do armazenamento confiável deve estar acessível no host do agente.
    Por exemplo: 
    keytool -keystore truststore.jks -alias ALIAS -import -file ELASTICSEARCH_CERTIFICATE

Ativar Descoberta do Process Monitor

O Process Monitor é descoberto junto com PeopleSoft e é ativado por padrão ao descobrir um aplicativo PeopleSoft. A seleção de Não na seção Descobrir Monitor de Processo exclui o Monitor de Processo da descoberta PeopleSoft.

A descoberta do Process Monitor é opcional. Se o Process Monitor já estiver ativado, você poderá incluí-lo na descoberta inicial. Para integrar o Process Monitor no futuro, use o comando PeopleSoft CLI refresh e adicione as concessões do Banco de Dados do Process Monitor ao usuário de monitoramento. Para obter mais informações sobre concessões, consulte "Estabelecer Privilégios de Concessão de Banco de Dados para Monitoramento de PeopleSoft", acima, e para obter mais informações sobre comandos de atualização de CLI, consulte "Atualizar Instâncias PeopleSoft", em outro lugar neste playbook.

Não há propriedades necessárias para a descoberta do Process Monitor.

A descoberta do Process Monitor é incluída por padrão. Para recusar, selecione Não no painel de descoberta Descobrir Monitor do Processo no Recurso.

Para obter mais informações, consulte "Ativar descoberta do Process Monitor para PeopleSoft", que você pode acessar em "Explorar Mais", em outro lugar neste manual.

Atualizar Topologia do Aplicativo

Você pode usar a CLI do OCI para descobrir novos recursos, criar associações necessárias entre os recursos do Stack Monitoring ou atualizar toda a topologia. Especificamente, você pode usar a CLI para criar associações entre o banco de dados e PeopleSoft.

Para PeopleSoft, a atualização da topologia do aplicativo requer estas tarefas:
  • Gerenciar domínios PeopleSoft.
  • Atualize instâncias PeopleSoft.

Gerenciar Domínios do PeopleSoft

O Stack Monitoring aproveita as informações de domínio contidas na tabela PSPMAGENT para descoberta. Se o seu domínio PeopleSoft estiver ausente, você poderá criar as informações de domínio necessárias manualmente seguindo as etapas descritas em "Adicionar Domínios Manualmente", em outro lugar neste manual.

Atualizar Instâncias PeopleSoft

A atualização do aplicativo PeopleSoft atualiza os seguintes tipos de recursos do Stack Monitoring:

oracle_psft
oracle_psft_appserv
oracle_psft_prcs
oracle_psft_pia
weblogic_domain (including members)

A atualização não validará as credenciais dos novos domínios encontrados durante o processo de atualização. Se, durante o processo de descoberta, quaisquer domínios com falha forem descobertos, eles poderão ser domínios obsoletos, talvez não estejam acessíveis para conexões JMX do agente ou por outros motivos. Depois que os problemas subjacentes forem resolvidos, certifique-se de que as credenciais comuns sejam válidas para cada um dos novos domínios que você pretende adicionar validando por meio de uma conexão JMX do host do agente e, em seguida, executando uma operação de atualização. Quando a atualização for bem-sucedida, os novos domínios serão adicionados. Esses domínios usam as mesmas credenciais comuns com as quais os domínios descobertos antecipadamente são configurados.

Uma atualização também atualizará os domínios WebLogic associados existentes e seus membros.

Quando novas instâncias PIA são adicionadas, a execução da atualização PeopleSoft descobrirá o recurso PIA recém-adicionado, mas não descobrirá o novo domínio WebLogic subjacente. Você precisa descobrir o domínio WebLogic manualmente usando a CLI para associar esse novo Domínio WebLogic ao PIA recém-descoberto.

Você pode atualizar a instância PeopleSoft na interface do usuário ou usando a CLI.
  • Para atualizar na IU, na home page do recurso, clique em Atualizar abaixo do nome do recurso. Na mensagem de confirmação, clique em OK para abrir o painel Descoberta de Recursos em uma nova guia. Você pode rastrear o status do job de atualização enviado aqui.
  • Para atualizar usando a CLI, execute discovery-job create. Esta opção envolve um arquivo JSON. Para permitir a exclusão de recursos durante a operação de atualização, adicione a propriedade allow_delete_resources ao payload, juntamente com a propriedade resource_id property e o ID do agente de monitoramento. O resource_id é o ID do recurso PeopleSoft que precisa ser atualizado.
    Para atualizar instâncias PeopleSoft usando a CLI, use este comando:
    oci stack-monitoring discovery-job create --compartment-id "Compartment_OCID" --discovery-type REFRESH --discovery-details file:///tmp/psft_refresh_dev.json

Para obter mais detalhes sobre como atualizar instâncias do PeopleSoft, consulte "PeopleSoft Refresh" na documentação do OCI, que você pode acessar em "Explorar Mais", em outro lugar neste manual.