1. 为 PeopleSoft 启用可观察性和管理堆栈监视
  2. 开始部署过程

开始部署过程

为 PeopleSoft 应用程序部署观测和管理堆栈监视需要三个主要步骤：

  1. 为所选版本、标准版或企业版以及部署中使用的任何资源或区间配置许可。
  2. 搜索和提升部署中使用的资源。
  3. 使用 OCI 命令行界面 (command-line interface，CLI) 搜索新资源，在堆栈监视资源之间创建所需的关联，或者刷新整个拓扑。

配置许可

Stack Monitoring 提供两个版本：标准版和企业版。Standard Edition 可监视内部部署和云部署的应用和技术堆栈，包括 WebLogic、Tomcat、Oracle Database 和主机。Enterprise Edition 添加了度量扩展、性能基线、异常检测和 OCI 资源集成等高级功能，以实现增强监视。

除这两个版本外，还必须在单个资源级别或区间级别配置许可证，如下所述。

注意：

在任一级别分配许可证的步骤都超出了本手册的范围。您可以从本手册其他地方的“浏览更多”中访问下面特定部分中确定的每个分配级别所需的相关过程。

为区间特定功能配置许可

对于在区间中搜索到或提升的所有新资源，您可以将资源许可证自动分配设置为企业或标准。配置许可证自动分配是自动分配许可证而不是按资源实例应用许可证的便捷方式。此外，您可以为整个区间启用或禁用企业可扩展性。

Oracle Cloud Infrastructure 文档的 "Licensing Assignment" 中介绍了为特定于区间的功能配置许可的过程，您可以从 "Explore More" 访问该文档。

配置特定于资源的功能的许可

资源许可证分配可以在发现期间或在发现之后使用许可 UI 在单个资源级别完成。应用于组合的许可证更改将应用于所有子项；也就是说，将 Enterprise Edition 许可证应用于 WebLogic 域时，与该域关联的所有 WebLogic 服务器也将收到 Enterprise Edition。

在搜索过程中，您可以通过选择相应的单选按钮为资源分配许可证。您还可以在使用许可证 UI 搜索资源后修改资源许可证。Oracle Cloud Infrastructure 文档中的 "Licensing Assignment" 中介绍了这些过程，您可以从 "Explore More" 访问这些过程。

搜索和提升 PeopleSoft 的资源

要使用堆栈监视来监视资源，必须首先搜索和提升这些资源。促销预填充与资源相关的信息。您应验证此信息以确保其正确无误。提升的先决条件和输入参数与用户启动的搜索的先决条件和输入参数相同。

PeopleSoft 搜索涉及三个强制性资源系列：应用程序服务器域、进程调度器域和 PeopleSoft Internet 体系结构 (Internet Architecture，PIA) 以及其底层 Weblogic 域。每个资源系列可以包含一个或多个这些资源，这些资源可以跨多个服务器。

要搜索和提升 PeopleSoft 应用程序的资源，您需要执行以下操作：
  • 搜索 PeopleSoft 数据库。
  • 建立数据库授予权限以进行 PeopleSoft 监视。
  • 为纯 Internet 体系结构 (PIA) 启用 PeopleSoft Performance Monitor。
  • 满足应用服务器和进程调度程序域的先决条件。
  • 标识要搜索的域。
  • 手动添加域。
  • 启用 Elasticsearch 搜索。
  • 启用进程监视器搜索。

注意：

发现和推广资源的步骤超出了本手册的范围。您可以从本手册其他地方的“浏览更多”中访问下面特定部分中确定的每个分配级别所需的相关过程。

搜索 PeopleSoft 数据库

在搜索 PeopleSoft 应用程序之前，需要搜索包含 PeopleSoft 方案的 Oracle Database。

通过先搜索数据库，PeopleSoft 资源搜索完成后，该数据库将自动与 PeopleSoft 应用程序关联。如果在搜索数据库之前执行 PeopleSoft 应用程序搜索，则需要手动创建关联。有关更多信息，请参见应用程序拓扑。要搜索 Oracle 数据库，请参阅 "Oracle Database"，您可以从本手册其他位置的 "Explore More" 访问该数据库。

为 PeopleSoft 监视建立数据库授权权限

要监视 PeopleSoft，您需要具有访问 PeopleSoft 数据库方案的特定权限。设置因用作 PeopleSoft 数据存储的数据库类型（非容器数据库与容器数据库以及可插入数据库）而异。

搜索 PeopleSoft 堆栈监视时，可以使用 PeopleSoft 方案所有者（通常为 SYSADM）作为数据库身份证明。应创建一个仅具有监视 PeopleSoft 应用程序所需的权限的监视用户。使用同一数据库用户监视包含 PeopleSoft 方案和 PeopleSoft 应用程序的 Oracle 数据库。

要创建数据库监视用户，请参见 MOS 简讯：2857604.1。有关详细信息，另请参阅 OCI 文档中的 "DB Grant Privileges for PeopleSoft Monitoring"。您可以从本手册的其他地方的“探索更多”访问这两个文档。

为纯 Internet 体系结构 (PIA) 启用 PeopleSoft Performance Monitor

