Umgebungsvariablen

Umgebungsvariablen dienen zur Speicherung von Informationen für bestimmte Einstellungen in der Umgebung des verbindenden Clients. Zu diesen Informationen zählen beispielsweise Verzeichnis- und Dateipfade, Portnummern und Benutzernamen.

Nachfolgend finden Sie eine Liste der Umgebungsvariablen, die Sie in der Datei "dbinit.sde" oder in den Windows-Systemeinstellungen festlegen bzw. deaktivieren oder aber in der direkten Verbindungssyntax angeben können, die beim Herstellen einer Verbindung von einer Client-Anwendung wie ArcGIS Desktop zu einer Geodatabase bereitgestellt wird.

• GIOMGRLOGREFRESH

  Setzen Sie GIOMGRLOGREFRESH auf TRUE, wenn die Datei "giomgrd.log" bei jedem Start des ArcSDE-Diensts überschrieben werden soll. Wenn Sie die Protokolle sammeln möchten (Standardeinstellung), legen Sie diese Variable nicht fest.

  set GIOMGRLOGREFRESH=TRUE

• LOCATION_ERRLOG

  LOCATION_ERRLOG bestimmt die Datei, in der ArcSDE-Standortfehler protokolliert werden. Der Wert für diese Umgebungsvariable sollte den vollständigen qualifizierten Namen der Protokolldatei enthalten. Diese Datei muss nicht existieren, bevor die Umgebungsvariable gesetzt ist, da die Standortumgebung sie automatisch erstellt. ArcSDE-Standortfehler werden in dieser Datei protokolliert, wenn die Umgebungsvariable LOCATION_VERBOSE auf TRUE gesetzt ist.

  set LOCATION_ERRLOG=c:\temp\location.errlog

• LOCATION_VERBOSE

  Setzen Sie die Umgebungsvariable LOCATION_VERBOSE auf TRUE, um die ArcSDE-Standortfehler zu protokollieren. Wenn auch die Umgebungsvariable LOCATION_ERRLOG gesetzt ist, werden die Standortfehler in der angegebenen Datei protokolliert. Wenn die Umgebungsvariable LOCATION_ERRLOG nicht gesetzt ist oder die angegebene Datei nicht erstellt werden kann, werden die Standortfehler in SDEHOM\etc\location.errlog protokolliert.

  set LOCATION_VERBOSE=TRUE

• SDEATTEMPTS

  Setzen Sie SDEATTEMPTS auf die Anzahl, wie häufig die Sitzung versuchen soll, eine Verbindung zu einem ArcSDE-Dienst herzustellen. Unter normalen Bedingungen ist nur ein Versuch erforderlich. Wenn der ArcSDE-Dienst jedoch zu beschäftigt ist, die Verbindungsanforderungen vieler Benutzer gleichzeitig zu erfüllen, sind u. U. mehrere Versuche erforderlich, bevor eine Sitzung eine Verbindung herstellen kann. Bei jedem Fehlschlagen einer Verbindungsherstellung, wartet die Sitzung, bis das IP-Timeout eintritt. Das IP-Timeout wird vom Netzwerkadministrator festgelegt; die Standardeinstellung bei den meisten Betriebssystemen ist 75 Sekunden. Standardmäßig ist SDEATTEMPTS auf 4 gesetzt. Dies sollte für die meisten Umgebungen geeignet sein.

  set SDEATTEMPTS=4

• SDE_DATABASE

  SDE_DATABASE kann für das DBMS eingegeben werden, das eine Verbindung mehrerer Datenbanken über einen Anwendungsserver ermöglicht. Wenn Sie die Datenbank über die Anwendung angeben, wird diese Variable überschrieben. Wenn die Variable nicht gesetzt ist und die Datenbank bei der Verbindung nicht angegeben wurde, stellt der ArcSDE-Client eine direkte Verbindung zur Standarddatenbank her.

  set SDE_DATABASE=city_eng

  Hinweis:

  Ab ArcSDE 9.2 für DB2 und Informix unter Windows hat die im Registrierungsschlüssel ADMIN_DATABASE angegebene Datenbank Vorrang vor der Datenbank, die mit der Variablen SDE_DATABASE in der Datei "dbinit" festgelegt wird.

