Panduan Installasi CBT di Windows
Prasyarat
- Sistem operasi Windows 10 atau 11 (64-bit)
- Akses administrator untuk install software
- License CBT yang didapat dari ecosystem.ekstraordinary.com
Mendapatkan License dari Ecosystem
Sebelum menginstal CBT, Anda perlu mendapatkan license terlebih dahulu. Berikut adalah langkah-langkahnya:
-
Buka website Ecosystem:
- Akses ecosystem.ekstraordinary.com di browser Anda
-
Login atau Register:
- Jika sudah memiliki akun, login dengan email dan password Anda
- Jika belum memiliki akun, "Daftar" untuk membuat akun baru
-
Generate atau Copy License Key:
- Klik tombol "Generate License"
- Copy license key yang muncul
- Simpan license key di tempat yang aman
-
Verifikasi License:
- Pastikan license key aktif dan valid
- Periksa masa berlaku license
Catatan:
- License key diperlukan untuk mengaktifkan aplikasi CBT
- Setiap license key hanya bisa dipakai di satu server
1. Download dan Extract File CBT
-
Download file CBT:
- Buka https://ekstraordinary.com/download di browser
- Klik tombol "Download for Windows" atau link download yang sesuai
-
Extract file yang telah didownload:
- Klik kanan pada file ZIP yang didownload
- Pilih "Extract All..."
- Pilih folder tujuan, misalnya
D:\CBTatauC:\CBT - Klik "Extract"
Catatan Penting:
- Anda dapat menggunakan direktori lain sesuai preferensi Anda
- Format file download biasanya berupa
.zip - Pastikan folder tujuan memiliki cukup ruang penyimpanan
2. Install PostgreSQL
-
Download PostgreSQL Installer:
- Buka https://www.postgresql.org/download/windows/
- Download installer versi terbaru untuk Windows
-
Jalankan Installer:
- Double-click file installer (misal:
postgresql-15-windows-x64.exe) - Ikuti wizard instalasi dengan klik "Next"
- Penting: Catat password yang Anda buat untuk user
postgres - Biarkan port default
5432 - Selesaikan instalasi
- Double-click file installer (misal:
-
Verifikasi Instalasi:
- Cari "pgAdmin 4" di Start Menu
- Buka pgAdmin untuk memastikan PostgreSQL terinstall dengan baik
3. Setup Database PostgreSQL
-
Buka pgAdmin:
- Cari "pgAdmin 4" di Start Menu dan buka aplikasi
- Masukkan password yang dibuat saat instalasi
-
Buat Database:
- Di panel kiri, klik kanan pada "Databases"
- Pilih "Create" → "Database"
- Isi:
- Database:
cbt_db - Owner:
postgres
- Database:
- Klik "Save"
4. Import Data SQL
-
Cari file SQL:
- Di folder CBT yang sudah diextract, cari file
exo-dump-master.sql
- Di folder CBT yang sudah diextract, cari file
-
Import di pgAdmin:
- Di pgAdmin, klik kanan pada database
cbt_db - Pilih "Query Tool"
- Klik icon "Open File" (folder)
- Pilih file
exo-dump-master.sql - Klik icon "Execute" (petir) atau tekan F5
- Tunggu sampai proses import selesai
- Di pgAdmin, klik kanan pada database
5. Setup Aplikasi CBT
-
Buat direktori storage:
- Di folder CBT (misal:
D:\CBT) - Klik kanan → "New" → "Folder"
- Beri nama folder
storage
- Di folder CBT (misal:
-
Berikan permission (jika perlu):
- Klik kanan pada folder
storage - Pilih "Properties" → "Security"
- Pastikan user memiliki permission "Modify"
- Klik kanan pada folder
6. Konfigurasi File .env
-
Edit file .env:
- Di folder CBT, cari file
.env - Klik kanan → "Open with" → "Notepad" atau text editor lain
- Di folder CBT, cari file
-
Ubah konfigurasi berikut:
# License yang didapat dari ecosystem.ekstraordinary.com
SERVER_SECRET_LICENSE_KEY=license_anda_di_sini
# Konfigurasi Database
DB_NAME=cbt_db
DB_USER=postgres
DB_PASS=password_yang_dibuat_saat_install_postgres
DB_HOST=localhost
DB_PORT=5432
# Path storage (sesuaikan dengan lokasi folder CBT)
STORAGE_PATH=D:\CBT\storage
# Port aplikasi
SERVER_PORT=9988
Catatan Konfigurasi .env:
- Pastikan semua variabel di file
.envdiisi dengan benar SERVER_SECRET_LICENSE_KEYharus sesuai dengan license dari ecosystem.ekstraordinary.comDB_PASSharus sesuai dengan password PostgreSQL yang dibuat saat instalasiSTORAGE_PATHharus mengarah ke folderstorageyang sudah dibuat- Sesuaikan
STORAGE_PATHjika folder CBT berada di lokasi lain
7. Menjalankan Aplikasi
-
Cari file executable:
- Di folder CBT, cari file
main.exeataumain
- Di folder CBT, cari file
-
Jalankan aplikasi:
- Double-click file
main.exe - Jika berjalan dengan baik, akan muncul command prompt dengan output:
- Double-click file
_____ _ _ _ ____ ____ _____
| ____|_ _| |_ _ __ __ _ ___ _ __ __| (_)_ __ __ _ _ __ _ _ / ___| __ )_ _|
| _| \ \/ / __| '__/ _` |/ _ \| '__/ _` | | '_ \ / _` | '__| | | | | | | _ \ | |
| |___ > <| |_| | | (_| | (_) | | | (_| | | | | | (_| | | | |_| | | |___| |_) || |
|_____/_/\_\\__|_| \__,_|\___/|_| \__,_|_|_| |_|\__,_|_| \__, | \____|____/ |_|
|___/
Author: shellrean <info@shellrean.id>
Version: 4.7.0-ROSETTA-RELEASE
- Verifikasi instalasi:
- Buka browser (Chrome, Firefox, Edge)
- Akses
http://localhost:9988 - Aplikasi CBT seharusnya sudah bisa diakses
8. Setup Windows Service (Opsional)
Untuk menjalankan CBT sebagai service di Windows:
-
Download NSSM (Non-Sucking Service Manager):
- Download dari https://nssm.cc/download
- Extract ke folder tertentu
-
Install sebagai service:
- Buka Command Prompt sebagai Administrator
- Navigasi ke folder NSSM
- Jalankan perintah:
nssm install CBTService
-
Konfigurasi service:
- Di window NSSM yang muncul:
- Path: Browse ke
D:\CBT\main.exe(sesuaikan lokasi) - Startup directory:
D:\CBT(folder CBT)
- Path: Browse ke
- Klik "Install service"
- Di window NSSM yang muncul:
-
Kelola service:
- Buka "Services" (Windows + R, ketik
services.msc) - Cari service "CBTService"
- Klik kanan → "Start"
- Untuk auto-start: Klik kanan → "Properties" → Set "Startup type" ke "Automatic"
- Buka "Services" (Windows + R, ketik
Catatan Service:
- Service memungkinkan CBT berjalan otomatis saat Windows startup
- Untuk melihat log: Buka Event Viewer → Windows Logs → Application
- Untuk stop service:
services.msc→ CBTService → Stop - Untuk uninstall:
nssm remove CBTService
9. Troubleshooting
PostgreSQL Connection Error
- Pastikan PostgreSQL service berjalan:
- Windows + R →
services.msc→ Cari "postgresql" - Pastikan status "Running"
- Windows + R →
- Periksa password PostgreSQL di file
.env
Permission Denied
- Pastikan folder CBT dan
storagememiliki permission yang cukup - Coba jalankan
main.exesebagai Administrator
Port Already in Use
- Ubah
SERVER_PORTdi file.envke port lain (misalnya 9999) - Restart aplikasi
- Akses dengan port baru:
http://localhost:9999
License Error
- Pastikan
SERVER_SECRET_LICENSE_KEYdi file.envsesuai dengan license dari ecosystem - Verifikasi koneksi internet untuk validasi license
- Pastikan tidak ada spasi di awal/akhir license key
Tidak Bisa Diakses dari Browser
- Pastikan aplikasi masih berjalan (lihat di taskbar)
- Coba browser lain
- Clear cache browser:
Ctrl + Shift + Delete
Akses dari Jaringan Tidak Bisa
-
Cari IP Address komputer:
- Buka Command Prompt
- Ketik
ipconfig - Catat IPv4 Address (misal:
192.168.1.100)
-
Konfigurasi Firewall:
- Buka Windows Defender Firewall
- Pilih "Allow an app through firewall"
- Klik "Change settings" → "Allow another app"
- Browse ke
D:\CBT\main.exe - Centang "Private" dan "Public"
- Klik "OK"
-
Akses dari device lain:
- Pastikan dalam satu jaringan
- Akses
http://192.168.1.100:9988(ganti dengan IP komputer Anda)
10. Verifikasi Instalasi
-
Cek apakah aplikasi berjalan:
- Lihat di taskbar atau Task Manager
- Command prompt harus tetap terbuka dengan output CBT
-
Akses aplikasi:
- Buka browser di komputer server:
http://localhost:9988 - Buka browser di device lain:
http://[IP_SERVER]:9988
- Buka browser di komputer server:
-
Test fungsi dasar:
- Login dengan credential default
- Buat user baru
- Buat soal ujian sederhana
Support
Jika mengalami masalah, kunjungi:
- Dokumentasi: https://docs.ekstraordinary.com
- Telegram: Telegram Group