Notes d’installation d’Oracle Instant Client ODBC

Le logiciel Oracle Instant Client ODBC est un pack autonome qui offre toutes les fonctionnalités d’Oracle ODBC Driver (à l’exception du service Oracle Services for Microsoft Transaction Server) avec une installation simple.

Le pilote ODBC présente l’interopérabilité de la version client-serveur standard d’Oracle, consultez l’ID de document de support 207303.1. Par exemple, Instant Client ODBC 19c peut se connecter à Oracle Database 11.2 ou version ultérieure.

Installation d’Oracle Instant Client Basic et Basic Light

Instant Client ODBC requiert également l’installation du pack Oracle Instant Client Basic ou Basic Light (en fonction des exigences de votre pays). À partir d’OTN, téléchargez le pack souhaité pour votre système d’exploitation et suivez les instructions d’installation de la page de téléchargement. Par exemple, décompressez le pack pour C:\instantclient_19_3sous Windows, décompressez /opt/oracle/instantclient_19_3sur Linux ou d’autres plateformes, ou utilisez yum pour installer les packs RPM sous Linux.

Plus de détails sur Oracle Instant Client sont disponibles dans le Guide du programmeur Oracle Call Interface.

Installation d’Oracle Instant Client ODBC

Sous Linux et UNIX

1. Téléchargez le package d'installation d'Instant Client Basic ou Basic Light comme décrit ci-dessus.

2. Téléchargez le package Instant Client ODBC. Décompressez-le dans le même répertoire que votre pack Basic ou Basic Light. Ou, si vous utilisez le pack RPM sous Linux, installez-le avec yum.

3. Installez le gestionnaire de pilotes unixODBC s'il n'est pas déjà disponible. Pour plus d’informations, consultez la section "Version recommandée du gestionnaire de pilotes unixODBC" de ce document.

4. Exécutez odbc_update_ini.sh à partir du répertoire Instant Client.

5. Définissez les variables de globalisation Oracle requises pour vos paramètres régionaux. Pour plus d’informations, consultez le Guide de support Oracle Database Globalization. Par exemple, sous Linux, vous pouvez définir export NLS_LANG=JAPANESE_JAPAN.JA16EUC de sorte à utiliser le caractère JA16EUC en japonais.

Utilisation : odbc_update_ini.sh <ODBCDM_Home> [<Install_Location> <Driver_Name> <DSN> <ODBCINI>]

Paramètre Description
ODBCDM_Home Chemin d’accès au répertoire d’accueil du gestionnaire de pilotes unixODBC
Install_Location* Chemin d’accès au répertoire Oracle Instant Client. Le chemin par défaut est le répertoire courant
Driver_Name* Nom du pilote pour identifier le pilote Oracle ODBC résidant dans le répertoire d’accueil actuel d’Oracle Instant Client. Le nom par défaut sera du type "pilote Oracle 19c ODBC"
DSN* Définit le nom ODBC DSN. Le nom par défaut sera "OracleODBC-19c"
ODBCINI* Chemin de répertoire du fichier .odbc.ini. Le chemin par défaut est le répertoire d’accueil de l’utilisateur, par exemple, ~/.odbc.ini

* - Paramètres facultatifs

Sous Windows :

  1. Installez le pack Instant Client Basic ou Basic Light, comme décrit ci-dessus.
  2. Téléchargez le pack Instant Client ODBC. Décompressez-le dans le même répertoire que votre pack Basic ou Basic Light.
  3. Exécutez odbc_install.exe à partir du répertoire Instant Client. Si la version d’Instant Client est égale ou antérieure à la version 11g, lancez l’invite de commande en tant qu’administrateur. Pour effectuer une installation avec une prise en charge de la langue japonaise, exécutez la commande odbc_install.exe JA.

Configuration de l’environnement pour les applications ODBC

Une application ODBC doit charger le fichier de bibliothèque partagée du pilote ODBC Oracle Instant Client (voir la section suivante) pour se connecter à Oracle Database. Sous Linux/Unix, le chemin du répertoire de la bibliothèque partagée doit être défini dans la variable d’environnement LD_LIBRARY_PATH ou son équivalent sur la plate-forme. Il peut également être configuré dans /etc/ld.so.conf. Sous Windows, il doit être défini dans la variable d’environnement PATH.

