The CHARON-SSP Agent for GNU/Linux 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.

To begin, unpack the distribution archive, like so:

Unpack CHARON-SSP Agent Distribution

# cd /tmp
# tar xzvf /path/to/charon-agent-ssp-1.0.22-x86_64_rpm.tar.gz

Once the archive is unpacked, remain in the directory /tmp. This is where the remaining installation steps will take place.

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

Installing the CHARON-SSP Agent Software

To install the CHARON-SSP Agent for GNU/Linux software, execute the following command:

CHARON-SSP Agent for GNU/Linux Install Command

# yum localinstall charon-agent-ssp-1.0.22-x86_64.rpm

Executing this command will produce output similar to the following:

CHARON-SSP Agent for GNU/Linux Install Output

Loaded plugins: langpacks
Examining charon-agent-ssp-1.0.22-x86_64.rpm: charon-agent-ssp-1.0.22-1.x86_64
Marking charon-agent-ssp-1.0.22-x86_64.rpm to be installed
Resolving Dependencies
--> Running transaction check
---> Package charon-agent-ssp.x86_64 0:1.0.22-1 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

================================================================================
Package            Arch     Version    Repository                         Size
================================================================================
Installing:
charon-agent-ssp   x86_64   1.0.22-1   /charon-agent-ssp-1.0.22-x86_64   2.4 M

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

Total size: 2.4 M
Installed size: 2.4 M
Is this ok [y/d/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Installing : charon-agent-ssp-1.0.22-1.x86_64                             1/1

  Verifying  : charon-agent-ssp-1.0.22-1.x86_64                             1/1

Installed:
  charon-agent-ssp.x86_64 0:1.0.22-1

Complete!

Post-Installation Tasks

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

Securing the Configuration

By default the software installation directory (which also contains the configuration files) for the CHARON-SSP Agent for GNU/Linux is unsecure. To ensure that the software and, especially the configuration, is secure against accidental or intentional access or corruption, it is necessary to execute the following commands:

Commands to Secure CHARON-SSP Agent Install Tree

# chmod -R go-rwx /opt/charon-agent
# chmod -R a-x /opt/charon-agent/ssp-agent/etc

The above commands should be executed by sudo or from a privileged account.

Removing the CHARON-SSP Agent Software

To remove the CHARON-SSP Agent for GNU/Linux software, execute the following command:

CHARON-SSP Agent for GNU/Linux Uninstall Command

# yum remove charon-agent-ssp

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-agent-ssp package and answer y(es) to proceed.

CHARON-SSP Agent for GNU/Linux Uninstall Output

Loaded plugins: langpacks
Resolving Dependencies
--> Running transaction check
---> Package charon-agent-ssp.x86_64 0:1.0.22-1 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

================================================================================
Package           Arch    Version      Repository                         Size
================================================================================
Removing:
charon-agent-ssp  x86_64  1.0.22-1     @/charon-agent-ssp-1.0.22-x86_64  2.4 M

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

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

  Erasing    : charon-agent-ssp-1.0.22-1.x86_64                             1/1
  Verifying  : charon-agent-ssp-1.0.22-1.x86_64                             1/1

Removed:
  charon-agent-ssp.x86_64 0:1.0.22-1

Complete!

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

Upgrading CHARON-SSP Agent for GNU/Linux

To upgrade the CHARON-SSP Agent for GNU/Linux software, simply follow the instructions described in the section Installing the CHARON-SSP Agent Software. The terminal output below shows an upgrade from CHARON-SSP Agent for GNU/Linux v1.0.18 to v1.0.22.

Upgrading CHARON-SSP/4M for GNU/Linux

# yum localinstall charon-agent-ssp-1.0.22-x86_64.rpm
Loaded plugins: langpacks
Examining charon-agent-ssp-1.0.22-x86_64.rpm: charon-agent-ssp-1.0.22-1.x86_64
Marking charon-agent-ssp-1.0.22-x86_64.rpm as an update to charon-agent-ssp-1.0.18-1.x86_64
Resolving Dependencies
--> Running transaction check
---> Package charon-agent-ssp.x86_64 0:1.0.18-1 will be updated
---> Package charon-agent-ssp.x86_64 0:1.0.22-1 will be an update
--> Finished Dependency Resolution

Dependencies Resolved

================================================================================
Package            Arch     Version    Repository                         Size
================================================================================
Updating:
charon-agent-ssp   x86_64   1.0.22-1   /charon-agent-ssp-1.0.22-x86_64   2.4 M

Transaction Summary
================================================================================
Upgrade  1 Package

Total size: 2.4 M
Is this ok [y/d/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Updating   : charon-agent-ssp-1.0.22-1.x86_64                             1/2

  Cleanup    : charon-agent-ssp-1.0.18-1.x86_64                             2/2
  Verifying  : charon-agent-ssp-1.0.22-1.x86_64                             1/2
  Verifying  : charon-agent-ssp-1.0.18-1.x86_64                             2/2

Updated:
  charon-agent-ssp.x86_64 0:1.0.22-1

Complete!