1. 啟用 PeopleSoft 的可觀測性與管理堆疊監督
  2. 部署處理入門

部署處理入門

部署 PeopleSoft 應用程式的可觀察性與管理堆疊監督需要三個主要步驟：

  1. 設定您所選版本 (標準版或企業版) 的授權，以及部署中使用的任何資源或區間。
  2. 尋找並升級部署中使用的資源。
  3. 使用 OCI 命令行介面 (CLI) 尋找新資源、建立堆疊監控資源之間的必要關聯，或重新整理整個拓樸。

設定授權

堆疊監控提供兩種版本：標準版和企業版。標準版會監控內部部署和雲端部署的應用程式和技術堆疊，包括 WebLogic、Tomcat、Oracle Database 和主機。Enterprise Edition 新增了度量擴充、效能基準、異常偵測及 OCI 資源整合等進階功能，以增強監控功能。

除了這兩個版本之外，授權還必須在個別資源層級或在區間層級進行設定，如下所述。

附註：

在任一層級指派執照的步驟超出此手冊的範圍。您可以從本手冊其他地方的「瀏覽其他」存取每個指派層次所需的相關程序 (在下方的特定區段中識別)。

設定區間特定功能的授權

您可以為區間中發現或升級的所有資源，將資源授權自動指定給「企業」或「標準」。設定授權自動指定是自動指定授權的便利方式，而非根據每個資源執行處理套用授權。此外，您可以啟用或停用整個區間的企業擴充性。

Oracle Cloud Infrastructure 文件中的 "Licensing Assignment" 章節說明設定區特定功能的授權程序，該文件可從「探索更多」存取。

設定資源特定功能的授權

資源授權指定可在尋找期間或在尋找後使用授權 UI 完成。套用至複合項目的授權變更會套用至所有子項；亦即，將 Enterprise Edition 授權套用至 WebLogic 網域時，與該網域關聯的所有 WebLogic 伺服器也會收到 Enterprise Edition。

在尋找期間，您可以選取對應的圓鈕，將授權指定給資源。您也可以在使用授權 UI 找到資源之後修改資源授權。這些程序詳述於 Oracle Cloud Infrastructure 文件中的 "Licensing Assignment"，您可從 "Explore More" 存取這些文件。

探索並推廣 PeopleSoft 資源

若要使用堆疊監控來監控資源，您必須先尋找並推廣這些資源。促銷會預先植入與資源相關的資訊。您應驗證此資訊以確定其正確無誤。升級的先決條件和輸入參數與使用者起始尋找的參數相同。

PeopleSoft 尋找涉及三個必要的資源系列：應用程式伺服器網域、程序排程器網域，以及具有其基礎 Weblogic 網域的 PeopleSoft Internet Architecture (PIA)。每個資源系列都可能包含一或多個資源，這些資源可以跨數個伺服器。

若要尋找並升級 PeopleSoft 應用程式的資源，您必須執行下列動作：
  • 尋找 PeopleSoft 資料庫。
  • 建立 PeopleSoft 監督的資料庫授權權限。
  • 啟用純網際網路架構 (PIA) 的 PeopleSoft Performance Monitor。
  • 符合應用程式伺服器和處理作業排程器網域的先決條件。
  • 指定要尋找的網域。
  • 手動新增網域。
  • 啟用 Elasticsearch 尋找。
  • 啟用處理作業監督器尋找。

附註：

尋找和推廣資源的步驟超出此手冊的範圍。您可以從本手冊其他地方的「瀏覽其他」存取每個指派層次所需的相關程序 (在下方的特定區段中識別)。

尋找 PeopleSoft 資料庫

在尋找 PeopleSoft 應用程式之前，您必須先尋找包含 PeopleSoft 綱要的 Oracle Database。

先尋找資料庫後，在 PeopleSoft 資源尋找完成後，它就會自動與 PeopleSoft 應用程式建立關聯。如果您在找到資料庫之前執行 PeopleSoft 應用程式尋找，則必須手動建立關聯。如需詳細資訊，請參閱 應用程式拓樸 。若要探索 Oracle 資料庫，請參閱您可以從本手冊其他位置的「探索更多」存取的「Oracle Database」。

建立 PeopleSoft 監督的資料庫授權權限

若要監督 PeopleSoft，您需要特定權限才能存取 PeopleSoft 資料庫綱要。設定會因作為 PeopleSoft 資料存放區的資料庫類型 (非容器資料庫與容器資料庫和可插式資料庫) 而有所不同。

尋找 PeopleSoft 堆疊監督時，您可以使用 PeopleSoft 綱要擁有者 (通常是 SYSADM) 作為資料庫證明資料。您應該建立一個只有監督 PeopleSoft 應用程式所需之權限的監督使用者。使用相同的資料庫使用者來監督包含 PeopleSoft 綱要和 PeopleSoft 應用程式的 Oracle 資料庫。