Reportez-vous aux rubriques Variables d’environnement pour OCI Instant Client et Chaînes de connexion à la base de données pour Instant Client' dans le Guide du programmeur Oracle Call Interface pour la configuration de la chaîne de connexion à la base de données et des variables d’environnement associées telles que TWO_ADMIN, TWO_TASK, LOCAL, etc.

Contenu du pack ODBC Oracle Instant Client

Description Linux et UNIX Windows
Bibliothèque partagée du pilote ODBC Oracle libsqora.so.XX.Y. Par exemple : libsqora.so.19.1 sqora32.dll
Fichier d’installation odbc_update_ini.sh odbc_install.exe, odbc_uninstall.exe
Fenêtre de dialogue de configuration du pilote ODBC Oracle (GUI) Non disponible sqoras32.dll, sqresus.dll, sqresja.dll
Système d’aide aide/ aide/

Correction d’Oracle Instant Client ODBC

Remarque : Sauvegardez la bibliothèque partagée du pilote ODBC Oracle et d'autres fichiers avant de les corriger.

Sous Linux et UNIX Vous pouvez corriger le pilote ODBC Instant Client sous Linux/UNIX en générant les packs ODBC, Basic et Basic Light d’Instant Client dans un répertoire d’accueil ORACLE_HOME corrigé. La procédure de correction et de génération des packs ODBC, Basic et Basic Light d’Instant Client est décrite dans le Guide du programmeur Oracle Call Interface. Ces nouveaux packs doivent ensuite être décompressés dans le répertoire Instant Client à corriger. Cette méthode de correction est recommandée.

Le pilote ODBC Oracle Instant Client peut également être corrigé en copiant les fichiers répertoriés ci-dessous à partir d’un répertoire ORACLE_HOME corrigé :

  • Fichier de bibliothèque partagée du pilote ODBC :
    Pour 19c : libsqora.so.19.1
    Pour 18c : libsqora.so.18.1
    Pour 12c : libsqora.so.12.1
    Pour 11g : libsqora.so.11.1
  • Fichiers supplémentaires requis lors de l'utilisation d'Oracle Instant Client Basic :
    Pour 19c : libociei.so, libclntshcore.so.19.1, libclntsh.so.19.1, libnnz19.so, libons.so
    Pour 18c : libociei.so, libclntshcore.so.18.1, libclntsh.so.18.1, libnnz18.so, libons.so
    Pour 12c : libociei.so, libclntshcore.so.12.1, libclntsh.so.12.1, libnnz12.so, libons.so
    Pour 11g : libclntsh.so.11.1, libociei.so, libnnz11.so
  • Fichiers supplémentaires requis lors de l'utilisation de Oracle Instant Client Basic Light :
    Pour 19c : libclntsh.so.19.1, libclntshcore.so.19.1, libociicus.so, libnnz19.so, libons.so
    Pour 18c : libclntsh.so.18.1, libclntshcore.so.18.1, libociicus.so, libnnz18.so, libons.so
    Pour 12c : libclntsh.so.12.1, libclntshcore.so.12.1, libociicus.so, libnnz12.so, libons.so
    Pour 11g : libclntsh.so.11.1, libociicus.so, libnnz11.so
 

Sous Windows Le correctif du pilote ODBC Instant Client sous Windows ne peut être effectué qu’en copiant manuellement les fichiers de bibliothèque partagée du pilote ODBC et en prenant en charge les fichiers de bibliothèque à partir d’un répertoire ORACLE_HOME corrigé ou d’un correctif Oracle Database Bundle non compressé. Ceux-ci doivent être copiés dans le répertoire Instant Client. La génération d’un pack ODBC Instant Client n’est pas disponible sous Windows.

