A. Pendahuluan

Aplikasi RDM (Rapor Digital Madrasah) merupakan sistem informasi yang digunakan oleh madrasah untuk mengelola data penilaian, rapor peserta didik, serta administrasi akademik secara digital dan terintegrasi. Aplikasi ini berbasis web sehingga memerlukan server dengan konfigurasi layanan web dan database yang sesuai agar dapat berjalan dengan optimal.

Panduan ini disusun untuk memberikan langkah-langkah instalasi Aplikasi RDM Madrasah pada sistem operasi Ubuntu 22.04.

B. Persiapan

Sebelum melanjutkan menginstal Aplikasi RDM Madrasah pada OS Ubuntu, pada artikel kali ini memerlukan persiapan service yang dibutuhkan seperti:

1.  Sistem Operasi : Pada artikel kali ini menggunakan Ubuntu 22.04 LTS.

2.  Spesifikasi Minimum Server :

• CPU: 2 core atau lebih
• RAM: Minimal 4 GB (disarankan 8 GB untuk produksi)
• Disk: Minimal 20 GB kosong
• Akses root atau user dengan hak sudo

Setelah menyiapkan service yang diperlukan, maka dapat melanjutkan ke tahap selanjutnya.

C. Instalasi Aplikasi RDM Madrasah di Ubuntu

1. Perbarui sistem

Untuk memperbarui daftar paket dari repository agar sistem tahu versi terbaru dari paket-paket yang tersedia dan meng-upgrade semua paket yang bisa diperbarui ke versi terbaru tanpa konfirmasi pengguna (-y otomatis menjawab "yes") dapat menjalankan command berikut:

apt update && apt upgrade -y

2. Instalasi Python & Tool Pendukung

Sebelum melakukan instalasi Aplikasi RDM Madrasah, pastikan sistem Ubuntu telah memiliki beberapa paket pendukung yang dibutuhkan. Paket ini digunakan untuk proses unduh file, ekstraksi arsip, serta pengeditan konfigurasi melalui terminal. 

Silakan jalankan perintah berikut:

apt install unzip curl nano wget -y

3. Instalasi Nginx dan Mengaktifkan serta Menjalankan Nginx

Jalankan perintah berikut pada terminal Ubuntu:

apt install nginx -y

Setelah instalasi selesai, jalankan perintah berikut:

systemctl enable --now nginx

4. Instalasi MariaDB dan Konfigurasi Keamanan MariaDB

Jalankan perintah berikut pada terminal Ubuntu:

apt install mariadb-server -y

Setelah instalasi selesai, jalankan perintah berikut untuk meningkatkan keamanan database:

mysql_secure_installation

Perintah ini akan menjalankan konfigurasi awal keamanan MariaDB, meliputi:

• Pengaturan password user root database
• Penghapusan user anonymous
• Menonaktifkan akses root dari remote
• Menghapus database test
• Reload privilege table

Selama proses berjalan, akan muncul beberapa pertanyaan. Disarankan untuk memilih opsi berikut:

5. Buat database RDM

Masuk ke MariaDB, silakan login ke MariaDB menggunakan perintah berikut:

sudo mysql

Kemudian jalankan perintah berikut untuk membuat database dan user database RDM Madrasah:

CREATE DATABASE rdm_db;
CREATE USER 'rdm_user'@'localhost' IDENTIFIED BY 'password_kuat';
GRANT ALL PRIVILEGES ON rdm_db.* TO 'rdm_user'@'localhost';
FLUSH PRIVILEGES;
SHOW GRANTS FOR 'rdm_user'@'localhost';
EXIT;

Catatan

• Nama database dan user dapat disesuaikan sesuai kebutuhan.
• Pastikan password database disimpan dengan aman dan tidak menggunakan password yang lemah.

6. Install PHP 7.2

Jalankan perintah berikut pada terminal Ubuntu:

add-apt-repository ppa:ondrej/php -y

Setelah repository berhasil ditambahkan, jalankan perintah berikut:

apt update

Kemudian jalankan perintah berikut pada terminal Ubuntu:

apt install php7.2-fpm php7.2-cli php7.2-mysql php7.2-xml php7.2-mbstring php7.2-curl php7.2-zip php7.2-gd -y

7. Download & Siapkan File RDM

Download file RDM dari Kemenag, Anda bisa mendownload pada URL: https://rdm.kemenag.go.id/#/download 

Atau langsung mengunduh File dari URL, Anda bisa mengunduh file ZIP RDM Madrasah ke server menggunakan salah satu dari perintah berikut:

https://rdm.kemenag.go.id/download/data/eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJkYXRhIjp7InN0YXR1cyI6Imhvc3RpbmciLCJmaWxlbmFtZSI6IlJETWhvc3RpbmcuemlwIiwiZmlsZSI6Ilwvd3d3XC93d3dyb290XC9yZG0ua2VtZW5hZy5nby5pZFwvX19zdG9yYWdlXC9SRE1ob3N0aW5nLnppcCJ9LCJleHAiOjE3NjkyOTE1NTYsImlhdCI6MTc2OTI5MDg1Nn0.N8-CemDnOystZeWwTtbCnIHQ_87jIYiP_ywlpLPU2J4

Catatan : Untuk token yang didapatkan bisa berbeda-beda.

Setelah file aplikasi RDM Madrasah berhasil diunduh, langkah selanjutnya adalah menyeragamkan nama file agar lebih mudah dikelola pada tahap instalasi berikutnya.

Jalankan perintah berikut pada direktori tempat file hasil unduhan berada:

