支持实用程序 (dbsupport)

dbsupport [ options ] operation [ operation-specific-option ]

dbsupport configuration-options

选项	说明
@data	读取来自指定的环境变量或配置文件的选项。请参见配置文件。要保护口令或配置文件中的其它信息，可以使用文件隐藏实用程序 (dbhide) 对配置文件的内容进行模糊处理。请参见文件隐藏实用程序 (dbfhide)。
-o filename	将日志输出消息发送到指定文件。
-q	只显示重要的日志输出消息。

选项

说明

@data

读取来自指定的环境变量或配置文件的选项。请参见配置文件。

要保护口令或配置文件中的其它信息，可以使用文件隐藏实用程序 (dbhide) 对配置文件的内容进行模糊处理。请参见文件隐藏实用程序 (dbfhide)。

-o filename

将日志输出消息发送到指定文件。

-q

只显示重要的日志输出消息。

操作说明

-e configuration-option

显示指定配置选项的设置。例如，假设您运行以下命令来配置 dbsupport 在可能的情况下显示提示：

dbsupport -cc promptdefy

运行命令 dbsupport -ecc 时，会返回以下设置：

-cc "promptdefy"

如果配置选项的当前值从未进行过显式设置，将不会回写任何内容。

-is submission-ID [ -rr N ]

检查已提交给技术支持部门的崩溃报告的状态。

例如，以下命令将返回 ID 66 的提交状态：

dbsupport -is 66

-iu [ -r N ]

检查软件内部版本是否有更新。更新包括：

支持包 支持包是含有一个或多个错误修正的软件子集。错误修正软件列在更新程序的发行说明中。错误修正软件更新可能只适用于具有相同版本号的已安装软件。虽然已在该软件上进行了一些测试，但是除非您使用该软件对您的应用程序进行了全面测试，否则不要随应用程序分发这些文件。
次要版本 次要版本是一套完整的软件，它升级已安装的具有相同主版本号的较早版本的软件（版本号格式是 major.minor.build）。升级程序的发行说明中列出了错误修正软件和其它更改。

还可使用 Interactive SQL、Sybase Central 和 SQL Anywhere 控制台实用程序 (dbconsole) 检查是否有更新。请参见软件更新。

-lc 生成一份尚未提交给技术支持部门的所有崩溃报告的列表。所列出的报告名称可以与 -sc 选项一起使用。

-ls

生成已提交的所有报告的提交 ID 列表。例如：

dbsupport -ls

此命令返回的信息如下：

SQL Anywhere Support Utility Version 16.0.2040
Submission ID: 217756  reported: Wed Jul 30 15:54:43 2011
Submission ID: 217757  reported: Wed Jul 30 15:57:07 2011
Submission ID: 217759  reported: Wed Jul 30 16:14:24 2011
Submission ID: 217760  reported: Wed Jul 30 16:14:30 2011
Submission ID: 217761  reported: Wed Jul 30 16:28:12 2011
Submission ID: 221030  reported: Mon Sep 08 12:34:59 2011
Submission ID: 221031  reported: Mon Sep 08 12:35:05 2011

-pc filename 显示崩溃报告信息。通过此选项，可以在信息提交前进行查看。

-pd 显示已收集的诊断信息。通过此选项，可以在信息提交前进行查看。

-ps submission-ID

显示已提交的特定报告的信息。例如，运行命令 [dbsupport -ps 4] 将返回有关提交 4 的信息：

SQL Anywhere Support Utility Version 16.0.2040
Submission ID: 217756  reported: Wed Jul 30 15:54:43 2012

-sa [ -r number-of-submission-retries ] 提交存储在诊断目录中的所有崩溃报告和诊断信息。

-sc reportname [ -r number-of-submission-retries ] [ -nr | -rr N ]

提交崩溃报告和诊断信息。例如：

dbsupport -sc SA16_20051220_133828_32116

使用 -lc 选项可以查看未提交报告的列表。

-sd [ -r number-of-submission-retries ]

仅提交诊断信息。

有关诊断目录的详细信息，请参见SADIAGDIR 环境变量。

配置选项说明

-cc [ autosubmit | no | promptDefY | promptDefN ]

更改 dbsupport 的提示行为。可以指定以下选项之一：

autosubmit 自动提交崩溃报告，定期提交诊断报告。
no 不提示用户授权来提交报告。不提交报告。
promptDefY 在可能的情况下提示用户授权来提交报告。如果用户没有给予回答，则提交报告。
promptDefN 在可能的情况下提示用户授权来提交报告。如果用户没有给予回答，则不提交报告。这是缺省设置。
例如，如果正在应用程序中使用嵌入式 SQL Anywhere，则您可能希望将支持实用程序配置为不提交报告。

