2009/09/16

Redmine - Windows XP 에서 수동 설치하기

버그및 프로젝트 관리 프로그램으로 Redmine 을 선택하려고 가상PC에 설치를 해 보았다.
쉽게 설치하려면 Bitnami Redmine Stack 을 이용하면 되지만 기존 운영중인 DB나 웹서버가 있을 경우 수동으로 설치하는 것이 나을 것 같아 설치를 해 보았다.

기본적인 설치 순서는 Redmine 사이트에 있는 Install 문서를 바탕으로 진행 했다. 하지만 추가적으로 진행 해야 할 사항도 있었다.

현재 시스템은 XAMPP 1.7.2 으로 되어 있고, Ruby 1.8.6 (2007-09-24 patchlevel 111) [i386-mswin32] 버전과 Rails 2.3.4 버전이 설치 되어 있는 상태이다.
Ruby 와 Rails 설치는 2009/09/12 - [Dev Story] - XP에 Ruby on Rails 설치하기 를 참고하면 된다.

Redmine 을 수동 설치할 때는 Rails 의 버전을 고려해야 한다고 한다.  아래 테이블은 Redmine 사이트에서 발췌한 것으로 Redmine 구동에 필요한 Ruby 및 Rails 버전 테이블 이다.




















































Redmine versionSupported Ruby versionsRequired Rails version
current trunkruby 1.8.6, 1.8.7Rails 2.3.4
trunk from r2493 to r2886ruby 1.8.6, 1.8.7Rails 2.2.2
trunk before r2493ruby 1.8.6, 1.8.7Rails 2.1.2
0.8.xruby 1.8.6, 1.8.7Rails 2.1.2
0.7.xruby 1.8.6Rails 2.0.2

Rails 를 2.3.4 버전을 설치해 놓은 상태라서 현재 개발 중인 redmine 을 SVN (TortoiseSVN) 을 받았다. (r2888) (설치 경로는 C:\Dev\Rails\Redmine 으로 하였음.)

MySQL 서버 설정
먼저 데이터베이스를 준비한다. XAMPP 를 설치하면 MySQL이 설치되는데 redmine 에서 사용하기 위해서 유니코드를 지원토록 my.ini 에 아래와 같은 내용을 추가한다.
[mysqld]

default-character-set=utf8

character-set-server=utf8

collation-server=utf8_general_ci



[mysql]

default-character-set=utf8



MySQL을 재시작 한 후 mysql에 접속하여 redmine 을 위한 데이터베이스를 생성위해 아래 Query 문을 실행한다.
create database redmine character set utf8;

create user 'redmine'@'localhost' identified by 'redadmin';

grant all privileges on redmine.* to 'redmine'@'localhost';



MySQL 접속 환경 설정
Redmine 프로젝트 폴더(C:\Dev\Rails\Redmine) 안에 config 폴더의 database.yml.example 파일을 database.yml 으로 바꾸고 아래와 같은 내용으로 작성을 한다.
production:

adapter: mysql

database: redmine

host: localhost

username: redmine

password: redadmin

port: 3306

encoding: utf8



Session store secret 생성하기
secret 을 Redmine Trunk r2493 이상 설치시 필요하며 아래와 같은 명령을 수행하여 생성한다.
C:\Dev
ails
edmine>rake config/initializers/session_store.rb

(in C:/Dev/rails/redmine)



데이터베이스 생성하기
Redmine 운영시 사용될 데이터베이스로 아래 명령을 수행하여 생성한다.
C:\Dev
ails
edmine>rake db:migrate RAILS_ENV="production"


위 명령을 수행할 때 루비가 설치된 경로(C:\Dev\Ruby)에 bin 폴더 안에 libmysql.dll 이 없을 경우 아래와 같은 에러 메세지를 만나게 된다.
C:\Dev
ails
edmine>rake db:migrate RAILS_ENV="production"

(in C:/Dev/rails/redmine)

!!! The bundled mysql.rb driver has been removed from Rails 2.2. Please install

the mysql gem and try again: gem install mysql.

rake aborted!

