A. Pendahuluan

E-Rapor SMK merupakan sistem pelaporan hasil belajar siswa berbasis elektronik (Digital) yang digunakan di Sekolah Menengah Kejuruhan (SMK) di Indonesia. E-Raport SMK dapat di install pada device dengan OS Windows ataupun OS Linux. Pada artikel kali ini akan membahas cara penginstalan E-Rapor SMK pada OS Linux yaitu dengan menggnuakan Debian 12.

Sebelum melakukan pengistallan E-Rapor SMK, pastikan telah telah mempersiapkan sevice pendukung yaitu:

1. Web Server dengan Apache2.
2. PHP versi 8 dengan Extension yang dibutuhkan yaitu : php-cytpe, php-curl, php-dom, php-fileinfo, php-filter, php-mbstring, php-openssl, php-pcre, phppdo, php-session, php-tokenizer, php-xml, php-zip, php-pgsql, php-gd
3. Database PostgreSQL.
4.  Composer.

Berikut langkah-langkah install E-Rapor SMK pada Debian12.

B. Persiapan dan Instalasi Web Server, Database

1. Install Web Server

Web server yang digunakan pada artikel kali ini yaitu menggunakan Apache2, untuk instalasi Apache dapat menggunakan panduan:

·         Cara Menginstall Linux Apache

Dapat juga menjalankan command:

sudo apt update
sudo apt install apache2

Setalah itu dapat memulai service apache2 dan mengecek statusservice apache2.

sudo systemctl start apache2
sudo systemctl enable apache2
sudo systemctl status apache2

Seperti informasi diatas untuk web server apache2 telah berhasil di install dan telah berjalan dengan baik.

2. Install PHP

Selanjutnya yaitu melakukan penginstalan php, default php yang terdapat pada Debian 12 yaitu php versi 8.2 maka tidak perlu menambahkan spesifik versi php saat penginstalan. Jalankan langkah berikut untuk install php beserta module / extension yang dibutuhkan:

sudo apt install php php-cytpe php-curl php-dom php-fileinfo php-filter php-mbstring php-openssl php-pcre phppdo php-session php-tokenizer php-xml php-zip php-pgsql php-gd

Cek versi php dengan menjalankan command:

php –v

Lakukan pengecekkan modul / extension php yang telah terinstall dengan command:

php –m

Pastikan modul php telah terdapat pada list, jika belum maka dapat menginstall modul terpisah.

3. Install Database PostgreSQL

Dalam penginstalan database PostgreSQL dapat mengikuti artikel berikut:

·         Cara Install PostgreSQL 12 dan pgAdmin 4 di Ubuntu 20.04

Dapat juga menjalankan command:

sudo apt update
sudo apt install postgresql postgresql-contrib

Lakukan start dan cek status service PostgreSQL

sudo systemctl start postgresql
sudo systemctl enable postgresql
sudo systemctl status postgresql

Seperti informasi diatas untuk database PostgreSQL telah berhasil di install dan telah berjalan dengan baik.

4. Install Composer

Selanjutnya yaitu melakukan pengistalan composer untuk mengelolah dependensi project pada php.

Donwload composer diserver dan jalankan instalasi composer:

sudo apt update
curl -sS https://getcomposer.org/installer -o composer-setup.php
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
Setelah itu cek status composer saat ini dengan menjalankan command:
composer –V

Seperti informasi diatas untuk composer telah berhasil di install dan telah berjalan dengan baik.

C. Konfigurasi E-Rapor SMK di Web Server

Setelah melakukan persiapan dengan menginstall service pendukung yang dibutuhkan, maka selanjutnya yaitu tahap konfigurasi atau penginstalan E-Rapor SMK di server.

1. Download E-Rapor SMK

Pertama memerlukan persiapan project E-Raport SMK yang dapat di download di laman repository https://github.com/eraporsmk/erapor7

Berikut untuk langkah-langkah download:

git clone https://github.com/eraporsmk/erapor7.git erapor-smk

Jika telah berhasil maka akan muncul nama project baru yaitu erapor-smk.

2. Konfigurasi Database

Setelah melakukan download file, selanjutnya yaitu melakukan kofigurasi database di project E-Rapor SMK.

a. Pembuatan Database

Ikuti langkah berikut untuk pembuatan database di PostgreSQL.

Masuk ke service PostgreSQL:

sudo -i -u postgres
psql

