레드마인 - CentOS 5.x + Redmine 2.x 설치

CentOS 5.x + Redmine 2.x

이슈관리를 위하여 레드마인을 설치하려고 보니 2.x 가 최신이네요

최신버전을사용하려면 상위버전의 ruby가 필요하고 또 다른것도 좀 있어야 합니다. 

설치순서는 ruby > rubygems > rails > redmine 의 순서로 설치.

1. Download ruby source

wget http://ftp.ruby-lang.org/pub/ruby/1.8/ruby-1.8.7.tar.gz

tar -zxvf ruby-1.8.7.tar.gz

2. Install dependencies

sudo yum install gcc

sudo yum install gcc-c++

sudo yum install zlib-devel

sudo yum install openssl-devel

sudo yum install readline-devel

sudo yum install sqlite3-devel

3. Build ruby from source

cd ruby-1.8.7

./configure --with-openssl-dir=/usr/lib64/openssl

make

sudo make install

4. Download rubygems source

wget http://rubyforge.org/frs/download.php/69365/rubygems-1.3.6.tgz

tar -zxvf rubygems-1.3.6.tgz

cd rubygems-1.3.6

sudo ruby setup.rb

5. Install gems

sudo gem install rake

sudo gem install rails

sudo gem install mysql2

6. Install Redmine 

아래 문서를 따라서 차근차근 진행합니다.

http://www.redmine.org/projects/redmine/wiki/RedmineInstall

트러블슈팅

1) bundle install --without development test 

>>> 오류 발생 rmagick, postgresql, sqlite 등을 사용하지 않아서 아래처럼 제거하고 설치

`bundle install --without development test rmagick`

`bundle install --without development test postgresql sqlite`

2) ruby 위치를 못찾아서 'ln -s /설치위치 /usr/bin/ruby' 로 링크해 줌

나머지는 매뉴얼대로 설치 진행.

standalon 구동방식) 서버를 재시작해도 레드마인이 구동되기 위한 Init script 적용

/etc/init.d/redmine 파일의 내용

#!/bin/bash
#
# chkconfig: - 16 84
# description: Start up Redmine
#
# processname: redmine
# config: /etc/sysconfig/redmine

# source function library
. /etc/rc.d/init.d/functions

# Get network config
. /etc/sysconfig/network

[ "${NETWORKING}" = "no" ] && exit 0

# Defaults
DAEMON_HOME=/usr/local/redmine
DAEMON_ARGS="-e production -d"

# Daemon
NAME=redmine
RUBY=$(which ruby)

APP_PIDFILE=$DAEMON_HOME/tmp/pids/server.pid
DAEMON_PIDFILE=/var/run/$NAME.pid
DAEMON_LOCKFILE=/var/lock/subsys/$NAME

start() {
    echo -n $"Starting ${NAME}: "
       
    cd $DAEMON_HOME
    #redmine 2.x 인경우
    $RUBY script/rails server webrick $DAEMON_ARGS
    #redmine 1.x 라면 아래의 구동스크립트 사용
    #$RUBY script/server webrick $DAEMON_ARGS

    sleep 2

    status -p $APP_PIDFILE &> /dev/null && echo_success || echo_failure
    RETVAL=$?

    if [ $RETVAL -eq 0 ]; then
        touch $DAEMON_LOCKFILE
        cat $APP_PIDFILE > $DAEMON_PIDFILE
    fi

    echo
}

stop() {
    echo -n $"Shutting down ${NAME}: "
   
    killproc -p $DAEMON_PIDFILE
    RETVAL=$?

    [ $RETVAL -eq 0 ] && /bin/rm -f $DAEMON_LOCKFILE $DAEMON_PIDFILE

    echo
}

case "$1" in
    start)
        start
    ;;
    stop)
        stop
    ;;
    restart)
        stop
        start
    ;;
    status)
        status -p $DAEMON_PIDFILE $NAME
    ;;

    *)
        echo "Usage: $SCRIPTNAME {start|stop|restart|status}" >&2
        exit 3
    ;;
esac

위의 redmine 파일을 /etc/init.d/ 디렉토리 안에 넣고 아래의 순서를 따른다.

chmod +x /etc/init.d/redmine
chkconfig --add redmine
chkconfig redmine on
/etc/init.d/redmine start

아파치 연동방식) 가상호스트로 구동시킬 때

passenger 설치하고 아파치 모듈설치

gem install passenger
passenger-install-apache2-module

/etc/httpd/conf.d/redmine.conf 파일추가 후 아파치 재 시작

LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-3.0.18/ext/apache2/mod_passenger.so
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-3.0.18
PassengerRuby /usr/bin/ruby

<VirtualHost *:80>
  ServerName redmine.abydos.co.kr
  # 레드마인이 설치된 디렉토리 안의 public 디렉토리를 지정

  DocumentRoot /opt/webRoot/redmine/public

  <Directory /opt/webRoot/redmine/public>

   # This relaxes Apache security settings.
   AllowOverride all
   # MultiViews must be turned off.
   Options -MultiViews
  </Directory>

   ErrorLog "|/usr/sbin/rotatelogs /etc/httpd/logs/redmine-error.%Y-%m-%d.log 86400"
   CustomLog "|/usr/sbin/rotatelogs /etc/httpd/logs/redmine-access.%Y-%m-%d.log 86400" "%h %l %u %t %D \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\""

</VirtualHost>

나눔고딕폰트로 변경)

나눔고딕으로 스타일 적용하려면

설치디렉토리안의 public/stylesheets/application.css 파일을 아래와 같이 수정

css 파일의 맨위에 아래 내용을 삽입하고

@import url('http://api.mobilis.co.kr/webfonts/css/?fontface=NanumGothicWeb');

원하는 부분에서 아래처럼 사용

font-family: 'NanumGothicWeb'

플러그인)

http://www.redmine.org/projects/redmine/wiki/Plugins

백업 및 복구, 데이터 이전)

다른 서버의 레드마인을 이전하거나, 장애에 대비하여 백업할때를 위하여 스크립트를 작성하고 cron으로 등록.

참고 : http://www.redmine.org/projects/redmine/wiki/HowTo_Migrate_Redmine_to_a_new_server_to_a_new_Redmine_version

고쳐서 사용중인 스크립트(git 대신 일자별로 백업되게 변경)

redmine_bak

crontab -l

0 2 * * * /root/redmine/redmine_bak

마이그레이션) 버전이 다른 레드마인을 업그레이드 하는 경우 아래의 과정 필수

http://www.redmine.org/projects/redmine/wiki/RedmineUpgrade

[root@localhost redmine]# rake generate_secret_token

[root@localhost redmine]# rake db:migrate RAILS_ENV=production

[root@localhost redmine]# rake redmine:plugins:migrate RAILS_ENV=production 

[root@localhost redmine]# rake tmp:cache:clear

[root@localhost redmine]# rake tmp:sessions:clear

[root@localhost redmine]# /etc/init.d/httpd restart

시작페이지를 위키로 바꾸고 싶을 경우)

설치된 디렉토리안의 app/controllers/welcome_controller.rb 파일을 수정

@news = News.latest User.current
@projects = Project.latest User.current

to

@news = News.latest User.current
@projects = Project.latest User.current 
redirect_to :controller => 'projects', :action => 'show', :id => '이동시킬프로젝트아이디/wiki'