Instalasi di Hosting

Shared Hosting Requirements:

Step 1: Upload Files

1. Via cPanel File Manager:

1. Login to cPanel
2. Open File Manager
3. Navigate to public_html/
4. Create folder: ftthnms/
5. Upload semua file aplikasi
6. Extract jika dalam format zip

2. Via FTP:

FTP Client: FileZilla, WinSCP, etc.
Upload semua file ke: /public_html/ftthnms/
Set permissions: 755 untuk folders, 644 untuk files

Step 2: Database Setup

1. Via cPanel MySQL Wizard:

1. cPanel → MySQL Database Wizard
2. Database name: yourusername_ftthnms
3. Create database user
4. Assign user to database dengan All Privileges
5. Note down database details

2. Import Database:

1. cPanel → phpMyAdmin
2. Select database
3. Import → Choose database.sql
4. Execute import

Step 3: Configuration

# Edit: config/database.php

<?php
class Database {
    private $host = "localhost";              // atau IP server hosting
    private $db_name = "yourusername_ftthnms"; // FTTH schematic NMS Database
    private $username = "yourusername_dbuser";
    private $password = "your_db_password";
    private $port = "3306";
    
    // Connection dengan charset UTF8MB4 untuk emoji support
    public function getConnection() {
        $dsn = "mysql:host={$this->host};dbname={$this->db_name};charset=utf8mb4";
        $options = [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
        ];
        return new PDO($dsn, $this->username, $this->password, $options);
    }
}
?>

Step 5: Security Setup

1. File Permissions:

# Via cPanel File Manager atau FTP
Folders: 755
Files: 644
config/: 750
config/database.php: 640

2. .htaccess Security:

# Create: /public_html/ftthnms/.htaccess

# Disable directory browsing
Options -Indexes

# Protect config directory
<Files "config/*">
    Deny from all
</Files>

# Protect database files
<Files "*.sql">
    Deny from all
</Files>

# Enable mod_rewrite
RewriteEngine On

# Force HTTPS (optional)
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

Konfigurasi Database

Database Schema Overview:

Core Tables:

• ftth_items - Data infrastruktur FTTH (items, coordinates, properties)
• cable_routes - Routing kabel antar items dengan coordinates
• users - User accounts dan roles (admin/teknisi)
• item_types - Jenis-jenis item (11 categories dengan icons)
• monitoring_logs - Log monitoring ping status

Master Data Tables:

• tube_colors - 32 warna tube dengan hex codes
• splitter_types - Jenis splitter (main & ODP) dengan ratio
• server_vlans - Konfigurasi VLAN untuk Server/Router
• olt_pons - Konfigurasi PON ports untuk OLT
• pon_vlans - Relasi PON-VLAN mapping

SNMP Monitoring Tables:

• snmp_metrics - Real-time SNMP monitoring data
• snmp_oid_mapping - OID mapping per device type
• device_interfaces - Persistent interface information
• interface_ip_addresses - IP addresses per interface
• interface_vlans - VLAN configuration per interface
• interface_wireless - Wireless interface information
• interface_bridges - Bridge interface information
• interface_tunnels - Tunnel interface information
• network_topology - Device connection mapping
• interface_traffic_history - Traffic history untuk trend analysis

Enhanced ODC Management Tables:

• odc_ports - ODC port management (input/output ports)
• odc_pon_mapping - ODC-PON connection mapping dengan VLAN

Database Views:

• latest_snmp_metrics - Latest SNMP metrics per device
• interface_summary - Interface summary dengan IP addresses
• topology_view - Network topology yang readable

Database Optimization:

