[mapguide-commits] r10253 - in branches/4.0/MgDev: Common/MapGuideCommon/System Portable/MgPortable/System Server/src/Core cmake/configs
svn_mapguide at osgeo.org
svn_mapguide at osgeo.org
Mon Nov 2 20:29:35 PST 2026
Author: jng
Date: 2026-11-02 20:29:35 -0800 (Mon, 02 Nov 2026)
New Revision: 10253
Modified:
branches/4.0/MgDev/Common/MapGuideCommon/System/ConfigProperties.h
branches/4.0/MgDev/Portable/MgPortable/System/ConfigProperties.h
branches/4.0/MgDev/Server/src/Core/serverconfig.ini
branches/4.0/MgDev/cmake/configs/serverconfig.ini.in
Log:
Add more details on some serverconfig.ini log properties
Fixes #1331
Modified: branches/4.0/MgDev/Common/MapGuideCommon/System/ConfigProperties.h
===================================================================
--- branches/4.0/MgDev/Common/MapGuideCommon/System/ConfigProperties.h 2026-11-03 04:05:50 UTC (rev 10252)
+++ branches/4.0/MgDev/Common/MapGuideCommon/System/ConfigProperties.h 2026-11-03 04:29:35 UTC (rev 10253)
@@ -715,12 +715,12 @@
static const STRING AccessLogPropertyEnabled; /// value("Enabled")
static const bool DefaultAccessLogPropertyEnabled; /// value(true)
- /// The Access log's file name. NOTE: A log's filename may include the following special
- /// characters: %d,%m,%y, standing for date, month, year. If one or all of these are used,
- /// the special char will be replaced by the actual calendar value when the log file is
- /// created. A new log file will be created when the shortest time period has elapsed.
- /// That is, if the filename includes %d, a new log file will be created everyday. If the
- /// filename contains both %m and %y, a new log file is created every month.
+ /// The Access log's file name. NOTE: A log's file name may include the following special
+ /// characters: %y, %m, %d, standing for year, month and day. A name that contains one of
+ /// them is archived when the period it names changes, so that %d archives and starts a new
+ /// log every day, %m every month, and %y every year. The period is taken from the first
+ /// special character in the name. The special characters are not replaced by the date in
+ /// the name of the log file in use; the date appears in the name of the archived file.
static const STRING AccessLogPropertyFilename; /// value("Filename")
static const STRING DefaultAccessLogPropertyFilename; /// value("Access.log")
Modified: branches/4.0/MgDev/Portable/MgPortable/System/ConfigProperties.h
===================================================================
--- branches/4.0/MgDev/Portable/MgPortable/System/ConfigProperties.h 2026-11-03 04:05:50 UTC (rev 10252)
+++ branches/4.0/MgDev/Portable/MgPortable/System/ConfigProperties.h 2026-11-03 04:29:35 UTC (rev 10253)
@@ -513,12 +513,12 @@
static const STRING AccessLogPropertyEnabled; /// value("Enabled")
static const bool DefaultAccessLogPropertyEnabled; /// value(true)
- /// The Access log's file name. NOTE: A log's filename may include the following special
- /// characters: %d,%m,%y, standing for date, month, year. If one or all of these are used,
- /// the special char will be replaced by the actual calendar value when the log file is
- /// created. A new log file will be created when the shortest time period has elapsed.
- /// That is, if the filename includes %d, a new log file will be created everyday. If the
- /// filename contains both %m and %y, a new log file is created every month.
+ /// The Access log's file name. NOTE: A log's file name may include the following special
+ /// characters: %y, %m, %d, standing for year, month and day. A name that contains one of
+ /// them is archived when the period it names changes, so that %d archives and starts a new
+ /// log every day, %m every month, and %y every year. The period is taken from the first
+ /// special character in the name. The special characters are not replaced by the date in
+ /// the name of the log file in use; the date appears in the name of the archived file.
static const STRING AccessLogPropertyFilename; /// value("Filename")
static const STRING DefaultAccessLogPropertyFilename; /// value("Access.log")
Modified: branches/4.0/MgDev/Server/src/Core/serverconfig.ini
===================================================================
--- branches/4.0/MgDev/Server/src/Core/serverconfig.ini 2026-11-03 04:05:50 UTC (rev 10252)
+++ branches/4.0/MgDev/Server/src/Core/serverconfig.ini 2026-11-03 04:29:35 UTC (rev 10253)
@@ -70,7 +70,20 @@
# MaxLogFileSize Max size allowed for the log files in
# kilobytes (KB)
# 0 < Value <= 2000000
+# Applies to all log files, and is used only
+# when MaxLogFileSizeEnabled = 1
+# Example: 1024 = 1 MB
# MaxLogFileSizeEnabled 0 = max size disabled, 1 = max size enabled
+# When enabled, a log file that reaches
+# MaxLogFileSize is archived: it is closed,
+# renamed as described under LOG FILE NAMES
+# below, and logging continues in a new file
+# of the same name. Entries are never removed
+# from a log and logging never stops; the
+# server itself is not affected. Because the
+# size is checked after each entry is
+# written, an archived file can exceed the
+# limit by one entry.
# MentorDictionaryPath The path where the CS-Map Coordinate System Dictionaries are installed
# MentorUserDictionaryPath The path where user defined CS-Map Coordinate System Dictionaries are stored
# PreCacheMaps The list of maps to precache at server startup.
@@ -480,6 +493,40 @@
DefaultTileSizeY = 300
ImageFormat = PNG
+# *****************************************************************************
+# L O G F I L E N A M E S
+#
+# The Filename property of each log section names its log file. It is a file
+# name only - a path is not allowed - and the file is created in the folder
+# given by LogsPath in the GeneralProperties section.
+#
+# The name may contain these parameters:
+# %y last two digits of the year
+# %m month, 01 to 12
+# %d day of the month, 01 to 31
+#
+# A parameter rolls the log over when the period it names changes: the log
+# file in use is archived and logging continues in a new file. The period
+# comes from the first parameter in the name, so a log that has to roll over
+# daily puts %d first, as in "Access-%d%m%y.log"; "Access-%y%m%d.log" rolls
+# over yearly, because %y is the first parameter.
+#
+# Archiving renames the file in use to
+# <name>_<yyyy>-<m>-<d>_<unique id>.log
+# where <name> is the part of the configured name before the extension, with
+# the parameters removed. The parameters are not replaced by the date in the
+# name of the file being written, so "Error-%d.log" is written to "Error-.log"
+# and archived as "Error-_2026-11-3_<unique id>.log". A name without
+# parameters is not rolled over by the date.
+#
+# A log is also archived when it is enabled - at server startup, or through the
+# Server Admin API - and the Parameters recorded in the header of the file in
+# use no longer match the configured Parameters, so that each file's header
+# describes its own entries. All archiving - by date, by size, and by
+# parameter change - uses the name above, and archived files are never removed
+# by the server.
+# *****************************************************************************
+
[AccessLogProperties]
# *****************************************************************************
# A C C E S S L O G
@@ -487,7 +534,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 1
@@ -501,7 +548,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 1
@@ -515,7 +562,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 1
@@ -529,7 +576,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 1
@@ -543,7 +590,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# Interval Time interval in seconds for when the server
# writes the performance information to the log
@@ -560,7 +607,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 0
@@ -574,7 +621,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 0
Modified: branches/4.0/MgDev/cmake/configs/serverconfig.ini.in
===================================================================
--- branches/4.0/MgDev/cmake/configs/serverconfig.ini.in 2026-11-03 04:05:50 UTC (rev 10252)
+++ branches/4.0/MgDev/cmake/configs/serverconfig.ini.in 2026-11-03 04:29:35 UTC (rev 10253)
@@ -70,7 +70,20 @@
# MaxLogFileSize Max size allowed for the log files in
# kilobytes (KB)
# 0 < Value <= 2000000
+# Applies to all log files, and is used only
+# when MaxLogFileSizeEnabled = 1
+# Example: 1024 = 1 MB
# MaxLogFileSizeEnabled 0 = max size disabled, 1 = max size enabled
+# When enabled, a log file that reaches
+# MaxLogFileSize is archived: it is closed,
+# renamed as described under LOG FILE NAMES
+# below, and logging continues in a new file
+# of the same name. Entries are never removed
+# from a log and logging never stops; the
+# server itself is not affected. Because the
+# size is checked after each entry is
+# written, an archived file can exceed the
+# limit by one entry.
# MentorDictionaryPath The path where the CS-Map Coordinate System Dictionaries are installed
# MentorUserDictionaryPath The path where user defined CS-Map Coordinate System Dictionaries are stored
# PreCacheMaps The list of maps to precache at server startup.
@@ -482,6 +495,40 @@
DefaultTileSizeY = 300
ImageFormat = PNG
+# *****************************************************************************
+# L O G F I L E N A M E S
+#
+# The Filename property of each log section names its log file. It is a file
+# name only - a path is not allowed - and the file is created in the folder
+# given by LogsPath in the GeneralProperties section.
+#
+# The name may contain these parameters:
+# %y last two digits of the year
+# %m month, 01 to 12
+# %d day of the month, 01 to 31
+#
+# A parameter rolls the log over when the period it names changes: the log
+# file in use is archived and logging continues in a new file. The period
+# comes from the first parameter in the name, so a log that has to roll over
+# daily puts %d first, as in "Access-%d%m%y.log"; "Access-%y%m%d.log" rolls
+# over yearly, because %y is the first parameter.
+#
+# Archiving renames the file in use to
+# <name>_<yyyy>-<m>-<d>_<unique id>.log
+# where <name> is the part of the configured name before the extension, with
+# the parameters removed. The parameters are not replaced by the date in the
+# name of the file being written, so "Error-%d.log" is written to "Error-.log"
+# and archived as "Error-_2026-11-3_<unique id>.log". A name without
+# parameters is not rolled over by the date.
+#
+# A log is also archived when it is enabled - at server startup, or through the
+# Server Admin API - and the Parameters recorded in the header of the file in
+# use no longer match the configured Parameters, so that each file's header
+# describes its own entries. All archiving - by date, by size, and by
+# parameter change - uses the name above, and archived files are never removed
+# by the server.
+# *****************************************************************************
+
[AccessLogProperties]
# *****************************************************************************
# A C C E S S L O G
@@ -489,7 +536,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 1
@@ -503,7 +550,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 1
@@ -517,7 +564,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 1
@@ -531,7 +578,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 1
@@ -545,7 +592,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# Interval Time interval in seconds for when the server
# writes the performance information to the log
@@ -562,7 +609,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 0
@@ -576,7 +623,7 @@
# Property Name Description
# -----------------------------------------------------------------------------
# Enabled 0 = log disabled, 1 = log enabled
-# Filename Name of the log file
+# Filename Name of the log file (see LOG FILE NAMES)
# Parameters Log parameters
# *****************************************************************************
Enabled = 0
More information about the mapguide-commits
mailing list