본문 바로가기
컴퓨터 활용(한글, 오피스 등)/기타

Windows Redmine 수동 구축 하기

by 3604 2025. 4. 11.
728x90

출처: https://blog.naver.com/ikariksj/140138640525

Windows Redmine 수동 구축 하기  Programming   
2011. 9. 6. 17:20


https://blog.naver.com/ikariksj/140138640525
 

대부분의 회사에서 개발 소스 관리를 위해서 버전 관리, 향상 관리 툴을 사용 하고 있는 것으로 알고 있습니다. 

 

대표적인 Tool 로 PerForce (Linux/Unix 기반 , 유료, 성능 : 매우 좋음), Clear Case (window 기반, 유료, 성능 : 매우 좋음), SVN (windsow/Linux 기반, 무료, 성능 : 좋음) , CVS 도 있지만 command 기반 이라 GUI 인터페이스가 부족하여 SVN 을 일반적으로 많이 사용 합니다.

 

PerForce, Clear Case Tool 도 성능 적으로 만 보면 매우 우수 하지만 라이센스가 워낙 비싸기 때문에.. 대부분 중소기업 에서는 무료인 SVN 을 많이 사용 합니다. 

 

프로젝트를 진행 하다보면 소스 관리 이외 프로젝트 를 효율적으로 관리 하기 위한 방법 이 많이 있습니다. 그중에서 대표적으로 사용 되는것이 Trac, Remine 이 있습니다.

 

Trac 은 NASA 에서도 프로젝트에 사용 할 정도로 널리 이용 되는 Open Source Tool 입니다.

한글화가 많이 지원 대지 않으며 자료 또한 많이 없으며 Python 기반 으로 구축 시 설치해야 하는 항목이 Redmine 보다 훨씬 많은 단점 이 있습니다. 

 

Redmine 은 Trac 단점을 커버 하여 한글화 많이 진행 되었으며 Ruby 기반 으로 개발 되어 

구축 시 쉽게 구축 할수 있는 장점 이 있습니다. 

특히 Bitnami Redmine 의 경우 원클릭 설치 되도록 All Package 로 구성이 되어 있습니다. 

(Ruby + Rails + Rcak + SVN + Apache )

 

이 문서는 Redmine 수동 설치(windows 기반) 방법 을 다루는 문서 입니다.

서론이 길어 졌는데 본격적으로 Redmine 설치 관련 설명 드립니다.

 

 

Redmine 설치 순서는 다음과 같습니다.

 - 1. Ruby (v1.8.6) 설치

 - 2. Rails (v2.3.5) / Rack (v1.0.1) 설치

 - 3. Redmine (v0.9.x) 설치

 - 4. MySQL (v5.x) 연동

 - 5. Redmine 실행

 - 6. SMTP 설정 

 - 7. Apache 연동

 

 

1. Ruby 설치

Ruby 다운로드 : http://www.ruby-lang.org/ko/downloads/

각자 사용 하는 O/S 에 맞는 버전 설치 하시면 됩니다.

 

Ruby 1.8.6 Installer 버전으로 설치 (Enable RubyGems)

 

ruby-1.8.7-p72 최신 바이너리 버전으로 확인 시 Rails / Rack 설치 시 

zlib.dll 라이브러리를 찾지 못하는 문제가 발생 합니다. 

바이너리 버전은 일부 라이브러리 버전이 누락 된 버전으로 가급적 Installer 버전으로 설치 해야 

불필요한 문제에서 벗어 날수 있습니다. 

 

 

* 주의 사항 *

Ruby 설치 전 Redmine 사이트를 하기 항목 확인 필요 합니다.

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.

Ruby 최신 버전은 1.9 이지만 Redmine 에서 1.9 버전을 지원 하지 않는다.

RubyGems 1.3.1 이상 , Rake 0.8.3 이상 1.0.1 좋음

 

 

2. Rails / Rcak 설치

 

- Rails 설치 (cmd 창에서 하기 명령어 실행)

gem install rails -v=2.3.5  

(최신 버전 gem install rails -v=2.3.11 설치 시 별다른 문제 없음)

 

- Rack 설치 (cmd 창에서 하기 명령어 실행)

gem install rack -v=1.0.1 

(최신 버전 gem install rack -v=1.1.0 설치 시 mysql 연동 db 생성 시 문제 발생 함)

 

gem cmd error 발생 할 경우 환경 변수 등록 필요 (Path "C:\Ruby\bin")

 

**

Ruby Installer 버전으로 설치 시  기본적으로 환경 변수에 등록 돼지만 수동으로 설치 

