Table of Contents

exclude	Contents
style	square

Div

class	pagebreak

Important Information to Protect the License Validity

Certain actions can invalidate your license. Therefore, once you have installed your license, please note the following points:

Insert excerpt

	Operational Information and Logging	Operational Information and LoggingPDC:__Include: Installing a License on the VE License Server
	PDC:__Include: Installing a License on the VE License Server
name	VELicInvalidationCaveat
nopanel	true

Div

class	pagebreak

Overview - Requesting and Installing a License

...

Perform the following basic steps to request and install a license:

VMware only: for the first license request in a VMware environment, or if the binding data has changed, use the esxi_bind command to bind the license server to its ESXi host or vCenter Server.
Collect the fingerprint (the customer-to-vendor - or C2V - file) on the license server and (if applicable) the backup license server.
Send the fingerprint data to Stromasys stating the license requirements based on your contract with Stromasys (product version, number of concurrent instances, is this the main or the backup license, etc.). Stromasys will send you the license data. Please also indicate if you require a license with or without a passphrase (can be selected per product section). The use of a passphrase requires Charon-SSP emulator versions 4.3.x and higher and VE license server versions 1.1.x and higher.
Install the license data (the vendor-to-customer - or V2C - file) on the license server and (if applicable) on the backup license server.
Verify the license installation.

These basic steps are described in more detail below.

...

class	pagebreak

Insert excerpt
PDC:Include: Installing a License on the VE License Server
PDC:Include: Installing a License on the VE License Server
name VEStepsOverview
nopanel true

License Installation Using the Command-Line

The following sections will show how to perform a license installation on the VE license server. Alternatively, you can use the web-based GUI (see VE License Server Web-based Management GUI)

Running the esxi_bind Command (VMware environment only)

The esxi_bind command sets up the necessary communication connection between the VE license server and the ESXi host / the vCenter Server.

It must be run on the license server (and the backup license server, if applicable):

once before the first license is requested, and
again should the user credentials, the password, or the address data for the access to the ESXi host / the vCenter Server change. Please make sure that the password of the selected user account does not automatically expire after a certain time period. This would cause disruptions in the license server operation and make it impossible for clients to receive their license.

Perform the following steps:

...

<user> is the user for interactive login associated with your license server system
<license-server-ip> the ip address of your license server system

...

Become the root user: # sudo -i
Run the esxi_bind program: # /opt/license-server/esxi_bind -a <address> -u <username> -p <password>where
1. <address> is the IP address of the ESXi host or vCenter Server
2. <username> is a user with administrative rights on the ESXi host or vCenter Server
3. <password> is the password of the administrative user

...

Insert excerpt

	PDC:__Include: Installing a License on the VE License Server
	PDC:__Include: Installing a License on the VE License Server
name	VEesxi_bind
nopanel	true

Collecting the Fingerprint Data on the License Server

The fingerprint is collected on the license server using the c2v utility.

Perform the following steps to collect the fingerprint on the license server and (if applicable) the backup license server:

...

<mykey> is the private key of the key-pair you associated with your cloud instance
(for an on-premises VMware installation where login with username/password is allowed, it is not needed)
<user> is the user for interactive login associated with your license server instance (e.g., opc on OCI, centos for a CentOS instance on AWS, or the custom user on your VMware virtual machine;
for an instance installed from a prepackaged Charon-SSP VE marketplace image, use sshuser)
<license-server-ip> is the ip address of your license server system

...

Become the root user: # sudo -i
Run the c2v program: # /opt/license-server/c2v [-a] --filename <my-file>.c2v --platform <my-platform>where
1. The optional -a parameter creates the fingerprint for a AutoVE license. Regular VE mode and AutoVE mode are mutually exclusive.
2. <my-file>.c2v is the path and name under which you want to store the fingerprint. The file type is C2V (customer-to-vendor)
3. <my-platform> indicates the platform on which the license server runs (possible values: aws, oci, gcp, azure, ibm, or esxi)

...

Insert excerpt

	PDC:__Include: Installing a License on the VE License Server
	PDC:__Include: Installing a License on the VE License Server
name	VEGetFGP
nopanel	true

Sending the C2V File to Stromasys and Receive License Data File

Stromasys or your Stromasys VAR will provide you with an email address to which you should send the C2V file you created in the previous step. Please indicate if you require a license with or without a passphrase (can be selected per product section). The use of a passphrase requires Charon-SSP emulator versions 4.3.x and higher and VE license server versions 1.1.x and higher.

...

Insert excerpt
PDC:Include: Installing a License on the VE License Server
PDC:Include: Installing a License on the VE License Server
name VESendC2Vupd2
nopanel true
Div
class pagebreak

Installing the License Data on the License Server

The license data is installed on the license server using the v2c utility.

Perform the following steps to install the license on the license server:

