升级到 Essbase 21.8 需要手动 ODBC 配置

升级到 Essbase 21.8 需要手动配置 ODBC

Essbase 21.8 部署包括更新的 DataDirect ODBC 驱动程序（版本 8.0.2）。将 Essbase 21.8 OPatch 应用于独立的 Essbase 部署后，您需要手动更新 ODBC 配置（适用于 Linux 和 Windows）。

如果您要从以前的版本升级到 Essbase 21.8，并且需要使用 ODBC 驱动程序将外部源数据/维加载到 Essbase （如使用 ODBC 连接访问数据中所述）。

注意：

应用 Essbase 21.8 OPatch 时，将删除较旧的 ODBC 驱动程序版本（例如 7.1.6 或 5.3）。它们不受 Essbase 21.8 支持，并且不起作用。

Essbase 21.8 仅与这些 DataDirect ODBC 驱动程序版本捆绑在一起，并且仅支持以下版本：

[ODBC Drivers]
Oracle 8.1 MongoDB
Oracle 8.0 Amazon Redshift Wire Protocol
Oracle 8.0 Apache Hive Wire Protocol
Oracle 8.0 Apache Spark SQL
Oracle 8.0 DB2 Wire Protocol
Oracle 8.0 Greenplum Wire Protocol
Oracle 8.0 Informix Wire Protocol
Oracle 8.0 MySQL Wire Protocol
Oracle 8.0 Oracle Wire Protocol
Oracle 8.0 PostgreSQL Wire Protocol
Oracle 8.0 SQL Server Wire Protocol
Oracle 8.0 Sybase IQ Wire Protocol

应用 Essbase 21.8 OPatch 后，

您必须手动更新 ODBC 配置（适用于 Linux 和 Windows）。
Oracle 建议为旧版 7.1.6 驱动程序手动备份 ODBC 配置，以防您需要回滚到使用这些驱动程序的 Essbase 早期版本。

Linux 说明

开始之前，请记下 Essbase 服务器域上较旧的 7.1.6 驱动程序配置的位置：

odbc.ini，位于

<Domain Root>/<Domain Name>/config/fmwconfig/essconfig/core

odbcinst.ini，位于

<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/odbcinst.ini

ODBC 驱动程序库位于
```
<Essbase Product Home>/modules/
```

如果 Essbase 正在运行，请停止服务器，如启动、停止和检查服务器中所述。
为旧版 7.1.6 驱动程序配置创建备份副本：odbc.ini（必需）和 odbcinst.ini（如果您使用第三方驱动程序（例如 Teradata），则必需）。
注意：
为避免意外覆盖，请确保 7.1.6 驱动程序配置备份保存在外部的某个位置
```
<Essbase Product Home>/modules/
```
示例：
```
cp <Domain_Home>/config/fmwconfig/essconfig/core/odbc.ini <Oracle_HOME>/odbc.ini_orig
```
```
cp <Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/odbcinst.ini <Oracle_HOME>/odbcinst.ini_orig
```
应用 Essbase 21.8 OPatch（如补丁程序和回退中所述）。
打开 odbc.ini 进行编辑。

将旧驱动程序名称替换为新驱动程序名称，在驱动程序名称条目中提供绝对库路径。例如，（将 Oracle_HOME 替换为系统的 Oracle_HOME 路径）：

更改

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/lib/ARsqls27.so

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/lib/ARsqls28.so

更改

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/lib/ARdb227.so

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/lib/ARdb228.so

更改

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/lib/ARmysql27.so

Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/lib/ARmysql28.so

（可选）将旧驱动程序说明替换为新驱动程序说明。
- 将 Oracle 7.1 SQL Server Wire Protocol 更改为 Oracle 8.0 SQL Server Wire Protocol
- 将 Oracle 7.1 DB2 Wire Protocol Driver 更改为 Oracle 8.0 DB2 Wire Protocol Driver
- 将 Oracle 7.1 MySQL Wire Protocol 更改为 Oracle 8.0 MySQL Wire Protocol
保存 odbc.ini。
编辑 odbcinst.ini 文件 <Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/odbcinst.ini。

