Job Management Partner 1/Base User's Guide

[Contents][Glossary][Index][Back][Next]

Distribution definition file

Format

[destination-host,...]
definitions
[&destination-host,...]
definitions
[destination-host,...]@action-definition-file-name
definitions
:

File name

Table 14-13 Names of distribution definition file

Definition file for distribution destination Name of distribution definition file
Forwarding settings file [jev_forward.conf | any file]
Action definition file for log file trapping [jev_logtrap.conf | any file]
Action definition file for event log trapping [jev_ntevent.conf | any file]

Storage destination directory

Table 14-14 Storage locations of distribution definition files (in Windows)

Definition file for distribution destination Storage location
Forwarding settings file event-folder#\
Action definition file for log file trapping installation-folder\conf\
Action definition file for event log trapping installation-folder\conf\event\

#: Replace event-folder with the following folder:


Table 14-15 Storage locations of distribution definition files (in Unix)

Definition file for distribution destination Storage location
Forwarding settings file event-directory#/
Action definition file for log file trapping /etc/opt/jp1base/conf/
Action definition file for event log trapping /etc/opt/jp1base/conf/event/

#: Replace event-directory with the following directory:


Description

Specifies the definition information to distribute and the destination host. You must prepare a distribution definition file for each definition file for which you want to distribute the definitions of. Create the file in the storage location, using the default name or any other name.

Application of settings

Execute the jevdef_distrib command to distribute definitions and apply the settings. For details on the jevdef_distrib command, see jevdef_distrib in 13. Commands.

Definition details

The following conventions apply to entries in the distribution definition file.

[destination-host]
  • Specify a host name for a host that is defined in the JP1/IM - Manager system configuration and running JP1/Base 07-00 or a later version.
  • To distribute the same definitions to multiple hosts, specify the hosts within [ ], using commas to separate the hosts.
  • Host names can be no more than 255 bytes.
  • The maximum length of a line is 1,023 bytes.

&
You can add & to the beginning of a host name to distribute definitions to all of the hosts that are defined one layer below the specified host in the configuration definition information. If you specify an & for a host defined in the lowest layer in the configuration definition information, the specification is ignored. A single pair of square brackets can simultaneously contain a host prefixed with an ampersand (&) and a host without an ampersand (&).

@action-definition-file-name
You can use an arbitrary name for the definition file only when you distribute definitions in the action definition file for log file trapping. The file name cannot use the following symbols: \ / : , ; * ? " < > |, tags or spaces. If you specify @action-definition-file-name following square brackets, definitions are distributed to the following folder on the host specified in the square brackets:
In Windows: installation-folder\conf\
In UNIX: /etc/opt/jp1base/conf/

definitions
Specify definitions you want to distribute to each host. The file format is the same as that of each definition file. For details, see the following sections:

Definition examples

This subsection shows an example of configuring a distribution definition file for distributing definitions in the following system:

Figure 14-7 Example system configuration

[Figure]

In the above example system configuration, ManagerHost is the integrated manager. SubHostA, SubHostB, and SubHostC are managed hosts for ManagerHost, and JP1host_1 and JP1host_2 are managed hosts for SubHostA, as defined in the system configuration for JP1/IM - Manager. For details on how to define the system configuration, see the Job Management Partner 1/Integrated Management - Manager Configuration Guide.

The following shows an example distribution definition file for distributing definitions in the forwarding settings file (forward) from ManagerHost to managed hosts.

 
#------------------------------------------
# JP1/Base - Event Server jev_forward.conf 
#------------------------------------------
 
[SubHostA, SubHostB, SubHostC] 
#-------------------------------------------
# JP1/Base - Event Server Forwarding Setting
#-------------------------------------------
to ManagerHost
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
end-to
 
[JP1host_1, JP1host_2] 
#-------------------------------------------
# JP1/Base - Event Server Forwarding Setting
#-------------------------------------------
to SubHostA
E.SEVERITY IN Error Warning
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AOM
end-to

The following is an example for distributing definitions in the action definition file for log file trapping. In the example, ManagerHost distributes definitions as a file named ACTDEF1 to SubHostA and SubHostB, and as a file named ACTDEF2 to SubHostC.

The following shows an example distribution definition file (jev_logtrap.conf) for distributing definitions in the action definition file for log file trapping.

 
#------------------------------------------
# JP1/Base - Event Server jev_logtrap.conf 
#------------------------------------------
 
[SubHostA,SubHostB]@ACTDEF1
FILETYPE=SEQ
RECTYPE =VAR '\n'
HEADLINE=3
MARKSTR ="====="
         "MARK"
ACTDEF  =00000111:00000000  "message"
[SubHostC]@ACTDEF2
FILETYPE=SEQ
RECTYPE =VAR '\n'
HEADLINE=3
MARKSTR ="====="
         "MARK"
ACTDEF  =00000222:00000000  "error"

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.