Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/IT Service Level Management Description, User's Guide, Reference and Operator's Guide


jslmursetup (sets up ITSLM - UR)

Organization of this page

Function

This command creates an execution environment for ITSLM - UR. It can also be used to reconfigure the execution environment for an existing ITSLM - UR.

Before you execute this command, install ITSLM - UR, and then execute the jslmuripls command to check the network interface number and IP address of the host on which ITSLM - UR has been installed.

The command execution results are output to the standard output and displayed in the console window. For details about the messages displayed during command execution, see 11.3 Messages.

The command performs one of the following processes, depending on the status of the execution environment at the time of command execution:

Creates an execution environment (when there is no existing execution environment):

This command creates an execution environment when it is executed immediately after ITSLM - UR has been newly installed or after the execution environment for ITSLM - UR was discarded by unsetup processing.

Reconfigures the existing execution environment (when an execution environment already exists):

If this command is executed when the execution environment for a configured ITSLM - UR already exists, the command reconfigures the existing execution environment for ITSLM - UR.

You reconfigure the execution environment in the following cases:

  • The host name, IP address, or port number settings in the execution environment for a configured ITSLM - UR are to be changed.

  • The execution environment for a configured ITSLM - UR is to be reconfigured after an upgrade installation was performed.

Format

jslmursetup [ -c { online | standby } ] absolute-path-of-options-file

Execution permission

User account that belongs to the OS's Administrators group

Storage folder

ITSLM-UR-installation-folder\ur\bin\

Arguments

-c

Specifies that the execution environment used in a cluster system is to be configured. The specification method is as follows:

  • online

    Specifies that the execution environment for the active system is to be configured or reconfigured.

  • standby

    Specifies that the execution environment for the standby system is to be configured or reconfigured.

absolute-path-of-options-file

Specifies the absolute path for an options file that is to be created in text format. This file can be stored at any desired location. The absolute path of the options file storage location must be a maximum of 255 bytes of characters, including the file name (any name).

An options file template is stored at the following location:

ITSLM-UR-installation-folder\ur\template\ur\conf\jp1itslm_setup.opt

The following shows the definitions in the options file:

manager_host=host-name-or-IP-address-of-ITSLM-Manager
manager_port=port-number-of-ITSLM-Manager
ur_host=host-name-or-IP-address-of-ITSLM-UR
ur_port=port-number-of-ITSLM-UR
ur_ni_number=network-interface-number

The following table provides the details of definition items.

Table 9‒13: Details of definition items in options file for ITSLM - UR

No.

Definition item

Specification

Description

Default value

1

manager_host

R

Specifies the host name or IP address of the host on which ITSLM - Manager is installed, as the information for identifying ITSLM - Manager's execution environment.

If ITSLM is running in a cluster system, specify the logical host name or logical IP address.

--

2

manager_port

O

Specifies the port number used by ITSLM - Manager, as a number in the range from 1 through 65535.#

20904

3

ur_host

R

Specifies the host name or IP address of the host on which ITSLM - UR is installed, as the information for identifying ITSLM - UR's execution environment.

If ITSLM is running in a cluster system, specify the logical host name or logical IP address.

--

4

ur_port

O

Specifies the port number used by ITSLM - Manager, as a number in the range from 1 through 65535.#

20910

5

ur_ni_number

R

Specifies the network interface number used for connection by ITSLM - UR, as a number in the range from 1 through 60.# You can use the jslmuripls command to check the connected network device.

For details about the jslmuripls command, see jslmuripls (displays network interface number and IP address) in 9. Commands.

--

Legend:

R: Specification is required

O: Specification is optional

--: Not applicable

#

If the specified value is not within the permitted range, setup is completed, but an error occurs when the ITSLM - UR service JP1/ITSLM - User Response Service (service name: JP1_ITSLM_UR_Service) starts.

Notes

Return value

Return value

Description

0

Setup processing terminated normally.

1

Setup processing failed.

Example

C:\Program Files\HITACHI\JP1ITSLM\ur\bin\jslmursetup C:\Users\Administrator\Desktop\jp1itslm_setup.opt