Redmine 설치 (Developer) 2010/07/31 18:40

과거에 Trac에 대한 설치를 포스팅했었다. 이후 Trac을 사용해본 후에 여러가지 Trac의 사용법을 작성해 보려고 했지만, 막상 Trac은 프로젝트에 적용하여 사용하는 것이 잘 되지 않았다. 프로젝트의 일정과 업무를 관리하기에는 부족한 것이 많았던 것이다.
 일정과 업무의 관리는 Trac라는 웹사이트 형태의 관리 도구가 없다고 해도 엑셀, 파워포인트 등의 일반적인 문서로도 충분한 관리가 가능하다고 생각한다. 하지만 프로젝트의 진행상 발생하게 되는 빈도 높은 프로세스의 수정과 해당문서의 수정은 프로젝트 참가 인력들에게 많은 혼란을 가져온다. 또한 인력의 관리, 업무의 진행상황, 일정의 변화 등을 문서를 작성하는 관리자만이 파악하고 있으며 보통의 프로젝트 참여 인원은 프로젝트의 진척 상황에 대한 관심초차 없는 것이 일반적이다.
 때문에 개발자는 마치 범선의 노를 젖는 노예처럼 어디에서 어디로 항해하는지도 모르고 쉼없이 노젖기만 하는 듯한 처절한 감상에 빠지기 일수라는 것이 나의 생각이다. 다양하고 가변적인 일정변화, 업무변화 등으로 인한 문서의 수정 빈도는 을 보다 쉽게 관리 및 확인 하기 위해서는 목적에 맞는 자동화 시스템이 중요한 역할을 할 것은 분명하다.

2009/12/04 - Apache + SVN + Trac (아파치 SVN Trac 연동하기)

 때문에 Trac라는 일정관리 프로그램을 사용해보았다. 엄청난 문제를 가지고 있었다.
첫번째 부족한 한글화 - 무엇인가 관리를 위한 툴을 공부해야한다는 것은 엄청난 부담감이다.

두번째 직관적이지 못한 구성 - 용어 및 관리를 위한 포인트가 현실상황가 많은 차이가 있다는 것을 알게되었다. 일상적으로 우리가 개발을 하면서 이루어지는 커뮤니케이션, 업무보고와는 많은 차이를 가지고 있기 때문에 이중작업의 늪에 빠져버리기 일수였다.

세번째 복잡한 설치 - 마치 Trac와 SVN의 연동이 필수인듯이 강요되어있다. 결론을 말하지만 연동은 중요하지 않다. 문제는 연동을 강요함으로 인하여 복잡도는 증가하고, 무엇인가 알수없는 미련을 남기게 된다.

네번째 지속적인 사용성 부제 - 프로젝트를 끝마치게 되면 자연스럽게 Trac의 사이트는 방치되는 현상이 발생한다. 작성법의 불편함은 결국 Trac의 방치로 귀결된다.


결국 좀더 편한 것이 찾을수 밖에 없으며, 이 와중에 Redmine를 웹서핑중에 알게되었다.
보통 일반적인 목소리는 쉬운 설치, 깔끔한 UI, 간단한 사용법, 여러프로젝트의 관리 등이였다.
지금은 설치를 완료하고 사용에 들어간 상태이다. 정말 설치를 Trac에 비해 쉬운편이다. 물론 Redmine 역시 버전과 여러가지 문제를 발생시키며, 약간?의 애를 먹였지만 Trac의 설치에 비하면 이건 설치도 아니다.

이제부터 Redmine을 천천히 설치해보도록 하자.




Redmine 설치

Redmine은 Ruby And Rails 기반의 프로그램이다. 때문에 Trac을 설치하기 위해서는 Python을 설치해야 하는 것과 같다.

현재 가장 최신 버전은 1.9.x버전이지만 Remine의 설치를 위해서는 1.8.6 버전 또는 1.8.7 버전을 설치해야 한다고 한다. 여러 블로그를 통해서 많은 정보를 얻을수 있었지만 모두 조각조각의 본인이 않되는 부분에 대한 설명뿐이였다.

Redmine 다운로드 :  http://www.redmine.org/wiki/redmine/Download
Redmine 설치 : http://www.redmine.org/wiki/redmine/RedmineInstall

