1. Abilita il monitoraggio dello stack di osservabilità e gestione per PeopleSoft
  2. Introduzione al processo di distribuzione

Introduzione al processo di distribuzione

L'implementazione del monitoraggio dell'osservabilità e dello stack di gestione per le applicazioni PeopleSoft richiede tre passi principali:

  1. Configura le licenze per l'edizione, lo standard o l'azienda scelti e per tutte le risorse o i compartimenti utilizzati nella distribuzione.
  2. Individuare e promuovere le risorse utilizzate nella distribuzione.
  3. Utilizza l'interfaccia della riga di comando (CLI) OCI per trovare nuove risorse, creare associazioni necessarie tra le risorse di monitoraggio dello stack o aggiornare l'intera topologia.

Configura licenza

Stack Monitoring offre due edizioni: Standard e Enterprise. La Standard Edition monitora le applicazioni e gli stack tecnologici on premise e distribuiti nel cloud, inclusi WebLogic, Tomcat, Oracle Database e gli host. Enterprise Edition aggiunge funzioni avanzate come le estensioni di metrica, le baseline delle prestazioni, il rilevamento delle anomalie e l'integrazione delle risorse OCI per un monitoraggio avanzato.

Oltre a queste due edizioni, le licenze devono essere configurate a livello di singola risorsa o a livello di compartimento, come descritto di seguito.

Nota

I passaggi per l'assegnazione delle licenze a entrambi i livelli sono oltre l'ambito di questo playbook. È possibile accedere alle procedure pertinenti richieste per ogni livello di assegnazione, identificato nella sezione specifica, di seguito, da "Esplora di più", in altre parti di questo playbook.

Configurare le licenze per le funzioni specifiche dei compartimenti

È possibile impostare l'assegnazione automatica della licenza risorsa su Enterprise o Standard per tutte le nuove risorse trovate o promosse all'interno di un compartimento. La configurazione dell'assegnazione automatica delle licenze è un modo conveniente per assegnare automaticamente una licenza invece di applicarla per ogni istanza di risorsa. Inoltre, puoi abilitare o disabilitare l'estensibilità aziendale per un intero compartimento.

Le procedure per la configurazione delle licenze per le funzioni specifiche del compartimento sono descritte in "Assegnazione delle licenze" nella documentazione di Oracle Cloud Infrastructure, alla quale è possibile accedere da "Scopri di più".

Configurare le licenze per funzioni specifiche delle risorse

L'assegnazione della licenza delle risorse può essere eseguita a livello di singola risorsa durante la ricerca automatica o dopo la ricerca automatica utilizzando l'interfaccia utente della licenza. Le modifiche alla licenza applicate a un composto si applicano a tutti i figli, ovvero quando si applica la licenza Enterprise Edition a un dominio WebLogic, tutti i server WebLogic associati al dominio riceveranno anche la Enterprise Edition.

Durante la ricerca automatica, è possibile assegnare una licenza alla risorsa selezionando il pulsante di opzione corrispondente. È inoltre possibile modificare una licenza risorsa dopo che una risorsa è stata trovata utilizzando l'interfaccia utente di licenza. Queste procedure sono descritte in "Assegnazione delle licenze" nella documentazione di Oracle Cloud Infrastructure, alla quale è possibile accedere da "Scopri di più".

Scopri e promuovi le risorse per PeopleSoft

Per monitorare le risorse utilizzando Monitoraggio dello stack, è innanzitutto necessario individuare e promuovere tali risorse. La promozione preinserisce le informazioni correlate alla risorsa. È necessario convalidare queste informazioni per assicurarsi che siano corrette. I prerequisiti e i parametri di input per la promozione sono uguali a quelli per la ricerca automatica avviata dall'utente.

La ricerca automatica PeopleSoft prevede tre famiglie di risorse obbligatorie: il dominio dell'Application Server, il dominio dello scheduler dei processi e PeopleSoft Internet Architecture (PIA) con il dominio o i domini Weblogic di base. Ogni famiglia di risorse può includere una o più di queste risorse, che possono estendersi su diversi server.

Per scoprire e promuovere le risorse per le applicazioni PeopleSoft, è necessario effettuare le operazioni riportate di seguito.
  • Trova il database PeopleSoft.
  • Stabilisce i privilegi di concessione del database per il monitoraggio PeopleSoft.
  • Abilitare PeopleSoft Performance Monitor per PIA (Pure Internet Architecture).
  • Soddisfare i prerequisiti per i domini Application Server e Process Scheduler.
  • Identificare i domini da trovare.
  • Aggiungere i domini manualmente.
  • Abilita la ricerca automatica di Elasticsearch.
  • Abilita la ricerca automatica del monitoraggio dei processi.

