La mise à niveau vers Essbase 21.8 nécessite une configuration ODBC manuelle

La mise à niveau vers Essbase 21.8 requiert une configuration ODBC manuelle

Le déploiement Essbase 21.8 inclut les pilotes ODBC DataDirect mis à jour (version 8.0.2). Après avoir appliqué Essbase 21.8 OPatch à un déploiement Essbase indépendant, vous devez mettre à jour manuellement votre configuration ODBC (s'applique sous Linux et Windows).

Ce problème vous concerne si vous effectuez une mise à niveau vers Essbase 21.8 à partir d'une version précédente et que vous devez charger des dimensions/données source externes vers Essbase à l'aide des pilotes ODBC (comme décrit dans Accès aux données à l'aide de la connectivité ODBC).

Remarques :

Lorsque vous appliquez Essbase 21.8 OPatch, les versions antérieures du pilote ODBC (par exemple, 7.1.6 ou 5.3) sont supprimées. Elles ne sont pas prises en charge pour Essbase 21.8 et ne fonctionneront pas.

Essbase 21.8 est fourni uniquement avec ces versions de pilote ODBC DataDirect, et seules ces versions sont prises en charge :

[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

Après avoir appliqué Essbase 21.8 OPatch,

Vous devez mettre à jour manuellement votre configuration ODBC (s'applique à la fois à Linux et à Windows).
Oracle recommande de sauvegarder manuellement vos configurations ODBC pour les anciens pilotes de la version 7.1.6, au cas où vous deviez revenir à une version précédente d'Essbase qui utilise ces pilotes.

Instructions Linux

Avant de commencer, notez l'emplacement des anciennes configurations de pilote 7.1.6 sur le domaine de serveur Essbase :

odbc.ini, situé dans

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

odbcinst.ini, situé dans

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

Bibliothèques de pilotes ODBC, situées dans
```
<Essbase Product Home>/modules/
```

Si Essbase est en cours d'exécution, arrêtez les serveurs, comme décrit dans Démarrer, arrêter et vérifier les serveurs.
Créez une copie de sauvegarde de vos anciennes configurations de pilote 7.1.6 : odbc.ini (obligatoire) et odbcinst.ini (obligatoire si vous utilisez des pilotes tiers tels que Teradata).
Remarques :
Pour éviter tout écrasement accidentel, assurez-vous que vos sauvegardes de configuration de pilote 7.1.6 sont enregistrées quelque part en dehors de
```
<Essbase Product Home>/modules/
```
Exemples :
```
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
```
Appliquez Essbase 21.8 OPatch (comme décrit dans la section Patch and Roll Back).
Ouvrez odbc.ini pour la modifier.

Remplacez les anciens noms de pilote par les nouveaux, en fournissant le chemin absolu de la bibliothèque dans l'entrée Nom du pilote. Par exemple, (remplacez Oracle_HOME par le chemin Oracle_HOME de votre système) :

Changer

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

Changer

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

Changer

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

(Facultatif) Remplacez les anciennes descriptions de pilote par de nouvelles.
- Modifiez Oracle 7.1 SQL Server Wire Protocol en Oracle 8.0 SQL Server Wire Protocol.
- Modifiez Oracle 7.1 DB2 Wire Protocol Driver en Oracle 8.0 DB2 Wire Protocol Driver.
- Modifiez Oracle 7.1 MySQL Wire Protocol en Oracle 8.0 MySQL Wire Protocol.
Enregistrez odbc.ini.
Modifiez le fichier odbcinst.ini, <Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/odbcinst.ini.

Par exemple pour DB2

(remplacez Oracle_HOME par le chemin Oracle_HOME de votre système) :
```
Driver=<Oracle_HOME>/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/Ardb228.so
```
Exemple pour Teradata

Copiez et collez les entrées associées à Teradata à partir du fichier de sauvegarde, <Oracle_HOME>/odbcinst.ini_orig, ajoutez les informations relatives au pilote ODBC Teradata à 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
```
Enregistrez odbcinst.ini.
Démarrez Essbase, comme décrit dans Démarrer, arrêter et vérifier les serveurs.

Remarques :

Si vous avez besoin d'annuler (rollback) Essbase 21.8 OPatch, vous devrez également restaurer votre fichier de sauvegarde odbc.ini (et odbcinst.ini, si vous utilisez des pilotes tiers tels que Teradata). Par exemple :

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

Instructions Windows

Sous Windows, les DSN système précédemment configurés, comme décrit dans la section Configure the ODBC Source of Data (Windows), ne fonctionneront pas après l'application d'OPatch Essbase 21.8. Vous devez reconfigurer le DSN du système pour utiliser les pilotes 8.0.2.

Si Essbase est en cours d'exécution, arrêtez les serveurs, comme décrit dans Démarrer, arrêter et vérifier les serveurs.
Appliquez Essbase 21.8 OPatch (comme décrit dans la section Patch and Roll Back).
Sur le serveur Windows Essbase, ouvrez l'éditeur de registre Windows (dans le menu Démarrer, exécutez regedit).
Accédez à Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI.
Cliquez avec le bouton droit de la souris sur ODBC.INI et sélectionnez Export. Enregistrez-la en tant que sauvegarde, au cas où vous auriez besoin d'annuler (rollback) OPatch. Par exemple, enregistrez la configuration sous le nom odbc.orig.reg.
Accédez à Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI.
Cliquez avec le bouton droit de la souris sur ODBCINST.INI et sélectionnez Exporter. Enregistrez-la en tant que sauvegarde, au cas où vous auriez besoin d'annuler (rollback) OPatch. Par exemple, enregistrez la configuration sous le nom odbcini.orig.reg.
Accédez à Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\ODBC Data Sources.
Pour l'entrée nommée essbase_datasource, cliquez avec le bouton droit de la souris et sélectionnez Modifier.

Changer
- Oracle 7.1 SQL Server Wire Protocol
  
  to
  
  Oracle 8.0 SQL Server Wire Protocol
- Changer
  
  Oracle 7.1 DB2 Wire Protocol Driver
  
  to
  
  Oracle 8.0 DB2 Wire Protocol Driver
- Changer
  
  Oracle 7.1 MySQL Wire Protocol
  
  to
  
  Oracle 8.0 MySQL Wire Protocol
Sur le serveur Windows Essbase, accédez à <ESSBASE_PRODUCT_HOME>\modules\oracle.essbase.datadirect.odbc\8.0.2.
Créez une copie de sauvegarde de ODBC802.reg (par exemple, ODBC802_orig.reg).
Modifiez ODBC802.reg en remplaçant toutes les occurrences de $ODBC_PATH par le chemin absolu des pilotes ODBC, par exemple C:\\Oracle\\Middleware\\Oracle_Home\\essbase\\modules\\oracle.essbase.datadirect.odbc\\.
Cliquez deux fois sur le fichier ODBC802.reg modifié. Cela modifiera le registre Windows pour qu'il comporte des entrées pour les pilotes DataDirect 8.0.2 fournis avec Essbase 21.8.
Démarrez Essbase, comme décrit dans Démarrer, arrêter et vérifier les serveurs.

Remarques :

Si vous avez besoin d'annuler (rollback) Essbase 21.8 OPatch, vous devrez également restaurer vos entrées de registre Windows ODBC.INI et ODBCINST.INI de sauvegarde. Par exemple, supprimez l'entrée ODBC.INI de regedit, puis cliquez deux fois sur odbc.orig.reg pour restaurer l'entrée précédente. Vous pouvez également importer/fusionner les entrées de registre.