=== INSTALL UNDER UBUNTU 8.10 ===

== TODO ==

- Gruff configuration still problematic

- Make more tests (those were done in a bare-bone VPS machine)

- Improve the service scripts

== WARNINGS ==

- Assumes running everything as ROOT, unless specified

- Some commands react like 'Wizard' screens, just follow the default choices

== OS COMPONENTS ==

1.1 Install Required Packages

apt-get update

apt-get install -y build-essential apache2 mysql-server mysql-client git git-svn apg geoip-bin libgeoip1 libgeoip-dev sqlite3 libsqlite3-dev imagemagick libpcre3 libpcre3-dev zlib1g zlib1g-dev libyaml-dev libmysqlclient15-dev apache2-dev sendmail

1.2 Install some components from source

wget http://www.geocities.jp/kosako3/oniguruma/archive/onig-5.9.1.tar.gz

tar xvfz onig-5.9.1.tar.gz 

cd onig-5.9.1

./configure && make && make install

cd ..

wget http://www.sphinxsearch.com/downloads/sphinx-0.9.8.tar.gz

tar xvfz sphinx-0.9.8.tar.gz

cd sphinx-0.9.8

./configure && make && make install

cd ..

wget ftp://ftp.imagemagick.net/pub/ImageMagick/ImageMagick-6.4.6-9.tar.gz

tar xvfz ImageMagick-6.4.6-9.tar.gz 

cd ImageMagick-6.4.6-9

./configure && make && make install

cd ..

1.2.3 Set up ActiveMQ

apt-get install uuid uuid-dev openjdk-6-jre

wget http://www.powertech.no/apache/dist/activemq/apache-activemq/5.2.0/apache-activemq-5.2.0-bin.tar.gz

tar xzvf apache-activemq-5.2.0-bin.tar.gz  -C /usr/local/

echo "export ACTIVEMQ_HOME=/usr/local/apache-activemq-5.2.0" >> /etc/activemq.conf

echo "export JAVA_HOME=/usr/" >> /etc/activemq.conf

adduser --system --no-create-home  activemq

chown -R activemq /usr/local/apache-activemq-5.2.0/data

# turn off the default multicasting activemq does, or other brokers on the

# same network will receive your queue items

vim /usr/local/apache-activemq-5.2.0/conf/activemq.xml

# edit the networkConnectors conf to something like this:

<networkConnectors>

    <!-- by default just auto discover the other brokers -->

    <!-- <networkConnector name="default-nc" uri="multicast://default"/> -->

    <!-- Example of a static configuration: -->

    <networkConnector name="localhost" uri="static://(tcp://127.0.0.1:61616)"/>

</networkConnectors>

wget http://launchpadlibrarian.net/15645459/activemq

mv activemq /etc/init.d/activemq

chmod +x /etc/init.d/activemq

2.1 Install Ruby Enterprise Edition

wget http://rubyforge.org/frs/download.php/48625/ruby-enterprise_1.8.6-20081215-i386.deb

dpkg -i ruby-enterprise_1.8.6-20081215-i386.deb

2.2 Append to /etc/profile

export PATH=/opt/ruby-enterprise/bin:$PATH

export LD_LIBRARY_PATH="/usr/local/lib"

export LDFLAGS="-L/usr/local/lib -Wl,-rpath,/usr/local/lib"

2.3 Prepend to /etc/ld.so.conf

/usr/local/lib

