17.35 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.
|
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.
|
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 exportdevice
-
ioutils exportdevicedetail
-
ioutils exportfield
-
ioutils exportfilter
-
ioutils exportoplog
-
ioutils exportpolicy
-
ioutils exporttemplate
-
ioutils exportupdategroup
-
ioutils exportupdatelist
-
ioutils importasset
-
ioutils importexlog
-
ioutils importfield
-
ioutils importfilter
-
ioutils importpolicy
-
ioutils importtemplate
-
ioutils importupdategroup
-
ioutils importupdatelist
-
reorgdb
-
startservice
-
stopservice
-
updatesupportinfo
-
deletenwgroup
-
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: