Hyperactive

*Important note: we're not quite sure whether these instructions work in their current form, so please try them and report how you get on at #5893*

h1. Get Hyper Active!

In order to get the site running, you'll need to download a bunch of stuff.  First, you need to have all the right supporting software installed.  Then you need to download the Hyperactive code, configure the site to run on your machine, and run it.

The installation docs are written from the standpoint of someone running a Debian GNU/Linux based operating system (such as Debian or Ubuntu).  We'd love to have install docs for Red Hat, Mac OS X, or other system types, so if you install it on one of those OSs, please let us know or make a wiki page for it.

h2. Install the necessary packages on a Debian-based system, e.g. Debian 6:

<pre>

sudo apt-get install ruby ruby1.8 rdoc rdoc1.8 ri ri1.8  irb irb1.8 ruby1.8-dev build-essential mysql-server libmysql-ruby imagemagick libmagick9-dev libopenssl-ruby git-core ffmpeg ffmpeg2theora bittornado libxapian-ruby1.8 libxapian15 libimage-exiftool-perl jhead libmysqlclient16 libmysqlclient15-dev ghostscript flvtool2

#

# previously, the following were suggested as well: 

# libmysqlclient16 libmysqlclient15-dev  

</pre>

* 1/10/2009 - On Ubuntu 9.04 I had to replace libmagick9-dev with libmagickwand-dev

* On Ubuntu 10.04 and 10.10, replace @libmysqlclient15off@ with @libmysqlclient16@ and @libmysqlclient15-dev@ with @libmysqlclient16-dev@

h2. Build swftools

Hyperactive needs the swftools package, but that's not in the Debian repositories. But don't worry, we can make it ourselves. Start by installing the build dependencies like this

<pre>

# sudo apt-get install libgif-dev libjpeg8-dev libfreetype6-dev

</pre>

then grab the source and unpack it

<pre>

# wget http://swftools.org/swftools-0.9.1.tar.gz

# tar -xvf swftools-0.9.1.tar.gz

</pre>

if you're using a recent version of libjpeg (>6) you also need to pull in the source tarball for xpdf like this

<pre>

# cd swftools-0.9.1/lib/pdf

# wget ftp://ftp.foolabs.com/pub/xpdf/xpdf-3.02.tar.gz

</pre>

then change directory up the source tree, configure, build and install:

<pre>

#  cd ../..

# ./configure

# make

# sudo make install

</pre>

h2. Install ruby gems:

<pre>

wget http://rubyforge.org/frs/download.php/60718/rubygems-1.3.5.tgz

tar -xvzf rubygems-1.3.5.tgz

cd rubygems-1.3.5

sudo ruby setup.rb

sudo ln -s /usr/bin/gem1.8 /usr/bin/gem

cd ..

</pre>

h2. Download and install necessary rubygems

First, set up the gem sources to use. Some gems need specific versions installed, most don't.

<pre>

gem sources -a http://gems.github.com

sudo gem install rmagick -v 2.12.2

sudo gem install json -v=1.2.4

sudo gem install will_paginate -v=2.3.11

sudo gem install faker -v=0.3.1

sudo gem install rake ruby-debug daemons slave rio simple-rss mysql mongrel echoe mini_exiftool Ruby-IRC calendar_date_select subdomain-fu shoulda hpricot quietbacktrace machinist acts_as_tree acts_as_list uploadcolumn htmlentities rghost httparty ri_cal

</pre>

h2. Grab the code

<pre>

git clone git://git.escapegoat.org/hyperactive.git

</pre>

OR if you can only check out via http due to firewall restrictions:

<pre>

git clone http://git.escapegoat.org/git/hyperactive.git

</pre>

If you know that you have commit access to the code, you can get it here:

<pre>

git clone git@git.escapegoat.org:hyperactive.git

</pre>

h2. Install the torrent gem from the lib folder

<pre>

sudo gem install hyperactive/lib/transmission-0.1.gem

</pre>

h2. Development or production?

What you do next depends upon whether you are running the code for development or production purposes. 

If you just want to play with the code locally, as a development install, you can use the native web server. Follow the instructions for database migration and setup at [[DevSetUp]]. 

Alternatively, if you are planning on running hyperactive in a production environment, you will need to set it up with Apache or some other webserver; instructions are at [[SysAdminHome]].