Release v2.33.7 · Deployment Guide

Installation & Deployment Guide

Choose your preferred setup method: Docker Compose (fastest & automated), Standalone Linux Server, or Windows / XAMPP.

System Requirements & Prerequisites

PHP Runtime PHP 8.5 (Minimum) Memory limit >= 256MB

Database & Cache MariaDB 10.4+ / MySQL 8.0 (utf8mb4) Redis 6.0+ (Opsional/Cache)

PHP Extensions snmp, pdo_mysql, curl mbstring, redis, json

Scanner Engine Nmap Binary (available in PATH) Akses UDP 161 (SNMP)

Fast Deployment with Docker Compose

All dependencies (PHP 8.5+ Web, MariaDB, Redis, background Nmap scanner, and SNMP poller) are isolated and configured automatically.

Clone Repository & Pindah ke Direktori

git clone https://github.com/frambudi75/NetScopePro.git && cd NetScopePro

Jalankan Docker Compose Build

docker-compose up -d --build

⚡ Fitur Zero-Touch Database Auto-Healing (v2.31+):

Container otomatis mengecek kelengkapan tabel dan struktur skema `sql/database.sql`. Jika tabel database belum ada, sistem langsung mengimpor dan menginisiasi tabel secara instan tanpa perlu intervensi manual.

Akses Dashboard & Login Pertama

Buka browser dan akses alamat: http://localhost:2025

Kredensial Default: Username: admin | Password: admin123 (Wajib segera ganti password di menu Settings setelah login).

Perintah Operasional Docker Container

Cek Status Container: docker-compose ps

Lihat Log Polling: docker-compose logs -f app

Hentikan Container: docker-compose down

Instalasi Native di Linux Server (Ubuntu 22.04 / 24.04 / Debian)

Panduan instalasi paket PHP 8.5+, MariaDB, Nmap, Redis, dan SNMP langsung pada server Linux host.

1. Install Paket Dependencies & Web Server (PHP 8.5+)

sudo apt update && sudo apt install -y apache2 libapache2-mod-php8.5 php8.5 php8.5-snmp php8.5-mysql php8.5-curl php8.5-mbstring php8.5-redis mariadb-server nmap redis-server

2. Unduh Source Code & Atur Hak Akses Direktori

$ cd /var/www/html

$ sudo git clone https://github.com/frambudi75/NetScopePro.git

$ sudo chown -R www-data:www-data /var/www/html/NetScopePro

$ sudo chmod -R 775 /var/www/html/NetScopePro

3. Buat Database MariaDB & Import Skema

# Masuk ke MariaDB dan buat database:

CREATE DATABASE netscope CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'netscope'@'localhost' IDENTIFIED BY 'PasswordKuatAnda123!';

GRANT ALL PRIVILEGES ON netscope.* TO 'netscope'@'localhost';

FLUSH PRIVILEGES;

# Import tabel database:

mysql -u netscope -p netscope < /var/www/html/NetScopePro/sql/database.sql

4. Sesuaikan File Konfigurasi (includes/config.php)

Buka includes/config.php dan pastikan kredensial database sesuai dengan yang telah dibuat di langkah sebelumnya.

5. Aktifkan Module Rewrite Apache

sudo a2enmod rewrite && sudo systemctl restart apache2

Pastikan direktori `/var/www/html/NetScopePro` di file konfigurasi Apache VirtualHost memiliki opsi `AllowOverride All` agar file `.htaccess` berjalan aktif.

6. Pasang Crontab Worker Polling Otomatis

Jalankan crontab -e dan tambahkan baris berikut agar switch polling, netwatch, dan subnet scanner berjalan berkala:

* * * * * php /var/www/html/NetScopePro/cron_switch_poll.php >> /var/log/netscope_switch.log 2>&1

* * * * * php /var/www/html/NetScopePro/cron_netwatch.php >> /var/log/netscope_netwatch.log 2>&1

*/5 * * * * php /var/www/html/NetScopePro/cron_scanner.php >> /var/log/netscope_scanner.log 2>&1

Instalasi di Windows Menggunakan XAMPP

Langkah konfigurasi ekstensi PHP SNMP, Nmap Windows, dan database pada environment lokal XAMPP.

1. Aktifkan Ekstensi SNMP & PDO di php.ini

Buka file C:\xampp\php\php.ini, cari baris ;extension=snmp dan hapus tanda titik koma (;) di depannya. Pastikan juga extension=pdo_mysql dan extension=curl aktif, lalu restart Apache dari XAMPP Control Panel.

2. Pasang Nmap Windows & Registrasikan ke PATH

Unduh installer Nmap resmi dari nmap.org. Pastikan opsi "Add Nmap to System PATH" dicentang saat instalasi agar perintah nmap dapat dipanggil oleh PHP script.

3. Buat Database di phpMyAdmin & Import Skema SQL

Buka http://localhost/phpmyadmin, buat database bernama netscope (Collation: `utf8mb4_unicode_ci`), lalu import file sql/database.sql.

4. Jalankan Background Poller (run_cron.bat)

Untuk mengeksekusi polling switch dan ping Netwatch di Windows, jalankan file skrip run_cron.bat atau jadwalkan via Windows Task Scheduler setiap 1 menit.

Verifikasi Operasional & Post-Install SOP

Checklist langkah awal setelah instalasi NetScope Pro selesai dijalankan:

✓ 1. Rotasi Password Administrator

Login ke /login.php dengan akun admin / admin123. Buka menu Settings dan ganti password bawaan dengan passphrase yang kuat.

✓ 2. Tambah Subnet IP Pertama

Buka menu Subnets → klik Add Subnet. Masukkan network CIDR (contoh: 192.168.1.0/24), gateway, dan VLAN ID terkait.

✓ 3. Registrasi Switch Cisco / Alcatel SNMP

Buka menu Switches → Add Switch. Masukkan IP manajemen switch dan SNMP v2c community string (contoh: public). Sistem akan membaca status port, SFP optik, dan STP.

✓ 4. Uji Notifikasi Bot Telegram & Discord

Buka menu Settings → Notification Channels. Masukkan Bot Token & Chat ID Telegram atau Webhook URL Discord, lalu klik Test Webhook.

Troubleshooting & Masalah Umum (FAQ)

Solusi cepat untuk kendala yang sering ditemui saat konfigurasi jaringan:

Q: Mengapa SNMP Polling menghasilkan status "Timeout / No Response"?

Pastikan switch mengizinkan SNMP request dari IP server NetScope Pro pada port UDP 161. Cek konfigurasi switch Cisco: snmp-server community public RO atau ACL firewall.

Q: Nmap Scan tidak mendeteksi host atau menghasilkan error permissions?

Pastikan binary nmap terpasang dan bisa dipanggil via CLI (`which nmap`). Di Linux, beri hak akses raw packet socket jika diperlukan: sudo setcap cap_net_raw,cap_net_admin,cap_net_bind_service+eip /usr/bin/nmap.

Q: Muncul error 404 saat membuka halaman tanpa ekstensi .php di Apache?

Pastikan modul rewrite aktif (sudo a2enmod rewrite) dan direktori virtual host Apache diset ke AllowOverride All agar aturan `.htaccess` bawaan NetScope Pro terbaca dengan benar.