A. Pendahuluan

GenieACS adalah software Auto Configuration Server (ACS) berbasis TR-069 yang berfungsi untuk mengelola perangkat jaringan (CPE) seperti modem atau router dari jarak jauh. Dengan GenieACS, administrator jaringan dapat melakukan provisioning, monitoring, dan troubleshooting perangkat dengan lebih efisien.

Panduan ini membahas cara instalasi GenieACS pada server Linux yang menggunakan systemd sebagai init system. Instalasi dilakukan pada satu server, namun di lingkungan produksi GenieACS dapat dijalankan secara terdistribusi atau dengan load-balancing.

⚠️ Catatan Penting:

• Pastikan server sudah memiliki Node.js (≥12.13) dan MongoDB (≥3.6).
• Untuk deployment production, disarankan mengaktifkan TLS/HTTPS serta mengganti nilai UI_JWT_SECRET dengan string acak yang aman.

B. Langkah-Langkah

1. Install Dependensi

Pastikan Node.js dan MongoDB sudah terpasang. Lalu install GenieACS dengan perintah:

sudo npm install -g genieacs@1.2.13

2. Membuat User dan Direktori

Tambahkan user sistem khusus untuk menjalankan service GenieACS:

sudo useradd --system --no-create-home --user-group genieacs

Buat direktori penyimpanan extension:

mkdir -p /opt/genieacs/ext
chown genieacs:genieacs /opt/genieacs/ext

3. Membuat File Environment

Buat file konfigurasi di /opt/genieacs/genieacs.env:

GENIEACS_CWMP_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-cwmp-access.log
GENIEACS_NBI_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-nbi-access.log
GENIEACS_FS_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-fs-access.log
GENIEACS_UI_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-ui-access.log
GENIEACS_DEBUG_FILE=/var/log/genieacs/genieacs-debug.yaml
NODE_OPTIONS=--enable-source-maps
GENIEACS_EXT_DIR=/opt/genieacs/ext

Generate JWT secret acak dan tambahkan ke file:

node -e "console.log(\"GENIEACS_UI_JWT_SECRET=\" + require('crypto').randomBytes(128).toString('hex'))" >> /opt/genieacs/genieacs.env

Atur hak akses:

sudo chown genieacs:genieacs /opt/genieacs/genieacs.env
sudo chmod 600 /opt/genieacs/genieacs.env

4. Membuat Direktori Log

mkdir /var/log/genieacs
chown genieacs:genieacs /var/log/genieacs

5. Membuat Service systemd

Buat service file untuk masing-masing komponen:

a. Service CWMP

sudo systemctl edit --force --full genieacs-cwmp

Isi dengan:

[Unit] Description=GenieACS CWMP
After=network.target

[Service] User=genieacs
EnvironmentFile=/opt/genieacs/genieacs.env
ExecStart=/usr/local/bin/genieacs-cwmp

[Install] WantedBy=default.target

b. Service NBI

sudo systemctl edit --force --full genieacs-nbi

Isi dengan konfigurasi serupa tapi ExecStart=/usr/local/bin/genieacs-nbi.

c. Service FS

sudo systemctl edit --force --full genieacs-fs

Isi dengan ExecStart=/usr/local/bin/genieacs-fs.

d. Service UI

sudo systemctl edit --force --full genieacs-ui

Isi dengan ExecStart=/usr/local/bin/genieacs-ui.

6. Konfigurasi Logrotate

Buat file /etc/logrotate.d/genieacs berisi:

/var/log/genieacs/*.log /var/log/genieacs/*.yaml {
   daily
   rotate 30
   compress
   delaycompress
   dateext
}

7. Enable dan Start Service

Aktifkan semua service agar otomatis jalan setelah boot:

sudo systemctl enable genieacs-cwmp
sudo systemctl start genieacs-cwmp
sudo systemctl status genieacs-cwmp

sudo systemctl enable genieacs-nbi
sudo systemctl start genieacs-nbi
sudo systemctl status genieacs-nbi

sudo systemctl enable genieacs-fs
sudo systemctl start genieacs-fs
sudo systemctl status genieacs-fs

sudo systemctl enable genieacs-ui
sudo systemctl start genieacs-ui
sudo systemctl status genieacs-ui

Pastikan status service active (running) sebelum lanjut ke konfigurasi lebih detail.

8. Akses GenieACS 

Buka browser dan akses:

http://<IP_SERVER>:3000

C. Penutup

Selamat! Anda sudah berhasil menginstal dan menjalankan GenieACS pada server Linux. Dengan mengikuti panduan ini, GenieACS siap digunakan untuk mengelola perangkat jaringan 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.