Variables d'environnement

Les variables d'environnement stockent des informations sur des paramètres spécifiques dans l'environnement du client de connexion. Elles stockent des éléments tels que le chemin d'accès à un répertoire ou fichier spécifique, un numéro de port et des noms d'utilisateur.

Voici une liste de variables d'environnement que vous pouvez définir ou désactiver dans le fichier dbinit.sde, dans les variables système Windows, ou spécifier dans la syntaxe de connexion directe que vous fournissez lorsque vous vous connectez avec une application cliente (par exemple ArcGIS Desktop) à une géodatabase.

• GIOMGRLOGREFRESH

  Définissez GIOMGRLOGREFRESH sur true si vous souhaitez remplacer le fichier giomgr.log à chaque démarrage du service ArcSDE. Si vous souhaitez accumuler les messages consignés dans le journal (valeur par défaut), ne définissez pas la variable.

  set GIOMGRLOGREFRESH=TRUE

• LOCATION_ERRLOG

  La variable LOCATION_ERRLOG définit le fichier d'enregistrement des erreurs de localisation d'ArcSDE. La valeur de cette variable d'environnement doit contenir le nom complet du fichier journal. Ce fichier ne doit pas nécessairement exister avant la définition de la variable d'environnement car il est créé automatiquement par la structure de localisation. Les erreurs de localisation d'ArcSDE sont consignées dans ce fichier dès lors que la variable d'environnement LOCATION_VERBOSE est définie sur true.

  set LOCATION_ERRLOG=c:\temp\location.errlog

• LOCATION_VERBOSE

  Définissez la variable d'environnement LOCATION_VERBOSE sur true pour consigner les erreurs de localisation d'ArcSDE. Si la variable d'environnement LOCATION_ERRLOG est également définie, les erreurs de localisation sont consignées dans le fichier spécifié. Si la variable d'environnement LOCATION_ERRLOG n'est pas définie ou si le fichier spécifié ne peut être créé, les erreurs de localisation sont consignées dans SDEHOME\etc\location.errlog.

  set LOCATION_VERBOSE=TRUE

• SDEATTEMPTS

  Définissez la variable SDEATTEMPTS sur le nombre souhaité d'essais de connexion de la session à un service ArcSDE. Normalement, une seule tentative est suffisante ; toutefois, si le service ArcSDE est trop occupé à satisfaire les demandes de connexion simultanées de nombreux utilisateurs, une session peut nécessiter plusieurs tentatives avant d'établir une connexion. A chaque échec de connexion, la session attend le dépassement du délai d'expiration IP. Le délai d'expiration IP est défini par votre administrateur de réseau, mais la valeur par défaut est de 75 secondes pour la plupart des systèmes d'exploitation. Par défaut, SDEATTEMPTS est défini sur 4. Ceci doit suffire pour la plupart des environnements.

  set SDEATTEMPTS=4

• SDEDBECHO

  La variable SDEDBECHO répercute le contenu du fichier dbinit.sde pendant le démarrage. Pour les serveurs d'applications ArcSDE démarrés localement sur un système UNIX, le résultat de la variable SDEDBECHO est affiché à l'écran. Le résultat de la variable SDEDBECHO pour un serveur d'applications ArcSDE démarré sur un serveur d'applications ArcSDE distant sous UNIX est consigné dans son fichier sde.errlog.

  set SDEDBECHO=TRUE

• SDEHOME

  SDEHOME spécifie l'emplacement où les fichiers ArcSDE sont installés. Elle détermine également à quel service ArcSDE les commandes administratives vont s'appliquer. Cette variable peut être remplacée par l'option –H des commandes.

  set SDEHOME=d:\arcgis\arcsde

• SDEINSTANCE

  La variable SDEINSTANCE est définie dans l'environnement de l'application client et détermine le nom du service ArcSDE à connecter. La spécification du service par l'application remplace cette variable. Si cette variable n'est pas définie et si le nom du service n'est pas spécifié dans l'application, le nom du service par défaut est esri_sde.

  set SDEINSTANCE=esri_sde

