エラーやソフトウェアの使用状況に関する情報を iAnywhere Solutions に送信します。
dbsupport [ options ] operation [ operation-specific-option ]
dbsupport configuration-options
オプション | 説明 |
---|---|
@data |
指定された環境変数または設定ファイルからオプションを読み込みます。設定ファイルを参照してください。 設定ファイル内のパスワードなどの情報を保護する場合は、ファイル非表示ユーティリティを使用して、設定ファイルの内容を読みにくくすることができます。ファイル非表示ユーティリティ (dbfhide)を参照してください。 |
-o filename | 指定されたファイルに出力を送信します。 |
-q | 重要なメッセージだけを表示します。 |
操作 | 説明 | ||||
---|---|---|---|---|---|
-e configuration-option |
指定された設定オプションの設定を表示します。たとえば次のコマンドを実行して、可能な場合にはプロンプトを表示するように dbsupport を設定したとします。
この場合、
設定ファイルの現在の値が明示的に設定されていない場合は、エコーされません。 |
||||
-is submission-ID [ -rr N ] |
iAnywhere Solutions に送信されたクラッシュレポートのステータスをチェックします。 たとえば、次のコマンドは送信 ID 66 のステータスを返します。
|
||||
-iu [ -r N ] |
使用している SQL Anywhere のビルドに対する更新をチェックします。次の更新があります。
更新については、Interactive SQL と Sybase Central を使用して確認することもできます。ソフトウェアの更新を参照してください。 |
||||
-lc | iAnywhere Solutions に送信されていないすべてのクラッシュレポートのリストを作成します。リストされるレポート名には、-sc オプションを使用できます。 | ||||
-ls |
iAnywhere Solutions に送信されたすべてのレポートの送信 ID のリストを作成します。次に例を示します。
このコマンドは次のような情報を返します。
|
||||
-pc filename | クラッシュレポートの情報を表示します。このオプションを使用すると、情報を確認してからレポートを iAnywhere Solutions に送信できます。 | ||||
-pd | 収集された診断情報を表示します。このオプションを使用すると、情報を確認してからレポートを iAnywhere Solutions に送信できます。 | ||||
-ps submission-ID |
iAnywhere Solutions に送信された特定のレポートに関する情報を表示します。次に例を示します。
このコマンドは送信 ID 4 の情報を返します。
|
||||
-sa [ -r number-of-submission-retries ] | 診断ディレクトリに保存されているすべてのクラッシュレポートと診断情報を、iAnywhere Solutions に送信します。 | ||||
-sc reportname [ -r number-of-submission-retries ] [ -nr | -rr N ] |
クラッシュレポートと診断情報を iAnywhere Solutions に送信します。次に例を示します。
-lc オプションを使用すると、送信されていないレポートのリストを参照できます。 |
||||
-sd [ -r number-of-submission-retries ] |
診断情報だけを iAnywhere Solutions に送信します。 診断ディレクトリの詳細については、SADIAGDIR 環境変数を参照してください。 |
設定オプション | 説明 | ||||
---|---|---|---|---|---|
-cc [ autosubmit | no | promptDefY | promptDefN ] |
dbsupport によるプロンプトの動作を変更します。次のいずれかのオプションを指定できます。
このオプションを指定すると、その値がデフォルトとしてサポートユーティリティに使用されます。設定は、診断ディレクトリ内の dbsupport.ini ファイルに保存されます。 次のコマンドは、レポートを送信せず、ユーザーに対してレポート送信の確認メッセージを表示しないように、サポートユーティリティを設定します。
|
||||
-cd retry-delay |
レポートの送信が失敗した場合にリトライするまでの遅延時間を秒単位で指定します。デフォルトの遅延時間は 30 秒です。 このオプションを指定すると、その値がデフォルトとしてサポートユーティリティに使用されます。設定は、診断ディレクトリ内の dbsupport.ini ファイルに保存されます。 次の dbsupport コマンドでは、送信が失敗した場合に 3 秒間隔で最大 4 回リトライするように指定しています。
|
||||
-ce email-address;email-server[:port ][;user-id:password ] |
クラッシュの発生後に電子メールを送信するアドレスを指定します。電子メールは、email-server SMTP サーバーを使用して送信されます。必要に応じて、使用するポートや、SMTP サーバーでの認証に使用する user-id と password を指定できます。 |
||||
-cet | -ce オプションで指定した電子メール設定をテストします。 | ||||
-ch crash-handler-program |
クラッシュが発生したときに呼び出すプログラムを指定します。 このオプションを指定すると、その値がデフォルトとしてサポートユーティリティに使用されます。設定は、診断ディレクトリ内の dbsupport.ini ファイルに保存されます。 データベースサーバーは、crash-handler-program に渡す情報を構築する 3 つの代入パラメーターをサポートしています。
%F、%P、%S の代わりに $F、$P、$S を使用できます。% と $ の解釈がコマンドシェルによって異なるため、両方の文字を提供しています。たとえば、4NT では %F が環境変数 F の値に置き換えられるため、それを回避するために $F を使用できます。 c:\test.bat にクラッシュハンドラープログラムがあり、次のコマンドが含まれているとします。
Windows では、クラッシュが発生した場合、次のコマンドによって dbsupport が c:\test.bat を起動し、2 つのパラメーターを渡します。レポートを送信する場合は、このプログラムが呼び出された後でレポートが送信されます。
%F に指定されたパスが 1 つ目のパラメーターとして c:\test.bat に渡されます。2 つ目のパラメーターとして、parm2 が c:\test.bat に渡されます。引数を取るクラッシュハンドラープログラムを指定する場合は引用符が必要です。 上記の例では、生成されたレポートファイルのフルパスを引用符で囲んでいます。dbsupport が使用中であるためにレポートファイルにアクセスできなくなるという問題を回避するために、クラッシュハンドラープログラムはレポートファイルの専用コピーを作成する必要があります。 |
||||
-ch- |
dbsupport.ini ファイルに格納されているクラッシュハンドラー設定を削除します。次に例を示します。
|
||||
-cid customer-id |
送信レポート内でユーザー自身を識別するための文字列を指定します。このオプションを指定すると、その値がデフォルトとしてサポートユーティリティに使用されます。設定は、診断ディレクトリ内の dbsupport.ini ファイルに保存されます。 次の例は、dbsupport に対してカスタマー ID 文字列を指定しています。
|
||||
-cid- |
dbsupport.ini ファイルからカスタマー ID 文字列を削除します。次に例を示します。
|
||||
-cp { email-server [ :port ] | autodetect } |
エラーレポートの送信に使用する HTTP プロキシのホストとポートを設定します。 Windows では、-cp autodetect の構文もサポートされます。このオプションを指定し、Internet Explorer でプロキシサーバーとポートが設定され、現在有効である場合、dbsupport はそのシステム設定に基づいてプロキシサーバーとポートを設定します。Internet Explorer で、プロキシサーバーとポートを設定しなければならない場合があります。 |
||||
-cp- |
dbsupport.ini ファイルから HTTP プロキシのホストとポートの設定を削除します。次に例を示します。
|
||||
-cr number-of-submission-retries |
送信が失敗した場合のリトライ回数を指定します。 このオプションを指定すると、その値がデフォルトとしてサポートユーティリティに使用されます。設定は、診断ディレクトリ内の dbsupport.ini ファイルに保存されます。 次の dbsupport コマンドでは、操作が失敗した場合に 3 秒間隔で最大 4 回リトライするように指定しています。
|
操作固有のオプション | 説明 | ||
---|---|---|---|
-ac | 送信にコメントを追加します。 | ||
-af | 送信にファイルを付加します。-af オプションを複数回指定すると、送信に複数のファイルを付加できます。 | ||
-nr |
dbsupport がサーバーで送信のステータスをチェックしないことを指定します。たとえば、次のコマンドは、レポートを送信するだけで、その送信のステータスについてはチェックしません。
デフォルトでは、送信しようとしている問題について解決策がすでに提示されていないかどうかチェックします。 |
||
-r number-of-submission-retries | dbsupport がレポートの送信をリトライする最大回数を指定します。0 を指定すると、リトライ回数は無限となります。デフォルト値は 10 です。dbsupport.ini ファイルに -cr オプションが保存されている場合、-r を指定すると -cr の値は上書きされます。 | ||
-rd retry-delay | レポートを再送するまでの dbsupport の待ち時間を秒単位で指定します。デフォルト値は 30 です。dbsupport.ini ファイルに -cd オプションが保存されている場合、-rd を指定すると -cr の値は上書きされます。 | ||
-rr number-of-submission-response-retries | dbsupport が送信に対する応答の取得をリトライする最大回数を指定します。0 を指定すると、リトライ回数は無限となります。デフォルト値は 10 です。 |
SQL Anywhere プログラムで致命的なエラーまたはクラッシュが発生した場合は、エラー発生時のプログラムに関する技術情報を含むエラーレポートが作成されます。エラーレポートが作成されると、このレポートを SQL Anywhere サポートチームに提出するよう要求されます。サポートユーティリティ (dbsupport) を使用して、このレポートを提出することもできます。エラーレポートを送信すると、致命的なエラーやアサーションの原因の究明に役立つことがあります。エラーレポートが提出されると、テクニカルサポートの問い合わせで使用できる提出 ID を受け取ります。問題をテクニカルサポート部門に報告すると、このエラーファイルを送信することで、テクニカルサポート部門が問題をすばやく処理することができます。テクニカルサポートに連絡しない場合でも、製品の改良に役立てるために、エラーレポートを送信することをおすすめします。
サポートユーティリティ (dbsupport) では、次のタスクを実行できます。
診断情報とクラッシュレポートをインターネット経由で iAnywhere Solutions に送信する
機能の統計を送信する
送信済みおよび未送信のクラッシュレポートに関する情報を表示する
送信済みおよび未送信のクラッシュレポートに関する情報を出力する
送信のステータスを問い合わせる
使用中の SQL Anywhere のビルドに対応するソフトウェア更新のリリース状況を問い合わせる
致命的なエラー (アサーション/クラッシュ) を検出した場合の dbsupport の動作を設定する。たとえば、データベースサーバーがエラーレポートを送信するたびに、指定したハンドラープログラムを実行するように設定できます。この機能は、エラー処理プロセスにカスタムアクションを追加する場合に便利です。
レポートの再送回数を設定する。たとえば、レポートの送信については、リトライの間隔を 30 秒、最大回数を 10 回に設定することもできます。この機能によって、サービスが一時的に使用不能となった場合の対処方法を組み込むことができます。
サポートユーティリティの設定は、診断ディレクトリの dbsupport.ini ファイルに格納されます。
操作固有のオプションは、dbsupport.ini file に保存されている動作を含め、デフォルトの動作に優先させる場合に役立ちます。
グラフィカルな管理ツールで、エラーレポートを送信するオプションを削除するよう設定することができます。 管理ツールの設定を参照してください。
エラーレポートを送信しないように選択すると、レポートの内容はハードディスクの診断ディレクトリに残ります。このディレクトリは SQL Anywhere プログラムによって自動的に作成され、エラーレポートの保存と、サポートユーティリティ (dbsupport) の設定の格納にのみ使用されます。
診断ディレクトリの場所 診断ディレクトリの場所は、プラットフォームによって異なります。
Windows (Windows Mobile を除く)
SADIAGDIR 環境変数で指定されたディレクトリ (設定している場合)。
デフォルトの診断ディレクトリ:
Windows XP:%ALLUSERSPROFILE%\Application Data\SQL Anywhere 12\diagnostics
Windows Vista 以降:%ALLUSERSPROFILE%\SQL Anywhere 12\diagnostics
現在のディレクトリ。
テンポラリディレクトリ。SATMP 環境変数と、TMP、TMPDIR、TEMP 環境変数を参照してください。
Windows Mobile
実行可能ファイルのディレクトリ、またはそのディレクトリが書き込み可能でない場合。
現在のディレクトリ、またはそのディレクトリが書き込み可能でない場合。
テンポラリディレクトリ。Windows Mobile でのレジストリ設定を参照してください。
UNIX、Linux、OS X
SADIAGDIR 環境変数で指定されたディレクトリ (設定している場合)。
デフォルトの診断ディレクトリ:$HOME/.sqlanywhere12/diagnostics。
現在のディレクトリ。
テンポラリディレクトリ。SATMP 環境変数と、TMP、TMPDIR、TEMP 環境変数を参照してください。
UNIX では、データベースサーバーまたは Mobile Link サーバーをデーモンとして実行する場合やユーザーが root/nobody である場合、ユーザーのホームディレクトリにクラッシュレポートを書き込むことは推奨されません。
エラーレポートファイル名 エラーレポートのファイル名は、次のように構成されます。
アプリケーションを識別するプレフィクス
アプリケーションプレフィクス | アプリケーション |
---|---|
DBCONSOLE | SQL Anywhere コンソールユーティリティ |
ISQL | Interactive SQLユーティリティ |
LSN | Listener ユーティリティ |
MLC | Mobile Link クライアント |
MLS | Mobile Link サーバー |
ML_MON | Mobile Link モニター |
QAA | QAnywhere Agent |
SA | パーソナルデータベースサーバーまたはネットワークデータベースサーバー |
SCJ | Sybase Central |
SR | SQL Remote |
ソフトウェアのバージョンを示す数値
アンダースコアで連結された 2 つのフィールド (エラーレポートが作成されたときのタイムスタンプを示す)
アプリケーションの識別子
拡張子 .dmp
たとえば、SA12_20110620_133828_32116.dmp は、SQL Anywhere バージョン 12 のデータベースサーバーで、2011/06/20 の 1:38:28 に、プロセス 32116 から作成されたエラーレポートであることを示します。
この dbsupport のデフォルト動作を変更するには、-cc オプションを使用します。
次のコマンドは、ユーザーにメッセージを表示せず、自動的にエラーレポートを送信するように dbsupport を設定します。
dbsupport -cc autosubmit |
次のコマンドは、自動的なエラーレポート送信を無効にします。
dbsupport -cc no |
-lc オプションを使用してエラーレポートのリストを表示できます。
次のコマンドは、iAnywhere Solutions に送信されていないすべてのクラッシュレポートのリストを作成します。
dbsupport -lc |
-sa、-sc、または -sd オプションを使用してエラーレポートを手動で送信できます。
次のコマンドは、診断ディレクトリに保存されているすべてのクラッシュレポートと診断情報を、iAnywhere Solutions に送信します。
dbsupport -sa |
-ac オプションと -af オプションをそれぞれ指定して、エラーレポートと共にコメントとファイルを送信することもできます。
dbsupport -sc SA12_20080901_113308_3360 -ac "The message.txt file provides more information about this error report." -af c:\scenario.txt -af c:\message.txt |
![]() |
DocCommentXchange で意見交換できます
|
Copyright © 2012, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.1 |