Instalasi Confluence 7.4.3 di Ubuntu 20.04 LTS Dengan Database MySQL

Instalasi Confluence 7.4.3 di Ubuntu 20.04 LTS Dengan Database MySQL

 

Confluence adalah sebuah aplikasi kolaborasi dalam format wiki yang dibuat oleh Atlassian.

Artikel ini berisi tahap instalasi Confluence versi 7.4.3 di sebuah server Ubuntu 20.04. Confluence menggunakan database sebagai penyimpanan data. Pada instalasi ini, database menggunakan MySQL versi 8.0.21. Pedoman instalasi ini mengadopsi dari pedoman resmi confluence di situs Atlassian: “Installing Confluence on Linux” , dengan penyesuaian seperlunya.

Strategi Instalasi

  • Server menggunakan sistem operasi Linux Ubuntu 20.04 LTS. Penggunaan versi LTS (Long Time Support) menjamin bahwa server ini masih mendapatkan update selama 5 tahun ke depan.
  • Server khusus menjalankan software Confluence, tidak menjalankan aplikasi lain supaya tidak saling mengganggu
  • Database menggunakan MySQL 8.0.x (pada waktu artikel ini ditulis versi terakhir adalah 8.0.21)
  • Webserver menggunakan Apache dengan reverse proxy dan SSL supaya aman
  • Pada demo ini SSL menggunakan self-signed certificate. Untuk mengubah ke certificate yang benar tidak rumit, cara mudah menggunakan Letsencrypt.
  • Confluence diinstall sebagai root

Persiapan Instalasi

  • Buat akun di situs my.atlassian.com
  • Siapkan server fisik ataupun virtual dengan kemampuan minimum sebagai berikut (sumber)
    • CPU: Quad core 2GHz+ CPU
    • RAM: 6GB
    • Minimum database space: 10GB
  • Download dan install Ubuntu 20.04 di sebuah server yang sudah disiapkan.
Tampilan situs my.atlassian.com
Tampilan login ke situs my.atlassian.com

Update Dan Upgrade Ubuntu

Seperti instalasi Ubuntu pada umumnya, perlu dilakukan update dan upgrade ke versi terbaru. Terutama untuk mengurangi kemungkinan masalah keamanan. Berikut ini perintah yang perlu dijalankan dari console Ubuntu Linux:

$ apt update
$ apt upgrade

Setup Database MySQL

Setting database MySQL perlu disesuaikan untuk Confluence.

Tambahkan setting berikut di file /etc/mysql/mysql.conf.d/mysqld.cnf . Untuk mengedit dapat menggunakan editor nano di Ubuntu.

character-set-server=utf8mb4
collation-server=utf8mb4_bin
default-storage-engine=INNODB
max_allowed_packet=256M
innodb_log_file_size=2GB
transaction-isolation=READ-COMMITTED
binlog_format=row

Tahap selanjutnya adalah membuat database serta user untuk mengakses database tersebut. Perlu disiapkan parameter sebagai berikut:

  • nama database, misal ‘confluence’
  • nama user , misal ‘confluenceuser”
  • password untuk akses, misal ‘65423452’

Parameter-parameter tersebut bebas, jadi bisa pilih nama user, nama database dan password sendiri, namun perlu disimpan baik-baik karena akan dipakai di tahap ‘Setup Confluence’ di tahap selanjutnya

Selanjutnya membuat database, dan user di MySQL.

Aktifkan console mysql

mysql -uroot

Jalankan perintah SQL berikut ini untuk membuat database dan membuat user baru:

CREATE DATABASE confluence CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE USER ‘confluenceuser’@’localhost’ IDENTIFIED BY ‘65423452’;
grant all privileges on confluence.* to ‘confluenceuser’@’localhost’;

Berikut tampilan di console:

CREATE DATABASE confluence CHARACTER SET utf8mb4 COLLATE utf8mb4_bin; CREATE USER 'confluenceuser'@'localhost' IDENTIFIED BY '65423452';  grant all privileges on confluence.* to 'confluenceuser'@'localhost';
Membuat database dan user di MySQL 8.0

Referensi instalasi database MySQL dapat dibaca di situs Atlassian artikel “Database Setup for MySQL

Instalasi Confluence

Download file atlassian-confluence-7.4.3-x64.bin, kemudian letakkan ke sebuah direktori di server.

Pindah ke direktori tersebut

$ cd
$ chmod a+x atlassian-confluence-7.4.3-x64.bin

Jalankan script instalasi tersebut

./atlassian-confluence-7.4.3-x64.bin

Script instalasi akan melakukan download program-program lain yang diperlukan untuk menjalankan Confluence.

Akan muncul prompt yang menanyakan “This will isntall Confluence 7.4.3 on your computer”. Klik Enter

Kemudian pilih Express Install

Pilih “1”. Enter

Klik enter untuk menerima setting default.

Klik Enter untuk Start Confluence

Instalasi selesai, confluence dapat diakses di alamat http://localhost:8090. Jika ingin diakses dari komputer lain, gunakan http://<alamat server>:8090. Misal pada instalasi ini menggunakan IP 192.168.0.206 , maka gunakan URL http://192.168.0.206:8090

