Installing Razorback

There are two routes that can be taken to install razorback, the first is using the jumbo package with all the components in it, the second is to install only the packages that you want. It should be noted that you can still enable and disable components when using the jumbo package. This guide will cover using the jumbo package as the individual component packages where designed for package builders to use.

Supported Operating Systems and Platforms

Currently supported Operating Systems and Platforms

I'm currently developing for one platform

• CentOS 7.0

Previously supported Operating Systems and Platforms

• Debian 6.0
• FreeBSD 8.1
• Redhat Enterprise Linux 6.0
• Ubuntu 10.04 LTS

Future supported Operating Systems and Platforms

OS versions will be supported by razorback only as long as the OS version itself is supported by its distributor.

• Debian 7.0+
• FreeBSD 10.3+
• Redhat Enterprise Linux 6.9+
• CentOS 6.9+
• Ubuntu 14.04+*

*There are currently library support issues in compiling on Ubuntu

We support these OS's on both i386 and amd64/x86_64 hardware.

Dependencies

First you should select the components that you wish to install, at the very minimum you will need to install the API and the dispatcher, you can then chose which nuggets you wish to enable from this list. Once you have this information you should install the dependencies for the components as detailed here.

As well as the dependencies listed on the dependencies page, you will also need a MySQL server setup to put the database on.

Installation

You will need to download and extract the latest tarball from here. At the time of writing this would be 0.2.5.

Now you can build the code (to enable and disable nuggets see "./configure --help"):

cd razorback-0.2.5
./configure --prefix=/usr/local/razorback
make
make install

This will have install a full razorback install into /usr/local/razorback, at this stage we recomend isolating razorback from the normal prefix's (/usr, /usr/local) to make it easier to upgrade.

Setup the Database

The database schema is installed by the dispatcher, to setup the database you can do something along the lines of the following:

$ cd /usr/local/razorback/share/razorback
$ mysql -uroot -p
Enter password: 
mysql> create database razorback;
Query OK, 1 row affected (0.00 sec)
mysql> grant all on razorback.* to razorback@localhost identified by ‘razorback’;
Query OK, 0 rows affected (0.00 sec)
mysql> use razorback;
Database changed
mysql> \. razorback.sql
......
mysql> \. razorback-data.sql
......
mysql> \q
Bye
$

Setup ActiveMQ

Follow the installation instructions for your platform to get ActiveMQ installed and running.

For Ubuntu and Debian we like this guide: http://www.jmkg.co.uk/2010/08/31/installing-activemq-on-ubuntu/

At the very minimum you will need to enable stomp in the transporConnectors section of activemq.xml:

<transportConnector name="stomp" uri="stomp://0.0.0.0:61612?transport.closeAsync=false"/>

If you wish to use authentication or SSL you will need to configure ActiveMQ for them using the following references:

SSL: http://activemq.apache.org/how-do-i-use-ssl.html

Authentication: http://activemq.apache.org/security.html