Buat password untuk user database:

\password postgres

Buat database di PostgreSQL:

create database erapor;

Cek list database yang telah dibuat.

\l

Dicek database telah berhasil dibuat dan dapat keluar.

\q
exit

b. Koneksi Database

Setelah pembuatan database, selanjutnya melakukan konfigurasi database yang telah dibuat ke project E-Rapor SMK dengna mengikuti langkah berikut:

Masuk ke project E-Rapor SMK yang telah di download:

cd erapor-smk
Buat file .env:
cp .env.example .env

Edit file .env dan input konfigurasi database:

nano .env

Pada detail berikut dapat menginputkan nama database, username, dan password yang telah dibuat.

DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=db_name
DB_USERNAME=db_user
DB_PASSWORD=db_pass

Setelah itu dapat disimpan.

b. Install Dependensi

Jalankan command berikut untuk melakukan instalasi dependensi yang dibutuhkan pada folder project E-Rapor SMK.

composer install

Jika berhasil akan seperti berikut:

c. Generate App Key

Lanjut melakukan generate App Key dengan menjalankan command:

php artisan key:generate

Tunggu proses hingga selesai.

d. Migrate Database

Selanjutnya yaitu melakukan migrate database dan seeder dengan bergantian:

Menjalankan migrate:

php artisan migrate

Menjalankan seeder:

php artisan db:seed

3. Konfigurasi Web Server

Agar project dapat diakses secara publik, maka diperlukan penambahan konfigurasi di web server dengan mengikut langkah berikut.

a. Pembuatan virtual host

Buat virtual host yang nantinya diarahkan ke directory / folder project E-Rapor SMK.

Masuk ke folder konfigurasi virtual host di apache dan buat file virtual host baru.

sudo su
cd /etc/apache2/sites-available/
touch erapor.conf

Edit file virtual host:

nano erapor.conf

Inputkan detail konfigurasi seperti berikut:

<VirtualHost *:80>
    #ServerAdmin admin@example.com
    DocumentRoot /home/user/erapor-smk/public
    ServerName namadomain/subdomain
 
    <Directory /home/user/erapor01/public>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
 
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
RewriteEngine on
RewriteCond %{SERVER_NAME} =namadomain/subdomain
RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]
</VirtualHost>

Note:

• Pada DocumentRoot dapat menginputkan path folder dari project E-Rapor SMK.
• Pada ServerName dan RewriteCond %{SERVER_NAME} dapat menginputkan nama domain atau subdomain yang akan di gunakan project E-Rapor SMK.

Setelah itu dapat mengaktifkan konfigurasi virtual host apache yang telah dibuat.

sudo a2ensite erapor.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

b. Pembuatan .htaccess

Selanjutnya diperlukan pembuatan .htaccess di folder project E-Rapor SMK dengan langkah berikut.

touch .htaccess
sudo nano .htaccess

Lalu inputkan dengan detail berikut:

<IfModule mod_rewrite.c>
    <IfModule mod_negotiation.c>
        Options -MultiViews -Indexes
    </IfModule>
 
    RewriteEngine On
 
    # Handle Authorization Header
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
 
    # Redirect Trailing Slashes If Not A Folder...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_URI} (.+)/$
    RewriteRule ^ %1 [L,R=301]
 
    # Handle Front Controller...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

c. Penyesuaian permission akses project

Lakukan penyesuaian permission akses ke folder data project E-Raport SMK.

chown –R www-data:www-data /home/user/erapor-smk
sudo find /home/user/erapor-smk -type f -exec chmod 644 {} \;
sudo find /home/user/erapor-smk -type d -exec chmod 755 {} \;
sudo chmod 600 /home/user/erapor-smk/.env

4. Akses E-Rapor SMK

Setelah melakukan langkah di atas dan telah sesuai, selanjutnya dapat mengakses ke website E-Raport SMK yang telah dibuat. Jika telah sesuai maka akan masuk ke laman login E-Rapor SMK seperti berikut:

Note: Untuk login diperlukan registrasi terlebih dahulu, pastikan anda telah memiliki NPSN dan Email yang telah terdaftar di Dapodik. Hal ini dikarenakan akun E-Rapor SMK terintegrasi dengan Dapodik.

D. Penutup

Selamat Anda telah menyelesaikan instalasi untuk E-Rapor SMK pada layanan Anda. Semoga artikel ini dapat membantu Anda. 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.