ArcGIS Server .NET Help - Variables de entorno

Las variables de entorno almacenan información para configuraciones específicas en el entorno del cliente que se conecta. Almacenan elementos como la ruta de un archivo o directorio específico, números de puerto y nombres de usuario.

La siguiente es una lista de las variables de entorno del archivo dbinit.sde o del sistema de Windows que puede configurar o desconfigurar, o especificar en la sintaxis de conexión directa que proporciona al conectarse a una geodatabase desde una aplicación cliente, como ArcGIS Desktop.

GIOMGRLOGREFRESH
Si desea que el archivo giomgr se sobrescriba cada vez que se inicie el servicio de ArcSDE, establezca la variable GIOMGRLOGREFRESH en verdadero. Si desea acumular los mensajes de registro (por defecto), no configure la variable.
```
set GIOMGRLOGREFRESH=TRUE
```
LOCATION_ERRLOG
La variable LOCATION_ERRLOG define el archivo en el que se registran los errores de ubicación de ArcSDE. El valor de esta variable debe contener el nombre calificado completo del archivo de registro. No es necesario que este archivo esté preparado antes de configurar la variable de entorno, ya que el marco de ubicación lo crea automáticamente. Los errores de ubicación de ArcSDE se registran en este archivo cada vez que la variable de entorno LOCATION_VERBOSE se establezca en verdadero.
```
set LOCATION_ERRLOG=c:\temp\location.errlog
```
LOCATION_VERBOSE
Establezca la variable de entorno LOCATION_VERBOSE en verdadero para registrar los errores de ubicación de ArcSDE. Si la variable de entorno LOCATION_ERRLOG también está establecida, los errores de ubicación se registran en el archivo especificado. Si no lo está, o si el archivo especificado no se puede crear, los errores de ubicación se registran en SDEHOME\etc\location.errlog.
```
set LOCATION_VERBOSE=TRUE
```
PGHOST o PGHOSTADDR
(Sólo en PostgreSQL) Utilice la variable PGHOTS para establecer el nombre del servidor en el cual se instala un cluster de bases de datos PostgreSQL remotas.
```
set PGHOST=orwell
```
O bien, establezca la variable PGHOSTADDR en la dirección IP del servidor de base de datos remoto.
```
set PGHOSTADDR=162.44.100.22
```
Estas dos configuraciones casi siempre son útiles cuando se conecta desde una instalación de ArcSDE a una base de datos PostgreSQL remota. Si esta base de datos no utiliza el número de puerto o conexión de dominio de UNIX predeterminados, deberá configurar la variable PGPORT.
PGPORT
(Sólo en PostgreSQL) Utilice la variable PGPORT para establecer el número de puerto TCP o la extensión del archivo de conexión de dominio de Unix del cluster de base de datos PostgreSQL a la que desea conectarse.
```
set PGPORT=6000
```
Para obtener más información sobre las variables de entorno de PostgreSQL, consulte la Documentación de PostgreSQL.
SDEATTEMPTS
Configure la variable SDEATTEMPTS de acuerdo a la cantidad de veces que desea que la sesión intente una conexión al servicio de ArcSDE. Bajo condiciones normales, solo se requiere un intento; sin embargo, si el servicio de ArcSDE se encuentra sobrecargado de solicitudes de conexión de muchos usuarios a la vez, se requieren varios intentos para que una sesión pueda establecer una conexión. Cada vez que una sesión falla en su intento de establecer una conexión, deja pasar el tiempo de espera para la IP. El administrador de la red es quien establece el tiempo de espera para la IP pero, en la mayoría de los sistemas operativos, el predeterminado es de 75 segundos. Por defecto, la variable SDEATTEMPTS está establecida en 4, que debería ser el valor adecuado para la mayoría de los entornos.
```
set SDEATTEMPTS=4
```
SDE_DATABASE
La variable SDE_DATABASE está disponible para el DBMS y cuenta con varios modos de conexión a las bases de datos dentro de un servidor de aplicaciones. Especificar la base de datos por medio de la aplicación invalida esta variable. Si la variable no se configura y la base de datos no se especifica en la conexión, el cliente de ArcSDE se conecta a la base de datos predeterminada.
```
set SDE_DATABASE=city_eng
```
Nota:

