wiki:Software/Install/AllLinux
Last modified 8 years ago Last modified on 05/31/11 16:49:48

Installing all Components together 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 http://download.opensuse.org/repositories/home:/rhyssmith:/raptor 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). Browse the repository linked to above, find your distribution, copy the link to the .repo file, and download it to the YUM repository directory.

CentOS 5 example (run as root)

# cd /etc/yum.repos.d
# curl http://download.opensuse.org/repositories/home:/rhyssmith:/raptor/CentOS_CentOS-5/home:rhyssmith:raptor.repo -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 MUA and Web

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

# yum install raptor-all

2. OR Installing manually

If you prefer to install the RPMs manually rather than through YUM, simply browse the Raptor repository at http://download.opensuse.org/repositories/home:/rhyssmith:/raptor to find the RPM you wish to install (raptor-mua and raptor-web), download them, and issue a "rpm -i $RPMNAME" command.

3. Installation Details

The RPMs will install the Raptor ICA, MUA and Web into /opt/raptor/ica, /opt/raptor/mua and /opt/raptor/web and set up their SSL keystores, 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/ica/lib/ - Contains all libraries used by the Raptor ICA
        • /opt/raptor/ica/keys/ - Contains the Raptor ICA's keystore and truststore
        • /opt/raptor/ica/logs/ - Contains the Raptor ICA's log files
      • /opt/raptor/mua
        • /opt/raptor/mua/raptor-mua.jar - The main Raptor MUA classfile
        • /opt/raptor/mua/batchimport/ - Where historical log files can be dropped (see this page)
        • /opt/raptor/mua/conf/ - Contains all configuration files for the Raptor MUA
        • /opt/raptor/mua/data/ - Contains the HSQL database, if you haven't switched to using a "real" database
        • /opt/raptor/mua/lib/ - Contains all libraries used by the Raptor MUA
        • /opt/raptor/mua/keys/ - Contains the Raptor MUA's keystore and truststore
        • /opt/raptor/mua/logs/ - Contains the Raptor MUA's log files
      • /opt/raptor/web
        • /opt/raptor/web/raptor-web.jar - The main Raptor Web classfile
        • /opt/raptor/web/conf/ - Contains all configuration files for the Raptor Web
        • /opt/raptor/web/lib/ - Contains all libraries used by the Raptor Web
        • /opt/raptor/web/keys/ - Contains the Raptor Web's keystore and truststore
        • /opt/raptor/web/logs/ - Contains the Raptor Web's log files

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