Les fichiers à copier dans le répertoire Instant Client :

  • Fichiers de bibliothèque partagés du pilote ODBC : sqora32.dll, sqoras32.dll, sqresus.dll, sqresja.dll
  • Required additional files when using Oracle Basic Instant Client:
    For 19c: oraociei19.dll, orannzsbb19.dll, oci.dll, oraons.dll, ociw32.dll, oraociei19.sym, orannzsbb19.sym, oci.sym, ociw32.sym
    For 18c: oraociei18.dll, orannzsbb18.dll, oci.dll, oraons.dll, ociw32.dll, oraociei18.sym, orannzsbb18.sym, oci.sym, ociw32.sym
    For 12c: oraociei12.dll, orannzsbb12.dll, oci.dll, oraons.dll, ociw32.dll, oraociei12.sym, orannzsbb12.sym, oci.sym, ociw32.sym
    For 11g: oraociei11.dll, orannzsbb11.dll, oci.dll, ociw32.dll, oraociei11.sym, orannzsbb11.sym, oci.sym, ociw32.sym
  • Required additional files when using Oracle Basic Light Instant Client:
    For 19c: oraociicus19.dll, orannzsbb19.dll, oci.dll, oraons.dll, ociw32.dll, oraociicus19.sym, orannzsbb19.sym, oci.sym, ociw32.sym
    For 18c: oraociicus18.dll, orannzsbb18.dll, oci.dll, oraons.dll, ociw32.dll, oraociicus18.sym, orannzsbb18.sym, oci.sym, ociw32.sym
    For 12c: oraociicus12.dll, orannzsbb12.dll, oci.dll, oraons.dll, ociw32.dll, oraociicus12.sym, orannzsbb12.sym, oci.sym, ociw32.sym
    For 11g: oraociicus11.dll, orannzsbb11.dll, oci.dll, ociw32.dll, oraociicus11.sym, orannzsbb11.sym, oci.sym, ociw32.sym

Remarque : lors de la copie du patch Oracle Database Bundle, certains des fichiers ci-dessus peuvent être manquants. Cela implique que ces fichiers sont inchangés et qu’il n’est pas nécessaire de les corriger.

Désinstallation d’Oracle ODBC Instant Client

Sous Linux et UNIX

La procédure de désinstallation d’Instant Client ODBC sous Linux/UNIX est la suivante :

  1. Supprimez l’entrée du pilote Oracle ODBC du fichier odbcinst.ini du gestionnaire de pilotes unixODBC. Le nom par défaut de cette entrée est du type [Oracle 19c ODBC driver].
  2. Supprimez l’entrée DSN du pilote Oracle ODBC du fichier odbc.ini. Le nom par défaut de l’entrée DSN est du type [OracleODBC-19c].
  3. Supprimez tous les fichiers et répertoires du répertoire ODBC Instant Client.
 

Sous Windows :

La procédure pour désinstaller Instant Client ODBC sous Windows est la suivante :

  1. Supprimez le DSN associé au pilote ODBC Oracle dans la console ODBC Data Source Administrator (odbcad32).
  2. Exécutez odbc_uninstall.exe à partir du répertoire Instant Client ODBC.
  3. Supprimez tous les fichiers et répertoires du répertoire ODBC Instant Client.

Versions recommandées du gestionnaire de pilotes unixODBC pour Linux/UNIX

Pour Instant Client 18 et 19 :

Plateforme Version du gestionnaire de pilotes unixODBC
Linux 32 bits, 64 bits 2.3.4
Solaris SPARC64 32 bits, 64 bits 2.3.4
Solaris 32 bits, 64 bits 2.3.4
AIX 5L 32 bits, 64 bits 2.3.4
HP IA64 32 bits, 64 bits 2.3.4
z/Linux 31 bits, 64 bits 2.3.4

Pour Instant Client 12.1 et 12.2 :

Plateforme Version du gestionnaire de pilotes unixODBC
Linux 32 bits, 64 bits 2.3.1
Solaris SPARC64 32 bits, 64 bits 2.3.1
Solaris 32 bits, 64 bits 2.3.1
AIX 5L 32 bits, 64 bits 2.3.1
HP IA64 32 bits, 64 bits 2.3.1
z/Linux 31 bits, 64 bits 2.3.1

Pour Instant Client 11g :

Plateforme Version du gestionnaire de pilotes unixODBC
Linux 32 bits, 64 bits 2.2.11, 2.2.14
Solaris SPARC64 32 bits, 64 bits 2.2.11
Solaris 32 bits, 64 bits 2.2.11
AIX 5L 32 bits, 64 bits 2.2.11
HP IA64 32 bits, 64 bits 2.2.11
z/Linux 31 bits, 64 bits 2.2.11

Ressources Oracle ODBC Driver

Technologies liées