Version 6 (modified by smith@…, 8 years ago) (diff)


Installing the Raptor ICA on Linux

All Raptor components are made available on linux as noarch RPMs, allowing easy installs and upgrades and dependency management. These RPMs are made available as YUM repositories via the openSUSE build service (the recommended way to install), or you can download and install the RPMs (or source RPMS) manually.

1. Installing via YUM (recommended)

The Raptor YUM repository can be found at where each supported distribution has its own directory containing a .repo file for you to use, and all appropriate RPMs.

Installing via YUM involves adding this repository to your system (see 1.1) then issuing a yum install command (see 1.2).

1.1 Adding a YUM repository

How to add a YUM repository varies from linux distribution to distribution. Generally it involves adding the repository definition file (.repo) into the YUM repository collection (often /etc/yum.repos.d).

CentOS 5 example (run as root)

# cd /etc/yum.repos.d
# curl -o raptor.repo

Once you have the .repo file installed in the correct place, you can enable and disable it by editing the file and changing the enabled property to enabled=1 (to enable) or enabled=0 (to disable). If you followed the above instructions it should be enabled by default.

1.2 Installing the Raptor ICA

Once your Raptor repository is configured in your YUM system, installing the Raptor ICA simply involves issuing the following command (as root):

# yum install raptor-ica

2. OR Installing manually

If you prefer to install the RPMs manually rather than through YUM, simple browse the Raptor repository at to find the RPM you wish to install, download it, and issue a "rpm -i $RPMNAME" command.

3. Installation Details

The RPM will install the Raptor ICA into /opt/raptor/ica and set up its SSL keystore, with the following file structure:

  • /opt
    • /opt/raptor
      • /opt/raptor/ica
        • /opt/raptor/ica/raptor-ica.jar - The main Raptor ICA classfile
        • /opt/raptor/ica/conf - Contains all configuration files for the Raptor ICA
        • /opt/raptor/lib - Contains all libraries used by the Raptor ICA
        • /opt/raptor/keys - Contains the Raptor ICA's keystore and truststore
        • /opt/raptor/logs - Contains the Raptor ICA's log files

See this wiki page for a complete listing of files along with a description of what they do.