Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
SQL Anywhere 11.0.1 (Deutsch) » SQL Anywhere Server - Datenbankadministration » Verwaltung Ihrer Datenbank » Dienstprogramme für die Datenbankadministration

 

Dienstprogramm für Supportanfragen (dbsupport)

Sendet Informationen über Fehler und Software-Nutzung an iAnywhere Solutions.

Syntax 
dbsupport [ Optionen ] Vorgang [ vorgangsspezifische_Option ]
dbsupport Konfigurationsoptionen
Option Beschreibung
@data

Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei einlesen. Weitere Hinweise finden Sie unter Konfigurationsdateien verwenden.

Wenn Sie Kennwörter oder andere Informationen in einer Konfigurationsdatei schützen möchten, können Sie das Dienstprogramm zum Verschleiern von Dateien verwenden. Weitere Hinweise finden Sie unter Dienstprogramm zum Verschleiern von Dateien (dbfhide).

-o Dateiname Ausgabe an die festgelegte Datei senden
-q Nur kritische Meldungen anzeigen
Vorgang Beschreibung
-e Konfigurationsoption

Einstellung für die angegebene Konfigurationsoption anzeigen. Beispiel: Angenommen, Sie haben folgenden Befehl ausgeführt, um dbsupport zur Eingabeaufforderung zu konfigurieren, wenn dies möglich ist: 

dbsupport -cc promptdefy

Wenn Sie den Befehl dbsupport -ecc ausführen werden folgende Einstellungen zurückgegeben: 

-cc "promptdefy"
-is Einsende-ID [ -rr N ]

Den Status eines Crash-Berichts prüfen, der an iAnywhere Solutions übermittelt wurde.

Der folgende Befehl fragt den Status der Einsende-ID 66 ab:

dbsupport -is 66
-iu [ -r N ]

Updates für Ihren Build von SQL Anywhere suchen.

Sie können auch nach Updates mit Interactive SQL und Sybase Central suchen. Weitere Hinweise finden Sie unter Nach Software-Updates suchen.

-lc Liste aller Crash-Berichte generieren, die nicht an iAnywhere Solutions übermittelt wurden. Die aufgelisteten Berichtsnamen können mit der Option -sc verwendet werden.
-ls

Liste aller Einsende-IDs für alle Berichte generieren, die an iAnywhere Solutions übermittelt wurden. Zum Beispiel:

dbsupport -ls

Dies gibt Informationen ähnlich wie die folgenden zurück:

Einsende-ID: 4
Minicore dump 20051220_133828_32116 gemeldet: Wed Mar 15 16:31:56 2006
Einsende-ID: 98
Minicore dump 20051229_221211_3221 gemeldet: Wed Mar 22 16:33:26 2006
-pc Dateiname Crash-Berichtsinformationen anzeigen. Sie können diese Option verwenden, um Informationen anzuzeigen, bevor sie an iAnywhere Solutions übertragen werden.
-pd Diagnoserinformationen anzeigen, die gesammelt wurden. Sie können diese Option verwenden, um Informationen anzuzeigen, bevor sie an iAnywhere Solutions übertragen werden.
-ps Einsende-ID

Informationen über einen bestimmten Bericht anzeigen, der an iAnywhere Solutions übermittelt wurde. Zum Beispiel:

dbsupport -ps 4

Dies gibt Informationen über Einsendung 4 zurück:

Minicore dump 20051220_133828_32116 reported: Wed Mar 15 16:31:56 2006
-sa [ -r Anzahl_der_Einsendungsneuversuche ] Alle Crash-Bericht- und Diagnoseinformationen im Diagnoseverzeichnis an iAnywhere Solutions übermitteln.
-sc Berichtname [ -r Anzahl_der_Einsendungsneuversuche ] [ -nr | -rr N ]

Crash-Bericht und Diagnoseinformationen an iAnywhere Solutions übermitteln. Zum Beispiel:

dbsupport -sc 20051220_133828_32116

Verwenden Sie die Option -lc, um eine Liste der Berichte zu generieren, die nicht eingesendet wurden.
-sd [ -r Anzahl_der_Einsendungsneuversuche ]

Alle Crash-Berichte und Diagnoseinformationen an iAnywhere Solutions übermitteln.

Weitere Hinweise zum Diagnoseverzeichnis finden Sie unter SADIAGDIR-Umgebungsvariable.

