K.5 Settings for outputting operation logs

(a) On a physical host

1. Edit the operation log definition file (jp1bs_baselog_setup.conf).

1-1 Set the ENABLE parameter.

Open the operation log definition file (jp1bs_baselog_setup.conf) in an editor, and change the ENABLE parameter as follows:

• Before (default)

  "ENABLE"=dword:00000000

• After

  "ENABLE"=dword:00000001

1-2 To change the output destination for operation log data, set the LOGFILEDIR parameter.

Change the LOGFILEDIR parameter as follows:

In Windows:

• Before (default)

  "LOGFILEDIR"="installation-folder\log\BASE"

• After

  "LOGFILEDIR"="output-destination"

In UNIX:

• Before (default)

  "LOGFILEDIR"="/var/opt/jp1base/log/BASE"

• After

  "LOGFILEDIR"="output-destination"

2. Execute the jbssetcnf command.

The new settings are added to the common definition information.

3. Enable the new settings.

Enable the new settings by restarting JP1/Base or executing the jbs_spmd_reload command.

(b) On a logical host

1. Edit the operation log definition file (jp1bs_baselog_setup.conf) on the shared disk.

1-1 Set the [JP1_DEFAULT\JP1BASE\BASE_LOG] parameter.

Open the operation log definition file (jp1bs_baselog_setup.conf) in an editor, and change the [JP1_DEFAULT\JP1BASE\BASE_LOG] parameter as follows:

• Before (default)

  [JP1_DEFAULT\JP1BASE\BASE_LOG]

• After

  [logical-host-name\JP1BASE\BASE_LOG]

1-2 Set the ENABLE parameter.

Change the ENABLE parameter as follows:

• Before (default)

  "ENABLE"=dword:00000000

• After

  "ENABLE"=dword:00000001

1-3 Set the output destination for operation log data.

Specify the LOGFILEDIR parameter as follows. On logical hosts, we recommend that you specify a location on the shared disk.

In Windows:

• Before (default)

  "LOGFILEDIR"="installation-folder\log\BASE"

• After

  "LOGFILEDIR"="shared-folder\jp1base\log\BASE"

In UNIX:

• Before (default)

  "LOGFILEDIR"="/var/opt/jp1base/log/BASE"

• After

  "LOGFILEDIR"="shared-directory/jp1base/log/BASE"

2. Execute the jbssetcnf command on the primary node.

The contents of the definition file are added to the common definition information.

3. Carry the settings over to the secondary node.

When using JP1/Base in a cluster environment, you need to make the common definition information consistent on each server. For details, see 5.6.1(1) When common definition information is added or changed.

4. Enable the new settings.

Enable the new settings by restarting JP1/Base from the cluster software, or executing the jbs_spmd_reload command.

(a) Storage destination directory

In Windows:

installation-folder\conf\

shared-folder\jp1base\conf\

In UNIX:

/etc/opt/jp1base/conf/

shared-directory/jp1base/conf/

(b) Format

In the operation log definition file (jp1bs_baselog_setup.conf), use the following format to specify whether operation log output is enabled. You can also use this format to specify the output destination and file size of the operation log file (base_log.log), the number of files to be saved, and whether the log file is changed automatically.

"item-name"=value

(c) Definition details

Excluding the output destination of the operation log file (base_log.log), specify a hexadecimal value for all. A value in () indicates a decimal value.

ENABLE

Specifies whether to enable operation log output. If you specify a number other than the following numbers, the system assumes that the default is specified.

• Initial value: 00000000

• To disable operation log output: 00000000

• To enable operation log output: 00000001

LOGFILEDIR

Enter the output path of the operation log file (base_log.log). For the operation log file in a logical host, we recommend that you specify a path for a shared disk.

• Initial value

  In Windows: installation-folder\log\BASE

  In UNIX: /var/opt/jp1base/log/BASE

• Example output path for logical hosts

  In Windows: shared-folder\jp1base\log\BASE

  In UNIX: shared-directory/jp1base/log/BASE

LOGSIZE

Specifies the operation log file (base_log.log) size in bytes. If a value smaller than the lower limit of the possible range is specified, the lower limit value is assumed. If a value greater than the upper limit is specified, the upper limit value is assumed.

• Initial value: 00100000 (1,024 KB)

• Possible value range: 00002000 to 00400000 (8 KB to 4,096 KB)

LOGFILENUM

Specifies the number of operation log files (base_log.log) to be saved. If a value smaller than the lower limit of the possible range is specified, the lower limit value is assumed. If a value greater than the upper limit is specified, the upper limit value is assumed.

• Initial value: 00000004 (4 files)

• Possible value range: 00000001-00000010 (from 1 to 16 files)

LOGCHANGEOPT

Specifies whether to automatically change the log file when JP1/Base starts. If you specify a number other than one of the following, the system assumes the initial value.

• Initial value: 00000000

• Not to be changed at startup: 00000000

• To be changed at startup: 00000001

(d) Operation log definition file definition example

If the ENABLE value is changed to 00000001, the operation log can store no more than 1 megabyte of output, and save no more than four log files.

[JP1_DEFAULT\JP1BASE\BASE_LOG]
"ENABLE"=dword:00000001
"LOGFILEDIR"="/var/opt/jp1base/log/BASE"
"LOGSIZE"=dword:00100000
"LOGFILENUM"=dword:00000004
"LOGCHANGEOPT"=dword:00000000