The License Server kit contains the following command-line utilities:
All License Server utilities are located in /opt/license-server.
The c2v Utility
The c2v (Customer-to-Vendor) utility enables the user to collect the initial fingerprint of the license server system and later collect C2V data for license updates.
Usage: c2v [options]
The options are described in the table below:
| Option | Description |
|---|---|
| Specifies the name of the file in which the C2V data will be stored. |
-p, --platform platform | VE platform on which the license server runs:
|
-a, --auto | Create a C2V for an AutoVE license (mutually exclusive with general, non AutoVE licenses). |
-t, --transfer | Export a transfer file (.tfr) to transfer the license to another system. |
-d, --debuglog | Print a debug log. |
-h, --help | Print the usage information. Default if no parameter is selected. |
The v2c Utility
The v2c (Vendor-to-Customer) utility enables the user to install the initial license and subsequent license updates.
Usage: v2c [options]
The options are described in the table below:
| Option | Description |
|---|---|
| Specifies the name of the file containing the V2C data. |
-s, --silent | Run v2c in silent mode. New in version 1.1.23. Using this option will suppress the change confirmation dialog when updating an existing license. |
-d, --debuglog | Print a debug log. |
-h, --help | Print the usage information. Default if no parameter is selected. |
Please note:
- If the V2C file installed is an update to an existing license, the v2c command will first show the difference between old and new license and wait for the user confirmation before proceeding with the update. If absolutely required, this behavior can be suppressed using the
-soption. Carefully review the changes before accepting them. - To import the same license repeatedly will not cause a problem. In this case, the user will not be asked to confirm the import.
- The difference between old and new license is shown as a side-by-side list of the old and new license parameters. This list uses short parameter names to keep the old and new parameter on one line.
Example output of the comparison list:
|
The license_viewer Utility
The license_viewer utility enables the user to displayed installed licenses.
Usage: license_viewer [options]
The options are described in the table below:
| Option | Description |
|---|---|
| Displays the license clients connected to the server. |
-r, --register | Displays the registered license clients. |
-o, --output file.csv | Send command output to a CSV file. New in version 1.1.23. |
-u, --usage | Shows license utilization. That is, it shows how many of the allowed instances for each product sections are currently used and how many instances are still available. New in version 1.1.23. After a license server restart, it could take up to one hour for the output to be correct again (time to the next connection made by the active emulators). |
-n, --number count | Used in combination with the -r parameter, this parameter shows the last count hosts that registered with the AutoVE server. Useful especially for servers with many registered clients. |
-h, --help | Print the usage information |
| No parameter | If run without parameters, the installed licenses will be displayed. |
The esxi_bind Utility
The esxi_bind utility is used to establish the connection between license server and ESXi host or vCenter Server.
Usage: esxi_bind [options]
The options are described in the table below:
| Option | Description |
|---|---|
| IP address of the ESXi host or vCenter Server. |
-u, --username username | Username of a user on the ESXi host or vCenter Server. Important notes regarding the user on the ESXi host or the vCenter Server: The user must have at least the following global permissions (i.e. the permissions cannot be limited to a specific VM): Please note: if username and/or password contain Unix shell meta-characters, these characters must be escaped (enclose the string in single quotes, or add a backslash character in front of the meta-character). |
-p, --password password | Password of the user specified in the username option. |
-d, --debuglog | Print a debug log. |
-h, --help | Print the usage information. Default if no parameter is selected. |
Please note: if username and/or password contain Unix shell meta-characters, these characters must be escaped (enclose the string in single quotes, or add a backslash character in front of the meta-character).
Command-Line Options of the License Server
The license server itself has some command-line options. They are described below.
Usage: license_server [options]
| Option | Description |
|---|---|
| Change the password of the web GUI user charon. Available starting with version 1.1.14. |
-s, --status | Display the status of the license_server. Available starting with version 1.1.18. |
-l debug | Enable debug log output when starting the license server. |
-h, --help | Print the usage information. |
| No parameter | If run without parameters, the system will attempt to start the license server. |