include ld.so.conf.d/*.conf

2.4 Update changed configuration

source /etc/profile

ldconfig

2.5 Set up Ruby Enterprise Edition and Passenger

mv /usr/bin/ruby /usr/bin/ruby.old

ln -s /opt/ruby-enterprise/bin/ruby /usr/bin/ruby

gem install passenger --no-rdoc --no-ri

passenger-install-apache2-module

3.1 Create /etc/apache2/mods-available/passenger.load with:

  LoadModule passenger_module /opt/ruby-enterprise/lib/ruby/gems/1.8/gems/passenger-2.0.6/ext/apache2/mod_passenger.so

  PassengerRoot /opt/ruby-enterprise/lib/ruby/gems/1.8/gems/passenger-2.0.6

  PassengerRuby /opt/ruby-enterprise/bin/ruby

3.2 Symlink Passenger into Apache

  ln -s /etc/apache2/mods-available/passenger.load /etc/apache2/mods-enabled/passenger.load 

3.3 Create /etc/apache2/sites-available/gitorious with:

  <VirtualHost *:80>

    ServerName your_server.com.br

    DocumentRoot /var/www/gitorious/public

  </VirtualHost>

3.4 Symlink the Site

  ln -s /etc/apache2/sites-available/gitorious /etc/apache2/sites-enabled/000-gitorious

  rm /etc/apache2/sites-enabled/000-default

4.1 Install require Ruby Gems

  gem install bundler

  cd gitorious && bundle install

5.1 Download Gitorious

cd /var/www

git clone git://gitorious.org/gitorious/mainline.git gitorious

ln -s /var/www/gitorious/script/gitorious /usr/local/bin/gitorious

rm gitorious/public/.htaccess

mkdir gitorious/log

mkdir gitorious/tmp

6.1 Create /etc/init.d/git-ultrasphinx 

- copy from doc/templates/ubuntu/git-ultrasphinx

6.2 Create /etc/init.d/git-daemon

- copy from doc/templates/ubuntu/git-daemon

6.3 Set up the services

chmod +x /etc/init.d/git-ultrasphinx

chmod +x /etc/init.d/git-daemon

update-rc.d -f git-daemon start 99 2 3 4 5 .

update-rc.d -f git-ultrasphinx start 99 2 3 4 5 .

7.1 Create the 'git' user (can be another name instead of 'git')

adduser git

chown -R git:git /var/www/gitorious

su - git            <================= ATTENTION: LOGGED AS GIT FROM NOW ON (!)

mkdir ~/.ssh

chmod 700 ~/.ssh

touch ~/.ssh/authorized_keys

cd /var/www/gitorious

cp config/database.sample.yml config/database.yml

cp config/gitorious.sample.yml config/gitorious.yml

7.2 Edit config/database.yml

- Probably need to chanage password to the one that was asked to you during

  the apt packages installation in step 1.1

7.3 Edit config/gitorious.yml

  # The session secret key (`apg -m 64` is always useful for this kinda stuff)

  cookie_secret: frie...kceft

  # The path where git repositories are stored. The actual (bare) repositories resides

  # in repository_base_path/#{project.slug}/#{repository.name}.git/:

  repository_base_path: "/home/git"

  # Stuff that's in the html <head>. custom stats javascript code etc

  extra_html_head_data:

  # System message that will appear on all pages if present

  system_message:

  # Port the ./script/gitorious script should use:

  gitorious_client_port: 80

  # Host the ./script/gitorious script should use:

  gitorious_client_host: localhost

  # Host which is serving the gitorious app, eg "gitorious.org"

  gitorious_host: servidor.local

  # User which is running git daemon

  gitorious_user: git

  # Email spam on server errors to:

  exception_notification_emails:  

  # Mangle visible e-mail addresses (spam protection)

  mangle_email_addresses: true

  # Enable or Disable Public Mode (true) or Private Mode (false)

  public_mode: false

  # Define your locale

  locale: en

7.3.1 Remarks on gitorious.yml

- run apg -m 64

- replace the result (big string, take off the line breaks to have just one 

  continuous line) with value of the the current 'cookie_secret'

- configure 'gitorious_host' to your registered domain, if you have one

- configure 'gitorious_user' if you created the 'git' user above

7.4 Final Website Setup

cd /var/www/gitorious

rake db:create RAILS_ENV=production

rake db:setup RAILS_ENV=production

rake ultrasphinx:bootstrap RAILS_ENV=production

7.5 Setup CronJobs

- type in 'crontab -e'

- it will open an editor (probably nano)

- copy and paste the following 2 lines:

*/2 * * * * /opt/ruby-enterprise/bin/ruby /var/www/gitorious/script/task_performer

* */1 * * * cd /var/www/gitorious && /opt/ruby-enterprise/bin/rake ultrasphinx:index RAILS_ENV=production

8.1 [UNKNOWN] Append to /home/git/.bash_profile

# User specific aliases and functions

export RUBY_HOME=/opt/ruby-enterprise

export GEM_HOME=$RUBY_HOME/lib/ruby/gems/1.8/gems

export PATH=$RUBY_HOME/bin:$PATH

9.1 Start Services

- if you're still as user 'git', type 'exit' to go back to Root

/etc/init.d/git-daemon start

/etc/init.d/git-ultrasphinx start

9.2 Create /etc/logrotate.d/gitorious, add this content:

- copy content from doc/templates/ubuntu/gitorious-logrotate

9.3 Set permission for /etc/logrotate.d/gitorious

chmod 644 /etc/logrotate.d/gitorious

10 DONE

Open your browser, go to your main website, it should take a minute to cold start

Phusion Passenger. Then you should already be able to start operating on the system.