This chapter describes how to set up a basic Charon-SSP instance in Azure based on a Marketplace or VE image provided by Stromasys.

Prerequisites

General Prerequisites

To access and use Charon-SSP for Azure Marketplace, you need an Azure subscription.

Licensing

Charon-SSP requires a license to run emulated SPARC systems. There are two different cloud-specific Charon-SSP product variants with two different licensing models:

The cloud-specific Charon-SSP for Marketplace image utilizing a public, Stromsys-operated cloud-specific license server.
The Charon-SSP VE (Virtual Environment) image utilizing a customer-operated, private VE license server.

Please note:

At the time of writing only the Charon-SSP Marketplace image (#1 above) is available for the Azure cloud environment.
The user is responsible for any Solaris licensing obligations and has to provide the appropriate licenses.

Automatic Marketplace Licensing Overview

Charon-SSP for Azure Marketplace requires a license to run emulated SPARC systems. This license is created automatically upon first launch of the Charon-SSP Azure instance. Please note the following points:

The Charon-SSP Azure instance requires Internet access (via public IP address or NAT) for the license mechanism to work. If NAT is used, the gateway must be an Azure instance (the source address must be from the Azure address range). At the time of writing, the license servers that must be reachable are cloud-azure1.stromasys.com and cloud-azure2.stromasys.com on port 8080. Also a DNS service must be reachable to resolve the host names of the license servers, or corresponding entries in /etc/hosts must exist.
If you change the instance size after first launching the instance and thereby change the number of CPU cores (or if the number of CPU cores is changed by any other method), the license will be invalidated.
Some license problems (e.g., additional CPU cores needed) may require moving the emulator to a new instance. Therefore, it is strongly recommended to store all relevant emulator data on a separate disk volume that can easily be detached from the old instance and attached to a new instance.
Should access to the license be lost while the emulator is running, there is a grace period of 24 hours. If license access is not restored within this period, the emulator will stop (if a guest system is running at the time, this is the equivalent of disconnecting the power without clean shutdown, i.e., it may lead to loss of data).

Please note: You will be billed by Microsoft Azure for your use of the Charon-SSP Azure instance. Stromasys will not bill you directly.

VE Licensing Overview

Please note: currently Charon-SSP VE images are not available for the Azure cloud. This section is for information only.

Charon-SSP VE license characteristics:

Software licenses only.
Installed on Charon-SSP host or separate license server.
Require the Charon-SSP VE license server software (RPM package included in the cloud-specific Charon-SSP VE image).
Require matching Charon-SSP emulator software (preinstalled on the cloud-specific Charon-SSP VE image).

A VE license server in a supported cloud environment can be moved to a different subnet or zone in the same virtual private cloud environment. It is also possible to backup and restore (to the same instance) the license server data. However, the following actions will invalidate the license:

Changing the number of CPU cores of the license server system.
Copying the license server data to a different instance
Seriously damaging the root filesystem of the license server system
Re-installing the license server system

Basic steps to install a license after the launch of the cloud instance and before you can start an emulator instance:

If there is no VE license server running already, decide on which cloud instance it should run and install the VE License Server package included in the Charon-SSP cloud image. See Installing the VE License Server Software.
Unless you have done so before, contact your Stromasys representative to purchase an appropriate license.
Log in on your Charon-SSP VE instance.
Create a C2V file and send it to the email address Stromasys will provide to you.
Install the V2C file received from Stromasys.
Configure the emulator instance(s) to use the license server.

Please refer to the VE License Server User's Guide for more information.

Azure Instance Size Prerequisites (Hardware Prerequisites)

By selecting an instance size in Azure you select the virtual hardware that will be used for Charon-SSP Azure. Therefore, the selection of an instance size determines the hardware characteristics of the Charon-SSP virtual host hardware (e.g., how many CPU cores and how much memory your virtual Charon host system will have).

The minimum hardware requirements are described below. To learn about the default settings and how to use the Charon-SSP configuration options to determine the resource allocation, refer to the different configuration sections of the general Charon-SSP user's guide guide in particular, the CPU Configuration section.

Important general information:

To facilitate a fast transfer of emulator data from one cloud instance to another, it is strongly recommended to store all relevant emulator data on a separate disk volume that can easily be detached from the old instance and attached to a new instance.
Please make sure to dimension your instance correctly from the beginning (check the minimum requirements below). The Charon-SSP license for Charon-SSP AL is created when the instance is first launched. Changing later to another instance size/type and thereby changing the number of CPU cores will invalidate the license and thus prevent Charon instances from starting (new instance required). The license for Charon-SSP VE is created based on the fingerprint taken on the license server. If the license server is run directly on the emulator host and the emulator host later requires, for example, a change in the number of CPU cores, the license will be invalidated (new license required).

General CPU requirements: Charon-SSP requires modern x86-64 architecture processors with a recommended CPU frequency of at least 3.0GHz.

Minimum requirements for Charon-SSP:

Minimum number of host system CPU cores:
- At least one CPU core for the host operating system.
- For each emulated SPARC system:
  - One CPU core for each emulated CPU of the instance.
  - At least one additional CPU core for I/O processing (at least two, if server JIT optimization is used). See the CPU Configuration section mentioned above for default allocation and configuration options

Minimum memory requirements:
- At least 2GB of RAM for the host operating system.
- For each emulated SPARC system:
  - The configured memory of the emulated instance.
  - 2GB of RAM (6GB of RAM if server JIT is used) to allow for DIT optimization, emulator requirements, run-time buffers, SMP and graphics emulation.
If hyper-threading cannot be disabled on the Charon-SSP host, configure the hyper-threading option in the Charon-SSP Manager. See the CPU Configuration section mentioned above for additional configuration information.
One or more network interfaces, depending on customer requirements.
Charon-SSP/4U+ and Charon-SSP/4V+ must run on physical Intel hardware supporting VT-x/EPT (baremetal instances) and therefore cannot run in all cloud environments. Please check your cloud provider's documentation for the availability of such hardware. In addition, note the following points:
- The support of these product variants on AMD processors (AMD-v/NPT required) is currently experimental.
- Charon-SSP/4U+ and Charon-SSP/4V+ are only available when using the Linux kernels provided by Stromasys.
- Please contact Stromasys or your Stromasys VAR if you need this type of emulated SPARC hardware to discuss your requirements in detail.

Please note:

The sizing guidelines above—in particular regarding number of host CPU cores and host memory—show the minimum requirements.
Every use case has to be reviewed and the actual host sizing has to be adapted as necessary. For example, the number of I/O CPUs may have to be increased if the guest applications produce a high I/O load. Also take into consideration that a system with many emulated CPUs in general is also able to create a higher I/O load and thus the number of CPUs for I/O processing may have to be increased.
The CPU core allocation for emulated CPUs and CPU cores for I/O processing is determined by the configuration. See CPU Configuration in the general Charon-SSP User's Guide for more information about this and the default allocation of CPU cores for I/O processing.

Azure Login and New Instance Launch

Logging in to your Azure account

To log in perform the following steps:

Go to portal.azure.com. You will see a Microsoft Azure login screen.
Enter your login credentials.
Upon successful login, the Azure home screen will be displayed as shown in the example below:

Creating a Virtual Machine

Step 1: Click on the Virtual machines icon on the home page.

This opens the virtual machines overview list.

Step 2: Click on the Add icon in the overview list.

This opens the Basics tab of the Create a Virtual Machine window.

Step 3: Enter your data on the Basics tab. Mandatory data are, for example:

Your subscription
Existing resource group (or click on Create new)
Virtual machine name
Region for the virtual machine
Charon-SSP Azure image (click on Browse all public and private images to select the correct image)
Size of your VM (click on Change size to see a list of available sizes)
User name for the administrative user of the VM (enter sshuser)
Authentication type. Select SSH public key and paste the public key of the key-pair to use into the field provided.

Basics tab upper part sample:

Select the Charon-SSP image and the correct size of your instance (please review the sizing requirements above). Enter the other information in accordance to your environment.

Basics tab lower part sample:

Enter the user sshuser as the administrative user.
Select SSH public key authentication and paste your public key into the field provided (make sure you have access to the private key associated with this public key). To create a new key-pair, use the ssh-keygen command (sample command on Linux: ssh-keygen -m PEM -t rsa -b 4096). For more information, please refer to https://docs.microsoft.com/en-us/azure/virtual-machines/linux/mac-create-ssh-keys.
The default allowed inbound port will allow SSH connections without limiting the source IP range. Remember to adapt it to your requirements after creating the instance or in the Networking tab (advanced) during the creation of the instance.

Click on Next: Disks. This will open the Disks tab of the VM creation window.

Step 4: Define the disks for your VM.

Please note: By default, Azure VMs have one operating system disk and a temporary disk for short-term storage (mounted on /mnt/resource and not persistent). You can attach existing additional data disks, or create new disks and attach them.

Disks tab sample:

Click on Next: Networking. This will open the Networking tab of the VM creation window.

Step 5: Enter the necessary information in the Networking tab.

On this tab, you can define the network configuration of your VM:

Virtual Network (existing or new)
Subnet (default or other subnet)
Whether a public IP should be assigned or not (note that the license server must be accessed via a public IP address from the Azure range)
Basic or advanced security settings (which ports are open for access to the VM).

Networking tab sample:

Optionally, you can proceed to the Management, Advanced, and Tags tabs to configure additional details of your VM. However, for a basic test, this is not required. Click on Review + Create to proceed to the review screen.

Step 6: Check the data on the Review + Create screen and create VM.

Verify that the checks passed successfully and click on Create to create the VM.

Sample Review+Create screen:

Create will take you to the Deployment page where the current status of the deployment is displayed. Once the VM has been fully deployed, the Deployment Complete screen will be displayed.

Sample Deployment Complete screen:

Click on Go to resource to get to the details page of the newly created VM. The image below shows a sample of a detail page:

Setting up a Charon-SSP Azure Cloud Instance

Contents