Configurare PeopleSoft

È necessario accedere al database per completare la configurazione del file system dei server di livello intermedio in standby.

Conversione del primo database in standby in standby snapshot

Portare l'applicazione fino a completare la configurazione dell'ambiente in standby. A tale scopo, è necessario accedere temporaneamente al database in modalità di lettura-scrittura, operazione impossibile quando il database applica redo dal database primario. Quando si converte il database OCI inOracle Exadata Database Service on Dedicated Infrastructure da uno standby fisico a uno standby snapshot, redo dal database primario viene spedito allo standby, ma non viene applicato fino a quando il database non viene ripristinato in uno standby fisico.

Con SSH, accedi a uno dei nodi DB di Oracle Exadata Database Service on Dedicated Infrastructure (domUs).
Diventare l'utente oracle.
```
$ sudo su – oracle
```
Origine dell'ambiente del database di standby.
Questo ambiente è stato creato quando il database segnaposto è stato creato in preparazione per l'utilizzo di Oracle Zero Downtime Migration.
```
$ . ./CDBHCM.env
```

Avviare il broker Oracle Data Guard e immettere la password SYS.

$ dgmgrl
DGMGRL for Linux: Release 19.0.0.0.0 - Production on Tue Nov 15 18:38:11 2022
Version 19.14.0.0.0

Copyright (c) 1982, 2019, Oracle and/or its affiliates.  All rights reserved.

Welcome to DGMGRL, type "help" for information.
DGMGRL> connect sys/password
Connected to " CDBHCM_iad1dx"
Connected as SYSDBA.
DGMGRL>

Mostra la configurazione Data Guard, inclusi i tempi di ritardo dei redo e dell'applicazione.

DGMGRL> show configuration lag

Configuration - ZDM_ CDBHCM_iad1dx

  Protection Mode: MaxPerformance
  Members:
  CDBHCM_sca6dp   - Primary database
    CDBHCM_iad1dx - Physical standby database 
                     Transport Lag:      0 seconds (computed 1 second ago)
                     Apply Lag:          0 seconds (computed 1 second ago)
    CDBHCM_phx5s - Physical standby database (receiving current redo)
                      Transport Lag:      1 second (computed 1 second ago)
                      Apply Lag:          2 seconds (computed 1 second ago)


Fast-Start Failover:  Disabled

Configuration Status:
SUCCESS   (status updated 43 seconds ago)

Se non si verificano errori e in alto viene visualizzato "SUCCESS", convertire il database di standby in uno standby snapshot.

DGMGRL> convert database CDBHCM_iad1dx to snapshot standby
Converting database "CDBHCM_iad1dx" to a Snapshot Standby database, please wait...
Database "CDBHCM_iad1dx" converted successfully

Mostrare nuovamente la configurazione per verificare che lo standby fisico sia ora uno standby snapshot.

È possibile che vengano visualizzate avvertenze che indicano che il ritardo del trasporto ha superato le soglie. Questo avviso scompare dopo alcuni minuti.

DGMGRL> show configuration lag

Configuration - ZDM_ CDBHCM_iad1dx

  Protection Mode: MaxPerformance
  Members:
   CDBHCM_sca6dp - Primary database
   CDBHCM_iad1dx - Snapshot standby database 
                     Transport Lag:      0 seconds (computed 2 seconds ago)
                     Apply Lag:          10 minutes 14 seconds (computed 2 seconds ago)
    CDBHCM_phx5s - Physical standby database (receiving current redo)
                      Transport Lag:      1 second (computed 1 second ago)
                      Apply Lag:          2 seconds (computed 1 second ago)


Fast-Start Failover:  Disabled

Configuration Status:
SUCCESS   (status updated 60 seconds ago)

Verificare che i servizi richiesti per PeopleSoft siano stati avviati.
Per questo esempio, i servizi sono: HR92U033_BATCH e HR92U033_ONLINE. Oracle Zero Downtime Migration ha eseguito la migrazione di questi servizi dal database di origine (on-premise) e li ha registrati in Oracle Clusterware.
```
$ srvctl status service -db CDBHCM_iad1dx -s HR92U033_BATCH
Service HR92U033_BATCH is running on instance(s) CDBHCM1,CDBHCM2
$ srvctl status service -db CDBHCM_iad1dx -s HR92U033_ONLINE
Service HR92U033_ONLINE is running on instance(s) CDBHCM1,CDBHCM2
```

