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 pack d’installation d’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. 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éperto
Nom du pilote pour identifier le pilote Oracle ODBC résidant dans le répertoire d’accu
Driver_Name*
d’Oracle Instant Client. Le nom par défaut sera du type "pilote Oracle 19c ODB
DSN* Définit le nom ODBC DSN. Le nom par défaut sera "OracleODBC-19c"
Chemin de répertoire du fichier .odbc.ini. Le chemin par défaut est le répertoire d’a
ODBCINI*
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 Windo
libsqora.so.XX.Y. For example
Bibliothèque partagée du pilote ODBC Oracle sqora32
libsqora.so.19.1
odbc_insta
Fichier d’installation odbc_update_ini.sh
odbc_unins
Fenêtre de dialogue de configuration du pilote sqoras32.dll, s
Non disponible
ODBC Oracle (GUI) sqresja.
Système d’aide help/ help/
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 la 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 du pack 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 du pack 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 la bibliothèque partagée du pilote ODBC : sqora32.dll, sqoras32.dll, sqresus.dll, sqresja.dll

 Fichiers supplémentaires requis lors de l’utilisation du pack Oracle Basic Instant Client :
Pour 19c : oraociei19.dll, orannzsbb19.dll, oci.dll, oraons.dll, ociw32.dll, oraociei19.sym, orannzsbb19.sym, oci.sym, ociw32.sym
Pour 18c : oraociei18.dll, orannzsbb18.dll, oci.dll, oraons.dll, ociw32.dll, oraociei18.sym, orannzsbb18.sym, oci.sym, ociw32.sym
Pour 12c : oraociei12.dll, orannzsbb12.dll, oci.dll, oraons.dll, ociw32.dll, oraociei12.sym, orannzsbb12.sym, oci.sym, ociw32.sym
Pour 11g : oraociei11.dll, orannzsbb11.dll, oci.dll, ociw32.dll, oraociei11.sym, orannzsbb11.sym, oci.sym, ociw32.sym
 Fichiers supplémentaires requis lors de l’utilisation du pack Oracle Basic Light Instant Client :
Pour 19c : oraociicus19.dll, orannzsbb19.dll, oci.dll, oraons.dll, ociw32.dll, oraociicus19.sym, orannzsbb19.sym, oci.sym, ociw32.sym
Pour 18c : oraociicus18.dll, orannzsbb18.dll, oci.dll, oraons.dll, ociw32.dll, oraociicus18.sym, orannzsbb18.sym, oci.sym, ociw32.sym
Pour 12c : oraociicus12.dll, orannzsbb12.dll, oci.dll, oraons.dll, ociw32.dll, oraociicus12.sym, orannzsbb12.sym, oci.sym, ociw32.sym
Pour 11g : oraociicus11.dll, orannzsbb11.dll, oci.dll, ociw32.dll, oraociicus11.sym, orannzsbb11.sym, oci.sym, ociw32.sym
Remarque : Lors de la copie du correctif Oracle Database Bundle, il est possible que certains des fichiers ci-dessus soient 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 unixODB

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 unixODB

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 unixODB

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
 Oracle Instant Client - Télécharger ODBC
 Interfaces Oracle C et C++ - page d’accueil
 Utilisation du Oracle ODBC Driver - Guide de développement de base de données
 Oracle ODBC - Forum de discussion
 Notes de version du pilote ODBC - Informations relatives aux versions
Technologies liées
 Langages de script - Utilisation de Node.js, PHP, Python et Ruby avec Oracle Database
 Oracle Database 12c Application Development - Plus de technologies
 VirtualBox - Virtualisation de bureau
 VM de développement d’applications de base de données - Ordinateur virtuel VirtualBox préconfiguré avec Oracle Database 12c installé
 Oracle Database Cloud Service - Service de base de données Cloud prenant en charge une charge de travail de toute taille
 Oracle Databasec et Oracle Database "XE" Express Edition - Téléchargements gratuits pour les développeurs
 Oracle Linux - Serveur de référentiels yum gratuit, avec les derniers errata