Redmine 사이트 의 다운로드를 누르게 되면 설치 방법에 대한 설명이 상세하게 나와있다. 문제는 영어라는 점, 때문에 블로그를 찾아봤지만, 뭔가 똑뿌러지는 설명이 별로 없어서 귀찮은 몸을 이끌고 직접 이러저러한 방법으로 설치를 해보았다.

Redmine 설치에 보면

Notes:

• Ruby 1.9 is not supported yet. You have to use Ruby 1.8.x as stated above.
• RubyGems 1.3.1 or higher is required
• Rake 0.8.3 or higher is required
• Rack 1.0.1 is required. If you don't have this exact version, database migration would fail.

이런 문구가 있다. 1.9는 않된다는 것이다.
그리고 Gems는 1.3.1 이상, Rake는 0.8.3 이상, Rack는 1.0.1 이 좋다는 것이다.
이글을 읽고 있는 분도 분명 설치 사이트에 가서 몇가지 점검을 꼭 해보자. 내가 글을 쓰는 시점과 당신이 읽는 시점에는 분명한 차이가 있다. 꼭 여러가지 참고를 통하여 속썩는 일 없도록 하자.

어째든 다 집어치우고 적절한 다운로드 링크 걸어주겠다.

참고 : http://www.ruby-lang.org/ko/downloads/
윈도우 버전 : Ruby 1.8.6 안정화된 인스톨 버전

위자드형태의 인스톨 버전이기 때문에 이상의 설명이 필요없다.

설치 확인 : 명령프롬프트창(cmd)에서 ruby -v 를 입력하면 Ruby의 버전을 확인 할 수 있다.

2. Rails/Rack 설치

인스톨 버전을 설치하였다면 기본적으로 환경변수가 설정되어있다.
(인스톨 버전에 Rails와 Rack도 설치되어있지만 그냥 한번더 설치했다.)
때문에 명령프롬프트(cmd)창을 띄워 다음 명령어를 입력한다.

 - Rails 설치

gem install rails -v=2.3.5

 - Rack 설치

 gem instal rack -v=1.0.1

신나게 설치되는 것을 볼수 있다.

3. Redmine 설치

현재 Ruby 와 MySQL 의 연동을 위해서 편하게 설치할수 있는 Redmine의 버전은 0.9.x 인것 같다. 1.0.x 버전의 Redmine 를 설치했을때 MySQL 기초데이터 생성중에 Blob, Text 데이터 형에서 어쩌구저쩌구 하는 에러가 발생하는데, 찾아서 해결하는 것도 번거롭고 하여 Redmine 버전을 0.9.x로 설치 하여 해결하였다.
(해결했다기 보다는 우회하는 방법을 선택한 것이다.)

Redmine 다운로드 : http://rubyforge.org/frs/?group_id=1850
다운로드 버전 : 0.9.6 을 받자
다운로드 URL : http://rubyforge.org/frs/download.php/71532/redmine-0.9.6.zip

압축파일을 원하는 장소에 풀어놓는것으로 설치는 완료이다.

4. MySQL 설치 및 연동

MySQL 설치
MySQL의 설치는 본문에서 설명하지 않겠다.
검색을 하면 쉽게 설치가 가능하다.

MySQL 연동
Redmin에서 사용할 DB 와 USER를 생성해야 한다.

create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'my_password';
grant all privileges on redmine.* to 'redmine'@'localhost';

MySQL v5.0.2 이전의 버전에서는 다음과 같이 USER 생성이 가능하다고 한다.

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

DB 생성이 완료되면 Redmine Root 디렉토리의 config 폴더에서 database.yml.example 파일을 찾아 database.yml 로 파일 명을 변환한다.

변환한 파일을 열어서 다음과 같이 작성한다.

production:
  adapter: mysql
  database: redmine
  host: localhost
  username: redmine
  password: my_password

만약 포트를 변경하고 싶다면 다음과 같이 작성한다.

production:
  adapter: mysql
  database: redmine
  host: localhost
  port: 3307
  username: redmine
  password: my_password

정보를 수정하면 database.yml 파일을 저장한 후에 명령프롬프트창을 열어서 다음 명령어를 입력하여 mysql 연동 모듈을 설치한다.

