cschantz
448f1ed1d5
Issue: All completed scans showing as "RUNNING" in status check User reported 5 scans showing RUNNING when they actually completed hours ago, with 0 scans showing as COMPLETED despite being done. Root Cause: Line 1851 used: `pgrep -f "$dir/scan.sh"` This pattern matches ANY process with that path in its command line: - The actual scan.sh process (correct) - Shell sessions viewing results (false positive) - Editors/viewers with the file open (false positive) - grep/tail commands on logs (false positive) - Any process that touched those files (false positive) This caused completed scans to always show as "RUNNING" because there were always SOME processes matching the overly broad pattern. Evidence from User's Status Check: malware-20251222-202658 [RUNNING] Latest: "Scan session ended - opening interactive shell" Scan says "ended" but status shows RUNNING - clear false positive! Solution - Two-part Fix: 1. Use More Specific Process Match: Changed from: pgrep -f "$dir/scan.sh" Changed to: pgrep -f "bash $dir/scan.sh" This only matches actual bash execution of the script, not viewers, editors, or other processes. 2. Add Marker File for Reliability: Create .scan_running marker when scan starts Remove .scan_running marker when scan exits (in cleanup trap) Status check: pgrep OR marker file = running This handles edge cases where process check might fail but provides definitive state tracking. Changes: 1. check_standalone_status() (line 1852): - Added "bash " prefix to pgrep pattern - Added OR check for .scan_running marker file - Both in running detection and delete listing 2. Standalone scan.sh template (lines 655, 607): - Create marker: touch "$SCAN_DIR/.scan_running" after start - Remove marker: rm -f "$SCAN_DIR/.scan_running" in cleanup_on_exit 3. delete_standalone_sessions() (line 1917): - Same pgrep + marker file logic for consistency Result: Now completed scans will correctly show [COMPLETED] status instead of falsely showing [RUNNING] due to viewer processes. Status detection is now accurate and reliable!
⚡ Linux Server Management Toolkit
Comprehensive multi-panel server management suite supporting cPanel, InterWorx, Plesk, and standalone Apache with modular architecture and intelligent security features.
📦 Directory Structure
server-toolkit/
├── launcher.sh # Main menu system
├── README.md # This file
│
├── modules/ # Modular scripts organized by category
│ │
│ ├── diagnostics/ # 🔍 System Diagnostics
│ │ ├── system-health-check.sh # Comprehensive health analysis
│ │ └── loadwatch-analyzer.sh # Historical system health analysis
│ │
│ ├── security/ # 🛡️ Security & Monitoring
│ │ ├── bot-analyzer.sh # Full bot/threat analysis
│ │ ├── live-attack-monitor.sh # Real-time attack monitoring dashboard
│ │ ├── ssh-attack-monitor.sh # SSH brute force detection
│ │ ├── web-traffic-monitor.sh # Web traffic monitoring
│ │ ├── firewall-activity-monitor.sh # CSF/iptables monitoring
│ │ ├── enable-cphulk.sh # cPHulk enablement with CSF whitelist import
│ │ ├── ip-reputation-manager.sh # Centralized IP reputation tracking
│ │ └── tail-*.sh # Various log monitoring scripts
│ │
│ ├── backup/ # 💾 Backup & Recovery
│ │ ├── acronis-*.sh # Acronis Cyber Protect (9 management scripts)
│ │ └── mysql-restore-to-sql.sh # MySQL/MariaDB database restore & dump tool
│ │
│ ├── website/ # 🌐 Website Diagnostics
│ │ ├── website-error-analyzer.sh # Comprehensive error analysis
│ │ ├── 500-error-tracker.sh # Fast 500 error tracking
│ │ └── wordpress/ # WordPress tools
│ │
│ ├── performance/ # 📊 Performance Analysis
│ │ ├── hardware-health-check.sh # Hardware diagnostics
│ │ ├── mysql-query-analyzer.sh # MySQL performance analysis
│ │ ├── network-bandwidth-analyzer.sh # Network analysis
│ │ ├── php-optimizer.sh # PHP Configuration Optimizer (NEW!)
│ │ └── (other performance modules)
│ │
│ └── maintenance/ # 🧹 System Maintenance
│ └── cleanup-toolkit-data.sh # Clean temporary toolkit data
│
├── lib/ # Shared libraries
│ ├── common-functions.sh # Reusable functions
│ ├── system-detect.sh # System type detection
│ ├── user-manager.sh # User account management
│ ├── mysql-analyzer.sh # MySQL utilities
│ ├── reference-db.sh # Cross-module intelligence sharing
│ ├── php-detector.sh # PHP configuration detection (NEW!)
│ ├── php-analyzer.sh # PHP performance analysis engine (NEW!)
│ └── php-config-manager.sh # PHP config backup/restore/modification (NEW!)
│
├── config/ # Configuration files
│ ├── settings.conf # Main configuration
│ ├── whitelist-ips.txt # IP whitelist
│ └── whitelist-user-agents.txt # User-Agent whitelist
│
└── tools/ # Utility scripts
├── diagnostic-report.sh # Generate system reports
└── test-*.sh # Testing utilities
🚀 Quick Start
Installation & Running
One command - automatic cleanup:
curl -sL https://git.mull.lol/cschantz/Linux-Server-Management-Toolkit/archive/main.tar.gz | tar xz && source linux-server-management-toolkit/run.sh
When exiting (option 0), answer "yes" and cleanup happens automatically - no extra steps.
Or if already downloaded:
source /root/linux-server-management-toolkit/run.sh
✨ Key Features
🛡️ Security & Monitoring
- Bot & Traffic Analyzer: Full bot/threat analysis with pattern detection
- Live Attack Monitor: Real-time SOC dashboard with threat classification
- Specialized Monitors: SSH attacks, web traffic, firewall activity
- IP Reputation Manager: Centralized cross-module IP intelligence with query/tracking
- Malware Scanner: ImunifyAV, ClamAV, and Maldet integration
- cPHulk Integration: Auto-imports CSF whitelists from all sources
- Log Viewers: Live tail for Apache access/error, mail, and security logs
- Optimized Status Checks: Uses cached domain status (no redundant HTTP requests)
💾 Backup & Recovery
- Acronis Cyber Protect: Complete agent management (install, update, configure, monitor, troubleshoot)
- MySQL Database Restore Tool: Advanced recovery from file-based backups with intelligent Force Recovery
- Multi-control panel support (cPanel, InterWorx, Plesk, standalone)
- Smart detection for selective restore scenarios
- Safe single-database extraction from full backups
- Clean SQL export for production import
🌐 Website Diagnostics
- Error Analysis: Comprehensive website error detection and troubleshooting
- 500 Error Tracking: Detailed analysis of application errors
- Log Integration: Apache, PHP-FPM, cPanel error log analysis
- Smart Recommendations: Context-aware suggestions for fixing issues
🔍 Performance & Diagnostics
- System Health Check: Comprehensive hardware, services, and security posture analysis
- Loadwatch Analyzer: Historical system health analysis (1h/6h/24h/7d/30d time ranges)
- MySQL Query Analyzer: Slow query detection and optimization recommendations
- Network & Bandwidth Analyzer: Traffic analysis and top consumers
- Hardware Health Check: SMART, memory, CPU sensors
- PHP Configuration Optimizer: Per-domain PHP-FPM tuning with auto-backup and zero downtime
- Multi-Panel Support: cPanel, InterWorx, Plesk, standalone Apache
📊 Session Intelligence
- Reference Database: Cross-module data sharing (.sysref)
- No Historical Tracking: Session-based intelligence only
- "Download, Run, Fix, Delete": Designed for one-time troubleshooting
🎯 Usage Examples
Quick System Health Check
bash launcher.sh
# Select: 1) System Health Check
Security Analysis & Monitoring
bash launcher.sh
# Select: 2) Security & Monitoring
# Options:
# - Bot & Traffic Analyzer (full scan or 1-hour quick scan)
# - Live Attack Monitor (unified threat intelligence)
# - SSH/Web/Firewall attack monitors
# - IP Reputation Manager
# - Malware Scanner
# - Enable cPHulk Protection
Website Diagnostics
bash launcher.sh
# Select: 3) Website Diagnostics
# Options:
# - Website Error Analyzer (comprehensive error detection)
# - Fast 500 Error Tracker (500 errors only)
# - WordPress Tools (WP-Cron manager)
Performance Analysis
bash launcher.sh
# Select: 4) Performance Analysis
# Options:
# - MySQL Query Analyzer (slow query detection)
# - Network & Bandwidth Analyzer
# - Hardware Health Check
# - PHP Configuration Optimizer (per-domain tuning)
# - Loadwatch Health Analyzer (1h/6h/24h/7d/30d analysis)
Backup & Recovery
bash launcher.sh
# Select: 5) Backup & Recovery
# Options:
# - Acronis Management (complete backup interface)
# - MySQL File Restore (convert DB files to SQL)
🔧 Configuration
Edit the configuration file:
nano /root/server-toolkit/config/settings.conf
🔒 Security Considerations
- Run as root: Most modules require root access
- Credentials stored safely: Git credentials in ~/.git-credentials (outside project)
- No sensitive data in repo: .gitignore excludes keys, tokens, credentials
- Test first: Try on non-production environments first
📊 Recent Updates (v2.1)
December 2025 Highlights
- Launcher Cleanup: Removed 90+ phantom menu items, reduced from 1,576 to 574 lines (64% reduction)
- Performance: Cached domain status checks save ~5 minutes on 50-domain servers
- MySQL Restore Tool: Advanced database recovery with intelligent Force Recovery detection
- Multi-Panel: Full support for cPanel, InterWorx, Plesk, standalone Apache
Current Feature Set
- 41 Working Modules: Security (14), Website (3), Performance (5), Backup (11), Diagnostics (8)
- Reference Database: 1-hour cached status for cross-module intelligence
- Zero Hardcoded Paths: Automatic control panel detection and path abstraction
🙏 Credits
Built for comprehensive cPanel/Linux server management with a focus on security and intelligent automation.
Version: 2.1.0 Repository: https://git.mull.lol/cschantz/Linux-Server-Management-Toolkit