Installing the Charon Manager

Owned by W.Erber
Last updated: Jan 28, 2021

Contents

Overview

The Charon-SSP Manager is the main interface for managing the emulated SPARC systems running on a Charon-SSP cloud host. Therefore, the Charon-SSP Manager must be installed on every system that will be used to manage the Charon instances running on the Charon-SSP cloud host. Configuring and managing Charon-SSP instances from the command-line is also possible, but outside the scope of this Getting Started Guide. Please refer to the general Charon-SSP User's Guide for information about using the command-line.

Typically, the Charon Manager is installed on a system on customer premises and used via an encrypted connection to manage the Charon host in the cloud, or to access a Charon host in a VMware environment. The Charon Manager can also be installed on the Charon host itself and the be accessed via X11-Forwarding across an SSH connection. The latter currently requires additional package installation (via standard or local repository) on the Charon host.

Stromasys provides Charon-SSP Manager installation packages for the following operating systems:

  • Linux distributions and versions:
    • Oracle Linux, Red Hat Enterprise Linux, and CentOS: 7.x or higher (64-bit versions only)
    • Ubuntu 17 or higher (64-bit)
  • Microsoft Windows: versions 7, 8, and 10

Installation Packages

Installation packages are available in RPM or Debian package formats for Linux and as a ZIP-file for Microsoft Windows:

  • RPM package: charon-manager-ssp-<version>.rpm
  • Ubuntu package: charon-manager-ssp-<version>.deb

  • Microsoft Windows package: charon-manager-ssp-<version>.zip

There are different ways to obtain the Charon-SSP Manager installation packages. They are briefly described below:

a) For installation on a management system on customer premises if using a prepackaged cloud marketplace image:

The packages are included in the Charon-SSP cloud-specific image. Once a new instance has been launched, you can download the Charon-SSP Manager packages from the running instance:

  • Connect to the public IP address of the instance via SFTP using the private key assigned during launch and the user charon:
    $ sftp -i <path-to-private-key> charon@<public-ip-of-cloud-instance>
  • Download the required package:
    sftp> get charon-manager-ssp-<version>.[rpm | deb | zip]

b) For installation on the Charon host in the cloud if using a prepackaged marketplace image: the packages are located in the /charon/storage/ directory.

c) For installation on a Charon host where a conventional RPM installation was performed: the packages can be downloaded from a Stromasys server. They are also included in the Charon agent RPM and available in (/opt/charon-agent/ssp-agent/bin/).



Charon-Manager Installation on Linux

Prerequisites

When the Charon Manager is installed on a Linux host with a graphical user environment, the prerequisites are often already fulfilled. However, when installing the Charon Manager on the Charon-SSP host in the cloud or on a Linux server without graphics (for example, to display it via a remote X11-connection) instead of on a local management system, additional packages may have to be installed that normally are already available in a workstation environment.

In particular, the Charon-SSP Manager requires the following packages:

  • libX11
  • xorg-x11-server-utils
  • gtk2
  • xorg-x11-xauth (only required for X11-Forwarding)

If you install the Charon Manager with the yum or dnf command, these packages (with the exception of xorg-x11-xauth) and any dependencies that these packages themselves may have, are resolved automatically if a package repository is available. The xorg-x11-xauth package must be installed separately (also with yum). 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.

Please note:

  • The exact list of additionally required packages depends on what is already installed on the server.
  • To install dependencies on Ubuntu, please refer to your Linux documentation.

Installation Steps on Linux

The following table describes the installation steps for Charon-SSP Manager:

Step                                                         Description
1