Se i servizi richiesti non sono stati avviati, avviarli.

$ srvctl start service -db CDBHCM_iad1dx -s HR92U033_BATCH
$ srvctl start service -db CDBHCM_iad1dx -s HR92U033_ONLINE

Lo standby snapshot è pronto per la configurazione dello scheduler di applicazioni e processi.

Stabilire la connessione al database PeopleSoft

Modificare il file tnsnames.ora per stabilire la connessione.

Eseguire il login a una delle istanze di computazione OCI e ottenere il file psft.env. Quindi spostarsi nella directory $TNS_ADMIN:
```
$ cd $TNS_ADMIN
```

Modificare il file tnsnames.ora, modificando il valore HOST nel nome SCAN del cluster nelle stringhe di connessione al database per i domini Application Server e Process Scheduler.

Nota

PeopleTools utilizza gli alias di connessione TNS come DBNames. Assicurarsi che i nomi alias TNS corrispondano alla colonna DBNAME nella tabella PS.PSDBOWNER.

Ad esempio, nella tabella PSDBOWNER di esempio sono riportate le voci riportate di seguito.

DBNAME   OWNERID
-------- --------
HR92U033 EMDBO
HRBATCH  EMDBO

Di seguito sono riportate le voci del file tnsnames.ora di esempio.

# Application server
HR92U033 =
    (DESCRIPTION =
       (CONNECT_TIMEOUT=5)(TRANSPORT_CONNECT_TIMEOUT=3)(RETRY_COUNT=3)
       (ADDRESS_LIST =
           (LOAD_BALANCE=on)
           (ADDRESS = (PROTOCOL = TCP)(HOST = iadexadb-bw5wn-scan.ebsexadbprivate.ebscloudmaavcn.oraclevcn.com)(PORT = 1521))
       )
        (CONNECT_DATA =
           (SERVER = DEDICATED)
           (SERVICE_NAME = HR92U033_ONLINE)
       )
    )
 
# Process scheduler
HRBATCH =
   (DESCRIPTION =
       (CONNECT_TIMEOUT=5)(TRANSPORT_CONNECT_TIMEOUT=3)(RETRY_COUNT=3)
       (ADDRESS_LIST =
       (LOAD_BALANCE=on)
           (ADDRESS = (PROTOCOL = TCP)(HOST = iadexadb-bw5wn-scan.ebsexadbprivate.ebscloudmaavcn.oraclevcn.com)(PORT = 1521))
       )
       (CONNECT_DATA =
           (SERVER = DEDICATED)
           (SERVICE_NAME = HR92U033_BATCH)
       )
    )

Per eseguire il test di questa configurazione, assicurarsi che i servizi di database di cui è stata eseguita la migrazione da Oracle Zero Downtime Migration siano attivi e in esecuzione.
Nella configurazione di esempio, sono HR92U033_ONLINE e HR92U033_BATCH.

Eseguire il login come utente del sistema operativo psadm2 ed eseguire il test del primo alias di stringa di connessione TNS con SQL*Plus.

$ sqlplus PS/password@HR92U033
SQL*Plus: Release 19.0.0.0.0 - Production on Sat Nov 20 00:50:53 2021
Version 19.3.0.0.0
Copyright (c) 1982, 2019, Oracle.  All rights reserved.
Last Successful login time: Fri Nov 19 2021 02:06:04 +00:00

Connected to:
Oracle Database 19c EE Extreme Perf Release 19.0.0.0.0 - Production
Version 19.19.0.0.0

SQL>

Eseguire il test dell'alias della stringa di connessione HRBATCH in modo simile per assicurarsi che si connetta correttamente al database.
Eseguire questi test su tutte le istanze di computazione che ospiteranno lo scheduler dell'applicazione e del processo.

Configurare i domini dell'applicazione PeopleSoft

Distribuire il dominio dell'Application Server e configurare le istanze di computazione per ospitare gli Application Server.

