From 4d41056d4f5852b9b02dc7a1da99c1b27fdedb07 Mon Sep 17 00:00:00 2001 From: cschantz Date: Thu, 6 Nov 2025 22:32:09 -0500 Subject: [PATCH] Update README to v2.1.0 with complete feature documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Directory Structure Updates: - Added backup/ module (16 Acronis Cyber Protect scripts) - Added website/ module (error analysis tools) - Added maintenance/ module - Updated security/ module with IP reputation manager Key Features Additions: - Complete Acronis backup management documentation - Website diagnostics capabilities - Enhanced security features section Usage Examples: - Added Acronis backup management examples - Added website error analysis examples - Updated all examples with current menu paths Recent Updates: - Bumped version to 2.1.0 - Reorganized updates into categories - Documented all major features added since v2.0 ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- README.md | 94 ++++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 87 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 499d8fc..da58efd 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,7 @@ server-toolkit/ โ”œโ”€โ”€ README.md # This file โ”‚ โ”œโ”€โ”€ modules/ # Modular scripts organized by category +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ security/ # ๐Ÿ›ก๏ธ Security & Threat Analysis โ”‚ โ”‚ โ”œโ”€โ”€ bot-analyzer.sh # Full bot/threat analysis โ”‚ โ”‚ โ”œโ”€โ”€ live-attack-monitor.sh # Real-time attack monitoring dashboard @@ -17,15 +18,40 @@ server-toolkit/ โ”‚ โ”‚ โ”œโ”€โ”€ 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 Cyber Protect) +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-backup-manager.sh # Main backup management menu +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-install.sh # Install Acronis agent +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-update.sh # Update Acronis agent +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-uninstall.sh # Uninstall Acronis agent +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-register.sh # Register agent with cloud +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-configure.sh # Configure agent settings +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-agent-status.sh # Comprehensive agent status check +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-trigger-backup.sh # Trigger manual backups with optimizations +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-backup-status.sh # Check backup job status +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-list-backups.sh # List all backups +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-plan-manager.sh # Manage protection plans +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-schedule-viewer.sh # View backup schedules +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-restore.sh # Restore from backup +โ”‚ โ”‚ โ”œโ”€โ”€ acronis-logs.sh # View Acronis logs +โ”‚ โ”‚ โ””โ”€โ”€ acronis-troubleshoot.sh # Troubleshoot common issues +โ”‚ โ”‚ +โ”‚ โ”œโ”€โ”€ website/ # ๐ŸŒ Website Diagnostics & Troubleshooting +โ”‚ โ”‚ โ”œโ”€โ”€ website-error-analyzer.sh # Comprehensive website error analysis +โ”‚ โ”‚ โ””โ”€โ”€ 500-error-tracker.sh # Track and analyze 500 errors +โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ diagnostics/ # ๐Ÿ” System Diagnostics โ”‚ โ”‚ โ””โ”€โ”€ system-health-check.sh # Comprehensive health analysis โ”‚ โ”‚ -โ”‚ โ””โ”€โ”€ performance/ # ๐Ÿ“Š Performance Analysis -โ”‚ โ”œโ”€โ”€ hardware-health-check.sh # Hardware diagnostics -โ”‚ โ”œโ”€โ”€ mysql-query-analyzer.sh # MySQL performance analysis -โ”‚ โ””โ”€โ”€ network-bandwidth-analyzer.sh # Network analysis +โ”‚ โ”œโ”€โ”€ performance/ # ๐Ÿ“Š Performance Analysis +โ”‚ โ”‚ โ”œโ”€โ”€ hardware-health-check.sh # Hardware diagnostics +โ”‚ โ”‚ โ”œโ”€โ”€ mysql-query-analyzer.sh # MySQL performance analysis +โ”‚ โ”‚ โ””โ”€โ”€ network-bandwidth-analyzer.sh # Network analysis +โ”‚ โ”‚ +โ”‚ โ””โ”€โ”€ maintenance/ # ๐Ÿงน System Maintenance +โ”‚ โ””โ”€โ”€ cleanup-toolkit-data.sh # Clean temporary toolkit data โ”‚ โ”œโ”€โ”€ lib/ # Shared libraries โ”‚ โ”œโ”€โ”€ common-functions.sh # Reusable functions @@ -64,8 +90,24 @@ bash /root/server-toolkit/launcher.sh - **3-Mode Security Menu**: Analysis / Actions / Live Monitoring - **Live Attack Monitor**: Real-time SOC dashboard with threat classification - **Intelligent cPHulk Setup**: Auto-imports CSF whitelists from all sources +- **IP Reputation Tracking**: Centralized cross-module IP intelligence - **Multi-Source Monitoring**: SSH, Web, Firewall, cPHulk integration +### ๐Ÿ’พ Backup & Recovery (Acronis Cyber Protect) +- **Complete Agent Management**: Install, update, uninstall, register +- **Comprehensive Status Monitoring**: Agent health, registration, cloud connectivity +- **Manual Backup Triggering**: CLI-managed plans with performance optimizations +- **Backup Type Selection**: Full, Incremental, Differential backups +- **Plan Management**: View, enable/disable, delete protection plans +- **Restore Operations**: Full restore capabilities from backups +- **Troubleshooting Tools**: Log viewing and automated diagnostics + +### ๐ŸŒ 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 - **Comprehensive Health Checks**: Hardware, services, security posture - **Smart Recommendations**: Context-aware suggestions based on findings @@ -97,6 +139,25 @@ bash launcher.sh # Select: Enable cPHulk Protection ``` +### Acronis Backup Management + +```bash +bash launcher.sh +# Select: Backup & Recovery +# Select: Check Agent Status (view health, registration, connectivity) +# Select: Trigger Manual Backup (with type selection and optimizations) +# Select: Manage Protection Plans +``` + +### Website Error Analysis + +```bash +bash launcher.sh +# Select: Website Diagnostics & Troubleshooting +# Select: Website Error Analyzer +# Choose a cPanel user account to analyze +``` + ### System Health Check ```bash @@ -119,14 +180,33 @@ nano /root/server-toolkit/config/settings.conf - **No sensitive data in repo**: .gitignore excludes keys, tokens, credentials - **Test first**: Try on non-production environments first -## ๐Ÿ“Š Recent Updates (v2.0) +## ๐Ÿ“Š Recent Updates (v2.1) +### Backup & Recovery +- โœ… Complete Acronis Cyber Protect integration (16 management scripts) +- โœ… Agent installation, registration, and update automation +- โœ… Comprehensive status monitoring (health, registration, connectivity) +- โœ… Manual backup triggering with performance optimizations +- โœ… Backup type selection (Full/Incremental/Differential) +- โœ… Protection plan management and scheduling + +### Website Diagnostics +- โœ… Comprehensive website error analyzer +- โœ… 500 error tracking and troubleshooting +- โœ… Multi-log integration (Apache, PHP-FPM, cPanel) +- โœ… Smart error detection and recommendations + +### Security Enhancements +- โœ… Centralized IP reputation tracking across modules - โœ… Complete security menu restructure (3-mode hierarchy) - โœ… Live network security monitoring dashboard - โœ… Intelligent cPHulk enablement with multi-source CSF whitelist discovery - โœ… Real-time threat detection and classification + +### Core Infrastructure - โœ… Reference database for cross-module intelligence -- โœ… Git repository integration +- โœ… Git repository integration with auto-commit workflows +- โœ… Modular architecture with organized category structure ## ๐Ÿ™ Credits @@ -134,5 +214,5 @@ Built for comprehensive cPanel/Linux server management with a focus on security --- -**Version**: 2.0.0 +**Version**: 2.1.0 **Repository**: https://git.mull.lol/cschantz/Linux-Server-Management-Toolkit