• SDEINTERCEPT

  Définissez la variable SDEINTERCEPT (ainsi que la variable SDEINTERCEPTLOC) si vous avez besoin de capturer des informations que le client ou le serveur envoie par le biais du port TCP/IP. Le support client d'ESRI peut vous demander d'obtenir cette information pour résoudre certains types de problèmes. La collecte des diffusions sur les réseaux client et serveur peut aider l'équipe de support technique à diagnostiquer les problèmes spécifiques du client ou du serveur, puisque les diffusions doivent être symétriques. Toute diffusion asymétrique indique que les informations ne sont pas reçues à une extrémité.

  Une fois que vous avez défini cette variable et la variable SDEINTERCEPTLOC, vous devez redémarrer votre service ArcSDE et reproduire les étapes ayant entraîné le problème.

  Vous pouvez définir la variable SDEINTERCEPT avec les indicateurs suivants pour intercepter les diffusions réseau : c - Intercepter le nom de commande API, r - Intercepter les diffusions sur le canal en lecture seule, w - Intercepter les diffusions sur le canal en écriture seule, t - Intercepter la durée de l'enregistrement (minute:seconde), T - Intercepter la durée de l'enregistrement (heure:minute:seconde) et f - Intercepter la purge immédiate

  set SDEINTERCEPT=crwtf

  Lorsque vous n'avez plus besoin d'intercepter les informations, vous pouvez commenter les variables SDEINTERCEPT et SDEINTERCEPTLOC dans le fichier dbinit.sde en ajoutant un signe dièse (#) devant et en relançant le service.

• SDEINTERCEPTLOC

  Définissez la variable SDEINTERCEPTLOC, ainsi que la variable SDEINTERCEPT, si vous avez besoin de capturer des informations que le client ou le serveur envoie par le biais du port TCP/IP.

  Pour les interceptions du client et du serveur, définissez la variable SDEINTERCEPTLOC sur le nom de chemin complet du préfixe de nom de fichier qui reçoit les informations. Lorsque l'interception est activée, un fichier est créé et écrit à chaque fois qu'une application se connecte au service ArcSDE. Il est fermé uniquement après la déconnexion de l'application. ArcSDE génère un nom de fichier à partir du préfixe fourni dans SDEINTERCEPTLOC en ajoutant une extension numérique qui commence à .001 et s'incrémente de manière séquentielle à chaque création de fichier.

  set SDEINTERCEPTLOC=D:\tmp\sde_server

  Si l'analyste de support technique d'ESRI demande une sortie d'interception de la part du client et du serveur, utilisez des noms de préfixe différents, afin de distinguer le client et le serveur. Par exemple, la définition de SDEINTERCEPTLOC sur d:\tmp\sde_server dans le fichier dbinit.sde capture les diffusions sur le réseau serveur. La définition de SDEINTERCEPTLOC sur d:\tmp\sde_client dans l'environnement de l'application capture les diffusions sur le réseau client dans le même répertoire, mais avec un préfixe différent.

• SDELOGAPPEND
  Remarque :

  UNIX uniquement

  Définissez la variable SDELOGAPPEND sur true pour accumuler les messages de journal dans le fichier journal des erreurs sde et pour éviter de le tronquer à chaque redémarrage du service. Ne définissez pas la variable si vous souhaitez tronquer le fichier journal des erreurs sde au démarrage.

  set SDELOGAPPEND=TRUE

• SDENOIPTEST

  Définissez la variable SDENOIPTEST sur true pour éviter qu'ArcSDE vérifie la présence du nom SERVER dans le fichier HOSTS. Par défaut, SDENOIPTEST n'est pas définie. La définition de cette variable peut être utile si vous n'avez pas configuré les fichiers HOSTS. Le client tentera de se connecter au serveur SDEATTEMPTS fois (quatre fois par défaut).

  set SDENOIPTEST=TRUE

• SDEPASSWORD

  La variable SDEPASSWORD spécifie le mot de passe pour le nom d'utilisateur entré par l'application client d'ArcSDE. La spécification du mot de passe dans l'outil de connexion d'application remplace cette variable. Si la variable n'est pas définie et si le mot de passe n'est pas spécifié dans l'application, l'application peut demander le mot de passe. Si l'application n'invite pas à entrer le mot de passe, un message d'erreur est renvoyé.

  set SDEPASSWORD=fools.gold

  Avec cette définition, la connexion est tentée à l'aide du mot de passe défini par la variable d'environnement. Si vous utilisez l'authentification du système d'exploitation, la connexion échoue puisque vous essayez d'utiliser le mot de passe de l'identifiant de connexion du système d'exploitation. Cela s'applique toujours pour la connexion aux géodatabases ArcSDE sur SQL Server Express (serveurs de base de données ArcSDE).

  Remarque :

  Le stockage d'un mot de passe avec la variable d'environnement SDEPASSWORD n'est pas sûr et n'est pas recommandé.
• SDESERVER

  La variable SDESERVER détermine l'hôte du service ArcSDE pour l'application client de connexion. Cette variable peut être remplacée en spécifiant l'hôte dans l'application. Si l'hôte n'est pas spécifié lors de la connexion et si la variable SDESERVER n'est pas définie, l'application client essaie de se connecter à un service ArcSDE en cours d'exécution sur l'hôte local.

  set SDESERVER=bruno

• SDETMP

  La variable SDETMP vous permet de définir le répertoire temporaire pour les serveurs qui utilisent cette variable, mais il ne sera vérifié que si le mot-clé TEMP n'est pas défini dans la table SERVER_CONFIG.

  set SDETMP=c:\temp

• SDETRACELOC

  SDETRACELOC active le suivi et dirige l'application de connexion vers l'emplacement des fichiers de trace. Le suivi commence lors de la connexion initiale d'une application et s'arrête lors de la déconnexion de l'application.

  set SDETRACELOC=<path_to_trace_results_file>

• SDETRACEMODE

  SDETERACEMODE définit le type et la quantité d'informations consignées dans le fichier de trace. Le mode est défini par les paramètres suivants :

  Code	Définition	Description
  b	Mode succinct	N'affiche que les noms de fonctions
  v	Mode commentaire	Affiche les noms, ainsi que les valeurs en entrée, en sortie et les valeurs renvoyées
  m	Mode minute	Affiche le temps au format [minute:seconde] entre les appels de fonctions
  h	Mode heure	Affiche le temps au format [heure:minute:seconde]
  f	Mode forcé	Force la consignation de données dans le fichier de trace

  Codes du mode de traçage d'ArcSDE

  Le mode commentaire est prioritaire par rapport au mode succinct et le mode heure est prioritaire par rapport au mode minute. Par conséquent, si le mode est défini sur les valeurs succinct et commentaire, le mode commentaire est appliqué et si le mode est défini sur les valeurs minute et heure, le mode heure est appliqué. Si tous les cinq modes sont définis, le mode vhf est appliqué. Si vous ne définissez pas la variable SDETRACEMODE, sa valeur par défaut est vhf : mode commentaire, heure et forcé. Si vous utilisez une valeur de paramètre incorrecte pour la variable SDETRACEMODE, elle aura par défaut la valeur b : mode succinct.

• SDEUSER

  La variable SDEUSER spécifie le nom d'utilisateur de connexion de l'application client ArcSDE. La spécification du nom d'utilisateur par l'application remplace cette variable. Si cette variable n'est pas définie et si le nom utilisateur n'est pas spécifié dans l'application, un message d'erreur est renvoyé. Un nom utilisateur doit être spécifié.

  set SDEUSER=bob

  Ne définissez pas cette variable d'environnement si vous utilisez l'authentification du système d'exploitation pour vos connexions à la géodatabase. Avec cette définition, la connexion est tentée à l'aide de l'utilisateur défini par la variable d'environnement, ce qui échoue puisque vous essayez d'utiliser l'authentification du système d'exploitation.

• SDEVERBOSE

  La variable SDEVERBOSE indique la messagerie interne à l'écran de démarrage et consigne les messages de démarrage et d'arrêt du processus gsrvr dans le fichier sde.errlog.

  set SDEVERBOSE=TRUE

• TWO_TASK ou LOCAL

  Utilisez la variable TWO_TASK sur des serveurs UNIX ou Linux ou la variable LOCAL sur des serveurs Windows pour spécifier le nom de service réseau d'une base de données Oracle distante. Le nom de service réseau de la base de données Oracle est créé lors de la configuration d'Oracle. Reportez-vous à votre documentation Oracle pour savoir comment définir un nom de service réseau.

  set TWO_TASK=GRANITEO11G

  ou une classe de

  set LOCAL=BRONZEORA

  Remarque :

  vous pouvez utiliser la variable TWO_TASK ou LOCAL pour spécifier le nom de service réseau d'une base de données Oracle locale. Toutefois, cela n'est pas recommandé dans la mesure où cela provoque une surcharge de traitement lors de l'établissement d'une connexion à la base de données. Pour les connexions locales, utilisez plutôt Oracle_SID.