gem install mysql

설치가 완료되면 명령프롬프트창에서 Redmine 가 설치되어있는 디렉토리로 이동한다.
그리고 다음과 같이 명령어를 입력한다.

rake generate_session_store

set RAILS_ENV=production

rake db:migrate

rake redmine:load_default_data

세번째 또는 네번째 과정에서 libmysql.dll 에서 에러가 발생한다면 다음 사이트에서 DLL을 다운받는다. : http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll

다운받은 DLL을 실행 할 수 있도록 환경변수에 등록해야 하는데, Ruby를 설치하면서 환경변수에 Ruby의 bin 디렉토리가 환경변수로 등록된것을 확인할수 있다.
결과적으로 Ruby의 Root 디렉토리에 있는 bin 디렉토리에 복사해주면 된다.

복사가 완료되면 다시 한번 위의 네가지 명령어를 실행하여 DB 기초 데이터를 생성하자.

5. Redmine 실행

DB연동까지 완료되면 다음 명령어를 실행하여 Redmine를 실행해보자.

ruby script/server webrick -e production

마치 톰켓을 Run한것 처럼 로그가 주르륵 올라가는 것이 보일것이다.
특별한 변경이 없다면 http://localhost:3000/ 를 웹사이트 주소창에 입력하여 접근이 가능하다.

최초 로그인 아이디/비밀번호는 admin/admin 이다.

6. SMTP 연동

SMTP 설정은 별도로 작성하지 않겠다.

윈도우 서버 2008 SMTP 설정 참고 : http://blog.naver.com/megapjh/40102898815

Redmine 를 사용하려고 하는 서버에 SMTP가 설정되어있을때
Redmine 의 Root 디렉토리의 config 디렉토리의 email.yml.example 파일을 열어서 다음 정보를 수정하여 email.yml 로 파일명을 변경하여 저장한다.

production:
  delivery_method: :smtp
  smtp_settings:
    address: smtp.example.net
    port: 25
    domain: example.net
    authentication: :login
    user_name: redmine@example.net
    password: redmine

development:
  delivery_method: :smtp
  smtp_settings:
    address: 127.0.0.1
    port: 25
    domain: example.net
    authentication: :login
    user_name: redmine@example.net
    password: redmine

아이디 비밀번호를 사용하지 않는 경우에는 다음과 같이 수정한다.

production:
  delivery_method: :smtp
  smtp_settings:
    address: smtp.knology.net
    port: 25
    domain: cybersprocket.com
    authentication: :none

원문 사이트 : http://www.redmine.org/wiki/redmine/EmailConfiguration
자세한 정보는 다음 사이트에서 확인 할 수 있다.

7. Apache 연동

외부에서 Redmine 를 사용 할 수 있도록 아파치 연동을 해보자.
Apache 의 설치는 본 문서에서 설명하지 않는다.
설치되어 있는 Apache의 Root 디렉토리의 conf 디렉토리의 httpd.conf 파일을 열어서 수석을 제거한다.

#Include conf/extra/httpd-vhosts.conf
#LoadModule proxy_module modules/mod_proxy.so
#LoadModule proxy_http_module modules/mod_proxy_http.so

httpd.conf에 설정되어있는 접근 경로 및 권한을 설정하여준다.

<VirtualHost *:80>
   DocumentRoot "c:\apache\htdocs"
   ServerName redmine.dev
   ErrorLog logs/error_log
   ServerSignature On
   ProxyRequests off
   <Proxy *>
           Order deny,allow
           Allow from all
   </Proxy>
   ProxyPass / http://localhost:3000/
   ProxyPassReverse / http://localhost:3000/
   ProxyPreserveHost On
</VirtualHost>

아파치를 재시작하여 접속을 하면 Redmine 접속을 확인할 수 있다.

---

참고 사이트

Redmine 사이트

설치 참고 블로그
      ^ㅂ^ :: 레드마인(Redmine) 설치기(1) : 레드마인이란?
      아이군의 블로그 :: [Redmine] 프로젝트 관리 시스템 레드마인 설치하기

다운로드
      Ruby 다운로드
      BitNami

Trackback 1 | Comment 10

• Trackback Address :: http://codepedia.tistory.com/trackback/105