Salesforce

OEM: Database startup parameters "-lgTruncateFrequency" and "-lgTruncateTime" are not working

« Go Back

Information

 
TitleOEM: Database startup parameters "-lgTruncateFrequency" and "-lgTruncateTime" are not working
URL Nameoem-database-startup-parameters-lgtruncatefrequency-and-lgtruncatetime-are-not-working
Article Number000198590
EnvironmentProduct: OpenEdge
Version: 11.7.3 and later, 12
OS: All Supported Platforms
Question/Problem Description
OEM: Database startup parameters "-lgTruncateFrequency" and "-lgTruncateTime" are not working
Unable to set the "-lgTruncateTime" parameter in OEM.

OEM for Daily "lgtruncatefrequency=0" is ignored and log file truncation never happens
Steps to Reproduce1. Define a database in OEM.

2. Navigate: Resources > local > dbname > configuration > configuration.

:: [dbname].defaultconfiguaration > diagnostics
Edit and set the following parameters:
:> lgarchiveenable=true
:> lgarchivedir=<direcorypath and name>
:> lgtruncatefrequency=0
:> lgtruncatesize=0
:> lgtruncatetime=<07:XX, 08:XX, 09:XX>

SAVE will result in an error for lgtruncatetime.
>> lgarchiveenable=true Invalid property 'Log file truncate time (-lgTruncateTime)': Value must match pattern HH:MM. Valid range is 00:00 to 23:59.

4. Restart the database through the OEM Console or DBMAN -start

Database log file startup parameters show log file truncation is disabled:
:: Frequency of database log file truncation (-lgTruncateFrequency): -1
Clarifying Information
OpenEdge 11.7.3, The following database startup parameters manage the database logfile:
  • -lgArchiveDir - Database log file archive directory
  • -lgArchiveEnable - Archive database log file before truncation
  • -lgTruncateFrequency - Frequency of database log file truncation. Used in conjunction with -lgTuncateTime  to determine the time of the truncation on the specified days. 
    • -1 == "Not Enabled"
    • Values are {0 .. 8} where:
      • 0 == Daily,
      • {1,2,...,7} == indicate weekly on each day Monday (1),Tuesday (2),..., Sunday (7),
      • 8 == monthly, on the last day of the month.
  • -lgTruncateTime - Time of day for the database log file truncation (in hours and minutes: HH:MM)
  • -lgTruncateSize - The maximum size the database log file can grow before truncation (in megabytes)
Error Messagelgarchiveenable=true Invalid property 'Log file truncate time (-lgTruncateTime)': Value must match pattern HH:MM. Valid range is 00:00 to 23:59.
Defect NumberOCTA-32401
Enhancement Number
Cause
There are two issues with the logfile archive parameters:

lgTruncateTime: Is set incorrectly.  This property takes time value as a string: format HH:MM, where the-time-of-day must falll within a valid range: 00:00 through 23:59
This setting cannot be a comma separated multiple time values - HH:MM,HH:MM,HH:MM
(THE-) Time of day for truncation (-lgTruncateTime):     13:00

lgTruncateFrequency: This property takes value from ranging from -1 to 9.
Setting this value to truncate Daily 0 (zero) in the OEM/OEE database parameter configuration screen "lgtruncatefrequency=0" is ignored and log file truncation never happens as this is set to -1 which denotes "Not Enabled". This needs to be addressed for lgTruncateFrequency to accept zero also as valid value.
When setting the value other than zero works fine.

 
Resolution
Until the fix is available, use the workaround below.
Workaround

To configure Daily database log file truncation. 

  • Edit conmgr.properties and configure daily db lg file truncation in: otherargs=-lgTruncateFrequency 0  
  • It must be used in conjunction with -lgTuncateTime to determine the time to truncate and archive
  • The lg file truncation time accepts one value anywhere within the range 00:00 through 23:59
  • To disable database logfile management set : lgtruncatefrequency=-1
Example: <dlc>\properties\conmgr.properties
    
[configuration.sports2020.defaultconfiguration]
...
lgarchivedir=< full writeable path to archive >
lgarchiveenable=true
lgtruncatefrequency=0
lgtruncatetime=23:59
lgtruncatesize=1000
otherargs=-lgTruncateFrequency 0
 ...
Notes
Keyword Phrase
Last Modified Date11/14/2023 4:37 PM

Powered by