Hitachi

JP1 Version 12 JP1/Performance Management - Agent Option for Oracle Description, User's Guide and Reference


K.4 Settings for outputting action logs

The settings for outputting action logs are defined in the jpccomm.ini file. If no settings are specified, no action logs are output. The following describes the settings required to output the action logs, and how to specify the settings.

Organization of this subsection

(1) Setting procedure

To specify the settings for outputting action log information:

  1. Stop all PFM services on the host.

  2. Using a text editor, edit the jpccomm.ini file.

  3. Save and close the jpccomm.ini file.

(2) Details about the jpccomm.ini file

The following describes the jpccomm.ini file in detail.

(a) Storage directory

In Windows

installation-folder

In UNIX

/opt/jp1pc/

(b) Format

In the jpccomm.ini file, define the following information:

  • Whether or not to output action log information

  • Output destination of the action log

  • Number of action logs that can be saved

  • File size of the action log

The specification format is as follows:

"item-name"=value

The following table shows the items that you specify.

Table K‒4: Items specified in the jpccomm.ini file and their initial values

No.

Item

Explanation

1

[Action Log Section]

The section name, which cannot be changed.

2

Action Log Mode

Specify whether or not to output action log information. You must specify this item.

  • Initial value

    0 (Information not output)

  • Specifiable value

    0 (Information not output) or 1 (Information output)

    If any other value is specified, an error message is output and action log information will not be output.

3

Action Log Dir#

Specify the action log output destination.

In a logical host environment, specify a directory on the shared disk. If the directory you specify is not on the shared disk, Performance Management will output action logs to each physical host that forms the basis for the logical host.

If a path longer than the limit is specified or if access to the directory fails, an error message is output to the command log and action log information will not be output.

  • Initial value

    None set

  • Default value used when no specification is made

    On physical hosts:

    Windows: installation-folder\auditlog\

    UNIX: /opt/jp1pc/auditlog/

    On logical hosts:

    Windows: environment-folder\jp1pc\auditlog\

    UNIX: environment-directory/jp1pc/auditlog/

  • Specifiable value

    A character string of 1 to 185 bytes

4

Action Log Num

Specify the upper limit on the total number of log files (number of saved files). Specify the sum of the number of current output file and shift files.

  • Initial value

    None set

  • Default value used when no specification is made:

    5

  • Specifiable value

    An integer in the range from 2 to 10

If a character string containing a non-numeric value is specified, an error message is output and the default value 5 is set. If a numeric value outside the valid range is specified, an error message is output and an integer nearest the specified value in the range from 2 to 10 is set.

5

Action Log Size

Specify the log file size in kilobytes.

  • Initial value

    None set

  • Default value used when no specification is made:

    2048

  • Specifiable value

    An integer in the range from 512 to 2096128

If a character string containing a non-numeric value is specified, an error message is output and the default value 2048 is set. If a numeric value outside the valid range is specified, an error message is output and an integer nearest the specified value in the range from 512 to 2096128 is set.

#

When you use the jpcconf ha setup command to set up a logical host after you configure action log output on the physical host, the settings in the jpccomm.ini file of the physical host apply to the logical host. When using Performance Management on a logical host and a physical host at the same time, make sure that both hosts do not output action logs to the same directory.