Skip to content
adrianwirawPublic

About

NetMon adalah proyek magang untuk mendukung pemantauan jaringan di Dinas Kearsipan dan Perpustakaan Provinsi Jawa Tengah (Dinas Arpus Jateng

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

Repository files navigation

NetMon — Instalasi dan Menjalankan

NetMon adalah proyek magang untuk mendukung pemantauan jaringan di Dinas Kearsipan dan Perpustakaan Provinsi Jawa Tengah (Dinas Arpus Jateng). Aplikasi ini memantau router MikroTik, menampilkan perangkat dan data DHCP/ARP, serta mendeteksi indikasi konflik alamat IP. Syslog dan notifikasi Telegram membantu petugas melihat peristiwa jaringan; pemantauan hanya mencakup router yang didaftarkan secara manual dan tidak mengubah konfigurasi router.

Pilih salah satu cara berikut. Jangan jalankan kedua cara bersamaan karena keduanya memakai port web 8000.

Pilihan 1: Docker Compose

Pasang dan jalankan Docker Desktop atau Docker Engine. Dari folder utama proyek, siapkan konfigurasi:

PowerShell:

if (-not (Test-Path .env)) { Copy-Item .env.example .env }

Linux:

if [ ! -f .env ]; then cp .env.example .env; fi

Isi nilai rahasia di .env, lalu jalankan semua layanan:

docker compose up -d --build

Buka http://localhost:8000. Perintah Docker yang umum:

docker compose ps                    # status layanan
docker compose logs -f web poller syslog
docker compose down                  # berhenti, data tetap disimpan
docker compose up -d --build         # jalankan/bangun ulang

Jangan gunakan docker compose down -v kecuali memang ingin menghapus data database.

Pilihan 2: Linux tanpa Docker

Pilihan ini memasang command yan agar bisa dipanggil dari folder mana pun oleh user Linux yang menjalankan installer. Instalasi ini tidak berlaku untuk semua user di komputer. Installer menyiapkan virtual environment Python khusus NetMon, membuat secret aplikasi jika belum ada, dan membangun penerima syslog Go; paket Python tidak dipasang ke Python sistem.

Persyaratan: Bash, Python 3.10+, Go 1.21+, dan akses internet saat instalasi dependensi.

Dari folder utama proyek:

bash yan.sh install

Troubleshooting WSL untuk checkout lama: jika muncul error invalid option name atau \r: command not found, berkas yan.sh masih memakai format baris Windows (CRLF). Checkout terbaru menjaga file shell tetap dalam format Unix (LF). Untuk checkout lama, ubah formatnya sebelum menjalankan instalasi:

sed -i -e 's/\r$//' yan.sh
bash yan.sh install

Installer membuat .env dari .env.example jika belum ada. DJANGO_SECRET_KEY dan INGEST_TOKEN yang kosong atau masih bernilai contoh akan dibuat otomatis; nilai rahasia yang sudah diatur tidak diubah. File .env dibatasi agar hanya dapat dibaca oleh user saat ini. Pertahankan DJANGO_SECRET_KEY yang sama agar kredensial router tersimpan tetap dapat dibuka.

Command dipasang di ~/.local/bin/yan. Installer mengatur PATH otomatis untuk Bash atau Zsh. Setelah instalasi berhasil, aktifkan perubahan di terminal yang sedang dipakai:

Bash / WSL:

source ~/.bashrc
hash -r

Zsh:

source ~/.zshrc
hash -r

Lalu mulai NetMon:

yan up

Jika membuka terminal baru, aktivasi PATH biasanya tidak perlu diulang. Ini instalasi per-user, bukan system-wide untuk semua user.

Setelah instalasi, kelola semua layanan dengan:

yan up                    # mulai web, poller, dan penerima syslog
yan status                # status layanan
yan logs                  # ikuti log semua layanan
yan logs web              # ikuti log layanan tertentu
yan down                  # hentikan semua layanan
yan restart               # mulai ulang semua layanan

Buka http://127.0.0.1:8000. Aplikasi memakai SQLite di django_app/db.sqlite3; yan down tidak menghapus data. Log dan PID proses disimpan di ~/.local/state/netmon.

Jika folder proyek dipindahkan, jalankan kembali bash yan.sh install dari lokasi barunya agar command yan menunjuk ke lokasi yang benar. Setelah memperbarui kode, jalankan bash yan.sh install lagi untuk memasang dependensi atau membangun ulang penerima syslog, lalu aktifkan PATH di terminal jika diminta dan jalankan yan restart.

Tanpa login aplikasi, web hanya diikat ke komputer lokal (127.0.0.1). Jangan ubah alamat bind atau menerbitkannya ke jaringan/internet tanpa menambahkan perlindungan akses. Penerima syslog mendengarkan UDP 5514; arahkan RouterOS ke IP komputer ini dan izinkan port tersebut di firewall jika ingin menggunakannya.

About

NetMon adalah proyek magang untuk mendukung pemantauan jaringan di Dinas Kearsipan dan Perpustakaan Provinsi Jawa Tengah (Dinas Arpus Jateng

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages