1. 在 Oracle Cloud 上佈建及部署 PeopleSoft 的最大可用性解決方案
  2. 設定 PeopleSoft

設定 PeopleSoft

您必須存取資料庫，才能完成待命資料庫中層伺服器的檔案系統組態。

將第一個備用資料庫轉換成快照備用

讓應用程式升級，以完成待命環境的組態設定。若要這麼做，您必須暫時以讀寫模式存取資料庫，而資料庫從主要資料庫套用 redo 時無法進行。當您將 Dedicated Infrastructure 上的 Exadata Database Service 上的 OCI 資料庫從實體待命資料庫轉換為快照待命資料庫時，主要資料庫的 redo 會運送至待命資料庫，但要等到資料庫回復至實體待命資料庫後才會套用。
  1. 使用 SSH 登入其中一個 Oracle Exadata Database Service on Dedicated Infrastructure 資料庫節點 (domU)。
  2. 成為 oracle 使用者。
    $ sudo su – oracle
  3. 來源待命資料庫環境。
    此環境是在建立預留位置資料庫以準備使用 Oracle Zero Downtime Migration 時建立。 
    $ . ./CDBHCM.env
  4. 啟動 Oracle Data Guard 中介並輸入 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>
  5. 顯示資料保全組態，包括重做和套用延遲時間。
    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)
  6. 如果沒有錯誤且上述顯示為 "SUCCESS"，請將待命資料庫轉換成快照待命資料庫。
    DGMGRL> convert database CDBHCM_iad1dx to snapshot standby
Converting database "CDBHCM_iad1dx" to a Snapshot Standby database, please wait...
Database "CDBHCM_iad1dx" converted successfully
  7. 再次顯示組態，以查看實體待命資料庫現在是快照待命資料庫。
    您可能會看見指出傳輸延遲已超過臨界值的警告。此警告將在數分鐘後消失。 
    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)
  8. 確認 PeopleSoft 所需的服務已經啟動。
    在此範例中，服務為：HR92U033_BATCH 和 HR92U033_ONLINE。Oracle Zero Downtime Migration 已從來源 (內部部署) 資料庫移轉這些服務，並將其註冊到 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
  9. 如果尚未啟動必要的服務，請啟動它們。
    $ srvctl start service -db CDBHCM_iad1dx -s HR92U033_BATCH
$ srvctl start service -db CDBHCM_iad1dx -s HR92U033_ONLINE
快照待命已可供您設定應用程式與處理排程器。

建立 PeopleSoft 資料庫連線

編輯 tnsnames.ora 檔案以建立連線。

  1. 登入其中一個 OCI 運算執行處理，並建立 psft.env 檔案的來源。然後移至 $TNS_ADMIN 目錄：
    $ cd $TNS_ADMIN
  2. 編輯 tnsnames.ora 檔案，將 HOST 值變更為應用程式伺服器和處理作業排程器網域之資料庫連線字串中的叢集 SCAN 名稱。

    附註：

    PeopleTools 使用 TNS 連線別名作為 DBNames。確定 TNS 別名名稱與 PS.PSDBOWNER 表格中的 DBNAME 資料欄相符。

    例如，以下是範例 PSDBOWNER 表格中的項目： 

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

    下列是範例 tnsnames.ora 檔案中的項目： 

    # 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)
       )
    )
  3. 若要測試此組態，請確定 Oracle Zero Downtime Migration 所移轉的資料庫服務已啟動並在執行中。
    在範例組態中，它們是 HR92U033_ONLINE 和 HR92U033_BATCH。
  4. 以 psadm2 作業系統使用者身分登入，並使用 SQL*Plus 測試第一個 TNS 連線字串別名。
    $ 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>
  5. 以類似的方式測試 HRBATCH 連線字串別名，以確保它順利連線至資料庫。
  6. 對代管應用程式和處理作業排程器的所有運算執行處理執行這些測試。

