The following sections cover the procedures for installing, removing and upgrading the CHARON-SSP for Linux software.

Installing CHARON-SSP Manager for Linux

The CHARON-SSP Manager for Linux software is shipped as a tar, gzip distribution package. To begin the installation, unpack the distribution archive, like so:

Unpack CHARON-SSP Distribution

# cd /tmp
# tar xzvf /path/to/charon-manager-ssp-1.0.22-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 are required to be performed from a privileged account as denoted by the '#' prompt.

To install the CHARON-SSP Manager for Linux software, execute the following command:

CHARON-SSP Manager for Linux Install Command

# yum localinstall charon-manager-ssp-1.0.22-rpm

Executing this command will produce output similar to the following:

CHARON-SSP Manager for Linux Install Output

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

Dependencies Resolved

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

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

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

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

Complete!

Post Installation Tasks

The following post installation tasks are not required. However, for greater usability they are highly recommended.

Installing the Xephyr X11 Server

To use the X11 Server from CHARON-SSP Manager (described in Accessing the Console) it is necessary to install the Xephyr X11 Server. Use the following commands to install the software:

Installing Xephyr X11 Server on RedHat Linux

# yum install xorg-x11-server-Xephyr

Create a CHARON-SSP Manager Menu Item

To create an entry in the Applications menu for the CHARON-SSP Manager follow the steps below.

Step Description

1. Using sudo or a privileged account, create the file /usr/local/share/applications/charon-ssp-manager.desktop.

2.

Add the following text to the file created in step 1 and save it.

[Desktop Entry]
Version=1.0.22
Name=CHARON-SSP Manager
Exec=/opt/charon-manager/ssp-manager/ssp-manager
Icon=/opt/charon-manager/ssp-manager/resource/charon.png
Terminal=false
Type=Application
StartupNotify=true
Categories=System;

3.

Set the file protections and ownership appropriately:

# chmod 0644 /usr/local/share/applications/charon-ssp-manager.desktop
# chown root:root /usr/local/share/applications/charon-ssp-manager.desktop

4.

Navigate to Applications/System Tools. There should be an entry, much like the following:

Removing the CHARON-SSP Manager Software

To remove the CHARON-SSP Manager for Linux software, execute the following command:

CHARON-SSP Manager for Linux Uninstall Command

# yum remove charon-manager-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-manager-ssp package and answer y(es) to proceed.

CHARON-SSP Manager for Linux Uninstall Output

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

Dependencies Resolved

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

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

Installed size: 2.5 M
Is this ok [y/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Erasing    : charon-manager-ssp-1.0.22-1.x86_64                           1/1
  Verifying  : charon-manager-ssp-1.0.22-1.x86_64                           1/1

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

Complete!

During the uninstall process, only the CHARON-SSP Manager for 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.

Post Removal Tasks

The following post removal tasks are not required. However, they are highly recommended.

Remove the CHARON-SSP Manager Menu Item

To test, and remove if present, the CHARON-SSP Manager menu item, execute the following shell script.

Removing the CHARON-SSP Manager Menu Item

# MENUITEM=/usr/local/share/applications/charon-ssp-manager.desktop
# if [ -e "$MENUITEM" ]; then rm $MENUITEM; fi

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

Upgrading CHARON-SSP Manager for Linux

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

Upgrading CHARON-SSP/4M for Linux

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

Dependencies Resolved

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

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

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

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

Complete!