Copy the V2C file to the license server (e.g., with SFTP).
Use ssh to log in on the license server instance.
# ssh -i ~/.ssh/<mykey> <user>@<license-server-ip>
where
1. <mykey> is the private key of the key-pair you associated with your license server instance
  (for an on-premises VMware installation where login with username/password is allowed, it is not needed)
2. <user> is the user for interactive login associated with your license server instance (e.g., opc on OCI, centos for a CentOS instance on AWS, or the custom user on your VMware virtual machine);
  for an instance installed from a prepackaged Charon-SSP VE marketplace image, use sshuser)
3. <license-server-ip> is the ip address of your license server system
Become the privileged user and run the v2c program.
1. Become the root user: # sudo -i
2. Run the v2c program: # /opt/license-server/v2c -f <my-file>.v2cwhere <my-file>.v2c is the path and name under which you want to store the fingerprint. The file type is V2C (vendor-to-customer).

After the installation of the V2C file, the license server will be restarted.

Please note:

Starting with version 1.0.35, a previously installed license will be cleanly removed once a new license is installed with the v2c command.
In versions before 1.0.17, the license server will not start until a valid license has been installed.

The following example shows the installation of a V2C file:

...

language	text

...

Insert excerpt

	PDC:__Include: Installing a License on the VE License Server
	PDC:__Include: Installing a License on the VE License Server
name	VEV2Cupd2
nopanel	true

Verifying License Installation and License Content

...

Check the license server log file to see if the server started successfully or reported an error. Use the following command (as the privileged user):
# cat /opt/license-server/license_log/license.log

The log should indicate that the license server is ready to serve licenses.

...

#/opt/license-server/license_viewer

The following sample table shows the output examples for several different licenseslicense types and platforms (please note that the output may vary depending on platform and software version) :

# /opt/license-server/license_viewerAutoVE license on AWS

Regular VE license on AWS	Regular VE license on VMware	physical server
<<License Viewer>> Current license: License fingerprintFingerprint: 07792211fc8ce3fdc085 <truncated> Customer nameName: Stromasys License ID: 01.00000001.002.020 Key typeType: NORMAL Platform: amazon.aws Release dateDate: 2021-06-17 13:08:01 Grace periodPeriod: 120 minutes License check intervalCheck Interval: 60 minutes Virtual Hardware: Charon-SSP/4M,Charon-SSP/4U Product codeCode: Charon-SSP/ALL Expiration dateDate: 2021-12-22 23:55:00 Major Version: 5 Minor Version: 3 Maximum CPU: 64 Maximum virtual memoryVirtual Memory: 1048576MB Instances allowedAllowed: 3 `# /opt/license-server/license_viewer`	`<<License Viewer>> Current license:` `License fingerprintFingerprint: 07792211fc8ce3fd 07792211fc8ce3fdc085` *<truncated>* `Customer nameName: Stromasys` `License ID: 03.00000003.002.006` `Key typeType: NORMAL` `Platform: vmwarephysical.esximachine` `Release dateDate: 2021-0612-17 08 13:0818:0132` `Grace periodPeriod: 120 minutes` `License check intervalCheck Interval: 60 minutes` `Virtual Hardware: Charon-SSP/4M,Charon-SSP/4U` `Product code: Charon-SSP/ALL` `Expiration date: 2021-12-22 -PA9-64-L1` `Product Code: CHPA9-64-L1-IP` `Expiration Date: 2022-06-08 23:55:00` `Major Version: 53` `Minor Version: 30` `Maximum CPU: 641` `Maximum virtual memoryVirtual Memory: 1048576MB2048MB` `Instances allowedAllowed: 310` `Passphrase: DYRB77U8-KHDWHXR9-0CUQ-5B6V`	`VUFK-1B9V`
Countdown license on physical server	`<<License Viewer>> Current license:` `License fingerprint: 5aaa364f9fc602323eaab2c <truncated>` `Customer name: Stromasys` `License ID: 03.00000003.002.007` `Key type: NORMAL` `Expiration date: 2022-02-14 23:55:00` `Platform: amazon.aws` `Release date: 2021-07-27 10:42:44Grace period: 1440 minutes` `Instances allowed: 3` `Auto license: true`	AutoVE license on AWS
`<<License Viewer>> Current license:` `License fingerprintFingerprint: 5f9d9f13f390e3b071` <truncated> `Customer nameName: Stromasys` `License ID: 01.00000001.002.194` `Key typeType: COUNTDOWN` `Expiration dateDate: 240 hour(s)` `Platform: physical.machine` `Release dateDate: 2021-07-29 09:06:15` `Grace periodPeriod: 480 minutes` `License check intervalCheck Interval: 60 minutes` `Virtual Hardware: Charon-SSP/4U` `Product codeCode: test` `Major Version: 5` `Minor Version: 3` `Maximum CPU: 4` `Maximum virtual memoryVirtual Memory: 10240MB` `Instances allowedAllowed: 4`

The license contains a key-specific section and one or more product-specific sections.

