ArcGIS Server Java Help - 服务器配置文件

Server.dat 文件包含服务器的属性。服务器对象管理器 (SOM) 将在启动时读取该文件的内容。当成功读取了该文件且完成了其中详细说明的初始化要求之后，服务器将报告启动成功。如果文件中存在错误，SOM 会记录错误并尝试对缺失或无效的属性使用默认值来启动。

首次在计算机上安装 SOM 时，Server.dat 文件不存在。Server.dat 在启动 SOM 之后创建，并且将向 GIS 服务器添加服务器对象容器 (SOC) 计算机或服务器目录。

对于可以使用“管理器”或 ArcGIS Desktop 中的“目录”窗口更改的属性，请避免通过手动编辑 Server.dat 文件来实施更改。

警告:

必须在手动编辑 Server.dat 文件之前停止“ArcGIS Server 对象管理器”服务。应该在此时创建 Server.dat 文件的备份以防备在编辑过程中无意损坏文件。

下面是某个 GIS 服务器的 Server.dat 文件示例，该服务器带有单个容器计算机 (cup) 和记录级别为 3 的单个输出目录 (/net/cup/cup1/images)。

<Server> 
	<SecurityEnabled>false</SecurityEnabled>
	<ServerMachines> 
		<Machine> 
			<Name>cup</Name>
			<Description>Server container machine 1</Description>
			<Capacity>-1</Capacity> 
		</Machine>
	</ServerMachines>
	<ServerDirectories> 
		<Directory>
			<Path>/cup1/arcgis/server/serverdir/arcgiscache</Path>
			<URL>http://cup:8399/arcgis/server/arcgiscache</URL>
			<Description>Cache location</Description>
			<Type>cache</Type> 
		</Directory> 
		<Directory>
			<Path>/cup1/arcgis/server/serverdir/arcgisjobs</Path>
			<URL>http://cup:8399/arcgis/server/arcgisjobs</URL>
			<Description>Geoprocessing jobs location</Description>
			<Type>jobs</Type>
			<Cleaning>sliding</Cleaning>
			<MaxFileAge>21600</MaxFileAge> 
		</Directory>
		<Directory>
			<Path>/cup1/arcgis/server/serverdir/arcgisoutput</Path>
			<URL>http://cup:8399/arcgis/server/arcgisoutput</URL>
			<Description>Output directory location</Description>
			<Type>output</Type>
			<Cleaning>sliding</Cleaning>
			<MaxFileAge>600</MaxFileAge> 
		</Directory>
	</ServerDirectories> 
	<Properties>
		<LogPath>/cup1/arcgis/server/user/log/</LogPath>
		<LogSize>10</LogSize>
		<LogLevel>3</LogLevel>
		<ConfigurationStartTimeout>300</ConfigurationStartTimeout>
		<EngineContextTimeout>600</EngineContextTimeout>
		<AISServer>127.0.0.1:3982</AIServer>
	</Properties> 
</Server>

Server.dat 标签

以下是 Server.dat 文件中的标签、标签含义以及示例值。

确定是否将强制执行对服务设置的安全性规则。默认情况下，此标签设置为 false。在“管理器”中启用服务的安全性会将此标签设置为 true。将其重置回 false 的唯一方法是手动编辑 Server.dat 文件。请在手动执行该编辑之前停止 ArcGIS 服务器对象管理器服务。

SOM 会定期 ping SOC 进程，以查看进程是否仍然响应。经过 CrashDetectorFrequency 之后，SOM 会 ping 每个 SOC 进程。完成该检查的时间取决于所有 SOC 计算机上正在运行的 SOC 进程数。完成检查后，SOM 将等待这一间隔时间后再次进行检查。该时间间隔默认为 5000 毫秒（5 秒）。

服务器对象容器计算机的列表。此标签包含每个服务器计算机的 <Machine> 子标签。

表示服务器对象容器计算机。此标签包含三个子标签：<Name>、<Description> 和 <Capacity>。

<Name>

表示服务器对象容器计算机名称的字符串。如果缺少此标签，将忽略 <Machine> 标签的其余部分。启动时，SOM 不会验证此标签的值是否是有效的服务器对象容器计算机。如果无效，则当 SOM 尝试在其中创建服务时会记录错误。计算机名称必须唯一。重复的计算机名称将被忽略。

可选字符串，用于描述服务器对象容器计算机。

整数，表示可在计算机上运行的最大服务实例数。值 -1 表示对实例数没有任何限制。

以下是 <ServerMachine> 标签、<Machine> 标签及其子标签的示例。

<ServerMachines>
 <Machine>
  <Name>cup</Name>
  <Description>Server container machine 1</Description>
  <Capacity>40</Capacity>
 </Machine>
 <Machine>
  <Name>gogo</Name>
  <Description>Server container machine 1</Description>
  <Capacity>40</Capacity>
 </Machine>
