Configuration Oracle SQLNet — Guide Complet
ORACLE DATABASE
Configuration Oracle SQLNet
Guide complet — Installation, paramétrage et résultats attendus
[Link] • [Link] • [Link]
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
1. Présentation de Oracle SQLNet
Oracle SQLNet (Oracle Net Services) est la couche réseau qui permet la communication
entre un client Oracle et un serveur de base de données. Il abstrait le protocole réseau
sous-jacent (TCP/IP, IPC) et fournit des services de résolution de noms, d'authentification et
de chiffrement.
1.1 Architecture
La communication s'effectue en trois couches :
• Client Oracle : application, SQL*Plus, JDBC, ODBC
• Couche SQLNet : résolution, authentification, chiffrement
• Serveur Oracle : instance DB + listener
1.2 Fichiers de configuration
• [Link] — contrôle global : résolution de noms, sécurité, timeouts
• [Link] — répertoire des alias de connexion (TNS)
• [Link] — configuration du processus listener
Emplacement par défaut : $ORACLE_HOME/network/admin/
Depuis Oracle 11g, l'enregistrement dynamique des services est recommandé — le
NOTE
[Link] peut être minimal ou absent.
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
2. Prérequis & Environnement
2.1 Systèmes supportés
• Linux (RHEL, OEL, SUSE, Ubuntu)
• Windows Server 2016/2019/2022
• AIX, Solaris, HP-UX
2.2 Variables d'environnement
Ces variables doivent être définies dans le profil de l'utilisateur oracle :
export ORACLE_HOME=/u01/app/oracle/product/19c/dbhome_1
export ORACLE_SID=ORCL
export PATH=$ORACLE_HOME/bin:$PATH
export TNS_ADMIN=$ORACLE_HOME/network/admin
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
2.3 Résultat attendu
Après avoir sourcé le profil :
source ~/.bash_profile
$ echo $ORACLE_HOME
/u01/app/oracle/product/19c/dbhome_1
$ echo $TNS_ADMIN
/u01/app/oracle/product/19c/dbhome_1/network/admin
$ sqlplus -V
SQL*Plus: Release [Link].0 - Production
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
3. Configuration de [Link]
Le fichier [Link] contrôle le comportement global d'Oracle Net côté client et serveur. Il
est lu au démarrage de chaque processus Oracle.
3.1 Contenu du fichier
# ============================================================
# [Link] — $ORACLE_HOME/network/admin/[Link]
# ============================================================
# Ordre de résolution des alias de connexion
NAMES.DIRECTORY_PATH = (TNSNAMES, EZCONNECT)
# Détection des connexions inactives (minutes, 0=désactivé)
SQLNET.EXPIRE_TIME = 10
# Authentification OS (NTS=Windows, NONE=désactivé)
SQLNET.AUTHENTICATION_SERVICES = (NTS)
# Timeout de connexion (secondes)
TCP.CONNECT_TIMEOUT = 30
# Logs réseau (OFF / USER / ADMIN / SUPPORT)
TRACE_LEVEL_CLIENT = OFF
LOG_DIRECTORY_CLIENT = /u01/app/oracle/diag/clients
# Chiffrement (REQUIRED / REQUESTED / ACCEPTED / REJECTED)
SQLNET.ENCRYPTION_CLIENT = REQUESTED
SQLNET.ENCRYPTION_TYPES_CLIENT = (AES256, AES128)
3.2 Paramètres clés
Paramètre Valeur exemple Description
NAMES.DIRECTORY_PATH (TNSNAMES,EZCON Ordre de résolution : fichier local puis syntaxe directe
NECT)
SQLNET.EXPIRE_TIME 10 Intervalle en minutes pour la détection de connexions
mortes
SQLNET.AUTHENTICATION_S (NTS) Mécanisme d'auth OS (Windows=NTS, Linux=mettre
ERVICES NONE si non requis)
TCP.CONNECT_TIMEOUT 30 Abandon de la tentative de connexion après N
secondes
SQLNET.ENCRYPTION_CLIEN REQUESTED Chiffrement négocié si le serveur le supporte
T
3.3 Résultat attendu
Le fichier [Link] est lu silencieusement. La validation se fait en tentant une connexion :
sqlplus / as sysdba
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
SQL*Plus: Release [Link].0 - Production on Wed May 13 09:00:00 2026
Copyright (c) 1982, 2019, Oracle. All rights reserved.
Connected to:
Oracle Database 19c Enterprise Edition Release [Link].0
SQL>
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
4. Configuration de [Link]
Le fichier [Link] mappe des alias lisibles (noms TNS) vers les paramètres de
connexion complets (hôte, port, service).
4.1 Syntaxe de base
# ============================================================
# [Link] — $ORACLE_HOME/network/admin/[Link]
# ============================================================
ORCL =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS =
(PROTOCOL = TCP)
(HOST = [Link])
(PORT = 1521)
)
)
(CONNECT_DATA =
(SERVICE_NAME = ORCL)
)
)
4.2 Alias avec failover (RAC / Data Guard)
ORCL_FAILOVER =
(DESCRIPTION =
(FAILOVER = ON)
(LOAD_BALANCE = OFF)
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL=TCP)(HOST=[Link])(PORT=1521))
(ADDRESS = (PROTOCOL=TCP)(HOST=[Link])(PORT=1521))
)
(CONNECT_DATA =
(SERVICE_NAME = ORCL)
(FAILOVER_MODE =
(TYPE = SELECT)
(METHOD = BASIC)
(RETRIES = 5)
(DELAY = 5)
)
)
)
4.3 Résultat attendu — tnsping
tnsping ORCL
TNS Ping Utility for Linux: Version [Link].0 - Production
Copyright (c) 1997, 2019, Oracle. All rights reserved.
Used parameter files: /u01/.../network/admin/[Link]
Used TNSNAMES adapter to resolve the alias
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
Attempting to contact (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=[Link])
(PORT=1521))...)
OK (10 msec)
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
5. Configuration de [Link]
Le listener est le processus serveur qui accepte les connexions entrantes des clients Oracle.
Il écoute sur un port TCP (1521 par défaut) et redirige vers l'instance DB appropriée.
5.1 Configuration complète
# ============================================================
# [Link] — $ORACLE_HOME/network/admin/[Link]
# ============================================================
LISTENER =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = [Link])(PORT = 1521))
(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))
)
)
# Enregistrement statique (facultatif avec Oracle 11g+)
SID_LIST_LISTENER =
(SID_LIST =
(SID_DESC =
(GLOBAL_DBNAME = ORCL)
(ORACLE_HOME = /u01/app/oracle/product/19c/dbhome_1)
(SID_NAME = ORCL)
)
)
# Paramètres de logging
LOGGING_LISTENER = ON
LOG_FILE_LISTENER = /u01/app/oracle/diag/tnslsnr/[Link]
LOG_DIRECTORY_LISTENER = /u01/app/oracle/diag/tnslsnr
5.2 Points d'attention
• HOST doit correspondre exactement à la sortie de hostname -f sur le serveur
• Le SID_LIST est optionnel si l'enregistrement dynamique (ALTER SYSTEM
REGISTER) est utilisé
• IPC (KEY=EXTPROC1521) est requis pour les procédures externes (extproc)
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
6. Démarrage & Gestion du Listener
6.1 Commandes lsnrctl
# Démarrer le listener
lsnrctl start
# Vérifier le statut détaillé
lsnrctl status
# Recharger la configuration sans redémarrage
lsnrctl reload
# Arrêter proprement
lsnrctl stop
# Lister les services enregistrés
lsnrctl services
6.2 Résultat attendu — lsnrctl start
LSNRCTL for Linux: Version [Link].0 - Production on 13-MAY-2026
Copyright (c) 1991, 2019, Oracle. All rights reserved.
Starting /u01/app/oracle/product/19c/dbhome_1/bin/tnslsnr: please wait...
TNSLSNR for Linux: Version [Link].0 - Production
System parameter file: /u01/.../network/admin/[Link]
Listening on: (DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=[Link])
(PORT=1521)))
Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=[Link])
(PORT=1521)))
STATUS of the LISTENER
------------------------
Alias LISTENER
Version TNSLSNR for Linux: Version [Link].0
Start Date 13-MAY-2026 09:00:00
Uptime 0 days 0 hr. 0 min. 2 sec
Security ON: Local OS Authentication
Services Summary...
Service "ORCL" has 1 instance(s).
Instance "ORCL", status READY, has 1 handler(s) for this service...
The command completed successfully
6.3 Enregistrement dynamique (Oracle 11g+)
sqlplus / as sysdba
SQL> ALTER SYSTEM SET LOCAL_LISTENER=
'(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=[Link])(PORT=1521)))'
SCOPE=BOTH;
SQL> ALTER SYSTEM REGISTER;
System altered.
System altered.
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
7. Test de Connexion Complet
7.1 tnsping — test de résolution
tnsping ORCL
OK (10 msec)
7.2 sqlplus — connexion distante
# Via alias TNS
sqlplus scott/tiger@ORCL
# Via EZConnect (sans tnsnames)
sqlplus scott/tiger@[Link]/ORCL
Connected to:
Oracle Database 19c Enterprise Edition Release [Link].0
SQL>
7.3 Vérification de l'instance
sqlplus / as sysdba
SQL> SELECT instance_name, status, database_status FROM v$instance;
INSTANCE_NAME STATUS DATABASE_STATUS
---------------- ------------ -----------------
ORCL OPEN ACTIVE
7.4 Vérification du port
# Linux
netstat -tlnp | grep 1521
# ou
ss -tlnp | grep 1521
tcp 0 0 [Link]:1521 [Link]:* LISTEN 12345/tnslsnr
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
8. Dépannage & Erreurs Courantes
Tableau récapitulatif des erreurs Oracle Net les plus fréquentes :
Code Erreur Message Cause Solution
ORA-12541 TNS: no listener Listener non démarré ou port lsnrctl start firewall-cmd --add-
1521 bloqué par firewall port=1521/tcp netstat -tlnp | grep
1521
ORA-12154 TNS: could not Alias introuvable dans echo $TNS_ADMIN tnsping
resolve identifier [Link] ou TNS_ADMIN ORCL Vérifier l'orthographe de
incorrect l'alias
ORA-12514 Listener: service SERVICE_NAME non enregistré lsnrctl status ALTER SYSTEM
inconnu auprès du listener REGISTER; Vérifier
SERVICE_NAME
ORA-12170 TNS: Connect Firewall bloque le port ou HOST telnet [Link] 1521
timeout incorrect Vérifier HOST dans
[Link]
ORA-01017 Identifiant/mot de Mauvaises credentials ou case- Vérifier les credentials ALTER
passe invalide sensitive password USER scott IDENTIFIED BY
tiger;
8.1 Activer les traces réseau (debug avancé)
# Dans [Link] (côté client)
TRACE_LEVEL_CLIENT = SUPPORT
TRACE_DIRECTORY_CLIENT = /tmp/oracle_trace
TRACE_FILE_CLIENT = sqlnet_client
# Analyser le fichier généré
tail -f /tmp/oracle_trace/sqlnet_client.trc
Oracle SQLNet | DBA Guide p.
Configuration Oracle SQLNet — Guide Complet
9. Récapitulatif — Checklist
• Variables d'environnement ORACLE_HOME, TNS_ADMIN, PATH définies
• [Link] créé avec NAMES.DIRECTORY_PATH et paramètres de sécurité
• [Link] créé avec alias correct (HOST, PORT, SERVICE_NAME)
• [Link] configuré avec le bon HOST (hostname -f)
• lsnrctl start exécuté sans erreur
• lsnrctl status confirme le service READY
• tnsping ORCL retourne OK
• sqlplus user/pass@ORCL se connecte sans erreur ORA-
• Port 1521 visible dans netstat / ss
• Logs listener surveillés pour détecter les erreurs futures
Automatiser le démarrage du listener avec dbstart / dbshut ou via systemd (oracle-
CONSEIL
[Link]) pour une remise en service automatique après reboot.
Oracle SQLNet | DBA Guide p.