[ Redmine ] redmine 설치 + easy gantt plugin 설치

개발 환경

OS : Ubuntu 18.04

 

Redmine 은 오픈 소스 프로젝트로 웹 기반으로 만들어진 프로젝트를 관리 툴이다.

Easy Gantt Plugin 은 https://www.easyredmine.com/ 회사에서 만든 GanttChart Plugin 으로 무료버전과 유료 버전이 있다. 해당 게시글에서는 무료버전으로 설치할 예정이다. 

 

Gantt Plugin 다운로드 - https://www.easyredmine.com/redmine-gantt-plugin (간단한 정보를 입력하면 이메일로 해당 플러그인을 다운로드 받을 수 있다.)

 

1. Redmine 설치

- 아래에서 다운로드 받을 Plugin 과 호환되는 4.x 버전으로 설치할 예정이다.

  (플러그인 설치시 버전체크를 잘해줘야 나중에 고생을 안한다...)

- 설치한 OS에 패키지 저장소를 update 해주자

apt-get update
apt-get upgrade

 

- Redmine은 mysql을 사용하므로 mysql 을 설치해주어야한다. (설치된 경우 패스)

apt-get install mysql-server

 

- 설치한 mysql 접속하여 redmine에서 사용할 DB와 유저를 생성한다.

mysql> CREATE DATABASE redmine;
mysql> GRANT ALL PRIVILEGES ON redmine_db.* TO 'redmine'@'localhost' IDENTIFIED BY 'Password';
FLUSH PRIVILEGES;

 

 

 

2. Ruby  설치

- Redmine 은 ruby를 기반으로 구동되기 때문에 ruby를 설치해주자.

- 다른 library는 뒤에 build시 필요한 library이다.

apt-get install ruby-full build-essential libssl-dev libmysqlclient-dev imagemagick libmagickwand-dev

 

3. apache 설치

- passenger 모듈은 redmine이 rails 기반이기때문에 설치해줘야한다.

 apt-get install apache2 libapache2-mod-passenger

 

4. redmine 설치 

- 현재 release 된 레드마인 4.0 버전의 최신버전을 설치하겠다.

wget https://www.redmine.org/releases/redmine-4.0.6.zip 

- 압축해제 후 opt 아래로 이동시킨다.

unzip redmine-4.0.2.zip
mv redmine-4.0.2 /opt/redmine

- 해당 폴더에 웹서버가 접근하기 위해서 권한 변경을 해준다.

chown -R www-data:www-data /opt/redmine/
chmod -R 755 /opt/redmine/

 

- 환경설정을 해주기 위해 example 파일을 복사해준다.

cd /opt/redmine/config/
cp configuration.yml.example configuration.yml
cp database.yml.example database.yml

 

- 생성한 database.yml에 DB의 정보를 입력해준다.

vim database.yml

production:
  adapter: mysql2			#사용 DB 드라이버
  database: redmine			#생성한 DB 이름
  host: localhost			#DB ip
  username: redmine			#사용자이름
  password: "Password"			#사용자 비밀번호
  encoding: utf8			#인코딩

 

- 설치한 redmine의 필요 패키지와 의존성을 주입해준다.

cd /opt/redmine/
gem update
gem install bundler 
bundle install

 

- DB 마이그레이션을 진행해준다.

RAILS_ENV=production bundle exec rake db:migrate

 

 

 

 

5. Apache 설정

 

- 해당 설정은 기존에 사용하던 웹서비스가 없고, 앞으로 레드마인만 설치할 경우를 가정하고 설정할 것이므로 참고바란다.

- 설치한 passenger module의 설정을 한다. 

vim /etc/apache2/mods-available/passenger.conf

<IfModule mod_passenger.c>
  PassengerDefaultUser www-data
  PassengerRuby /usr/bin/ruby
  PassengerRoot /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini
  PassengerDefaultRuby /usr/bin/ruby
</IfModule>

 

- Symbolic 링크를 만들어 준다.

- 폴더를 직접 설정해줘도 똑같지만 그럴 경우 권한 작업도 추가적으로 해줘야한다.

 ln -s /opt/redmine/public /var/www/html/redmine

 

- 폴더 접근 설정을 해준다.

 vim /etc/apache2/sites-available/000-default.conf

<Directory /var/www/html/redmine>
	RailsBaseURI /redmine
	PassengerResolveSymlinksInDocumentRoot on
</Directory>

 

- Apache를 재시작한다.

service apache2 restart

 

 

- http://{설치주소}/redmine 로 접근하면 Redmine 페이지가 나타난다.

- 초기 관리자 ID/비밀번호 는 admin/admin 이다.

 

 

6. plugin 설치

- 최상단의 사이트에서 받은 파일을 받으면 2가지 버전이 있는데 4.x.zip 버전을 서버에 올려준다.

 

 

- 설치 경로는 /opt/redmine/plugins이며 unzip 명령어를 통해 압축해제해주면 아래와 같이 나타난다.

 

- 웹서버에서 접근가능하도록 접근권한 설정을 한다.

chown -R www-data:www-data easy_gantt/

 

 

 

 

- Plugin을 배포해준다.

bundle install --without development test --no-deployment
bundle exec rake db:migrate RAILS_ENV=production
bundle exec rake redmine:plugins NAME=easy_gantt RAILS_ENV=production

 

- 관리 > 플러그인 메뉴를 들어간다.

- 플러그인이 설치된 것을 확인할 수 있다.

- 안보일 경우 웹서버를 다시 시작해보자.