La actualización a Essbase 21.8 requiere la configuración manual de ODBC

El despliegue de Essbase 21.8 incluye controladores ODBC DataDirect actualizados (versión 8.0.2). Después de aplicar OPatch de Essbase 21.8 a un despliegue de Essbase independiente, debe actualizar manualmente la configuración de ODBC (se aplica en Linux y Windows).

Este problema le afecta si está actualizando a Essbase 21.8 desde una versión anterior y necesita cargar datos/dimensiones de origen externo en Essbase mediante controladores ODBC (como se describe en Acceso a datos mediante conectividad ODBC).

Note:

Al aplicar OPatch de Essbase 21.8, se eliminan las versiones anteriores del controlador ODBC (por ejemplo, 7.1.6 o 5.3). No se admiten para Essbase 21.8 y no funcionarán.

Essbase 21.8 solo se incluye con estas versiones de controlador ODBC de DataDirect, y solo se admiten las siguientes:

[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

Después de aplicar OPatch de Essbase 21.8,

  • Debe actualizar manualmente la configuración de ODBC (se aplica tanto en Linux como en Windows).
  • Oracle recomienda realizar una copia de seguridad manual de las configuraciones de ODBC para los controladores 7.1.6 anteriores, en caso de que necesite realizar un rollback a una versión anterior de Essbase que utilice esos controladores.

Instrucciones de Linux

Antes de comenzar, tome nota de la ubicación de las configuraciones de controlador 7.1.6 anteriores en el dominio del servidor de Essbase:

  • odbc.ini, ubicado en

    <Domain Root>/<Domain Name>/config/fmwconfig/essconfig/core
  • odbcinst.ini, ubicado en

    <Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/7.1.6/odbcinst.ini
  • Bibliotecas de controladores ODBC, ubicadas en

    <Essbase Product Home>/modules/
  1. Si se está ejecutando Essbase, detenga los servidores, como se describe en Iniciar, Detener y Comprobar Servidores.

  2. Realice una copia de seguridad de las configuraciones de controlador 7.1.6 anteriores: odbc.ini (necesario) y odbcinst.ini (necesario si utiliza controladores de terceros como Teradata).

    Note:

    Para evitar la sobrescritura accidental, asegúrese de que las copias de seguridad de la configuración del controlador 7.1.6 se guarden en algún lugar fuera de
    <Essbase Product Home>/modules/

    Ejemplos:

    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
  3. Aplique OPatch de Essbase 21.8 (como se describe en Patch and Rollback).

  4. Abra odbc.ini para su edición.

  5. Sustituya los nombres de controlador antiguos por los nuevos, proporcionando la ruta de biblioteca absoluta en la entrada de nombre de controlador. Por ejemplo, (sustituya Oracle_HOME por la ruta Oracle_HOME del sistema):

    • Cambiar

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

      to

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

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

      to

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

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

      to

      Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/lib/ARmysql28.so
  6. (Opcional) Sustituya las descripciones de controlador antiguas por otras nuevas.

    • Cambiar Oracle 7.1 SQL Server Wire Protocol a Oracle 8.0 SQL Server Wire Protocol
    • Cambiar Oracle 7.1 DB2 Wire Protocol Driver a Oracle 8.0 DB2 Wire Protocol Driver
    • Cambiar Oracle 7.1 MySQL Wire Protocol a Oracle 8.0 MySQL Wire Protocol
  7. Guarde odbc.ini.

  8. Edite el archivo odbcinst.ini, <Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/odbcinst.ini.

    Ejemplo para DB2

    (sustituya Oracle_HOME por la ruta Oracle_HOME del sistema):

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

    Ejemplo para Teradata

    Copiando y pegando las entradas relacionadas con Teradata del archivo de copia de seguridad, <Oracle_HOME>/odbcinst.ini_orig, agregue información sobre el controlador ODBC de Teradata a 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
  9. Guarde odbcinst.ini.

  10. Inicie Essbase, como se describe en Iniciar, Detener y Comprobar Servidores.

Note:

Si alguna vez necesita realizar un rollback del OPatch de Essbase 21.8, también tendrá que restaurar el archivo odbc.ini de copia de seguridad (y odbcinst.ini, si utiliza controladores de terceros como Teradata). Por ejemplo:

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

Instrucciones para Windows

En Windows, los DSN de sistema configurados anteriormente, como se describe en Configuración del origen de datos ODBC (Windows), no funcionarán después de aplicar OPatch de Essbase 21.8. Debe volver a configurar el DSN de sistema para utilizar los controladores 8.0.2.

  1. Si se está ejecutando Essbase, detenga los servidores, como se describe en Iniciar, Detener y Comprobar Servidores.

  2. Aplique OPatch de Essbase 21.8 (como se describe en Patch and Rollback).

  3. En el servidor de Windows de Essbase, abra el Editor de registro de Windows (en el menú Inicio, ejecute regedit).

  4. Vaya a Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI.

  5. Haga clic con el botón derecho en ODBC.INI y seleccione Exportar. Guárdelo como copia de seguridad, en caso de que necesite realizar un rollback del OPatch. Por ejemplo, guarde la configuración como odbc.orig.reg.

  6. Vaya a Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI.

  7. Haga clic con el botón derecho en ODBCINST.INI y seleccione Export (Exportar). Guárdelo como copia de seguridad, en caso de que necesite realizar un rollback del OPatch. Por ejemplo, guarde la configuración como odbcini.orig.reg.

  8. Vaya a Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\ODBC Data Sources.

  9. Para la entrada denominada essbase_datasource, haga clic con el botón derecho y seleccione Modify (Modificar).

    Cambiar

    • Oracle 7.1 SQL Server Wire Protocol

      to

      Oracle 8.0 SQL Server Wire Protocol

    • Cambiar

      Oracle 7.1 DB2 Wire Protocol Driver

      to

      Oracle 8.0 DB2 Wire Protocol Driver

    • Cambiar

      Oracle 7.1 MySQL Wire Protocol

      to

      Oracle 8.0 MySQL Wire Protocol

  10. En Windows Server de Essbase, vaya a <ESSBASE_PRODUCT_HOME>\modules\oracle.essbase.datadirect.odbc\8.0.2.

  11. Realice una copia de seguridad de ODBC802.reg (por ejemplo, ODBC802_orig.reg).

  12. Edite ODBC802.reg, sustituyendo todas las incidencias de $ODBC_PATH por la ruta absoluta de los controladores ODBC, por ejemplo, C:\\Oracle\\Middleware\\Oracle_Home\\essbase\\modules\\oracle.essbase.datadirect.odbc\\.

  13. Haga doble clic en el archivo ODBC802.reg editado. Esto editará el registro de Windows para que tenga entradas para los controladores DataDirect 8.0.2 incluidos con Essbase 21.8.

  14. Inicie Essbase, como se describe en Iniciar, Detener y Comprobar Servidores.

Note:

Si alguna vez necesita realizar un rollback del OPatch de Essbase 21.8, también tendrá que restaurar las entradas de registro de Windows ODBC.INI y ODBCINST.INI de la copia de seguridad. Por ejemplo, suprima la entrada ODBC.INI de regedit y, a continuación, haga doble clic en odbc.orig.reg para restaurar la entrada anterior. También puede importar/fusionar las entradas del registro.