cschantz/Linux-Server-Management-Toolkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0fa5676bacf3ebf18369470969ce133145335120
Linux-Server-Management-Too…/README.md
T
cschantz fccb714cce Update documentation for MySQL restore tool and backup module 
Main README.md:
- Added mysql-restore-to-sql.sh to directory structure
- Created dedicated Backup & Recovery section with subsections
- Documented MySQL restore tool features:
  - Multi-control panel support
  - Intelligent Force Recovery detection
  - Safe selective restore capabilities
  - Safety features (disk space, directory protection, warnings)
  - Clean SQL export functionality
- Added MySQL restore usage example
- Updated Recent Updates section with new tool features

modules/backup/README.md (NEW):
- Comprehensive documentation for backup module
- Acronis Cyber Protect integration section:
  - All 16 scripts documented with purposes
  - Usage examples and features
- MySQL/MariaDB Database Restore Tool section:
  - Key features and capabilities
  - Control panel path support details
  - Force Recovery levels explained
  - Smart detection for selective restore
  - Use cases and safety guarantees
  - Step-by-step wizard documentation
  - Technical details (second instance, file requirements)
  - Error detection and recovery procedures
- Integration with launcher documented
- Requirements and recent updates listed

Documentation Status:
- Main README updated with new tool
- Backup module README created from scratch
- All recent changes documented (InterWorx paths, smart detection, etc.)
- Ready for user testing
2025-12-10 23:07:11 -05:00

300 lines
13 KiB
Markdown
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-backup-manager.sh # Main backup management menu (Acronis Cyber Protect)
│ │ ├── 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
│ │ └── mysql-restore-to-sql.sh # Advanced 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:**
```bash
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:
```bash
source /root/linux-server-management-toolkit/run.sh
```
## ✨ Key Features
### 🛡️ Security & Threat Analysis
- **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 Integration
- **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
#### MySQL/MariaDB Database Restore Tool (NEW!)
- **Advanced Database Recovery**: Restore individual databases from file-based backups (Acronis, raw file backups)
- **Multi-Control Panel Support**: Automatic path detection for cPanel, InterWorx, Plesk, standalone
- **Intelligent Force Recovery**: Smart detection for missing tablespace files from other databases
- **Safe Selective Restore**: Restore single database from full backup without data loss
- **Guided Recovery Process**: Step-by-step wizard with automatic error detection
- **Safety Features**: Disk space validation, critical directory protection, recovery level warnings
- **Clean SQL Export**: Dumps restored database to clean SQL file for import into production
### 🌐 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
### Security Analysis with Live Monitoring
```bash
bash launcher.sh
# Select: Security & Threat Analysis
# Select: Live Monitoring & Alerts
# Select: Live Network Security Monitor
```
### Enable cPHulk with CSF Whitelist
```bash
bash launcher.sh
# Select: Security & Threat Analysis
# Select: Security Actions & Fixes
# Select: Authentication Security
# 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
```
### MySQL Database Restore & Recovery
```bash
bash launcher.sh
# Select: Backup & Recovery
# Select: MySQL/MariaDB Database Restore to SQL
# Follow guided wizard:
# 1. Provide backup files (ibdata1, ib_logfile*, database folders)
# 2. Select database to restore
# 3. Configure MySQL settings
# 4. Choose Force Recovery level (with intelligent recommendations)
# 5. Restore and dump to clean SQL file
```
### 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
bash launcher.sh
# Select: System Diagnostics
# Select: System Health Check
```
### Loadwatch System Health Analysis
```bash
bash launcher.sh
# Select: Performance & Diagnostics
# Select: Loadwatch Health Analyzer
# Choose time range: 1h, 6h, 24h, 7d, or 30d
```
## 🔧 Configuration
Edit the configuration file:
```bash
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.2)
### Multi-Control Panel Support (NEW!)
- ✅ 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)
- ✅ 38/38 modules refactored for multi-panel architecture (100% complete)
- ✅ Automated validation scripts for InterWorx and Plesk (13 and 15 tests)
- ✅ All critical paths verified on production systems
### System Detection & Abstraction
- ✅ Automatic control panel detection (system-detect.sh)
- ✅ Multi-panel user/domain management abstraction (user-manager.sh)
- ✅ Dynamic log discovery for all panel types
- ✅ Panel-specific path handling (docroots, logs, configs)
- ✅ Zero hardcoded paths - all detection-based
### 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
- ✅ Protection plan management and scheduling
- ✅ MySQL/MariaDB database restore tool with intelligent recovery (NEW!)
- ✅ Multi-control panel support for database restoration paths
- ✅ Smart detection for Force Recovery Level selection
- ✅ Safe selective database restore from full backups
### Website Diagnostics
- ✅ Comprehensive website error analyzer (multi-panel)
- ✅ 500 error tracking and troubleshooting (multi-panel)
- ✅ Multi-log integration (Apache, PHP-FPM, all panels)
- ✅ Smart error detection and recommendations
### Security Enhancements
- ✅ Bot analyzer with multi-panel log discovery
- ✅ Live attack monitor supporting all control panels
- ✅ Malware scanner with panel-aware docroot detection
- ✅ Centralized IP reputation tracking
- ✅ Real-time threat detection and classification
### Core Infrastructure
- ✅ Modular architecture with organized category structure
- ✅ Reference database for cross-module intelligence
- ✅ Comprehensive developer documentation (REFDB_FORMAT.txt)
- ✅ Production validation complete for all major panels
## 🙏 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
Reference in New Issue View Git Blame Copy Permalink