En ArcSDE 9.2 y versiones posteriores para DB2 e Informix en Windows, la base datos especificada bajo la clave de registro ADMIN_DATABASE tiene prioridad sobre la base de datos especificada con la variable SDE_DATABASE del archivo dbinit.
SDEDBECHO
Durante el inicio, la variable SDEDBECHO repite el contenido del archivo dbinit.sde. Para los servidores de aplicaciones de ArcSDE iniciados de forma local en un sistema UNIX, el resultado de esta variable se muestra en la pantalla. El resultado de la variable SDEDBECHO en un servidor de aplicaciones de ArcSDE con UNIX se escribe en el archivo sde.errlog correspondiente.
```
set SDEDBECHO=TRUE
```
SDEHOME
La variable SDEHOME especifica la ubicación donde se instalan los archivos de ArcSDE. También determina el servicio de ArcSDE en el que operarán los comandos administrativos. La opción –H de los comandos puede invalidar la variable.
```
set SDEHOME=d:\arcgis\arcsde
```
SDEINSTANCE
La variable SDEINSTANCE se establece en el entorno de la aplicación cliente y determina el nombre del servicio de ArcSDE al que se debe realizar la conexión. La especificación del servicio en la aplicación invalida esta variable. Si la variable no se establece y el nombre de servicio no se especifica en la aplicación, este último será, por defecto, esri_sde.
```
set SDEINSTANCE=esri_sde
```
SDEINTERCEPT
Si necesita obtener la información que el cliente o el servidor envían a través del puerto TCP/IP, deberá configurar la variable SDEINTERCEPT (junto con la variable SDEINTERCEPTLOC). Es posible que el servicio de atención al cliente de Esri le pida conseguir esta información para solucionar ciertos tipos de problemas. La recopilación de la difusión de red del cliente y del servidor puede ayudar al analista de soporte técnico a diagnosticar los problemas específicos del uno y del otro, ya que estas difusiones deben ser simétricas. Si son asimétricas, se muestra la información que no se recibe en uno de los dos destinos.

Después de configurar las variables SDEINTERCEPT y SDEINTERCEPTLOC, debe reiniciar el servicio de ArcSDE y reproducir los pasos del problema.

