服务器配置文件
Server.dat 文件包含服务器的属性。服务器对象管理器 (SOM) 将在启动时读取该文件的内容。当成功读取了该文件且完成了其中详细说明的初始化要求之后,服务器将报告启动成功。如果文件中存在错误,SOM 会记录错误并尝试对缺失或无效的属性使用默认值来启动。
首次在计算机上安装 SOM 时,Server.dat 文件不存在。Server.dat 在启动 SOM 之后创建,并且将向 GIS 服务器添加服务器对象容器 (SOC) 计算机或服务器目录。
对于可以使用“管理器”或 ArcGIS Desktop 中的“目录”窗口更改的属性,请避免通过手动编辑 Server.dat 文件来实施更改。
![警告 警告](rsrc/caution.png)
必须在手动编辑 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 文件中的标签、标签含义以及示例值。
确定是否将强制执行对服务设置的安全性规则。默认情况下,此标签设置为 false。在“管理器”中启用服务的安全性会将此标签设置为 true。将其重置回 false 的唯一方法是手动编辑 Server.dat 文件。请在手动执行该编辑之前停止 ArcGIS 服务器对象管理器服务。
SOM 会定期 ping SOC 进程,以查看进程是否仍然响应。经过 CrashDetectorFrequency 之后,SOM 会 ping 每个 SOC 进程。完成该检查的时间取决于所有 SOC 计算机上正在运行的 SOC 进程数。完成检查后,SOM 将等待这一间隔时间后再次进行检查。该时间间隔默认为 5000 毫秒(5 秒)。
服务器对象容器计算机的列表。此标签包含每个服务器计算机的 <Machine> 子标签。
表示服务器对象容器计算机。此标签包含三个子标签:<Name>、<Description> 和 <Capacity>。
表示服务器对象容器计算机名称的字符串。如果缺少此标签,将忽略 <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> 标签的目录将被忽略。但是请注意,如果单个位置具有多个路径(例如,名称不同的两个共享路径),SOM 不会将这些路径识别为相同的目录。
可选字符串,用于表示指向 <Path> 标签中指定物理位置的虚拟目录 URL。URL 的格式为 http://cup:8399/arcgis/server/images。
可选字符串,用于描述服务器目录。
用于表示服务器目录类型的字符串,可以是 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 进程生成错误报告。
![注意 注意](rsrc/note.png)
值 1 和 2 不使用这一属性。
ArcGIS Server 错误报告在磁盘上写入的路径。必须在生成任何错误报告之前设置该属性。
可以选择任何目录,但是 SOM 和 SOC 帐户必须可以写入该目录。如果 ArcGIS Server 配置包含多台计算机,则此路径应为指向共享位置的 UNC 路径,或每台 SOC 计算机上的相同本地路径。
指定错误报告是否会自动通过 Web 发送到 ESRI。默认值为 False。True 值表示会发送错误报告。在启用自动错误报告之前,需要阅读并接受 ESRI 隐私策略中的条款。
包含电子邮件地址的可选属性,ESRI 可使用该属性联系系统管理员以获得有关错误报告的详细信息。
时间间隔,用于指定 ArcGIS Server 检查错误报告目录中的新报告的频率(以秒为单位)。默认值为 3600(1 小时)。如果启用自动上传(使用 <ErrorReportEnableUpload> 标签),则检查期间找到的任何报告都会自动发送到 ESRI。
保留在错误报告输出目录中的错误报告的数量。默认值为 10。如果在短时间内累积了大量错误报告,而且 ArcSOC.exe 多次崩溃,那么可以增加该属性的值。如果已选择自动将错误报告发送到 ESRI,则报告会在发送后从目录中移除。然而,您始终可以在 SOM 帐户的用户配置文件目录中发现最近的 10 个报告。