[레드마인 플러그인] 시놀로지 도커 레드마인(Synology Docker Redmine) DMSF 설치 및 백업 설정 방법

'레드마인(Redmine)'을 주제로 다루는 본문 글은 아래 링크를 참고하세요.

[레드마인] 레드마인 소개

[레드마인] 레드마인 소개

'레드마인 플러그인(Redmine Plugin)'을 주제로 다루는 본문 글은 아래 링크를 참고하세요.

[레드마인 플러그인] 플러그인 소개

[레드마인 플러그인] 플러그인 소개

이전에 DMSF를 다뤘던 글을 새롭게 리뉴얼했습니다. Windows 설치 방법은 이전 글을 참고하세요.

[레드마인 플러그인] Redmine DMSF

[레드마인 플러그인] Redmine DMSF

레드마인(Redmine) DMSF 플러그인

DMSF는 Document Managerment System Features의 약자로, 파일 버전 관리를 위한 플러그인입니다. 주요 특징으로는 다음과 같습니다.

• 폴더 관리
• 문서 버전 관리
• E-Main 전송
• 멀티 파일 업로드/다운로드

동일한 이름의 파일을 업로드하면, 자동으로 버전이 증가하며 어떤 내용이 수정되었는지 이력을 작성할 수 있습니다. 물론, 중간에 파일 이름이 변경됐다면 파일 이름 수정도 가능합니다. DMSF 플러그인에 대한 자세한 내용은 공식 페이지를 참고하세요.

https://github.com/danmunn/redmine_dmsf

GitHub - danmunn/redmine_dmsf: Fork of svn repository for redmine_dmsf

시놀로지 도커(Synology Docker)에서 DMSF 설치 과정

본문에서 설명하는 환경은 다음과 같습니다.

Synology DSM 6.2.4-25556 Update3
Docker 20.10.3-0054
Redmine 3.4.13-0057
DMSF 1.6.2
※ 2022년 1월 23일 기준, Synology Docker Redmine의 최신 버전은 3.4.13-0057입니다. 그리고 해당 버전에 호환되는 DMSF 플러그인의 최신 버전은 1.6.2입니다.

설치 과정은 아래 더 보기를 클릭하세요. 그리고 제일 중요한 백업을 위한 경로 변경도 참고하세요.

1. DMSF 플러그인 1.6.2 다운로드

Putty에서 시놀로지에 접속한 후 아래의 명령어를 입력하여 레드마인 bash를 실행합니다. 명령어의 'synology_redmine'은 레드마인 컨테이너의 이름입니다. 변경하지 않았다면 'synology_redmine'입니다.
(만약, 컨테이너의 이름을 모르겠다면 아래 명령어로 이름을 확인할 수 있습니다)

//컨테이너 이름 확인하기
docker ps

docker exec -i -t synology_redmine /bin/bash

그리고 plugins 경로로 이동합니다.

cd plugins

아래 명령어를 입력하여 redmine dmsf 1.6.2를 다운로드합니다.

git clone -b v1.6.2 https://github.com/danmunn/redmine_dmsf

위 과정은 아래의 화면과 같습니다.

redmine dmsf 1.6.2 다운로드하기

2. Gemfile 수정하기

바로 설치를 진행하면 Gemfile에서 버전이 맞지 않다는 에러가 발생합니다.

버전이 맞지 않다는 에러 메시지

Gemfile 수정을 위해 아래 경로로 이동합니다.

cd /home/redmine/redmine

이제 vi 편집기로 Gemfile을 수정할 겁니다. 그런데 보통 윈도우만 사용했다면 vi 편집기가 익숙하지 않으므로, 주요 단축키를 미리 설명합니다.

G(대문자) 편집기의 제일 하단으로 스크롤 및 커서 이동
i 커서 위치에 문자 입력 시작
:w 저장
:q 종료
:wq 저장하고 종료
:q! 저장하지 않고 종료

Gemfile 수정을 위해 아래 명령어를 입력합니다(vi 편집기 실행).

vi Gemfile

이제 Gemfile의 맨 아래줄 조건을 주석 처리할 겁니다. vi 편집기를 잘 사용하지 못한다면 아래의 순서대로 진행하세요.

1. 대문자 G 입력(스크롤 및 커서 맨 아래줄로 이동)
2. gem "dalli", "~> 2.7.0"의 g 부분에 커서가 깜빡이는 상태에서 i 입력
3. # 입력
4. esc 입력
5. :wq 입력

위와 같이 진행하고 다시 Gemfile을 열어보면, 아래처럼 #gem "dalli", "~> 2.7.0"로 변경되어 있습니다.

편집된 Gemfile

3. DMSF 설치하기

다시 plugins 경로로 이동합니다.

cd /home/redmine/redmine/plugins

아래 명령어를 입력하여 설치합니다.

bundle install

정상적으로 설치되면 아래와 같은 화면이 표시됩니다.

bundle install 성공 화면

아래 명령어를 입력하여 DB를 세팅합니다.

bundle exec rake redmine:plugins:migrate RAILS_ENV="production"

웹 서버의 접근 권한을 설정하기 위해 다음의 명령어를 실행합니다.

chown -R www-data:www-data redmine_dmsf

이제 패키지 센터에서 레드마인 서비스를 중지하고 다시 시작합니다.

4. DMSF 설치 확인하기

정상적으로 레드마인이 실행되고 사이트에 접속이 된다면 설치가 완료된 겁니다. 관리자 계정으로 로그인한 후 관리의 플러그인 메뉴를 클릭하면 다음과 같이 표시됩니다.

DMSF 플러그인이 정상적으로 설치된 모습

5. DMSF 저장 경로 변경하여 Hyper Backup으로 백업하기

DMSF의 기본 저장 경로는 files/dmsf입니다. 이 경로는 아래의 경로와 같습니다.

/home/redmine/redmine/files/dmsf

DMSF 파일 저장 기본 경로

이 경로의 파일은 레드마인 삭제 및 재설치 시 모두 지워지며 백업이 되지 않습니다. 반드시 백업이 되는 경로로 변경해야 합니다.

아래와 같이 '파일 저장 장소'의 경로를 변경합니다.

/home/redmine/data/files

DMSF 파일 저장 경로 변경

위 경로는 시놀로지 DSM의 File Station에서 아래와 같이 접근이 가능합니다.

File Station > docker > redmine > files > dmsf > YYYY > MM

File Station에서 DMSF 업로드된 파일 확인

즉, Hyper Backup 으로 DMSF에 업로드된 파일도 백업이 가능하다는 의미입니다. 만약, DMSF 저장 경로를 기본 경로로 사용한다면 Hyper Backup을 사용할 수 없습니다.