DB2 的示例

（将 Oracle_HOME 替换为系统的 Oracle_HOME 路径）：
```
Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/Ardb228.so
```
Teradata 的示例

从备份文件 <Oracle_HOME>/odbcinst.ini_orig 复制和粘贴与 Teradata 相关的条目，将有关 Teradata ODBC 驱动程序的信息添加到 odbcinst.ini：
```
Teradata=Installed
[Teradata]
Driver=/opt/teradata/client/20.00/odbc_64/lib/tdataodbc_sb64.so
APILevel=CORE
ConnectFunctions=YYY
DriverODBCVer=3.51
SQLLevel=1
```
保存 odbcinst.ini。
启动 Essbase ，如启动、停止和检查服务器中所述。

注意：

如果您需要回滚 Essbase 21.8 OPatch，则还需要恢复到备份 odbc.ini 文件（以及 odbcinst.ini，如果使用第三方驱动程序，例如 Teradata）。示例：

cd <DOMAIN_HOME>/config/fmwconfig/essconfig/core
cp odbc.ini.orig odbc.ini

Windows 说明

在 Windows 上，先前配置的系统 DSN- 如 Configure the ODBC Source of Data (Windows) 中所述 - 在应用 Essbase 21.8 OPatch 后将不起作用。必须重新配置系统 DSN 以使用 8.0.2 驱动程序。

如果 Essbase 正在运行，请停止服务器，如启动、停止和检查服务器中所述。
应用 Essbase 21.8 OPatch（如补丁程序和回退中所述）。
在 Essbase Windows 服务器上，打开 Windows 注册表编辑器（从“开始”菜单中，运行 regedit ）。
导航到 Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI。
右键单击 ODBC.INI，然后选择导出。将其另存为备份，以防需要回滚 OPatch。例如，将配置另存为 odbc.orig.reg。
导航到 Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI。
右键单击 ODBCINST.INI，然后选择导出。将其另存为备份，以防需要回滚 OPatch。例如，将配置另存为 odbcini.orig.reg。
导航到 Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\ODBC Data Sources。
对于名为 essbase_datasource 的条目，右键单击并选择 Modify 。

更改
- Oracle 7.1 SQL Server Wire Protocol
  
  to
  
  Oracle 8.0 SQL Server Wire Protocol
- 更改
  
  Oracle 7.1 DB2 Wire Protocol Driver
  
  to
  
  Oracle 8.0 DB2 Wire Protocol Driver
- 更改
  
  Oracle 7.1 MySQL Wire Protocol
  
  to
  
  Oracle 8.0 MySQL Wire Protocol
在 Essbase Windows Server 上，导航到 <ESSBASE_PRODUCT_HOME>\modules\oracle.essbase.datadirect.odbc\8.0.2。
创建 ODBC802.reg 的备份副本（例如 ODBC802_orig.reg）。
编辑 ODBC802.reg，用 ODBC 驱动程序的绝对路径（例如 C:\\Oracle\\Middleware\\Oracle_Home\\essbase\\modules\\oracle.essbase.datadirect.odbc\\）替换所有出现的 $ODBC_PATH。
双击编辑的 ODBC802.reg 文件。这将编辑 Windows 注册表，使 DataDirect 8.0.2 驱动程序的条目与 Essbase 21.8 捆绑在一起。
启动 Essbase ，如启动、停止和检查服务器中所述。

注意：

如果您需要回滚 Essbase 21.8 OPatch，则还需要恢复到备份 ODBC.INI 和 ODBCINST.INI Windows 注册表项。例如，从 regedit 中删除 ODBC.INI 条目，然后双击 odbc.orig.reg 恢复上一个条目。或者，您可以导入/合并注册表条目。