{{{
#!html
<h1>Serverconfig.ini and Webconfig.ini Documentation and Tuning</h1>
}}}
----

'''Revision History'''

||'''Revision'''||'''Date'''||'''Author'''||'''Comment'''||
||0.1||May 10, 2010||Trevor Wekel||Initial pass at documentation||

[[PageOutline(1-3,Table of Contents,inline)]]

= Overview =
This document describes the parameters and provides parameter tuning tips for serverconfig.ini and webconfig.ini. 

== Common Validation Information ==
=== String Properties ===
|| '''Property Type''' || '''Range of String Length'''  || '''Reserved Characters''' ||
|| File Name || 0 < Length <= 128 || \/:*?"<>| ||
|| Folder Name || 0 < Length <= 128 || \/:*?"<>| ||
|| Log Parameters || 0 < Length <= 1024 || ||
|| Password || 0 < Length <= 64 || \t\r\n\v\f ||
|| Path || 0 < Length <= 255 || *?"<>| ||
=== Numeric Properties ===
|| '''Property Type''' || '''Range of String Length'''  ||
|| Port Number ||  0 < Value <= 65535 ||



= Serverconfig.ini =#Server
== Overview ==
Serverconfig.ini controls various aspects of the !MapGuide Server process.  It is typically located in C:\Program Files\OSGeo\!MapGuide\Server\bin or /usr/local/mapguideopensource/server/bin.
== [!GeneralProperties] Section ==#ServerGeneralProperties
|| '''Property Name''' || '''Supported In''' || '''Restrictions''' || '''Description''' ||
|| !ConnectionTimeout || >= 2.1 ||  < Value <= 86400 || Time duration in seconds for when an idle connection is dropped ||
|| !ConnectionTimerInterval || >= 2.1 || 0 < Value <= 2147483647 || Time interval in seconds for when the server checks for idle connections ||
|| !DefaultMessageLocale|| >= 2.1 || Length = 2 || ISO 639-1 name for the message locale ||
|| !DisplayName|| >= 2.1 ||0 <= Length <= 255 [[BR]]Reserved Characters: \/:*?"<>| || Display name of the server ||
|| !FdoPath|| >= 2.1 || ||Path where FDO is installed ||
|| !LicenseServerPath || >= 2.1 || ||The path to the License server (not used by !MapGuide Open Source) ||
|| [#ServerLocale Locale]|| >= 2.1 ||0 <= Length <= 255 || The server's locale. ||
|| !LogsDelimiter|| >= 2.1 || || Delimiter that separates the data fields in the log files ||
|| [#ServerLogsDetail LogsDetail]|| >= 2.1 || ||  Level of logging detail per service
|| !LogsPath || >= 2.1 || || Path where log files are stored ||
|| !MachineIp || >= 2.1 || 0 < Length <= 255 || IP address of the server ||
|| !MaxLogFileSize || >= 2.1 || 0 < Value <= 2000000 || Max size allowed for the log files in kilobytes (KB) ||
|| !MaxLogFileSizeEnabled || >= 2.1 || || 0 = max size disabled, 1 = max size enabled ||
|| !Renderer || >= 2.1 || || Image renderer to use (GD or AGG) ||
|| !ResourcesPath || >= 2.1 || || Path where the localization resource files are stored ||
|| !SerialNumber || >= 2.1 || 0 <= Length <= 12 || The !MapGuide Server serial number (not used by !MapGuide Open Source) ||
|| !TcpIpMtu || >= 2.1 ||  0 < Value <= 65535 || TCP/IP maximum transmission unit ||
|| !TempPath || >= 2.1 || || Path where the temporary files are stored ||
|| !WfsDocumentPath || >= 2.1 || || Document path location for WFS documents ||
|| !WmsDocumentPath || >= 2.1 || || Document path location for WMS documents ||
=== Locale Parameter ===#ServerLocale
The server's locale.  If left blank it will default to the operating system locale [[BR]] Format: lang[_country_region.code_page] [[BR]] Example (Windows): English_United States.1252 [[BR]] Example (Linux): en_US.iso88591
=== !LogsDetail Parameter ===#ServerLogsDetail
Level of logging detail per service.
 * 0 - Errors without parameters (default)
 * 1 - Warnings and Errors with parameters
 * 2 - Trace, Warnings, and Errors
 * 3 - Internal Trace, Trace, Warnings, and Errors
Service keys: !ResourceService, !DrawingService, !FeatureService, !MappingService, !RenderingService, !TileService, !KmlService, !ServerAdminService, !SiteService
[[BR]]
Example: MappingService:3,FeatureService:1
== [!AdministrativeConnectionProperties] Section ==#ServerAdministrativeConnection
== [!ClientConnectionProperties] Section ==#ServerClientConnection
== [!SiteConnectionProperties] Section ==#ServerSiteConnection
== [!HostProperties] Section ==#ServerHostProperties
== [!DrawingServiceProperties] Section ==#ServerDrawingService
== [!FeatureServiceProperties] Section ==#ServerFeatureService
== [!MappingServiceProperties] Section ==#ServerMappingService
== [!RenderingServiceProperties] Section ==#ServerRenderingService
== [!ResourceServiceProperties] Section ==#ServerResourceService
== [!SiteServiceProperties] Section ==#ServerSiteService
== [!TileServiceProperties] Section ==#ServerTileService
== [!AccessLogProperties] Section ==#ServerAccessLog
== [!AdminLogProperties] Section ==#ServerAdminLog
== [!AuthenticationLogProperties] Section ==#ServerAuthenticationLog
== [!ErrorLogProperties] Section ==#ServerErrorLog
== [!SessionLogProperties] Section ==#ServerSessionLog
== [!TraceLogProperties] Section ==#ServerTraceLog
== [!FontAliases] Section ==#ServerFontAliases
== [!UnmanagedDataMappings] Section ==#ServerUnmanagedDataMappings


= Webconfig.ini =#Web
== Overview ==
Webconfig.ini controls various aspects of the !MapGuide !WebExtensions and !MapAgent. It is typically located in C:\Program Files\OSGeo\!MapGuide\Web\www or /usr/local/mapguideopensource/webserverextensions/www.
== [!GeneralProperties] Section ==#WebGeneralProperties
== [!AdministrativeConnectionProperties] Section ==#WebAdministrativeConnection
== [!ClientConnectionProperties] Section ==#WebClientConnection
== [!SiteConnectionProperties] Section ==#WebSiteConnection
== [!AgentProperties] Section ==#WebAgentProperties
== [!OgcProperties] Section ==#WebOgcProperties
== [!WebApplicationProperties] Section ==#WebApplicationProperties