17.37 distributelicense (distributing licenses)

Functionality

This command is used to distribute licenses to a management relay server or to grant a management relay server permission to register licenses.

Note that you must execute this command on the primary management server.

Format

distributelicense{∆-i∆file-name|∆-d}

Arguments

-i

Use an absolute path of 259 bytes or less to specify the name of the file in which you set distribution destinations, the number of licenses to be distributed, and other information.

-d

This option initializes the license distribution and license registration permission settings for the management relay servers under the local server. All the distributed licenses are collected into the primary management server. If you specify the -d option, a confirmation message is displayed.

Storage location

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

You can execute this command without specifying the storage location for the executable file, by using the command prompt provided byJP1/IT Desktop Management 2.

File coding format

The following table describes the coding format of the file to be specified for the -i argument. Use a comma (,) to separate items.

Item	Required/ optional	Description	Input value
Host name of the management relay server	Required	Specify the host name of the management relay server to which the license is distributed. Make sure that the host name you specify is unique within the file.	Format of the host name
Processing mode	Required	Specify whether to distribute a license or to permit registration of a licence. For distribution DIST For registration permission REG	REG or DIST
Number of product licenses to be distributed	Required for distribution	Specify the number of licenses to be distributed to the management relay server. For distribution Specify an integer of 1 or greater. For registration permission No need to set a value	Integer of 1 or greater
Comment	Optional	Set a comment.	Any character string of up to 128 characters

The following are coding examples:

Host1,DIST,100,comment

Host2,DIST,50,

Host3,REG,,

Notes

• Execute this command when the database services are running.

• Two or more instances of this command cannot be simultaneously executed.

• 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

Return values

The following table lists the return values of the distributelicensecommand.

Return value	Description
0	The command finished normally.
11	The specified format for the argument is incorrect.
12	The specified file path is invalid, or you do not have permission to access the file.
31	Another command is being executed.
51	You do not have the permissions to execute this command.
54	The management server has not been set up.
58	The command was executed from other than a management server.
80	The format of the specified file is invalid.
101	Command execution was interrupted due to some other error.
110	The command execution failed due to a problem with a license.
120	A database access error occurred.

Example

The following example shows use of this command to distribute licenses by using license-distribution.csv (license distribution information) created in C:\temp\.

distributelicense -i C:\temp\license-distribution.csv

Related Topics:

• 17.1 Executing commands

To Page Top