IBM Support

IBM Maximo Application Suite - Increase log history for IBM Maximo Application Suite Manage application

Question & Answer


Question

Is there a way to increase log history for IBM Maximo Application Suite Manage application?

Answer

Following the previous document on how Show WebSphere Liberty timestamp details in IBM Maximo Application Suite - Manage application logs brought in attention the need to also have more history on Manage application traces.
With IBM WebSphere Liberty's default settings and with the verbosity of IBM Maximo Application Suite Manage Application you currently get a 7 hours worth of logs traces, which in some cases it won't be enough if you want to track issues that started to occur few days ago.
This 7 hours of logging is usually spread over two files (main message.log plus one secondary or backup).
The secondary file is 20 MB which is the default IBM WebSphere Liberty log file size.
There is a way to increase the retention period by setting two Liberty logging properties: maxFileSize and maxFiles.
Increasing both will also increase retention time.
Starting from default values calculations, a size of 100 MB with 5 files per rotation should get you a week of traces is that is what you need.
Follow the same instructions from here but passing the below xml definition on the server bundles:
<?xml version="1.0" encoding="UTF-8"?>
<server description="new server">
    <logging consoleFormat="simple" maxFileSize="100" maxFiles="5"/>
</server>
The below xml definition will work as well:
​<?xml version="1.0" encoding="UTF-8"?>
<server description="new server">
    <logging consoleFormat="simple"/>
    <logging maxFileSize="100"/>
    <logging maxFiles="5"/>
</server>
This is how the settings are in IBM Maximo Application Suite - Manage application configuration:
image-20220518141425-1
Here are all the WebSphere Liberty logging parameters:
https://www.ibm.com/docs/en/was-liberty/nd?topic=configuration-logging
Description of the maxFileSize is:

The maximum size (in MB) that a log file can reach before it is rolled.
The Liberty runtime does only size-based log rolling.
To disable this attribute, set the value to 0.
The maximum file size is approximate.
By default, the value is 20.
Note: maxFileSize does not apply to the console.log file.
Description of the maxFiles is:

Maximum number of log files that are kept before the oldest file is removed; a value of 0 means no limit.
If an enforced maximum file size exists, this setting is used to determine how many of each of the log files are kept.
This setting also applies to the number of exception logs that summarize exceptions that occurred on a particular day.
So if this number is 10, you might have 10 message logs, 10 trace logs, and 10 exception summaries in the ffdc/directory.
By default, the value is 2.
Note: maxFiles does not apply to the console.log file.
No need to say that you can adjust maxFileSize and maxFiles based on your needs.

[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSRHPA","label":"IBM Maximo Application Suite"},"ARM Category":[{"code":"a8m3p000000F81LAAS","label":"Maximo Application Suite->MAS Applications->Manage->Administration"}],"ARM Case Number":"TS009244629","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
18 May 2022

UID

ibm16587441

Page Feedback