Important key-specific license parameters:

Platform: the platform for which the license has been created. This parameter cannot be changed by a license update.
Release date: date on which the license has been issued.
Customer name: the owner of the license. This parameter cannot be changed by a license update. If a change is required, the existing license must be removed before creating a new fingerprint.
License ID: in older versions, the license ID changed if the license server software was reinstalled; in newer versions, it will remain unchanged as long as the license server host instance is not re-installed. This parameter cannot be changed by a license update. If a change is required, the existing license must be removed before creating a new fingerprint.
Key type: possible values are NORMAL (time-limited or perpetual license) or COUNTDOWN (limited to a certain number of emulator runtime hours).
Expiration date: configured number of emulator runtime hours. The remaining hours can be seen in the web interface of the license server and the emulator log file.
Grace period: time in minutes the emulator can run after the license used by the emulator has timed out or disappeared. Configured by Stromasys when creating the license.
License check interval: license check interval (1 hour).

Important product-specific license parameters:

Expiration date: is the expiration date.
Major version and Minor version: the major and minor product versions.
Maximum CPU: defines the maximum number of CPUs in an emulated system (emulated SPARC in the example).
Maximum virtual memory: defines the maximum amount of RAM in an emulated system.
Instances allowed: defines the maximum number of concurrently running emulated systems.
Passphrase: defines the passphrase that must be configured on the license client system.

...

class	pagebreak

Using the Web Interface

The license server provides a web interface to display important license characteristics and a list of currently connected client systems and emulator instances.

Prerequisite: access to TCP port 8084 of the license server must be possible.

The following image shows sample output of a backup license with 179 hours and 57 minutes of runtime remaining:

Image Removed

The following image shows sample output of a regular license with an expiration date and one client attached:

Image Removed

The following example shows a license on a physical server with the grace period parameter:

Image Removed

...

<<License Viewer>> Current license:
License Fingerprint: 5aaa364f9fc602323eaab2c <truncated>
Customer Name: Stromasys
License ID: 03.00000003.002.007
Key Type: NORMAL
Expiration Date: 2022-02-14 23:55:00
Platform: amazon.aws
Release Date: 2021-07-27 10:42:44Grace Period: 1440 minutes
Instances Allowed: 3 Passphrase:Auto License: true

Div

class	pagebreak

The license contains a key-specific section and one or more product-specific sections. Please note that the product-specific section is mostly not applicable to AutoVE licenses as this license is based on the number and configuration of the cloud-based host instances.

Insert excerpt

	PDC:__Include: Installing a License on the VE License Server
	PDC:__Include: Installing a License on the VE License Server
name	VELicContent
nopanel	true

License Verification Using the Web Interface

Insert excerpt

	PDC:__Include: Installing a License on the VE License Server
	PDC:__Include: Installing a License on the VE License Server
name	VEGUIinfo
nopanel	true

See VE License Server Web-based Management GUI and Additional Configuration Options - the config.ini File for more information.

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

Versions Compared

Old Version 74

New Version Current

Key

Important Information to Protect the License Validity

Overview - Requesting and Installing a License

Insert excerpt
PDC:Include: Installing a License on the VE License Server
PDC:Include: Installing a License on the VE License Server
name VEStepsOverview
nopanel true

License Installation Using the Command-Line

Running the esxi_bind Command (VMware environment only)

Collecting the Fingerprint Data on the License Server

Sending the C2V File to Stromasys and Receive License Data File

Insert excerpt
PDC:Include: Installing a License on the VE License Server
PDC:Include: Installing a License on the VE License Server
name VESendC2Vupd2
nopanel true
Div
class pagebreak

Installing the License Data on the License Server

Verifying License Installation and License Content

Using the Web Interface

License Verification Using the Web Interface

Page Comparison

Versions Compared

Old Version 74

New Version Current

Key

Important Information to Protect the License Validity

Overview - Requesting and Installing a License

Insert excerptPDC:__Include: Installing a License on the VE License ServerPDC:__Include: Installing a License on the VE License ServernameVEStepsOverviewnopaneltrue

License Installation Using the Command-Line

Running the esxi_bind Command (VMware environment only)

Collecting the Fingerprint Data on the License Server

Sending the C2V File to Stromasys and Receive License Data File

Insert excerptPDC:__Include: Installing a License on the VE License ServerPDC:__Include: Installing a License on the VE License ServernameVESendC2Vupd2nopaneltrue Divclasspagebreak

Installing the License Data on the License Server

Verifying License Installation and License Content

Using the Web Interface

License Verification Using the Web Interface

Insert excerpt
PDC:Include: Installing a License on the VE License Server
PDC:Include: Installing a License on the VE License Server
name VEStepsOverview
nopanel true

Insert excerpt
PDC:Include: Installing a License on the VE License Server
PDC:Include: Installing a License on the VE License Server
name VESendC2Vupd2
nopanel true
Div
class pagebreak