BugTrackingSystem / Redmine 설치하기 [Windows 64bit]

---

설치하기에 앞서

---

레드마인을 사용해본 이용자들의 평을 들어보면 정말 좋은 무료 BTS임은 틀림없다. 하지만 설치하려고 하는 여러분께 드리고 싶은 말씀은 굳이 레드마인을 쓰셔야겠냐고 물어보고 싶을 정도로 설치 과정이 복잡하다. 아니 정확히 말하면 설치법은 제공되는데 설치법대로 설치해도 제대로 되지 않는 경우 무수히 많았다. 설치해야하는 프로그램은 많은데 버전별 호환성이 최악이였다. 물론 공식 사이트에서 호환되는 제품에 대해서 명시를 해주고 있긴 하지만 크게 도움은 되지 않았다. 설치하려는 윈도우가 64비트 였기 때문에 선택사항이 거의 없다고 봐도 무방했기 때문이다. 블로그에 설치방법에 대해서는 설명하겠지만 반드시 설치된다고 말씀드리기 어렵다. 이 방법은 여러번의 시도 끝에 설치한 방법이니 한번에 설치되기를 바라면서 이 글을 쓴다.

시작하기전에 저도 참조 했고 잘 엄선된 사이트들의 목록이다. 물론 둘다 100% 정확히 설치된 적은 없지만 그래도 공식적으로 설명했거나 깔끔하게 설명되어져 있는 사이트와 블로그들이니 같이 참조하시면 설치하는데 있어서 더 수월함을 느끼실 것이라 생각되어 먼저 명시해 놓았다.

참조 사이트:

http://www.redmine.or.kr/boards/3/topics/328

http://pseg.or.kr/pseg/infoinstall/2998

---

1.Ruby 설치

---

다운로드:http://rubyinstaller.org/downloads/

일단 다운로드 받자. 64비트에 설치할 것이기 때문에 최소 버전은 2.0.0-p645 (x64) 버전부터 시작된다. 2.0.0버전을 추천하는 이유는 상위버전의 호환성 문제때문에 이런저런 많은 에러들이 발생되었고, 문제가 있다고 판단되어 64비트 최소버전으로 설치하였다.

Ruby설치시 2번에 있는 환경변수를 꼭 체크해주도록하자. 3개 다 체크해도 상관없다.

설치가 완료되면 실행->cmd 명령프롬프트를 실행시킨 뒤 c:\Ruby200-x64\bin으로 이동해서 아래의 명령어를 해주도록하자.

---

2.DevKit 설치

---

아까전 Ruby를 받은 다운로드 사이트로 들어가면 아래에 Development Kit with ruby 2.0.0이 호환되는 64bit버전을 다운받자

• 다운로드 받은 DevKit폴더를 생성하고 압축을 푼 뒤 C:DevKit 으로 옮기자

• 다시 명령 프롬프트를 실행하고 C:\Devkiit으로 이동한뒤 ruby dk.rb init 을 입력한다. 그러면 다음 아래와 같이 완료되었다는 표시와 함께 config.yml 파일을 검토해야 한다고 나온다. 

• C:\devkit으로 이동하여 config.yml 파일을 Notepad나 에디터 편집기로 열어줄 수 있도록 한다. 제일 아래 부분에 다음과 같은 문장을 추가한다. 만약 추가되어 있다면 굳이 손대지 말고 다음으로 넘어가길 바란다. (컴퓨터 2대에 실험결과 생성되기도 하고 안되기도 하는 경우가 있음)

- C:/Ruby200-x64

• 다시 명령 프롬프트로 이동하여 ruby dk.rb install 을 입력한다. 아래와 같이 화면에 나오는지 확인하기 바란다.

• 다음은 환경 변수를 설정해 줘야 한다. 제어판 -> 시스템 속성-> 고급 -> 환경변수 -> PATH 편집을 누른뒤 -> C:\Devkit\Bin;을 추가해준다.

---

3.RedMine 설치

---

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

레드마인을 다운받아 설치할 차례이다. 3.0.3 64bit버전을 받아서 설치해주자 2.6.5 버전의 경우 나중에 서버의 실행 명령어가 틀리기 때문에 2.6.5 버전을 설치하고 싶을 경우 다른 블로그를 참조해주길 바란다. 여기서는 최신 버전인 3.0.3을 설치하였다.

• 이번에도 역시나 압축을 풀고 C:\Redmine-3.0.3 경로에 설치해주자.

• 먼저 GEM을 설치해야 한다. 명령프롬프트를 실행시키고 C:\Redmine-3.0.3 폴더로 이동한 뒤 아래의 명령어를 입력시키자.

• 위의 결과가 나왔다면 redmine의 경우 mysql2를 사용해야 하므로 설치해줘야 한다. gem install mysql2를 실행시켜 설치하자

• 그리고 여기까지 되었다면 옮겨야할 중요한 파일이 하나있다. MySQL을 설치한 Program Files\MySQL\MySQL Connector.C 6.1\Lib 폴더에 있는 libmysql.dll 파일을 복사하여 C:\Ruby200-x64\bin 폴더에 붙여넣어준다.

• 그 후 C:\redmine-3.0.3\config 폴더의 database.yml-sample이라는 파일을 찾아 database.yml으로 이름을 변경 시킨뒤 파일을 열어준다. Notepad++로 파일을 열어주고 production을 제외한 나머지는 모두 주석처리한다. 그리고 비밀번호 부분을 입력해준다.

adapter: mysql2  database : redmine  host : localhost  username : root  password: "" // sql설치시 입력했던 비밀번호를 넣어준다  encoding: utf8

• 자 이제 다시 명령프롬프트의 redmine 폴더로 돌아와 session을 생성해주어야 한다. 아래의 명령어를 입력하자

• rake generate_secret_token을 먼저 입력한 뒤 rake db:migrate RAILS_ENV=production을 입력해주자

• 다음으로 한글을 설정하기 위해서 rake redmine:load_default_data RAILS_ENV=production을 입력하고 아래의 언어 선택 부분이 나오면 ko를 입력해준다.

• 이제 마지막이다 서버를 가동시키자. redmine 3.0.3 버전의 경우 bundle exec rails server webrick -e production을 입력해서 서버를 실행시켜야 한다. 만약 당신이 설치한 버전이 2.6.5 버전이라면 bundle exec ruby script/rails server webrick -e production을 입력해야 실행될 것이다.

• 크롬에서 localhost:3000을 입력하면 웹 페이지에 다음과 같은 화면을 볼 수 있을 것이다. Redmine의 첫 아이디와 패스워드는 admin/admin으로 로그인이 가능하다.

회사의 윈도우 64비트 윈도우에 설치해보고 현재 블로그를 위해 집에 있는 맥북 부트캠프 윈도우 64비트에도 설치하고 실행해본 결과 아주 잘 작동된다. 이 귀찮은 과정을 거치고 완벽히 설치한 당신에게 박수를 보낸다. 버전 호환성과 에러를 해결하기 위해 본인은 하루 꼬박 걸렸음을 알아주길 바라면서.. 이상 레드마인 설치법을 마치겠다.