Konfigurationsoption Beschreibung
-cc [ autosubmit | no | promptDefY | promptDefN ]

Bedieneraufforderungsverhalten von dbsupport ändern. Sie können eine der folgenden Optionen festlegen:

  • autosubmit   Berichte automatisch einsenden.

  • no   Nicht zur Eingabe der Berechtigung, Berichte einzusenden, auffordern. Berichte und Funktionsstatistiken werden nicht übermittelt.

  • promptDefY   Wenn möglich zur Eingabe der Berechtigung, den Bericht einzusenden, auffordern. Wenn keine Antwort gegeben wird, wird der Bericht eingesendet.

  • promptDefN   Wenn möglich zur Eingabe der Berechtigung, den Bericht einzusenden, auffordern. Wenn keine Antwort gegeben wird, wird der Bericht nicht eingesendet. Dies ist die Standardeinstellung.

    Wenn Sie z.B. Embedded SQL in einer Anwendung benutzen, kann es sinnvoll sein, das SQL Anywhere-Dienstprogramm für Supportanfragen so zu konfigurieren, dass keine Berichte an iAnywhere Solutions gesendet werden.

Wenn Sie diese Option angeben, wird ihr Wert vom Dienstprogramm für Supportanfragen als Standardwert verwendet. Die Einstellung wird in der dbsupport.ini-Datei im Diagnoseverzeichnis gespeichert.

Der folgende Befehl konfiguriert das Dienstprogramm für Supportanfragen dergestalt, dass keine Berichte eingesendet werden und der Benutzer niemals aufgefordert wird, Berichte einzusenden: 

dbsupport -cc no
-cd Neuversuch-Verzögerung

Neuversuch-Verzögerung angeben, um die Verzögerung bei Neuversuchen (in Sekunden) zur Einsendung eines Berichts festzulegen, wenn der vorherige Versuch fehlgeschlagen ist. Der Standardverzögerung ist 30 Sekunden.

Wenn Sie diese Option angeben, wird ihr Wert vom Dienstprogramm für Supportanfragen als Standardwert verwendet. Die Einstellung wird in der dbsupport.ini-Datei im Diagnoseverzeichnis gespeichert.

Der folgende dbsupport-Befehl legt fest, dass fehlgeschlagene Übermittlungen alle 3 Sekunden bis zu einem Maximum von 4 Versuchen erneut versucht werden sollen, bis aufgegeben wird: 

dbsupport -cr 4 -cd 3
-ce E-Mail-Adresse;E-Mail-Server[:Port ][;Benutzer-ID:Kennwort ]

Adresse angeben, an die die E-Mail nach einem Crash geschickt werden soll. Die E-Mail wird über den SMTP-Server E-Mail-Server verschickt. Optional können Sie den Port angeben, der benutzt werden soll, und die Benutzer-ID sowie das Kennwort für die Authentifizierung auf dem SMTP-Server.

-cet Testen Sie die mit der -ce-Option angegebenen E-Mail-Einstellungen.
-ch Crash-Handler_Programm

Programm angeben, das aufgerufen wird, wenn ein Crash auftritt.

Wenn Sie diese Option angeben, wird ihr Wert vom Dienstprogramm für Supportanfragen als Standardwert verwendet. Die Einstellung wird in der dbsupport.ini-Datei im Diagnoseverzeichnis gespeichert.

Der Datenbankserver unterstützt drei Ersetzungsparameter, die Informationen einrichten, die dem Crash-Handler-Programm übergeben werden:

  • %F   Dieser Parameter wird durch den vollständigen Pfad zum Speicherort der generierten Berichtsdatei ersetzt.

  • %P   Dieser Parameter wird durch den Namen des Programms, das den Bericht generiert hat, ersetzt. Beispiel: Wenn ein Personal Datenbankserver der Version 11 den Bericht generiert, wird dbeng11 zurückgegeben.

  • %S   Dieser Parameter wird durch den Namen des Datenbankservers ersetzt, der im Einsatz war, als der Crash oder der schwerwiegende Fehler aufgetreten ist. Beispiel: Wenn ein Datenbankserver namens "Sample" den Bericht generiert hat, wird "Sample" zurückgegeben.

