5.6.1 Editing the system definition files
This subsection explains how to edit ITSLM's system definition files (jp1itslm.properties and jp1itslmur.properties).
- Organization of this subsection
(1) Before you start
-
Terminate the ITSLM - Manager or ITSLM - UR whose system definition file you will be editing.
For details about the termination method, see 2.1.4 Terminating ITSLM - Manager or 2.1.3 Terminating ITSLM - UR.
(2) Procedure
To edit a system definition file:
-
Edit the system definition file.
The system definition file is stored at the following location:
- For ITSLM - Manager:
-
ITSLM-Manager-installation-folder\mgr\conf\jp1itslm.properties
- For ITSLM - UR:
-
ITSLM-UR-installation-folder\ur\conf\jp1itslmur.properties
For a list of the definitions that can be edited, see 5.6.2 Editable definitions.
If you are editing properties that are common to both ITSLM - Manager and ITSLM - UR, make sure that you edit both system definition files.
-
Start the ITSLM - Manager or ITSLM - UR whose system definition file has been edited.
For details about how to start ITSLM - Manager or ITSLM - UR, see 2.1.1 Starting ITSLM - Manager or 2.1.2 Starting ITSLM - UR.
The system definition file has been edited and the ITSLM settings have been changed.
(3) Supplementary information
-
A system definition file definition is specified in the following format:
property=value
-
Use ISO/IEC 646 character codes for system definition files; do not use Unicode characters. Do not include any Unicode escape sequences.
-
Changes made to a system definition file are not applied until the next time ITSLM - Manager or ITSLM - UR is started (or restarted).
-
If an invalid keyword that is not defined in ITSLM is specified in a system definition file, ITSLM ignores the specified keyword and continues processing.
-
If an invalid value, such as an out-of-range value, is specified in a system definition file, the target ITSLM - Manager or ITSLM - UR might terminate during startup processing.
However, for properties related to output of logs (properties beginning with logger), a specified invalid value, such as an out-of-range value, will be changed to the default value and ITSLM - Manager or ITSLM - UR processing will continue.
-
Paths specified in a definition file cannot exceed 100 characters. The following characters can be used:
-
A to Z, a to z, 0 to 9, space, underscore (_), period (.), left and right parentheses (()), and the path separator character (\)
Note that two consecutive path separator characters (\\) must be specified, as indicated in the following.
Example specification: C:\\Program Files\\HITACHI\\JP1ITSLM\\ur\\accesslog
None of the following are permitted:
-
Double-byte characters
-
Characters that Windows does not allow in file or folder names (\, /, :, *, ?, ", <, >, |)
-
NTFS stream names that contain a colon (:), except as a separator after the drive name
-
Reserved device names (AUX, CON, NUL, PRN, CLOCK$, COM1 through COM9, LPT1 through LPT9)
-
Folder names that start with u
-
Paths that include #
-
Paths that end with \\
-
Paths on a network drive
-
-
We recommend that you make a backup after you have edited a system definition file.
For details about how to back up system definition files, see 8.1.1 Backing up the definition files.
-
If you are running ITSLM in a cluster system and change a system definition file, make sure that you make the same changes to the system definition files in both systems to avoid inconsistent settings between the active and standby servers.