In questo scenario, il dominio dell'Application Server è HR92U033 e due delle quattro istanze di computazione ospiteranno sia gli Application Server che lo scheduler dei processi: iad-psft-hcm-app01 e iad-psft-hcm-app02. Gli Application Server e lo scheduler dei processi vengono eseguiti ciascuno all'interno del proprio dominio Oracle Tuxedo.

L'utente psadm2 utilizzerà la utility psadmin per configurare il dominio Oracle Tuxedo, incluso l'Application Server.

Individuare il file psappsrv.cfg nella directory $PS_CFG_HOME/appserv/Application server domain. Utilizzare la utility psadmin per apportare le modifiche di configurazione necessarie a questo file ($PS_HOME/bin/psadmin) prima di distribuire il dominio su ciascun nodo.

Avviare la utility psadmin come utente psadm2 sul primo nodo (iad-psft-hcm-app01).
```
cd $PS_HOME/bin ./psadmin
```
Quando viene avviata la utility psadmin, verranno visualizzati i percorsi delle directory per PS_HOME, PS_CFG_HOME e PS_APP_HOME. Assicurarsi che siano corretti.
Di seguito sono riportati alcuni esempi.
```
PS_CFG_HOME            /peoplesoft/local/ps_config
PS_HOME                /u01/app/psft/pt/ps_home8.57.11
PS_APP_HOME            /u01/app/psft/pt/hcm_app_home
```
Selezionare opzione 1: Dominio applicazione per configurare il dominio del server applicazioni.
Selezionare opzione 1: Amministra un dominio. Selezionare il nome di dominio, nel nostro caso HR92U033.
Selezionare opzione 4: Configura questo dominio. Immettere Y per chiudere il dominio.
Esaminare le opzioni e le impostazioni di configurazione visualizzate.
- Assicurarsi che gli alias delle stringhe di connessione TNS siano corretti per DBName. Nel nostro caso è HR92U033.
- Apportare le modifiche necessarie per le porte utilizzate dal server del dominio dell'applicazione.
- Prendere nota in particolare dell'intervallo di porte JOLT: le porte utilizzate dal server Web PeopleSoft Internet Architecture (PIA) per connettersi all'Application Server. Questi valori verranno utilizzati in un passo successivo. L'impostazione predefinita è 9000 - 9010.
Selezionare opzione 14: Carica dominio come mostrato.
La configurazione del dominio viene caricata e tutti i file di dominio necessari per Oracle Tuxedo vengono rigenerati.
Selezionare opzione 1: eseguire il boot di questo dominio in Amministrazione dominio per avviare questo dominio.
Monitorare il processo di avvio. Se vengono segnalati errori, controllare i file di log in. $PS_CFG_HOME/appserv/domain name/LOGS
Ripetere i passi da 1 a 7 come utente psadm2 sul secondo nodo, iad-psft-hcm-app02.

Configurare i domini Process Scheduler

Lo scheduler dei processi PeopleSoft (o server batch) è configurato in modo simile a quello dell'Application Server, oltre alla configurazione dei log dello scheduler dei processi. L'utente psadm2 creerà una directory per ogni nodo dello scheduler dei processi:

/u02/app/psft/ps/log_output/node1/HR92U033 (per il nodo: iad-psft-hcm-app01)
/u02/app/psft/ps/log_output/node2/HR92U033 (per il nodo: iad-psft-hcm-app02)

Puoi eseguire questa operazione da una qualsiasi delle istanze di computazione di livello intermedio. Con le directory di output dei log in posizione, eseguire le operazioni riportate di seguito per configurare lo scheduler dei processi.