如果指定 -cc 选项，其值将成为支持实用程序 (dbsupport) 所用的缺省值。该设置存储于诊断目录的 dbsupport.ini 文件中。

以下命令将支持实用程序配置为不提交报告并且不提示用户提交报告：

dbsupport -cc no

请参见定期提交性能数据。

-cd retry-delay

指定自上次尝试失败后报告提交操作的重试延迟（以秒为单位）。缺省延迟为 30 秒。

如果指定此选项，其值将成为支持实用程序所用的缺省值。该设置存储于诊断目录的 dbsupport.ini 文件中。

以下命令指定每三秒将失败的提交重试一次，在放弃重试前重试次数可达四次：

dbsupport -cr 4 -cd 3

-ce email-address;email-server[:port ][;user-id:password ]

指定在出现崩溃后发出电子邮件的地址。将使用 email-server SMTP 服务器发送电子邮件。另外，也可以指定应使用的端口以及用于 SMTP 服务器验证的用户 ID 和口令。

-cet 测试由 -ce 选项指定的电子邮件设置。

-cid customer-id

指定一个用于在提交报告中标识您身份的字符串。如果指定此选项，其值将成为支持实用程序所用的缺省值。该配置存储于诊断目录的 dbsupport.ini 文件中。

以下示例为 dbsupport 指定一个客户标识字符串：

dbsupport -cid myid@company.com

dbsupport -cid "MyClientApp 1.0"

-cid-

从 dbsupport.ini 文件中删除客户标识字符串。

-cp { host [ :port ] | autodetect }

配置在提交错误报告时所用的 HTTP 代理主机和端口。缺省端口是 80。

如果在 Windows 上指定 [-cp autodetect] 并且设置了 Internet Explorer 的代理服务器和端口，则 dbsupport 会使用此系统设置来配置其代理服务器和端口。

如果在 Unix 上指定 [-cp autodetect] 并且设置了 HTTP_PROXY 环境变量，则 dbsupport 会使用此环境变量设置来配置其代理服务器和端口。

-cp-

从 dbsupport.ini 文件中删除 HTTP 代理主机和端口设置。

-cr number-of-submission-retries

指定对于失败的提交操作的重试次数。

如果指定此选项，其值将成为支持实用程序所用的缺省值。该设置存储于诊断目录的 dbsupport.ini 文件中。

以下命令指定每三秒将失败的操作重试一次，在放弃重试前重试次数可达四次：

dbsupport -cr 4 -cd 3

特定于操作的选项

说明

-ac

为提交添加注释。

-af

为提交附加文件。可多次指定 -af 选项，为提交附加多个文件。

-nr

指定 dbsupport 不在数据库服务器中检查提交状态。例如，以下命令将提交报告，但不检查这一新提交的状态：

dbsupport -nr -sc SA16_20051220_133828_32116

缺省情况下，dbsupport 会检查针对所提交的问题是否已经有解决方案。

-r number-of-submission-retries

指定 dbsupport 将尝试发送提交的最大次数。指定 0 表示重试次数无限制。缺省值为 10。指定 -r 时，将替换存储于 dbsupport.ini 中的 -cr 值（如果存在）。

-rd retry-delay

指定 dbsupport 在两次报告重发尝试之间等待的秒数。缺省值为 30。指定 -rd 时，将替换存储于 dbsupport.ini 文件中的 -cd 值（如果存在）。

-rr number-of-submission-response-retries

指定 dbsupport 将尝试获取提交响应的最大次数。指定 0 表示重试次数无限制。缺省值是 10。

无。

崩溃报告及诊断信息报告等性能数据有助于改善产品。

如果任何 SQL Anywhere 程序中发生致命错误或崩溃，将创建一个包含发生错误时程序技术信息的错误报告。错误报告创建完成后，系统会提示您将此报告提交到技术支持部门。

您还可以使用支持实用程序 (dbsupport) 提交此报告。提交错误报告有助于诊断致命错误或断言的原因。错误报告提交后，您将收到一个可以提供给技术支持部门的提交 ID。如果向技术支持部门报告问题，将此错误文件发送给他们可以加快问题的处理速度。即使您选择不联系技术支持部门，为了帮助改进产品，也建议您提交错误报告和诊断报告。

支持实用程序 (dbsupport) 可用于以下任何任务：

