Window에서 Redmine 설치방법

목적

 

Trello로 프로젝트를 관리했었는데 짧은 주기의 간단한 일감정도는 관리가 편해도 하위 일감이 필요하고 일정이 긴 경우에 일감을 관리하기에는 불편했었습니다.

그래서 이미 회사에서 사용한 경험이 있는 무료 프로젝트 관리 프로그램인 Redmine을 사용하기로 했습니다. Redmine은 하위 일감을 사용할 수 있고 일정 관리도 가능해서 Trello보단 더 큰 프로젝트를 관리하기 좋다고 판단했습니다.

하지만 설치하는데 몇가지 문제가 있었고 설치 하는 방법과 그에 따른 문제를 해결하는 과정을 기록하기 위해 글을 적게 되었습니다.

이미 많은 실력이 좋으신 분들이 설치 방법을 적어놓아 제가 따라하다가 놓친 부분이나 헷갈렸던 부분 위주로 내용을 정리하겠습니다.

---

환경

 

Window10, bitnami-redmine-4.1.1-1, redmine_agile-1_5_3-light, ruby2.3.0, rake 13.0.1

 

---

설치 과정

 

1. REDMINE 설치

 

https://bitnami.com/stack/redmine/installer

Install Redmine, Download Redmine

홈페이지에 들어가셔 Bitnami 설치합니다. 

 

참고 - 설치

https://luckygg.tistory.com/39

[레드마인 설치] Windows 7/10에 Redmine 3.4.5 설치하기

 

설치는 생각보다 쉬웠습니다. (주의 : 제가 설치 중 User를 제대로 설정하지 않아 비밀번호를 제대로 설정하지 못했고 이메일을 통해 비밀번호를 찾으려고했으나 Email도 제대로 설정하지 않아 비밀번호도 확인하지 못했습니다. 어떻게 비밀번호를 재설정하는 부분이 있다는데 그 부분은 제가 잘 몰라서 처음 설치는거라 재설치했습니다. 따라서 처음 설치시 User와 Email 설정을 제대로 설정해주세요.)

 

2. Plugin 설치

 

레드마인을 설치해도 몇가지 부족한 기능이 있습니다. 그중에 저는 CheckList가 없어 불편했었는데요. 그래서 CheckList 를 설치했습니다.

 

https://www.redmineup.com/

Redmine Cloud Hosting, Redmine Plugins, Services and Development

 

redmineup 홈페이지에 들어가서 무료 Agile plugin을 다운로드 받습니다.

 

참고 - Checklist plugin 설치

https://ychcom.tistory.com/entry/Redmine-Plugin-%EC%84%A4%EC%B9%98-%ED%95%98%EA%B8%B0-checklist

Redmine : Plugin 설치 하기 (checklist)

설치할때 경로가 헷갈려서 해맸습니다. 경로에 유의하셔서 설치하셔야 합니다. 

 

1. C:\Bitnami\redmine-4.1.1-1\user_redmine.bat 실행

2. CMD에 cd C:\Bitnami\redmine-4.1.1-1\apps\redmine\htdocs 이동

3. CMD에 bundle install

4. CMD에 bundle exec rake redmine:plugins NAME=redmine_checklists RAILS_ENV=production

 

3. PLUGIN 이 정상적으로 설치 되지 않았을 때 

 

3.1. 로그 확인 

redmine을 설치했는데 일감을 삭제할 경우 삭제가 안되는 현상 있었습니다. error500을 내면서 삭제가 되지 않았습니다. 그래서 로그(로그 위치 : C:\Bitnami\apps\redmine\htdoc\log\production.log)를 확인 해보니 Plugin이 정상적으로 설치 되지 않았음을 확인했습니다. 

 

ActiveRecord::StatementInvalid (Mysql2::Error: Table 'bitnami_redmine.agile_data' doesn't exist: SHOW FULL FIELDS FROM `agile_data`):

 

참고 - 로그 위치 

luckygg.tistory.com/112

[레드마인 관리] 로그 확인하는 방법

 

그래서 복구하는 방법을 확인해보니 

rake redmine:plugins:migrate RAILS_ENV=production

를 해서 복구 할 수 있다고 사실을 찾았습니다.

 

참고 - 플러그인 복구 명령어

mine-it-record.tistory.com/170

[Redmine] 레드마인 접속 에러 해결_(테이블 없음 에러 Table doesn't exist)

3.2. rake update

위의 명령어를 해서 넣었는데 RAKE 버전이 맞지 않아 Plugin이 정상적으로 설치 되지 않는 문제가 발생했습니다.

 

Gem::LoadError: You have already activated rake 12.3.3, but your Gemfile requires rake 13.0.1. Prepending `bundle exec` to your command may solve this.

 

그래서 이럴 때 맞는 버전의 rake 버전을 설치해 주었더니 정상적으로 설치되었습니다. 일감 삭제 또한 정상적으로 해결되었습니다. 

 

C:\Bitnami\redmine-4.1.1-1\user_redmine.bat 실행 후 
cd C:\Bitnami\redmine-4.1.1-1\apps\redmine\htdocs
gem install rake -v 13.0.1
rake redmine:plugins:migrate RAILS_ENV=production

참고 - rake 버전 업

stackoverflow.com/questions/23287357/rails-you-have-already-activated-rake-10-3-1-but-your-gemfile-requires-rake-10

Rails: You have already activated rake 10.3.1, but your Gemfile requires rake 10.2.2 (Gem::LoadError)

 

참고 - ruby 설치 방법

kkamagistory.tistory.com/579

Octopress 설치하기

참고 - 플러그인 삭제 설치 방법

pseg.or.kr/pseg/infoinstall/3280

소프트웨어 설치가이드 - 레드마인(Redmine) 플러그인 설치와 삭제