The CHARON-SSP for GNU/Linux virtual machine software is shipped as a tar, gzip distribution package. To begin the installation you must first obtain the package archive. This can be downloaded from Stromasys or distributed by read-only media, such as a CD-ROM. If you do not have the software package, then please contact either Stromasys or your Value Added Reseller for further help.

The CHARON-SSP for GNU/Linux software comes in two separate install packages. The table below describes these:

CHARON-SSP for GNU/Linux Installation Packages

Product Name	Description	Distribution Package Name
CHARON-SSP/4M	32-bit SPARC V8 virtual machine based on the sun4m architecture.	`charon-ssp-4m-1.0.21-x86_64_rpm.tar.gz`
CHARON-SSP/4U	64-bit SPARC V9 virtual machine based on the sun4u architecture.	`charon-ssp-4u-1.0.21-x86_64_rpm.tar.gz`

To begin, unpack the distribution archive, like so (the example below shows CHARON-SSP/4M for GNU/Linux):

Unpack CHARON-SSP/4M for GNU/Linux Distribution

# cd /tmp
# tar xzvf /path/to/charon-ssp-4m-1.0.21-x86_64_rpm.tar.gz

All installation steps a required to be performed from a privileged account as denoted by the '#' prompt.

Prerequisites

Before installing the CHARON-SSP for GNU/Linux virtual machine software, it is first necessary to install the Sentinel HASP software. Without this software it will not be possible for CHARON-SSP to locate the Sentinel HASP and license the environment appropriately.

For instructions on installing the Sentinel HASP software, please see the section Installing the Sentinel HASP Software.

Installing the CHARON-SSP Software

To install the CHARON-SSP for GNU/Linux virtual machine software, execute the relevant yum command for the specific package, shown in the table below.

CHARON-SSP for GNU/Linux Installation Commands

Product Name	Installation Command
CHARON-SSP/4M	`yum localinstall charon-ssp-4m-1.0.21-x86_64.rpm`
CHARON-SSP/4U	`yum localinstall charon-ssp-4u-1.0.21-x86_64.rpm`

The following terminal output shows the installation of CHARON-SSP/4M:

CHARON-SSP/4M for GNU/Linux Install Output

Loaded plugins: fastestmirror, langpacks
Examining charon-axp-sma-2.2.14-x86_64.rpm: charon-axp-sma-2.2.14-1.x86_64
Marking charon-axp-sma-2.2.14-x86_64.rpm to be installed
Resolving Dependencies
--> Running transaction check
---> Package charon-axp-sma.x86_64 0:2.2.14-1 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

================================================================================
Package           Arch      Version     Repository                        Size
================================================================================
Installing:
charon-axp-sma  : x86_64    2.2.14-1    /charon-axp-sma-2.2.14-x86_64     14 M

Transaction Summary
================================================================================
Install  1 Package

Total size: 14 M
Installed size: 14 M
Is this ok [y/d/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Installing : charon-axp-sma-2.2.14-1.x86_64                              1/1

  Verifying : charon-axp-sma-2.2.14-1.x86_64                               1/1

Installed:
charon-axp-sma.x86_64 0:2.2.14-1

Complete!

Post-Installation Tasks

The following post installations task are not required. However, for improved usability they are recommended.

Add the CHARON-SSP for GNU/Linux Software to the Shell PATH

To add the CHARON-SSP for GNU/Linux software to a C Shell environment, add the following to the end of .login:

Add CHARON-SSP for GNU/Linux Software to C Shell .login

setenv PATH $PATH:/opt/charon-ssp/ssp-4m:/opt/charon-ssp/ssp-4u

To add the CHARON-SSP for GNU/Linux software to a Bourne Shell environment (e.g. bash or sh), add the following to the end of .profile, .bash_profile or .bashrc:

Add CHARON-SSP for GNU/Linux Software to Bourne Shell Login Profile

PATH=$PATH:/opt/charon-ssp/ssp-4m:/opt/charon-ssp/ssp-4u
export PATH

Removing the CHARON-SSP Software

To remove the CHARON-AXP/SMA for GNU/Linux software, execute the following command:

CHARON-AXP/SMA for GNU/Linux Uninstall Command

# yum remove charon-axp-sma

Executing the command above should generate output similar to the following. When asked "Is this ok?" Check the list of software to ensure it only includes the charon-axp-sma package and answer y(es) to proceed.

CHARON-AXP/SMA for GNU/Linux Uninstall Output

Loaded plugins: fastestmirror, langpacks
Resolving Dependencies
--> Running transaction check
---> Package charon-axp-sma.x86_64 0:2.2.14-1 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

================================================================================
Package                Arch           Version          Repository         Size
================================================================================
Removing:
charon-axp-sma         x86_64         2.2.14-1         installed          14 M

Transaction Summary
================================================================================
Remove  1 Package

Installed size: 14 M
Is this ok [y/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction

  Erasing    : charon-axp-sma-2.2.14-1.x86_64                               1/1
  Verifying  : charon-axp-sma-2.2.14-1.x86_64                               1/1

Removed:
  charon-axp-sma.x86_64 0:2.2.14-1

Complete!

During the uninstall process, only the CHARON-AXP/SMA for GNU/Linux software is removed. All user data, including virtual disks, configuration files and virtual tapes are left untouched. It is left to the user to archive and/or delete this files.