Panduan Lengkap Instalasi ThingsBoard Professional Edition di Proxmox LXC

ThingsBoard Professional Edition (PE) adalah platform IoT tingkat lanjut yang menawarkan fitur manajemen perangkat, visualisasi data, dan mesin aturan yang sangat fleksibel. Menggunakan container LXC di Proxmox Virtual Environment adalah strategi yang cerdas untuk menjalankan platform ini karena efisiensi sumber daya yang ditawarkan dibandingkan Virtual Machine (VM) konvensional.

Dalam panduan ini, kita akan melakukan instalasi secara "on-premises" menggunakan database PostgreSQL. Pastikan Anda telah menyiapkan container LXC dengan spesifikasi minimum setidaknya 2 core CPU dan 4 GB RAM untuk kebutuhan pengembangan atau PoC.

Langkah 1: Persiapan Container dan Update Sistem

Pastikan container LXC Anda menggunakan template Debian atau Ubuntu terbaru. Langkah awal yang wajib dilakukan adalah memperbarui daftar paket sistem agar proses instalasi berjalan lancar.

apt update && apt upgrade -y

Langkah 2: Instalasi Java OpenJDK 21

ThingsBoard PE versi terbaru memerlukan Java 17 atau lebih tinggi, namun sangat direkomendasikan untuk menggunakan OpenJDK 21 demi stabilitas dan performa optimal.

apt install openjdk-21-jdk -y
# Verifikasi versi Java
java -version

Langkah 3: Instalasi Paket ThingsBoard PE

Unduh paket Debian ThingsBoard PE dan instal menggunakan manajer paket dpkg. Pastikan Anda juga menginstal pustaka font yang diperlukan oleh komponen pelaporan.

apt install fontconfig libfreetype6 -y
wget https://dist.thingsboard.io/thingsboard-4.3.1.3PE.deb
dpkg -i thingsboard-4.3.1.3PE.deb

Langkah 4: Konfigurasi Kunci Lisensi

ThingsBoard PE memerlukan kunci lisensi agar layanan dapat berjalan. Kita akan memasukkan kunci rahasia lisensi langsung ke dalam file konfigurasi agar terbaca oleh layanan sistem secara permanen.

# Ganti YOUR_LICENSE_SECRET dengan kunci lisensi Anda
echo "TB_LICENSE_SECRET=YOUR_LICENSE_SECRET" >> /etc/thingsboard/conf/thingsboard.conf

Catatan: Parameter lisensi ini harus tepat agar proses aktivasi instance saat startup tidak mengalami kegagalan.

Langkah 5: Instalasi PostgreSQL dan Penambahan Repositori

Untuk mendapatkan versi PostgreSQL terbaru (seperti versi 16 atau 18), Anda perlu menambahkan repositori resmi PostgreSQL karena repositori bawaan Debian/Ubuntu biasanya menyediakan versi yang lebih lama.

# Menambah repositori resmi PostgreSQL
apt install wget gnupg2 -y
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | apt-key add -
echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list
apt update

# Instalasi PostgreSQL
apt install postgresql-16 -y

Langkah 6: Konfigurasi Database dan thingsboard.conf

Buat database untuk ThingsBoard dan atur kredensialnya. Sangat penting untuk mendaftarkan detail koneksi database ke dalam file thingsboard.conf sebelum menjalankan skrip instalasi utama.

# Masuk ke PostgreSQL dan buat database
sudo -u postgres psql -c "CREATE DATABASE thingsboard;"
sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD 'password_anda';"

# Tambahkan konfigurasi ke file thingsboard.conf
echo "export DATABASE_TS_TYPE=sql" >> /etc/thingsboard/conf/thingsboard.conf
echo "export SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/thingsboard" >> /etc/thingsboard/conf/thingsboard.conf
echo "export SPRING_DATASOURCE_USERNAME=postgres" >> /etc/thingsboard/conf/thingsboard.conf
echo "export SPRING_DATASOURCE_PASSWORD=password_anda" >> /etc/thingsboard/conf/thingsboard.conf

Langkah 7: Eksekusi Skrip Instalasi

Setelah semua konfigurasi siap, jalankan skrip inisialisasi untuk membuat skema database. Anda dapat memilih untuk memuat data demo guna memudahkan pengujian awal platform.

# Menjalankan instalasi dengan data demo
/usr/share/thingsboard/bin/install.sh --loadDemo

Langkah 8: Menjalankan Layanan dan Verifikasi

Langkah terakhir adalah menjalankan layanan ThingsBoard. Tunggu sekitar 90 detik hingga Web UI siap sepenuhnya sebelum mencoba mengaksesnya melalui browser.

systemctl enable thingsboard
systemctl start thingsboard

Untuk memverifikasi, akses http://[IP-CONTAINER-ANDA]:8080. Gunakan kredensial default berikut untuk login awal:

• System Administrator: sysadmin@thingsboard.org / sysadmin
• Tenant Administrator: tenant@thingsboard.org / tenant

Catatan: Segera ganti kata sandi default Anda melalui profil akun setelah berhasil login demi keamanan.

Selamat! Anda kini telah memiliki instance ThingsBoard Professional Edition yang berjalan dengan konfigurasi yang tepat di lingkungan Proxmox LXC Anda.