Server configuration files |
|
Release 9.3 |
The Server.dat file maintains the server's properties. The server object manager (SOM) reads the contents of this file at its startup. The server reports a successful start once this file has been successfully read and any initialization detailed in it completed. If there are errors in the file, the SOM logs an error and attempts to start using default values for the missing or invalid properties.
When the SOM is first installed on a machine, the Server.dat file does not exist. Server.dat is created after the SOM is started, and either a server object container (SOC) machine or a server directory is added to the GIS server.
The following is an example of a Server.dat file for a GIS server with a single container machine (cup) and a single output directory (\\padisha\images) whose logging level is 3.
<Server> <SecurityEnabled>false</SecurityEnabled> <ServerMachines> <Machine> <Name>padisha</Name> <Description>Server container machine 1</Description> <Capacity>-1</Capacity> </Machine> </ServerMachines> <ServerDirectories> <Directory> <Path>\\padisha\arcgisserver\arcgiscache</Path> <URL>http://padisha/arcgiscache</URL> <Description>Cache location</Description> <Type>cache</Type> </Directory> <Directory> <Path>\\padisha\arcgisserver\arcgisjobs</Path> <URL>http://padisha/arcgisjobs</URL> <Description>Geoprocessing jobs location</Description> <Type>jobs</Type> <Cleaning>sliding</Cleaning> <MaxFileAge>21600</MaxFileAge> </Directory> <Directory> <Path>\\padisha\arcgisserver\arcgisoutput</Path> <URL>http://padisha/arcgisoutput</URL> <Description>Output directory location</Description> <Type>output</Type> <Cleaning>sliding</Cleaning> <MaxFileAge>600</MaxFileAge> </Directory> </ServerDirectories> <Properties> <LogPath>C:\Program Files\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>
The following are the tags, their meanings, and example values in a Server.dat file.
The SOM periodically pings the SOC processes to see if they are still responsive. After the CrashDetectorFrequency elapses, the SOM pings every SOC process. The time for this check to finish depends on the number of SOC processes running on all of the SOC machines. When the check finishes, the SOM will wait this interval before starting the check again. This interval defaults to 5 seconds.
The following is an example of the <ServerMachine> tag, <Machine> tag, and its subtags.
<ServerMachines> <Machine> <Name>padisha</Name> <Description>Server container machine 1</Description> <Capacity>25</Capacity> </Machine> <Machine> <Name>melange</Name> <Description>Server container machine 1</Description> <Capacity>25</Capacity> </Machine> </ServerMachines>
An optional string that specifies the server directory's cleaning mode. Valid values are off, sliding, or absolute. If <Cleaning> is off, then the server will not clean up its files in the directory. If <Cleaning> is sliding, then the server will delete files for which the time specified by the <MaxFileAge> tag has elapsed since they were last accessed. If <Cleaning> is absolute, then the server will delete files for which the time specified by the <MaxFileAge> tag has elapsed since they were created. If this tag is missing, the default value is sliding.
The <Cleaning> tag is only used with server jobs and output directories. It is not used with server cache directories.
An optional positive integer that represents the amount of time in seconds that needs to elapse since a file was last accessed (sliding) or created (absolute) before the file is deleted. If this tag is missing, the default is 10.
The <MaxFileAge> tag is only used with server jobs and output directories. It is not used with server cache directories.
The following is an example of the <ServerDirectory> tag, <Directory> tag, and its subtags.
<ServerDirectories> <Directory> <Path>\\padisha\arcgisserver\arcgiscache</Path> <URL>http://padisha/arcgiscache</URL> <Description>Cache location</Description> <Type>cache</Type> </Directory> <Directory> <Path>\\padisha\arcgisserver\arcgisjobs</Path> <URL>http://padisha/arcgisjobs</URL> <Description>Geoprocessing jobs location</Description> <Type>jobs</Type> <Cleaning>sliding</Cleaning> <MaxFileAge>21600</MaxFileAge> </Directory> <Directory> <Path>\\padisha\arcgisserver\arcgisoutput</Path> <URL>http://padisha/arcgisoutput</URL> <Description>Output directory location</Description> <Type>output</Type> <Cleaning>sliding</Cleaning> <MaxFileAge>600</MaxFileAge> </Directory> </ServerDirectories>
The path on disk to which ArcGIS Server error reports will be written. For the error reports to be generated, the <CrashDumpMode> tag must be set to a value of 2.
The path you list here can be either a local path or a UNC path to a shared location (recommended for multiple-machine deployments). The SOM and SOC accounts must have Read and Write permissions to the directory you reference in this path.
Learn more about ArcGIS Server error reports.
Specifies whether ArcSOC.exe processes will be allowed to crash and what the server should do when a crash occurs. The default value of 0 means that ArcSOC.exe processes cannot crash. A value of 1 allows ArcSOC.exe processes to crash with a message written to the log file. A value of 2 allows ArcSOC.exe processes to crash with a message written to the log file and an error report written to the location specified in the <CrashDumpDir> tag.
Learn more about ArcGIS Server error reports.
An optional integer that indicates the level of detail to which the server writes in the log files. The levels are as follows:
0 (None)
1 (Error)
2 (Normal)
3 (Info:Simple)
4 (Info:Standard)
5 (Info:Detailed)
6 (Verbose)
The default log level is 2, or Normal. For more detailed descriptions of the log levels, see Interpreting log files.
An optional tag specifying the number of attempts to try to reach the SOC machine if a ping attempt fails. The SOM periodically pings its SOC machines every n milliseconds, n being the value of the MachinePingInterval tag. If a SOC machine does not respond, the SOM will continue trying to ping that SOC until MachinePingAttempts is reached, at which point the SOC will be marked as disabled. Disabled SOCs are still pinged, and if they are determined to be alive later, they are validated and added back into the group of SOCs available to take requests from the SOM.
The default value of MachinePingAttempts is 2.
An optional tag specifying the time in milliseconds between subsequent attempts to ping the SOC machine if the first ping attempt fails. See the definitions for MachinePingInterval, MachinePingTimeout, and MachinePingAttempts in this help topic for more information.
Below is an example of the <Properties> tag of Server.dat with its subtags.
<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>