准备从 Essbase 11g 内部部署进行迁移

如果您有现有的 Essbase 11g 内部部署应用程序和多维数据集要迁移到 Essbase 26ai ，请查看以下注意事项和先决条件。

Essbase 11g 内部部署与 Essbase 26ai 之间的差异

• 具有类型化度量的多维数据集的自由格式数据导出和导入在 Essbase 26ai 中的行为不同。有关最新信息，请参阅加载、清除和导出文本和日期度量。

• 在迁移之前，请查看 Essbase 11g 与 Oracle Essbase 26ai 之间的差异。

用于迁移的任务流

注意：

• 如果在 Essbase 11g 内部部署中使用了 EPM Shared Services 来配置外部安全提供程序，则不需要执行下面的步骤 1。根据在配置期间选择的安全模式，您可能需要将目标 EPM 实例或 WebLogic 配置为使用与 Essbase 11g 内部部署中使用的相同外部安全提供程序。

• 如果您使用的是 Oracle Identity Cloud Service ，请将其配置为使用与 Essbase 11g On-Premise 中相同的外部安全提供程序。

1. 将用户和组从源 Essbase 11g On-Premise EPM Shared Services 迁移到 OCI Identity and Access Management (IAM) 或 Oracle Identity Cloud Service (IDCS)（用于 OCI 部署）或 EPM Shared Services / WebLogic LDAP（用于独立部署）。请参阅迁移 Essbase 11g 用户和组。

2. 如果要导出非 Unicode Essbase 11g On-Premise 应用程序，则必须将应用程序转换为 Unicode。

   1. Use Alter System on the server, and then on a backup copy of the Essbase application, prior to running 11g LCM Export Utility, to enable Essbase itself to support the Unicode application.

   2. 对于非 Unicode、 block 存储应用程序，请在导出命令中使用 -converttoutf8 选项导出应用程序。请参见 11g LCM Export Utility Options 。

      对于非 Unicode、 aggregate 存储应用程序，请按照 Convert Non-Unicode Aggregate Storage Application to Unicode Mode 中的手动 Unicode 转换说明进行操作。

3. 迁移 11g 应用程序：

   1. 使用 11g LCM 导出实用程序导出 Essbase 应用程序，从目标 Essbase 26ai 实例下载，然后在安装了 Essbase 11g On-Premise 的计算机上运行实用程序。

      注意：

      要使用 11g LCM 导出实用程序，必须安装 Java Development Kit (JDK) 8 或更高版本，并且必须设置以下变量：JAVA_HOME 环境变量，以及 shell 终端中的 EPM_ORACLE_HOME 和 EPM_ORACLE_INSTANCE 变量。

   2. 使用从 Essbase 26ai 实例下载的 Essbase 命令行界面 (Command Line Interface，CLI) 实用程序导入 Essbase 应用程序。对每个导出的 zip 文件运行该实用程序。

支持的 Essbase 版本和路径

以下发行版已针对迁移进行了测试：11.1.2.3.0nn、11.1.2.4.0nn、12.2.1 及更高版本。

注意：

支持从 11.1.2.3 迁移，但并非每个应用程序都可以从 11.1.2.3 迁移到 26ai。我们建议您在尝试迁移到 26ai 之前将 11.1.2.3.0.n.n 升级到 11.1.2.4.0.n.n。

不支持以下迁移路径：

• Essbase 19c 或 26ai on OCI（Marketplace 部署）到 Essbase 26ai on Windows（独立部署）
• Linux 上的 Essbase 26ai （独立部署）到 Windows 上的 Essbase 26ai （独立部署）

迁移的 11g 对象

查看迁移支持的 11g 对象。请参见 Migrated Artifacts 。

不受支持的应用程序和数据库设置

迁移中不支持以下应用程序或数据库级别设置：磁盘卷。

配置注释

• 混合模式

  默认计算和查询处理器为混合模式。混合模式使块存储多维数据集能够拥有动态、上级稀疏成员以及完全动态查询和计算。更新数据后可以立即查询数据，无需运行批处理计算。在混合模式中，如果没有选择对上级稀疏成员应用动态计算，则对立方没有影响。注意：如果使用计算脚本，则混合模式不是默认模式 - 如果计算脚本包含许多稀疏依赖项，请考虑为计算脚本启用混合模式。

