redmine 설치

소스코드 다운로드

소스코드가 위치할 디렉토리로 이동해 소스코드를 다운로드 받습니다.

apache 기본 document root 는 /var/www/html 입니다.
편의상 이 경로에서 작업해도 되지만 redmine이라는 계정을 생성해 진행하도록 하겠습니다.

$ useradd redmine
$ su - redmine
$ wget https://www.redmine.org/releases/redmine-4.0.5.tar.gz
$ tar xvzf redmine-4.0.5.tar.gz
$ mv redmine-4.0.5 redmine

데이터베이스 생성 및 user 생성

MariaDB [(none)]> CREATE DATABASE redmine CHARACTER SET utf8mb4;
Query OK, 1 row affected (0.001 sec)

MariaDB [(none)]> CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'PASSWORD';
Query OK, 0 rows affected (0.001 sec)

MariaDB [(none)]> GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
Query OK, 0 rows affected (0.001 sec)

데이터베이스 설정파일 수정

redmine 소스코드 압축 해제한 디렉토리 안에 config/database.yml 파일을 수정해준다.

$ cd /home/redmine/redmine/config
$ mv database.yml.example database.yml 
$ vi database.yml

production 부분을 위에서 생성한 데이터베이스 정보로 수정해 줍니다.

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "PASSWORD"
  encoding: utf8mb4

redmine 의존성 라이브러리 설치

$ gem install bundler # root 계정으로 실행
$ cd /home/redmine/redmine # redmine 계정으로 실행
$ bundle install --without development test

bundle install 시 발생 가능한 에러 대응

$ bundle install --without development test
... 중략 ...

We trust you have received the usual lecture from the local System
Administrator. It usually boils down to these three things:

    #1) Respect the privacy of others.
    #2) Think before you type.
    #3) With great power comes great responsibility.



Your user account isn't allowed to install to the system RubyGems.
  You can cancel this installation and run:

      bundle install --path vendor/bundle

  to install the gems into ./vendor/bundle/, or you can enter your password
  and install the bundled gems to RubyGems using sudo.

  Password: 

위 내용과 같이 패스워드를 물어보면 다음명령어로 설치해줍니다.

$ bundle install --without development test --path vendor/bundle

mysql2 관련 에러가 발생한다면 MariaDB-shared, MariaDB-devel 패키지를 설치해줍니다.

An error occurred while installing mysql2 (0.5.2), and Bundler cannot continue.
 Make sure that gem install mysql2 -v '0.5.2' --source 'https://rubygems.org/' succeeds before bundling.
$ yum install MariaDB-shared MariaDB-devel

아래와 같이 rmagick 에러 발생시 ImageMagick ImageMagick-devel 패키지를 설치 해줍니다.

An error occurred while installing rmagick (2.16.0), and Bundler cannot continue.  Make sure that gem install rmagick -v '2.16.0' --source 'https://rubygems.org/' succeeds before bundling. 
$ yum install ImageMagick ImageMagick-devel

Session Store secret 생성

$ bundle exec rake generate_secret_token

데이터베이스 스키마 생성

앞서 생성한 데이터베이스에 기본 구조를 만듭니다.

$ RAILS_ENV=production bundle exec rake db:migrate

데이터베이스 기본 데이터셋 입력

기본 설정 데이터를 데이터베이스에 입력합니다.

$ RAILS_ENV=production bundle exec rake redmine:load_default_data

Select language: ar, az, bg, bs, ca, cs, da, de, el, en, en-GB, es, es-PA, et, eu, fa, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, lv, mk, mn, nl, no, pl, pt, pt-BR, ro, ru, sk, sl, sq, sr, sr-YU, sv, th, tr, uk, vi, zh, zh-TW [en]  ko
====================================
Default configuration data loaded.

실행 후 사용할 언어를 물어보면 ko 입력 합니다.


파일시스템 퍼미션 조정

$ pwd
/home/redmine/redmine
$ mkdir -p tmp tmp/pdf public/plugin_assets
$ chown -R redmine:redmine files log tmp public/plugin_assets
$ chmod -R 755 files log tmp public/plugin_assets

테스트

WEBrick 웹서버를 구동해 redmine 이 잘 동작하는지 확인해 봅니다.

$ bundle exec rails server webrick -e production
=> Booting WEBrick
=> Rails 5.2.3 application starting in production on http://0.0.0.0:3000
=> Run `rails server -h` for more startup options
[2019-10-24 17:44:43] INFO  WEBrick 1.4.2
[2019-10-24 17:44:43] INFO  ruby 2.6.3 (2019-04-16) [x86_64-linux]
[2019-10-24 17:44:43] INFO  WEBrick::HTTPServer#start: pid=25912 port=3000

브라우져에서 http://아이피주소:3000 주소로 접속하면 다음과 같은 화면을 볼 수 있습니다.

redmine 접속 화면
기본 로그인 ID/Password는 admin / admin 입니다.

다음 글에서 apache 와 연동 부분을 다루어 보겠습니다…..


0개의 댓글

댓글 남기기

이메일은 공개되지 않습니다. 필수 입력창은 * 로 표시되어 있습니다