Event server index file
- Organization of this page
Format
server event-server-name directory-name |
Storage destination directory
- In Windows:
-
installation-folder\conf\event\
- In UNIX:
-
/etc/opt/jp1base/conf/event/
Description
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.
Application of settings
Start the event service to apply the settings.
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‒4: 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‒5: 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/
-
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.