• SDEDBECHO

  SDEDBECHO spiegelt den Inhalt der Datei "dbinit.sde" während des Starts wider. Bei ArcSDE-Anwendungsservern, die lokal auf einem UNIX-System gestartet werden, wird die Ausgabe von SDEDBECHO am Bildschirm angezeigt. Die SDEDBECHO-Ausgabe für einen ArcSDE-Anwendungsserver, der auf einem Remote-UNIX-ArcSDE-Anwendungsserver gestartet wird, wird in die Datei "sde.errlog" geschrieben.

  set SDEDBECHO=TRUE

• SDEHOME

  SDEHOME gibt das Verzeichnis an, in dem die ArcSDE-Dateien installiert werden. Außerdem wird hiermit festgelegt, auf welchem ArcSDE-Dienst die administrativen Befehle ausgeführt werden. Diese Variable kann mit der Option "–H" der Befehle überschrieben werden.

  set SDEHOME=d:\arcgis\arcsde

• SDEINSTANCE

  SDEINSTANCE wird in der Umgebung der Client-Anwendung gesetzt und bestimmt, mit welchem ArcSDE-Dienstnamen eine Verbindung hergestellt wird. Wenn Sie den Dienst in der Anwendung festlegen, wird diese Variable überschrieben. Wenn diese Variable nicht gesetzt ist und der Dienstname nicht in der Anwendung angegeben wurde, wird standardmäßig der Dienstname "esri_sde" verwendet.

  set SDEINSTANCE=esri_sde

• SDEINTERCEPT

  Wenn Sie Informationen erfassen müssen, die der Client oder Server über den TCP/IP-Port versendet, müssen Sie die Variable SDEINTERCEPT (zusammen mit der Variablen SDEINTERCEPTLOC) einrichten. Ein Mitarbeiter des Esri Customer Supports bittet Sie unter Umständen, diese Informationen zu erfassen, um bestimmte Probleme zu beheben. Wenn Sie sowohl Client- als auch Server-Übertragungen erfassen, kann der Technische Support spezifische Client- oder Server-Probleme diagnostizieren, da die Übertragungen symmetrisch sein sollten. Jede asymmetrische Übertragung deutet darauf hin, dass Informationen an einem Ende nicht empfangen werden.

  Nachdem Sie dies und die Variable SDEINTERCEPTLOC festgelegt haben, müssen Sie den ArcSDE-Dienst neu starten und die Schritte, die zum Problem geführt haben, wiederholen.

  Sie können für die Variable SDEINTERCEPT auch die folgenden Flags festlegen, um Netzwerkübertragungen abzufangen: c – Abfangen des API-Befehlsnamens, r – Abfangen der schreibgeschützten Kanalübertragungen, w – Abfangen der lesegeschützten Kanalübertragungen, t – Abfangen der Protokollierungszeit (Minute:Sekunde), T – Abfangen der Protokollierungszeit (Stunde:Minute:Sekunde) und f – Informationen sofort und ungepuffert schreiben

  set SDEINTERCEPT=crwtf

  Wenn Sie die Informationen nicht mehr abfangen müssen, können Sie die Variablen SDEINTERCEPT und SDEINTERCEPTLOC in der Datei "dbinit.sde" deaktivieren, indem Sie das #-Symbol vor den Variablen einfügen und dann den Dienst neu starten.

