ServerView Resource Orchestrator Cloud Edition V3.2.0 Operation Guide

8.7.3 Metering Log Settings

This section explains how to change the metering log operational settings.

Follow the steps below to change the metering log operational settings.

1. Open the following operational settings file for metering logs:

   [Windows Manager]

   Installation_folder\RCXCTMG\Charging\conf\metering_log.properties

   [Linux Manager]

   /etc/opt/FJSVctchg/conf/metering_log.properties

2. Change the relevant items in the operational settings file for metering logs:

   Key	Description	Default value
   retention_period	Retention period of log entries Logs will be deleted once their retention period has passed. Use the following format to specify the retention period: YYYY-MM-DD Example: 0000-03-00: Retain logs for 3 months. 0005-00-00: Retain logs for 5 years.	0000-03-00
   periodic_log_use (*1)	Specify whether or not to use the periodic log function: yes: Use no: Do not use	yes
   periodic_log_schedule_time (*1)	Output time of periodic log Use the following format to specify the output time: HH:mm	00:00
   periodic_log_schedule_type (*1)	Output frequency of periodic log Specify one of the following strings: DAILY: Every day WEEKLY: Every week MONTHLY: Every month	DAILY
   periodic_log_schedule_day (*1)	Output day of periodic log If periodic_log_schedule_type is WEEKLY or MONTHLY, this item is mandatory.(*2) If periodic_log_schedule_type is WEEKLY: Use the following strings to specify the day of the week: MON TUE WED THU FRI SAT SUN Commas can be used as delimiters to specify a number of days of the week. If periodic_log_schedule_type is MONTHLY: Use one of the following methods to specify a date: Numerics from 1 to 28 indicating the date LASTDAY string indicating the last day of the month A number of days cannot be specified with this method.	No specification

   *1: Changes to this setting are enabled by executing the Change periodic log schedule settings command after changing the settings file.
   *2: If periodic_log_schedule_type is DAILY, the periodic_log_schedule_day value will be ignored.

   An example of setting the operational settings file is shown below:

   # delete setting of meteringlog database 
   # YYYY-MM-DD
   # ex. 3 months ago     0000-03-00
   
   retention_period=0000-03-00
   
   # schedule of periodlog insert
   
   periodic_log_use=yes
   
   periodic_log_schedule_time=00:00
   
   periodic_log_schedule_type=DAILY
   
   periodic_log_schedule_day=

3. If an item other than retention_period has been changed, execute the Change periodic log schedule settings command.
   Refer to "11.1 ctchg_chgschedule (Change Periodic Log Schedule Settings)" in the "Reference Guide (Command/XML) CE" for information on the Change periodic log schedule settings command.

Note

Points to note when using the usage charge calculator

• Specify either the default value (3 months) or a period longer than the default value for retention_period.

• Do not change the values for the following keys from the default:

  • periodic_log_use

  • periodic_log_schedule_time

  • periodic_log_schedule_type

  • periodic_log_schedule_day