| | 3 | 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. |
| | 4 | |
| | 5 | == 1. Installing via YUM (recommended) == |
| | 6 | |
| | 7 | 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. |
| | 8 | |
| | 9 | Installing via YUM involves adding this repository to your system (see 1.1) then issuing a {{{yum install}}} command (see 1.2). |
| | 10 | |
| | 11 | === 1.1 Adding a YUM repository === |
| | 12 | |
| | 13 | 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. |
| | 14 | |
| | 15 | ''CentOS 5 example (run as root)'' |
| | 16 | {{{ |
| | 17 | # cd /etc/yum.repos.d |
| | 18 | # curl http://download.opensuse.org/repositories/home:/rhyssmith:/raptor/CentOS_CentOS-5/home:rhyssmith:raptor.repo -o raptor.repo |
| | 19 | }}} |
| | 20 | |
| | 21 | 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. |
| | 22 | |
| | 23 | === 1.2 Installing the Raptor MUA and Web === |
| | 24 | |
| | 25 | 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): |
| | 26 | |
| | 27 | {{{ |
| | 28 | # yum install raptor-server |
| | 29 | }}} |
| | 30 | |
| | 31 | == 2. OR Installing manually == |
| | 32 | |
| | 33 | If you prefer to install the RPMs manually rather than through YUM, simple 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. |
| | 34 | |
| | 35 | == 3. Installation Details == |
| | 36 | |
| | 37 | The RPMs will install the Raptor MUA and Web into {{{/opt/raptor/mua}}} and {{{/opt/raptor/web}}} and set up their SSL keystores, with the following file structure: |
| | 38 | |
| | 39 | * {{{/opt}}} |
| | 40 | * {{{/opt/raptor}}} |
| | 41 | * {{{/opt/raptor/mua}}} |
| | 42 | * {{{/opt/raptor/mua/raptor-mua.jar}}} - The main Raptor MUA classfile |
| | 43 | * {{{/opt/raptor/mua/conf/}}} - Contains all configuration files for the Raptor MUA |
| | 44 | * {{{/opt/raptor/mua/lib/}}} - Contains all libraries used by the Raptor MUA |
| | 45 | * {{{/opt/raptor/mua/keys/}}} - Contains the Raptor MUA's keystore and truststore |
| | 46 | * {{{/opt/raptor/mua/logs/}}} - Contains the Raptor MUA's log files |
| | 47 | * {{{/opt/raptor/web}}} |
| | 48 | * {{{/opt/raptor/web/raptor-web.jar}}} - The main Raptor Web classfile |
| | 49 | * {{{/opt/raptor/web/conf/}}} - Contains all configuration files for the Raptor Web |
| | 50 | * {{{/opt/raptor/web/lib/}}} - Contains all libraries used by the Raptor Web |
| | 51 | * {{{/opt/raptor/web/keys/}}} - Contains the Raptor Web's keystore and truststore |
| | 52 | * {{{/opt/raptor/web/logs/}}} - Contains the Raptor Web's log files |
| | 53 | |
| | 54 | See [Software/Configuration/Files this wiki page] for a complete listing of files along with a description of what they do. |
