Upgrade auf Essbase 21.8 erfordert manuelle ODBC-Konfiguration

Das Essbase 21.8-Deployment umfasst aktualisierte DataDirect-ODBC-Treiber (Version 8.0.2). Nachdem Sie Essbase 21.8 OPatch auf ein unabhängiges Essbase-Deployment angewendet haben, müssen Sie die ODBC-Konfiguration manuell aktualisieren (gilt für Linux und Windows).

Dieses Problem wirkt sich auf Sie aus, wenn Sie ein Upgrade von einer früheren Version auf Essbase 21.8 durchführen und externe Quelldaten/Dimensionen mit ODBC-Treibern in Essbase laden müssen (wie unter Auf Daten mit ODBC-Konnektivität zugreifen beschrieben).

Hinweis:

Wenn Sie Essbase 21.8 OPatch anwenden, werden ältere ODBC-Treiberversionen (z.B. 7.1.6 oder 5.3) entfernt. Sie werden für Essbase 21.8 nicht unterstützt und funktionieren nicht.

Essbase 21.8 ist nur mit diesen DataDirect ODBC-Treiberversionen gebündelt, und nur diese werden unterstützt:

[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

Nachdem Sie den OPatch für Essbase 21.8 angewendet haben,

Sie müssen die ODBC-Konfiguration manuell aktualisieren (gilt sowohl für Linux als auch für Windows).
Oracle empfiehlt, die ODBC-Konfigurationen für die älteren 7.1.6-Treiber manuell zu sichern, falls Sie zu einer früheren Essbase-Version zurückkehren müssen, die diese Treiber verwendet.

Linux-Anweisungen

Notieren Sie sich zunächst den Speicherort der älteren 7.1.6-Treiberkonfigurationen in der Essbase-Serverdomain:

odbc.ini, befindet sich in

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

odbcinst.ini, befindet sich in

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

ODBC-Treiberbibliotheken, die sich in
```
<Essbase Product Home>/modules/
```

Wenn Essbase ausgeführt wird, stoppen Sie die Server, wie unter Server starten, stoppen und prüfen beschrieben.
Erstellen Sie eine Sicherungskopie der älteren 7.1.6-Treiberkonfigurationen: odbc.ini (erforderlich) und odbcinst.ini (erforderlich, wenn Sie Treiber von Drittanbietern wie Teradata verwenden).
Hinweis:
Um versehentliches Überschreiben zu vermeiden, stellen Sie sicher, dass die Sicherungen der 7.1.6-Treiberkonfiguration irgendwo außerhalb von
```
<Essbase Product Home>/modules/
```
Beispiele:
```
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
```
Wenden Sie Essbase 21.8 OPatch an (wie unter Patch und Rollback beschrieben).
Öffnen Sie odbc.ini zur Bearbeitung.

Ersetzen Sie die alten Treibernamen durch neue, indem Sie den absoluten Bibliothekspfad im Eintrag für den Treibernamen angeben. Beispiel: (Ersetzen Sie Oracle_HOME durch den Oracle_HOME-Pfad Ihres Systems):

Änderung

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

bis

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

Änderung

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

bis

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

Änderung

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

bis

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

(Optional) Ersetzen Sie die alten Treiberbeschreibungen durch neue.
- Ändern Sie Oracle 7.1 SQL Server Wire Protocol in Oracle 8.0 SQL Server Wire Protocol.
- Ändern Sie Oracle 7.1 DB2 Wire Protocol Driver in Oracle 8.0 DB2 Wire Protocol Driver.
- Ändern Sie Oracle 7.1 MySQL Wire Protocol in Oracle 8.0 MySQL Wire Protocol.
Speichern Sie odbc.ini.
Bearbeiten Sie die Datei odbcinst.ini, <Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/odbcinst.ini.

Beispiel für DB2

(ersetzen Sie Oracle_HOME durch den Oracle_HOME-Pfad Ihres Systems):
```
Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/Ardb228.so
```
Beispiel für Teradata

Kopieren und Einfügen Ihrer Teradata-bezogenen Einträge aus der Backupdatei <Oracle_HOME>/odbcinst.ini_orig, fügen Sie Informationen zum Teradata ODBC-Treiber in odbcinst.ini ein:
```
Teradata=Installed
[Teradata]
Driver=/opt/teradata/client/20.00/odbc_64/lib/tdataodbc_sb64.so
APILevel=CORE
ConnectFunctions=YYY
DriverODBCVer=3.51
SQLLevel=1
```
Speichern Sie odbcinst.ini.
Starten Sie Essbase, wie unter Server starten, stoppen und prüfen beschrieben.

Hinweis:

Wenn Sie jemals ein Rollback des Essbase 21.8 OPatch durchführen müssen, müssen Sie auch die Backupdatei odbc.ini (und odbcinst.ini, wenn Sie Drittanbietertreiber wie Teradata verwenden) wiederherstellen. Beispiel:

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

Anweisungen für Windows

Unter Windows funktionieren zuvor konfigurierte System-DSNs – wie unter ODBC-Datenquelle (Windows) konfigurieren beschrieben – nach dem Anwenden von Essbase 21.8 OPatch nicht mehr. Sie müssen den System-DSN neu konfigurieren, um die 8.0.2-Treiber zu verwenden.

Wenn Essbase ausgeführt wird, stoppen Sie die Server, wie unter Server starten, stoppen und prüfen beschrieben.
Wenden Sie Essbase 21.8 OPatch an (wie unter Patch und Rollback beschrieben).
Öffnen Sie auf dem Essbase-Windows-Server den Windows Registry Editor (aus dem Startmenü regedit ausführen).
Navigieren Sie zu Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI.
Klicken Sie mit der rechten Maustaste auf ODBC.INI, und wählen Sie Exportieren aus. Speichern Sie es als Backup, falls Sie OPatch zurücksetzen müssen. Beispiel: Speichern Sie die Konfiguration als odbc.orig.reg.
Navigieren Sie zu Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI.
Klicken Sie mit der rechten Maustaste auf ODBCINST.INI, und wählen Sie Exportieren aus. Speichern Sie es als Backup, falls Sie OPatch zurücksetzen müssen. Beispiel: Speichern Sie die Konfiguration als odbcini.orig.reg.
Navigieren Sie zu Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\ODBC Data Sources.
Klicken Sie für den Eintrag essbase_datasource mit der rechten Maustaste, und wählen Sie Ändern aus.

Änderung
- Oracle 7.1 SQL Server Wire Protocol
  
  bis
  
  Oracle 8.0 SQL Server Wire Protocol
- Änderung
  
  Oracle 7.1 DB2 Wire Protocol Driver
  
  bis
  
  Oracle 8.0 DB2 Wire Protocol Driver
- Änderung
  
  Oracle 7.1 MySQL Wire Protocol
  
  bis
  
  Oracle 8.0 MySQL Wire Protocol
Navigieren Sie auf dem Essbase-Windows Server zu <ESSBASE_PRODUCT_HOME>\modules\oracle.essbase.datadirect.odbc\8.0.2.
Erstellen Sie eine Backupkopie von ODBC802.reg (Beispiel: ODBC802_orig.reg).
Bearbeiten Sie ODBC802.reg, und ersetzen Sie alle Vorkommen von $ODBC_PATH durch den absoluten Pfad der ODBC-Treiber. Beispiel: C:\\Oracle\\Middleware\\Oracle_Home\\essbase\\modules\\oracle.essbase.datadirect.odbc\\.
Doppelklicken Sie auf die bearbeitete Datei ODBC802.reg. Dadurch wird die Windows-Registry so bearbeitet, dass Einträge für die mit Essbase 21.8 gebündelten DataDirect 8.0.2-Treiber vorhanden sind.
Starten Sie Essbase, wie unter Server starten, stoppen und prüfen beschrieben.

Hinweis:

Wenn Sie jemals ein Rollback des Essbase 21.8 OPatch durchführen müssen, müssen Sie auch die Windows-Registrierungseinträge ODBC.INI und ODBCINST.INI in Ihrem Backup wiederherstellen. Beispiel: Löschen Sie den Eintrag ODBC.INI aus regedit, und doppelklicken Sie auf odbc.orig.reg, um den vorherigen Eintrag wiederherzustellen. Alternativ können Sie die Registry-Einträge importieren/zusammenführen.