rake requires RubyCems version >= 1.3.2 error 발생 시 해결 방법

http://rubyforge.org/frs/?group_id=126 사이트 에서 update 버전 받은 후 update 수행 

$ gem install rubygems-update

$ update_rubygems

 

 

 

3. Redmine 설치

 

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

Redmine 설치 : http://www.redmine.org/wiki/redmine/RedmineInstall

 

다운로드 받은 후 압축 풀면 설치 완료 됩니다.

redmine-0.9.6 --> 정상 동작 하는 버전

redmine-1.2.1 --> 최신 버전 db 생성시 에러 발생 함

 

 

4. MySql 설치 및 연동

http://www.xgenesis.org/6091 

http://dev.mysql.com/downloads/mysql/

회원 가입 후 MySQL Community Server 5.5.15  버전 다운로드 받음

자동 설치 하면 별다른 설정 없이 사용 가능 함 (mysql 설치 시 설정한 Port 확인 해놓아야 합니다.)

 

MySql 연동

redmine 에서 사용 할 DB 와 USER 를 생성 

---------------------------------------------------------------------------------------

create database db_name character set utf8;

create user 'user_name'@'localhost' identified by 'user_pw';

grant all privileges on db_name.* to 'user_name'@'localhost';

---------------------------------------------------------------------------------------

 

DB 생성이 완료 되면 Redmine Root 디렉토리 config 폴더 에서 database.yml.example 파일을 복사 하여 database.yml 생성 한다 

 

파일 내부 설정 

---------------------------------------------------------------------------------------

production:

  adapter: mysql

  database: db_name  # mysql db 생성시 만들었던 db_name 입력 해야 됨

  host: localhost

  username: user_name  # mysql db 생성시 만들었던 user_name, user_pw 입력 해야 됨

  password: user_pw

  port: 3309 # mysql 설치 시 지정한 포트 설정 해야 됨

---------------------------------------------------------------------------------------

 

# mysql 모듈 설치 (cmd 창에서 하기 명령 실행)

gem install mysql

 

설치 됐는지 확인 방법  (cmd 창에서 하기 명령 실행)

irb

require 'mysql' 입력시 true 로 나오면 정상 설치 된것 입니다

 

mysql 모듈이 설치가 완료 되면 redmine 설치 디렉토리 에서

 

rake generate_session_store

 

set RAILS_ENV=production

 

rake db:migrate

 

rake redmine:load_default_data

 

 

5. Redmine 실행

 

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

ruby script/server webrick -e production

 

마치 톰켓을 Run한것 처럼 로그가 주르륵 올라가는 것이 보일것이다.

특별한 변경이 없다면 http://localhost:3000/ 를 웹사이트 주소창에 입력하여 접근이 가능하다.

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

 

 

6. SMTP 설정 

메일 연동을 하기 위해서는 SMTP 설치가 되어야 함

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

 

DB 생성이 완료 되면 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"

----------------------------------------------

 

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 설치 (ubuntu 기반):

http://www.swordair.com/docs/config-doc/redmine_complete_config_on_ubuntu.html

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

 

redmine 전반 적인 설치 방법 windows 기반 : 

http://codepedia.tistory.com/105

 

redmine 메일 알림 설정 : 

http://blog.naver.com/PostView.nhn?blogId=eureka6846&logNo=110077272778&redirect=Dlog&widgetTypeCall=true

 

redmine + SVN 연동 :

http://yjacket.tistory.com/25

http://blog.naver.com/PostView.nhn?blogId=skysonhj&logNo=100088833150

http://rooya-textcube.blogspot.com/2010/07/redmine-21-subversion-%EC%97%B0%EB%8F%99%ED%95%98%EA%B8%B0-svn-protocol.html

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

 

redmine + Eclipse 연동 :

http://blog.namgoos.com/93

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

 

Redmine 계정으로 Subversion 인증 연동하기 :

http://meye.pe.kr/archives/783

 

Windows 환경에서 Redmine 설치, MySQL 백업/복구, SVN 연동 : 

http://indoprince.egloos.com/2735451

 

p.s 

이미 많은 분들이 Redmine 을 사용 하고 있을텐데.. 뒷북인 감이 있지만 

사용 해보니까 정말 좋은거 같네요 사용 안해보신분들 계시면 한번 사용 해보세요 추천 해드립니다. 

SVN + Remine 는 필수 인거 같고 이후 Hudson Auto Build 까지 연결 할수 있으면 최적 일꺼 같네요

728x90