Changing Application Server Log Rotation

KB Home   |   Changing Application Server Log Rotation

Main.ChangingApplicationServerLogRotation History

Hide minor edits - Show changes to output

Changed lines 9-10 from:
'''Note: for Site Server log rotation''' see the note under the 14.3 or later section regarding changing rotation for site server logs.
to:
'''Note: for Site Server log rotation''' see the KB on [[https://www.papercut.com/kb/Main/HowToEnableDebugInTheSiteServer|enabling Debug on the Site Server]].
Deleted lines 23-30:

'''Changing server log rotation on a SITE server'''

Since there is no admin interface with configurable options for a site server, we need to make this change at the OS level.
*1. Open a text editor as administrator.
*2. Use file open and browse to @@[app dir]\server\site-server.properties@@ file.
*3. Add the line [@server.site.log.keep-mb=<Size in MB>@]  (eg 6Gb=6144 or 10Gb=10240)
*4. Restart the Site Server service.
August 16, 2018, at 04:12 PM by TimG - Formatting and note about site server changes.
Added lines 9-10:
'''Note: for Site Server log rotation''' see the note under the 14.3 or later section regarding changing rotation for site server logs.
Changed lines 14-25 from:

'''1.''' Login to the PaperCut administration interface

'''2.''' Navigate to "Options->Advanced".

'''3.''' In the diagnostics section, check @@Enable debug mode@@ and increase the amount of logs to keep from the default of 2048MB to something suitable for your site.  e.g. 5000MB

->
'''NOTE:''' In most cases 2048MB is enough for diagnostics. Make sure you have enough disk space to store the increased amount of logs.

'''3.''' Press "Apply" to save the settings.  These changes take effect immediately (no restart required).

to:
*1. Login to the PaperCut administration interface
*2. Navigate to "Options->Advanced".
*3. In the diagnostics section, check @@Enable debug mode@@ and increase the amount of logs to keep from the default of 2048MB to something suitable for your site.  e.g. 5000MB. '''NOTE:''' In most cases 2048MB is enough for diagnostics. Make sure you have enough disk space to store the increased amount of logs.
*4. Press "Apply" to save the settings.  These changes take effect immediately (no restart required).
Changed lines 20-30 from:

'''1.''' Login to the PaperCut administration interface

'''2.''' Navigate to "Options->Advanced".

'''3.''' Open the Config Editor and search for "system.log.default.keep-mb". Change the value from the default 100 to something suitable for your site. e.g 500.

->
'''NOTE:''' Make sure you have enough disk space to store the increased amount of logs.

'''4.''' Press "Update" to save the settings.  These changes take effect immediately (no restart required).
to:
*1. Login to the PaperCut administration interface
*2. Navigate to "Options->Advanced".
*3. Open the Config Editor and search for "system.log.default.keep-mb". Change the value from the default 100 to something suitable for your site. e.g 500. '''NOTE:''' Make sure you have enough disk space to store the increased amount of logs.
*4. Press "Update" to save the settings.  These changes take effect immediately (no restart required).

'''Changing server log rotation on a SITE server'''

Since there is no admin interface with configurable options for a site server, we need to make this change at the OS level.
*1. Open a text editor as administrator.
*2. Use file open and browse to @@[app dir]\server\site-server.properties@@ file.
*3. Add the line [@server.site.log.keep-mb=<Size in MB>@]  (eg 6Gb=6144 or 10Gb=10240)
*4. Restart the Site Server service
.
Changed lines 35-45 from:

'''1.''' Login to the PaperCut administration interface

'''2.''' Navigate to "Options->Advanced".

'''3.''' In the diagnostics section, increase the amount of logs to keep from the default of 100MB to something suitable for your site.  e.g. 500MB

->
'''NOTE:''' Make sure you have enough disk space to store the increased amount of logs.

'''3.''' Press "Apply" to save the settings.  These changes take effect immediately (no restart required).
to:
*1. Login to the PaperCut administration interface
*2. Navigate to "Options->Advanced".
*3. In the diagnostics section, increase the amount of logs to keep from the default of 100MB to something suitable for your site.  e.g. 500MB. '''NOTE:''' Make sure you have enough disk space to store the increased amount of logs.
*4. Press "Apply" to save the settings.  These changes take effect immediately (no restart required).
Changed lines 41-45 from:

If the total size of logs is less than 500MB you will have 10 logs of a maximum size of 50MB.

If the total size of logs is more than 500MB you will have 50MB logs up to the maximum configured size.
to:
*If the total size of logs is less than 500MB you will have 10 logs of a maximum size of 50MB.
*If the total size of logs is more than 500MB you will have 50MB logs up to the maximum configured size.
Changed lines 46-49 from:
'''1.''' Using a text editor, open the logging configuration file: @@[app-path]\server\lib\log4j.properties@@

'''2.''' Locate the lines in the file that look like the following:
to:
*1. Using a text editor, open the logging configuration file: @@[app-path]\server\lib\log4j.properties@@
*2. Locate the lines in the file that look like the following:
Changed lines 53-63 from:
'''3.''' These settings determine the size of each log file, and the number of log files to keep.  The settings above will keep 100MB of logs (10 x 10MB files).  Change this setting to increase the amount of logs kept.  To keep up to 1GB of logs you could change the @@[=MaxFileSize=]@@ setting to 100MB, or alternatively change you could change @@[=MaxBackupIndex=]@@ index to retain more logs.

->
'''NOTE:''' Make sure you have enough disk space to store the increased amount of logs.

'''3.''' Save the text file

'''4.''' Restart the PaperCut Application Server service (On Windows do this in Control Panel->Admin Tools->Services).

After the restart your PaperCut application server will collect more log data.

->
'''NOTE:''' These settings will be reset back to the defaults after PaperCut upgrades.
to:
*3. These settings determine the size of each log file, and the number of log files to keep.  The settings above will keep 100MB of logs (10 x 10MB files).  Change this setting to increase the amount of logs kept.  To keep up to 1GB of logs you could change the @@[=MaxFileSize=]@@ setting to 100MB, or alternatively change you could change @@[=MaxBackupIndex=]@@ index to retain more logs. '''NOTE:''' Make sure you have enough disk space to store the increased amount of logs.

*4. Save the text file

*5. Restart the PaperCut Application Server service (On Windows do this in Control Panel->Admin Tools->Services).
After the restart your PaperCut application server will collect more log data. '''NOTE:''' These settings will be reset back to the defaults after PaperCut upgrades.
Changed lines 3-4 from:
By default the PaperCut Application Server keeps up to 100MB of log files (10 files of 10MB in size). 
to:
By default the PaperCut Application Server keeps up to 2048MB of log files (40 files of 50MB in size). 
Changed line 36 from:
!! PaperCut 13.2 (or later)
to:
!! PaperCut 13.2 - 14.2
November 13, 2014, at 06:01 AM by matt - put the debug case first
Changed lines 11-12 from:
'''Changing server log rotation without enabling debug'''
to:
'''Changing server log rotation for with debug enabled'''
Deleted lines 16-27:
'''3.''' Open the Config Editor and search for "system.log.default.keep-mb". Change the value from the default 100 to something suitable for your site. e.g 500.

-> '''NOTE:''' Make sure you have enough disk space to store the increased amount of logs.

'''4.''' Press "Update" to save the settings.  These changes take effect immediately (no restart required).

'''Changing server log rotation for debug'''

'''1.''' Login to the PaperCut administration interface

'''2.''' Navigate to "Options->Advanced".

Changed lines 24-26 from:
!! PaperCut 13.2 (or later)

to:
'''Changing server log rotation without enabling debug'''
Changed lines 30-31 from:
'''3.''' In the diagnostics section, increase the amount of logs to keep from the default of 100MB to something suitable for your site.  e.g. 500MB
to:
'''3.''' Open the Config Editor and search for "system.log.default.keep-mb". Change the value from the default 100 to something suitable for your site. e.g 500.
Added lines 34-46:
'''4.''' Press "Update" to save the settings.  These changes take effect immediately (no restart required).

!! PaperCut 13.2 (or later)


'''1.''' Login to the PaperCut administration interface

'''2.''' Navigate to "Options->Advanced".

'''3.''' In the diagnostics section, increase the amount of logs to keep from the default of 100MB to something suitable for your site.  e.g. 500MB

-> '''NOTE:''' Make sure you have enough disk space to store the increased amount of logs.

September 07, 2014, at 11:03 PM by Amit - Added 14.3 server log rotation options
Changed lines 9-11 from:
!! PaperCut 13.2 (or later)

to:
!! PaperCut 14.3 (or later)

'''Changing server log rotation without enabling debug'''

Changed lines 17-18 from:
'''3.''' In the diagnostics section, increase the amount of logs to keep from the default of 100MB to something suitable for your site.  e.g. 500MB
to:
'''3.''' Open the Config Editor and search for "system.log.default.keep-mb". Change the value from the default 100 to something suitable for your site. e.g 500.
Added lines 21-32:
'''4.''' Press "Update" to save the settings.  These changes take effect immediately (no restart required).

'''Changing server log rotation for debug'''

'''1.''' Login to the PaperCut administration interface

'''2.''' Navigate to "Options->Advanced".

'''3.''' In the diagnostics section, check @@Enable debug mode@@ and increase the amount of logs to keep from the default of 2048MB to something suitable for your site.  e.g. 5000MB

-> '''NOTE:''' In most cases 2048MB is enough for diagnostics. Make sure you have enough disk space to store the increased amount of logs.

Added lines 35-48:

!! PaperCut 13.2 (or later)


'''1.''' Login to the PaperCut administration interface

'''2.''' Navigate to "Options->Advanced".

'''3.''' In the diagnostics section, increase the amount of logs to keep from the default of 100MB to something suitable for your site.  e.g. 500MB

-> '''NOTE:''' Make sure you have enough disk space to store the increased amount of logs.

'''3.''' Press "Apply" to save the settings.  These changes take effect immediately (no restart required).

Changed lines 22-23 from:

to:
!!! How does PaperCut know how many logs to create

If the total size of logs is less than 500MB you will have 10 logs of a maximum size of 50MB.

If the total size of logs is more than 500MB you will have 50MB logs up to the maximum configured size.

May 01, 2013, at 10:24 AM by matt - Instructions for new GUI option for log rotation
Changed lines 7-8 from:
It is simple to change the amount of logging retained by PaperCut.  To do this:
to:
It is simple to change the amount of logging retained by PaperCut.   Please choose the instructions for your version of PaperCut.

!! PaperCut 13.2 (or later)


'''1.''' Login to the PaperCut administration interface

'''2.''' Navigate to "Options->Advanced".

'''3.''' In the diagnostics section, increase the amount of logs to keep from the default of 100MB to something suitable for your site.  e.g. 500MB

-> '''NOTE
:''' Make sure you have enough disk space to store the increased amount of logs.

'''3.''' Press "Apply" to save the settings.  These changes take effect immediately (no restart required).



!! PaperCut 13.1 (or earlier)

Changed line 51 from:
[-Keywords: log, rotate, logs, debug, delete, extend, roll -]
to:
[-Keywords: log, rotate, logs, debug, delete, extend, roll -]
Changed line 34 from:
[-Keywords: log, rotate, logs, debug, delete -]
to:
[-Keywords: log, rotate, logs, debug, delete, extend, roll -]
Changed lines 28-30 from:
to:
-> '''NOTE:''' These settings will be reset back to the defaults after PaperCut upgrades.

Added lines 1-32:
(:title Changing Application Server Log Rotation :)

By default the PaperCut Application Server keeps up to 100MB of log files (10 files of 10MB in size). 

When debug logging is enabled on sites with a large volume of printing or a heavy use of hold release queues they may find that the logs rotate very quickly (e.g. in less than 20 minutes).  This can cause problems when PaperCut support is trying to help diagnose problems because the logs rotate too quickly, meaning the important data is rotated/deleted before it can be captured.

It is simple to change the amount of logging retained by PaperCut.  To do this:

'''1.''' Using a text editor, open the logging configuration file: @@[app-path]\server\lib\log4j.properties@@

'''2.''' Locate the lines in the file that look like the following:

[@
  log4j.appender.file.MaxFileSize=10MB
  log4j.appender.file.MaxBackupIndex=10
@]

'''3.''' These settings determine the size of each log file, and the number of log files to keep.  The settings above will keep 100MB of logs (10 x 10MB files).  Change this setting to increase the amount of logs kept.  To keep up to 1GB of logs you could change the @@[=MaxFileSize=]@@ setting to 100MB, or alternatively change you could change @@[=MaxBackupIndex=]@@ index to retain more logs.

-> '''NOTE:''' Make sure you have enough disk space to store the increased amount of logs.

'''3.''' Save the text file

'''4.''' Restart the PaperCut Application Server service (On Windows do this in Control Panel->Admin Tools->Services).

After the restart your PaperCut application server will collect more log data.


----
''Categories:'' [[Category.Debugging|+]]
----
[-Keywords: log, rotate, logs, debug, delete -]

Comments

Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.

Article last modified on August 16, 2018, at 04:19 PM
Printable View   |   Article History   |   Edit Article