VE License Server Installation

This step is only required under the following conditions:

• You plan to use VE licensing for your installation, AND

• you cannot use an existing VE license server making it necessary to install the license server software locally or on a dedicated system.

In this case, use the steps describe below.

VE License Server Package

The Charon VE License Server package is delivered as an RPM package. The software is not part of the Charon-PAR installation kit. Stromasys or your Stromasys VAR will provide you with the software or a download link. If an instance is created based on a Stromasys-provided emulator marketplace images, the installation kit is in the /charon/storage directory.

The packaging is different based on the VE license server version:

• VE license server version 2.2.3 and older: license-server-<version>.rpm
  RPM package for installation on a supported Linux system.

• VE license server version 2.2.4 and higher: license-server-<version>.rpm.sh
  Self-extracting archive containing the end-user license agreement (EULA) and the RPM package.

• VE license server version 2.4.9 and higher: charon-license-server-<version>.rpm.sh
  Self-extracting archive containing the end-user license agreement (EULA) and the RPM package.

In all cases <version> indicates the version of the software, for example, 2.4.9

Please note: the VE license server software has specific software and communication requirements (especially in the different cloud environments and on VMware). Please refer to the VE License Server Guide in Licensing Documentation on the Stromasys documentation page.

VE License Server Installation

Important: when upgrading to version 2.4.9 or above from an older version of the license server, additional steps are required:

• Before installing version 2.4.9 or later:

  • Backup modified VE configuration files (e.g., config.ini, non-default certificates).

  • Uninstall the old VE version (do not use the upgrade function).

• After installing the new version:

  • The latest xxx.v2c license file must be re-imported

  • Restore the previously saved files to the new installation directory and restart the license service.

Installation Steps

In the description below, the placeholders used have the following meaning:

• <mykey> is the private key of the key-pair you associated with your cloud instance
  (for an on-premises VMware installation or an installation on a physical system where logging in with username/password is allowed, this is not needed).

• <user> is the user 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 Stromasys-provided Charon AL or VE emulator marketplace image, use user charon for SFTP and user sshuser for interactive login.

• <linux-ip> is the ip address of your license server system.

Please note: if an instance was installed from a prepackaged Charon emulator marketplace image, the installation package is already stored in /charon/storage. Please check, if there are newer versions available that would be preferable for your environment.

Perform the following steps to install the VE License Server software:

1. Copy the license server software package to the license server host (if needed):

   1. For example, use sftp to connect to the VE license server system.
      sftp -i ~/.ssh/<mykey>  <user>@<linux-ip>

   2. Copy the software package to the license server system using the following SFTP command:
      put <local-path-to-license-server-package>

2. Use ssh to log in on the license server host.
   ssh-i ~/.ssh/<mykey> <user>@<linux-ip>

   
   

3. As a privileged user (root) go to the directory where you stored the installation package and install the package:

   1. Become the root user: sudo -i

   2. Go to the package location:  cd <path-to-package-directory>
      If you used SFTP to copy the package to an instance installed from a prepackaged Charon marketplace image, the home directory of the charon user and the default location for file transfers is /charon/storage.

   3. Unpack the archive and agree to the end-user license agreement (EULA).

      1. For VE license server 2.2.4 and above:

         1. sh ./license-server-<version>.rpm.sh
            This will display the EULA. You must agree to it to unpack the software.

         2. For version 2.2.4, the RPM installation package will be unpacked in the current directory.

         3. For version 2.2.5 and later, the EULA and the RPM package will be unpacked in a subdirectory (license-server-<version>.rpm) of the current working directory.

         4. RPM package name: license-server-<version>.rpm

      2. For VE license server 2.4.9 and above:

         1. sh ./charon-license-server-<version>.rpm.sh
            This will display the EULA. You must agree to it to unpack the software.

         2. The RPM installation package will be unpacked in a subdirectory (charon-license-server-<version>) of the current working directory.

         3. RPM package name: charon-license-server-<version>.rpm

         4. Important: if this is an upgrade from a version before 2.4.9, the old version must be uninstalled first and additional post-installation steps are required. Before proceeding, review the requirements described in the overview section above and the VE License Server Release Notes.

   4. Install the package: 

      1. Go to the directory in which the RPM package is located.           

      2. Linux 7.x: yum install <license-server-package-name>

      3. Linux 8.x and later: dnf install <license-server-package-name>