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:

🔧 Perbaikan Monitoring System

Ping Monitoring Enhancements:

🔧 Problem yang Diperbaiki:

• ❌ "ping: executable file not found" - ping command tidak tersedia di container
• ❌ False negative ping results - device online tapi reported sebagai offline
• ❌ Network timeout issues - monitoring hang pada certain devices
• ❌ Docker container limitations - missing network utilities

✅ Solution yang Diimplementasi:

1. Multi-Method Ping Detection

2. Enhanced API Endpoints

// File: api/ping_monitor.php
function pingHost($host) {
    // Try system ping first
    $ping_result = trySystemPing($host);
    
    // Fallback to socket ping if system ping fails
    if (!$ping_result['success']) {
        return trySocketPing($host);
    }
    
    return $ping_result;
}

3. Socket-Based Ping Implementation

// Multi-port connectivity test
$test_ports = [80, 443, 22, 23, 21, 25, 53];

foreach ($test_ports as $port) {
    $socket = @fsockopen($host, $port, $errno, $errstr, $timeout);
    if ($socket) {
        // Connection successful
        fclose($socket);
        return ['success' => true, 'response_time_ms' => $time];
    }
}

Database ENUM Fixes:

🔧 ENUM Validation Enhancement:

Fixed item_cable_type ENUM column errors dengan validation layer:

// Enhanced ENUM validation in api/items.php
$valid_cable_types = ['distribution', 'backbone', 'drop_core', 'feeder', 'branch'];
$item_cable_type = $_POST['item_cable_type'] ?? '';

if (empty($item_cable_type) || !in_array($item_cable_type, $valid_cable_types)) {
    $item_cable_type = 'distribution'; // Safe default
}

✅ Form Improvements:

• Default Values: All ENUM fields have safe defaults
• Client-side Validation: JavaScript validation before submit
• Server-side Sanitization: PHP validation dengan fallback values
• Enhanced Error Messages: User-friendly error descriptions

Auto Monitoring System:

Background Monitoring Process:

File: auto_monitor.php - Automated device monitoring dengan cron job support:

// Auto monitoring features:
- Device discovery dari database
- Real-time ping status updates  
- Monitoring logs untuk historical analysis
- Failed device notifications
- Status change tracking

Setup Auto Monitoring:

# Run inside Docker container
docker-compose exec ftthsnms_app php auto_monitor.php

# Setup cron job (outside container)
crontab -e
# Add: */5 * * * * cd /path/to/ftthsnms && docker-compose exec -T ftthsnms_app php auto_monitor.php

Testing & Debug Tools:

Built-in Test Scripts:

API Testing Examples:

# Test single host ping
curl "http://localhost:8081/api/ping_monitor.php?action=ping_single&host=8.8.8.8"

# Test monitoring API  
curl "http://localhost:8081/api/monitoring.php?action=check_all"

# Test items API
curl -X POST "http://localhost:8081/api/items.php" \
  -d "action=create&name=Test&item_type=1&latitude=-6.2&longitude=106.8"

Performance Improvements:

Optimizations Implemented:

• ⚡ Faster Ping Response: Socket connections average 50-100ms vs 3000ms+ timeouts
• 🔄 Parallel Processing: Multiple device monitoring in batches
• 💾 Optimized Database: Cleaned schema, removed redundant data
• 🚀 Enhanced PHP Config: Increased memory limits, execution time
• 📊 Better Error Handling: Graceful failure recovery

Monitoring Success Rates:

Documentation Updates:

New Documentation Files:

• 📚 TUTORIAL_DOCKER_FTTHSNMS.md - Complete Docker installation guide (669 lines)
• 🔧 PING_MONITORING_SOLUTION.md - Detailed ping monitoring fix documentation
• 📊 DATABASE_ANALYSIS.md - Database optimization dan clean-up analysis
• 🚨 FIX_CABLE_TYPE_ENUM_ISSUE.md - ENUM validation fixes
• 💡 SOLUSI_MASALAH_PENYIMPANAN.md - Data saving issues resolution

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

📚 Dokumentasi Teknis

Documentation Files Overview:

Debug & Testing Files:

Database Documentation:

🔹 Schema Files:

• database.sql (15KB, 414 lines) - CLEAN VERSION - Optimized schema dengan validated structure
• database_backup_original.sql (52KB, 1140 lines) - Original backup dengan full data
• database_fixed.sql (51KB, 1120 lines) - Fixed version dengan relationship corrections

🔹 Database Improvements Implemented:

• ✅ Foreign Key Optimization: Removed circular dependencies
• ✅ Data Cleanup: Reduced INSERT statements dari 1000+ ke 13 essential records
• ✅ ENUM Validation: Added proper validation untuk item_cable_type
• ✅ MySQL Compatibility: Added proper SQL_MODE dan FOREIGN_KEY_CHECKS settings
• ✅ Performance Optimization: Indexed foreign keys untuk faster queries

Docker Configuration:

🐳 Docker Files:

API Documentation:

🔹 Enhanced API Endpoints:

• api/ping_monitor.php - Multi-method ping monitoring dengan fallback
• api/monitoring.php - Device monitoring dengan enhanced error handling
• api/items.php - Item management dengan ENUM validation
• api/vlans.php - VLAN management untuk server integration
• api/sync_olt_odc_data.php - OLT-ODC-ODP synchronization

🔹 API Testing Examples:

# Test ping monitoring
curl "http://localhost:8081/api/ping_monitor.php?action=ping_single&host=8.8.8.8"

# Test device monitoring
curl "http://localhost:8081/api/monitoring.php?action=check_all"

# Create new item dengan validation
curl -X POST "http://localhost:8081/api/items.php" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "action=create&name=Test-OLT&item_type=1&latitude=-6.2&longitude=106.8&item_cable_type=distribution"

# Test VLAN API
curl "http://localhost:8081/api/vlans.php?action=list"

Troubleshooting Resources:

🔹 Debug Commands:

# Check Docker status
docker-compose ps
docker-compose logs ftthsnms_app

# Test database connection
docker-compose exec mysql mysql -u ftthsnms_user -pftthsnms123 -e "SHOW DATABASES;"

# Test application endpoints
curl -I http://localhost:8081/
curl http://localhost:8081/debug_database_connection.php

# Monitor real-time logs
docker-compose logs -f --tail=50

# Check PHP configuration
docker-compose exec ftthsnms_app php -i | grep -E "(version|extension)"

🔹 Common Issues & Solutions:

Performance Benchmarks:

Learning Resources:

🔹 Recommended Reading Order:

1. New Users: Start dengan TUTORIAL_DOCKER_FTTHSNMS.md untuk quick setup
2. Installation Issues: Check SOLUSI_MASALAH_PENYIMPANAN.md
3. Monitoring Problems: Read PING_MONITORING_SOLUTION.md
4. Database Issues: Consult DATABASE_ANALYSIS.md
5. Form Errors: Reference FIX_CABLE_TYPE_ENUM_ISSUE.md
6. Advanced Setup: Explore DOCKER_README.md

🔹 External Resources:

• Docker Documentation: docs.docker.com
• MySQL Documentation: dev.mysql.com/doc
• PHP Documentation: php.net/docs
• FTTH Standards: ITU-T G.984 series untuk GPON specifications