[Redmine] Ubuntu 22.04 Redmine 5.0 install

 

글 작성 기준 레드마인 5.X relese 버전인 5.0.3로 설치를 진행하였습니다.
만약 새로 설치하시거나 업그레이드를 위한 설치 시에는 레드마인의 버전에 맞는
ruby & rails 버전을 확인하시고 설치하시길 바랍니다.
그리고 버전에 따라 플러그인도 설치 여부가 다를 수 있으니 확인해보시는게 좋습니다.

※ 참고 자료

레드마인 버전	지원되는 Ruby 버전	지원되는Rail 버전
trunk	Ruby 2.6, 2.7, 3.0, 3.1	Rails 6.1
5.0	Ruby 2.51, 2.6, 2.7, 3.0, 3.1	Rails 6.1
4.2	Ruby 2.41, 2.51, 2.6, 2.72	Rails 5.2
4.1	Ruby 2.31, 2.41, 2.51, 2.6	Rails 5.2
3.4	Ruby 1.9.31, 2.0.0, 2.1, 2.2, 2.3, 2.4	Rails 4.2

 

설치환경 & 조건

• Ubuntu 22.04 
• Apache 2.4.52
• Mysql 5.7.40
• Redmine 5.0.3
• Ruby 3.0.2
• Rails 6.1.7
• sudo 권한이 있는 계정 혹은 root 계정
• 서버 IP 혹은 해당 IP를 가리키는 도메인주소

 

#1. 종속성 설치

설치 전에 항상 진행하는 APT 저장소 업데이트

sudo apt update

apache 가 설치되어 있으시다면 apache2는 빼고 설치해주시면 됩니다.

sudo apt install apache2 ruby ruby-dev curl build-essential libapache2-mod-passenger libmysqlclient-dev imagemagick libmagickwand-dev

 

만약 DB 가 설치되어있지 않으시다면 제 블로그에 게시되어있는 글
https://code-tech.tistory.com/entry/MYSQL-Ubuntu-2204-Mysql-57-install
글 참고하시고 DB부터 설치하신 다음에 이어서 진행해주시면 됩니다!
(Redmine 공식 페이지에서는 mysql 5.6 or 5.7 버전을 추천하고 있어서 5.7 버전으로 설치하시면 좋을 것 같네요!)

 

#2. 서버 확인

서버가 정상적이지 않다면 서버부터 설치하시고 나서 진행해주시기 바랍니다.

systemctl status apach2

systemctl status mysql

 

#3. DB 구성

설치 전에 DB 먼저 구성하고 설치를 진행하도록 하겠습니다.

sudo mysql -u root -p

mysql root 계정 접속 후 해당 명령어 입력 

CREATE DATABASE redmine CHARACTER SET utf8mb4;

CREATE USER 'redmine'@'localhost' IDENTIFIED BY '비밀번호입력';

GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';

FLUSH PRIVILEGES;

이렇게 유저와 DB 생성 후 해당 명령어로 제대로 권한이 들어갔는지 확인

SHOW GRANTS FOR redmine@localhost;

이렇게 뜨면 성공! 

 

 

#4. Redmine 설치

일단 설치할 폴더를 들어가도록 합니다.

cd /opt/

wget https://www.redmine.org/releases/redmine-5.0.3.tar.gz

tar -xvzf redmine-5.0.3.tar.gz

항상 압축해제 후 압축파일까지 지워주는 센스

rm redmine-5.0.3.tar.gz

심볼릭 링크 생성 없이 그냥 폴더명을 redmine으로 바꾸셔도 됩니다.

sudo ln -s redmine-5.0.2 redmine

이제 해당 폴더로 이동합니다.

cd /opt/redmine

기본 데이터베이스 구성을 아까 새로 만들어준 Mysql 유저와 DB로 변경해주셔야 합니다.

cp config/database.yml.example config/database.yml

vi config/database.yml

## vi /opt/redmine/config/database.yml

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "비밀번호" 
  # Use "utf8" instead of "utfmb4" for MySQL prior to 5.7.7
  encoding: utf8mb4

파일을 저장하고 편집기를 종료합니다.

 

다음으로 Ruby 기본 종속성을 설치합니다.

bundle config set --local without 'development test'

bundle install

 

이후 Redmine 토큰을 생성 후 데이터베이스를 마이그레이션 합니다.

bundle exec rake generate_secret_token

RAILS_ENV=production bundle exec rake db:migrate

마지막으로 해당 명령어로 기본 값을 로드시키면 됩니다.

RAILS_ENV=production bundle exec rake redmine:load_default_data

언어 선택 창에서 en으로 설정하면 끝! 

 

#5. Apache에서 호스트 설정

이제 웹서버에서 Redmine을 호스팅만 해주면 접속 가능합니다.

저는 포트는 7201 포트로 했습니다.

sudo vi /etc/apache2/ports.conf

해당 포트 추가

## vi /etc/apache2/ports.conf

Listen 7201

레드마인 호스트 추가

sudo vi /etc/apache2/sites-available/redmine.conf

## vi /etc/apache2/sites-available/redmine.conf

<VirtualHost *:7201>

        ServerAdmin "IP or Domain"
        RailsEnv production
        DocumentRoot /opt/redmine/public


        <Directory "/opt/redmine/public">
                Allow from all
                Require all granted
        </Directory>


        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

 

아파치 서버 재시작

sudo systemctl restart apache2

 

이후  IP주소:포트 입력하면 홈페이지 접속 가능합니다!