</ServerMachines>

服务器目录的列表。此标签包含每个服务器目录的 <Directory> 子标签。

服务器目录。此标签包含必需的子标签 <Path> 及多个可选子标签。

<Path>

表示服务器目录路径的字符串。该属性是必需的且对于每个服务器必须唯一。带有重复 <Path> 标签的目录将被忽略。但是请注意，如果单个位置具有多个路径（例如，名称不同的两个共享路径），SOM 不会将这些路径识别为相同的目录。

<URL>

可选字符串，用于表示指向 <Path> 标签中指定物理位置的虚拟目录 URL。URL 的格式为 http://cup:8399/arcgis/server/images。

可选字符串，用于描述服务器目录。

<Type>

用于表示服务器目录类型的字符串，可以是 cache、jobs、output 或 index。不能在此处指定服务器输入目录。可改为使用文件 <Properties> 部分中的 <InputDir> 标签。

可选字符串，用于指定服务器输出和作业目录如何删除它们包含的旧文件。有效值为 off、sliding 或 absolute。如果 <Cleaning> 为“off”，则服务器不会从目录中删除文件。如果 <Cleaning> 为“sliding”，则服务器将删除自上次访问起，经过 <MaxFileAge> 标签指定的时间的文件。如果 <Cleaning> 为“absolute”，则服务器将删除自创建之时起，经过 <MaxFileAge> 标签指定的时间的文件。如果此标签缺失，则默认值为“sliding”。

<Cleaning> 标签只适用于服务器作业和输出目录。不适用于服务器缓存、索引或输入目录。

为使文件或文件夹能够从服务器输出目录中清除，它必须以 _ags_ 作为前缀。

可选的正整数，用于表示自上次访问 (sliding) 或创建 (absolute) 文件后到删除文件之前需要经历的时间量（以秒为单位）。如果此标签缺失，则默认值为 10。

<MaxFileAge> 标签只适用于服务器作业和输出目录。不适用于服务器缓存目录。

以下是 <ServerDirectory> 标签、<Directory> 标签及其子标签的示例。

  
<ServerDirectories>
 <Directory>
  <Path>/cup1/arcgis/server/serverdir/arcgiscache</Path>
  <URL>http://cup:8399/arcgis/server/arcgiscache</URL>
  <Description>Cache location</Description>
  <Type>cache</Type>
 </Directory>
 <Directory>
  <Path>/cup1/arcgis/server/serverdir/arcgisjobs</Path>
  <URL>http://cup:8399/arcgis/server/arcgisjobs</URL>
  <Description>Geoprocessing jobs location</Description>
  <Type>jobs</Type>
  <Cleaning>sliding</Cleaning>
  <MaxFileAge>21600</MaxFileAge>
 </Directory>
 <Directory>
  <Path>/cup1/arcgis/server/serverdir/arcgisoutput</Path>
  <URL>http://cup:8399/arcgis/server/arcgisoutput</URL>
  <Description>Output directory location</Description>
  <Type>output</Type>
  <Cleaning>sliding</Cleaning>
  <MaxFileAge>600</MaxFileAge>
 </Directory>
</ServerDirectories>

GIS 服务器的属性列表，包括记录属性和服务创建超时时间。<Properties> 的所有子标签都是可选的。

可选的标签，仅当向 ArcGIS Server 注册了 ArcGIS Image Server 后才会出现。标签结构为 <Image Server IP 地址>:<端口>

可选的整数，用于表示 GIS 服务器等待服务实例启动的时间（以秒为单位）。如果服务启动所花费的时间比 <ConfigurationStartTimeout> 长，则服务将超时并将记录错误。默认超时时长为 300。

可选的整数，用于表示客户端可在自动释放之前保留不再使用（空服务器上下文）的服务的最大时间量（以秒为单位）。默认值为 600。

表示服务器输入目录路径的字符串。可以是本地路径，也可以是 UNC 路径。

可选的整数，用于指示服务器在日志文件中写入的细节的级别。等级具体如下：

0（无）

1（错误）

2（正常）

3（信息：简单）

4（信息：标准）

5（信息：详细）

100（详细）

默认的日志级别为 2（或正常）。有关日志级别的详细描述，请参阅解释日志文件。

可选的字符串，用于表示磁盘上写入日志文件的位置的路径。默认路径为 <安装位置>\server\user\log（适用于 Windows），<ArcGIS Server 安装目录>/arcgis/server10.0/user/log（适用于 Linux/Solaris）。请注意，GIS 服务器帐户必须具有对该位置的写访问权限。

可选的整数，用于表示在创建新日志文件之前单个日志文件允许的大小（以 MB 为单位）。默认值为 10。