提交诊断信息和崩溃报告
提交功能统计信息
列出有关已提交和未提交崩溃报告的信息
打印有关已提交和未提交崩溃报告的信息
查询提交状态
查询针对您所用版本的 SQL Anywhere 是否有可用的软件更新
检测到致命错误（断言/崩溃）时的配置 dbsupport 行为。例如，可将 dbsupport 配置为在每次数据库服务器提交错误报告时运行指定的处理程序。要向错误处理程序添加自定义的操作时，此功能非常有用。
配置重新尝试发送报告的次数。例如，经过配置，它可以在提交报告时在 30 秒后再次重试这一操作，重试次数可达十次。在处理服务有可能会暂时无法使用的情况时，此功能非常有用。

支持实用程序的设置存储在诊断目录的 dbsupport.ini 文件中。

在替换缺省行为（包括存储于 dbsupport.ini 文件中的行为）时，特定于操作的选项非常有用。

可将图形管理工具配置为移除选项以提交错误报告。请参见管理工具配置。

如果选择不提交错误报告，该报告将保留在硬盘上的诊断目录中。此目录由软件程序自动创建，仅用于保存报告和存储支持实用程序 (dbsupport) 的设置。

诊断目录位置 诊断目录的位置因平台而异。
数据库服务器根据以下优先级顺序检查诊断目录：
- Windows（Windows Mobile 除外）
  1. 由 SADIAGDIR 环境变量指定的目录（如果设置）。
  2. 缺省诊断目录位置：
    
    在 Windows XP 上： %ALLUSERSPROFILE%\Application Data\SQL Anywhere 16\diagnostics.
    
    在 Windows Vista 和更高版本上： %ALLUSERSPROFILE%\SQL Anywhere 16\diagnostics.
  3. 当前目录。
  4. 临时目录。请参见 SATMP 环境变量以及 TMP、TMPDIR 和 TEMP 环境变量。
  在 Windows 上，诊断目录位于对计算机的所有用户均可写的位置。如果一台计算机具有多个用户帐户，并且您需要让其他用户无法访问错误报告，则可为每个用户将 SADIAGDIR 环境变量设为指向只对特定用户可读写的目录。请参见SADIAGDIR 环境变量。
- Windows Mobile
  1. 可执行文件的目录。
  2. 当前目录。
  3. 临时目录。请参见Windows Mobile 上的注册表设置。
- Unix、Linux、OS X
  1. 由 SADIAGDIR 环境变量指定的目录（如果设置）。
  2. 缺省诊断目录：$HOME/.sqlanywhere16/diagnostics。
  3. 当前目录。
  4. 临时目录。请参见 SATMP 环境变量以及 TMP、TMPDIR 和 TEMP 环境变量。
  注意
  
  在 Unix 上，当数据库或 MobiLink 服务器作为守护程序运行或用户为 root/nobody 时，建议不要将崩溃报告写入用户的主目录。

错误报告文件名称 错误报告文件名由以下部分组成：

标识应用程序的前缀：

应用程序前缀	应用程序
DBCONSOLE	SQL Anywhere 控制台实用程序
ISQL	Interactive SQL 实用程序
LSN	监听器实用程序
MLC	MobiLink 客户端
MLS	MobiLink 服务器
ML_MON	MobiLink 分析器
SA	个人或网络数据库服务器
SCJ	Sybase Central
SR	SQL Remote

表示软件版本的值
以下划线链接的两个字段，提供错误报告创建时间的时间戳
应用程序标识符
扩展名 .dmp

例如，SA16_20110620_133828_32116.dmp 是一个来自 SQL Anywhere 版本 16 数据库服务器的错误报告，日期为 2011/06/20，时间为下午 1:38:28，发生错误的进程是 32116。

SADIAGDIR 环境变量

可以通过 -cc 选项更改 dbsupport 的缺省行为：

以下命令会将 dbsupport 配置为不提示用户而自动提交报告：

dbsupport -cc autosubmit

以下命令会将 dbsupport 配置为自动提交报告并使用电子邮件服务器 emailserver.company.com 将通知电子邮件发送到 myemail@company.com：

dbsupport -cc autosubmit -ce "myemail@company.com";"emailserver.company.com:25"

以下命令会禁用报告自动提交功能：

dbsupport -cc no

可以通过 -lc 选项查看错误报告的列表。下面的命令会生成一份尚未提交的所有崩溃报告的列表：
dbsupport -lc
可以通过 -sa、-sc 或 -sd 选项手动提交错误报告。以下命令将提交诊断目录中存储的所有报告：
dbsupport -sa

可通过分别指定 -ac 和 -af 选项在错误报告中加入注释和文件：

dbsupport -sc SA16_20080901_113308_3360 -ac "The message.txt file provides more 
information about this error report." -af c:\scenario.txt -af c:\message.txt

支持实用程序 (dbsupport)

语法

特权

注释

注意

另请参见

示例