Accessed by the event server. It defines the directories where the other environment setting files, event databases, and work files are stored. There is usually no need to change the default settings in this file.

You can define multiple event servers if you want to specify a large-capacity or high-speed disk other than the one where you have installed JP1/Base or you want to run more than one event server on the local host.

To Page Top

Application of settings

Start the event service to apply the settings.

To Page Top

Definition details

The following conventions apply to entries in the event server index file (index):

Each line of the text file is no more than 1,024 bytes and the file size is no more than 2 GB.
Separate parameter keywords with a space (code 0x20) or a tab (code 0x09).
Do not insert a space or any other characters in front of the parameter name and hash mark (#) (code 0x23) at the start of a line.
A hash mark (#) (code 0x23) at the start of a line indicates a comment. You can enter a comment or line space anywhere in a file.
Letters are case sensitive.

Specify an event server and directory to use. To have multiple event servers on the local host, associate each event server with a corresponding directory.

server event-server-name directory-name

event-server-name

Specify the name of the event server. For event-server-name, specify one of the following names. The default is an asterisk (*).

*

In this case, the local host name (value returned by the hostname command) is used. Under normal circumstances, there is no need to change the default asterisk. If an environment that supports DNS, replace the asterisk with an event server name or an at mark (@).
event-server-name

Specify this parameter if you configured the JP1 program to support DNS or use JP1 programs in a cluster system. For an example of configuring an event server in a system that uses DNS, see 10.1.10 Setting up an event server in a system that uses DNS services.

For the event server name, specify the name of the host on which the event server starts as a character string of no more than 255 bytes. Letters are case sensitive. If you want to use a server to distribute and collect event service definitions in an environment that supports the DNS, you should specify an at mark (@) for the event server name.
@

When an at mark (@) is specified, the event server supports the DNS. Also, the event server can be used to distribute and collect event service definitions in an environment that supports the DNS.

directory-name

You can change the directory that the event server uses. If the directory has been changed, place the event server settings file and forwarding settings file in this directory.

When a full path is specified:

Place the event database and all the work files in the specified directory.

When a partial path is specified:

The partial path indicates subdirectories of the directory shown in the following table, so place the event database and all the work files in the specified directories.

Table 16‒10: Base directories of the partial paths specified (in Windows)
File name	Directory
Event server settings file or forwarding settings file	`installation-folder\conf\event\servers\`
Event database	`installation-folder\sys\event\servers\`
Temporary work files	`installation-folder\sys\tmp\event\servers\`

Table 16‒11: Base directories of the partial paths specified (in UNIX)
File name	Directory
Event server settings file or forwarding settings file	`/etc/opt/jp1base/conf/event/servers/`
Event database	`/var/opt/jp1base/sys/event/servers/`
Temporary work files	`/var/opt/jp1base/sys/tmp/event/servers/`

To Page Top

Notes

To support the DNS, the DNS must return a FQDN as a local host name. If the DNS fails to return the FQDN as a local host name, the FQDN format event server will not be recognized as an event server of the physical host.
If you change the server parameter of an active event service, the event service does not stop.
If there is only one FQDN format event server name in the Event server index file for the JP1/Base physical host and you call the JP1 event acquisition function, add the definition of * (indicating that the event server name runs on local host) as event-server-name. (This works on JP1/Base version 12-10 or later.) Also, the directory name (with underlined) needs to be matched with the existing definition. The use of the product cannot be guaranteed unless the directory name is matched. Also, if the definition is not added, the JP1 event acquisition function fails.

Definition example of the event server index file
```
#-----------------------------------------------------------------------
# JP1/Base - Event Server Index
#-----------------------------------------------------------------------
server hostX.d1.hitachi.co.jp default
server * default
```

To Page Top