mv * rdm.zip

8. Membuat Direktori dan Menempatkan File Aplikasi RDM

Pada tahap ini, dilakukan pembuatan direktori khusus untuk menyimpan file aplikasi RDM Madrasah serta memindahkan file arsip instalasi ke lokasi tersebut. Jalankan perintah berikut untuk membuat direktori aplikasi RDM:

mkdir -p /var/www/rdm

Pindahkan file arsip RDM ke direktori aplikasi:

mv rdm.zip /var/www/rdm

Pindah ke direktori yang telah dibuat:

cd /var/www/rdm

9. Ekstraksi File Aplikasi RDM Madrasah

Setelah file arsip rdm.zip ditempatkan pada direktori aplikasi, langkah selanjutnya adalah mengekstrak file tersebut agar source code RDM Madrasah dapat digunakan oleh web server. Pastikan Anda berada pada direktori aplikasi RDM:

cd /var/www/rdm

Kemudian jalankan perintah berikut:

unzip -o rdm.zip

10. Atur Kepemilikan dan Hak Akses Direktori RDM

Agar aplikasi RDM Madrasah dapat diakses dan dijalankan dengan baik oleh web server Nginx, diperlukan pengaturan ownership dan permission pada direktori aplikasi. Jalankan perintah berikut:

chown -R www-data:www-data /var/www/rdm

Selanjutnya, jalankan perintah berikut:

chmod -R 755 /var/www/rdm

11. Konfigurasi Nginx Virtual Host

Pada tahap ini dilakukan pembuatan server block Nginx agar aplikasi RDM Madrasah dapat diakses melalui browser menggunakan nama domain. alankan perintah berikut untuk membuat dan mengedit konfigurasi Nginx

nano /etc/nginx/sites-available/rdm

Kemudian masukkan konfigurasi berikut:

server {
    listen 80;
    server_name namadomainanda.tld;

    root /var/www/rdm;
    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.2-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

Catatan:

• server_name namadomain.tld : Nama domain yang digunakan untuk mengakses aplikasi RDM Madrasah.
  (Silakan sesuaikan dengan domain yang digunakan)

Setelah file konfigurasi dibuat, aktifkan server block dengan perintah berikut:

ln -s /etc/nginx/sites-available/rdm /etc/nginx/sites-enabled/

Sebelum merestart Nginx, lakukan pengecekan konfigurasi:

nginx -t

Pastikan hasilnya menunjukkan:

syntax is ok
test is successful

Jika tidak terdapat error, jalankan perintah berikut:

systemctl restart nginx

12. Instalasi dan Konfigurasi ionCube Loader PHP 7.2

Aplikasi RDM Madrasah membutuhkan ionCube Loader untuk menjalankan file PHP yang telah dienkripsi. Oleh karena itu, ionCube Loader harus dipasang dan dikonfigurasikan sesuai dengan versi PHP yang digunakan. Jalankan perintah berikut untuk mengunduh paket ionCube Loader:

wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz

Setelah file berhasil diunduh, ekstrak arsip tersebut dengan perintah:

tar xzf ioncube_loaders_lin_x86-64.tar.gz

Salin file ionCube Loader yang sesuai dengan versi PHP 7.2 ke direktori ekstensi PHP:

cp ioncube/ioncube_loader_lin_7.2.so /usr/lib/php/20170718/

Selanjutnya, buat file konfigurasi ionCube dengan perintah berikut:

nano /etc/php/7.2/fpm/conf.d/00-ioncube.ini

Kemudian isi file tersebut dengan konfigurasi berikut:

zend_extension=ioncube_loader_lin_7.2.so

Setelah konfigurasi selesai, simpan file lalu restart layanan PHP-FPM agar perubahan diterapkan:

systemctl restart php7.2-fpm

13. Instal & Konfigurasi Certbot (SSL)

Pada artikel panduan ini digunakan contoh SSL dari Certbot untuk mempermudah proses instalasi dan uji coba. Namun, untuk kebutuhan production, kami tidak menyarankan penggunaan SSL Certbot. Sebagai alternatif, silakan gunakan SSL bertipe wildcard apabila sertifikat akan digunakan secara bersamaan pada domain utama maupun seluruh subdomain terkait.

apt install certbot python3-certbot-nginx -y

Minta sertifikat SSL Let’s Encrypt:

certbot --nginx -d namadomain.tld

D. Hasil Uji Coba

Setelah proses instal dan Mendeploy Website telah selesai, silakan akses aplikasi di browser di URL berikut :

https://namadomain.tld

Ganti namadomain.tld dengan domain Anda. Setalah akses akan menampilkan tampilan dashboard berikut :

Pada halaman tersebut, silakan isi data berikut:

Setelah proses instalasi RDM Madrasah dan konfigurasi database berhasil, sistem akan menampilkan halaman Registrasi RDM. Tahap ini digunakan untuk menghubungkan aplikasi RDM lokal dengan RDM Pusat.

E. Penutup.

Dengan mengikuti panduan instalasi Aplikasi RDM (Rapor Digital Madrasah) pada sistem operasi Ubuntu, diharapkan aplikasi dapat terpasang dan berjalan dengan baik sesuai dengan kebutuhan operasional madrasah

Semoga artikel ini dapat membantu Anda. Temukan bantuan lainnya melalui Knowledge Base Biznet Gio. Jika Anda masih memiliki kendala silakan hubungi Support Biznet GIO melalui email support@biznetgio.com atau live chat maupun WA ke website www.biznetgio.com dan bisa juga melalui telepon ke nomor (021) 5714567.