A.4 perf.conf Parameter

This file is saved at the following location as a detailed setting file of the storage performance management:

Platform of Manager	Location
Windows	$ENV_DIR\ESC\Manager\etc\opt\FJSVssmgr\current\perf.conf ($ENV_DIR means "Environment Directory" specified at the Manager installation.)
Solaris OS, Linux	/etc/opt/FJSVssmgr/current/perf.conf

Reflecting Contents of Setting File

If the setting file is changed, execute re-read definition file by using Web Console, or reactivate the Manager. This reflects the settings on this software.
However, to reflect the settings related to displaying the additional event messages of the threshold monitoring alarm, reflect it during the "How to Reflect the ALARM_MSG_EXP_DEC_NAME Parameter to This Product" procedure.

Information

In performance management, the setting file is referenced once every 4 hours so that changes are reflected even if the above procedure has not been performed.
If the number of days to retain performance data is reduced, data retained that is older than the new number of days is deleted. When you execute re-read definition file by using Web Console, it may take a time to delete the performance data.

Customization

Note

After starting operation, the program in this product may add/update/delete parameters that are not explained in this document for the "perf.conf" file. For this reason, do not edit/delete parameters that are not explained in this document.
If the number of days performance data is kept is increased, the application may stop because of insufficient memory or disk space; therefore care must be taken to ensure space is sufficient. In particular, if 0 is set for PERF_DATA_KEEP_DAYS, processing to delete performance information stops, so check the memory or disk space regularly.
If the number of generations of log files is increased, the application may stop because of insufficient memory or disk space, therefore care must be taken to ensure space is sufficient.
When the performance management for number of active disks is performed, it may not be possible to obtain performance information inside the performance monitoring interval. Change the performance monitoring interval where necessary.

PERF_DATA_KEEP_DAYS

Specify the number of days during which performance management keeps performance data. The data is automatically deleted after the specified number of days elapse.

If 0 is specified, the data is not deleted. However, the number of days does not include the current day.

The default value is seven days and is defined as shown below. Change this value if necessary.

PERF_DATA_KEEP_DAYS = 7;

LOG_ROTATION

The number of generations of log files (perflog.*) related to performance is specified by an arbitrary decimal number. Default is 2. It circulates in the second generation of perflog.0 and perflog.1 when 2 is set.

Example for circulating in the fifth generation:
LOG_ROTATION = 5;

Location of the log file

Platform of Manager	Location
Windows	$TMP_DIR\ESC\Manager\var\opt\FJSVssmgr\log ($TMP_DIR means "Work Directory" specified at the Manager installation.)
Solaris OS, Linux	/var/opt/FJSVssmgr/log

ENABLED_ECO_MODE

Specify whether to use the performance management for the active disks, power consumption, and temperature. To use the performance management for them, specify "true". If you do not want to use it, specify "false". The default is "true".

Example: When the performance management for the number of active disks, power consumption, and temperature is used:
ENABLED_ECO_MODE = true;

ENABLED_PORT_ISCSI

Specify whether to use the performance management for iSCSI port on ETERNUS Disk storage system. To use the performance management for iSCSI port, specify "true". If you do not want to use it, specify "false". The default is "true".

Example: When the performance management for iSCSI port is used:
ENABLED_PORT_ISCSI = true;

ALARM_MSG_EXP_DEC_NAME

Specify whether to display the decimal number and name of the monitoring target resource in the event message of the threshold monitoring alarm. Specify "true" to display the decimal number and name, otherwise specify "false". If the parameter is omitted, the default is "false".

Example for displaying the decimal number and name of the monitoring target resource:
ALARM_MSG_EXP_DEC_NAME = true;

How to Reflect the ALARM_MSG_EXP_DEC_NAME Parameter to This Product

The method for reflecting the setting of the ALARM_MSG_EXP_DEC_NAME parameter to this product is as follows.

When installing this product
Perform the following procedure before starting the performance monitoring of all the devices.
1. Edit the "perf.conf" file.
  The following is an edited example to display the decimal number and name of the monitoring target resource.
```
ALARM_MSG_EXP_DEC_NAME = true;
```
2. With Web Console, perform to re-read the "perf.conf" file.
When changing the setting during operation
Perform the following procedure.
1. Edit the "perf.conf" file.
  The following is an edited example in which the value of the ALARM_MSG_EXP_DEC_NAME parameter is changed from "true" to "false".
```
ALARM_MSG_EXP_DEC_NAME = false;
```
  The following is an edited example in which the value of the ALARM_MSG_EXP_DEC_NAME parameter is changed from "false" to "true".
```
ALARM_MSG_EXP_DEC_NAME = true;
```
2. Restart the Storage Cruiser's manager.