Sie können "$F", "$P" und "$S" als Alternativen zu "%F", "%P" bzw. "%S" verwenden. Da verschiedene Befehlsumgebungen die Zeichen "%" und "$" interpretieren, werden beide zur Verfügung gestellt. Unter Windows NT 4 z.B. wird "%F" durch den Wert der Umgebungsvariable "F" ersetzt, daher kann "$F" verwendet werden, um diese Ersetzung zu umgehen.

Nehmen wir an, Sie haben ein Crash-Handler-Programm unter c:\test.bat, das die folgenden Befehle enthält: 

copy %1 c:\archives
echo %2

Unter Windows teilt der folgende Befehl dbsupport mit, c:\test.bat mit zwei Parametern zu starten, wenn ein Crash eintritt. Wenn der Bericht eingesendet werden soll, wird dieses Programm aufgerufen, bevor der Bericht eingesendet wird. 

dbsupport -ch "c:\test.bat \"%F\" Parameter2"

Dieser durch %F angegebene Pfad wird an c:\test.bat als der erste Parameter gesendet. Der Parameter Param2 wird an c:\test.bat als der zweite Parameter gesendet. Beachten Sie, dass Anführungszeichen verwendet werden müssen, um einen Crash-Handler anzugeben, der Argumente nimmt.

Im Beispiel oben wurden zusätzliche Anführungszeichen um den vollständigen Pfad zur generierten Berichtsdatei verwendet. Um Probleme beim Zugriff auf die von dbsupport verwendete Berichtsdatei zu vermeiden, sollte der Crash-Handler seine eigene Kopie der Berichtsdatei erstellen.

-ch-

Crash-Handler-Einstellungen entfernen, die in der Datei dbsupport.ini gespeichert sind. Zum Beispiel: 

dbsupport -ch-
-cid Kunden-ID

Zeichenfolge angeben, durch die Sie im Einsendebericht identifiziert werden. Wenn Sie diese Option angeben, wird ihr Wert vom Dienstprogramm für Supportanfragen als Standardwert verwendet. Die Konfiguration wird in der dbsupport.ini-Datei im Diagnoseverzeichnis gespeichert.

Das folgende Beispiel legt eine Kunden-Identifizierungszeichenfolge für dbsupport fest:

dbsupport -cid myid@company.com

dbsupport -cid "MyClientApp 1.0"
-cid-

Die Zeichenfolge für die Kundenidentifizierung aus der Datei dbsupport.ini entfernen. Zum Beispiel: 

dbsupport -cid-
-cp { E-Mail_Server [ ::Port ] | autodetect }

Den HTTP-Proxy-Host und Port konfigurieren, die für die Übermittlung der Crash-Berichte verwendet werden.

Unter Windows wird auch die Syntax -cp autodetect unterstützt. Wenn Sie diese Option angeben und ein Proxy-Server und Port zur Verwendung des Internet Explorers eingestellt und derzeit aktiviert sind, konfiguriert dbsupport seinen Proxy-Server und Port unter Verwendung der Systemeinstellungen. Sie können den Proxy-Server und Port im Windows Internet Explorer einstellen, indem Sie Extras » Optionen » LAN-Einstellungen wählen.

-cp-

HTTP-Proxy-Host- und Port-Einstellungen aus der dbsupport.ini-Datei entfernen. Zum Beispiel: 

dbsupport -cp-
-cr Anzahl_der_Einsendungsneuversuche

Angeben, wie oft eine fehlgeschlagene Einsendung wiederholt werden soll.

Wenn Sie diese Option angeben, wird ihr Wert vom Dienstprogramm für Supportanfragen als Standardwert verwendet. Die Einstellung wird in der dbsupport.ini-Datei im Diagnoseverzeichnis gespeichert.

Der folgende dbsupport-Befehl legt fest, dass fehlgeschlagene Vorgänge alle 3 Sekunden bis zu einem Maximum von 4 Versuchen erneut versucht werden sollen, bis aufgegeben wird: 

dbsupport -cr 4 -cd 3
Vorgangsspezifische Option Beschreibung
-nr

Angeben, dass dbsupport den Server nicht auf den Status der Einsendung überprüfen soll. Der folgende Befehl z.B. sendet den Bericht ein, überprüft aber nicht den Status der neuen Einsendung: 

dbsupport -nr -sc 20051220_133828_32116