如果要建立資料庫監督使用者，請參閱 MOS 注意事項：2857604.1。如需進一步資訊，另請參閱 OCI 文件中的 "DB Grant Privileges for PeopleSoft Monitoring"。您可以從本手冊其他地方的「瀏覽更多」存取這兩份文件。

啟用純網際網路架構 (PIA) 的 PeopleSoft Performance Monitor

此為選擇性程序，僅適用於 PeopleSoft 尋找與重新整理；不過，對於定期監督與測量結果收集，則不需要 PeopleSoft Performance Monitor 代理程式。如果您選擇因任何原因而不要啟用 PPM 代理程式，請使用下列其中一種替代方法：
  • 啟用 PPM 代理程式，直到尋找或重新整理完成為止，然後將它停用並重新啟動網域。
  • 手動 INSERT/DELETE 所有 PeopleSoft 網域資訊。這樣就不需要啟用啟用 PPM 代理程式。
如果您需要啟用 PIA 的 PPM，請執行下列作業：
  1. 瀏覽至 PeopleTools，移至 Web 設定檔，按一下 Web 設定檔組態，然後搜尋使用中的設定檔；例如，PROD。
  2. 如果尚未核取，請選取啟用 PPM 代理程式。
  3. 重新啟動所有 PIA 網域。

符合應用程式伺服器和處理程序排程程式網域的先決條件

接下來，您需要符合每個應用程式伺服器和處理程序排程程式網域的必備條件。PeopleSoft 尋找會假設 JMX 存取的遠端管理使用者 ID/ 密碼與所有應用程式伺服器網域以及所有處理排程器網域相同。

您需要完成的先決條件如下：
  • 啟用 PeopleSoft Performance Monitor 代理程式。
  • 啟用 JMX 代理程式。
  • 啟用 Performance Collator 特性。

下列主題提供完成這些任務的高階步驟。如需詳細程序，請參閱 Stack Monitoring OCI 文件中的 "Prerequisites for Application Server and Process Scheduler Domains"，您可以從本手冊其他地方的 "Explore More" 存取。

啟用 PeopleSoft Performance Monitor 代理程式

若要啟用 PeopleSoft Performance Monitor 代理程式，請執行下列動作：

  1. 以編輯模式開啟網域組態檔。從 PSADMIN 命令行介面中，依序選取應用程式伺服器 (選項 1) 或處理作業排程器 (選項 2) 、管理網域 (選項 1) 、選取網域，然後選取編輯組態 / 日誌檔功能表 (選項 6) ，再選取編輯網域組態檔 (選項 1) 。
  2. 在 PSTOOLS 區段下，檢查 EnablePPM 代理程式的值。
  3. 啟用「PPM 代理程式」，將值設為 1，然後儲存檔案。
啟用 JMX 代理程式

此先決條件可讓「堆疊監督」收集 PeopleSoft 應用程式的使用狀態和效能資料。以下是高階步驟：

  1. 從 PSADMIN 命令行介面以編輯模式開啟網域組態檔。依序選取應用程式伺服器 (選項 1) 或處理作業排程器 (選項 2) 、管理網域 (選項 1) 、選取網域、編輯組態 / 日誌檔功能表 (選項 6) ，然後選取編輯網域組態檔 (選項 1) 。
  2. 尋找 PSTOOLS 區段的設定並執行下列作業：
    1. 確定主機上的任何其他處理作業未使用您想要使用的「遠端管理連接埠」。
    2. 以文字格式設定使用者 ID。對所有應用程式伺服器網域和處理程序排程程式網域使用相同的使用者 ID 與密碼。
    3. 使用 PSCipher 公用程式來加密密碼。
    4. 設定「效能協調器特性」變更之後 (如下列主題所述)，請重新啟動應用程式伺服器和處理排程器網域。
  3. 設定遠端管理連接埠和 RMI 連接埠值。
    • 如果您使用 PeopleSoft 版本 8.59 和更舊版本，則只需設定「遠端管理連接埠」。RMI 連接埠值會自動設定，將「遠端管理連接埠」值增加 1。
    • 對於 PSFT 8.60 版起，RMI 連接埠是由組態檔中的一個額外參數所控制。確定值已明確設定。設定 Performance Collator 特性之後，請重新啟動應用程式伺服器與處理程序排程程式網域。
  4. 確定您儲存的設定值在組態檔中正確顯示。
如需更詳細的指示，請參閱 OCI 文件中的 "Enable JMX Agents"，您可以從本手冊其他地方的 "Explore More" 存取此文件。
啟用 Performance Collator 特性

