[레드마인 플러그인] 플러그인 설치 및 삭제 (Windows / Synology NAS)

'레드마인'을 주제로 다루는 본문 글은 아래 링크를 클릭해주세요.

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

'레드마인 플러그인'을 주제로 다루는 본문 글은 아래 링크를 클릭해주세요.

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

플러그인 설치 및 삭제 과정은 간단합니다. 어떠한 변수가 없다면 아래의 순서로 간단히 끝납니다.

(Windows, Synology NAS 두 경우 모두 동일합니다.)

① 플러그인 설치 경로에 설치할 플러그인 다운로드.

② Bitnami Redmine Stack (console) 실행.

③ 설치 명령어 실행.

④ 레드마인 서버 재시작.

하지만, 경우에 따라 위와 같이 안되는 경우가 허다하더군요... 그래서 삽질을 정말 많이했습니다ㅠ

앞으로 설명해 드릴 내용에는 Windows와 Synology NAS 두 경우 모두 작성할 건데요.

필요한 내용 참고하시면 되겠습니다.

두 플랫폼의 자세한 설치 및 삭제 명령어는 아래 내용을 확인해 주세요.

1. Plugin 경로 확인

현재 Windows에서 사용중인 레드마인의 버전은 3.4.5-0입니다. 3.4.5-0 기준으로 플러그인 설치를 위한 파일 경로는 다음과 같습니다.

아래 경로에 다운받은 플러그인 파일을 위치시킵니다. (zip 파일이 아니라 압축 해제된 폴더여야 합니다.)

D:\Bitnami\redmine-3.4.5-0\apps\redmine\htdocs\plugins

(저는 설치 경로를 'D:\Bitnami\redmine-3.4.5-0'로 지정했었습니다.)

2. Bitnami Redmine Stack 실행

다음으로, 'Windows > 시작 > Bitnami Redmine Stack > Bitnami Redmine Stack 사용'을 클릭하여 console 창을 실행합니다.

아래 명령어를 실행하여 플러그인 폴더로 이동합니다.

cd D:\Bitnami\redmine-3.4.5-0\apps\redmine\htdocs\plugins

3. 설치 명령어 입력

아래 명령어를 실행하여 플러그인을 설치합니다.

첫 번째 명령어를 먼저 실행해보고, 만약 'bundle exec 어쩌구...'라는 메시지가 표시되면서 설치가 안되면 두 번째 명령어를 실행합니다.

rake redmine:plugins:migrate RAILS_ENV=production

또는

bundle exec rake redmine:plugins:migrate RAILS_ENV=production

4. 플러그인 제거

플러그인 제거시에는 아래 명령어를 수행합니다.

rake redmine:plugins:migrate NAME=plugin_name VERSION=0 RAILS_ENV=production

또는

bundle exec rake redmine:plugins:migrate  NAME=plugin_name VERSION=0 RAILS_ENV=production

주의할 점은, 'NAME=plugin_name'에서 plugin_name에 제거할 플러그인의 이름을 정확하게 입력해야 합니다.

그리고 해당 플러그인 폴더도 제거합니다. 마지막으로 레드마인 서버를 재시작하면 깔끔하게 제거됩니다.

5. 레드마인 서버 재시작

Bitnami Redmine Stack Manager를 실행합니다.

'Manage Servers'를 클릭합니다.

Thin_redmine, Thin_redmine2 를 각각 클릭한 후 'Restart'를 수행하면 재시작 됩니다.

Synology NAS에서 플러그인을 설치하는 방법은 상당히 복잡합니다. 쉽게 설치하는 방법도 있다고는 하지만 어떻게 해야하는지 모르겠더군요;

그래서 저는 정석대로 반복해서 했습니다.. 잘 모르면 되는대로 하는거죠 ㅎㅎ

Synology NAS에서 플러그인을 설치하기 위해서는 Putty가 필요합니다. Putty를 사용하는 방법부터 설명을 시작하겠습니다.

1. Putty 설치 및 설정

먼저, 링크를 클릭하여 Putty를 다운받으세요.

설치 과정은 너무나 단순해서 'Next'버튼만 누르면 완료됩니다.

Putty를 실행합니다.

'Host Name'항목에 Synology NAS의 IP주소를 입력한 후 'Open'버튼을 클릭합니다.

정상적으로 연결이 되면 다음과 같은 화면이 표시됩니다.

Synology NAS의 관리자 계정으로 아이디 및 비밀번호를 입력합니다.

로그인이 정상적으로 완료되면 아래와 같이 표시됩니다.

그리고 root 로그인을 위해 아래 명령어를 실행한 후 비밀번호를 입력합니다.

sudo --login

2. Plugin 경로 확인

Synology NAS의 버전에 따라 Redmine Plugin 설치 방법이 달라짐을 최근에 확인했습니다.

