Versions Compared

Key

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

...

The Charon-SSP VE License Server package is delivered as an RPM package. Stromasys or your Stromasys VAR will provide you with the software or a download link.

Package name:

license-server-<version>.rpm

Where <version> indicates the version of the software, for example, 1.0.2835.

Div
classpagebreak


Linux Cloud Instance for License Server

...

Depending on the cloud environment, Stromasys may offer a prepackaged Charon-SSP VE image on the cloud marketplace. This image includes the Charon-SSP emulator software (already installed) and the VE License Server RPM package (can be installed optionally). An instance launched from such a prepackaged image can also be used as a VE license server.

...

  • If the license server is combined with the Charon-SSP emulator software on the same instance, the instance used must satisfy the requirements of the Charon-SSP host and all instances that will run on it. If this requirement exists, please refer to the your Charon-SSP user's guide for details.

Additional general requirements:

  • In the AWS cloud, an IAM role allowing the ListUsers action (IAMReadOnlyAccess in the example below) must be attached to the instance. This can be done during the launch of the instance as shown in the sample below.

    Alternatively, the role can be set/changed by selecting the instance, right-clicking on it, and selecting Instance Settings Security > Modify IAM Role (in the older AWS console, use the Action menu). If such a role has not yet been defined, please refer to Creating and Attaching an AWS IAM Role and to the documentation provided by AWS for additional information.

...

Any intermediate firewall as well as the cloud-specific subnet and instance security settings must permit the following ports to for the appropriate source systems:

  • TCP/8083: must be permitted from on the client to license server for the client system to enable the use of the the license by the client.
  • TCP/8084: must be permitted by the the license server for any system that should access the web interface to display information about licenses and active clients (currently not encrypted, hence should not be run across the Internet without a VPN).

See Cloud-Specific Firewall Information for information about the traffic filtering mechanisms used in the different cloud environments.

...

  • The default zone name can be found with the command firewall-cmd --get--default-zone, a list of all zones can be displayed with the command firewall-cmd --get-zones.
  • The parameter --permanent writes the command to the respective firewalld configuration files. To add the command to the running firewall, re-run it without the parameter --permanent.
  • The simplified sample above does not limit the source IP address to the addresses of the license clients. This would require a more sophisticated configuration. Please refer to the documentation of your Linux system.

...

The VE license server software requires matching Charon-SSP emulator software. The necessary features are available in Charon-SSP 4.2.x and its pre-releaseslater. Stromasys or your Stromasys VAR will provide you with the software or a download link. In certain cloud environments, Stromasys may offer a prepackaged Charon-SSP VE image on the cloud marketplace. This image includes the Charon-SSP emulator software (already installed) and the VE License Server RPM package (can be installed optionally). If you use a Charon host in the cloud and the instance was launched from such a prepackaged image, the required VE-capable emulator software is already installed (refer to the respective cloud-specific Getting Started Guide for more information).

Please note: The protocol versions used by the emulator software and the license server must be compatible. The software checks for compatible protocol versions and and reports an error should there be a mismatch.

...

  • Management components (not VE-specific):
    • charon-agent-ssp-<version>-x86_64.rpm
    • charon-director-ssp-<version>.rpm
    • charon-manager-ssp-<version>.rpm
  • VE-capable emulator software:
    • charon-ssp-<architecture>-<version>.ve.el7-x86_64.rpm, or
    • charon-ssp-<architecture>-<version>.ve.el8-x86_64.rpm

In the above list, the parameters placeholders have the following meaning:

  • <version> indicates the software version (e.g., 4.12.215).
  • <architecture> indicates the type of emulated SPARC covered by the software (currently it can have the values 4m, 4u, 4v, 4u+, or 4v+).
  • The string ve in the package containing the Charon emulator software indicates that this version of the emulator requires a VE license server.
  • The string el7 denotes packages intended for Red Hat/CentOS/Oracle Linux 7.x.
  • The string el8 denotes packages intended for Red Hat/CentOS/Oracle Linux 8.x.
  • Charon Agent, Manager, and Director are not license-model specific.

...

  • In versions before 1.0.17, the license server will not start automatically after the initial installation. It will be started once a valid license has been installed (see Installing a License on the VE License Server).
  • When upgrading to version 1.0.24 from an older version of the license server, a license update is required due to a change in the license schema.
  • If you plan to use a primary and a backup license server, the license server software must be installed on both systems.

