cschantz/Linux-Server-Management-Toolkit

Files

T

cschantz 10d5bc93ab Reduce Acronis documentation verbosity in README

Changes:
- Condensed Backup & Recovery section from 14 lines to 5 lines
- Removed detailed Acronis sub-bullets (was overstated)
- Condensed directory structure: 15 Acronis script lines → 1 line
- Balanced coverage between Acronis and MySQL restore tool
- Kept essential info without excessive detail

Before: 14 bullet points for Acronis
After: 1 line for Acronis, cleaner overview

2025-12-11 16:48:59 -05:00

12 KiB

Raw Blame History

⚡ 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       # System health from loadwatch monitoring logs
│   │
│   ├── security/                        # 🛡️ Security & Threat Analysis
│   │   ├── 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 & Troubleshooting
│   │   ├── website-error-analyzer.sh   # Comprehensive website error analysis
│   │   └── 500-error-tracker.sh        # Track and analyze 500 errors
│   │
│   ├── diagnostics/                     # 🔍 System Diagnostics & Log Analysis
│   │   ├── system-health-check.sh      # Comprehensive health analysis
│   │   └── loadwatch-analyzer.sh       # System health monitoring from loadwatch logs
│   │
│   ├── 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

🔍 System Diagnostics & Performance Monitoring

Comprehensive Health Checks: Hardware, services, security posture
Loadwatch Health Analyzer: Historical system health analysis from monitoring logs
- Time-range analysis: 1h, 6h, 24h, 7d, 30d
- Memory pressure detection and swap usage trending
- CPU saturation analysis (idle, iowait, steal time)
- Process issue detection (zombies, high CPU/MEM consumers)
- MySQL performance monitoring
- Actionable recommendations based on findings
PHP Configuration Optimizer (NEW!): Per-domain PHP optimization
- Analyzes PHP-FPM pool configurations across all domains
- Detects max_children issues from 7-day error log history
- OPcache hit rate analysis and tuning recommendations
- Memory limit optimization based on actual usage
- Auto-backup before changes with rollback capability
- Graceful PHP-FPM reload for zero downtime
- Supports cPanel, InterWorx, Plesk, standalone Apache
Smart Recommendations: Context-aware suggestions based on findings
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 - Major Cleanup & Optimization

Launcher Streamlined (NEW!)

✅ Removed 90+ phantom menu items pointing to non-existent scripts
✅ Reduced from 1,576 lines to 574 lines (64% reduction)
✅ Cleaned up 7-level nested menus to 3 levels maximum
✅ Every menu item now points to a real, working script
✅ Faster navigation and no more "module not found" errors
✅ Main menu: 6 categories, 41 total working options

Performance Optimizations

✅ Bot analyzer now uses cached domain status (eliminates redundant HTTP checks)
✅ Saves ~5 minutes on 50-domain servers (no more curl requests per check)
✅ All modules use centralized reference database for domain status
✅ 1-hour cache prevents wasteful re-checking

MySQL/MariaDB Database Restore Tool

✅ Advanced database recovery from file-based backups
✅ Multi-control panel support (cPanel, InterWorx, Plesk, standalone)
✅ Intelligent Force Recovery with smart detection
✅ Safe selective restore (single DB from full backup, zero data loss)
✅ InterWorx path fix (/chroot/home instead of /home symlink)
✅ SQL output saved to restore directory parent (not control panel dirs)
✅ Safety features: disk space validation, directory protection, recovery warnings

Documentation Updates

✅ Main README updated with streamlined menu structure
✅ New modules/backup/README.md (comprehensive backup tools documentation)
✅ Updated usage examples to match new launcher
✅ All recent features documented

Multi-Control Panel Support

✅ Full cPanel support (primary platform - production ready)
✅ InterWorx support (validated on real servers - production ready)
✅ Plesk support (validated on real servers - production ready)
✅ Standalone Apache support (basic functionality)
✅ 41 modules refactored for multi-panel architecture
✅ All critical paths verified on production systems

Core Features Implemented

Security & Monitoring (14 tools)

Bot & Traffic Analyzer (full + quick scan)
Live Attack Monitor + 3 specialized monitors
IP Reputation Manager
Malware Scanner
4x Log tail viewers
cPHulk enablement
CT_LIMIT optimization

Website Diagnostics (3 tools)

Website Error Analyzer
Fast 500 Error Tracker
WordPress Tools (WP-Cron manager)

Performance Analysis (5 tools)

MySQL Query Analyzer
Network & Bandwidth Analyzer
Hardware Health Check
PHP Configuration Optimizer
Loadwatch Health Analyzer

Backup & Recovery (11 tools)

Complete Acronis Cyber Protect integration (9 scripts)
MySQL/MariaDB database restore
Cleanup toolkit data

System Infrastructure

✅ Reference database for cross-module intelligence (.sysref with 1-hour cache)
✅ Automatic control panel detection (system-detect.sh)
✅ Multi-panel user/domain management (user-manager.sh)
✅ Cached domain status checks (eliminates redundant HTTP requests)
✅ Zero hardcoded paths - all detection-based

🙏 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

12 KiB Raw Blame History