这是一个可选过程，仅 PeopleSoft 搜索和刷新需要此过程；但是，对于常规监视和度量收集，不需要 PeopleSoft Performance Monitor 代理。如果出于任何原因选择不启用 PPM 代理，请使用以下任一替代方案：
  • 启用 PPM 代理，直到搜索或刷新完成，然后将其禁用并重新启动域。
  • 手动插入/删除所有 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 Agent 的值。
  3. 启用 PPM 代理，将值设置为 1，然后保存文件。
启用 JMX 代理

使用此先决条件，堆栈监视可以收集 PeopleSoft 应用程序的可用性和性能数据。以下是大致步骤：

  1. 从 PSADMIN 命令行界面以编辑模式打开域配置文件。依次选择应用程序服务器（选项 1）或进程调度器（选项 2）、管理域（选项 1）、选择域、编辑配置文件/日志文件菜单（选项 6）和编辑域配置文件（选项 1）。
  2. 找到 PSTOOLS 部分的设置并执行以下操作：
    1. 确保主机上的任何其他进程都未使用您打算使用的远程管理端口。
    2. 以文本格式设置用户 ID。对所有应用服务器域和进程调度器域使用相同的用户 ID 和密码。
    3. 使用 PSCipher 实用程序对密码进行加密。
    4. 配置 Performance Collator 属性更改后（如以下主题中所述），重新启动应用服务器和进程调度器域。
  3. 设置远程管理端口和 RMI 端口值。
    • 如果您使用的是 PeopleSoft 版本 8.59 及更低版本，则只需设置远程管理端口。RMI 端口值通过将远程管理端口值增加一来自动设置。
    • 对于 PSFT 版本 8.60 及更高版本，RMI 端口由配置文件中的一个附加参数控制。确保显式设置该值。配置 Performance Collator 属性后，重新启动应用程序服务器和进程调度器域。
  4. 确保您保存的设置在配置文件中正确显示。
有关更详细的说明，请参阅 OCI 文档中的 "Enable JMX Agents"（启用 JMX 代理），您可以从本手册的其他位置的 "Explore More"（浏览更多内容）访问该文档。
启用性能转换器属性

启用 Performance Collator 属性之前，请检查域模板文件 psprcsrv.ubx (Process scheduler) 和 psappsrv.ubx (Application Server) 中位于 $PS_CFG_HOME 下的 Performance Collator 的当前值。

如果启用了性能转换器，您将看到以下条目： 
{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
      可以为 Application Server 选择选项 14，为 Process Scheduler 选择选项 7。
    • 如果将该值设置为“否”，则为“应用程序服务器”输入“选项 10”或为“进程调度器”输入“选项 3”，以将该值切换为“是”。
  4. 确认“Performance Collator（性能转换器）”设置为“Yes（是）”后，选择 Load config as shown（应用程序调度器的选项 14 或进程调度器的选项 7）。
  5. 最后，选择 Boot this domain Option 1 以启动域。

标识要搜索的域

堆栈监视利用存储在 Oracle Database 中的信息来确定要搜索或刷新的域。

要验证当前域的列表，请使用此查询：
SELECT * FROM PSPMAGENT;
在搜索或刷新 PeopleSoft 应用程序之前，应删除查询返回的任何不再存在的域。

注意：

如果需要添加未列出的域，请参见以下主题："Adding domain manual"（手动添加域）。
要删除过时的域，请以 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 列中的主机名访问所有其他主机。

您需要手动添加的域包括：
  • 进程调度程序域
  • 应用程序服务器域
  • 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 是当前时间戳。
使用以下命令添加域：
  • 进程调度程序域
    INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');
  • 应用程序服务器域
    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 的详细信息，请参阅“在 PeopleSoft 和 Elasticsearch 之间配置 SSL”，您可以从本手册中的其他位置的“浏览更多”访问该内容。
  • 在搜索 Elasticsearch 之前，在监视代理主机上创建一个 JKS 信任库（JKS 是唯一支持的信任库），以存储来自 Elasticsearch 的证书。在搜索 UI 或搜索 JSON 中尝试通过 CLI 进行搜索时，此信任库的位置和密码是必需的参数。此外，必须在代理主机上访问信任存储位置。
    例如： 
    keytool -keystore truststore.jks -alias ALIAS -import -file ELASTICSEARCH_CERTIFICATE

启用进程监视器搜索

进程监视器与 PeopleSoft 一起搜索，在搜索 PeopleSoft 应用程序时默认启用。在 "Discover Process Monitor"（搜索进程监视器）部分下选择 "No"（否）将从 PeopleSoft 搜索中排除进程监视器。

进程监视器搜索是可选的。如果进程监视器已启用，则可以将其包括在初始搜索中。要将来集成进程监视器，请使用 PeopleSoft CLI refresh 命令，并将进程监视器 DB 授权添加到监视用户。有关授权的更多信息，请参见上文中的“为 PeopleSoft 监视建立数据库授权”以及有关 CLI 刷新命令的更多信息，请参见本手册其他部分的“刷新 PeopleSoft 实例”。

进程监视器搜索不需要任何属性。

缺省情况下包括进程监视器搜索。要退出，请在在资源中搜索进程监视器搜索面板上选择否。

有关详细信息，请参阅“为 PeopleSoft 启用进程监视器搜索”，您可以从本手册其他位置的“浏览更多”访问该功能。

更新应用程序拓扑

您可以使用 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" 访问该文档。