Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Introduce workaround for Confluence PDF bullet list bug

...

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 in the cloud. 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.

...

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

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>.sh.  It also contains the Charon-SSP Agent which must be installed on the Charon host system to be managed by the Charon Manager. The archive must be unpacked on a Linux system (even if you need the kit for Microsoft Windows).

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

Names of the Charon-Manager installation packages:

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

Div
classpagebreak


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

...

The packages are included in the Charon-SSP cloud-specific image (in /charon/storage). Once a new instance has been launched, you can download the Charon-SSP Manager packages archive 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-managergui-ssp-<version>.[rpm | deb | zip]sh

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 Stromasys will provide you with a download link.
The Charon Manager packages 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>.sh
  • 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

once the agent has been installed.

Charon-Manager Installation on Linux

Prerequisites

The Charon Manager can be installed on the Charon host itself or on a remote management system. For the Charon Manager to work, the Charon Agent must have been installed on the Charon host system. The Charon Manager communicates with the Agent to configure and manage the emulator instances.

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.

...

Step                                                         Description
1

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

  1. Log in to the Linux management system as the root user (denoted by the # prompt).
  2. 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(non-typical installation):

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

    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>

    3

    Unpacking the shell archive:


    1. Run the script: # sh charon-gui-<version>.sh
    2. Read the end-user agreement and accept it.
    3. The RPM packages will be extracted in a subdirectory (charon-gui-<version>) of your current working directory
    4Installing the package:

    For supported Assuming you are in the subdirectory containing the RPM file, use the following commands for supported Linux systems with RPM package management:

    Linux 7.x:

     

                          # yum install <filename-of-package> 

    Linux 8.x and higher: # 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>

    ...

    The Charon-SSP Manager for Windows software is shipped as a zipped archive package . Copy it which is contained in the charon-gui-<version>.sh archive. After unpacking the archive on a Linux system, copy the ZIP file to your Microsoft Windows system and use the following instructions to complete the installation.

    ...