Installation on a Linux management system on customer premises (typical installation):

  • Log in to the Linux management system as the root user (denoted by the # prompt).
  • Copy the installation package to your local Linux management system (from one of the sources described above).

Installation on the Charon-SSP host system in the cloud or in a VMware environment (optional):

  • Log in and become the root user on the Charon host using the following commands:
    $ ssh -i <path-to-private-key>  sshuser@<cloud-instance-ip>
    # sudo -i
  • Please note:
    • The SSH key for logging in is not required for an on-premises installation that allows login by username/password.
    • If the Charon host was not installed using a prepackaged marketplace image, the username may be different and the installation package will have to be copied to the Charon host in a separate step.
2

Go to the directory where the package has been stored:

# cd <package-location>

3Installing the package:

For systems with RPM package management (Red Hat, CentOS, Oracle Linux):

  • Linux 7.x:  # yum install <filename-of-package> 
  • Linux 8.x:  # dnf install<filename-of-package>

(For an installation on the cloud host system, check if xorg-x11-xauth is already installed if X11-Forwarding is planned.)


For systems with Debian package management (Ubuntu):
    # dpkg -i <filename-of-package>



Example (RPM installation with yum command recursively resolving package dependencies):

# yum install charon-manager-ssp*.rpm
Loaded plugins: fastestmirror, langpacks
Examining charon-manager-ssp-4.3.5.rpm: charon-manager-ssp-4.3.5-1.x86_64
Marking charon-manager-ssp-4.3.5.rpm to be installed
Resolving Dependencies
--> Running transaction check
---> Package charon-manager-ssp.x86_64 0:4.3.5-1 will be installed

<lines removed>

Dependencies Resolved

================================================================================
 Package                 Arch   Version        Repository                Size
================================================================================
Installing:
 charon-manager-ssp      x86_64 4.3.5-1       /charon-manager-ssp-4.3.5  5.8 M
Installing for dependencies:

<lines removed>

Transaction Summary
================================================================================
Install  1 Package (+42 Dependent packages)

Total size: 14 M
Total download size: 9.5 M
Installed size: 37 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-manager-ssp.x86_64 0:4.3.5-1                                          

Dependency Installed:
  atk.x86_64 0:2.28.1-1.el7                                                     
  cairo.x86_64 0:1.15.12-4.el7                                                  
  dejavu-fonts-common.noarch 0:2.33-6.el7                                       
  dejavu-sans-fonts.noarch 0:2.33-6.el7                                         
  
<lines removed>                                                
                                                 
  xorg-x11-server-utils.x86_64 0:7.7-20.el7                                     

Complete!

Installation Steps on Microsoft Windows

The Charon-SSP Manager for Windows software is shipped as a zipped archive package. Copy it to your Microsoft Windows system and use the following instructions to complete the installation.

  1. Right-click on the zip archive charon-manager-ssp-{version}.zip and select Extract All.

  2. A window titled Extract Compressed (Zipped) Folders opens. In this window:

    1. Click on the Show extracted files when complete checkbox.

    2. Click on the Extract button.

  3. A new Windows Explorer window opens showing the extracted packages.
  4. Double-click on the setup.exe executable to begin the installation.
  5. If you are presented with an Open File - Security Warning window, click on the Run button.

  6. You should now see the Charon-SSP Manager Setup Wizard. To proceed with the installation, click on the Next button. If the Windows Installer reports that Charon-SSP Manager for Windows is already installed, you must deinstall the currently installed software before you can install a different version. Normally, several versions can coexist.

  7. To accept the default installation options, simply click on Next without modifying any options. Alternatively, the following installation options can be adjusted:

    1. Click on Browse to select an alternative installation target.

    2. Click the appropriate radio button, Everyone or Just for Me, to specify system-wide or private installation respectively (the system-wide installation will prompt for the administrator password if you are not using the administrator account).

    3. To determine the approximate disk usage after the installation, click on the Disk Cost button.

    4. Once all options have been set, click on Next.

  8. Proceed with the installation by clicking on Next.
  9. Once the installation has completed, click on Close to exit the SSP-Manager Setup Wizard.

  10. The installation process creates:

    1. A Charon Manager icon on the desktop

    2. A Charon Manager entry in the Start menu (folder Stromasys)

<Go to top>



© Stromasys, 1999-2024  - All the information is provided on the best effort basis, and might be changed anytime without notice. Information provided does not mean Stromasys commitment to any features described.