啟用 Performance Collator 特性之前，請先檢查網域範本檔案 psprcsrv.ubx (程序排程器) 中的 Performance Collator 目前值，以及位於 $PS_CFG_HOME 下的 psappsrv.ubx (應用程式伺服器)。

如果已啟用「績效協調員」，您會看到此項目： 
{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [y]:
如果「績效協調者」已停用，您會看到此項目： 
{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [n]:
如果「效能協調器」已經啟用，且變更已實行至 EnablePPM 代理程式或 JMX 值，您可以重新啟動所有網域。如果尚未啟用「績效協調員」，請執行下列作業：
  1. 從 PSADMIN 命令行介面中，依序選取 Application Server (Option 1) 或 Process Scheduler (Option 2)、Administer a domain (Option 1)、select domain 及 Configure this domain (Option 4) 。
  2. 輸入問題 Do you want to continue (y/n) 的 y 。此選項將關閉網域。
  3. 檢查「效能協調器」特性的值。
    • 如果值設為「是」，則「整合者」已啟用且不需要任何動作。 
      Load config as shown
      您可以選取「應用程式伺服器」的「選項 14」，或選取「處理程序排程程式」的「選項 7」。
    • 如果您將值設為「否」，請為「應用程式伺服器」輸入「選項 10」，或為「處理程序排程程式」輸入「選項 3」以切換值為「是」。
  4. 確認「績效協調器」設為「是」後，請選取 Load config as shown (應用程式排程器的選項 14，或「處理排程器」的選項 7)。
  5. 最後，選取 Boot this domain Option 1 以啟動網域。

識別要尋找的網域

堆疊監控會利用 Oracle Database 中儲存的資訊，識別要尋找或重新整理的網域。

若要驗證目前網域清單，請使用此查詢：
SELECT * FROM PSPMAGENT;
尋找或重新整理 PeopleSoft 應用程式之前，您應該先移除查詢所傳回且不再存在的任何網域。

附註：

如果您需要新增未列出的網域，請參閱下列主題：「手動新增網域」。
若要移除過時的網域，請以 SYSADM 或同等使用者身分登入，然後執行下列 SQL 查詢。重複查詢，直到移除所有過時的網域為止。請注意：
  • 進行變更之前，請先備份 PSPMAGENT 表格。 
    create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;

    其中 DATE 具有目前時戳

  • 確認您建立的備份表格內容與父項表格相同。 
    select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
如果 PSPMAGENT 的資料列數目與 PSPMAGENT_BKP_DATE 相符，請繼續移除過時的網域： 
delete from PSPMAGENT WHERE PM_AGENTID='&enter_agent_id_of_stale_domain'; 
Commit;

手動新增網域

接著，檢查 PSPMAGENT 表格中是否顯示所有有效網域。如果未顯示任何有效網域，請使用下列主題中的查詢。代理程式主機應該可以使用儲存在 PSPMAGENT 表格中之 PM_HOST_PORT 資料欄中的主機名稱，連線到所有其他主機。

您需要手動新增的網域為：
  • Process Scheduler 網域
  • Application Server 網域
  • PIA 伺服器
繼續之前，請先執行下列作業來備份 PSPMAGENT 表格：
  1. 進行變更之前，請以系統管理員或同等使用者的身分登入並備份表格： 
    create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;
    其中 DATE 是目前的時間戳記。
  2. 確認您建立的備份表格內容與父項表格相同。PSPMAGENT 的資料列計數應該與 PSPMAGENT_BKP_DATE 的資料列計數相符：
    select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
    其中 DATE 是目前的時間戳記。
請使用下列指令來新增網域：
  • Process Scheduler 網域
    INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');
  • 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');
  • 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');

啟用 Elasticsearch 尋找

Elasticsearch 尋找是選擇性的。如果 Elasticsearch 已經整合，您就可以在初始尋找中包含它。若要日後整合 Elasticsearch，請使用 PeopleSoft CLI refresh 命令，然後將 Elasticsearch 資料庫授權新增至監督使用者。如需有關授權的詳細資訊，請參閱上方「建立 PeopleSoft 監督的資料庫授權權限」，如需有關 CLI 重新整理命令的詳細資訊，請參閱此手冊中其他位置的「重新整理 PeopleSoft 執行處理」。
完成這些先決條件後，將會在 PeopleSoft 中啟用 Elasticsearch 整合：
  • 堆疊監控只支援使用 SSL 設定的監控 Elasticsearch。其端點必須是 HTTPS。如需有關 Elasticsearch 設定的詳細資訊，請參閱本手冊其他位置的 "Configuring SSL between PeopleSoft and Elasticsearch" (可從 "Explore More" 存取)。
  • 尋找 Elasticsearch 之前，請先在監督代理程式主機上建立 JKS 信任存放區 (JKS 是唯一支援的信任存放區)，以儲存 Elasticsearch 的憑證。透過 CLI 嘗試尋找時，此信任存放區的位置和密碼是尋找 UI 或尋找 JSON 中的必要參數。此外，信任存放區位置必須在代理程式主機上存取。
    舉例而言： 
    keytool -keystore truststore.jks -alias ALIAS -import -file ELASTICSEARCH_CERTIFICATE

啟用處理作業監督器尋找

「處理作業監督器」會與 PeopleSoft 一起發現，在尋找 PeopleSoft 應用程式時預設為啟用。在「探查程序監視器」區段下選取「否」，會將「程序監視器」從 PeopleSoft 尋找排除。

處理作業監督器尋找是選擇性的。如果「程序監視器」已啟用，則您可以在初始尋找中包含它。若要日後整合「程序監視器」，請使用 PeopleSoft CLI refresh 命令，然後將「程序監視器資料庫」授權新增至監視使用者。如需有關授權的詳細資訊，請參閱上方「建立 PeopleSoft 監督的資料庫授權權限」，如需有關 CLI 重新整理命令的詳細資訊，請參閱此手冊中其他位置的「重新整理 PeopleSoft 執行處理」。

「處理作業監督器」尋找不需要任何特性。

預設包括「程序監督器」尋找。若要選擇退出，請在在資源中尋找處理監視器尋找面板上選取否。

如需詳細資訊，請參閱本手冊其他位置的 "Enable Process Monitor discovery for PeopleSoft"，您可以從 "Explore More" 存取。

更新應用程式拓樸

您可以使用 OCI CLI 尋找新資源、建立堆疊監控資源之間的必要關聯，或重新整理整個拓樸。特別是，您可以使用 CLI 建立資料庫與 PeopleSoft 之間的關聯。

對於 PeopleSoft，更新應用程式拓樸需要下列工作：
  • 管理 PeopleSoft 網域。
  • 重新整理 PeopleSoft 執行處理。

管理 PeopleSoft 網域

堆疊監控會利用 PSPMAGENT 表格中包含的網域資訊進行尋找。如果遺漏您的 PeopleSoft 網域，您可以依照本手冊其他位置的「手動新增網域」中所述的步驟，手動建立必要的網域資訊。

重新整理 PeopleSoft 執行處理

PeopleSoft 會重新整理下列「堆疊監督」資源類型的應用程式重新整理：

oracle_psft
oracle_psft_appserv
oracle_psft_prcs
oracle_psft_pia
weblogic_domain (including members)

重新整理將不會驗證在重新整理處理作業期間找到之新網域的證明資料。如果在尋找處理作業期間發現任何失敗的網域，這些網域可能是過時的網域，可能無法從代理程式的 JMX 連線或基於其他原因而存取它們。解決問題之後，請透過代理程式主機的 JMX 連線驗證，然後執行重新整理作業，確定要新增之每個新網域的通用證明資料均有效。重新整理成功之後，就會新增網域。這些網域使用設定先前發現之網域的相同通用證明資料。

重新整理也會重新整理現有的關聯 WebLogic 網域及其成員。

新增 PIA 執行處理時，執行 PeopleSoft 重新整理將會尋找新增的 PIA 資源，但不會尋找基礎的新 WebLogic 網域。您必須使用 CLI 手動尋找 WebLogic 網域，才能將該新 WebLogic 網域與新發現的 PIA 建立關聯。

您可以從 UI 或使用 CLI 重新整理 PeopleSoft 執行處理。
  • 若要從 UI 重新整理，請從資源的首頁按一下資源名稱下方的重新整理。在確認訊息中，按一下確定，即可在新頁籤中開啟「資源尋找」面板。您可以在此處追蹤已送出重新整理工作的狀態。
  • 若要使用 CLI 重新整理，您必須執行 discovery-job create。此選項包含 JSON 檔案。若要允許在重新整理作業期間刪除資源，您必須新增 allow_delete_resources 特性至有效負載，以及 resource_id property 和監督代理程式 ID 特性。resource_id 是需要重新整理之 PeopleSoft 資源的 ID。
    若要使用 CLI 重新整理 PeopleSoft 執行處理，請使用此命令：
    oci stack-monitoring discovery-job create --compartment-id "Compartment_OCID" --discovery-type REFRESH --discovery-details file:///tmp/psft_refresh_dev.json

如需有關重新整理 PeopleSoft 執行處理的詳細資訊，請參閱 OCI 文件中的 "PeopleSoft Refresh"，您可以從本手冊其他位置的 "Explore More" 存取此文件。