服务器配置文件

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 文件中的标签、标签含义以及示例值。

<SecurityEnabled>

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

<CrashDetectorFrequency>

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

<ServerMachines>

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

<Machine>

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

<Name>

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

<Description>

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

<Capacity>

整数,表示可在计算机上运行的最大服务实例数。值 -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>
<ServerDirectories>

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

<Directory>

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

<Path>

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

<URL>

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

<Description>

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

<Type>

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

<Cleaning>

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

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

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

<MaxFileAge>

可选的正整数,用于表示自上次访问 (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>
<Properties>

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

<AISServer>

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

<ConfigurationStartTimeout>

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

<EngineContextTimeout>

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

<InputDir>

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

<LogLevel>

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

0(无)

1(错误)

2(正常)

3(信息:简单)

4(信息:标准)

5(信息:详细)

100(详细)

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

<LogPath>

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

<LogSize>

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

<LogMaxFiles>

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

<LogUser>

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

<MachinePingAttempts>

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

MachinePingAttempts 的默认值为 2

<MachinePingDelay>

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

<MachinePingInterval>

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

<MachinePingTimeout>

可选的标签,用于指定在认为尝试失败之前等待 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>
<ErrorReportMode>

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

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

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

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

12 不使用这一属性。

<ErrorReportDir>

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

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

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

<ErrorReportEnableUpload>

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

<ErrorReportEmailAddress>

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

<ErrorReportReportInterval>

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

<ErrorReportCacheSize>

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


3/7/2012