INSTALASI GENIEACS DI UBUNTU 24.04

Diperbarui: 17 Oktober 2025


Unduh VirtualParameter (.bson) Unduh Config (.bson)

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.

Tampilan genieacs full virtualParameter
Gambar 1.0: Tampilan genieacs full virtualParameter.

Sumber virtualParameter : Github AlijayaNet


**Selesai.** Anda telah mencapai akhir dari topik ini. Silakan pilih topik lain melalui Sidebar di sebelah kiri atau kembali ke Halaman Modul Utama.