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

Installing the 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.

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!