• 隐式共享

  如果在 Essbase 11g 内部部署应用程序中使用 IMPLIED_SHARE 配置设置，则将迁移隐含的共享设置，以尽可能减少中断。有关 Essbase 26ai 中隐式共享默认值的更多详细信息，请参阅 IMPLIED_SHARE_ON_CREATE 配置主题。

• 关于 UPPERCASECONNECTION esssql.cfg 设置的警告

  如果您的环境具有包含不再支持的 UPPERCASECONNECTION 设置的 esssql.cfg 文件，则在执行数据加载操作时可能会收到如下警告：

  WARNING – 1021037 - SQL Config file syntax error [UpperCaseConnection], ignored.

  修复此问题的方法是手动从 esssql.cfg 中删除 UPPERCASECONNECTION 设置，该设置位于

  <DOMAIN_HOME>/config/fmwconfig/essconfig/essbase/esssql.cfg

  然后重新启动 Essbase 服务器。

• 文本和日期度量
  从 Essbase 21.3 及更高版本开始，配置 ALLOWOUTOFRANGELOAD 已过时，其行为将与以前版本中的 "ALLOWOUTOFRANGELOAD TRUE" 相同。类型化度量的超出范围和缺失值将加载到具有文本度量的多维数据集，并导出这些多维数据集。在以下数据导出文件示例中，对于缺失值，<OutOfRange_Name> 为 "Invalid" 和 "NoColor"。

  "Color1" "Color2"
  "Shoes" "Massachusetts" "Q1" "#Txt:NoColor" "#Txt:Yellow"
  "Q2" "#Txt:Green"
  "Connecticut" "Q1" "#Txt:Green" "#Txt:Invalid"

  有关加载超出范围值的信息，请参阅加载、清除和导出文本和日期度量。

• 配置设置

  某些默认配置值与 Essbase 11g 内部部署中的值不同。检查 Configuration Reference 。

  INDEXCACHESIZE 和 DATACACHESIZE 设置现在控制所有 Essbase 多维数据集（聚合存储多维数据集除外）的高速缓存大小。以前，这两个设置仅影响新创建的多维数据集或迁移的多维数据集。

  要修改应用程序级配置设置的默认值，请使用 Essbase Web 界面。

  Oracle 建议在应用程序级别管理大多数配置。迁移应用程序时，将在 LCM 导出和导入过程中保留应用程序级配置。但是，某些配置仅适用于 Essbase Server 。在部署期间配置 Essbase 时指定的大多数服务器配置，但如果需要，还可以使用 essbase.cfg 更改服务器配置默认值。

一般说明

• 导入的 SQL 时间戳数据类型

  以前以 ODBC 格式 [yyyy-mm-dd hh:mm:ss] 显示的 SQL 时间戳数据类型现在以不同的格式 [dd-MON-yy hh.mm.ss.mmm a] 显示，显示在 Essbase Web 界面的规则编辑器中以及导入时间戳数据类型的其他位置。要在数据加载或维构建期间以您选择的格式加载时间戳，您可以通过在加载规则的查询部分中使用 SQL 转换函数将时间戳转换为您选择的字符串格式。以下 SQL 查询示例使用格式函数：SELECT introdate, format(introdate, 'yyyy-MM-dd hh:mm:ss') FROM tbc.dbo.product

• 升级 EPM 应用程序 - 计算和筛选器

  将应用程序升级到 Essbase 26ai 后，无法从 EPM Shared Services 控制台为计算或筛选器设置成员。您必须使用 Essbase Web 界面来分配成员。请参阅：分配筛选器和计算访问权限

• 分区

  执行 LCM 导入操作时，请先导入源应用程序，再导入目标应用程序。如果未在目标应用程序之前导入源应用程序，则分区定义将无法工作，必须在导入源应用程序之后重新创建分区定义。

  回退 OPatch 后，可能需要重新创建透明和复制的分区，并重新验证分区。

