在 Windows 上配置 Essbase

安装后,必须在 Windows 上使用配置工具配置 Essbase

先决条件和注意事项

  • 必须已安装 Fusion Middleware ,并且 Oracle Essbase 必须安装在同一 Oracle 主目录中。请参阅安装 Fusion Middleware
  • 必须安装支持的关系数据库,如安装先决条件中所述。请参见 Install a Relational Database
  • 如果您使用的是 EPM Shared Services 身份验证,则必须安装受支持的 EPM 版本,并创建和配置 EPM 用户 Shared Services,并了解 Oracle 主目录和 EPM 实例详细信息
    • 如果使用 EPM Shared Services 验证,则它应在 Essbase 配置期间运行。如果 EPM Shared Services 未运行,则必须手动配置某些端口号以避免端口冲突。配置 Essbase 时,必须谨慎并了解此主机上的任何 EPM 服务已在使用的端口,并且只能选择和使用此主机上的服务或应用程序未使用的有效端口。您还必须在用户界面或响应文件中相应地设置这些未使用的端口号。
  • 如果使用 Microsoft SQL Server (MSSQL) 作为 Essbase 资料档案库 (RCU) 方案的数据库,则必须在运行 Essbase 配置工具之前运行该流程来更改数据库并应用正确的整理和解决方案注意事项。有关详细信息,请参阅将 Microsoft SQL Server 配置为 Essbase 模式的资料档案库数据库
  • Pre-create RCU Schemas for Essbase 介绍了在配置之前选择预创建 RCU Schema,然后让 Configuration Tool 为您创建 RCU Schema 的过程。预创建方案的一个用例是,如果您正在使用 Wallet 建立安全的 HTTPS 连接。
  • 在 Windows 控制面板 > 时钟和区域 > 区域中,选择“管理”选项卡。单击更改系统区域设置,然后选中 Beta:使用 Unicode UTF-8 提供全球语言支持复选框。
  • Windows 上的 Essbase 不能在同一主机上具有多个配置或实例。
  • 在创建 RCU 方案(无论是否使用预创建的方案)之前,必须在 Oracle 主目录上应用以下补丁程序。检查 Independent Deployment(独立部署)的 "Essbase Release Notes"(Essbase 版本说明)部分中的最新补丁程序,或与支持人员联系以验证适当的补丁程序版本。

    • 28186730- 适用于 FMW/WLS 的 OPatch 13.9.4.2.x 的最新版本
    • 31676526- 用于 TNS_ADMIN RCU 警告的修补程序 12.2.1.4.0
    • 30540494-RAC RCU bug 的补丁程序 12.2.1.4.0
    • 30754186-RAC RCU bug 的补丁程序 12.2.1.4.0
  • 所有端口都不应位于临时端口范围内,也不应由其他正在运行的软件使用。请参见 Avoid Port Conflicts
  • 每个托管服务器必须分配给一台计算机,这是托管一个或多个服务器实例的计算机的逻辑表示。计算机名称相对于域中的其他可配置资源必须是唯一的。
  • 如果您计划安装和配置多个 Essbase 内部部署实例,以支持故障转移,则需要一个前端负载平衡器,并且必须在不同的主机上配置这些实例。如前所述,Windows 上的 Essbase 不能在同一主机上具有多个配置或实例。请参阅配置负载平衡器以支持故障转移
  • 如果要配置 Essbase 服务或将其用作 Essbase Windows 服务,要启动和停止 Essbase 服务,PowerShell 必须位于环境 PATH 变量中。您还必须在配置期间启用 Essbase Windows 服务,才能安装 Windows 服务。
  • 如果您要使用 URL /aps/SmartView 通过 Smart View 进行连接,则需要更改 URL。请参阅重定向到新的 Essbase Smart View 连接 URL 。或者,您可以配置指向 Web 服务器上的新 URL 的重定向。如果您使用的是 Oracle HTTP Server (OHS) 或 HTTPD 服务器,请在修改 Oracle HTTP Server 配置时重定向 URL,如前面的项目符号中所述。
  • 要访问响应文件并使用该文件,必须为用户设置 TEMP 和 TMP 环境变量,如下所示:
    1. 在 Windows 任务栏上,右键单击 Windows 图标,然后选择系统
    2. 在 "Settings"(设置)页面右侧的 "Related Settings"(相关设置)标题下,依次单击 Systems info(系统信息)Advanced System settings(高级系统设置)
    3. 选择环境变量
    4. 单击新建以创建新的环境变量 TEMP 和 TMP,或者单击编辑以使用您的用户变量值修改现有环境变量 TEMP 和 TMP。可以对两者使用相同的值。
    5. 设置后,打开新的 cmd 或命令提示符以反映新变量集。

