5.6.1 Editing the system definition files

(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.

To Page Top

(2) Procedure

To edit a system definition file:

1. 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.

2. 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.

To Page Top

(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.

To Page Top

(4) Related topics

• 2.2.1 Logging in to ITSLM - Manager

• 5.4.1 Setting up the linkage between ITSLM and Performance Management (working with Performance Management)

• 5.4.2 Specifying settings for saving Performance Management's performance data from ITSLM (working with Performance Management)

• 5.4.3 Releasing the linkage between ITSLM and Performance Management (working with Performance Management)

• 8.4.1 Renaming the ITSLM - Manager host

• 8.4.2 Renaming the ITSLM - UR host

• 8.5.1 Changing ITSLM - Manager's RMI communication port number

• 8.5.2 Changing ITSLM - UR's RMI communication port number

• 8.5.3 Changing the listen port number of the ITSLM - Manager embedded database

• 8.5.4 Changing the listen port number of the ITSLM - Manager embedded Web server

• 8.5.5 Changing the port number of the internal communications port of the ITSLM - Manager embedded Web server

• 8.5.6 Changing the port number of the completion-message receiving port of the ITSLM - Manager embedded Web server

• 8.6 Changing the network interface number

To Page Top