Nota

I passi per scoprire e promuovere le risorse sono al di là della portata di questo playbook. È possibile accedere alle procedure pertinenti richieste per ogni livello di assegnazione, identificato nella sezione specifica, di seguito, da "Esplora di più", in altre parti di questo playbook.

Scopri il database PeopleSoft

È necessario individuare l'Oracle Database contenente lo schema PeopleSoft prima di trovare l'applicazione PeopleSoft.

Individuando prima il database, questo viene automaticamente associato all'applicazione PeopleSoft una volta completata la ricerca automatica delle risorse PeopleSoft. Se si esegue la ricerca automatica dell'applicazione PeopleSoft prima di trovare il database, sarà necessario creare l'associazione manualmente. Per ulteriori informazioni, vedere la topologia dell'applicazione. Per scoprire il database Oracle, consulta "Oracle Database", a cui puoi accedere da "Esplora di più", in altre parti di questa guida.

Stabilire i privilegi di concessione del database per il monitoraggio PeopleSoft

Per monitorare PeopleSoft, è necessario disporre di privilegi specifici per accedere allo schema di database PeopleSoft. L'impostazione varia a seconda del tipo di database (database non container rispetto al container database e al pluggable database) utilizzato come datastore PeopleSoft.

Quando si rileva il monitoraggio dello stack PeopleSoft, è possibile utilizzare il proprietario dello schema PeopleSoft, in genere SYSADM, come credenziali del database. È consigliabile creare un utente di monitoraggio con solo i privilegi necessari per monitorare un'applicazione PeopleSoft. Utilizzare lo stesso utente del database per monitorare sia il database Oracle contenente lo schema PeopleSoft che l'applicazione PeopleSoft.

Per creare un utente di monitoraggio del database, vedere la nota MOS: 2857604.1. Per ulteriori informazioni, vedere anche "DB Grant Privileges for PeopleSoft Monitoring" nella documentazione OCI. Puoi accedere a entrambi questi documenti da "Esplora di più", altrove in questo playbook.

Abilitare PeopleSoft Performance Monitor per PIA (Pure Internet Architecture)

Si tratta di una procedura facoltativa, obbligatoria solo per la ricerca automatica e l'aggiornamento di PeopleSoft. Tuttavia, per il monitoraggio e la raccolta regolare delle metriche, l'agente PeopleSoft Performance Monitor non è necessario. Se per qualsiasi motivo si è scelto di non abilitare l'agente PPM, utilizzare una delle seguenti alternative:
  • Abilitare l'agente PPM fino al termine della ricerca automatica o dell'aggiornamento, quindi disabilitarlo e riavviare i domini.
  • INSERT/DELETE manualmente tutte le informazioni sul dominio PeopleSoft. Ciò eliminerà la necessità di abilitare Abilita agente PPM.
Se è necessario abilitare il PPM per PIA, effettuare le operazioni riportate di seguito.
  1. Passare a PeopleTools, andare a Profilo Web, fare clic su Configurazione profilo Web e cercare il profilo in uso, ad esempio PROD.
  2. Se non è già selezionata, selezionare Abilita agente PPM.
  3. Riavviare tutti i domini PIA.

Soddisfa i prerequisiti per i domini Application Server e Process Scheduler

Successivamente, è necessario soddisfare i prerequisiti per ciascun dominio Application Server e Process Scheduler. La ricerca automatica PeopleSoft presuppone che l'ID utente/password di amministrazione remota per l'accesso JMX sia lo stesso per tutti i domini Application Server e anche per tutti i domini Process Scheduler.

I prerequisiti da completare sono i seguenti:
  • Abilitare l'agente PeopleSoft Performance Monitor.
  • Abilita gli agenti JMX.
  • Abilita la proprietà Collator prestazioni.

Gli argomenti riportati di seguito forniscono i passi di alto livello per il completamento di questi task. Per le procedure dettagliate, consulta la sezione "Prerequisiti per i domini Application Server e Process Scheduler" nella documentazione OCI di Monitoraggio dello stack, alla quale puoi accedere da "Scopri di più", in altre parti di questo playbook.

Abilitare l'agente Performance Monitor PeopleSoft

Per abilitare l'agente Performance Monitor PeopleSoft, effettuare le operazioni riportate di seguito.

  1. Aprire i file di configurazione del dominio in modalità di modifica. Dall'interfaccia della riga di comando PSADMIN selezionare Application Server (opzione 1) o Process Scheduler (opzione 2), quindi Administer a domain (opzione 1), Select Domain, quindi Edit configuration/log files menu (opzione 6), quindi Edit domain configuration file (opzione 1).
  2. Nella sezione PSTOOLS, selezionare il valore per Agente EnablePPM.
  3. Abilitare gli agenti PPM, impostare il valore su 1 e salvare il file.