-- Performance Indexes (dari database.sql)
-- Core Item Indexes
CREATE INDEX idx_core_color ON ftth_items(core_color_id);
CREATE INDEX idx_cable_type ON ftth_items(item_cable_type);
CREATE INDEX idx_core_usage ON ftth_items(core_used, total_core_capacity);
CREATE INDEX idx_monitoring_status ON ftth_items(monitoring_status);
CREATE INDEX idx_ip_address ON ftth_items(ip_address);
CREATE INDEX idx_item_type ON ftth_items(item_type);
CREATE INDEX idx_item_price ON ftth_items(item_price);
CREATE INDEX idx_snmp_enabled ON ftth_items(snmp_enabled);
CREATE INDEX idx_snmp_status ON ftth_items(snmp_enabled, monitoring_status);

-- ODC Enhancement Indexes
CREATE INDEX idx_odc_type ON ftth_items(odc_type);
CREATE INDEX idx_odc_capacity ON ftth_items(odc_capacity);
CREATE INDEX idx_odc_pon_connection ON ftth_items(odc_pon_connection);

-- User & Monitoring Indexes
CREATE INDEX idx_monitoring_logs_item ON monitoring_logs(item_id, ping_time);
CREATE INDEX idx_username ON users(username);
CREATE INDEX idx_user_role ON users(role);

-- SNMP Interface Indexes
CREATE INDEX idx_device_interfaces_device ON device_interfaces(device_id);
CREATE INDEX idx_device_interfaces_status ON device_interfaces(oper_status, admin_status);
CREATE INDEX idx_interface_ips_interface ON interface_ip_addresses(interface_id);
CREATE INDEX idx_topology_source ON network_topology(source_device_id, source_interface_id);
CREATE INDEX idx_topology_active ON network_topology(is_active, verified, last_seen);

-- Traffic History Index
CREATE INDEX idx_traffic_history_interface_time ON interface_traffic_history(interface_id, sample_time);

-- Latest SNMP Metrics View
CREATE VIEW latest_snmp_metrics AS
SELECT sm1.*
FROM snmp_metrics sm1
INNER JOIN (
    SELECT item_id, MAX(metric_time) as max_time
    FROM snmp_metrics GROUP BY item_id
) sm2 ON sm1.item_id = sm2.item_id AND sm1.metric_time = sm2.max_time;

Update Scripts:

FTTH schematic NMS menyediakan multiple database scripts untuk setup dan upgrade:

Authentication & User Management

User Roles & Permissions:

Role: Admin

• Full CRUD Access: Create, Read, Update, Delete semua items
• User Management: Kelola user accounts
• SNMP Configuration: Setup dan monitoring SNMP devices
• Accounting Access: View financial reports dan pricing
• System Configuration: Semua system settings

Role: Teknisi

• Read-Only Access: View semua data dan maps
• Export Data: Export KMZ, reports
• No Create/Edit/Delete: Tidak bisa modify data
• No User Management: Tidak bisa kelola users
• No System Config: Tidak bisa ubah settings

Default User Accounts:

User Management Operations:

Adding New Users:

1. Login sebagai Admin
2. Navigate: Dashboard → User Management
3. Add User:
   • Username: [unique_username]
   • Password: [secure_password]
   • Role: admin / teknisi
   • Full Name: [User Display Name]
   • Email: [user@email.com]
   • Status: active

Password Security:

• Hashing: bcrypt dengan salt
• Minimum Length: 8 characters (recommended)
• Change Password: User bisa change own password
• Admin Reset: Admin bisa reset password users

Session Management:

• Session Timeout: 30 menit inactivity
• Warning Alert: 5 menit before timeout
• Auto-logout: Automatic logout setelah timeout
• Remember Login: Optional remember untuk 7 hari

Panduan Penggunaan Fitur

Manajemen Item FTTH

Menambah Item Baru:

Item Types & Specific Fields:

Routing Kabel

Membuat Route Baru:

Route Types:

Route Properties:

• Cable Type: Fiber Optic, Copper, Hybrid
• Core Count: 2, 4, 8, 12, 24, 48, 96, 144, 288 cores
• Status: Planned (kuning), Installed (hijau), Maintenance (merah)
• Distance: Otomatis calculated dalam meter
• Auto-Generated Tiang: Track generated infrastructure