...

  1. Copy the license server software package to the cloud instance (if still required):
    1. Use sftp to connect to the cloud instance.
      # sftp -i ~/.ssh/<mykey>  <user>@<cloud-instance-ip>
      where
      1. <mykey> is the private key of the key-pair you associated with your cloud instance
      2. <user> is the user associated with your cloud instance (e.g., opc on OCI, or centos for a CentOS instance on AWS; for an instance installed from a prepackaged Charon-SSP VE image, use the SFTP user charon)
      3. <cloud-instance-ip> the ip address of your cloud instance
    2. Copy the software package to the cloud instance using the following sftp command:
      > put <local-path-to-license-server-package>
  2. Use ssh to log in on the cloud instance.
    # ssh-i ~/.ssh/<mykey> <user>@<cloud-instance-ip>
    where
    1. <mykey> is the private key of the key-pair you associated with your cloud instance
    2. <user> is the user for interactive login associated with your cloud instance (e.g., opc on OCI, or centos for a CentOS instance on AWS; for an instance installed from a prepackaged Charon-SSP VE image, use sshuser)
    3. <cloud-instance-ip> the ip address of your cloud instance
  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>
      On an instance installed from a prepackaged Charon-SSP VE image, the installation package is stored under /charon/storage)
    3. Install the package:             
      1. Linux 7.x: # yum install license-server*.rpm
      2. Linux 8.x: # dnf install license-server*.rpm

...

Code Block
languagetext
# yum install license-server-1.0.1635.rpm
Loaded plugins: fastestmirror, langpacks
Examining license-server-1.0.1635.rpm: license-server-1.0.1635-1.x86_64
Marking license-server-1.0.1635.rpm to be installed
Resolving Dependencies
--> Running transaction check
---> Package license-server.x86_64 0:1.0.1635-1 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

================================================================================
 Package            Arch       Version         Repository                  Size
================================================================================
Installing:
 license-server     x86_64     1.0.1635-1        /license-server-1.0.1635      1179 M

Transaction Summary
================================================================================
Install  1 Package

