Redmine 설치법

출처 : https://www.redmine.org/projects/redmine/wiki/RedmineInstall

문서는 redmine 3.0 ~ 4.0 버전에 관련된 문서이며, 타 버전에 대한 문서는 공식 웹사이트를 참조하세요

시스템 요구사항

OS

 Ruby를 사용할 수 있는 Unix, Linux, macOs, MacOs Server, Windows 에 설치 가능

Ruby Iterpreter

 Ruby, rails  설치 방법 참조

 Redmine 버전에 따른 Ruby 버전은 아래와 같다. 

Redmine version	Supported Ruby versions	Rails version used
4.0 (upcoming)	ruby 2.2 (2.2.2 and later), 2.3, 2.41, 2.5	Rails 5.2
3.4	ruby 1.9.34, 2.0.03, 2.1, 2.22, 2.3, 2.41	Rails 4.2
3.3	ruby 1.9.34, 2.0.03, 2.1, 2.22, 2.3	Rails 4.2

※ JRuby는 지원하지 않는다.

DataBase

MySQL 5.0 - 5.5

 - MySQL 5.6 이상, Maria DB 에서는 알려진 이슈 사항이 있다.

 - Redmine 4.0 에서는 MySQL 5.5 미만 버전은 지원하지 않는다.

PostgreSQL 8.3 이상

 - datestyle 이 ISO(기본 세팅) 이어야 함

 - 8.4.0, 8.4.1 에서 버그 있음, 8.4.2 버전에서 수정됨

 - Redmine 4.0 버전에는 9.2 미만 버전은 지원하지 않음

Microsoft SQL Server 2012 이상

SQLite 3

설치 순서

1. Redmine 설치

download 페이지에서 다운 받은 후 원하는 디렉토리에 압축을 풀어 놓는다.

2. database 생성, 세팅

설치된 DBMS에 맞게 database를 생성하고 redmine에서 사용할 계정을 생성한다.

My SQL 

CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';

My SQL (5.5.2 이하)

CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';

My SQL (5.0.2 이하)

CREATE DATABASE redmine CHARACTER SET utf8;
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'my_password';

PostgreSQL

CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

SQL Server

USE [master]
GO

-- Very basic DB creation
CREATE DATABASE [REDMINE]
GO

-- Creation of a login with SQL Server login/password authentication and no password expiration policy
CREATE LOGIN [REDMINE] WITH PASSWORD=N'redminepassword', DEFAULT_DATABASE=[REDMINE], CHECK_EXPIRATION=OFF, CHECK_POLICY=OFF
GO

-- User creation using previously created login authentication
USE [REDMINE]
GO
CREATE USER [REDMINE] FOR LOGIN [REDMINE]
GO
-- User permissions set via roles
EXEC sp_addrolemember N'db_datareader', N'REDMINE'
GO
EXEC sp_addrolemember N'db_datawriter', N'REDMINE'
GO

3. database 연결 설정

config 디렉토리에 보면 database.yml.example 파일이 있다. database.yml.example -> database.yml 변경후에 production 값을 아래와 같이 database 에 맞게 작성한다. (위 단계에서 생성한 database명, 계정명 사용)

My SQL

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "my_password"

PostgreSQL

production:
  adapter: postgresql
  database: 
  host: 
  username: 
  password: "" 
  encoding: utf8
  schema_search_path:  (default - public)

SQL Server

production:
  adapter: sqlserver
  database: redmine
  username: redmine # should match the database user name
  password: "redminepassword" # should match the login password

4. dependencies 설치

Redmine을 실행 하기 위한 프로그램들을 설치하기 위해 bundler를 먼저 설치 한다.

gem install bundler

그런다음 아래 명령어로 설치를 시작한다.

bundle install --without development test

5. session key 생성

session cookie를 암호화 할때 사용하는 secret token 을 생성한다.

bundle exec rake generate_secret_token

6. database 스키마 생성

database 에 table을 생성하고 권한 부여를 한다.

RAILS_ENV=production bundle exec rake db:migrate

Windows 일 경우 아래 코드로 실행한다.

set RAILS_ENV=production
bundle exec rake db:migrate

7. 기본 데이터 세팅

기본 데이터를 세팅한다. 아래 명령어를 실행하면 기본 언어를 무엇으로 할지 입력을 받는다. 한국어는 "ko"를 입력하면 된다.

RAILS_ENV=production bundle exec rake redmine:load_default_data

8. 파일시스템 권한 부여

Windows의 경우 이 단계는 건너뛰어도 된다.

redmine을 실행 하기 위해서는 아래 디렉토리에 대한 쓰기 권한이 있어야 한다.

 1. files (첨부파일이 저장되는 곳)

 2. log

 3. tmp, tmp/pdf (생성되는 PDF가 저장되는 곳)

 4. public/plugin_assets (plugin 관련 파일)

9. 설치 Test

아래 명령어로 서버를 실행하여 test 해 볼 수 있다. 

bundle exec rails server webrick -e production

실행 시키고 나면 "http://localhost:3000/" 으로 접속해서 확인해 볼 수 있다.

Webrick 서버는 운영용으로는 부적합하므로 다른 서버를 사용하길 권한다.

(하지만 어차피 20인 미만 사업장 내부에서 사용할 거라서 걍 쓴다.)

10. 관리자 log in

기본 계정은 

id : admin

pw: admin

 접속해서 여러가지 설정들을 해 보자