整数，用于定义日志目录中可存在的最大日志文件对数（由配套的 .xml 和 .dat 文件组成）。达到最大值后，将删除最旧的日志文件对来为新的日志文件对腾出空间。默认值 -1 意味着没有最大值并且不会删除任何日志文件。

布尔属性，用于指示日志消息是否应包括发起相应服务器请求的用户的名称。默认值为 true。当启用了 ArcGIS Server 安全性时，此标签最有用。

可选的标签，用于指定在 ping 尝试失败时尝试访问 SOC 计算机的次数。SOM 将每隔 n 毫秒定期 ping 它的 SOC 计算机，n 是 <MachinePingInterval> 标签的值。如果 SOC 计算机不响应，SOM 将继续尝试 ping 该 SOC，直到达到 MachinePingAttempts 规定的次数，而此时 SOC 将被标记为不可用。不可用的 SOC 仍将被 ping，如果稍后确定它们能够响应，则会进行验证并添加回 SOC 组中，以接受 SOM 发出的请求。

MachinePingAttempts 的默认值为 2。

可选的标签，用于指定在第一次 ping 尝试失败后，后续尝试 ping SOC 计算机的间隔时间（以毫秒为单位）。有关详细信息，请参阅本帮助主题中的 <MachinePingInterval>、<MachinePingTimeout> 和 <MachinePingAttempts>。

SOM 会定期 ping 它的各个 SOC 计算机以确定它们是否仍然可用。该标签可指定用于确定 SOM 的各个 SOC 计算机是否仍然连接的各次尝试之间经历的时间（以毫秒为单位）。未响应的计算机可能被标记为不可用。默认的 MachinePingInterval 为 3000（3 秒）；也就是说，如果不添加此标签，SOM 将使用该值。

可选的标签，用于指定在认为尝试失败之前等待 SOC 计算机响应的时间（以毫秒为单位）。默认值为 1000（1 秒）。如果尝试失败，SOM 将继续 ping SOC n 次，n 是在 <MachinePingAttempts> 标签中指定的值。

以下是 Server.dat 的 <Properties> 标签及其子标签的示例。

  
<Properties>
 <LogPath>/cup1/arcgis/server/user/log/</LogPath>
 <LogSize>10</LogSize>
 <LogLevel>3</LogLevel>
 <ConfigurationStartTimeout>300</ConfigurationStartTimeout>
 <EngineContextTimeout>600</EngineContextTimeout>
	<AISServer>127.0.0.1:3982</AIServer> 
	<MachinePingInterval>10000</MachinePingInterval> 
	<MachinePingTimeout>2000</MachinePingTimeout> 
	<MachinePingAttempts>3</MachinePingAttempts> 
	<MachinePingDelay>500</MachinePingDelay>
</Properties>

指定是否允许 ArcSOC.exe 进程崩溃以及发生崩溃时服务器应该完成的操作。可用的值如下：

0 - ArcSOC.exe 进程不能崩溃。
1 - 允许 ArcSOC.exe 进程崩溃并将消息写入日志文件。
2 - 允许 ArcSOC.exe 进程崩溃并将消息写入日志文件，同时将错误报告写入 <ErrorReportDir> 标签中指定的位置。

指定 ArcSOM.exe 进程是否生成错误报告。可用的值如下：

0 - ArcSOM.exe 进程不生成错误报告。
3 - ArcSOM.exe 进程生成错误报告。

注意:

值 1 和 2 不使用这一属性。

ArcGIS Server 错误报告在磁盘上写入的路径。必须在生成任何错误报告之前设置该属性。

可以选择任何目录，但是 SOM 和 SOC 帐户必须可以写入该目录。如果 ArcGIS Server 配置包含多台计算机，则此路径应为指向共享位置的 UNC 路径，或每台 SOC 计算机上的相同本地路径。

了解有关 ArcGIS Server 错误报告的详细信息

指定错误报告是否会自动通过 Web 发送到 ESRI。默认值为 False。True 值表示会发送错误报告。在启用自动错误报告之前，需要阅读并接受 ESRI 隐私策略中的条款。

包含电子邮件地址的可选属性，ESRI 可使用该属性联系系统管理员以获得有关错误报告的详细信息。

时间间隔，用于指定 ArcGIS Server 检查错误报告目录中的新报告的频率（以秒为单位）。默认值为 3600（1 小时）。如果启用自动上传（使用 <ErrorReportEnableUpload> 标签），则检查期间找到的任何报告都会自动发送到 ESRI。

保留在错误报告输出目录中的错误报告的数量。默认值为 10。如果在短时间内累积了大量错误报告，而且 ArcSOC.exe 多次崩溃，那么可以增加该属性的值。如果已选择自动将错误报告发送到 ESRI，则报告会在发送后从目录中移除。然而，您始终可以在 SOM 帐户的用户配置文件目录中发现最近的 10 个报告。

3/7/2012