Total size: 1179 M
Installed size: 1179 M
Is this ok [y/d/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Installing : license-server-1.0.1635-1.x86_64                               1/1 
  Verifying  : license-server-1.0.1635-1.x86_64                               1/1 

Installed:
  license-server.x86_64 0:1.0.1635-1                                              

Complete!


Div
classpagebreak


...

At least the required emulator packages (charon-ssp-4*.rpm) and the agent (charon-agent*.rpm) must be installed for the system to run emulated SPARC systems and to allow remote management by the Charon Manager. If local management with graphical tools is required, then the Charon Manager and the Charon Director packages must also be installed. 

...

Please note: To use the graphical user interface (Charon Manager for SSP) the Charon Manager package typically has to be is installed on your local Linux or Windows PC that will be used for management purposes. Running the Charon Manager in a non-graphical cloud instance and export it via X11-Forwarding is possible, but will require additional configuration and installation steps (with access to a package repository) - this is outside the scope of this document. It is also possible to manage Charon-SSP via the command-line only. This is described in the general Charon-SSP user's guide.

...

The packages above have their own dependencies. Install the above packages with the yum (or dnf) command in order to have their dependencies automatically installed. If your server does not have access to the standard operating system repositories, refer to this document for instructions on setting up a local repositories.

Div
classpagebreak


Sample Installation

Only the Charon-SSP emulator packages (4M, 4U(+), 4V(+)) are specific to the license model used. The packages required for managing Charon-SSP (Charon Agent, Manager, and Director) are the same as in the conventional product of the same version.

...

Code Block
languagetext
# yum install charon*.rpm
Loaded
plugins:
fastestmirror, langpacks

(lines removed)

Resolving Dependencies
--> Running transaction check
---> Package charon-agent-ssp.x86_64 0:4.1.14-1 will be installed
---> Package charon-director-ssp.x86_64 0:4.1.14-1 will be installed
---> Package charon-manager-ssp.x86_64 0:4.1.14-1 will be installed
---> Package charon-ssp-4m.x86_64 0:4.1.14.cloud-1 will be installed
---> Package charon-ssp-4u+.x86_64 0:4.1.14.cloud-1 will be installed
---> Package charon-ssp-4v+.x86_64 0:4.1.14.cloud-1 will be installed
--> Finished Dependency Resolution

(lines removed)   

Dependencies Resolved

(lines removed)

Dependencies Resolved

================================================================================
 Package                 Arch   Version     Repository                    Size
================================================================================
Installing:
Package charon-agent-ssp        x86_64 4.2.5-1   Arch   Version      Repository/charon-agent-ssp-4.2.5-x86_64 32 M
 charon-director-ssp     x86_64 4.2.5-1     /charon-director-ssp-4.2.5     287 k
 charon-manager-ssp      x86_64 4.2.5-1    Size
================================================================================
Installing:
 charon-agent-ssp /charon-manager-ssp-4.2.5      5.8 M
 charon-ssp-4m           x86_64 4.1.142.5.ve.el7-1      /charon-agentssp-ssp4m-4.2.15.ve.14el7-x86_64    28 6.1 M
 charon-director-ssp x86_64 4.1.14-1ssp-4u+          x86_64 4.2.5.ve.el7-1  /charon-directorssp-ssp4u+-4.2.1.14  5.ve.el7-x86_64 54 M
 charon-ssp-4v+     287 k  charon-manager-ssp  x86_64 4.1.142.5.ve.el7-1      /charon-managerssp-ssp4v+-4.1.14        4.2 M
 charon-ssp-4m       2.5.ve.el7-x86_64 4.1.14.cloud-1  /charon-ssp-4m-4.1.14.cloud-x86_64  5.5 M
 charon-ssp-4u+      x86_64 4.1.14.cloud-1  /charon-ssp-4u+-4.1.14.cloud-x86_64  41 M
 charon-ssp-4v+      x86_64 4.1.14.cloud-1  /charon-ssp-4v+-4.1.14.cloud-x86_64  41 M

Transaction Summary
====54 M

Installing for dependencies:
 
(lines removed)
 
Transaction Summary
==============================================================================================================
Install  6 Packages

Total size: 120 M
Installed size: 120 M
Is this ok [y/d/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Installing : charon-ssp-4u+-4.1.14.cloud-1.x86_64                          1/6 
  Installing : charon-ssp-4v+-4.1.14.cloud-1.x86_64                          2/6 
  Installing : charon-manager-ssp-4.1.14-1.x86_64                            3/6 
  Installing : charon-director-ssp-4.1.14-1.x86_64                           4/6 
  Installing : charon-agent-ssp-4.1.14-1.x86_64                              5/6 
Created symlink from /etc/systemd/system/multi-user.target.wants/ssp-agentd.service to /etc/systemd/system/ssp-agentd.service.
  Installing : charon-ssp-4m-4.1.14.cloud-1.x86_64                           6/6 
  Verifying  : charon-ssp-4m-4.1.14.cloud-1.x86_64                           1/6 
  Verifying  : charon-agent-ssp-4.1.14-1.x86_64                              2/6 
  Verifying  : charon-director-ssp-4.1.14-1.x86_64                           3/6 
  Verifying  : charon-manager-ssp-4.1.14-1.x86_64                            4/6 
  Verifying  : charon-ssp-4v+-4.1.14.cloud-1.x86_64                          5/6 
  Verifying  : charon-ssp-4u+-4.1.14.cloud-1.x86_64                          6/6 

==
Install  6 Packages (+32 Dependent packages)

Total size: 161 M
Total download size: 8.9 M
Installed size: 183 M
Is this ok [y/d/N]: y
Downloading packages:

(lines removed)

Running transaction check
Running transaction test
Transaction test succeeded
Running transaction

(lines removed)

Installed:
  charon-agent-ssp.x86_64 0:4.12.145-1      charon-director-ssp.x86_64 0:4.12.145-1   
  charon-manager-ssp.x86_64 0:4.12.145-1    charon-ssp-4m.x86_64 0:4.12.5.14ve.cloudel7-1      
  charon-ssp-4u+.x86_64 0:4.12.5.14ve.cloudel7-1  charon-ssp-4v+.x86_64 0:4.12.5.14ve.cloud-1el7-1     

(lines removed)                                 

Complete!


Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc