레드마인(Redmine) 0.9.x 에서 2.3.0으로 업그레이드

레드마인 완전 구버전 0.9.x에서 최신 버전 2.3.x로 업그레이드

 

1. 서론

 

오랜 시간 아무생각 없이 써왔던 레드마인이 어느날 보니 2.3.0 버전까지 업그레이드 되어 있다.

이거 내부적으로 많이 바뀌었을 텐데 하는 생각에 업그레이드하기가 겁나지만 시도해 보기로 하였다.

회사에서 사용중인 레드마인이라 기존 시스템에 대한 안정성 확보 문제로 기존 버전을 백업 받고

신규 서버에 설치하여 복구 하는 방법을 택했다.

 

2. 업그레이드 과정

 

먼저 무작정 업드레이드 하는데는 한계가 있어서 구글링을 해 보니 "채윤이네 집" 내가아는 동생 블로그를 참조하여 "하인드/하인도/인도짱" 블로그에 http://www.hind.pe.kr/1183 글에 기존 1.2.x 에서 2.1.3 버전으로 업그레이드 하는 과정을 정리한 글을 참고 하기로 하였다. 더 과거 버전으로 부터 더 신규 버전으로 업그레이드 하는 것도 될 것이라는 희망을 가지고....

 

자 시작해 보자

 

1) 설치 경로 차이 설명

  버전 1.x.x 버전대와 2.x.x 버전 이후 버전의 설치 경로가 다름

  - 1.x.x : "%BITNAMI설치위치%\apps\redmine"

  - 2.x.x 이상 : "%BITNAMI설치위치%\apps\redmine\htdocs"

 

2) MySQL DB 백업

  이전 버전에서 기록된 DATA가 가장 중요 하겠지... 반드시 백업을 받도록 한다.

  아마도 설치 패키지를 이용하여 레드마인(Redmine)을 설치 하였다면 대부분 MySQL의 bitnami_redmine DB의 사용권한 정보를 알지 못할 것이기 때문에 다음 파일을 참고하여 백업할 레드마인 데이터베이스 정보를 획득한다.

 

 - 대상 파일명 : database.yml

 - 경로정보 :  "%BITNAMI설치위치%\apps\redmine\config 위치에 있는 database.yml  <-- 이것은 1.x 버전대의 경로

 - 이 파일을 열어서 다음 부분을 참고한다.

# MySQL (default setup).  Versions 4.1 and 5.0 are recommended.
#
# Get the fast C bindings:
#   gem install mysql
#   (on OS X: gem install mysql -- --include=/usr/local/lib)
# And be sure to use new-style password hashing:
#   http://dev.mysql.com/doc/refman/5.0/en/old-client.html

production:
  adapter: mysql
  database: bitnami_redmine
  host: localhost
  username: bitnami
  password: f499133d0a 
  port: 3306
  reconnect: true
 

 

- 여기 암호는 암호화 되어 저장된 것이 아니라 레드마인이 설치될 때 기본 값으로 랜덤하게 설정된 값이니 문자열 그대로가 암호이다.

 

- DB를 백업하기 위해서는 도스 명령창(Dos Command Prompt)를 열어서 다음 경로로 이동후 백업을 실행 한다.

  . 경로 : %BITNAMI설치위치%\mysql\bin

  . 백업명령 : mysqldump.exe -u bitnami -p bitnami_redmine > D:\Backup\BackupRedmine.sql

  . 기록된 정보가 많아도 TEXT Base라서 금방 백업이 완료 된다. 수M Byte 정도....

 

3) 첨부파일 백업

 - 레드마인에서 첨부한 모든 첨부파일을 백업 받는다.

 - 경로 :  %BITNAMI설치위치%\app\redmine\files

 - 해당 경로내 모든 파일을 압축 백업 한다(알아서)

 

4) 레드마인 2.3.0을 다운로드 한다

 - 설치하기 편리하게 패키징된 설치 버전을 다운로드 받는다.

  http://bitnami.com/stack/redmine

 

5) 레드마인 2.3.0을 설치 한다

 - 설치는 설치창에 따라 경로만 적당히 지정해 주고 설치하면 된다..

 

6) DB 복구

 - 신규 설치된 버전의 MySQL DB 접근 정보를 획득한다

 - "%BITNAMI설치위치%\apps\redmine\htdocs\config 위치에 있는 database.yml

 - command prompt창을 열어서 다음과 같이 신규 설치된 bitnami_redmine DB를 제거하고 동일한 빈 DB를 샐호 만든다.

CD "%BITNAMI설치위치%\mysql\bin>  경로 이동

> mysql.exe -u bitnami -p 를 이용하여 MySQL 쿼리분석기 창으로 로그인

 

다음 명령 시도

mysql> drop database bitnami_redmine;

mysql> create database bitnami_redmine;

mysql> exit;

 - 백업했던 DB를 복구 한다.

> mysql -u bitnami -p bitnami_redmine < D:\Backup\RedmineBackup.sql

 

 - 복구된 DB에 대하여 버전업된 정보를 마이그레이션 시킨다.

 - 이를 위해서는 "cd "%BITNAMI설치위치%\apps\redmine\htdocs" 경로에서 반드시 실행 시켜야 한다

 - 다른 경로에서 실행 시키면 다음과 같은 오류 메시지를 만날 수 있다.

\htdocs> rake db:migrate RAILS_ENV=production

 

\htdocs> rake redmine:plugins:migrate RAILS_ENV=production

 

 - 다른 경로에서 실행 시키면 다음과 같은 오류 메시지를 만날 수 있다.

    "rake aborted! No Rakefile found"

 

7) 첨부파일 복원

 - 백업했던 첨부파일을 "%BITNAMI설치위치%\apps\redmine\htdocs\files"경로에 복사(압축해제)  시킨다.

 

8) 실행

 - 1.x 부터는 "%BITNAMI설치위치%" 경로에 "manager-windows.exe"  관리프로그램이 있으니 이를 이용하여 서비스를 실행 시킨다.

 

9) 기도하기

 - 정상실행 되기를 기도합시다...

 

 

참고문서

1. 레드마인 업그레이드,Bitnami Redmine for Windows Upgrade - 레드마인 업그레이드,Bitnami Redmine for Windows Upgrade

2. 맨티스(Mantis)를 레드마인(Redmine)로 이전(Migration)하기 - 채윤이네집