Standardmäßig überprüft dbsupport, ob es bereits eine Lösung für das eingesendete Problem gibt.
-r Anzahl_der_Einsendungsneuversuche Angeben, wie oft dbsupport maximal versuchen soll, die Einsendung zu wiederholen. Die Angabe 0 bedeutet unbegrenzte Neuversuche. Der Standardwert ist 10. Die Angabe der Option -r setzt den in der Datei dbsupport.ini gespeicherten Wert -cr außer Kraft, falls vorhanden.
-rd Neuversuch-Verzögerung Angeben, wie viele Sekunden dbsupport zwischen den Neuversuchen zur Übermittlung des Berichts abwartet. Der Standardwert ist 30. Die Angabe der Option -rd setzt den in der Datei dbsupport.ini gespeicherten Wert -cd außer Kraft, falls vorhanden.
-rr Anzahl_der_Einsendungsantwort-Neuversuche Angeben, wie oft dbsupport maximal versuchen soll, eine Antwort auf die Einsendung zu erhalten. Die Angabe 0 bedeutet unbegrenzte Neuversuche. Der Standardwert ist 10.
Bemerkungen

Das Dienstprogramm für Supportanfragen (dbsupport) kann für die folgenden Aufgaben verwendet werden:

  • Diagnoseinformationen und Crash-Berichte an iAnywhere Solutions über das Internet einsenden.

  • Funktionsstatistik einsenden.

  • Informationen über eingesendete und nicht-eingesendete Crash-Berichte auflisten.

  • Informationen über eingesendete und nicht-eingesendete Crash-Berichte drucken.

  • Den Status einer Einsendung abfragen.

  • Abfragen, ob Software-Updates für Ihre Version von SQL Anywhere verfügbar sind.

  • Aktionen konfigurieren, wenn ein schwerwiegender Fehler (Assertierung/Crash) von einem Datenbank- oder MobiLink-Server erkannt wird.

Standardmäßig überprüft dbsupport, ob es bereits eine Lösung für das eingesendete Problem gibt.

Informationen der folgenden Anwendungen können im Fall eines schwerwiegenden Fehlers ebenfalls als Fehlerbericht eingesendet werden:

Wenn ein Bericht erfolgreich eingesendet wurde, wird ihm eine eindeutige Einsende-ID zugeordnet. Berichte werden in das Diagnoseverzeichnis geschrieben.

Plattform Standard-Standort des Diagnoseverzeichnisses
Windows (außer Windows Mobile) %ALLUSERSPROFILE%\Anwendungsdaten\SQL Anywhere 11\diagnostics
Windows Mobile Verzeichnis, in dem die Programmdatei ausgeführt wird
Unix $HOME/.sqlanywhere11/diagnostics

Hinweise zum Diagnoseverzeichnis finden Sie unter SADIAGDIR-Umgebungsvariable.

Hinweise zu Fehlerberichten und wie sie eingesendet werden, finden Sie unter Fehlerberichte in SQL Anywhere.

Das Dienstprogramm für Supportanfragen kann so konfiguriert werden, dass bestimmte Aktionen durchgeführt werden, wenn ein Problem entdeckt wird. Es kann z.B. konfiguriert werden, dass ein bestimmtes Handler-Programm immer dann ausgeführt wird, wenn der Datenbankserver einen Fehlerbericht einsendet. Diese Funktion ist nützlich, um Ihre eigenen benutzerdefinierten Aktionen dem Fehlerbehandlungsprozess hinzuzufügen.

Das Dienstprogramm für Supportanfragen kann auch so konfiguriert werden, dass bei bestimmten Vorgängen Neuversuche durchgeführt werden. Bei einer Berichtseinsendung kann es z.B. konfiguriert werden, dass der Vorgang in 30 Sekunden erneut versucht wird, bis zu einem Maximum von 10 Versuchen. Diese Funktion ist nützlich, wenn der Dienst möglicherweise zeitweilig nicht verfügbar ist.

Einstellungen für das Dienstprogramm für Supportanfragen werden in der dbsupport.ini-Datei im Diagnoseverzeichnis gespeichert.

Die vorgangspezifischen Optionen sind nützlich, um das Standardverhalten außer Kraft zu setzen, einschließlich von jenen Optionen, die in der dbsupport.ini-Datei gespeichert sind:

Siehe auch
Copyright © 2009, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.1