Para interceptar las difusiones de red, puede configurar la variable SDEINERCET con los siguientes marcadores: c: interceptar el nombre de comando API, r: interceptar las difusiones de canal de solo lectura, w: interceptar las difusiones de canal de solo escritura, t: interceptar el tiempo de registro (minutos:segundos) T: interceptar el tiempo de registro (horas:minutos:segundos) y f: interceptar los alineamientos inmediatos
```
set SDEINTERCEPT=crwtf
```
Cuando no necesite interceptar la información, puede realizar comentarios en las variables SDEINTERCEPT Y SDEINTERCEPTLOC del archivo dbinit.sde incluyendo el signo numeral (#) delante de ellas y reiniciando el servicio.
SDEINTERCEPTLOC
Configure la variable SDEINTERCEPTLOC, junto con la variable SDEINTERCEPT, para obtener la información que envía el cliente y el servidor a través del puerto TCP/IP.

Para este tipo de intercepción, establezca la variable SDEINTERCEPTLOC con el nombre de ruta completo del prefijo del nombre del archivo que recibe la información. Cuando se habilita la intercepción, se crea y escribe un archivo nuevo cada vez que una aplicación se conecta al servicio de ArcSDE. El archivo se cierra sólo después de que la aplicación se desconecta. ArcSDE genera un nombre de archivo a partir del prefijo proporcionado en la variable SDEINTERCEPTLOC incluyendo un número de extensión que comienza con .001 y lo incrementa de manera secuencial cada vez que se crea un archivo nuevo.
```
set SDEINTERCEPTLOC=D:\tmp\sde_server
```
Si un analista de soporte técnico de Esri le pide que intercepte información del cliente y del servidor, utilice nombres de prefijo diferentes para poder distinguir entre ellos. Por ejemplo, si establece la variable SDEINTERCEPTLOC en d:\tmp\sde_server en el archivo dbinit.sde, se capturan difusiones de red del servidor. Si establece la variable SDEINTERCEPTLOC en d:\tmp\sde_client en el entorno de la aplicación, se capturan las difusiones de red del cliente en el mismo directorio pero con un prefijo diferente.
SDELOGAPPEND
Nota:
Solo UNIX

Establezca la variable SDELOGAPPEND en verdadero si desea que el archivo de registro de error sde acumule mensajes de registro y no se trunque cada vez que se reinicie el servicio. Si desea que el archivo de registro de error sde se trunque en los inicios de sistema, no configure esta variable.
```
set SDELOGAPPEND=TRUE
```
SDENOIPTEST
Establezca la variable SDENOIPTEST en verdadero si no desea que ArcSDE analice el archivo HOSTS en busca del nombre SERVER. Por defecto, la variable no está establecida. La configuración de esta variable puede ser útil si no configuró el archivo HOSTS. El cliente intentará conectarse al servidor la cantidad de veces que marque la variable SDEATTEMPTS (por defecto, cuatro veces).
```
set SDENOIPTEST=TRUE
```
SDEPASSWORD
La variable SDEPASSWORD especifica la contraseña para el nombre de usuario que se introduce en la aplicación cliente de ArcSDE. Si especifica la contraseña en la herramienta de conexión de la aplicación, la variable se invalida. Si la variable no se configura y la contraseña no se especifica en la aplicación, esta última puede solicitar la contraseña. Si la aplicación no solicita la contraseña, se muestra un error.
```
set SDEPASSWORD=fools.gold
```
Si esto se configura así, se intenta una conexión utilizando la contraseña establecida en la variable de entorno. Si utiliza una autentificación de sistema operativo (SO), la contraseña falla, ya que se intenta utilizar la contraseña de inicio de sesión del SO. Esto siempre se aplica cuando se conecta a geodatabases de ArcSDE en SQL Server Express (servidores de geodatabases de ArcSDE).

Nota:
El almacenamiento de una contraseña en la variable de entorno SDEPASSWORD no es seguro y, por lo tanto, no es recomendable.
SDESERVER
La variable SDESERVER determina el host del servicio de ArcSDE correspondiente a la aplicación cliente que se conecta. Esta variable puede invalidarse al especificar el host en la aplicación. Si el host no está especificado al realizar una conexión y la variable SDESERVER no está establecida, la aplicación cliente intenta conectarse a un servicio de ArcSDE que se ejecuta en el host local.
```
set SDESERVER=bruno
```
SDETMP
La variable SDETMP le permite establecer el directorio temporal para los servidores que utilizan esta variable, pero solo se verificará si la palabra clave TEMP no está establecida en la tabla sde_server_config.
```
set SDETMP=c:\temp
```
SDETRACELOC
La variable SDETRACELOC habilita el seguimiento y direcciona la aplicación que se intenta conectar hacia la ubicación de los archivos de seguimiento. El seguimiento comienza cuando una aplicación se conecta por primera vez y termina cuando finaliza la conexión.
```
set SDETRACELOC=<path_to_trace_results_file>
```

SDETRACEMODE

La variable SDETERACEMODE establece el tipo y la cantidad de información que se escribe en el archivo de seguimiento. El modo se establece con los siguientes parámetros:

Código	Definición	Descripción
b	Modo rápido	Solo imprime nombres de función
v	Modo detallado	Imprime valores de nombre, de entrada, de salida y de retorno
m	Modo en minutos	Imprime el tiempo que transcurre entre la invocación de funciones en el formato [min:sec]
h	Modo en horas	Imprime el tiempo en el formato [hour:minute:second]
f	Modo de fuerza	Hace que los datos se escriban en el archivo de seguimiento

Códigos del modo de seguimiento de ArcSDE

El modo detallado tiene prioridad sobre el modo rápido, y el modo en horas tiene prioridad sobre el modo en minutos. Por lo tanto, si el modo se establece en rápido y detallado, se aplicará el modo detallado, y si se establece el modo en minutos y en horas, se aplicará el modo en horas. Si se establecen los cinco modos, se aplicará el modo vhf. Si no configura la variable SDETRACEMODE, se establecerá el valor por defecto (vhf): modo detallado, modo en horas, modo de fuerza. Si utiliza un valor de parámetro inválido con la variable SDETRACEMODE, se establecerá el valor por defecto (b): modo rápido.

SDEUSER
La variable SDEUSER especifica el nombre de usuario a través del cual se conecta la aplicación cliente de ArcSDE. La especificación del nombre de usuario en la aplicación invalida esta variable. Si la variable no se establece y el nombre de usuario no se especifica en la aplicación, se muestra un error. Se debe especificar un nombre de usuario.
```
set SDEUSER=bob
```
Si utiliza una autentificación de sistema operativo para las conexiones a geodatabases, no configure esta variable de entorno. Si lo hace, se intentará la conexión utilizando el usuario establecido con esta variable de entorno, y fallará, ya que se intenta utilizar la autentificación del sistema operativo.
SDEVERBOSE
La variable SDEVERBOSE muestra mensajes internos en la pantalla durante el inicio y escribe mensajes de inicio y finalización del proceso gsrvr en el archivo sde.errlog.
```
set SDEVERBOSE=TRUE
```

3/6/2012