Auto-Generate Tiang Tumpu

Generated Tiang Properties:

• Naming: "Tiang Tumpu Auto" atau "Tiang Tumpu Tikungan"
• Type: Marked as auto-generated
• Behavior: Display-only, tidak bisa diedit
• Tracking: Linked ke route yang generate
• Cleanup: Auto-delete saat route dihapus

Dashboard & Statistics

Dashboard dengan Statistics Cards dan Interactive Map

Horizontal Statistics Cards:

Layout 1 row dengan 10 compact cards:

Real-time Updates:

• Statistics update otomatis saat data berubah
• Color-coded berdasarkan item types
• Click card untuk quick navigation

Statistics Detail:

• Total Items: Jumlah total semua item
• Per Type Count: Breakdown per kategori
• Auto-Generated: Track auto-generated items
• Route Statistics: Total routes, distance
• Investment Summary: Total harga (di Accounting page)

SNMP Monitoring

SNMP Configuration

Supported Devices:

• OLT: Optical Line Terminal monitoring
• Server/Router: Network equipment monitoring
• ONT: Customer premises equipment
• Access Point: Wireless equipment

🔧 SNMP Setup untuk XAMPP (Windows):

SNMP Versions:

Configuration Fields:

SNMP Settings:
├── SNMP Enabled: [checkbox]
├── Version: v1/v2c/v3 [dropdown]
├── Community: public/private [text]
├── Port: 161 [number]
├── Username: [text] (v3 only)
├── Auth Protocol: MD5/SHA [dropdown] (v3 only)
├── Auth Password: [password] (v3 only)
├── Priv Protocol: DES/AES [dropdown] (v3 only)
└── Priv Password: [password] (v3 only)

Monitoring Capabilities

Real-time Metrics:

• System Info: Hostname, uptime, description
• CPU Utilization: Processor usage percentage
• Memory Usage: RAM utilization
• Interface Status: Up/down, admin/operational status
• Bandwidth Utilization: In/out traffic dengan grafik

Interface Monitoring:

• Interface Discovery: Auto-discover network interfaces
• Persistent Storage: Interface data disimpan di database
• IP Address Mapping: Track IP per interface
• Topology Detection: Auto-detect device connections
• Traffic Monitoring: Real-time bandwidth usage

Optical Monitoring (for OLT/ONT):

• Tx Power: Transmit optical power (dBm)
• Rx Power: Receive optical power (dBm)
• Signal Quality: Link quality assessment
• Fiber Status: Cable integrity monitoring

SNMP Dashboard

Access SNMP Dashboard:

1. Login as Admin
2. Navigate: http://localhost/ftthnms/snmp_dashboard.php
3. atau Sidebar → "SNMP Dashboard"

Dashboard Features:

• Device Overview: Summary semua SNMP-enabled devices
• Real-time Status: Current status semua devices
• Interface Summary: Network interfaces overview
• Topology Map: Visual device connections
• Alert Summary: Critical issues notification

Interface Monitoring Workflow:

1. Click device marker di peta
2. Click "Discover" button
3. System perform SNMP discovery:
   • Discover all network interfaces
   • Get IP addresses per interface
   • Store data to database
   • Detect topology connections
4. Click "Interfaces" untuk view results:
   • Tab "Stored": Persistent interface data
   • Tab "Real-time": Live traffic monitoring
   • Tab "Topology": Device connections

Export/Import KMZ

Export KMZ untuk Google Earth

Export Process:

1. Dashboard → Tombol "Export KMZ" (hijau)
   atau Sidebar → "Export Data" → "Export ke KMZ"
2. System generate KMZ file dengan:
   • Semua FTTH items dengan styling
   • Cable routes dengan color coding
   • Complete information dalam popup
   • Professional GIS formatting
3. File auto-download dengan timestamp:
   Format: "FTTH_Planner_Export_YYYY-MM-DD-HHMMSS.kmz"

KMZ Content:

