Télécommunications SQL*Net V2 SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur GCOS 7 Logiciel Sujet : Ce document renseigne sur les noms et les positions des fichiers et utilitaires SQL*Net V2, sur la configuration sous SQL*Net V2 ; il décrit les paramètres et les descripteurs de connexion associés à la carte du protocole TCP/IP. Observations : Version du logiciel : GCOS 7 Date : Mai 1995 Bull S.A. Bull HN Information Systems Inc. CEDOC Publication Order Entry Atelier de reproduction MA30/843 331 avenue Patton BP 428 300 Concord Road 49005 ANGERS Cedex Billerica, MA 01821 FRANCE U.S.A. 47 F2 17UR Rev00
Copyright Bull S.A., 1995 Toutes les marques citées sont la propriété de leurs titulaires respectifs. Vos suggestions sur la forme et le fond de ce manuel seront les bienvenues. Une feuille destinée à recevoir vos remarques se trouve à la fin du présent manuel. La loi du 11 mars 1957, complétée par la loi du 3 juillet 1985, interdit les copies ou reproductions destinées à une utilisation collective. Toute représentation ou reproduction intégrale ou partielle faite par quelque procédé que ce soit, sans consentement de l'auteur ou de ses ayants cause, est illicite et constitue une contrefaçon sanctionnée par les articles 425 et suivants du code pénal. Ce document est fourni à titre d'information seulement. Il n'engage pas la responsabilité de Bull S.A. en cas de dommages résultant de son application. Des corrections ou modifications au contenu de ce document peuvent intervenir sans préavis ; des mises à jour ultérieures les signaleront éventuellement aux destinataires.
Préface OBJET DU MANUEL Ce document fournit des informations sur les noms et les positions des fichiers et utilitaires SQL*Net V2, sur la configuration sous SQL*Net V2 ; il décrit les paramètres et les descripteurs de connexion associés à la carte du protocole TCP/IP. UTILISATEURS CONCERNES Utilisateurs de SQL*Net V2. 47 F2 17UR Rev00 iii
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur STRUCTURE DU MANUEL Le chapitre 1 présente les fichiers et utilitaires SQL*Net V2. Le chapitre 2 décrit les cartes de protocole ORACLE. Le chapitre 3 décrit les fonctions du module d'écoute TNS et du COR V2. Le chapitre 4 fournit un exemple illustrant l'utilisation de SQL*Net V2. Un index se trouve à la fin du manuel. BIBLIOGRAPHIE Cette bibliographie est fournie à titre indicatif. Pour plus de précisions (disponibilité du manuel, numéro de révision, indice de mise à jour, veuillez vous adresser à CEDOC. SQL*Net V2 - Guide de l'administrateur... 86 F2 84CR Rev00 SQL*Net V2 Administrator's Guide...86 A2 84CR Rev00 Produits de réseau Oracle - Guide des messages d'erreur... 86 F2 85CR Rev00 Oracle Network Products Error Messages Manual...86 A2 85CR Rev00 Introduction à SQL*Net... 86 F2 86CR Rev00 Understanding SQL*Net...86 A2 86CR Rev00 iv 47 F2 17UR Rev00
Table des matières 1. Fichiers et utilitaires SQL*Net V2 - Introduction... 1-1 1.1 NOMS DES FICHIERS DE CONFIGURATION... 1-1 1.2 OUTIL DE CONFIGURATION SQL*NET... 1-1 1.3 FICHIERS SQL*NET V2... 1-2 1.3.1 TNSNAMES_ORA... 1-2 1.3.2 SQLNET_ORA... 1-3 1.3.3 LISTENER_ORA... 1-4 1.3.4 Modifications des fichiers SQL*Net V2... 1-6 1.4 LSNRCTL... 1-7 1.4.1 SYNTAXE... 1-7 1.4.2 PARAMETRES... 1-7 1.4.3 Remarques sur l'exécution de LSNRCTL... 1-8 1.5 CONFIGURATION D'UN CLIENT... 1-9 1.6 CONFIGURATION D'UN SERVEUR... 1-10 1.7 CONFIGURATION DES RÉPARTITEURS POUR DIFFÉRENTS PROTOCOLES... 1-11 47 F2 17UR Rev00 v
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur 2. Cartes de protocole ORACLE... 2-1 2.1 GÉNÉRALITÉS... 2-1 2.2 CARTE TCP/IP... 2-1 2.2.1 Fichier ETC_HOSTS... 2-2 2.2.2 Fichier ETC_SERVICES... 2-3 2.3 RÈGLE DE CONFIGURATION DE GXTI... 2-3 3. Module d'écoute TNS et COR V2 - Fonctions... 3-1 3.1 MODULE D'ÉCOUTE TNS... 3-1 3.2 COR V2... 3-2 3.3 CARTE SQLNET... 3-3 3.3.1 SYNTAXE DE SQLNET_ADAPTER... 3-3 3.3.2 PARAMETRES DE SQLNET_ADAPTER... 3-4 3.3.3 REMARQUES SUR L'EXECUTION DE SQLNET_ADAPTER... 3-4 4. Exploitation de SQL*Net V2 - Exemple... 4-1 4.1 GÉNÉRALITÉS... 4-1 4.2 CREATION DES FICHIERS DE CONFIGURATION... 4-2 4.3 CRÉATION DU FICHIER ETC_HOSTS... 4-3 4.4 CRÉATION DU FICHIER ETC_SERVICES... 4-3 4.5 LANCEMENT DE LA BASE DE DONNÉES ORACLE... 4-3 4.6 LANCEMENT DU MODULE D'ÉCOUTE TNS... 4-4 4.7 CONNEXION AU SERVEUR LOCAL... 4-4 vi 47 F2 17UR Rev00
Table des matières 4.8 REMARQUES RELATIVES À L'EXEMPLE... 4-5 Index... i-1 47 F2 17UR Rev00 vii
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur Illustrations Figures 3-1 Module d'écoute TNS exécuté sur un serveur ORACLE... 3-1 viii 47 F2 17UR Rev00
1. Fichiers et utilitaires SQL*Net V2 - Introduction 1.1 NOMS DES FICHIERS DE CONFIGURATION Il est souvent fait référence aux fichiers SQL* Net V2 dans la documentation SQL*Net. Sur votre système, ces fichiers sont des unités de bibliothèque. En voici la liste avec leur nom en regard : TNSNAMES.ORA SQLNET.ORA LISTENER.ORA TNSNAMES_ORA SQLNET_ORA LISTENER_ORA Les fichiers TNSNAV.ORA, TNSNET.ORA et INTCHG.ORA ne sont pas utilisés, le format d'échange MultiProtocol (multiprotocole n'étant pas disponible sur DPS 7000. Pour éviter des avertissements signalant l'absence de ces fichiers (dans le JOR du COR, dans SQLNET_ADAPTER ou sur les clients SQL *Net, nous vous recommandons de créer des fichiers TNSNAV_ORA, TNSNET_ORA et INTCHG_ORA vides. 1.2 OUTIL DE CONFIGURATION SQL*NET L'outil de configuration SQL*Net dédié à la création automatique de fichiers de configuration n'est pas disponible sur le DPS 7000. Pour créer vos fichiers de configuration, vous pouvez faire appel à l'utilitaire sur un système UNIX puis les transférer sur le DPS 7000, ou, à défaut, utiliser l'éditeur de GCOS 7. Avec l'éditeur, veillez à respecter les règles d'indentation des clauses, comme indiqué dans les exemples. Pour un complément d'informations sur cet utilitaire et son exploitation, reportez-vous aux chapitres 5 et 6 de SQL*Net V2 - Guide de l'administrateur. 47 F2 17UR Rev00 1-1
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur 1.3 FICHIERS SQL*NET V2 Voici une brève description des fichiers SQL*Net V2 (noms par défaut, emplacements sur le système et des informations, spécifiques du système, relatives au fichier de configuration de base SQL*Net V2. 1.3.1 TNSNAMES_ORA Il s'agit du fichier SQL*Net V2 de base, appelé TNSNAMES.ORA dans la documentation SQL*Net V2. Il répertorie les descripteurs de connexion et les alias dédiés à la connexion des applications de réseau. Ce fichier doit être accessible à tout client et serveur du réseau. TNSNAMES_ORA est une unité de bibliothèque et doit être placé dans la bibliothèque origine associée au répertoire de travail courant. Le nom de l'unité de bibliothèque est le répertoire de travail courant, suivi de l'extension.sl. Déclaration d'un serveur spécialisé ORACLE-V7 met à disposition des utilisateurs un serveur à unités d'exécution multiples, permettant le partage des process par le biais d'un répartiteur. Si vous ne souhaitez pas que vos demandes de connexion transitent par le répartiteur, ajoutez à la section CONNECT_DATA du fichier TNSNAMES_ORA la ligne suivante : (SERVER=dedicated Voici l'illustration d'une rubrique de TNSNAMES_ORA : alias = (DESCRIPTION= (ADDRESS_LIST = (ADDRESS = (PROTOCOL=tcp (HOST=by63 (PORT=1521 (CONNECT_DATA= (SID=or16 (SERVER=dedicated Pour plus de détails, reportez-vous au chapitre 4 de SQL*Net V2 - Guide de l'administrateur. 1.3.2 SQLNET_ORA Il s'agit du fichier maître de configuration dédié au journal et au suivi du process serveur et des applications client sur SQL*Net V2. Dans ORACLE Network Products Error Messages Manual, ce fichier s'appelle SQLNET.ORA. 1-2 47 F2 17UR Rev00
Fichiers et utilitaires SQL*Net V2 - Introduction SQLNET_ORA est une unité de bibliothèque et doit être placé dans la bibliothèque origine associée au répertoire de travail courant. Le nom de l'unité de bibliothèque est le répertoire de travail courant, suivi de l'extension.sl. Paramètres TRACE_LEVEL_module indique le niveau de détail de la fonction de suivi pour l'enregistrement des événements. La valeur la plus élevée est 16 et, celle par défaut, OFF. La syntaxe de ce paramètre est la suivante : TRACE_LEVEL_module=OFF numéro ADMIN USER TRACE_DIRECTORY_module non significatif pour le DPS 7000, le fichier de suivi étant placé dans la bibliothèque origine du répertoire de travail courant. TRACE_FILE_module définit le nom de l'unité de bibliothèque dans laquelle inscrire les informations de suivi. La valeur par défaut est SQLNET_TRC. La syntaxe de ce paramètre est la suivante : TRACE_FILE_module=nom-fichier-suivi. LOG_DIRECTORY_module non significatif pour le DPS 7000, le fichier journal étant placé dans la bibliothèque origine du répertoire de travail courant. LOG_FILE_module définit le nom de l'unité de bibliothèque où est situé le journal dédié au module d'écoute. La valeur par défaut est SQLNET_LOG. La syntaxe de ce paramètre est la suivante : LOG_FILE_module=nom-fichier-journal. 47 F2 17UR Rev00 1-3
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur Exemple de fichier SQLNET_ORA : AUTOMATIC_IPC=OFF TRACE_LEVEL_CLIENT=OFF TRACE_FILE_CLIENT=CLIENT LOG_FILE_CLIENT=CLIENT TRACE_LEVEL_SERVER=OFF TRACE_FILE_SERVER=SERVER LOG_FILE_SERVER=SERVER Remarque : La valeur de TRACE_LEVEL_module est différente de OFF uniquement en cas de mise au point. Pour plus de détails, reportez-vous à l'annexe A de ORACLE Network Products Error Messages Manual. 1.3.3 LISTENER_ORA Pour qu'un serveur de base de données puisse recevoir des connexions de clients SQL*Net V2, la plate-forme serveur doit être dotée d'un module d'écoute actif. LISTENER_ORA est le fichier de configuration dédié au module d'écoute TNS. Ce fichier contient les noms et adresses des modules d'écoute, une description des SID (ID serveurs de base de données pour lesquels le module d'écoute est actif, et les paramètres qui ont une répercussion sur le comportement du module d'écoute. LISTENER_ORA est une unité de bibliothèque située dans la bibliothèque origine associée au répertoire de travail courant. Le nom de l'unité de bibliothèque est le répertoire de travail courant, suivi de l'extension.sl. Pour des détails sur la définition des adresses de module d'écoute TNS, reportez-vous au chapitre 4 de SQL*Net V2 - Guide de l'administrateur. Le format de l'adresse du module d'écoute est comme suit : module-écoute = (ADDRESS_LIST = (ADDRESS = (PROTOCOL=tcp (PORT=1521 (HOST=bc09 Le format des SID est le suivant : SID_LIST_module-écoute = (SID_LIST = (SID_DESC = (SID_NAME=sid Dans ce format, SID est l'identificateur du serveur de base de données (nom d'instance tel qu'affiché dans la liste obtenue par la commande LIST_SVR - se reporter au manuel ORACLE-V7 - Processeurs et utilitaires. 1-4 47 F2 17UR Rev00
Fichiers et utilitaires SQL*Net V2 - Introduction ORACLE_HOME n'est pas significatif pour le DPS 7000. Paramètres TRACE_LEVEL indique le niveau de détail de la fonction de suivi pour l'enregistrement des événements. La valeur la plus élevée est 16 et, celle par défaut, OFF. La syntaxe de ce paramètre est la suivante : TRACE_LEVEL_module-écoute=OFF numéro. TRACE_DIRECTORY TRACE_FILE non significatif pour le DPS 7000, le fichier de suivi étant placé dans le répertoire de travail courant. définit le nom du fichier où inscrire les informations de suivi. La valeur par défaut est LISTENER_TRC. La syntaxe de ce paramètre est la suivante : TRACE_FILE_module-écoute=nom-fichier-suivi LOG_DIRECTORY non significatif pour le DPS 7000, le fichier journal étant placé dans le répertoire de travail courant. LOG_FILE définit le nom du fichier journal dédié au module d'écoute. La valeur par défaut est LISTENER_LOG. La syntaxe de ce paramètre est la suivante : Exemple de fichier LISTENER_ORA : LOG_FILE_module-écoute=nom-fichier-journal Cet exemple fait référence à un module d'écoute appelé LISTENER, accessible par le protocole TCP/IP via le port 1521 sur BC09. 47 F2 17UR Rev00 1-5
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur Ce module prend en charge une instance d'oracle appelée V7015. LISTENER = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = tcp (HOST = bc09 (PORT = 1521 SID_LIST_LISTENER = (SID_DESC = (SID_DESC = (SID_NAME = V7015 STARTUP_WAIT_TIME_LISTENER = 0 CONNECT_TIMEOUT_LISTENER = 10 TRACE_LEVEL_LISTENER= OFF TRACE_FILE_LISTENER= LISTENER LOG_FILE_LISTENER= LISTENER Définition du répertoire de travail courant (#WD La directive MODIFILE_PROFILE (MP permet de donner au répertoire de travail courant (#WD la valeur où les fichiers de configuration sont placés. TNSNAMES_ORA LISTENER_ORA service name= listener= (DESCRIPTION (ADDRESS_LIST= (ADDRESS_LIST= (ADDRESS= (ADDRESS= (PROTOCOL=protocol (PROTOCOL=protocol (protocol specific information (protocol specific information SID_LIST_listener= (CONNECT_DATA= (SID_LIST= (SID=sid (SID_DESC= (SID_NAME=sid 1.3.4 Modifications des fichiers SQL*Net V2 Les modifications apportées aux fichiers TNSNAMES_ORA et/ou SQLNET_ORA sont prises en compte après arrêt et redémarrage des groupes de process client/serveur concernés : le COR s'il traite les connexions SQL*Net V2, par exemple une connexion SQL*Net V2 émise sous une application ORACLE-V7/TDS (se reporter au paragraphe 3.2 ; un SQLNET_ADAPTER s'il traite les connexions SQL*NET V2, par exemple une connexion SQL*Net V2 émise sous une application ORACLE-V7/TDS (se reporter au paragraphe 3.3 ; un serveur ORACLE-V7 s'il traite les connexions DATABASE LINKS avec SQL*Net V2 (se reporter au paragraphe 3.3. 1-6 47 F2 17UR Rev00
Fichiers et utilitaires SQL*Net V2 - Introduction 1.4 LSNRCTL LSNRCTL est l'utilitaire de contrôle du module d'écoute TNS. 1.4.1 SYNTAXE LSNRCTL [ ACTION = { HELP } ] [ { SET PASSWORD } ] [ { START } ] [ { STOP } ] [ { STATUS } ] [ { SERVICES } ] [ { RELOAD } ] [ { TRACE } ] [ { VERSION } ] [ PARAMETERS = { alias-module-écoute } ] [ <jeu-paramètres-standard> ] 1.4.2 PARAMETRES ACTION SET PASSWORD HELP START STOP STATUS SERVICES définit le type d'exécution de LSNRCTL. Sélectionnez une des options décrites ci-après : autorise uniquement les tâches opérées par l'administrateur sur le module d'écoute. Le mot de passe doit correspondre avec un de ceux répertoriés dans le fichier LISTENER_ORA. Vous pouvez lancer cette commande en cours de session LSNRCTL ou quand vous démarrez la session. fournit les différentes commandes. lance un module d'écoute TNS. met fin à un module d'écoute TNS. affiche les informations de base suivantes : version, alias, heure de début de session, temps d'exploitation ; indique quel fichier LISTENER_ORA est utilisé et si le suivi est activé. fournit des informations détaillées sur les services contrôlés par le module d'écoute : le nombre de connexions établies et de connexions refusées. Deux types de services sont affichés : les serveurs spécialisés à partir de LISTENER_ORA et les informations du répartiteur. VERSION fournit les numéros de version : de l'exécutable du module d'écoute TNS, de TNS, de la carte de protocole. QUIT quitte le domaine LSNRCTL. 47 F2 17UR Rev00 1-7
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur TRACE RELOAD PARAMETERS active le suivi pour le module d'écoute. Les valeurs sont OFF, USER ou ADMIN. effectue un arrêt complet, excepté les adresses du module d'écoute et relit le fichier LISTENER_ORA. définit le nom du module d'écoute, sauf si ACTION='set password'. L'alias par défaut est LISTENER si vous n'indiquez pas de nom. ACTION='SET PASSWORD' définit la valeur du mot de passe. Pour un complément d'informations sur les paramètres standard, reportez-vous au chapitre 1 du manuel ORACLE-V7 - Processeurs et utilitaires, et sur la signification des paramètres LSNRCTL, à la section traitant de l'utilitaire de contrôle du module d'écoute dans SQL*Net V2 - Guide de l'administrateur. 1.4.3 Remarques sur l'exécution de LSNRCTL Quand le module d'écoute TNS est lancé (commande LSNRCTL, les fichiers de configuration SQL*Net V2 (LISTENER_ORA et SQLNET_ORA doivent être accessibles dans sa bibliothèque #WD.SL. Pour l'accès à l'utilitaire LSNRCTL du module d'écoute TNS, vous disposez des deux modes suivants : la commande directe LSNRCTL suivie de l'action et de l'alias du module d'écoute. Exemples : S: lsnrctl start alias-module-écoute S: lsnrctl status alias-module-écoute la commande LSNRCTL indirecte, sur le processeur LSNRCTL, à partir de l'invite LSNRCTL> suivie de la commande voulue. Exemples : S: lsnrctl LSNRCTL> start alias-module-écoute LSNRCTL> status alias-module-écoute Si vous n'indiquez pas de nom de module d'écoute, LISTENER est lancé par défaut. 1-8 47 F2 17UR Rev00
Fichiers et utilitaires SQL*Net V2 - Introduction 1.5 CONFIGURATION D'UN CLIENT Un client est une application qui puise des informations d'un serveur. Un serveur peut aussi être client. Appliquez les procédures décrites ci-après à chaque client, et également aux applications considérées comme des applications serveur, celles-ci pouvant accéder à d'autres serveurs par le biais de liaisons base de données. 1. Définition des bases de données à disposition du client Le fichier TNSNAMES_ORA répertorie les descripteurs de connexion (emplacements de toutes les bases de données et applications à disposition du client sur le réseau, ainsi que leurs alias, et les emplacements des noeuds du module d'écoute. Sur les machines client, ce fichier s'appelle aussi TNSNAMES_ORA. Il est situé dans une bibliothèque origine dont le nom est le répertoire de travail courant, suivi de l'extension.sl (#WD en cours d'exploitation une fois la demande de connexion émise. 2. Configuration des paramètres de l'application client (journal et suivi, y compris les noms des fichiers de sortie correspondants Le fichier SQLNET_ORA configure le journal et le suivi des applications client. Il est situé dans une bibliothèque origine dont le nom est le répertoire de travail courant, suivi de l'extension.sl (#WD en cours d'exploitation une fois la demande de connexion émise. Le niveau de suivi par défaut est OFF (pas de suivi. Il est recommandé de ne modifier cette valeur qu'en cas de mise au point, ceci pour des raisons de performances. Le DPS 7000 est dépourvu de gestionnaire IPC local. Aussi devez-vous l'indiquer dans SQLNET_ORA avec le paramètre suivant : AUTOMATIC_IPC=OFF Default is ON Si vous souhaitez que vos demandes de connexion passent par un répartiteur, vérifiez que la commande ci-après ne figure pas dans SQLNET_ORA : USE_DEDICATED_SERVER=ON Default is OFF 47 F2 17UR Rev00 1-9
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur 1.6 CONFIGURATION D'UN SERVEUR 1. Configuration de TNSNAMES_ORA Ce fichier est situé dans une bibliothèque origine dont le nom est le répertoire de travail courant, suivi de l'extension.sl (#WD en cours d'exploitation au lancement du serveur, figurant dans la liste obtenue par la commande LIST_SVR - se reporter au manuel ORACLE-V7 - Processeurs et utilitaires. 2. Création du fichier TNS alias Le fichier LISTENER_ORA est le principal fichier de configuration du module d'écoute. Il doit figurer dans une bibliothèque origine dont le nom est le répertoire de travail courant, suivi de l'extension.sl (#WD en cours d'exploitation au lancement du serveur, figurant dans la liste obtenue par la commande LIST_SVR - se reporter au manuel ORACLE-V7 - Processeurs et utilitaires. Sa fonction est de répertorier exhaustivement les adresses de module d'écoute et d'en configurer les paramètres de journal et suivi. 3. Création du fichier de configuration maître (journal et suivi du serveur Le fichier SQLNET_ORA configure le journal et le suivi du process serveur. Il est situé dans une bibliothèque origine dont le nom est le répertoire de travail courant, suivi de l'extension.sl (#WD.SL en cours d'exploitation au lancement du serveur, figurant dans la liste obtenue par la commande LIST_SVR - se reporter au manuel ORACLE-V7 - Processeurs et utilitaires. 1-10 47 F2 17UR Rev00
Fichiers et utilitaires SQL*Net V2 - Introduction 1.7 CONFIGURATION DES REPARTITEURS POUR DIFFERENTS PROTOCOLES Si vous sélectionnez le serveur à unités d'exécution multiples (multi_threaded avec SQL*Net V2, vous devez configurer les paramètres mts. Ceux-ci sont répertoriés dans l'annexe correspondante dans Serveur ORACLE-V7 - Guide de l'administrateur. Le fichier init_ora, situé dans la bibliothèque #WD.SL, doit être modifié. Voici un exemple de définition d'un répartiteur prenant le protocole TCP/IP en charge : mts_répartiteurs="tcp,1" #run one TCP/IP dispatcher mts_service=sid #dispatcher service name mts_serveurs=1 #min. no. of shared servers mts_max_serveurs=10 #max. no. of shared servers mts_adresse_répartiteur="(address=(protocol=tcp(host=nomhôte(port=numéro-port" Pour être sûr d'indiquer une adresse correcte, vérifiez-la dans LISTENER_ORA et assurez-vous qu'elle correspond à celle qui figure dans INIT_ORA. Le paramètre mts_service et votre SID doivent posséder la même valeur. Pour un complément d'informations sur les répartiteurs, reportez-vous à Serveur ORACLE-V7 - Guide de l'administrateur. 47 F2 17UR Rev00 1-11
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur 1-12 47 F2 17UR Rev00
2. Cartes de protocole ORACLE 2.1 GÉNÉRALITÉS La spécification GCOS 7 XTI (interface de transport GCOS 7 X/OPEN définit une interface de service transport. GCOS 7 XTI fournit à SQL*Net V2 sous GCOS 7 une interface de communication unique : avec des applications locales/à distance par le biais du protocole TCP, via FCP 7 sur GCOS 7. 2.2 CARTE TCP/IP TCP/IP est une famille de protocoles associés. Son nom est dérivé de ses deux modules principaux, les protocoles de contrôle de transmission (Transmission Control Protocol et Internet (Internet Protocol. Le module IP répartit les informations sur le réseau. Le module TCP prend en charge la transmission des données d'un point à l'autre du réseau. L'application ou le process client lance sa propre connexion TCP/IP avec l'hôte distant en spécifiant les deux adresses suivantes : une adresse IP hôte, un port TCP sur l'hôte. Remarque : Pour plus de détails sur ce protocole, reportez-vous à la documentation fournie avec le logiciel TCP/IP. 47 F2 17UR Rev00 2-1
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur Les paramètres de connexion de la carte TCP/IP font partie de valeur-mot-clé de ADDRESS. Dans ADDRESS, l'ordre des trois paramètres TCP/IP est indifférent. La syntaxe de connexion de la carte TCP/IP est la suivante : (ADDRESS= (PROTOCOL=tcp (HOST=nom-hôte (PORT=port# Paramètres PROTOCOL HOST PORT Remarque : définit la carte de protocole à employer. Pour le protocole TCP/IP, la valeur tcp s'indique indifféremment en majuscules ou minuscules. définit le nom de l'hôte ou son adresse IP. définit le numéro du port TCP/IP ou un nom de service. Si vous indiquez un nom de service dans le mot-clé PORT, vous devez ajouter une entrée au fichier ETC_SERVICES situé dans la bibliothèque SYS.DSACONF. Exemple : (ADDRESS= (PROTOCOL=tcp (HOST=bc09 (PORT=tnslsnr Dans le fichier SERVICES, ajoutez : tnslsnr 1521/tcp 2.2.1 Fichier ETC_HOSTS Avec ce fichier, le nom de l'hôte sera réduit à une adresse IP. Le fichier ETC_HOSTS doit être créé dans la bibliothèque SYS.DSACONF. La structure de ETC_HOSTS est la suivante : IP Address hostname alias #comments Exemple de fichier ETC_HOSTS : 129.182.131.23 oslo #null 0000A7103A66 129.182.131.24 lisboa #null 0000A7103A79 129.182.131.25 quito #null 0000A7103A90 2-2 47 F2 17UR Rev00
Cartes de protocole Oracle 2.2.2 Fichier ETC_SERVICES Avec ce fichier, le nom de service sera réduit à un numéro de PORT. Le fichier ETC_SERVICES doit être créé dans la bibliothèque SYS.DSACONF. Voici la structure de ce fichier : nom service port/protocole Exemple de fichier ETC_SERVICES : # services tnslsnr orasrv ORACLEor15 1521/tcp 1525/tcp 1600/tcp 2.3 RÈGLE DE CONFIGURATION DE GXTI Le nombre de connexions SQL*Net V2 ouvertes simultanément dépend de la valeur du paramètre MAXTE dans la clause de configuration VCAMSCN (se reporter à System Installation, Configuration and Updating Guide. La formule suivante permet d'évaluer approximativement la valeur du paramètre MAXTE : MAXTE > TE ISO + 5xTE TCP + 3xTE UDP + 22 où TE = extrémité transport = 1 connexion 47 F2 17UR Rev00 2-3
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur 2-4 47 F2 17UR Rev00
3. Module d'écoute TNS et COR V2 - Fonctions 3.1 MODULE D'ÉCOUTE TNS SQL*Net V2 fait appel au module d'écoute TNS sur un serveur pour la réception des connexions entrantes à partir de clients SQL*Net V2. Le module d'écoute TNS génère un process serveur spécialisé et lui passe le contrôle de la connexion entrante, ou l'adresse d'un process répartiteur partagé est indiquée, et la connexion entrante est dirigée vers cette adresse. Après l'établissement d'une connexion, le module d'écoute TNS reste à l'écoute d'autres éventuelles connexions entrantes. Le module d'écoute TNS doit être exécuté sur un serveur ORACLE pour être en mesure de recevoir les connexions entrantes de clients SQL*Net V2. serveur spécialisé répartiteur partagé génération d'un process et connexion 1 2 passage à un process existant module d'écoute TNS connexion entrante client SQL*Net V2 Figure 3-1. Module d'écoute TNS exécuté sur un serveur ORACLE 47 F2 17UR Rev00 3-1
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur 3.2 COR V2 Le gestionnaire de communication ORACLE V2 (COR est une nouvelle version. Le COR est nécessaire : pour exploiter un serveur de base de données ORACLE ; pour lancer un module d'écoute TNS ; pour exploiter ORACLE (ou SQL*Net V2 sous TDS. COR V2 gère le protocole local, qui permet au module d'écoute TNS de communiquer avec son process serveur spécialisé ou un répartiteur partagé. Le COR convertit la chaîne de connexion V1/V2 et correspond avec le TDS. Voici un exemple de conversion d'une chaîne de connexion : connect <nom-utilisateur>/<mot-de-passe>@alias1 Si une base de données locale ALIAS1 (instance appelée ALIAS1 est en cours d'exécution sur la machine locale, c'est le protocole SQL*NET V1 (protocole local qui permet la connexion. Remarque : La fonction de vérification d'une instance locale en cours d'exécution distingue les majuscules des minuscules. L'instance doit être en MAJUSCULES. Par ailleurs, le protocole utilisé est SQL*Net V2 ; ALIAS1 est un nom de service associé à un protocole et une base de données distante, comme défini dans le fichier TNSNAMES_ORA. Pour gérer les connexions entrantes de clients SQL*Net V2, COR V2 doit être exécuté sur un serveur ORACLE. 3-2 47 F2 17UR Rev00
Module d'écoute TNS et COR V2 - Fonctions 3.3 CARTE SQLNET Nous avons mis en évidence qu'un COR exécuté sur la machine locale est nécessaire pour gérer SQL*Net V2 sous ORACLE-V7/TDS. Il n'est pas tenu compte de la version : le COR reçoit dans tous les cas la chaîne de connexion (SQL*Net V1 ou V2 émise par ORACLE-V7/TDS. S'il s'agit d'une connexion SQL*Net V2, le COR la prendra en charge tant qu'elle sera active. Ceci signifie qu'il agit comme un client SQL*Net V2 en présence d'une chaîne de connexion SQL*Net V2 ; donc, les fichiers TSNAMES_ORA et SQLNET_ORA doivent figurer dans sa bibliothèque #WD.SL (voir paragraphe 1.5, et tout échange SQL*Net V2 entre ORACLE-V7/TDS et le serveur consomme du temps CPU. Si ORACLE-V7/TDS prend en charge des connexions SQL*Net V2 multiples, il est préférable qu'un groupe de process soit dédié à la gestion d'une connexion SQL*Net V2 spécifique (pour des raisons de performance et de fiabilité, ceci pour éviter que le groupe de process COR soit continuellement en charge de toutes ces connexions. Ce groupe de process SQL*Net V2 spécialisé s'appelle un SQLNET_ADAPTER. La vocation d'un SQLNET_ADAPTER est de gérer les connexions SQL*Net V2 associées à un alias SQL*Net V2 donné (et un seul. Cet alias est spécifié au lancement de SQLNET_ADAPTER (paramètre ALIAS. Il n'est lancé qu'un seul SQLNET_ADAPTER par SQL*Net V2 pris en charge par les applications ORACLE-V7/TDS. Pour l'ensemble des connexions SQL*Net V2 gérées par un SQLNET_ADAPTER, c'est le groupe de process qui fera fonction de SQL*Net V2 ; donc, les fichiers TSNAMES_ORA et SQLNET_ORA doivent figurer dans sa bibliothèque #WD.SL (voir paragraphe 1.5, et tout échange SQL*Net V2 entre ORACLE-V7/TDS et le serveur consomme du temps CPU. 3.3.1 SYNTAXE DE SQLNET_ADAPTER SQLNET_ADAPTER [ { INITIALIZE } ] [ ACTION { I } ] [ { SHUTDOWN } ] [ { S } ] ALIAS = <nom-32> <jeu-paramètres-standard> 47 F2 17UR Rev00 3-3
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur 3.3.2 PARAMETRES DE SQLNET_ADAPTER ACTION INITIALIZE définit le type d'exécution de SQLNET_ADAPTER. démarre un groupe de process SQLNET_ADAPTER, dont l'initialisation est effective dès que s'affiche le message : ORACLE adapter <alias> initialized SHUTDOWN ou S met fin à un groupe de process SQLNET_ADAPTER, dont l'arrêt est effectif dès que s'affiche le message : ORACLE adapter <alias> shutdown complete ALIAS désigne l'alias SQL*Net V2 que SQLNET_ADAPTER prendra en charge. Cet alias doit figurer dans le fichier TNSNAMES_ORA situé dans la bibliothèque #WD.SL associée au groupe de process SQLNET_ADAPTER. Pour un complément d'informations sur les paramètres standard, reportez-vous au chapitre 1 du manuel ORACLE-V7 - Processeurs et utilitaires. 3.3.3 REMARQUES SUR L'EXECUTION DE SQLNET_ADAPTER Une fois SQLNET_ADAPTER lancé, il figure sur le compte rendu obtenu par la commande LIST_SVR (se reporter au manuel ORACLE-V7 - Processeurs et utilitaires. La fonction qui gère l'alias SQL*Net V2 dédié à un SQLNET_ADAPTER distingue les majuscules des minuscules. L'alias doit figurer en MAJUSCULES dans la chaîne de connexion SQL*Net V2. Exemple : S: SQLNET_ADAPTER ALIAS=ALIAS2; --> ORACLE adapter ALIAS2 initialized Une application ORACLE-V7/TDS exécutant EXEC SQL CONNECT : nom-utilisateur IDENTIFIED BY : mot-de-passe USING : chaîne-base-données Instruction a avec nom-utilisateur=scott, mot-de-passe=tiger et chaîne-base-données=alias2 il est fait appel à SQLNET_ADAPTER ; b avec nom-utilisateur=scott, mot-de-passe=tiger et chaîne-base-données=alias2 il est fait appel au COR. 3-4 47 F2 17UR Rev00
4. Exploitation de SQL*Net V2 - Exemple 4.1 GÉNÉRALITÉS Ce chapitre vous aidera à tester le produit SQL*Net V2 sur votre site. Dans l'exemple cité, le site est à la fois client et serveur et les deux applications communiquent via GXTI/TCP. Le code ORACLE a été installé dans le répertoire ORACLE.CODE. Une base de données ORACLE a été créée dans le répertoire ORACLE.DBV7. Pour les clients, le serveur et le module d'écoute, le répertoire de travail courant (#WD est ORACLE.DBV7. Le nom du module d'écoute TNS est MY_LSNR. Le nom associé au point d'entrée IP est my_ip. Avant de tester le produit SQL*Net V2, les opérations ci-après doivent être terminées. 47 F2 17UR Rev00 4-1
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur 4.2 CREATION DES FICHIERS DE CONFIGURATION Vous devez créer trois fichiers de configuration SQL*NET V2 dans la bibliothèque origine associée au répertoire de travail courant, c'est-à-dire ORACLE.DBV7.SL (dans le cadre de l'exemple. 1. Fichier TNSNAMES_ORA my_test = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = tcp (HOST = my_ip (PORT = 1521 (CONNECT_DATA = (SID = DBV7 2. Fichier LISTENER_ORA MY_LSNR = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP (HOST = my_ip (PORT = 1521 SID_LIST_MY_LSNR = (SID_LIST = (SID_DESC = (SID_NAME = DBV7 STARTUP_WAIT_TIME_MY_LSNR = 0 CONNECT_TIMEOUT_MY_LSNR = 100 TRACE_LEVEL_MY_LSNR=OFF 3. Fichier SQLNET_ORA AUTOMATIC_IPC=OFF TRACE_LEVEL_CLIENT=OFF TRACE_LEVEL_LISTENER = OFF 4-2 47 F2 17UR Rev00
Exploitation de SQL*Net V2 - Exemple 4.3 CRÉATION DU FICHIER ETC_HOSTS Dans la bibliothèque SYS.DSACONF, vous devez créer le fichier ETC_HOSTS avec la ligne de commande suivante : #IP Address hostname comments 125.182.200.12 my_ip #IP address of the entry point 4.4 CRÉATION DU FICHIER ETC_SERVICES Dans la bibliothèque SYS.DSACONF, vous devez créer le fichier ETC_SERVICES avec la ligne de commande suivante : orav2 1521/tcp Si ce fichier existe, il est possible d'y remplacer (dans les fichiers de configuration SQL*Net V2 une clause semblable à "PORT = 1521" par "PORT = orav2". 4.5 LANCEMENT DE LA BASE DE DONNÉES ORACLE 1. Définition de l'environnement ORACLE S: mp oracle.code; S: mwinlib bin.bin; S: oracle; 2. Exécution du COR Au besoin, lancez le processeur COR : S: MP ORACLE.DBV7; s: COR I; 3. Lancement d'un serveur de base de données (désigné DBV7 S: mp oracle.dbv7; S: sor w size=4000 instance=dbv7; 4. Ouverture de la base de données S: sqldba instance=dbv7; SQLDBA> connect internal SQLDBA> startup open SQLDBA> exit 47 F2 17UR Rev00 4-3
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur 4.6 LANCEMENT DU MODULE D'ÉCOUTE TNS Vous vous connectez sur votre site DPS 7000 sous le nom d'utilisateur userx1. Définition de l'environnement ORACLE S: mp oracle.code; S: mwinlib bin. bin; S: oracle; S: mp oracle.dbv7 /* current directory */ Pour lancer un module d'écoute TNS appelé my_lsnr, l'utilisateur entre : S: lsnrctl start my_lsnr /* Start the TNS listener named my_lsnr */ S: ds ex /* To verify that the LSNRV2 batch job is running */ S: lsnrctl status my_lsnr /* To verify the listen address specified in the */ /* listener_ora file */ 4.7 CONNEXION AU SERVEUR LOCAL Vous vous connectez sur votre site DPS 7000 sous le nom d'utilisateur userx2. Définition de l'environnement ORACLE S: mp oracle.code S: mwinlib bin. bin S: oracle S: mp oracle.dbv7 Pour lancer un module d'écoute TNS appelé my_lsnr, l'utilisateur entre : S: sqlplus scott/tiger@my_test; ---> connected et, pour en vérifier l'état : S: lsnrctl LSNRCTL> status my_lsnr or services my_lsnr ou S: lsnrctl status my_lsnr S: lsnrctl services my_lsnr 4-4 47 F2 17UR Rev00
Exploitation de SQL*Net V2 - Exemple 4.8 REMARQUES RELATIVES À L'EXEMPLE Remarque 1 L'exemple illustre l'établissement d'une connexion SQL*Net V2 entre un client (CLIENT et un serveur (SERVER situés sur la même machine. La même procédure s'applique si le client et le serveur ne sont pas sur la même machine. Dans ce cas, le module d'écoute TNS ne sera obligatoire que sur la machine réceptrice. Remarque 2 Si les connexions établies entre le client et le serveur sont seulement locales, la connexion SQL *Net V1 locale est préférable à la connexion SQL*Net V2. La connexion SQL *Net V1 locale est en effet plus performante dans ce cas de figure, la connexion SQL*Net V2 locale consommant plus de temps CPU du fait qu'il est fait appel à toutes les couches logicielles SQL*Net V2 et GXTI. Pour une configuration identique à l'exemple donné, les connexions locales SQL *Net V1 s'effectuent avec une chaîne de connexion semblable à : S: sqlplus scott/tiger@dbv7 /* voir paragraphe 3.2 */ ou S: sqlplus scott/tiger@d:dbv7 Remarque 3 Une application ORACLE-V7/TDS qui exécute une connexion avec une chaîne de base de données égale à "my_test" fera appel au groupe de process COR pour établir les connexions SQL*Net V2 (voir paragraphe 3.2. A l'image de SQL *Plus, si uniquement des connexions locales sont gérées à partir d'oracle-v7/tds, vous optimiserez les performances en faisant appel aux chaînes de connexion SQL*Net V1 locales (c'est-à-dire en utilisant une chaîne de base de données telle que 'D:DBV7" ou "DBV7". 47 F2 17UR Rev00 4-5
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur 4-6 47 F2 17UR Rev00
Index C client configuration 1-9 configuration nom fichier 1-1 outil 1-1 COR version 2 3-1 COR V2 3-2 E ETC_HOSTS 2-2, 4-3 création 4-3 ETC_SERVICES 2-3, 4-3 création 4-3 R répartiteur configuration 1-11 répertoire de travail courant définition 1-6 S serveur configuration 1-10 serveur local 4-5 connexion 4-5 serveur spécialisé 1-2 SQLNET.ORA 1-3 SQLNET_ADAPTER 3-4 exécution 3-4 F fichier configuration création 4-2 fichiers V2 1-2 L T TCP/IP carte de protocole 2-1 TNS 4-5 lancement module d'écoute 4-5 module d'écoute 3-1 TNSNAMES.ORA 1-2 LISTENER_ORA 1-4 LSNRCTL 1-7 O ORACLE base de données 4-3 carte de protocole 2-1 lancement 4-3 47 F2 17UR Rev00 i-1
SQL*Net V2 avec GCOS 7 - Guide de l'utilisateur i-2 47 F2 17UR Rev00