Contents

At the time of writing, Charon-SSP was the only emulator product supporting VE licenses. Charon-SSP must be configured with the information needed to find the VE server(s).

The license server address, and optionally, a passphrase must be configured on the Charon-SSP host system for every emulated system that is to use the license server. This configuration is normally performed via the Charon Manager. On host systems that allow command-line access, it can also be performed by editing the configuration file.

Configuring the License Server Details Using the Charon Manager

To configure the license server details using the Charon Manager, perform the following steps:

1. Start the Charon Manager and log in to your Charon-SSP host system. Please refer to the user's guide of your Charon-SSP product for details.

2. Select the emulated SPARC system from the list of VMs on the left and click on Edit Virtual Machine to open the configuration window:
   
   
   
   

   
   
3. In the configuration window select the license configuration section and enter the following data into the Virtual Environment section:
   1. Primary license server: enter the IP address of the primary license server (use localhost or 127.0.0.1 if the license server runs on the same system as the emulator).
   2. Backup license server: if you have a backup license server (supported in Charon-SSP version 4.1.19 or later), add the IP address of the backup server in this field. The backup server provides a license limited to a certain number of runtime hours should the primary server become unavailable. If all valid licenses are lost or removed while an emulator is running, there is a grace period (configured on the license; default: 2 hours). The grace period is the time period during which the emulator continues to run after its license has been lost or removed. If there is no valid license after the grace period ends, the emulator will stop (this could cause data loss for a running guest system).
   3. Passphrase fields: the passphrase authenticates the license client to the the license server. It is defined when the license is created by Stromasys. Please let Stromasys know if you require a license with or without a passphrase (can be selected per product section); passphrases are supported in emulator versions 4.3.x and higher. If your license was created with a passphrase, enter the passphrase in the corresponding fields. You will find the passphrase on the license server in the output of the license_viewer program. If the license contains more than one product section, there will be a passphrase for each product section. Select the one defined for the product section the emulator instance will use.
      
      
4. Click on OK to save the configuration. It will become active at the next start of the emulator.

Configuring the License Server Details in the Configuration File

If your Charon-SSP host system allows command-line access, you can manually edit the configuration file of an emulated SPARC system. This section only describes the license server parameters. Please refer to your general Charon-SSP user's guide for a full documentation of the configuration file options.

Configuration File Location

The default location for the configuration files is in /opt/charon-agent/ssp-agent/ssp/<architecture>/<vmname>/<vmname>.cfg.

In the above path

• <architecture> stands for sun-4m, sun-4u, or sun-4v,
• <vmname> stands for the name of the emulated SPARC.

However, if the Charon-SSP system is managed without the GUI, the user can decide where to store the emulator configuration files.

Adding the License Server Details to the Configuration File

To add the license server IP address to the configuration file, perform the following steps:

1. Log in to the system as the privileged user.
2. Open the configuration file with a text editor
   (the default location is in /opt/charon-agent/ssp-agent/ssp/<emul-architecture>/<emul-sparc-name>/) where
   <emul-architecture> stands for sun-4m, sun-4u, or sun-4v.
3. Locate the [license] section (if it does not exist, add it).
4. Add the parameter
   server = <license-server-ip-address>
   to the section, where
   <license-server-ip-address> is the IP address of the license server.
5. Optionally, add the parameter
   backup_server = <backup-license-server-ip-address>
   to the section, where
   <backup-license-server-ip-address> is the IP address of the backup license server.
   The backup server provides a license limited to a certain number of runtime hours should the primary server become unavailable.
6. If defined on the license, add the license passphrase using the parameters
   server_key = <primary-license-server-passphrase>
   backup_server_key = <backup-license-server-passphrase>
   The passphrase provides an authentication of license client to license server. The correct values for <primary-license-server-passphrase> and <backup-license-server-passphrase> can be found in the license_viewer output of the license server. If there are several product sections on the same license, be careful to select the passphrase associated with the correct product section.
7. Save the configuration file
8. At the next restart of your emulator instance, the configuration becomes active.

Additional Information

Depending on your Charon-SSP product, the Charon Manager will show additional license management tools. In particular the following:

• Primary and backup license configuration under HASP in the license configuration section.
• HASP Tools in the Tools menu.

Please note: These tools are not relevant for Charon-SSP VE licenses. The same is true for the license management command-line tools hasp_srm_view and hasp_update that are installed with the Charon Agent.