配置技巧和解决方案

有关安装问题的帮助，请参阅“安装技巧和故障排除”。

提示：

如果您的配置过程被先决条件检查阻止，并且您认为您已了解警告的内容并可以在此情况下继续配置，则可以忽略先决条件检查并尝试使用 -ignoreChecks 选项运行 EPM System Configurator 来继续操作。

EPM System Configurator 无法启动

问题：

仅安装和配置了 Oracle HTTP Server (OHS) 时，在安装程​​序升级后 EPM System Configurator 无法启动。此问题在安装程序 11.2.8 和 11.2.15 等版本中很常见。

解决方案：

  1. 在现有的 11.2.x 环境中启动 Launch 11.2.x 安装程序。
    1. 选择新安装并转到下一个面板。
    2. 在“产品选择”面板中，仅选择 Foundation 组件。
    3. 单击下一步以开始安装。
    4. 安装完成后，单击完成。

      注：

      最终安装阶段可能需要较长时间，请不要单击取消。
  2. 再次启动 11.2.X 安装程序。选择重新安装并单击下一步继续安装。
  3. 启动 EPM System Configurator 并选择配置 Web 服务器。

分布式环境中的配置失败

问题：

为分布式环境中的 Web 应用程序执行部署到应用程序服务器任务失败。

必须在分布式环境中的每台计算机上运行 RCU 并编辑 RCUSchema.properties。运行 RCU 时，每台计算机都需要唯一的前缀。如果此步骤执行得不正确，则配置将失败。

解决方案：

如果由于 RCUSchema.properties 中存在错误条目而导致配置失败，请执行下面的步骤以便确保成功进行配置：

  1. 取消并退出 EPM System Configurator。
  2. 更正 RCUSchema.properties 中的条目并确保所有值正确无误。该环境中每台计算机上的前缀必须唯一。

    在 JDBC URL 中使用 SID，而非服务名称。

  3. 删除所有数据库用户，包括使用 RCU 创建的用户（使用 RCU 删除架构选项）和用于 Oracle Enterprise Performance Management System 配置的数据库用户。
  4. 创建新的数据库用户：
    • 再次运行 RCU 并为该环境中的每台计算机提供唯一的前缀。
    • 为 EPM System 配置创建数据库用户
  5. 重命名 user_projects 文件夹，例如 user_projects_old。默认情况下，该位置为 C:\Oracle\Middleware\user_projects。
  6. 重新运行 EPM System Configurator 并完成所需的任务。

    因为您重命名了 user_projects 文件夹，所以您执行的是新配置，而不是重新配置。

  7. 删除 user_projects_old 文件夹。

在无 SYSDBA 权限的情况下在 Oracle 数据库上创建 RCU 架构

必须创建 RCU 架构才能配置 EPM System。如果您没有 SYSDBA 权限，请使用以下过程：

  1. 以具有 sys 或 sysdba 权限的数据库用户身份登录 SQL Plus，并完成以下步骤：
    1. Create user testrcu IDENTIFIED BY password（例如，以名为 testrcu 的用户身份）。

    2. Privileges testrcu

      Create Session

      Select Any Dictionary

      Select_catalog_Role

    3. 向用户授予以下权限： 
      grant select_catalog_role to testrcu;
grant select any dictionary to testrcu;
grant create session to testrcu;
grant select on schema_version_registry to testrcu;

    注：

    如果在执行最后一个命令时遇到表或视图不存在错误消息，可以忽略它。

  2. 导航到 ORACLE_HOME/oracle_common/bin 并启动 RCU：

    • Windows：例如：C:\Oracle\Middleware\oracle_common\bin\rcu.bat

    • Linux/Unix：./rcu

  3. 选择准备用于系统加载的脚本。（请勿选择系统加载和产品加载）。

  4. 一定会生成两个脚本，默认情况下，这些脚本位于 ORACLE_HOME/oracle_common/rcu/log/logdir.[date_timestamp] 中。

    • script_systemLoad.sql

    • script_postDataLoad.sql

  5. 以具有 sys 或 sysdba 权限的数据库用户身份登录 SQL Plus 并完成以下步骤，或者将这些脚本提供给 DBA 来运行：

    1. 执行 script_systemLoad.sql 脚本。
    2. 在执行产品加载阶段之前，必须为用户（在本示例中为 testrcu）授予以下权限：
      • grant REGISTRYACCESS to testrcu;
      • grant STBROLE to testrcu;
  6. 再次启动 RCU，并以非 DBA 用户身份选择执行产品加载来完成数据加载。

  7. 以具有 sys 或 sysdba 权限的用户身份登录 SQL Plus，执行 script_postDataLoad.sql 脚本以完成产品加载阶段，或者将脚本提供给 DBA 来运行。

  8. 更新 RCUschema.properties 文件，例如： 
    sysDBAPassword=<password created in step one>