• SDEINTERCEPTLOC

  Wenn Sie Informationen erfassen möchten, die der Client oder Server über den TCP/IP-Port versendet, richten Sie die Variable SDEINTERCEPTLOC zusammen mit der Variablen SDEINTERCEPT ein.

  Legen Sie zum Abfangen von Übertragungen vom Client und Server die Variable SDEINTERCEPTLOC den vollständigen Pfadnamen des Dateinamenpräfixes fest, der die Informationen empfängt. Wenn das Abfangen aktiviert ist, wird eine neue Datei erstellt und erweitert, sobald eine Anwendung eine Verbindung zum ArcSDE-Dienst herstellt. Die Datei wird erst geschlossen, nachdem die Anwendungsverbindung getrennt wurde. ArcSDE erstellt aus dem Präfix in SDEINTERCEPTLOC einen Dateinamen, indem eine Nummer angehängt wird, beginnend bei .001. Diese Zahl wird mit jeder neu erstellten Datei aufwärts gezählt.

  set SDEINTERCEPTLOC=D:\tmp\sde_server

  Wenn ein Mitarbeiter des Technischen Supports von Esri Sie bittet, die Ausgabe vom Client und Server abzufangen, verwenden Sie eindeutige Präfixnamen, um zwischen den Client und dem Server unterscheiden zu können. Wenn Sie beispielsweise in der Datei "dbinit.sde" SDEINTERCEPTLOC auf "d:\tmp\sde_server" setzen, werden die Server-Netzwerkübertragungen erfasst. Wenn Sie in der Anwendungsumgebung SDEINTERCEPTLOC auf "d:\tmp\sde_client" setzen, werden die Client-Netzwerkübertragungen im gleichen Verzeichnis aber mit einem anderen Präfix erfasst.

• SDELOGAPPEND
  Hinweis:

  Nur UNIX

  Setzen Sie SDELOGAPPEND auf TRUE, wenn die Protokolldatei "sde error" bei jedem Neustart des Dienstes die Protokollmeldungen speichern und selbst nicht abgeschnitten werden soll. Setzen Sie die Variable nicht, wenn die Protokolldatei "sde error" beim Start abgeschnitten werden soll.

  set SDELOGAPPEND=TRUE

• SDENOIPTEST

  Setzen Sie SDENOIPTEST auf TRUE, wenn Sie ArcSDE nicht auf das Vorhandensein des SERVER-Namens in der Datei HOSTS überprüfen möchten. Standardmäßig ist SDENOIPTEST nicht gesetzt. Das Festlegen dieser Variablen kann nützlich sein, wenn Sie die Datei HOSTS nicht eingerichtet haben. Der Client versucht eine Verbindung zum Server für SDEATTEMPTS (standardmäßig viermal) herzustellen.

  set SDENOIPTEST=TRUE

• SDEPASSWORD

  SDEPASSWORD bestimmt das Kennwort für den von der ArcSDE-Client-Anwendung eingegebenen Benutzernamen. Wenn Sie das Kennwort auf dem Anwendungsverbindungswerkzeug festlegen, wird diese Variable überschrieben. Wenn die Variable nicht gesetzt ist und das Kennwort nicht in der Anwendung angegeben wurde, werden Sie von der Anwendung aufgefordert, das Kennwort einzugeben. Wenn keine Aufforderung zur Eingabe des Kennwortes angezeigt wird, wird ein Fehler zurückgegeben.

  set SDEPASSWORD=fools.gold

  Wenn Sie dies festlegen, wird versucht, eine Verbindung mit dem Kennwort herzustellen, das mit dieser Umgebungsvariablen gesetzt wird. Bei der Betriebssystemauthentifizierung schlägt dies fehl, da Sie versuchen, das Kennwort für das Login der Betriebssystemauthentifizierung zu verwenden. Dies gilt immer für Verbindungen zu ArcSDE-Geodatabases für SQL Server Express (ArcSDE-Datenbankserver).

  Hinweis:

  Ein Kennwort mit der SDEPASSWORD-Umgebungsvariable zu speichern ist nicht sicher und wird nicht empfohlen.
