Dalam tutorial ini, kami akan membahas cara install dan konfigurasi versi Redmine terbaru di CentOS 7 menggunakan MariaDB sebagai back-end database dan Passenger + Nginx sebagai server aplikasi Ruby.<\/p>\n
Prasyarat<\/h2>\n
Pastikan Anda telah memenuhi prasyarat berikut sebelum mulai dengan tutorial ini:<\/p>\n
- \n
- Memiliki nama domain yang menunjuk ke IP publik server. Kami akan menggunakan\u00a0
example.com<\/code>.<\/li>\n- Masuk sebagai pengguna dengan hak istimewa sudo<\/a>.<\/li>\n<\/ul>\n
Instal paket yang diperlukan untuk membangun Redmine dan Ruby dari source:<\/p>\n
sudo yum install curl gpg gcc gcc-c++ make patch autoconf automake bison libffi-devel libtool \nsudo yum install readline-devel sqlite-devel zlib-devel openssl-develh readline glibc-headers glibc-devel \nsudo yum install mariadb-devel zlib libyaml-devel bzip2 iconv-devel ImageMagick ImageMagick-devel<\/pre>\n
Membuat database MySQL<\/h2>\n
Redmine mendukung MySQL\/MariaDB, Microsoft SQL Server, SQLite 3 dan PostgreSQL. Kami akan menggunakan MariaDB sebagai back-end database. Pastikan Anda memiliki setidaknya MySQL 5.7 atau MariaDB 10.3 terinstall di mesin Anda.<\/p>\n
Jika MariaDB atau MySQL belum terinstal di server CentOS Anda, Anda dapat menginstalnya menggunakan instruksi ini<\/a>.<\/p>\n
Mulai dengan masuk ke konsol MySQL dengan mengetik:<\/p>\n
sudo mysql<\/pre>\n
Jalankan pernyataan SQL berikut untuk membuat database baru:<\/a><\/p>\n
CREATE DATABASE redmine CHARACTER SET utf8mb4;<\/pre>\n
Buat akun user MySQL baru<\/a> dan berikan akses ke database:<\/p>\n
GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'ubah-dengan-password-anda';<\/pre>\n
Jangan lupa ganti
ubah-dengan-password-anda<\/code> dengan kata sandi yang kuat.<\/p>\nSetelah selesai, keluar dari konsol MariaDB dengan mengetik:<\/p>\n
EXIT;<\/pre>\n
Install Passenger dan Nginx<\/h2>\n
Passenger adalah server aplikasi web yang cepat dan ringan untuk Ruby, Node.js dan Python yang dapat diintegrasikan dengan Apache<\/a> dan Nginx.\u00a0Pada tutorial ini, Kita akan menginstal Passenger sebagai modul Nginx.<\/p>\n
Instal repositori EPEL<\/a> dan paket yang diperlukan:<\/p>\n
sudo yum install epel-release yum-utils pygpgme \nsudo yum-config-manager --enable epel<\/pre>\n
Aktifkan repositori Phusionpassenger<\/a>:<\/p>\n
sudo yum-config-manager --add-repo https:\/\/oss-binaries.phusionpassenger.com\/yum\/definitions\/el-passenger.repo<\/pre>\n
Setelah repositori diaktifkan, perbarui daftar paket dan instal Nginx dan Passenger dengan:<\/p>\n
sudo yum install nginx passenger passenger-devel<\/pre>\n
Membuat User Baru<\/h2>\n
Buat pengguna dan grup baru yang akan menjalankan instance Redmine, untuk mempermudah dalam mengelola dan mengetahui pola perilaku user, kita akan menamai user baru dengan nama
redmine<\/code>:<\/p>\nsudo useradd -m -U -r -d \/opt\/redmine redmine<\/span><\/pre>\nTambahkan user
nginx<\/code> ke group user baru<\/a> dan ubah izin direktori\/opt\/redmine<\/code> sehinggaNginx<\/code> dapat mengaksesnya:<\/p>\nsudo usermod -a -G redmine nginx \nsudo chmod 750 \/opt\/redmine<\/pre>\n
Install Ruby di CentOS 7<\/h2>\n
Versi Ruby dalam repositori CentOS memang cukup usang dan tidak didukung oleh Redmine. Maka dari itu kita akan menginstal Ruby menggunakan RVM.<\/p>\n
Untuk install Ruby menggunakan RVM, kita akan login sebagai user\u00a0
redmine<\/code> dengan mengetik:<\/p>\nsudo su - redmine<\/pre>\n
Impor kunci GPG dan instal RVM:<\/p>\n
gpg --keyserver hkp:\/\/pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB \ncurl -sSL https:\/\/get.rvm.io | bash -s stable<\/pre>\n
Untuk mulai menggunakan RVM, gunakan perintah\u00a0source<\/a> file rvm:<\/p>\n
source \/opt\/redmine\/.rvm\/scripts\/rvm<\/pre>\n
Sekarang kita dapat menginstal Ruby dengan menjalankan:<\/p>\n
rvm install 2.5 \nrvm --default use 2.5<\/pre>\n
Jika Anda ingin menginstal Ruby via Rbenv, periksa panduan ini.<\/a><\/p>\n
Install Redmine di CentOS<\/h2>\n
Pada saat penulisan artikel ini, versi stabil Redmine terbaru adalah versi 4.0.1.<\/p>\n
Sebelum melanjutkan pada bagian berikutnya, silahkan untuk memeriksa versi terbaru redmine<\/a> untuk melihat apakah ada versi rilis terbaru yang tersedia.<\/p>\n
Pastikan Anda masuk sebagai user
redmine<\/code> sebelum melanjutkan pada bagian ini, Anda bisa memeriksa di terminal menggunakan perintahwhoami<\/code><\/p>\n1. Download Redmine<\/h3>\n
Download archive Redmine dengan menggunakan perintah\u00a0curl<\/a> berikut :<\/p>\n
curl -L http:\/\/www.redmine.org\/releases\/redmine-4.0.1.tar.gz -o redmine.tar.gz<\/pre>\n
Setelah pengunduhan selesai, ekstrak<\/a> arsip :<\/p>\n
tar -xvf redmine.tar.gz<\/pre>\n
2. Konfigurasi Database Redmine<\/h3>\n
Salin file\u00a0contoh konfigurasi (
.example<\/code>) Redmine dengan mengetik perintah :<\/p>\ncp \/opt\/redmine\/redmine-4.0.1\/config\/database.yml.example \/opt\/redmine\/redmine-4.0.1\/config\/database.yml<\/pre>\n
Buka file contoh konfigurasi Redmine dengan teks editor di linux terminal dengan mengetik perintah :<\/p>\n
sudo nano \/opt\/redmine\/config\/database.yml<\/pre>\n
Cari bagian
production<\/code> dan masukkan database MySQL serta\u00a0 informasi pengguna yang telah kita buat sebelumnya:<\/p>\nproduction: \n adapter: mysql2 \n database: redmine \n host: localhost \n username: redmine \n password: \"ganti-dengan-password-anda\"<\/pre>\n
Setelah selesai, simpan file dan keluar dari editor.<\/p>\n
3. Install dependensi Ruby<\/h3>\n
Pindah<\/a>\u00a0ke direktori
redmine-4.0.1<\/code> dan instal bundler serta dependensi Ruby lainnya:<\/p>\ncd ~\/redmine-4.0.1 \ngem install bundler --no-rdoc --no-ri \nbundle install --without development test postgresql sqlite<\/pre>\n
4. Hasilkan Key dan Migrasikan Database<\/h3>\n
Jalankan perintah berikut untuk menghasilkan kunci dan memigrasi database:<\/p>\n
bundle exec rake generate_secret_token \nRAILS_ENV=production bundle exec rake db:migrate<\/pre>\n
Konfigurasikan Nginx<\/h2>\n
Jika Anda masih login sebagai user redmine, silahkan kembali ke user biasa dengan perintah exit pada terminal.<\/p>\n
exit<\/pre>\n
Buka editor teks Anda dan buat file server block Nginx berikut:<\/p>\n
sudo nano \/etc\/nginx\/sites-available\/example.com<\/pre>\n
passenger_root \/usr\/share\/ruby\/vendor_ruby\/phusion_passenger\/locations.ini; \npassenger_ruby \/opt\/redmine\/.rvm\/gems\/default\/wrappers\/ruby; \npassenger_instance_registry_dir \/var\/run\/passenger-instreg; \n \nserver { \n listen 80; \n server_name example.com www.example.com; \n \n root \/opt\/redmine\/redmine-4.0.1\/public; \n \n # log files \n access_log \/var\/log\/nginx\/example.com.access.log; \n error_log \/var\/log\/nginx\/example.com.error.log; \n \n passenger_enabled on; \n passenger_min_instances 1; \n \n client_max_body_size 10m; \n}<\/pre>\nJangan lupa untuk mengganti
example.com<\/code> dengan domain Redmine Anda.<\/p>\nSebelum restart Nginx, lakukan tes untuk memastikan bahwa tidak ada kesalahan sintaksis:<\/p>\n
sudo nginx -t<\/pre>\n
Jika tidak ada kesalahan, hasilnya akan terlihat seperti ini:<\/p>\n
nginx: the configuration file \/etc\/nginx\/nginx.conf syntax is ok \nnginx: configuration file \/etc\/nginx\/nginx.conf test is successful<\/code><\/pre>\nTerakhir, restart layanan Nginx dengan mengetik:<\/p>\n
sudo systemctl restart nginx<\/pre>\n
Konfigurasi Nginx dengan SSL<\/h2>\n
Jika Anda belum memiliki sertifikat SSL tepercaya untuk domain, Anda dapat membuat sertifikat SSL Let\u2019s Encrypt dengan mengikuti petunjuk ini<\/a>.<\/p>\n
Setelah sertifikat dibuat edit konfigurasi domain Nginx sebagai berikut:<\/p>\n
sudo nano \/etc\/nginx\/conf.d\/example.com.conf<\/pre>\n
passenger_root \/usr\/share\/ruby\/vendor_ruby\/phusion_passenger\/locations.ini; \npassenger_ruby \/opt\/redmine\/.rvm\/gems\/default\/wrappers\/ruby; \npassenger_instance_registry_dir \/var\/run\/passenger-instreg; \n \n# Redirect HTTP -> HTTPS \nserver { \n listen 80; \n server_name www.example.com example.com; \n \n include snippets\/letsencrypt.conf; \n return 301 https:\/\/example.com$request_uri; \n} \n \n# Redirect WWW -> NON WWW \nserver { \n listen 443 ssl http2; \n server_name www.example.com; \n \n ssl_certificate \/etc\/letsencrypt\/live\/example.com\/fullchain.pem; \n ssl_certificate_key \/etc\/letsencrypt\/live\/example.com\/privkey.pem; \n ssl_trusted_certificate \/etc\/letsencrypt\/live\/example.com\/chain.pem; \n include snippets\/ssl.conf; \n \n return 301 https:\/\/example.com$request_uri; \n} \n \nserver { \n listen 443 ssl http2; \n server_name example.com; \n \n root \/opt\/redmine\/redmine-4.0.1\/public; \n \n # SSL parameters \n ssl_certificate \/etc\/letsencrypt\/live\/example.com\/fullchain.pem; \n ssl_certificate_key \/etc\/letsencrypt\/live\/example.com\/privkey.pem; \n ssl_trusted_certificate \/etc\/letsencrypt\/live\/example.com\/chain.pem; \n include snippets\/ssl.conf; \n include snippets\/letsencrypt.conf; \n \n # log files \n access_log \/var\/log\/nginx\/example.com.access.log; \n error_log \/var\/log\/nginx\/example.com.error.log; \n \n passenger_enabled on; \n passenger_min_instances 1; \n client_max_body_size 10m; \n}<\/pre>\n\u00a0<\/p>\n
Mengakses Redmine<\/h2>\n
Buka browser<\/a> dan ketikkan domain Anda, Jika instalasi berhasil, akan muncul tampilan yang mirip dengan screen shot berikut ini akan muncul:<\/p>\n
![\"\"](\"https:\/\/www.linuxid.net\/assets\/media\/img_5d0c8cf940ac4-1000x549.jpg\")
<\/a><\/p>\nKredensial login default untuk Redmine adalah:<\/p>\n
- \n
- Username: admin<\/li>\n
- Password: admin<\/li>\n<\/ul>\n
Ketika Anda masuk untuk pertama kalinya, Anda akan diminta untuk mengubah kata sandi seperti yang ditunjukkan di bawah ini:<\/p>\n
- Masuk sebagai pengguna dengan hak istimewa sudo<\/a>.<\/li>\n<\/ul>\n
![\"\"](\"https:\/\/www.linuxid.net\/assets\/media\/img_5d0c8cf9964f3-1000x548.jpg\")
<\/a><\/p>\n