schemaPrefix=testrcu1
rcuSchemaPassword=<you are prompted for schema password in the script>
dbURL=jdbc:oracle:thin:@dbserver:1521:ORCL
sysDBAUser=testrcu <user you created in step one>

分布式环境

在分布式环境中，在任何一台计算机上完成 EPM System 产品的配置后，需要关闭 EPM System Configurator，然后再开始配置其他计算机。

Java 堆大小更改

在 Windows 环境中使用服务启动和停止 Java Web 应用程序服务器时，可以更改 Java 堆大小。您可以在批处理文件或 Windows 注册表中进行更改。对产品进行更改后，必须重新启动 Java Web 应用程序服务器。有关详细信息，请参阅《Oracle Enterprise Performance Management System 部署选项指南》。

产品数据库

Oracle 建议将每个 EPM System 产品放在其自己的数据库架构中，以便灵活地备份和恢复数据库。在原型和开发环境中，令人满意的做法可能是为所有产品配置一个数据库。

EPM System Configurator 启动

问题：成功安装和配置 EPM System 后，无法从 Windows 的“开始”菜单启动 EPM System Configurator，并出现以下消息：

致命错误: 环境变量检查失败，出现“环境变量设置不正确”消息

解决方案：重新启动计算机。

Oracle HTTP Server 配置

问题：在为 SSL 配置 Oracle HTTP Server 的同时尝试打开导出的 ewallet.p12 文件时，即使输入的密码正确无误，仍然出现以下错误消息：

密码不正确。请重试。

解决方案：无法打开 wallet 是由于 Oracle Wallet Manager 存在缺陷。Oracle Wallet Manager 11g 无法读取从 OpenSSL 等第三方工具创建的 PKCS12 密钥库。在此问题得到解决之前，请使用 Oracle 10g Client 随附的 Oracle Wallet Manager 读取新的 ewallet.p12 文件，并对其进行保存以便用于 Oracle HTTP Server 11gR1。

多个 Java Web 应用程序部署出现内存不足错误

问题：部署多个 Java Web 应用程序时，部署过程中会显示一条内存不足消息。

解决方案：

增加 Oracle WebLogic Server 管理服务器中的默认内存设置。

首次配置 Shared Services 数据库

问题：运行 EPM System Configurator 进行首次配置时，执行第一次 Shared Services 数据库配置选项不可用。

解决方案：要在这种情况下配置 EPM System：

  1. 使用 –forceRegistry 选项从命令行启动 EPM System Configurator。

  2. 配置 Oracle Hyperion Foundation Services：

    依次选择 Foundation Services 任务公共设置、配置数据库和部署到应用程序服务器。

  3. 退出 EPM System Configurator。

  4. 以常规方式重新启动 EPM System Configurator，以配置其余 EPM System 产品。

连接到群集 SQL Server 部署

问题：需要配置 EPM System 才能连接到群集 SQL Server 部署。

解决方案：在 EPM System Configurator 的配置数据库屏幕的服务器字段中，输入 SQL Server 群集的虚拟主机。

缺少 JAR 文件

问题：安装多个 EPM System 产品后启动 EPM System Configurator 时，生成有关缺少 JAR 文件的错误，并且 EPM System Configurator 在大约 30 秒内关闭。

解决方案：出现缺少 JAR 文件的错误消息表示安装不完整。请检查以下消息。

如果您看到有关缺少 JAR 文件的错误消息或与 oracle_common jars 有关的错误，则表示 WebLogic Server 安装不完整。