• SDESERVER

  SDESERVER bestimmt den Host des ArcSDE-Diensts für die Verbindung zur Client-Anwendung. Wenn Sie den Host in der Anwendung festlegen, wird diese Variable überschrieben. Wenn der Host während der Verbindung nicht festgelegt wird und die Variable SDESERVER nicht gesetzt ist, versucht die Client-Anwendung eine Verbindung zum ArcSDE-Dienst auf dem lokalen Host herzustellen.

  set SDESERVER=bruno

• SDETMP

  Mit SDETMP können Sie das temporäre Verzeichnis für die Server einrichten, die Variable ist jedoch nur aktiviert, wenn das Schlüsselwort TEMP in der Tabelle server_config nicht festgelegt ist.

  set SDETMP=c:\temp

• SDETRACELOC

  SDETRACELOC ermöglicht die Verfolgung und verweist die Verbindungsanwendung auf den Speicherort der Verfolgungsdateien. Die Verfolgung beginnt, wenn zum ersten Mal eine Verbindung hergestellt wird, und endet, wenn die Anwendung die Verbindung trennt.

  set SDETRACELOC=<path_to_trace_results_file>

• SDETRACEMODE

  SDETERACEMODE legt den Typ und die Menge der Informationen fest, die in die Verfolgungsdatei geschrieben werden. Der Modus wird mit den folgenden Parametern festgelegt:

  Code	Definition	Beschreibung
  b	Kurzmodus (Brief)	Druckt nur Funktionsnamen
  v	Ausführlicher Modus (Verbose)	Druckt Namen, Eingabe-, Ausgabe- und Rückgabewerte
  m	Minutenmodus	Druckt die Zeit im Format [Min:Sek] zwischen Funktionsaufrufen
  h	Stundenmodus	Druckt die Zeit im Format [Stunde:Minuten:Sekunden]
  f	Zwangmodus (Force)	Erzwingt, dass Daten in die Verfolgungsdatei geschrieben werden

  Parameter für den ArcSDE-Verfolgungsmodus

  Der ausführliche Modus hat Vorrang vor dem Kurzmodus, und der Stundenmodus hat Vorrang vor dem Minutenmodus. Das heißt: Wenn der Kurzmodus und der ausführliche Modus aktiviert sind, wird der ausführliche Modus angewendet, und wenn der Minuten- und Stundenmodus aktiviert sind, wird der Stundenmodus angewendet. Wenn alle fünf Modi gesetzt sind, wird der vhf-Modus angewendet. Wenn Sie SDETRACEMODE nicht einrichten, wird standardmäßig "vhf" (ausführlicher Modus, Stundenmodus, Zwangsmodus) angewendet. Wenn Sie einen ungültigen Parameterwert mit SDETRACEMODE verwenden, wird der Wert standardmäßig auf "b:" (Kurzmodus) gesetzt.

• SDEUSER

  SDEUSER bestimmt den Benutzernamen, über den die ArcSDE-Client-Anwendung eine Verbindung herstellt. Wenn Sie den Benutzernamen in der Anwendung festlegen, wird diese Variable überschrieben. Wenn diese Variable nicht gesetzt ist und der Benutzername nicht in der Anwendung angegeben wurde, wird ein Fehler zurückgegeben. Es muss ein Benutzername angegeben werden.

  set SDEUSER=bob

  Setzen Sie nicht diese Umgebungsvariable, wenn Sie für die Geodatabase-Verbindungen die Betriebssystemauthentifizierung verwenden. Wenn Sie dies festlegen, wird versucht, eine Verbindung mit dem Benutzer herzustellen, der mit dieser Umgebungsvariablen gesetzt wird. Dies schlägt fehl, da Sie versuchen, die Betriebssystemauthentifizierung zu verwenden.

• SDEVERBOSE

  Mit SDEVERBOSE werden interne Meldung auf dem Bildschirm beim Start ausgegeben und gsrvr-Prozessstart- und -endmeldungen in "sde.errlog" geschrieben.

  set SDEVERBOSE=TRUE