17.48 rlyigwsetconf (setting a management relay server with Internet Connectivity)

Functionality

This configures management relay server to connect to higher management server through an Internet gateway. The configuration information is described in the Internet connection settings file.

You can also output a template of an Internet connection settings file when you first set up management relay server for the first time, or an Internet connection settings file with the current settings if you have already set it up.

Execute this command on a management relay server. Complete the management relay server setup process before executing this command.

Format

rlyigwsetconf∆{-i∆settings-file-name|-o∆output-file-name}[∆-s]

Arguments

-i∆settings-file-name

Specify the absolute path of the Internet connection settings file to be set to management relay server. If the path contains any single-byte spaces, enclose the entire path in ".

-o∆output-file-name

For the first time immediately after setting up the management relay server, a template of the Internet connection setting file is output to the specified file.

Specify the absolute path of the output file. If the path contains any single-byte spaces, enclose the entire path in ".

-s

Automatically performs all actions without asking the user.

When -i is specified, the confirmation message to stop the service is not displayed and the service is stopped.

If -o is specified, the command overwrites the file with the same name even if it already exists in the output destination.

Storage location

JP1/IT Desktop Management 2-installation-destination-folder\mgr\bin\

Format of the Internet connection settings file

For details about a format of the Internet connection settings file, see the instructions on Procedure for connecting a management relay server to an Internet gateway in the manual JP1/IT Desktop Management 2 Configuration Guide.

Notes

• Execute this command when the management relay server setup is completed and the management server is running.

• This command cannot be simultaneously executed by multiple users.

• This command cannot be executed simultaneously with any of the following commands:

  • exportdb

  • importdb

  • ioassetsfieldutil export

  • ioassetsfieldutil import

  • ioutils exportasset

  • ioutils exportassetassoc

  • ioutils exportdevice

  • ioutils exportdevicedetail

  • ioutils exportfield

  • ioutils exportfilter

  • ioutils exportoplog

  • ioutils exportpolicy

  • ioutils exporttemplate

  • ioutils exportupdategroup

  • ioutils exportupdatelist

  • ioutils importasset

  • ioutils importassetassoc

  • ioutils importexlog

  • ioutils importfield

  • ioutils importfilter

  • ioutils importpolicy

  • ioutils importtemplate

  • ioutils importupdategroup

  • ioutils importupdatelist

  • reorgdb

  • startservice

  • stopservice

  • updatesupportinfo

  • deletenwgroup

  • deletepackage

  • distributelicense

  • deletenwctllist

Return values

The following table shows the return values of the rlyigwsetconf command.

Return value	Description
0	The command finished normally.
1	Applying the settings in the specified internet connection settings file succeeded, but the JP1_ITDM2_Agent Service, and the management relay server services failed to start.
11	The specified argument is incorrect.
12	Error accessing the specified Internet connection settings file.
15	File access error during file output or insufficient disk space.
31	Another command is being executed.
51	You do not have the permissions to execute this command.
54	Management relay server has not been set up.
57	Run outside of management relay server.
80	The format of the specified Internet connection settings file is invalid. Or, you cannot access the Internet connection configuration file.
101	Command execution failed due to insufficient memory.
102	Failed to stop service.
150	The command execution was interrupted due to some other error.

Example

The following is a sample usage for outputting the connection information to the internet gateway currently set in management relay server as an internet connection settings file to the C:¥temp¥inetcon.conf.

rlyigwsetconf -o C:¥temp¥inetcon.conf

Related Topics:

• 17.1 Executing commands

To Page Top