查看 MIDDLEWARE_HOME 的 ohs 和 oracle_common 子文件夹。如果 ohs 仅包含一个或两个子文件夹，或者如果 oracle_common 为空，则表示 Oracle HTTP Server、WebLogic Server 或 Application Developer 安装不完整。检查系统上的最小交换空间，必须至少为 512 MB。

查看日志文件以查找故障的更多具体原因。首先查看主产品清单日志文件夹中的 OUI 日志。请参阅“主产品清单日志”。

配置错误消息

注：

出于故障排除的目的，请一次为一个产品或组件单独执行配置任务。

  • 问题：配置失败，或者在配置期间收到错误消息。

    解决方案：查看 EPM_ORACLE_INSTANCE/diagnotics/logs/config 中的 configtool_summary.log 文件。

  • 问题：首次配置 Oracle 数据库时，以下错误消息会添加到 EPM_ORACLE_INSTANCE/diagnotics/logs/config 中的 configtool.log 文件：

    ORA-00917：缺少逗号

    如果使用 US7ASCII 数据库字符集配置数据库，则会出现此错误。

    解决方案：使用 UTF-8 字符集或具有无限制多语言支持的其他字符集重新创建数据库。EPM System 版本 11.1.3 仅支持《Oracle Enterprise Performance Management System 安装与配置指南》中所述的这些字符集。

配置任务面板：缺少产品

问题：配置任务面板中未显示组件或产品。安装不完整时会发生这种情况。

解决方案：查看 EPM_ORACLE_HOME/diagnostics/logs/install 中的 installTool-install 日志和 product-install.log，以了解是否有任何组件安装不完整。

数据库配置选项不可用

问题：数据库配置面板上的选项不可用。

解决方案：确保使用安装时所用的同一用户帐户配置系统。

远程部署超时

问题：Java Web 应用程序的远程部署失败，并且 EPM_ORACLE_INSTANCE/diagnostics/logs/config/configtool.log 显示以下异常：您执行的操作在 60,000 毫秒后超时。

解决方案：执行下列步骤：

  1. 创建包含以下行的 EPM_ORACLE_HOME/common/config/11.1.2.0/configTool-options.properties 文件：

    deployment.remote.timeout=timeout in milliseconds

    例如，deployment.remote.timeout=300000 指定在 5 分钟（300,000 毫秒）后超时。

  2. 重新部署 Java Web 应用程序。

部署到应用程序服务器失败，但无配置错误

问题：产品未部署到应用程序服务器，但无配置错误。

解决方案：查看 EPM_ORACLE_INSTANCE/diagnostics/logs/config 中的 configtool.log 文件。此文件记录部署过程中的任何错误。如果未标识任务错误，则重新部署到应用程序服务器。

将 Java Web 应用程序移动到单个域

问题：EPM System Java Web 应用程序被部署到不同的 WebLogic Server 域，但您希望将其移动到单个域以进行更好的管理和监视。

注：

应将所有 EPM System 产品部署到一个域。请参阅《Oracle Enterprise Performance Management System 安装与配置指南》。

解决方案：使用以下过程之一：

  • 如果 Foundation Services 域工作正常，请将所有 EPM System Java Web 应用程序部署到该域：

    1. 在该域的 Foundation Services 计算机上运行 WebLogic Server 管理服务器。

    2. 对部署到 Foundation Services 域以外的其他域的 Java Web 应用程序进行重新部署。

      在 EPM System Configurator 中，选择将 Web 应用程序部署到现有域，然后输入 Foundation Services 计算机的主机、端口和域名。

    3. 在 Foundation Services 计算机上重新部署已部署在该计算机上的任何 Java Web 应用程序。

  • 要将所有 EPM System Java Web 应用程序部署到新域：

    1. 使用 WebLogic Server 配置向导创建基本域。

    2. 为新域启动 WebLogic Server 管理服务器。

    3. 对部署到 Foundation Services 计算机以外的其他计算机上的 Java Web 应用程序进行重新部署。

      在 EPM System Configurator 中，选择将 Web 应用程序部署到现有域，然后输入新域的主机、端口和域名。

    4. 将 Foundation Services 计算机上的任何 Java Web 应用程序重新部署到新域。