ArcGIS Server Java Help - 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
```
PGHOST ou PGHOSTADDR
(PostgreSQL uniquement) Utilisez la variable PGHOST pour définir le nom du serveur sur lequel un cluster de bases de données PostgreSQL distant est installé.
```
set PGHOST=orwell
```
Vous pouvez également définir PGHOSTADDR sur l'adresse IP du serveur de base de données distant.
```
set PGHOSTADDR=162.44.100.22
```
Ces deux paramètres sont principalement utiles si vous vous connectez à partir d'une installation ArcSDE sous Linux à une base de données PostgreSQL distante. Si la base de données PostgreSQL distante n'utilise pas le numéro de port ou le socket de domaine Unix par défaut, vous devez également définir la variable PGPORT.
PGPORT
(PostgreSQL uniquement) Utilisez la variable PGPORT pour définir le numéro de port TCP ou l'extension de fichier de socket de domaine Unix du cluster de bases de données PostgreSQL distant auquel vous souhaitez vous connecter.
```
set PGPORT=6000
```
Pour en savoir plus sur les variables d'environnement PostgreSQL, consultez la documentation PostgreSQL.
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
```
SDE_DATABASE
SDE_DATABASE peut être utilisée pour le SGBD et présente plusieurs possibilités de connexion à des bases de données sur un même serveur d'applications. La spécification de la base de données à l'aide de l'application remplace cette variable. Si la variable n'est pas définie et si la base de données n'est pas spécifiée lors de la connexion, le client ArcSDE se connecte à la base de données par défaut.
```
set SDE_DATABASE=city_eng
```
Remarque :

Dans ArcSDE 9.2 et les versions ultérieures pour DB2 et Informix sous Windows, la base de données spécifiée dans la clé du registre ADMIN_DATABASE est prioritaire par rapport à la base de données spécifiée par la variable SDE_DATABASE du fichier dbinit.
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 sde_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
```

3/6/2012