INSTALASI GENIEACS DI UBUNTU 24.04
Diperbarui: 17 Oktober 2025
1. Apa Itu GenieACS?
GenieACS adalah sebuah Auto Configuration Server (ACS) yang bersifat open-source, ringan, dan berkinerja tinggi. Fungsi utamanya adalah untuk manajemen jarak jauh (remote management) perangkat jaringan, khususnya perangkat yang diaktifkan dengan protokol TR-069 (misalnya modem, router, ONT/ONU milik pelanggan ISP).
2. Langkah-langkah Instalasi
Lakukan update dan Upgrade dahulu
sudo apt update && sudo apt upgrade -y
Install depedensinya curl, repo nodejs, dan nodejs nya
sudo apt-get install curl -y
curl -sL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install nodejs -y
Install database MongoDB
curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
--dearmor
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
sudo apt-get update
sudo apt-get install -y mongodb-org
Aktifkan dan jalankan layanan MongoDB (Pastikan statusnya "active (running)")
sudo systemctl start mongod
sudo systemctl enable mongod
sudo systemctl status mongod
Install GenieACS menggunakan NPM
sudo npm install -g genieacs
Buat user khusus untuk GenieACS
sudo useradd --system --no-create-home --user-group genieacs
Buat direktori dan file konfigurasinya
sudo mkdir -p /opt/genieacs/ext
sudo chown genieacs:genieacs /opt/genieacs/ext
sudo mkdir /var/log/genieacs
sudo chown genieacs:genieacs /var/log/genieacs
Buat file .env untuk konfigurasi
sudo nano /opt/genieacs/genieacs.env
Tambahkan baris tersebut ke file 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_CWMP_INTERFACE=0.0.0.0
GENIEACS_NBI_INTERFACE=0.0.0.0
GENIEACS_FS_INTERFACE=0.0.0.0
GENIEACS_UI_INTERFACE=0.0.0.0
Buat JWT Secret
node -e "console.log(\"GENIEACS_UI_JWT_SECRET=\" + require('crypto').randomBytes(128).toString('hex'))" | sudo tee -a /opt/genieacs/genieacs.env
Atur hak akses file nya
sudo chown genieacs:genieacs /opt/genieacs/genieacs.env
sudo chmod 600 /opt/genieacs/genieacs.env
Buat file service systemd untuk cwmp
sudo nano /etc/systemd/system/genieacs-cwmp.service
tambahkan baris tersebut ke file genieacs-cwmp.service
[Unit]
Description=GenieACS CWMP
After=network.target
[Service]
User=genieacs
EnvironmentFile=/opt/genieacs/genieacs.env
ExecStart=/usr/bin/genieacs-cwmp
Restart=always
[Install]
WantedBy=multi-user.target
Lakukan hal yang sama untuk layanan lainnya (genieacs-nbi.service, genieacs-fs.service, dan genieacs-ui.service), hanya ubah baris ExecStart sesuai dengan nama layanan.
Reload konfigurasi systemd
sudo systemctl daemon-reload
Aktifkan dan jalankan semua service yang sudah dibuat tadi
sudo systemctl enable --now genieacs-cwmp genieacs-nbi genieacs-fs genieacs-ui
Periksa dan pastikan status semua service berstatus "active (running)"
sudo systemctl status genieacs-cwmp genieacs-nbi genieacs-fs genieacs-ui
GenieACS UI akan berjalan di port 3000 secara default. Buka browser akses http://(IP_SERVER):3000. Ikuti panduan wizard untuk inisialisasi database.
Konfigurasi tambahan untuk menambahkan custom Virtual Parameter, karena bawaan GenieACS belum bisa secara otomatis menampilkan settingan dasar ONU.
Load konfigurasi File untuk virtualParameter dan Config
mongorestore --db genieacs --drop --collection virtualParameters /Document/VM/GenieACS/virtualParameters.bson
mongorestore --db genieacs --drop --collection config /Document/VM/GenieACS/config.bson
Seharusnya sampai langkah ini, GenieACS sudah bisa menampilkan settingan dasar dari ONU, contohnya WAN, LAN, SSID, dll.
Sumber virtualParameter : Github AlijayaNet