設定 PeopleSoft 應用程式網域

部署應用程式伺服器網域並設定運算執行處理，以代管應用程式伺服器。

在此案例中，應用程式伺服器網域為 HR92U033，四個運算執行處理中的兩個執行處理將同時代管應用程式伺服器和處理作業排程器：iad-psft-hcm-app01 和 iad-psft-hcm-app02。每次在自己的 Oracle Tuxedo 網域內執行應用程式伺服器和處理作業排程器。

身為 psadm2 使用者，您將使用 psadmin 公用程式來設定 Oracle Tuxedo 網域，包括應用程式伺服器。

在 $PS_CFG_HOME/appserv/Application server domain 目錄中尋找 psappsrv.cfg 檔案。請先使用 psadmin 公用程式對此檔案進行任何必要的組態變更 ($PS_HOME/bin/psadmin)，再在每個節點上建置網域。

  1. 以 psadm2 使用者身分在第一個節點 (iad-psft-hcm-app01) 上啟動 psadmin 公用程式。
    cd $PS_HOME/bin ./psadmin
    當 psadmin 公用程式啟動時，會顯示 PS_HOME、PS_CFG_HOME 和 PS_APP_HOME 的目錄路徑。請確定它們是正確的。
    例如， 
    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
  2. 選取選項 1：應用程式網域以設定應用程式伺服器網域。
  3. 選取選項 1：管理網域。在我們的案例中選擇網域名稱 HR92U033。
  4. 選取選項 4：設定此網域。輸入 Y 以關閉網域。
  5. 複查顯示的組態選項和設定值。
    • 請確定 DBName 的 TNS 連線字串別名正確無誤。在我們的案例中，它是 HR92U033。
    • 對應用程式網域伺服器使用的連接埠進行任何調整。
    • 請特別注意 JOLT 連接埠範圍 – PeopleSoft Internet Architecture (PIA) Web 伺服器用來連線至應用程式伺服器的連接埠。您會在稍後的步驟中使用這些值。預設為 9000 – 9010。
  6. 選取選項 14：載入網域 (如圖所示) 。
    系統會載入網域組態，並重新產生 Oracle Tuxedo 的所有必要網域檔案。
  7. 選取「網域管理」底下的「選項 1：啟動此網域」，以啟動此網域。
    監督啟動處理作業。如果報告錯誤，請檢查記錄檔。$PS_CFG_HOME/appserv/domain name/LOGS
  8. 重複步驟 1-7 作為第二個節點 iad-psft-hcm-app02 上的 psadm2 使用者。

設定處理排程器網域

PeopleSoft 處理排程器 (或批次伺服器) 的設定方式與應用程式伺服器大致相同，加上處理排程器日誌的組態。身為使用者 psadm2，您將為每個處理排程器節點建立一個目錄：

  • /u02/app/psft/ps/log_output/node1/HR92U033 (節點：iad-psft-hcm-app01)
  • /u02/app/psft/ps/log_output/node2/HR92U033 (節點：iad-psft-hcm-app02)