126: 지정된 모듈을 찾을 수 없습니다. - c:/Dev/ruby/lib/ruby/gems/1.8/gems/mys

l-2.8.1-x86-mswin32/lib/1.8/mysql_api.so



(See full trace by running task with --trace)


MySQL 이 설치된 경로(C:\XAMPP\MySQL) 폴더의 bin 폴더 안에 있는 libmysql.dll 을 Ruby 의 Bin 폴더(C:\Dev\Ruby\Bin)에 복사해 준다.

그리고 아래와 같은 에러가 발생할 경우에는 Redmine 의 database.yml 파일의 설정을 확인하여야 한다.
C:\Dev
ails
edmine>rake db:migrate RAILS_ENV="production"

(in C:/Dev/rails/redmine)

rake aborted!

Access denied for user 'root'@'localhost' (using password: YES)



(See full trace by running task with --trace)


모든 설정을 확인하였는데 아래와 같은 에러가 나타날 때가 있다.
C:\Dev
ails
edmine>rake db:migrate RAILS_ENV="production" --trace

(in C:/Dev/rails/redmine)

** Invoke db:migrate (first_time)

** Invoke environment (first_time)

** Execute environment

** Execute db:migrate

rake aborted!

Mysql::Error: query: not connected: CREATE TABLE `schema_migrations` (`version`

varchar(255) NOT NULL) ENGINE=InnoDB

:

:


위 에러는 Redmine 의 설치 메뉴얼에 설명이 나와 있지 않아 구글 검색을 통해 찾았는데 libmysql.dll 버전 문제라고 한다. 최신 버전의 libmysql.dll 을 사용할 경우 발생한다고 한다. XAMPP 1.7.2 버전에는 MySQL 5.1.37 버전에 설치되어 있는데 이 버전도 문제가 되었다. 문제가 없는 libmysql.dll 파일을 다운받아 Ruby 의 bin 폴더에 복사하고 MySQL 을 재가동 시킨 후 데이터베이스 생성 명령을 수행한다.

C:\Dev
ails
edmine>rake db:migrate RAILS_ENV="production" --trace

(in C:/Dev/rails/redmine)

** Invoke db:migrate (first_time)

** Invoke environment (first_time)

** Execute environment

** Execute db:migrate

:

:

:

** Invoke db:schema:dump (first_time)

** Invoke environment

** Execute db:schema:dump


기본 설정 데이터 추기하기
이 과정은 옵션이지만 Redmine 의 설치 문서에는 강력하게 추천을 하고 있다. 아래 명령을 통해 기본 설정 데이터를 추가한다. 추가할때 언어를 물어 볼 때 ko 를 입력한다.

C:\Dev
ails
edmine>rake redmine:load_default_data RAILS_ENV="production"

(in C:/Dev/rails/redmine)



Select language: bg, bs, ca, cs, da, de, el, en, es, fi, fr, gl, he, hu, it, ja,

ko, lt, nl, no, pl, pt, pt-BR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh, zh-T

W [en] ko

====================================

Default configuration data loaded.


이것으로 Redmine 설치가 끝이 났다. 이제 테스트를 위해 Redmine 을 실행 시킨다.

C:\Dev
ails
edmine>ruby script/server webrick -e production

=> Booting WEBrick

=> Rails 2.3.4 application starting on http://0.0.0.0:3000

=> Call with -d to detach

=> Ctrl-C to shutdown server

[2009-09-16 12:46:21] INFO WEBrick 1.3.1

[2009-09-16 12:46:21] INFO ruby 1.8.6 (2007-09-24) [i386-mswin32]

[2009-09-16 12:46:21] INFO WEBrick::HTTPServer#start: pid=2756 port=3000


브라우저를 실행하고 http://localhost:3000 로 접속을 해 보면 Redmine 을 만날 수 있다.

우상단의 로그인메뉴를 통해 접속하여 관리할 수 있다.


관리자 계정 : admin


관리자 암호 : admin

이대로 사용을 해도 되지만 XAMPP 와 연동을 하여 사용하면 더 좋을 것 같다. <

Original Post : http://neodreamer-dev.tistory.com/324

No comments :

Post a Comment