Tahap selanjutnya adalah melakukan set up Confluence dari browser. Ada 2 pilihan: ‘Trial’ dan ‘Production Installation’. Untuk menggunakan database MySQL, pilih ‘Production Installation’. Kemudian klik “Next”.

Muncul tawaran untuk mengaktifkan Confluence Questions dan Team Calendars. Pada saat ini tidak diperlukan, jadi langsung klik “Next”.

Selanjutnya akan muncul formulir “License Key”. Jika belum punya lisensi, klik saja di “Get an evaluation license” untuk mendapatkan trial license. Trial license ini nantinya dapat dengan mudah diganti dengan lisensi sesungguhnya.

Jika belum login, maka akan muncul halaman login di situs Atlassian.

Selanjutnya akan muncul formulir “New Trial License”. Pilih lisensi “Confluence (Server)”, kemudian klik di tombol “Generate License” di bagian bawah formulir tersebut.

Selanjutnya akan muncul konfirmasi untuk melakukan instalasi license key di server kita. Klik saja “Yes”.

Browser akan otomatis mengisikan lisensi trial yang baru saja dibuat ke formulir License key. Klik di “Next”.

Berikutnya akan muncul pilihan database di menu “Set up your database”. Pilih “My own database”.

Pilih MySQL sebagai database. Untuk melanjutkan proses setup, perlu dilakukan instalasi driver MySQL dari console Linux.

Download software Connector J/ 8.0.21 dari situs MySQL: https://dev.mysql.com/downloads/connector/j/8.0.html

Pilih driver untuk “Ubuntu Linux 20.04 (Architecture Independent), DEB Package”, sesuai dengan versi Ubuntu yang dipakai.

Klik di “No thanks, just start my download”

Upload file “mysql-connector-java_8.0.21-1ubuntu20.04_all.deb” ke server.

install dengan apt install

apt install ./mysql-connector-java_8.0.21-1ubuntu20.04_all.deb

Setelah proses instalasi, file driver JDBC akan tersedia di direktori /usr/share/java

root@ubuntu-confluence:~# ls -l /usr/share/java

total 2348

-rw-r--r-- 1 root root 2602 Mar 22 15:42 libintl.jar

-rw-r--r-- 1 root root 2397299 Jun 17 08:29 mysql-connector-java-8.0.21.jar

Copy file jar tersebut ke direktori library confluence  <installation-directory>/confluence/WEB-INF/lib

Pada proses instalasi default, direktori library Confluence adalah di /opt/atlassian/confluence/confluence/WEB-INF/lib/
Copy driver JDBC ke direktori library Confluence tersebut.

cp /usr/share/java/mysql-connector-java-8.0.21.jar /opt/atlassian/confluence/confluence/WEB-INF/lib/

Selanjutnya restart Confluence dengan perintah berikut ini

$ sh /opt/atlassian/confluence/bin/stop-confluence.sh
$ sh /opt/atlassian/confluence/bin/start-confluence.sh

Akses kembali Confluence dari web browser dengan alamat sebelumnya , misal http://192.168.0.206:8090/.  Pilih “My own database” kemudian klik “Next”.

Isikan ke formulir sebagai berikut:

  • Database type: MySQL
  • Setup type: Simple
  • Hostname: localhost
  • Port: 3306
  • Database name: confluence (sesuai dengan tahap setup database di atas)
  • Username: confluenceuser (sesuai dengan tahap setup database di atas)
  • Password: 65423452 (sesuai dengan tahap setup database di atas)

Klik di “Test connection”. Jika semuanya benar, maka akan muncul pesan “Success! Database connected successfully”. Jika ada kesalahan, akan ditampilkan kode kesalahannya.

Selanjutnya “klik Next”. Proses instalasi akan melakukan set up database, yaitu mengisi database dengan data-data aplikasi Confluence.

Selanjutnya akan muncul pilihan untuk mengisi Confluence dengan data demo . Pada tahap ini bebas saja, jika ingin melihat kemampuan Confluence bisa klik di “Example Site”, jika tidak ingin bisa klik di “Empty Site”.

Selanjutnya ada pilihan untuk manajemen user. Jika tidak ingin install JIRA, untuk mudahnya, pilih saja “Manage users and groups within Confluence”

Selanjutnya muncul formulir pengisian identitas administrator

Selanjutnya akan muncul pesan yang menyatakan proses Setup selesai.

Pada tahap ini instalasi dan setup Confluence sudah selesai. Aplikasi dapat diakses di port 8090, dengan URL seperti ini: http://192.168.0.206:8090

Software Confluence yang baru diinstall ini menggunakan lisensi trial, yang hanya berlaku selama 30 hari. Setelah itu kita perlu membeli lisensi resmi.

Integrasi Apache Dan SSL

Untuk dapat diakses di port 80, dapat menggunakan web server Apache dengan fitur reverse proxy. Untuk dapat lebih aman, perlu ditambahkan enkripsi data dengan SSL (Security Socket Layer)

 

Referensi

Tinggalkan Balasan

Alamat email Anda tidak akan dipublikasikan.