Abilita agenti JMX

Questo prerequisito consente a Monitoraggio dello stack di raccogliere i dati di disponibilità e prestazioni per un'applicazione PeopleSoft. Di seguito sono riportati i passi di alto livello.

  1. Aprire i file di configurazione del dominio in modalità di modifica dall'interfaccia della riga di comando PSADMIN. Selezionare Application Server (opzione 1) o Process Scheduler (opzione 2), quindi Administer a domain (opzione 1), select domain, Edit configuration/log files menu (opzione 6), quindi Edit domain configuration file (opzione 1).
  2. Individuare le impostazioni per la sezione PSTOOLS ed effettuare le operazioni riportate di seguito.
    1. Accertarsi che la porta di amministrazione remota che si desidera utilizzare non sia utilizzata da altri processi dell'host.
    2. Impostare l'ID utente in formato testo. Utilizzare lo stesso ID utente e la stessa password per tutti i domini di Application Server e i domini dello scheduler dei processi.
    3. Cifrare le password utilizzando la utility PSCipher.
    4. Dopo aver configurato la modifica della proprietà Collator prestazioni (come descritto nel seguente argomento), riavviare i domini Application Server e Process Scheduler.
  3. Impostare i valori della porta di amministrazione remota e della porta RMI.
    • Se si utilizza PeopleSoft versione 8.59 e versioni precedenti, è sufficiente impostare la porta di amministrazione remota. Il valore della porta RMI viene impostato automaticamente, incrementando di uno il valore della porta di amministrazione remota.
    • Per PSFT versione 8.60 in poi, la porta RMI è controllata da un parametro aggiuntivo nel file di configurazione. Assicurarsi che il valore sia impostato in modo esplicito. Riavviare i domini Application Server e Process Scheduler dopo aver configurato la proprietà Performance Collator.
  4. Assicurarsi che le impostazioni salvate vengano visualizzate correttamente nel file di configurazione.
Per istruzioni più dettagliate, consulta "Abilita agenti JMX" nella documentazione OCI, alla quale puoi accedere da "Esplora altro", in altre parti di questa guida.
Abilita proprietà garante prestazioni

Prima di abilitare la proprietà Collator prestazioni, controllare il valore corrente di Collator prestazioni nei file del modello di dominio psprcsrv.ubx (scheduler dei processi) e psappsrv.ubx (Application Server) in $PS_CFG_HOME.

