Per eseguire l'aggiornamento a Essbase 21.8 è necessaria la configurazione ODBC manuale

La distribuzione di Essbase 21.8 include driver ODBC DataDirect aggiornati (versione 8.0.2). Dopo aver applicato Essbase 21.8 OPatch a una distribuzione Essbase indipendente, è necessario aggiornare manualmente la configurazione ODBC (valido per Linux e Windows).

Questo problema si verifica se si sta eseguendo l'aggiornamento a Essbase 21.8 da una versione precedente ed è necessario caricare i dati o le dimensioni di origine esterna in Essbase utilizzando i driver ODBC (come descritto in Accedere ai dati mediante la connettività ODBC).

Nota

Quando si applica OPatch Essbase 21.8, vengono rimosse le versioni precedenti dei driver ODBC (ad esempio, 7.1.6 o 5.3). Non sono supportati per Essbase 21.8 e non funzioneranno.

Essbase 21.8 viene fornito in bundle solo con le seguenti versioni del driver ODBC DataDirect e sono supportate solo le seguenti:

[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

Dopo aver applicato Essbase 21.8 OPatch,

È necessario aggiornare manualmente la configurazione ODBC (valido sia per Linux che per Windows).
Oracle consiglia di eseguire manualmente il backup delle configurazioni ODBC per i driver 7.1.6 precedenti, nel caso in cui sia necessario eseguire il rollback a una versione precedente di Essbase che utilizza tali driver.

Istruzioni Linux

Prima di iniziare, prendere nota della posizione delle configurazioni dei driver 7.1.6 precedenti nel dominio del server Essbase:

odbc.ini, situato in

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

odbcinst.ini, situato in

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

Librerie di driver ODBC, situate in
```
<Essbase Product Home>/modules/
```

Se Essbase è in esecuzione, arrestare i server, come descritto in Avvia, Arresta e Controlla server.
Effettuare una copia di backup delle configurazioni dei driver 7.1.6 precedenti: odbc.ini (obbligatorio) e odbcinst.ini (obbligatorio se si utilizzano driver di terze parti come Teradata).
Nota
Per evitare sovrascritture accidentali, assicurarsi che i backup della configurazione del driver 7.1.6 vengano salvati in un punto esterno
```
<Essbase Product Home>/modules/
```
Esempi:
```
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
```
Applicare OPatch Essbase 21.8 (come descritto in Applicazione di patch e rollback).
Aprire odbc.ini per la modifica.

Sostituire i vecchi nomi dei driver con quelli nuovi, fornendo il percorso assoluto della libreria nella voce del nome del driver. Ad esempio, (sostituire Oracle_HOME con il percorso Oracle_HOME del sistema):

Modifica

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

Modifica

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

Modifica

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

(Opzionale) sostituire le vecchie descrizioni dei driver con nuove.
- Modificare Oracle 7.1 SQL Server Wire Protocol in Oracle 8.0 SQL Server Wire Protocol
- Modificare Oracle 7.1 DB2 Wire Protocol Driver in Oracle 8.0 DB2 Wire Protocol Driver
- Modificare Oracle 7.1 MySQL Wire Protocol in Oracle 8.0 MySQL Wire Protocol
Salvare odbc.ini.
Modificare il file odbcinst.ini, <Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/odbcinst.ini.

Esempio per DB2

(sostituire Oracle_HOME con il percorso Oracle_HOME del sistema):
```
Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/Ardb228.so
```
Esempio per Teradata

Copia e incolla delle voci relative a Teradata dal file di backup, <Oracle_HOME>/odbcinst.ini_orig, aggiungere informazioni sul driver ODBC 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
```
Salvare odbcinst.ini.
Avviare Essbase, come descritto in Server di avvio, arresto e controllo.

Nota

Se è necessario eseguire il rollback di Essbase 21.8 OPatch, sarà inoltre necessario eseguire il ripristino del file odbc.ini di backup (e di odbcinst.ini, se si utilizzano driver di terze parti come Teradata). Esempio:

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

Istruzioni per Windows

In Windows, i DSN di sistema configurati in precedenza, come descritto in Configurare l'origine dati ODBC (Windows), non funzioneranno dopo l'applicazione dell'OPatch Essbase 21.8. È necessario riconfigurare il DSN di sistema per utilizzare i driver 8.0.2.

Se Essbase è in esecuzione, arrestare i server, come descritto in Avvia, Arresta e Controlla server.
Applicare OPatch Essbase 21.8 (come descritto in Applicazione di patch e rollback).
Nel server Windows Essbase aprire l'editor del registro di Windows (dal menu Start eseguire regedit).
Passare a Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI.
Fare clic con il pulsante destro del mouse su ODBC.INI e selezionare Esporta. Salvarlo come backup, nel caso in cui sia necessario eseguire il rollback di OPatch. Ad esempio, salvare la configurazione come odbc.orig.reg.
Passare a Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI.
Fare clic con il pulsante destro del mouse su ODBCINST.INI e selezionare Esporta. Salvarlo come backup, nel caso in cui sia necessario eseguire il rollback di OPatch. Ad esempio, salvare la configurazione come odbcini.orig.reg.
Passare a Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\ODBC Data Sources.
Per la voce denominata essbase_datasource, fare clic con il pulsante destro del mouse e selezionare Modifica.

Modifica
- Oracle 7.1 SQL Server Wire Protocol
  
  to
  
  Oracle 8.0 SQL Server Wire Protocol
- Modifica
  
  Oracle 7.1 DB2 Wire Protocol Driver
  
  to
  
  Oracle 8.0 DB2 Wire Protocol Driver
- Modifica
  
  Oracle 7.1 MySQL Wire Protocol
  
  to
  
  Oracle 8.0 MySQL Wire Protocol
Nel server Windows di Essbase, passare a <ESSBASE_PRODUCT_HOME>\modules\oracle.essbase.datadirect.odbc\8.0.2.
Creare una copia di backup di ODBC802.reg (ad esempio, ODBC802_orig.reg).
Modificare ODBC802.reg, sostituendo tutte le occorrenze di $ODBC_PATH con il percorso assoluto dei driver ODBC, ad esempio C:\\Oracle\\Middleware\\Oracle_Home\\essbase\\modules\\oracle.essbase.datadirect.odbc\\.
Fare doppio clic sul file ODBC802.reg modificato. Questa operazione modificherà il registro di Windows in modo che le voci per i driver DataDirect 8.0.2 vengano raggruppate con Essbase 21.8.
Avviare Essbase, come descritto in Server di avvio, arresto e controllo.

Nota

Se è necessario eseguire il rollback dell'OPatch 21.8 di Essbase, sarà inoltre necessario eseguire il ripristino delle voci di registro di Windows ODBC.INI e ODBCINST.INI di backup. Ad esempio, eliminare la voce ODBC.INI da regedit, quindi fare doppio clic su odbc.orig.reg per ripristinare la voce precedente. In alternativa, è possibile importare/unire le voci del registro.