아래에 설명된 첫 번째 방법은, DSM 6.1.2에서 확인된 것이고 두 번째 방법은 DSM 6.1.6에서 확인된 것입니다.

DSM 6.1.6에서 첫 번째 방법으로 시도해보니 plugin 파일이 복사되지 않더군요.

반대로, DSM 6.1.2에서 두 번째 방법으로 시도해봐도 plugin 파일이 복사되지 않았습니다.

즉, 버전에따라 방법이 다른 것 같은데 더이상은 모르겠군요;;

2-1. 첫 번째 방법.

Synology NAS의 Plugin 경로 확인은 정말 까다롭습니다. 먼저, 저는 레드마인을 Synology NAS의 Volume2에 설치했습니다.

아래 명령어를 실행하여 docker로 경로를 이동합니다.

cd /volume2/@docker

docker내에 있는 레드마인의 경로를 찾기 위해, 'plugins'폴더를 검색합니다.

find . -name 'plugins'

이상한 영문,숫자 조합의 경로가 많이 표시됩니다. 게다가 저는 지금 플러그인이 많이 설치되어 있다보니 검색 결과가 많네요.

여기서 '/home/redmine/redmine/plugins' 경로를 찾아야 합니다. 다행히 맨 위에 표시돼있네요.

이 주소를 복사해서 이동하겠습니다.

cd [PATH]

혹시나 경로가 틀렸을 수도 있으니 확인하는 방법도 알려드리겠습니다.

아래 명령어를 수행하여 상위 경로로 이동합니다.

cd ..

그리고 아래 명령어를 수행하여 경로에 있는 파일 목록을 표시합니다.

ls -l

파일들이 많죠? 이렇게 표시되면 해당 경로가 Synology NAS에 설치된 레드마인 경로가 맞습니다.

2-2. 두 번째 방법.

Synolgoy NAS의 File Station을 실행시키고 docker>redmine>plugins 경로를 확인합니다.

이곳에 설치할 플러그인 파일(압축 해제된 파일)을 붙여 넣습니다.

그리고 Redmine 서버를 중지, 시작시킵니다.

그런데 시작을 하게되면 다시 중지가 됩니다. (제가 확인한 플러그인 파일은 CKEditor내의 codesnippet plugin 및 DMSF plugin 두 가지 입니다.)

방금전 File Station의 docker>redmine>plugins 에 복사했던 파일을 모두 지우고, 다시 레드마인 서버를 재시작 합니다.

이번에는 서버가 재시작 되고, putty로 아래 경로에 접근 시 plugin 파일이 복사가 된 것을 확인할 수 있습니다.

(아래 경로 접근은 계속해서 3번 설명을 보시면 되겠습니다.)

3. 설치 명령어 입력

자, 그러면 다시 'plugins' 경로로 이동하겠습니다.

cd plugins

문제는 지금부터 입니다... 일반적인 플러그인들은 'plugins'폴더에 다운받아 놓고 레드마인 서버만 재시작하면 자동으로 설치가 됩니다.

하지만 CKEditor, DMSF같은 유용한 플러그인은 설치가 되지 않습니다. 'bundle install'이나 'rake redmine:plugins:migrate RAILS_ENV=production'같은 명령어를 수행해야 설치가 됩니다.

하지만, 위 화면에서는 아무리 명령어를 입력해도 실행이 되지 않습니다. 어떻게 해야 할까요?

먼저, 아래 명령어를 수행하여 docker의 레드마인 이름을 확인합니다.

docker ps

docker에 존재하는 레드마인의 이름은 'synology_redmine'입니다.

다음으로, 아래 명령어를 수행합니다.

docker exec -i -t synology_redmine /bin/bash

'synology_redmine'부분에 방금 확인한 이름을 입력하면 되겠습니다.

아래 명령어를 수행하여 'pluins'폴더로 이동합니다.

cd plugins

이 화면에서는 Windows와 같이 명령어 수행이 가능합니다.

rake redmine:plugins:migrate RAILS_ENV=production

또는

bundle exec rake redmine:plugins:migrate RAILS_ENV=production

4. 플러그인 제거

Windows와 동일하게, 아래의 명령어를 수행합니다.

rake redmine:plugins:migrate NAME=plugin_name VERSION=0 RAILS_ENV=production

또는

bundle exec rake redmine:plugins:migrate  NAME=plugin_name VERSION=0 RAILS_ENV=production

주의할 점은, 'NAME=plugin_name'에서 plugin_name에 제거할 플러그인의 이름을 정확하게 입력해야 합니다.

그리고 해당 플러그인 폴더도 제거합니다. 마지막으로 레드마인 서버를 재시작하면 깔끔하게 제거됩니다.

5. 레드마인 서버 재시작

Synology NAS에 접속한 후 '패키지 센터'에서 'Redmine'을 선택합니다.

'작업'을 클릭하여 '중지'를 클릭하고, 다시 '실행'을 클릭하면 서버가 재시작 됩니다.