Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

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, for the management of a remote Charon host, the Charon Manager is installed on a system on customer premises, and uses an encrypted connection to manage the Charon host. The Charon Manager can also be installed on the Charon host itself and 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). Please note that as of 1 January 2022 CentOS 8 is EOL. For new deployments, it is recommended to use a non-EOL alternative. For existing installations, the possible negative impacts of staying with an EOL host operating system should be carefully evaluated.
    • Rocky Linux version 8.x (64-bit) or higher
    • Ubuntu 17 or higher (64-bit)
  • Microsoft Windows: versions 7, 8, 10, and (starting with Charon-SSP 5.6.1) version 11

Restriction: the Charon-SSP Manager is not supported on Linux hosts using Wayland when they run in a VMware instance with 3D-graphics. The Manager will show erratic behavior in such cases.

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 a Charon host in the cloud if using a prepackaged marketplace image: the packages are in /charon/storage/ .

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/).
Please note: starting with SSP version 5.6.1, the RPM packages are distributed in an self-extracting archive. The archive required for the Charon-SSP Manager is charon-gui-<version>. Use the following command to unpack the RPM packages:

  • Go to the directory containing the self-extracting archive.
  • Run the script: # sh charon-gui-<version>.
  • Read the end-user agreement and accept it.
  • The RPM packages will be extracted in a subdirectory (charon-gui-<version>) of your current working directory.

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 supported systems with RPM package management:

  • 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>


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>

  • No labels


© 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.