LLI Wiki — My Digital Knowledge Base

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.

Page de téléchargement Oracle Instant Client : paquets Basic, SQL*Plus et Tools (ZIP)

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.

Variables d'environnement Windows pour Oracle Instant Client

Registre Windows : clé ORACLE avec ORACLE_HOME et TNS_ADMIN

Remarques

Mastodon LLIMastodon SocialFosstodon