Redmine adalah open-source gratis untuk menggunakan alat berbasis web untuk manajemen proyek dan pelacakan masalah. Dibangun di atas kerangka kerja Ruby on Rails, ia menawarkan solusi lintas platform dan basis data lintas yang dilengkapi dengan dukungan untuk banyak proyek, wiki, forum, kalender, pemberitahuan email, dan banyak lagi.
Berikut adalah panduan mendetail tentang cara menginstal dan mengkonfigurasi Redmine di server CentOS 7.
Prasyarat
Pertama-tama, Anda memerlukan nama domain yang diarahkan ke IP server publik Anda. Untuk tutorial ini, kita akan merujuk ke example.com. Selain itu, Anda harus masuk sebagai pengguna dengan hak istimewa sudo.
Selain itu, Anda juga memerlukan backend database. Dalam kasus kami, kami akan menggunakan MariaDB. Namun, Anda juga dapat menggunakan Microsoft SQL Server, SQLite 3, dan PostgreSQL, karena Redmine mendukung semuanya.
Terakhir, Anda memerlukan server aplikasi Ruby yang akan kami gunakan Passenger dengan Nginx. Jika Anda tidak menginstalnya di sistem Anda, tidak perlu khawatir. Kami juga akan menunjukkan cara memasang dan mengonfigurasinya.
Mempersiapkan Sistem Anda Sebelum Menginstal Redmine
Seperti yang telah kita bahas, ada beberapa hal yang Anda perlukan pada sistem CentOS Anda sebelum Anda dapat menginstal dan menjalankan Redmine. Jika Anda belum menginstalnya, berikut adalah panduan langkah demi langkah yang menunjukkan cara menyiapkannya.
Catatan:Tidak perlu dikatakan lagi bahwa jika Anda sudah memiliki backend database atau server aplikasi Ruby yang diinstal, maka Anda dapat melewati langkah-langkah tersebut dan pindah ke langkah berikutnya.
Langkah 1:Menginstal Paket yang Diperlukan
Sebelum menginstal Redmine, Anda perlu mempersiapkan sistem Anda dengan menginstal paket Redmine dan Ruby yang diperlukan dari sumbernya.
Untuk melakukannya, ketik perintah berikut di terminal Anda:
$ sudo yum install curl gpg gcc gcc-c++ make patch autoconf automake bison libffi-devel libtool $ sudo yum install readline-devel sqlite-devel zlib-devel openssl-develh readline glibc-headers glibc-devel $ sudo yum install mariadb-devel zlib libyaml-devel bzip2 iconv-devel ImageMagick ImageMagick-devel
Setelah selesai, saatnya membuat database MySQL.
Langkah 2:Instal MariaDB di CentOS 7
Anda bebas menggunakan backend database apa pun yang Anda suka. Namun, untuk tutorial ini, karena kita akan menggunakan MariaDB/MySQL, berikut adalah tutorial singkat yang menunjukkan cara menginstalnya di sistem Anda.
Karena MariaDB versi 5.5 dilengkapi dengan repositori CentOS, kami akan menginstalnya semata-mata karena kenyamanan. Ini bukan versi terbaru, tetapi sangat stabil, dan Anda tidak akan mengalami masalah apa pun.
Ketik perintah berikut di terminal Anda untuk menginstal paket MariaDB:
$ sudo yum install mariadb-server
Setelah selesai menginstal, ketik perintah berikut untuk mengaktifkannya untuk memulai selama sistem boot-up.
$ sudo systemctl start mariadb $ sudo systemctl enable mariadb
Selanjutnya, periksa apakah instalasi berhasil atau tidak dengan memasukkan perintah berikut:
$ sudo systemctl status mariadb
Outputnya akan memberi tahu Anda bahwa layanan tersebut aktif dan berjalan. Setelah diurus, jalankan skrip berikut untuk melakukan beberapa tugas terkait keamanan untuk memastikan semuanya berfungsi dengan benar dan sesuai keinginan.
$ sudo mysql_secure_installation
Ini akan memunculkan petunjuk berikut:
Do you want to set up the root user password?
Do you want to remove anonymous user accounts?
Do you want to restrict root user access to the local machine?
Do you want to remove the test database?
Jawab dengan Y (ya) untuk semua pertanyaan ini.
Dan voila, Anda telah berhasil menginstal MariaDB di sistem CentOS Anda. Sekarang saatnya untuk melanjutkan ke langkah berikutnya.
Langkah 3:Buat Database MySQL
Dengan MariaDB terinstal di sistem CentOS Anda, ikuti langkah-langkah ini untuk membuat Database MySQL. Pertama, Anda harus masuk ke shell MySQL Anda. Untuk melakukannya, masukkan perintah berikut di terminal:
$ sudo mysql
Selanjutnya, Anda perlu membuat database baru. Untuk melakukannya, masukkan perintah berikut dari dalam shell MySQL Anda:
mysql> CREATE DATABASE redmine CHARACTER SET utf8;
Setelah selesai, Anda perlu membuat akun pengguna MySQL dan memberikannya akses ke database yang baru dibuat. Ini dilakukan dengan menggunakan perintah berikut:
mysql> GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'EnterPasswordHere';
Ganti EnterPasswordHere dengan kata sandi pilihan Anda yang kuat.
Anda telah berhasil membuat database MySQL. Sekarang keluar dari shell menggunakan perintah berikut dan lanjutkan ke langkah berikutnya:
mysql> EXIT;
Langkah 4:Instal Penumpang dan Nginx
Penumpang adalah server aplikasi web yang dirancang untuk Ruby, Node.js, dan Python. Ini super cepat, ringan dan dapat diintegrasikan dengan Apache dan Nginx. Untuk tutorial ini, kita akan menginstal modul Passenger untuk Nginx.
Untuk melakukan ini, pertama-tama kita perlu menginstal beberapa paket yang diperlukan, termasuk repositori EPEL. Untuk melakukannya, masukkan perintah berikut di terminal Anda:
$ sudo yum install epel-release yum-utils pygpgme $ sudo yum-config-manager --enable epel
Selanjutnya, Anda harus mengaktifkan repositori Phusionpassenger. Ini dapat dilakukan dengan menggunakan perintah ini:
$ sudo yum-config-manager --add-repo https://oss-binaries.phusionpassenger.com/yum/definitions/el-passenger.repo
Terakhir, perbarui daftar paket dan instal Nginx dan Passenger menggunakan perintah ini:
$ sudo yum install nginx passenger passenger-devel
Langkah 5:Buat Pengguna Sistem Baru
Kami hampir selesai mengatur semuanya untuk menginstal Redmine. Hal berikutnya yang perlu kita lakukan adalah membuat pengguna dan grup sistem baru yang akan menjalankan instance Redmine. Pertama-tama kita buat pengguna baru dengan memasukkan perintah berikut di terminal:
$ sudo useradd -m -U -r -d /opt/redmine redmine
Demi kesederhanaan, kami menyimpan nama pengguna sebagai redmine; namun, Anda bebas menggunakan nama pengguna apa pun yang Anda suka.
Selanjutnya, tambahkan pengguna ngnix ke grup pengguna baru menggunakan perintah ini:
$ sudo usermod -a -G redmine nginx
Dan terakhir, ubah izin direktori /opt/redmine sehingga dapat diakses oleh Nginx. Untuk melakukannya, masukkan perintah ini:
$ sudo chmod 750 /opt/redmine
Langkah 6:Instal Ruby
Dan sekarang, untuk langkah terakhir untuk menyiapkan semuanya, kita perlu menginstal Ruby di sistem CentOS kita.
Sekarang, bagian yang sulit adalah bahwa versi Ruby yang disertakan dengan repositori CentOS sudah usang dan tidak didukung oleh Redmine. Inilah sebabnya mengapa kita perlu menginstalnya dengan menggunakan RVM.
Pertama, beralih ke pengguna Redmine dengan mengetikkan perintah berikut:
$ sudo su - redmine
Anda perlu mengimpor kunci GPG menggunakan perintah ini:
$ gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
Setelah selesai, instal RVM dengan perintah ini:
$ curl -sSL https://get.rvm.io | bash -s stable
Sekarang, untuk menggunakan RVM, Anda perlu mencari file RVM menggunakan perintah ini:
$ source /opt/redmine/.rvm/scripts/rvm
Akhirnya, saatnya untuk menginstal Ruby di sistem kami. Untuk melakukannya, masukkan perintah berikut di terminal Anda.
$ rvm install 2.7 $ rvm --default use 2.7
Catatan:Di sini, 2.7 mengacu pada Ruby versi 2.7, yang merupakan versi terbaru dari Ruby pada saat penulisan. Jika ada versi Ruby yang diperbarui saat Anda membaca ini, maka unduh saja. Anda selalu dapat menggunakan versi 2.7 selama Redmine mendukungnya.
Dan itu saja! Anda telah berhasil mengonfigurasi sistem CentOS Anda, dan sekarang siap untuk menginstal Redmine.
Instal Redmine di CentOS 7
Saat memasang Redmine, Anda harus selalu memeriksa Halaman Unduh Redmine untuk melihat versi terbaru dan mengunduhnya. Demi tutorial ini, kami akan menginstal Redmine versi 4.1.1 karena ini adalah rilis stabil saat ini pada saat penulisan.
Sekarang dengan itu, berikut adalah panduan langkah demi langkah untuk menginstal Redmine 4.1.1 di CentOS 7.
Langkah 1:Unduh Redmine
Sebelum memulai, pastikan Anda menjalankan semua perintah dengan masuk sebagai pengguna Redmine.
Setelah Anda selesai melakukannya, unduh arsip Redmine ke sistem Anda. Anda dapat melakukannya dengan menggunakan perintah curl berikut:
$ curl -L http://www.redmine.org/releases/redmine-4.1.1.tar.gz -o redmine.tar.gz
Setelah mengunduh arsip, ekstrak menggunakan perintah berikut:
$ tar -xvf redmine.tar.gz
Langkah 2:Konfigurasikan Database Redmine
Selanjutnya, Anda perlu mengkonfigurasi database Redmine. Mulailah dengan menyalin file konfigurasi database contoh Redmine menggunakan perintah berikut:
$ cp /opt/redmine/redmine-4.1.1/config/database.yml.example /opt/redmine/redmine-4.1.1/config/database.yml
Selanjutnya, buka file menggunakan editor teks pilihan Anda. Kami akan menggunakan editor nano.
nano /opt/redmine/redmine-4.1.1/config/database.yml
Sekarang, cari di bawah bagian produksi dan masukkan informasi database MySQL yang dibuat sebelumnya, termasuk nama pengguna dan kata sandi, seperti yang ditunjukkan di bawah ini.
production: adapter: mysql2 database: redmine host: localhost username: redmine password: "EnterPasswordHere" encoding: utf8
Ganti EnterPasswordHere dengan kata sandi pilihan Anda yang kuat.
Setelah selesai, simpan dan keluar dari file untuk melanjutkan ke langkah berikutnya.
Langkah 3:Instal Ketergantungan Ruby
Selanjutnya, Anda perlu menginstal semua dependensi ruby dan bundler.
Untuk melakukannya, buka direktori redmine-4.1.1, buka terminal, dan masukkan perintah berikut:
$ cd ~/redmine-4.1.1 $ gem install bundler --no-rdoc --no-ri $ bundle install --without development test postgresql sqlite
Langkah 4:Membuat Kunci dan Memigrasikan Basis Data
Masukkan perintah berikut di terminal Anda untuk membuat kunci dan memigrasi database:
$ bundle exec rake generate_secret_token $ RAILS_ENV=production bundle exec rake db:migrate
Langkah 5:Konfigurasi Nginx
Sekarang, sebelum kami dapat mengakses Redmine, Anda perlu mengatur Nginx. Untuk melakukan ini, pertama-tama beralih kembali ke pengguna sudo Anda dengan memasukkan perintah berikut:
$ exit
Sekarang, buka editor teks dan buat file blok server Nginx. Untuk melakukannya, masukkan perintah berikut:
$ sudo nano /etc/nginx/conf.d/example.com.conf
Selanjutnya, salin dan tempel konten berikut di dalam file:
Catatan:Ingatlah untuk mengganti example.com dengan domain Redmine Anda.
passenger_root /usr/share/ruby/vendor_ruby/phusion_passenger/locations.ini;
passenger_ruby /opt/redmine/.rvm/gems/default/wrappers/ruby;
passenger_instance_registry_dir /var/run/passenger-instreg;
server {
listen 80;
server_name example.com www.example.com;
root /opt/redmine/redmine-4.1.1/public;
# log files
access_log /var/log/nginx/example.com.access.log;
error_log /var/log/nginx/example.com.error.log;
passenger_enabled on;
passenger_min_instances 1;
client_max_body_size 10m;
} Setelah selesai, jalankan tes untuk memastikan tidak ada kesalahan sistem dengan memasukkan perintah berikut:
$ sudo nginx -t
Output bersih tanpa kesalahan akan terlihat seperti ini:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
Setelah Anda mendapatkan lampu hijau, Anda dapat me-restart server Nginx dengan memasukkan perintah ini:
sudo systemctl restart nginx
Langkah 6:Enkripsi Nginx dengan SSL
Anda perlu mengonfigurasi Nginx dengan sertifikasi SSL. Jika domain Anda belum dilindungi oleh sertifikat SSL tepercaya, Anda dapat membuatnya gratis menggunakan Let's Encrypt.
Setelah Anda memiliki sertifikat, Anda perlu mengedit lagi file konfigurasi Nginx. Untuk melakukan ini, pertama, Anda harus membukanya di editor teks Anda menggunakan perintah berikut:
$ sudo nano /etc/nginx/conf.d/example.com.conf
Sekarang edit file, seperti yang ditunjukkan di bawah ini:
passenger_root /usr/share/ruby/vendor_ruby/phusion_passenger/locations.ini;
passenger_ruby /opt/redmine/.rvm/gems/default/wrappers/ruby;
passenger_instance_registry_dir /var/run/passenger-instreg;
# Redirect HTTP -> HTTPS
server {
listen 80;
server_name www.example.com example.com;
include snippets/letsencrypt.conf;
return 301 https://example.com$request_uri;
}
# Redirect WWW -> NON WWW
server {
listen 443 ssl http2;
server_name www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
include snippets/ssl.conf;
return 301 https://example.com$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com;
root /opt/redmine/redmine-4.1.1/public;
# SSL parameters
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
include snippets/ssl.conf;
include snippets/letsencrypt.conf;
# log files
access_log /var/log/nginx/example.com.access.log;
error_log /var/log/nginx/example.com.error.log;
passenger_enabled on;
passenger_min_instances 1;
client_max_body_size 10m;
} Catatan:Ingatlah untuk mengganti example.com dengan domain Redmine Anda.
Dan itu saja! Anda sekarang siap untuk mengakses Redmine.
Mengakses Redmine
Anda sekarang telah berhasil menginstal dan mengkonfigurasi Redmine di CentOS. Akhirnya tiba saatnya untuk mengaksesnya dan melihat apakah semuanya berfungsi dengan benar.
Untuk mengakses Redmine, pertama-tama Anda perlu membuka browser dan mengetikkan domain Anda. Jika penginstalan berhasil, Anda akan melihat layar berikut yang menanyakan nama pengguna dan kata sandi Anda.
Secara default, kredensial login adalah sebagai berikut:
Username: admin Password: admin
Setelah login untuk pertama kalinya, Anda akan diminta oleh sistem untuk mengubah kata sandi Anda menjadi kata sandi yang lebih aman.
Setelah mengubah kata sandi, Anda akan diarahkan ke halaman akun pengguna utama dari mana Anda dapat mulai menggunakan Redmine.