Avviare la utility psadmin come utente psadm2 sul primo nodo (iad-psft-hcm-app01).
```
cd $PS_HOME/bin ./psadmin
```
Quando viene avviata la utility psadmin, verranno visualizzati i percorsi di directory per PS_HOME, PS_CFG_HOME e PS_APP_HOME. Assicurarsi che siano corretti.
Di seguito sono riportati alcuni esempi.
```
PS_CFG_HOME            /peoplesoft/local/ps_config
PS_HOME                /u01/app/psft/pt/ps_home8.57.11
PS_APP_HOME            /u01/app/psft/pt/hcm_app_home
```
Selezionare l'opzione 2: Process Scheduler.
Selezionare opzione 1: Amministra un dominio. Selezionare il nome di dominio, nel nostro caso HR92U033.
Selezionare opzione 4: Configura questo dominio. Immettere Y per chiudere il dominio.
Esaminare le opzioni e le impostazioni di configurazione visualizzate.
Assicurarsi che gli alias delle stringhe di connessione TNS siano corretti per DBName. Nel nostro caso è HRBATCH.
Selezionare l'opzione 16: Log/Output e fornire i percorsi di directory appena creati.
Di seguito sono riportati alcuni esempi.
- /u02/app/psft/ps/log_output/node1/HR92U033 (per il nodo: iad-psft-hcm-app01)
- /u02/app/psft/ps/log_output/node2/HR92U033 (per il nodo: iad-psft-hcm-app02)
Selezionare opzione 6: Carica dominio come mostrato.
La configurazione del dominio viene caricata e tutti i file di dominio necessari per Oracle Tuxedo vengono rigenerati.
Selezionare opzione 1: eseguire il boot di questo dominio in Amministrazione dominio per avviare questo dominio.
Monitorare il processo di avvio. Se vengono segnalati errori, controllare i file di log in. $PS_CFG_HOME/appserv/prcs/domain name/LOGS
Ripetere i passi da 1 a 8 come utente psadm2 sul secondo nodo, iad-psft-hcm-app02.
Aprire la porta JOLT su tutte le istanze di calcolo di Application Server e Process Scheduler.
Questa operazione viene eseguita con il comando firewall-cmd, che viene eseguito come root. Di seguito è riportato un esempio che sarà necessario modificare per l'ambiente in uso.
```
# firewall-cmd --zone=public --add-rich-rule 'rule family=ipv4 source address=10.0.103.0/24 port port=9000-9100 protocol=tcp accept' –permanent
# firewall-cmd --reload
```

Monitorare le connessioni al database dello scheduler di applicazioni e processi all'avvio di questi domini Oracle Tuxedo. È possibile eseguire il login a una delle istanze di Oracle Exadata Database Service on Dedicated Infrastructure Oracle Real Application Clusters (Oracle RAC) come utente oracle OS per eseguire la query seguente per il monitoraggio:

$ sqlplus / as sysdba
SQL> col service_name format a20
SQL> select a.inst_id,a.instance_name,b.service_name, count(*)
2> from gv$instance a, gv$session b
3> where a.inst_id = b.inst_id
4> and service_name not like 'SYS%'
5> group by a.inst_id,a.instance_name,b.service_name
6> order by 1;

Di seguito viene fornito un esempio di output.

INST_ID INSTANCE_NAME    SERVICE_NAME           COUNT(*)
---------- ---------------- -------------------- ----------
         1 CDBHCM1          HR92U033_BATCH                8
         1 CDBHCM1          HR92U033_ONLINE              54
         2 CDBHCM2          HR92U033_BATCH                7
         2 CDBHCM2          HR92U033_ONLINE              48

L'output mostra il numero di connessioni a ciascun servizio in ogni istanza Oracle RAC. I processi devono essere sparsi tra i database server.

Configurare il dominio del server Web PIA PeopleSoft

Utilizzare lo script PeopleSoft Internet Architecture (PIA) setup.sh per configurare il dominio del server Web PIA.

Eseguire i passi riportati di seguito come utente psadm2 su ogni VM dell'istanza di computazione che ospiterà un server Web PIA.

Origine dell'ambiente come utente psadm2 sul primo nodo (iad-psft-hcm-web01).
```
$ . ./psft.env
```
Assicurarsi che sia definito PS_CFG_HOME. In questo esempio, viene impostato su /peoplesoft/local/ps_config. In caso contrario, assicurarsi che .bash_profile richiami il file psft.env.
Copiare il file di risposta del modello nella directory PS_CFG_HOME per la personalizzazione.
```
$ cd $PS_HOME/setup/PsMpPIAInstall
$ cp resp_file.txt $PS_CFG_HOME/iad_oci_pia_resp.txt
```

Modificare il file iad_oci_pia_resp.txt per l'ambiente in uso.