Se l'opzione relativa alle garanzie sulle prestazioni è abilitata, verrà visualizzata la seguente voce: 
{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [y]:
Se il responsabile delle prestazioni è disabilitato, verrà visualizzata la seguente voce: 
{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [n]:
Se il Collator prestazioni è già abilitato e le modifiche sono state implementate nei valori dell'agente EnablePPM o JMX, è possibile riavviare tutti i domini. Se il responsabile delle prestazioni non è già abilitato, effettuare le operazioni riportate di seguito.
  1. Dall'interfaccia della riga di comando PSADMIN, selezionare Application Server (Option 1) o Process Scheduler (Option 2), quindi Administer a domain (Option 1), quindi select domain e infine Configure this domain (Option 4) .
  2. Immettere y per la domanda Do you want to continue (y/n). Questa opzione chiuderà il dominio.
  3. Valore di controllo della proprietà Collator prestazioni.
    • Se il valore è impostato su Sì, la documentazione promozionale è già abilitata e non è richiesta alcuna azione. 
      Load config as shown
      È possibile selezionare l'opzione 14 per Application Server o l'opzione 7 per Process Scheduler.
    • Se si imposta il valore su No, inserire l'opzione 10 per Application Server o l'opzione 3 per Process Scheduler per attivare o disattivare il valore su Sì.
  4. Dopo aver confermato che il Collator prestazioni è impostato su Sì, selezionare Load config as shown (opzione 14 per lo scheduler applicazioni o opzione 7 per Process Scheduler ).
  5. Infine, selezionare Boot this domain Option 1 per avviare il dominio.

Identifica domini da trovare

Monitoraggio dello stack utilizza le informazioni memorizzate all'interno di Oracle Database per identificare i domini da trovare o aggiornare.

Per convalidare l'elenco dei domini correnti, utilizzare la seguente query:
SELECT * FROM PSPMAGENT;
Prima di individuare o aggiornare l'applicazione PeopleSoft, è necessario rimuovere tutti i domini restituiti dalla query che non esistono più.

Nota

Se è necessario aggiungere un dominio non elencato, vedere il seguente argomento "Aggiunta manuale dei domini".
Per rimuovere i domini non più validi, eseguire il login come SYSADM o un utente equivalente ed eseguire la query SQL seguente. Ripetere la query finché non saranno stati rimossi tutti i domini non più validi. Tenere conto di queste considerazioni:
  • Eseguire il backup della tabella PSPMAGENT prima di apportare modifiche. 
    create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;

    dove DATE con l'indicatore orario corrente

  • Verificare che la tabella di backup creata abbia lo stesso contenuto della tabella padre. 
    select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
Se il conteggio delle righe da PSPMAGENT corrisponde a PSPMAGENT_BKP_DATE, procedere con la rimozione dei domini non più validi: 
delete from PSPMAGENT WHERE PM_AGENTID='&enter_agent_id_of_stale_domain'; 
Commit;

Aggiungi domini manualmente

Successivamente, controlla se tutti i domini validi sono visibili dalla tabella PSPMAGENT. Se non vengono visualizzati domini validi, utilizzare le query negli argomenti riportati di seguito. L'host agente deve essere in grado di raggiungere tutti gli altri host utilizzando il nome host dalla colonna PM_HOST_PORT memorizzata nella tabella PSPMAGENT.

I domini da aggiungere manualmente sono:
  • Dominio Process Scheduler
  • Dominio Application Server
  • Server PIA
Prima di procedere, effettuare le seguenti operazioni per eseguire il backup della tabella PSPMAGENT:
  1. Prima di apportare modifiche, eseguire il login come amministratore di sistema o utente equivalente ed eseguire il backup della tabella. 
    create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;
    dove DATE è l'indicatore orario corrente.
  2. Verificare che la tabella di backup creata abbia lo stesso contenuto della tabella padre. Il conteggio delle righe da PSPMAGENT deve corrispondere al conteggio delle righe da PSPMAGENT_BKP_DATE:
    select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
    dove DATE è l'indicatore orario corrente.
Utilizzare i comandi seguenti per aggiungere i domini:
  • Dominio Process Scheduler
    INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');
  • Dominio 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');
  • Server 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');

Abilita Elasticsearch Discovery

La ricerca automatica elastica è facoltativa. Se Elasticsearch è già integrato, è possibile includerlo nella ricerca automatica iniziale. Per integrare Elasticsearch in futuro, utilizzare il comando PeopleSoft CLI refresh e aggiungere le autorizzazioni del database Elasticsearch all'utente di monitoraggio. Per ulteriori informazioni sui privilegi, vedere "Stabilire i privilegi di concessione del database per il monitoraggio PeopleSoft" in alto e per ulteriori informazioni sui comandi di aggiornamento CLI, vedere "Aggiorna istanze PeopleSoft" in altre parti di questa guida.
Il completamento di questi prerequisiti consentirà Elasticsearch Integration in PeopleSoft:
  • Monitoraggio dello stack supporta solo il monitoraggio Elasticsearch configurato con SSL. L'endpoint deve essere HTTPS. Per ulteriori informazioni sulla configurazione di Elasticsearch, vedere "Configurazione di SSL tra PeopleSoft ed Elasticsearch", a cui è possibile accedere da "Esplora di più", altrove in questo playbook.
  • Prima di individuare Elasticsearch, creare un truststore JKS (JKS è l'unico truststore supportato) nell'host dell'agente di monitoraggio per memorizzare il certificato da Elasticsearch. La posizione e la password di questo truststore sono parametri obbligatori nell'interfaccia utente di ricerca automatica o nel file JSON di ricerca automatica durante il tentativo di ricerca automatica tramite CLI. Inoltre, la posizione del truststore deve essere accessibile sull'host dell'agente.
    Ad esempio: 
    keytool -keystore truststore.jks -alias ALIAS -import -file ELASTICSEARCH_CERTIFICATE

Abilita ricerca automatica Process Monitor

Process Monitor viene rilevato insieme a PeopleSoft ed è abilitato per impostazione predefinita durante la ricerca automatica di un'applicazione PeopleSoft. Se si seleziona No nella sezione Discover Process Monitor, il monitoraggio dei processi viene escluso dalla ricerca automatica PeopleSoft.

La ricerca automatica di Process Monitor è facoltativa. Se Process Monitor è già abilitato, è possibile includerlo nella ricerca automatica iniziale. Per integrare Process Monitor in futuro, utilizzare il comando refresh dell'interfaccia CLI PeopleSoft e aggiungere le autorizzazioni del database Process Monitor all'utente di monitoraggio. Per ulteriori informazioni sui privilegi, vedere "Stabilire i privilegi di concessione del database per il monitoraggio PeopleSoft" in alto e per ulteriori informazioni sui comandi di aggiornamento CLI, vedere "Aggiorna istanze PeopleSoft" in altre parti di questa guida.

Non sono necessarie proprietà per la ricerca automatica di Process Monitor.

La ricerca automatica di Process Monitor è inclusa per impostazione predefinita. Per eseguire l'opt-out, selezionare No nel pannello di ricerca automatica Trova Process Monitor nella risorsa.

Per ulteriori informazioni, vedere "Abilita ricerca automatica Process Monitor per PeopleSoft", a cui è possibile accedere da "Esplora altro", in altre parti di questo playbook.

Aggiorna topologia applicazione

Puoi utilizzare l'interfaccia CLI OCI per trovare nuove risorse, creare associazioni necessarie tra le risorse di monitoraggio dello stack o aggiornare l'intera topologia. In particolare, è possibile utilizzare l'interfaccia CLI per creare associazioni tra il database e PeopleSoft.

Per PeopleSoft, l'aggiornamento della topologia dell'applicazione richiede i task riportati di seguito.
  • Gestire i domini PeopleSoft.
  • Aggiorna le istanze PeopleSoft.

Gestire i domini PeopleSoft

Monitoraggio dello stack utilizza le informazioni sul dominio contenute nella tabella PSPMAGENT per la ricerca automatica. Se manca il tuo dominio PeopleSoft, puoi creare manualmente le informazioni necessarie sul dominio seguendo i passaggi descritti in "Aggiungi domini manualmente", in altre parti di questa guida.

Aggiorna istanze PeopleSoft

Aggiornamento dell'applicazione PeopleSoft per i seguenti tipi di risorsa di monitoraggio dello stack:

oracle_psft
oracle_psft_appserv
oracle_psft_prcs
oracle_psft_pia
weblogic_domain (including members)

L'aggiornamento non convaliderà le credenziali per i nuovi domini trovati durante il processo di aggiornamento. Se, durante il processo di ricerca automatica, sono stati trovati domini non riusciti, questi potrebbero essere domini non più validi, potrebbero non essere accessibili per le connessioni JMX dall'agente o per altri motivi. Una volta risolti i problemi di base, assicurarsi che le credenziali comuni siano valide per ciascuno dei nuovi domini che si intende aggiungere convalidando tramite una connessione JMX dall'host agente e quindi eseguendo un'operazione di aggiornamento. Una volta completato l'aggiornamento, vengono aggiunti i nuovi domini. Questi domini utilizzano le stesse credenziali comuni con cui vengono configurati i domini precedentemente rilevati.

Un aggiornamento aggiornerà inoltre i domini WebLogic associati esistenti e i relativi membri.

Quando vengono aggiunte nuove istanze PIA, l'esecuzione dell'aggiornamento PeopleSoft determinerà la nuova risorsa PIA aggiunta, ma non individuerà il nuovo dominio WebLogic di base. È necessario individuare manualmente il dominio WebLogic utilizzando l'interfaccia CLI per associare il nuovo dominio WebLogic all'interfaccia PIA appena trovata.

È possibile aggiornare l'istanza PeopleSoft dall'interfaccia utente o utilizzando l'interfaccia CLI.
  • Per eseguire l'aggiornamento dall'interfaccia utente, nella home page della risorsa fare clic su Aggiorna sotto il nome della risorsa. Nel messaggio di conferma, fare clic su OK per aprire il pannello Ricerca automatica risorse in una nuova scheda. È possibile tenere traccia dello stato del job di aggiornamento sottomesso qui.
  • Per eseguire l'aggiornamento utilizzando l'interfaccia CLI, è necessario eseguire discovery-job create. Questa opzione prevede un file JSON. Per consentire l'eliminazione delle risorse durante l'operazione di aggiornamento, è necessario aggiungere la proprietà allow_delete_resources al payload, insieme alla proprietà resource_id property e all'ID agente di monitoraggio. resource_id è l'ID della risorsa PeopleSoft che deve essere aggiornata.
    Per aggiornare le istanze PeopleSoft utilizzando l'interfaccia CLI, utilizzare il comando seguente:
    oci stack-monitoring discovery-job create --compartment-id "Compartment_OCID" --discovery-type REFRESH --discovery-details file:///tmp/psft_refresh_dev.json

Per ulteriori dettagli sull'aggiornamento delle istanze PeopleSoft, vedere "PeopleSoft Refresh" nella documentazione OCI, a cui è possibile accedere da "Explore More", in altre parti di questa guida.