=== INSTALL UNDER CENT OS 5.2 ===

- kysy PC-supportilta miten löytyi onig- ja onig-devel paketit ja miten ne asentuivat
- kysy PC-supportilta minkä ImageMagickin ne asensi, käsin asennettu IM versotestillä ei toimi Rubyn kanssa.

== 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
- Steps marked with [*] are unknown yet if really necessary

== OS COMPONENTS ==

1.1 Add Yum Repository <<- ei tartte

wget http://dag.wieers.com/rpm/packages/rpmforge-release/rpmforge-release-0.3.6-1.el5.rf.i386.rpm
rpm -Uvh rpmforge-release-0.3.6-1.el5.rf.i386.rpm

1.2 Install Required Packages  <<- nää löytyy jyu:lta

yum -y upgrade
yum -y install git apg geoip httpd  mysql mysql-server mysql-devel sqlite sqlite-devel httpd-devel libjpeg libjpeg-devel readline-devel curl-devel pcre pcre-devel zlib zlib-devel openssl openssl-devel libyaml libyaml-devel gcc gcc-c++ autoconf automake 

1.3 Configure MySQL <<- tää puuttuu mymmeliltä: tarvitaan root-oikeudet

service mysqld start
/usr/bin/mysqladmin -u root password '[MYSQL_PASSWD]'

2.1 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.2 Prepend to /etc/ld.so.conf [*] <<- en tiiä mitä tekee, näytti versotestissä olevan tuo rivi jo valmiina

/usr/local/lib
include ld.so.conf.d/*.conf

2.3 Update changed configuration <<- tekee kait saman kuin uudestaan kirjautuminen

source /etc/profile
ldconfig

3.1 Install some components from source <<- onig löytyikin kai reposta, ruby:n käsinasentamista suositeltiin edelleen (kai se toimii ilmankin, sanoi joku maililistalla)

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 ..

wget http://rubyforge.org/frs/download.php/48623/ruby-enterprise-1.8.6-20081215.tar.gz
tar xvfz ruby-enterprise-1.8.6-20081215.tar.gz
cd ruby-enterprise-1.8.6-20081215
./installer

4.1 Set up Ruby Enterprise Edition and Passenger

ln -s /opt/ruby-enterprise-1.8.6-20081215 /opt/ruby-enterprise 
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 <<- tää löytyi findillä jostain vendor(?)-hakemistosta ja asentui hyvin

4.2 Append to /etc/httpd/conf/httpd.conf <<- tää olikin jo mymmelillä <<- meillä oltava mahdollisuus käynnistää httpd uusiksi (/etc/init.d/httpd restart)

  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
   
  <VirtualHost *:80>
    ServerName your_server.com.br
    DocumentRoot /var/www/gitorious/public
  </VirtualHost>
  
4.3 Install require Ruby Gems <<- asentuu /home/käyttäjä/.gems(?)/ <<- tänne, eli heatolsalla/gitillä jos jo on, niin muut käyttäjät joutunee asentamaan omat

gem install mime-types oniguruma textpow chronic BlueCloth ruby-yadis ruby-openid rmagick geoip ultrasphinx rspec rspec-rails RedCloth echoe daemons geoip --no-rdoc --no-ri

5.1 Download Gitorious <<- tässä aletaan siis käyttää versotestillä olevaan gitorious-repoa, näitä pitäisi pystyä olemaan monta /var/www:n jossain kansiossa ja silleen että symlinkataan toi apachen käyttämä 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  <<- pitäisi tehä

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

6.2 Create /etc/init.d/git-daemon <<- tässä käytetään juuri tuota reseptistä löytyvää git-daemonia (esim. unixsupport oli asentanut valmiiksi git-daemonin, joka nyt jää käyttämättä)

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

6.3 Set up the services <<- käynnistetään palvelut, en tiedä mihin tuo chkconfig viittaa (palveluiden pitäisi käynnistyä)

chmod 755 /etc/init.d/git-ultrasphinx
chmod 755 /etc/init.d/git-daemon
chkconfig --add git-ultrasphinx
chkconfig --add git-daemon
chkconfig git-ultrasphinx on
chkconfig git-daemon on
chkconfig sendmail on
chkconfig mysqld on
chkconfig httpd on
service sendmail start
service mysqld start

7.1 Create the 'git' user (can be another name instead of 'git') <<- tää on jo mymmelillä

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 <<- tähän mysql:n asetuksista username (=root) / password

- Probably need to chanage password to [MYSQL_PASSWD] as set up above

7.3 Edit config/gitorious.yml <<- tämäkin ihan ohjeen mukaan

  # 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 <<- ohjeen mukaan vaan

- run apg -m 64
- copy the result (big string, take off the line breaks to have just one 
  continuous line)
- 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 <<- ohjeen mukaan

cd /var/www/gitorious
rake db:create RAILS_ENV=production
rake db:migrate RAILS_ENV=production
rake ultrasphinx:bootstrap RAILS_ENV=production

7.5 Setup CronJobs <<- tässä tulee muutoksia

- 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 <<- tämän korvaa gitorious/scripts/poller, joka on daemon.
  -  sille on oltava (gem) stompserver, jota tuo poller pollaa (eli kutsuu).
  -  stompserver on konffattava broker.yml:lle että käytetään production-evnissä stomp:ia
* */1 * * * cd /var/www/gitorious && /opt/ruby-enterprise/bin/rake ultrasphinx:index RAILS_ENV=production <<- tää tais toimia näin

8.1 Append to /home/git/.bash_profile [*] <<- tää käy näin

# 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 <<- tää käy näin, pitäisi olla oikeuksia

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

exit
service httpd start
service git-daemon start

9.2 Create /etc/logrotate.d/gitorious, add this content: <<- logrotatet, en tehnyt versotestille. ei tarvita kehityskoneilla tosin.

- copy content from doc/templates/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.