Install Redmine on Ubuntu-16.04

Ubuntu-16.04를 설치합니다. 먼저 공식 Ubuntu Release site에서 Download 하겠습니다.

16.04 ISO Image를 선택합니다(ubuntu-16.04.3-desktop-amd64.iso)

설치 편의를 위해 VMWare를 사용해서 VM으로 설치 하겠습니다.

(VMWare는 Trial Version으로 사용 가능합니다 - 단 30일 사용 가능합니다)

실제 Server(Bare Metal)에 설치 하는 방법은 첨부 파일을 참고 하시면 됩니다.

Ubuntu-16.04 설치.pptx

'Create a New Virtual Machine'를 선택합니다.

Typical을 선택 하시고....

위 단계에서 Download 받은 ISO Image를 선택 합니다.

'Full name' 및 'User name' 과 'Password'를 입력합니다.

저는 Full name을 제 이름이 아닌 'Virtual Machine' 이름으로 했습니다.

이 단계에서 'Virtual Machine Name'을 설정 하면 됩니다.

여분으로 가지고 있던 SSD에 만들었습니다.

'Disk Size'는 기본 20GB인데, 100GB로 수정했습니다.

관리 편의성을 위해 'single file' 선택

'Customize Hardware'를 선택하고

Memory 8192MB(8GB, 제가 여유가 돼서) 1024MB로도 Ubuntu는 운용됩니다.

하지만 몇 번 Compile해보니 버벅인다는 느낌을 받게 되더군요 그런이유로 CPU도 2개로 변경,

Network Adapter는 사내망에서 보일 수 있도록 NAT에서 Bridged로 변경 했습니다.

(Redmine 정도면 고정 IP를 사용 해야겠지요 - 물론 이걸로 실제 운용하지는 않을겁니다.)

제가 변경한 Option들입니다.

'Easy Install' 이라는 말이 딱 맞습니다.

그 이후 손 한번 가지 않고 아래 화면이 나옵니다(짜잔~~)

Redmine을 설치하기 위해 google을 열심히 찾아 다녔습니다.

설치방법을 상세히 설명해주신 많은 분들이 계셨지만 저는 안되더군요.

여러가지 Error 상황이 발생하여 검색만으로 헤쳐 나가기에는 부족함이 있었습니다.

VMWare에 Ubuntu 설치 후 Snapshot을 만든 다음,

Redmine을 설치하고 실패해서 roll-back하고를 여러번 드디어 길을 발견했습니다.

그 길을 편히 가셨으면 합니다.

먼저 ruby부터 설치 해보겠습니다.

Ubuntu-16.04에서 기본 제공하는 ruby version은 아래와 같습니다.

* 실행이 되지 않는다면 먼저 설치를 하셔야 됩니다.

  sudo apt-get install ruby ruby-dev

1. Apache 설치

  sudo apt-get install apache2 libapache2-mod-passenger

2. MySQL 설치

  sudo apt-get install mysql-server mysql-client

3. Redmine 설치

  sudo apt-get install redmine redmine-mysql

4. 설정(앞쪽의 숫자는 단지 Line 번호 일뿐입니다)

  sudo vi /etc/apache2/mods-available/passenger.conf

  1 <IfModule mod_passenger.c>

  2     PassengerRoot /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini

  3     PassengerDefaultRuby /usr/bin/ruby

  4     PassengerDefaultUser www-data

  5     PassengerRuby /usr/bin/ruby

  6 </IfModule>

  sudo ln -s /usr/share/redmine/public /var/www/html/redmine

  sudo vi /etc/apache2/sites-available/000-default.conf 

  30     <Directory /var/www/html/redmine>

  31         RailsBaseURI /redmine

  32         PassengerResolveSymlinksInDocumentRoot on

  33     </Directory>

  34 

  35 </VirtualHost>

5. Apache 재 시작

  sudo service apache2 restart

운이 좋다면 여기까지만 하면 Redmine 창을 보실 수가 있습니다.

Web Browser에서

http://localhost/redmine

Redmine을 설치하기 위한 문서에서 대부분 "gem update"를 실행하도록 되어있습니다.

이 때 아래 에러 메세지를 보실 수 있습니다.

  ERROR: Failed to build gem native extension

그 전에 패키지를 추가 하겠습니다.

sudo apt-get install libmysqlclient-dev libssl-dev

sudo apt-get install imagemagick libmagickcore-dev libmagickwand-dev

자세한 사항은 아래를 참조 바랍니다.

첫 번째, ERROR:  Error installing atomic:

주요 문제는 mkmf.rb can't find header files for ruby at /usr/lib/ruby/include/ruby.h

ruby-dev를 설치하면 해결 됩니다.

sudo apt-get install ruby-dev

두 번째, ERROR:  Error installing mysql2:

에러 메세지를 잘 살펴보면 정답이 있습니다.

sudo apt-get install libmysqlclient-dev

세 번째, ERROR:  Error installing rmagick:

sudo apt-get install imagemagick libmagickcore-dev libmagickwand-dev

마지막으로 ERROR:  Error installing did_you_mean:

에러 메세지는 did_you_mean requires Ruby version >= 2.4.0.

ruby version을 2.4.0 이상으로 하라고 되어 있습니다. 해봤지만 더 힘들어 지더군요.

일단, 해당 gem 목록을 확인해 보겠습니다.

gem list --remote --all did_you_mean

해당 gem version을 낮춰서 설치 하겠습니다.

sudo gem install did_you_mean -v 1.0.3

참고: ruby 최신 버전 설치 방법

ruby 최신 version 설치를 위해 PPA(Personal Package Archives)를 추가합니다.

  sudo apt-add-repository ppa:brightbox/ruby-ng

  sudo apt-get update

이제 ruby2.4를 설치 합니다.

  sudo apt-get install ruby2.4 ruby2.4-dev

Version 확인

  sudo apt-get install libssl-dev

  sudo apt-get install imagemagick libmagickcore-dev libmagickwand-dev