您可以從任何一個中間層運算執行處理執行此操作。有了日誌輸出目錄，執行下列動作以設定程序排程器：

  1. 以 psadm2 使用者身分在第一個節點 (iad-psft-hcm-app01) 上啟動 psadmin 公用程式。
    cd $PS_HOME/bin ./psadmin
    當 psadmin 公用程式啟動時，會顯示 PS_HOME、PS_CFG_HOME 和 PS_APP_HOME 的目錄路徑。請確定它們是正確的。
    例如， 
    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
  2. 選取選項 2：處理排程器。
  3. 選取選項 1：管理網域。在我們的案例中選擇網域名稱 HR92U033。
  4. 選取選項 4：設定此網域。輸入 Y 以關閉網域。
  5. 複查顯示的組態選項和設定值。
    請確定 DBName 的 TNS 連線字串別名正確無誤。在我們的案例中，它是 HRBATCH。
  6. 選取選項 16：日誌 / 輸出，並提供您剛才建立的目錄路徑。

    例如，

    • /u02/app/psft/ps/log_output/node1/HR92U033 (節點：iad-psft-hcm-app01)
    • /u02/app/psft/ps/log_output/node2/HR92U033 (節點：iad-psft-hcm-app02)
  7. 選取選項 6：載入網域 (如圖所示) 。
    系統會載入網域組態，並重新產生 Oracle Tuxedo 的所有必要網域檔案。
  8. 選取「網域管理」底下的「選項 1：啟動此網域」，以啟動此網域。
    監督啟動處理作業。如果報告錯誤，請檢查記錄檔。$PS_CFG_HOME/appserv/prcs/domain name/LOGS
  9. 重複步驟 1-8 作為第二個節點 iad-psft-hcm-app02 上的 psadm2 使用者。
  10. 開啟所有應用程式伺服器和處理作業排程器運算執行處理上的 JOLT 連接埠。
    這是使用以 root 身分執行的 firewall-cmd 命令來完成。下列是您需要針對環境修改的範例： 
    # 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
  11. 在 Oracle Tuxedo 網域啟動時監督應用程式和處理作業排程器資料庫連線。您可以 oracle OS 使用者身分登入其中一個 Oracle Exadata Database Service on Dedicated Infrastructure Oracle Real Application Clusters (Oracle RAC) 執行處理，以執行下列查詢進行監督：
    $ 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;

    以下是範例輸出：

    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
輸出顯示每個 Oracle RAC 執行處理上每個服務的連線數目。處理作業應該分散到資料庫伺服器。

設定 PeopleSoft PIA Web 伺服器網域

使用 PeopleSoft Internet Architecture (PIA) setup.sh 命令檔來設定 PIA Web 伺服器網域。

以代管 PIA Web 伺服器之每個運算執行處理 VM 上的 psadm2 使用者身分執行下列步驟：

  1. 以 psadm2 使用者身分在第一個節點 (iad-psft-hcm-web01) 來源環境。
    $ . ./psft.env
    確定已定義 PS_CFG_HOME。在此範例中，它設為 /peoplesoft/local/ps_config。如果不是，請確定您的 .bash_profile 會呼叫 psft.env 檔案。
  2. 將範本回應檔案複製到 PS_CFG_HOME 目錄以進行自訂。
    $ cd $PS_HOME/setup/PsMpPIAInstall
$ cp resp_file.txt $PS_CFG_HOME/iad_oci_pia_resp.txt
  3. 編輯您環境的 iad_oci_pia_resp.txt 檔案。

    下列範例包含必須變更之 10 個項目的註標粗體字型。

    # 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
  4. 執行 setup.sh 命令檔來設定 PIA，指向您的新回應檔。 
    $ ./setup.sh -i silent -DRES_FILE_PATH=$PS_CFG_HOME/iad_oci_pia_resp.txt
  5. 啟用 PIA Web 伺服器至應用程式網域伺服器的負載平衡與容錯移轉。：
    1. 編輯位於 $PS_CFG_HOME/webserv/HR92U033/applications/peoplesoft/PORTAL.war/WEB-INF/psftdocs/ps 中的 configuration.properties 檔案。
    2. 修改定義 psserver 的行，以新增第二個應用程式網域伺服器。
      例如，我們的原始項目為：
      psserver=iad-psft-hcm-app01.appprivatesu.ebscloudmaavcn.oraclevcn.com:9000
      我們將它編輯到：
      psserver=iad-psft-hcm-app01.appprivatesu.ebscloudmaavcn.oraclevcn.com:9000,iad-psft-hcm-app02.appprivatesu.ebscloudmaavcn.oraclevcn.com:9000
  6. 重複步驟 1-5 作為第二個節點 iad-psft-hcm-web02 上的 psadm2 使用者。