启用错误报告
ArcGIS Server 将收集和存储错误报告,您可通过自动 Web 报告或电子邮件(地址为 ArcGISErrorReport@esri.com)将这些错误报告发送给 ESRI 开发团队。开发团队将分析这些错误报告,以便了解错误原因并在将来的版本或补丁包中修复错误。
某些服务器错误无法重现,只是在系统超载或发生硬件故障时出现。错误报告的内容使 ESRI 开发团队了解到如何更好地设计软件以在将来避免出现此类错误。
如果您确实遇到了可重现的错误,则应与当地 ESRI 代表联系。提供再次产生错误的步骤时,也可以发送错误报告。可以将 ArcGIS Server 配置为将此类错误或故障报告存储在您所选择的目录中。
启用错误报告
ArcGIS Server 对象容器进程 (ArcSOC.exe) 自身不太可能崩溃,但可能出现以下情况:
- 变为无响应状态。
- 开始出现异常行为并将错误记录到日志文件。
- 被指示在使用超时后或在尝试恢复丢失的工作空间连接时退出。
如果您的站点出现上述错误,并且这些错误已妨碍用户工作流,可以考虑启用 ArcGIS Server 错误报告。可选择将这些报告自动提交到 ESRI,或可以根据需要通过电子邮件发送到 ESRI。
请执行以下步骤来启用 ArcGIS Server 错误报告:
- 停止 ArcGIS 服务器对象管理器 (SOM) 服务。在 Windows 中,通过导航到控制面板 > 管理工具 > 服务,可以找到此服务。
- 导航到 <ArcGIS 安装位置>\server\system。
- 查找 Server.dat 并为此文件创建备份副本。如果进行编辑时无意地损坏了 Server.dat 文件,可用此备份进行替换,轻松恢复损坏的文件。
- 在记事本中打开原始的 Server.dat 文件。
- 使用以下示例作为指南对 Server.dat 文件中的 ErrorReport 标记进行编辑:
<Server> . . . <Properties> . . . </Properties> <ErrorReportMode>2</ErrorReportMode> <ErrorReportModeSOM>3</ErrorReportModeSOM> <ErrorReportDir>\\MYSERVER\ErrorReports</ErrorReportDir> <ErrorReportEnableUpload>True</ErrorReportEnableUpload> <ErrorReportEmailAddress>myAdmin@myCompany.com</ErrorReportEmailAddress> <ErrorReportReportInterval>3600</ErrorReportInterval> <ErrorReportCacheSize>10</ErrorReportCacheSize> </Server>
以下是关于每个标记的详细信息:
<ErrorReportMode>
指定是否允许 ArcSOC.exe 进程崩溃以及发生崩溃时服务器应该完成的操作。可用的值如下:
- 0 - ArcSOC.exe 进程不能崩溃。
- 1 - 允许 ArcSOC.exe 进程崩溃并将消息写入日志文件。
- 2 - 允许 ArcSOC.exe 进程崩溃并将消息写入日志文件,同时将错误报告写入 <ErrorReportDir> 标签中指定的位置。
<ErrorReportModeSOM>
指定 ArcSOM.exe 进程是否生成错误报告。可用的值如下:
- 0 - ArcSOM.exe 进程不生成错误报告。
- 3 - ArcSOM.exe 进程生成错误报告。
注:值 1 和 2 不使用这一属性。
<ErrorReportDir>
ArcGIS Server 错误报告在磁盘上写入的路径。必须在生成任何错误报告之前设置该属性。
可以选择任何目录,但是 SOM 和 SOC 帐户必须可以写入该目录。如果 ArcGIS Server 配置包含多台计算机,则此路径应为指向共享位置的 UNC 路径,或每台 SOC 计算机上的相同本地路径。
<ErrorReportEnableUpload>
指定错误报告是否会自动通过 Web 发送到 ESRI。默认值为 False。True 值表示会发送错误报告。在启用自动错误报告之前,需要阅读并接受 ESRI 隐私策略中的条款。
<ErrorReportEmailAddress>
包含电子邮件地址的可选属性,ESRI 可使用该属性联系系统管理员以获得有关错误报告的详细信息。
<ErrorReportReportInterval>
时间间隔,用于指定 ArcGIS Server 检查错误报告目录中的新报告的频率(以秒为单位)。默认值为 3600(1 小时)。如果启用自动上传(使用 <ErrorReportEnableUpload> 标签),则检查期间找到的任何报告都会自动发送到 ESRI。
<ErrorReportCacheSize>
保留在错误报告输出目录中的错误报告的数量。默认值为 10。如果在短时间内累积了大量错误报告,而且 ArcSOC.exe 多次崩溃,那么可以增加该属性的值。如果已选择自动将错误报告发送到 ESRI,则报告会在发送后从目录中移除。然而,您始终可以在 SOM 帐户的用户配置文件目录中发现最近的 10 个报告。
- 保存 Server.dat 文件。
- 启动 ArcGIS 服务器对象管理器 (SOM) 服务。
错误报告可能会非常大(可能超过 100 MB)。使用 <ErrorReportCacheSize> 属性防止错误报告目录过长。如果使用低带宽的 Internet 连接,除非正在排除故障,否则请考虑使错误报告的自动上传功能保持禁用状态。
禁用错误报告
要禁用 ArcGIS Server 错误报告,请执行以下步骤:
- 停止 ArcGIS 服务器对象管理器 (SOM) 服务。在 Windows 中,通过导航到控制面板 > 管理工具 > 服务,可以找到此服务。
- 导航到 <ArcGIS 安装位置>\server\system,在文本编辑器中打开 Server.dat。也可以在编辑此文件前对其进行备份。
- 将 <ErrorReportMode> 和 <ErrorReportModeSOM> 标记的值更改为 0。
- 保存 Server.dat 文件。
- 清除错误报告目录(在 <ErrorReportDir> 标记中列出)中不需要的错误报告。
- 启动 ArcGIS 服务器对象管理器 (SOM) 服务。
发送错误报告
您可以选择将错误报告自动发送到 ESRI,或者通过电子邮件将错误报告发送至 ArcGISErrorReport@esri.com。如果决定使用电子邮件发送文件,您可根据需要确定是否在邮件中包含联系信息以及描述崩溃发生时所执行的操作的详细信息。如果您选择包括您的联系信息,ESRI 可能会询问您关于崩溃的更多信息。您可选择是否提供此信息。
除非 ESRI 开发人员要求您提供有关错误的详细信息,否则不会与您联系,要求您提供有关报告状态的信息。ESRI 支持部门不能提供有关您的报告状态的详细信息,除非您将此信息随同现有支持事件一起发送过来。
常见问题
以下列出有关错误报告的一些常见问题。
我是否能获得针对错误的修补程序?
ESRI 不会为没有可重复步骤的错误提供修补程序。如果您遇到的严重应用程序错误可重现,则应联系 ESRI 支持核实此问题。
ESRI 是否会提供错误发生位置的摘要信息?
ESRI 将对接收到的错误报告进行分析并确定软件发生错误的区域。修复程序将在补丁包或将来的版本中提供。
是否有使用管理器或 ArcCatalog 启用错误报告的方法?
启用或禁用错误报告的唯一方法是手动编辑 Server.dat 文件,如本主题所述。在编辑 Server.dat 文件之前,最好保存一份备份。