Version 2 (modified by 15 years ago) ( diff ) | ,
---|
Serverconfig.ini and Webconfig.ini Documentation and Tuning
Revision History
Revision | Date | Author | Comment |
0.1 | May 10, 2010 | Trevor Wekel | Initial pass at documentation |
Table of Contents
- Overview
-
Serverconfig.ini
- Overview
- [GeneralProperties] Section
- [AdministrativeConnectionProperties] Section
- [ClientConnectionProperties] Section
- [SiteConnectionProperties] Section
- [HostProperties] Section
- [DrawingServiceProperties] Section
- [FeatureServiceProperties] Section
- [MappingServiceProperties] Section
- [RenderingServiceProperties] Section
- [ResourceServiceProperties] Section
- [SiteServiceProperties] Section
- [TileServiceProperties] Section
- [AccessLogProperties] Section
- [AdminLogProperties] Section
- [AuthenticationLogProperties] Section
- [ErrorLogProperties] Section
- [SessionLogProperties] Section
- [TraceLogProperties] Section
- [FontAliases] Section
- [UnmanagedDataMappings] Section
- Webconfig.ini
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
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
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 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) | |
Locale | >= 2.1 | 0 <= Length <= 255 | The server's locale. |
LogsDelimiter | >= 2.1 | Delimiter that separates the data fields in the log files | |
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
The server's locale. If left blank it will default to the operating system locale
Format: lang[_country_region.code_page]
Example (Windows): English_United States.1252
Example (Linux): en_US.iso88591
LogsDetail Parameter
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
Example: MappingService:3,FeatureService:1
[AdministrativeConnectionProperties] Section
[ClientConnectionProperties] Section
[SiteConnectionProperties] Section
[HostProperties] Section
[DrawingServiceProperties] Section
[FeatureServiceProperties] Section
[MappingServiceProperties] Section
[RenderingServiceProperties] Section
[ResourceServiceProperties] Section
[SiteServiceProperties] Section
[TileServiceProperties] Section
[AccessLogProperties] Section
[AdminLogProperties] Section
[AuthenticationLogProperties] Section
[ErrorLogProperties] Section
[SessionLogProperties] Section
[TraceLogProperties] Section
[FontAliases] Section
[UnmanagedDataMappings] Section
Webconfig.ini
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.