Nell'esempio seguente sono inclusi i callout in grassetto per i 10 elementi da modificare.

# Name of the PIA domain
DOMAIN_NAME=HR92U033    - The domain name can be the same on all nodes
# Web server type. Possible values are "weblogic", "websphere"
SERVER_TYPE=weblogic
# WebLogic home, the location where Oracle WebLogic is installed (for WebLogic deployment only)
BEA_HOME=/u01/app/psft/pt/bea
# admin console user id/password for securing WebLogic/WebSphere admin console credential
USER_ID=system
USER_PWD=password
USER_PWD_RETYPE=password
# Install action to specify the core task that installer should perform.
# For creating new PIA domain - CREATE_NEW_DOMAIN.
# For redeploying PIA - REDEPLOY_PSAPP.
# For recreating PIA domain - REBUILD_DOMAIN.
# For installing additional PSFT site - ADD_SITE
# For installing Extensions - ADD_PSAPP_EXT
INSTALL_ACTION=CREATE_NEW_DOMAIN          Use CREATE_NEW_DOMAIN
# Domain type to specify whether to create new domain or modify existing domain. Possible values are "NEW_DOMAIN", "EXISTING_DOMAIN".
DOMAIN_TYPE=NEW_DOMAIN
# Install type to specify whether the installation is a single server,  multi-server deployment or distributed webLogic server .
#Possible values are "SINGLE_SERVER_INSTALLATION", "MULTI_SERVER_INSTALLATION" and "DISTRIBUTED_SERVER_INSTALLATION"
INSTALL_TYPE=SINGLE_SERVER_INSTALLATION
# WebSite Name           THIS MUST BE THE SAME FOR ALL PeopleSoft WEB SERVERS
WEBSITE_NAME=ps          For our project we chose “ps”.
                           
# AppServer Name
APPSERVER_NAME=iad-psft-hcm-app01         The application domain server
# Appserver JSL Port
JSL_PORT=9000         This is the default port, you can choose a different port
# HTTP Port
HTTP_PORT=8080     PIA front-end port to access PeopleSoft application
# HTTPS Port
HTTPS_PORT=8443   PIA front-end SSL port if SSL is enabled on the web server
# Authentication Domain (optional)
AUTH_DOMAIN=appprivatesu.ebscloudmaavcn.oraclevcn.com    Change this to match the network domain for your environment.
# Web Profile Name Possible Values are "DEV","TEST","PROD","KIOSK"
WEB_PROF_NAME=PROD
# Web Profile password for User "PTWEBSERVER"
WEB_PROF_PWD=PTWEBSERVER
WEB_PROF_PWD_RETYPE=PTWEBSERVER
# Integration Gateway user profile.
IGW_USERID=administrator
IGW_PWD=password
IGW_PWD_RETYPE=password
# AppServer connection user profile
APPSRVR_CONN_PWD=PS
APPSRVR_CONN_PWD_RETYPE=PS
# Directory path for reports
REPORTS_DIR=/u02/app/psft/ps/report_repository   Report repository location

Eseguire lo script setup.sh per configurare PIA, puntando al nuovo file di risposta.
```
$ ./setup.sh -i silent -DRES_FILE_PATH=$PS_CFG_HOME/iad_oci_pia_resp.txt
```
Abilitare il bilanciamento del carico e il failover per il server Web PIA per i server del dominio dell'applicazione.
1. Modificare il file configuration.properties situato in $PS_CFG_HOME/webserv/HR92U033/applications/peoplesoft/PORTAL.war/WEB-INF/psftdocs/ps .
2. Modificare la riga che definisce psserver per aggiungere il secondo server del dominio dell'applicazione.
  Ad esempio, la nostra voce originale era:
```
psserver=iad-psft-hcm-app01.appprivatesu.ebscloudmaavcn.oraclevcn.com:9000
```
  Lo abbiamo modificato in:
```
psserver=iad-psft-hcm-app01.appprivatesu.ebscloudmaavcn.oraclevcn.com:9000,iad-psft-hcm-app02.appprivatesu.ebscloudmaavcn.oraclevcn.com:9000
```
Ripetere i passi da 1 a 5 come utente psadm2 sul secondo nodo, iad-psft-hcm-web02.