Oracle Instant Client sur Linux : installation et problèmes de connexion
Installer Instant Client et SQL*Plus sur Red Hat/Oracle Linux, configurer sqlnet/tnsnames, corriger ORA-01017 et auditer les échecs de connexion.
Comment installer Oracle Instant Client (paquets Basic, SQL*Plus et Tools) sur Red Hat 8 / Oracle Linux, configurer les fichiers réseau, l'environnement, et traiter quelques problèmes de connexion courants. Les variables d'environnement Windows sont listées en fin d'article.
Prérequis
SQL*Plus nécessite la bibliothèque libnsl :
yum install libnsl.so.1
yum install libnsl.so.1*64*
Télécharger les paquets depuis la page Instant Client Downloads for Linux x86-64 (zips Basic, SQL*Plus et Tools).
Installation
mkdir -p /opt/oracle
unzip -d /opt/oracle instantclient-basic-linux.x64-19.14.0.0.0dbru.zip
unzip -d /opt/oracle instantclient-sqlplus-linux.x64-19.14.0.0.0dbru.zip
unzip -d /opt/oracle instantclient-tools-linux.x64-19.14.0.0.0dbru.zip
Les archives se décompressent dans un dossier instantclient_19_14 (adapter le nom à la version téléchargée). Vérifier le contenu :
cd /opt/oracle/instantclient_19_14 && find . -type f | sort
On doit notamment trouver sqlplus, adrci, libclntsh.so.*, libsqlplus.so, ojdbc8.jar et network/admin/README.
Fichiers de configuration réseau
Créer le dossier network/admin et les fichiers ldap.ora (optionnel, pour la résolution par annuaire), sqlnet.ora et tnsnames.ora. Un jeu par utilisateur système qui utilise le client.
echo ${USER}
date=$(date '+%Y%m%d%H%M%S')
mkdir -p /opt/oracle/instantclient_19_14/network/admin
ldap.ora :
cat > /opt/oracle/instantclient_19_14/network/admin/ldap.ora <<EOF
# last modif : ${date}
DIRECTORY_SERVERS = (ldap1.example.com:389, ldap2.example.com:389)
DEFAULT_ADMIN_CONTEXT = "dc=example,dc=com"
DIRECTORY_SERVER_TYPE = OID
EOF
sqlnet.ora :
cat > /opt/oracle/instantclient_19_14/network/admin/sqlnet.ora <<EOF
# last modif : ${date}
NAMES.DIRECTORY_PATH= (TNSNAMES, LDAP)
AUTOMATIC_IPC = OFF
TRACE_LEVEL_CLIENT = OFF
sqlnet.expire_time=5
EOF
tnsnames.ora :
cat > /opt/oracle/instantclient_19_14/network/admin/tnsnames.ora <<EOF
# last modif : ${date}
ORCL =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = dbserver01)(PORT = 1521))
)
(CONNECT_DATA =
(SID = ORCL)
)
)
EOF
Environnement utilisateur
Créer un petit script d'environnement dans la session de l'utilisateur (sudo su - <utilisateur>) et le charger depuis ~/.bashrc :
mkdir -p /home/${USER}/scripts
cat > /home/${USER}/scripts/setEnv.sh <<'EOF'
export ORACLE_HOME=/opt/oracle/instantclient_19_14
export LD_LIBRARY_PATH="$ORACLE_HOME":$LD_LIBRARY_PATH
export PATH=$ORACLE_HOME:$PATH
export TNS_ADMIN=$ORACLE_HOME/network/admin
EOF
Test :
source ~/.bashrc
sqlplus -V
ORA-01017 entre clients Oracle 12c et 19c (sensibilité à la casse du mot de passe)
Côté serveur, modifier $ORACLE_HOME/network/admin/sqlnet.ora et ajouter :
SQLNET.ALLOWED_LOGON_VERSION_SERVER=8
Ensuite, en SYSDBA, réinitialiser le compte et assouplir le profil par défaut si nécessaire :
alter user app_user password expire;
alter user app_user identified by '<PASSWORD>' account unlock;
ALTER PROFILE DEFAULT LIMIT PASSWORD_LIFE_TIME UNLIMITED;
ALTER PROFILE DEFAULT LIMIT FAILED_LOGIN_ATTEMPTS UNLIMITED;
select USERNAME, ACCOUNT_STATUS from dba_users where username='APP_USER';
SELECT resource_name, limit FROM dba_profiles WHERE profile = 'DEFAULT' AND resource_type = 'PASSWORD';
alter user <your_username> account unlock;
Références : ORA-01017 expliqué et les paramètres sqlnet.ora d'Oracle.
Auditer les échecs de connexion
Pour retrouver l'origine des tentatives de connexion échouées (voir cet article) :
show parameter audit_trail
alter system set audit_trail=db,extended scope=spfile;
audit session whenever not successful;
set linesize 400
set pagesize 10000
col ntimestamp# for a30 heading "Timestamp"
col userid for a20 heading "Username"
col userhost for a15 heading "Machine"
col spare1 for a15 heading "OS User"
col comment$text for a80 heading "Details" wrap
select ntimestamp#, userid, userhost, spare1, comment$text from sys.aud$ where returncode=1017 order by 1;
Le changement de audit_trail dans le spfile prend effet après un redémarrage de l'instance. Pour désactiver l'audit :
NOAUDIT SESSION;
Windows
Variables d'environnement (exemple avec Instant Client 21.6) :
| Variable | Valeur |
|---|---|
ORACLE_HOME |
C:\oracle\instantclient_21_6 |
PATH |
ajouter C:\oracle\instantclient_21_6 (séparateur ;) |
TNS_ADMIN |
C:\oracle\instantclient_21_6\network\admin |
Pour un client 64 bits, clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ORACLE\KEY_<nom du home> :
| Valeur | Donnée |
|---|---|
NLS_LANG |
AMERICAN_AMERICA.WE8MSWIN1252 |
ORACLE_HOME |
C:\oracle\instantclient_21_6 |
ORACLE_HOME_NAME |
instantclient_21_6 |
Autres emplacements de registre Oracle : HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE et HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services. Pour pointer une seule session cmd vers un autre dossier TNS : set tns_admin=c:\temp.
Remarques
- Le nom du dossier Instant Client doit correspondre à la version téléchargée ; adapter les chemins.
- Ne pas laisser de mots de passe dans les scripts ; la valeur
<PASSWORD>ci-dessus est un espace réservé. - Mettre
PASSWORD_LIFE_TIMEetFAILED_LOGIN_ATTEMPTSà UNLIMITED réduit la sécurité ; à réserver aux environnements de test.