9.19 jslmursetup (sets up SLM - UR) : JP1 Version 11 JP1/Service Level Management Description

Function

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

After installing SLM - UR, execute the command after investigating one of the following:

Execute the jslmuripls command and investigate the network interface number and IP address to be subject to collection of HTTP packets
Execute the jslmurnals command and investigate the network adapter address and IP address to be subject to collection of HTTP packets

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 SLM - UR has been newly installed or after the execution environment for SLM - 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 SLM - UR already exists, the command reconfigures the existing execution environment for SLM - 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 SLM - UR are to be changed.
The execution environment for a configured SLM - 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

SLM-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:

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

The following shows the definitions in the options file:Specify one or the other for "ur_ni_number" and "ur_na_address".

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

The following table provides the details of definition items.

Table 9‒27: Details of definition items in options file for SLM - UR
No.	Definition item	Specification	Description	Default value
1	`manager_host`	R	Specifies the host name or IP address of the host on which SLM - Manager is installed, as the information for identifying SLM - Manager's execution environment. If SLM 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 SLM - 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 SLM - UR is installed, as the information for identifying SLM - UR's execution environment. If SLM 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 SLM - 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 SLM - 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 9.17 jslmuripls (displays network interface number and IP address) in 9. Commands.	--
6	ur_na_address	R	Specifies the network adaptor address the instance of SLM - UR will connect to as a single-byte hexadecimal number of up to 12 digits. The connected network devices can be confirmed by using the `jsmlurnals` command. For details on the `jsmlurnals` command, see 9.18 jslmurnals(displays the network adapter address and IP address).	--

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 SLM - UR service SLM - User Response Service (service name: JP1_ITSLM_UR_Service) starts.

Notes

If an error occurs during setup, eliminate the cause of the error and re-execute the command.
The options file used during setup is renamed jp1itslm_setup.opt after command execution and stored at the following location:
```
SLM-UR-installation-folder\ur\conf\jp1itslm_setup.opt
```
Do not execute commands other than the jslmuripls command or the jslmurnals command while this command is being executed.
If the folder shown below contains the options file, the command renames that options file by adding .bk, saves it in the same folder, and then creates a new options file:
```
SLM-Manager-installation-folder\ur\conf\
```
If a file with the same name already exists when the options file is saved, the existing file is overwritten. If the file save processing fails, setup fails. The values of definition items contained in the saved options file are inherited to the new options file. However, for the definition items that were specified in the options file when the command was executed, the specified values are set. Comments are not inherited.
Do not terminate setup processing by pressing Ctrl+C or closing the window. Also, in the event of an error, wait until setup is completed before proceeding.
Before you start the setup processing, terminate all other resident software programs, including other installers and applications (other applications include the jslmursetup and jslmurunsetup commands).
If setup is performed with the -c option specified in the command and any of a set of specific errors occurs during operation, the Windows services are closed by SLM - Manager. For details about the errors that result in a stoppage of the Windows services, see 6.1.3 Failover timing.

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