运行配置工具栏

  1. 如果在安装结束时未继续配置,请启动配置工具。
    1. 在安装了 EssbaseFusion Middleware 的 Oracle 主目录中,在 \essbase\bin 中打开一个终端。例如,在 <Oracle_Home>\essbase\bin 中打开终端。
    2. 使用 config.cmd 命令脚本启动 Configuration Tool。
      config.cmd
      可使用参数(例如 -mode、-log、-log 优先级、-responseFile)运行脚本。如果使用 responseFile 参数,则所有字段都将填充以前的配置条目(密码除外)。要了解配置脚本选项,请运行:config.cmd -help
  2. 在“Welcome(欢迎使用)”页面上,单击 Next(下一步)
  3. 在“Domain Details(域详细信息)”页面上,执行以下操作。
    1. 接受默认值(如果正确)或输入域名,例如 essbase_domain
    2. 接受默认路径(如果正确)或输入域根路径,例如
      C:\Oracle_home\dist\domains
    3. 接受默认值或输入应用程序目录,例如,
      C:\Oracle_home\dist\applications\essbase
      建议将应用程序目录与配置文件分开。
    4. 输入将用于管理 Essbase 和中间件服务器的 WebLogic 管理员帐户的名称和密码。
      • 如果使用 WebLogic Embedded LDAP ,则还会向此管理员授予 Essbase 服务管理员角色。
      • 如果使用 EPM Shared Services ,则此管理员仅适用于 EssbaseWebLogic 实例。将为 EPM Shared Services 管理员用户设置 Essbase 用户角色:服务管理员。
    5. 单击下一步
  4. 在“Database connection(数据库连接)”页上执行以下操作。
    1. 接受默认值,或输入数据库类型。这是受支持的关系数据库,例如 Oracle Database
    2. 输入连接字符串,例如,
      myhost.example.com:1521/orcl
      请参阅连接字符串格式
    3. 选择是立即创建新方案,还是使用在 Pre-create RCU Schemas for Essbase 中使用 Fusion Middleware RCU 实用程序构建的预创建方案作为预配置工作流任务。如果在配置中使用 Microsoft SQL Server (MSSQL),请参阅上述相关先决条件。
    4. 输入方案前缀,例如 ESS26AI。此字符串必须是新的唯一字符串,包含 1-12 个字母数字字符,并且必须以字母开头。
    5. 输入将为所有新方案共享的方案口令。
    6. 对于管理员用户名和密码,请输入为 Oracle Database 授予 sysdba 角色的任何用户的身份证明。这可以是默认的 sys 用户;也可以是 Microsoft 数据库管理员。用户名必须以字母开头,并且包含 5 到 128 个字母数字字符。密码必须以字母开头,长度介于 8 到 30 个字符之间的,至少包括一个数字,还可以包括任意数量的特殊字符 ($ # _)。
    7. 单击下一步
  5. 在“节点管理器配置”页上执行以下操作。
    1. 接受默认值,或输入用于处理群集的节点管理器计算机名称的字符串。所有端口都不应位于临时端口范围内,也不应由其他正在运行的软件使用。请参见 Avoid Port Conflicts
    2. 对于节点管理器监听地址,可以输入或选择全限定主机名(其中安装了 WebLogic 以及 Fusion Middleware 安装)。它也可以是一个操作系统地址。有关参考信息,请参阅配置监听地址
    3. 单击下一步
  6. WebLogic 服务器端口配置页上,根据您在安装过程中所做的选择进行配置。
    接受默认值或输入值。以上屏幕中的值仅为示例。为每个服务器指定安全明确的端口。请参阅服务器配置选项。所有端口都不应位于临时端口范围内,也不应由其他正在运行的软件使用。请参见 Avoid Port Conflicts
    1. 要使用传输层安全性 (Transport Layer Security,TLS Everywhere) 保护连接,请选中安全连接模式复选框;然后可以识别自签名证书。如果您尚未完成,请查看此主题:关于保护通信和网络的安全。如果部署了 TLS 安全,则默认端口是受管服务器安全端口。非安全端口的默认端口值为 9000,安全端口值为 9001。建议使用 secured (9001)。

      如果将 Essbase 配置为使用非 Oracle 关系数据库作为 RCU 资料档案库数据库,则可能需要在 Essbase 部署完成后执行其他步骤来配置系统的 ODBC 驱动程序以支持安全/TLS 加密。请参阅数据库驱动程序配置说明。

    2. [可选] 要限制对特定主机(对于多主目录环境)的访问,请在监听地址字段中指定或选择域(例如 localhost)。如果不选择/输入监听地址值,则监听地址将应用于所有接口和地址,并且所有映射的主机都可以访问。
    3. 单击下一步
  7. Essbase “端口配置”页上,执行以下操作。
    1. 接受代理端口、代理安全端口(用于使用 TLS 的安全通信)以及 Essbase 应用服务器的最小端口和最大端口的默认值或输入值。
      • 代理端口指定 Essbase 代理的端口 - 默认值为 1423。
      • 代理安全端口指定 Essbase 代理在安全连接模式下使用传输层安全 (Transport Layer Security,TLS) 进行安全通信时使用的端口 - 默认值为 6423。
      • 当一台计算机上安装了 Essbase Server 的多个实例时,必须为每个实例都指定一个唯一的端口号。
      • 所有端口都不应位于临时端口范围内,也不应由其他正在运行的软件使用。请参见 Avoid Port Conflicts
      • 最小端口和最大端口之间的范围必须至少为 1000,具体取决于使用的数量。
    2. 单击下一步
  8. 在“身份提供者配置”页上执行以下操作。
    1. 如果您尚未查看,请查看选择验证提供程序主题。
    2. WebLogic 为默认值。如果当前使用 EPM Shared Services,并且想要继续,请选中启用 EPM Shared Services Identity Provider 复选框。窗口示例显示已选择 EPM 提供程序。启用后,EPM 字段可用于确认或指定 EPM Oracle 主目录Oracle 实例位置。有关这些内容的详细信息,请参阅关于中间件主目录、EPM Oracle 主目录和 EPM Oracle 实例
    3. 对于要配置或可用的 Essbase Windows 服务,要启动和停止 Essbase 服务,PowerShell 必须位于环境变量 PATH 中。您还必须在配置期间启用 Essbase Windows 服务,才能安装 Windows 服务。要使用此功能,必须在此页上选择启用 Essbase Windows 服务才能安装 Windows 服务。Essbase Windows 服务的启动和停止是使用 Windows SCM 完成的。
    4. 单击下一步
  9. 查看 "Configuration Summary" 页面。记下日志文件位置(如果显示)和响应文件位置。此窗口示例可能与所选条目或值有所不同。 您可以使用响应文件 (.rsp) 保存您的配置选择,并在将来的基于 UI 或无提示模式配置中填写相同的字段值(不包括密码)。如果要使用 .rsp 文件运行将来的配置,还可以运行配置直到汇总页,然后单击取消而不是配置,然后重新使用响应文件。.rsp 文件将保存到概要中列出的临时位置作为响应文件位置。如果您打算使用它来自动执行将来的配置,请务必将其保存到更永久的位置,因为 tmp 目录可能会被常规清除。请参见 Sample Response File and Parameters
  10. 单击配置。在“配置进度”页面上,在“配置工具”处理接近结束时,将启动 Essbase 平台组件。当进度达到 100% 时,单击下一步
  11. 在“配置完成”页面上,查看详细信息,然后单击完成。请注意,此窗口示例不一定反映所选条目或值。您现在可以登录到 Essbase 。有关登录 URL,请参阅 Essbase、REST 和 Smart View 客户端 URL

    注意:

    如果使用 TNS_ADMIN 别名(例如 adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS)安全地为外部数据库配置 Essbase ,则必须执行以下操作,以便 Essbase 服务器可以处理连接:

    1. 编辑:
      <DOMAIN_HOME>\bin\setStartupEnv.cmd
    2. 在使用 -DODBC_URL= 之前将以下行添加到启动脚本:
      set TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS
    3. 更改以下行:
      -DODBC_URL='OCI;SERVICE=adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS'

      to

      -DODBC_URL='OCI;SERVICE='adwsql_low'
可以在 Advanced Configuration Topics 中查看高级和配置后选项和任务。这包括有关删除 RCU 方案、配置 Essbase 和 Oracle HTTP 服务器等的主题。