Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

  • For the first license request in a VMware environment: 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 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.
  • 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.

Div
classpagebreak


Running the esxi_bind Command

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 for the access to the ESXi host / the vCenter server change.

Perform the following steps:

  1. Use ssh to log in on the license server instance.
    # ssh <user>@<license-server-ip>
    where
    1. <user> is the user for interactive login associated with your license server system.
    2. <license-server-ip> the ip address of your license server system.
  2. Become the privileged user and run the esxi_bind program.
    1. Become the root user: # sudo -i
    2. Run the c2v 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.
  3. If the command is successful, it will create the file /opt/license-server/config.ini containing the connection data (the password is encrypted).

Collecting the Fingerprint Data on the License Server

...

  1. 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 cloud 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, or 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 cloud instancelicense server system.
  2. Become the privileged user and run the c2v program.
    1. Become the root user: # sudo -i
    2. Run the c2v program: # /opt/license-server/c2v --filename <my-file>.c2v --platform <my-platform>
      where
      1. <my-file>.c2v is the path and name under which you want to store the fingerprint. The file type is C2V (customer-to-vendor).
      2. <my-platform> indicates the platform on which the license server runs. Possible values: aws, oci, gcp, or azure. The value ibm shown in the help output is reserved for future use, ibm, or esxi.
  3. Copy the resulting C2V file to your local system (unless you can send email from the license server system).

...

  1. Copy the V2C file to the license server (e.g., with SFTP).
  2. 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 cloud license server instance (e.g., opc on OCI, or 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 cloud instancelicense server system.
  3. 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>.v2c
      where <my-file>.v2c is the path and name under which you want to store the fingerprint. The file type is V2C (vendor-to-customer).

...