• LCM 之外的应用程序创建选项

  除了使用 LCM 迁移导出的应用程序，还可以通过以下方式创建应用程序：

  • 使用 Excel 应用程序工作簿导入
  • 在 Smart View 中，使用多维数据集设计器扩展
  • MaxL create application 语句

• 位置别名

  LCM 不支持位置别名身份证明迁移。从 Essbase 11g On-Premise 迁移应用程序后，必须替换位置别名。您可以使用以下自动化方法，或使用 MaxL 的手动方法。

  用于替换位置别名的自动化方法

  1. 解压缩 LCM 导出的 zip。
  2. 转到 {ApplicationName}\Databases{dbName}\Location 别名。
  3. 打开此目录下的文件。这是 XML 格式文件，其中 userName 和密码字段为空。您可以提供身份证明。
  4. 再次压缩目录。
  5. 使用 zip 目录导入应用程序。

     示例 xml 文件

     <?xml version="1.0" encoding="UTF-8"?>
     <java version="$VERSION$" class="java.beans.XMLDecoder">
     <object class="oracle.essbase.lcm.essbase.EssbaseLocationAlias">
     <void property="aliasAppName">
     <string>
     {appName}
     </string>
     </void>
     <void property="aliasCubeName">
     <string>
     {dbName}
     </string>
     </void>
     <void property="aliasHostName">
     <string>localhost</string>
     </void>
     <void property="password">
     <string>password</string>
     </void>
     <void property="userName">
     <string>lauser</string>
     </void>
     </object>
     </java>

  使用 MaxL 替换位置别名的手动方法

  替代选件手动方法使用 MaxL 。通过执行 CLI LCMImport 作业导入源应用程序后，请使用 Create Location Alias 重新创建位置别名。

• 自定义函数和宏

  FOR INDEPLOYMENTS - 如果您有用于自定义计算函数和宏的自定义 .jar 文件，则这些文件不会由 11g LCM 导出实用程序迁移。必须手动移动它们。要执行此操作，

  1. 请注意 Essbase 26ai 中 <Essbase Path> 和 <Application directory> ( ARBORPATH ) 的位置。如果需要，请参阅 Essbase 平台中的环境位置。

  2. 通过将源实例上的 <Essbase Path>/java/udf 中的 .jar 文件复制到目标 Essbase 实例上的 <Essbase Path>/java/udf，迁移全局（系统级）函数。

  3. 通过将 .jar 文件从源实例上的应用程序目录复制到目标 Essbase 实例上的应用程序目录，迁移本地（应用程序级）函数。换句话说，将 .jar 文件从 11g 服务器上的 <ARBORPATH>/app/<app_name> 复制到 26ai 服务器上的 <Application directory>/app/<app_name>。

  4. 在目标 Essbase 实例上，将 JVMMODULELOCATION 添加到 essbase.cfg，以参数形式提供系统上 JVM 库的路径。

• 客户端服务 URL

  FOR INDEPENDENT DEPLOYMENTS - In Essbase 11g, Provider Services is the middle-tier data-source provider to Oracle Essbase for Java API, Smart View, and XML for Analysis (XMLA) clients.

  Provider Services 功能与 WebLogic 集成。将客户端 URL 更新为当前格式。

  客户机	先前用于将 Provider Services 连接到指定的客户端的 URL	Essbase 26ai 中的新 URL
  Java API	http://server_name:port/aps/JAPI	http://server_name:port/essbase/japi
  Smart View	http://server_name:port/aps/SmartView	http://server_name:port/essbase/smartview
  XML for Analysis (XMLA)	http://server_name:port/aps/XMLA	http://server_name:port/essbase/xmla

• 大纲解析顺序和启用的键入度量

  FOR OCI MARKETPLACE DEPLOYMENTS - 将 Essbase 应用程序从 Essbase 11g On Premises 服务器迁移到通过 MARKETPLACE 部署在 OCI 上的 Essbase 后，必须先在大纲中启用键入的度量，然后才能更改大纲解析顺序。

  在 OCI 上部署的 Essbase 中，默认情况下，启用类型度量大纲属性设置为 FALSE。要更改解析顺序，首先需要将“启用键入的度量”属性更改为 TRUE。要更改此属性，请参阅 Database Administrator's Guide for Oracle Essbase 中的 About Typed Measures 。