• Items: Semua 11 kategori item dengan marker styling
• Routes: Cable routing dengan status-based colors
• Metadata: Complete item information
• Styling: Professional icons dan colors

Google Earth Viewing:

1. Download file KMZ
2. Open Google Earth Pro atau Google Earth Web
3. File → Open → Select KMZ file
4. Data akan muncul di layer panel
5. Click item untuk view detail popup
6. Use Google Earth tools untuk measurement, etc.

Import KMZ/KML

Supported Formats:

• KMZ: Compressed KML files
• KML: Standard Google Earth format
• Geometries: Point, LineString, Polygon, MultiGeometry

Import Process:

1. Sidebar → "Import Data" → "Import dari KMZ/KML"
2. Upload file browser atau drag & drop
3. System parsing dan validation:
   • Auto-detect format
   • Parse coordinates
   • Validate data integrity
   • Preview import data
4. Review preview:
   • Check items to be imported
   • Verify coordinates
   • Resolve any conflicts
5. Confirm import:
   • Batch processing untuk large files
   • Progress indicator
   • Error reporting jika ada
6. Import complete:
   • Items appear on map
   • Statistics updated
   • Import summary report

Data Mapping:

Import Mapping:
├── Point → FTTH Item (auto-detect type)
├── LineString → Cable Route
├── Polygon → Convert to Point (centroid)
├── Name → Item name
├── Description → Item description
└── Coordinates → Latitude/longitude

Professional GIS Integration

Compatible Software:

Troubleshooting

Installation Issues

SNMP Issues:

XAMPP Issues:

Database Issues:

Application Issues

Login Problems:

Map Issues:

Performance Issues

Database Optimization:

-- Add missing indexes
CREATE INDEX idx_coordinates ON ftth_items(latitude, longitude);
CREATE INDEX idx_item_type ON ftth_items(item_type_id);
CREATE INDEX idx_route_items ON cable_routes(from_item_id, to_item_id);

-- Optimize tables
OPTIMIZE TABLE ftth_items;
OPTIMIZE TABLE cable_routes;

-- Check slow queries
SHOW FULL PROCESSLIST;

Server Optimization:

1. Increase PHP memory: memory_limit = 256M
2. Enable opcache: opcache.enable = 1, opcache.memory_consumption = 128
3. Enable compression: zlib.output_compression = On
4. Browser caching: Add Expires headers for static files

FAQ

General Questions

Technical Questions

-- Database backup FTTH schematic NMS
mysqldump -u username -p ftthnms > backup_ftthnms_$(date +%Y%m%d_%H%M%S).sql

-- Complete backup dengan struktur dan data
mysqldump -u username -p --single-transaction --routines --triggers ftthnms > full_backup.sql

-- File backup aplikasi
tar -czf ftthnms_backup_$(date +%Y%m%d).tar.gz /path/to/ftthnms/

-- Backup hanya tabel core (tanpa logs)
mysqldump -u username -p ftthnms ftth_items cable_routes users item_types > core_backup.sql

Security Questions

SNMP Questions

Maps & Export Questions

Kesimpulan

Key Benefits:

• Complete Infrastructure Management - 11 kategori item FTTH
• Interactive Mapping - Drag & drop, routing, visualization
• SNMP Monitoring - Real-time device monitoring
• Authentication System - Role-based security
• Professional Export - Google Earth integration
• Auto-Generation - Smart infrastructure planning
• Responsive Design - Works on all devices
• Open Source - Full source code ownership

Perfect For:

• ISP & Telco Companies - Network infrastructure planning
• FTTH Contractors - Site survey dan installation
• Government Projects - Infrastructure development
• Educational Institutions - Network learning
• Network Consultants - Professional planning tools

Production Ready:

• Enterprise-grade architecture dengan robust database design
• Scalable untuk large deployments (10K+ items)
• Professional security dengan encryption dan role-based access
• Comprehensive documentation dengan training materials
• Active support dan regular updates