cschantz/Linux-Server-Management-Toolkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
234 Commits 2 Branches 0 Tags
f20c0edf2b97b645e76f55166ef01422f7975cd8
Commit Graph

3 Commits

Author SHA1 Message Date
cschantz f20c0edf2b Phase 4: Implement backup/restore system with PHP-FPM restart capability 
NEW LIBRARY: lib/php-config-manager.sh (14 functions, 442 lines)

BACKUP FUNCTIONS:
- initialize_backup_system() - Creates /root/server-toolkit/backups/php/
- backup_php_config() - Backs up single config file with metadata
- backup_fpm_pool() - Backs up PHP-FPM pool configuration
- backup_user_php_configs() - Backs up ALL PHP configs for a user
- list_backups() - Lists all backups with metadata (date, user, domain, file count)

RESTORE FUNCTIONS:
- restore_php_config() - Restores single config file
- restore_from_backup() - Restores entire backup set
- delete_backup() - Removes old backups

CONFIGURATION MODIFICATION:
- modify_fpm_pool_setting() - Changes single FPM pool setting
- modify_php_ini_setting() - Changes single php.ini setting
- apply_fpm_pool_settings() - Applies multiple settings at once

PHP-FPM MANAGEMENT:
- restart_php_fpm() - Restarts PHP-FPM service (systemd/sysvinit)
- reload_php_fpm() - Graceful reload (no downtime)
- verify_php_fpm_running() - Checks if service is active

MENU OPTIONS B & R IMPLEMENTED:

Option B: Backup Current Configurations
  - Select domain to backup
  - Backs up all php.ini files (priority 1-4)
  - Backs up PHP-FPM pool config
  - Creates metadata.txt with timestamp, user, domain
  - Preserves directory structure
  - Shows list of backed up files
  - Backup location: /root/server-toolkit/backups/php/YYYYMMDD_HHMMSS/

Option R: Restore from Backup
  - Lists all available backups with details
  - Shows: backup name, date, username, domain, file count
  - Numbered selection menu
  - Confirmation prompt: "This will overwrite current configurations!"
  - Requires typing "yes" to proceed
  - Restores all files with metadata preservation
  - Shows success/failure for each file
  - Reminder to restart PHP-FPM

BACKUP STRUCTURE:
/root/server-toolkit/backups/php/
├── 20250102_143045/
│   ├── metadata.txt (backup info)
│   ├── opt/cpanel/ea-php82/root/etc/php-fpm.d/username.conf
│   ├── home/username/.php/8.2/php.ini
│   └── home/username/public_html/.user.ini
└── 20250102_150830/
    └── ...

SAFETY FEATURES:
- Metadata tracking (who, what, when)
- Confirmation required for restore
- Non-destructive backups (never overwrites backups)
- Timestamp-based naming (no conflicts)
- Preserves file permissions and ownership

FUTURE USE:
These functions will be used by Phase 5 (apply/action menu) to:
1. Auto-backup before applying changes
2. Rollback if changes cause issues
3. Compare current vs backed up configs
 2025-12-02 20:46:28 -05:00
cschantz 257e846685 Add server-wide memory capacity check (Option 9) - Critical OOM prevention 
NEW FEATURES:
- Menu Option 9: Check Server Memory Capacity (OOM Risk)
- Calculates total memory if ALL PHP-FPM pools hit max_children
- Identifies servers at risk of Out-Of-Memory (OOM) kills
- Provides balanced memory allocation recommendations

TWO NEW ANALYZER FUNCTIONS:

1. calculate_server_memory_capacity()
   - Iterates through all users/PHP-FPM pools
   - Calculates: max_children × avg_memory_per_process
   - Sums total across all pools
   - Compares to total RAM
   - Returns: total_required|total_ram|percentage|status

   Status Levels:
   - HEALTHY:  <60% RAM (safe)
   - CAUTION:  60-75% RAM (watch)
   - WARNING:  75-90% RAM (risky)
   - CRITICAL: >90% RAM (OOM likely!)

2. calculate_balanced_memory_allocation()
   - Analyzes traffic for each user (requests/minute)
   - Calculates proportional memory allocation
   - Reserves 20% of RAM for system (min 2GB)
   - Distributes remaining RAM based on traffic
   - Returns recommendations: REDUCE / INCREASE / OPTIMAL

   Example output:
   USER     CURRENT_MAX  AVG_MB  TRAFFIC_RPM  RECOMMENDED_MAX  REASON
   user1    50          45MB     120          75              INCREASE (traffic demands)
   user2    100         60MB     10           15              REDUCE (prevent OOM)

MENU OPTION 9 FEATURES:
- Shows total RAM vs required memory
- Displays percentage and color-coded status
- Optional per-user breakdown table
- Optional balanced recommendations
- Interactive: ask user what details to show

USE CASE:
Server has 16GB RAM. 10 users each with max_children=50, avg 50MB/process.
Total required: 10 × 50 × 50MB = 25GB
Percentage: 156% of RAM → CRITICAL!
Result: Server WILL run out of memory and kill processes!

This feature addresses user's request:
"calculating max children and memory allocation and then combining all the
 accounts to see if the memory will hit over the memory cap if at capacity"

CRITICAL for preventing OOM kills on shared hosting servers!
 2025-12-02 20:39:20 -05:00
cschantz f0d86d49cc Phase 3: Add interactive PHP Performance Optimizer (modules/performance/php-optimizer.sh) 
COMPLETE INTERACTIVE MENU SYSTEM:
- 8 main menu options for comprehensive PHP optimization
- Domain selection with PHP version display
- Real-time analysis and recommendations
- Color-coded severity levels (CRITICAL/HIGH/MEDIUM/LOW)
- Safe implementation with cecho() helper

MENU OPTIONS:
1. Analyze Single Domain - Complete PHP analysis report
2. Analyze All Domains - Server-wide analysis with issue detection
3. Quick Health Check - Overall health score based on issues
4. Optimize Domain - Detect issues + show recommendations
5. Optimize Server-Wide - (Placeholder for future)
6. View OPcache Statistics - Hit rates, memory usage, cache efficiency
7. View PHP-FPM Process Stats - Memory usage, process counts, pool config
8. Check Configuration Issues - Grouped by severity with recommendations

FEATURES IMPLEMENTED:
- Domain selection with user/PHP version context
- Comprehensive analysis using lib/php-analyzer.sh
- Issue detection with 4 severity levels
- OPcache statistics with hit rate analysis
- PHP-FPM resource usage tracking
- Optimal max_children calculations
- Health scoring system (0-100)
- Color-coded output for readability

ANALYSIS CAPABILITIES:
- PHP version detection per domain
- Configuration hierarchy display (4 priority levels)
- Effective settings resolution
- PHP-FPM pool configuration parsing
- Resource usage statistics (processes, memory)
- OPcache performance metrics
- Traffic analysis (requests/min, peak concurrent)
- Error analysis (7-day history)

ISSUE DETECTION:
- Config mismatches (post_max_size < upload_max_filesize)
- Security risks (display_errors = On)
- Performance issues (low memory_limit, OPcache disabled)
- Capacity issues (max_children errors)
- Memory leaks (pm.max_requests = 0)
- Resource waste (pm=static on low traffic)

RECOMMENDATIONS ENGINE:
- Calculates optimal pm.max_children based on:
  * System memory (total - reserved)
  * Average memory per process
  * 20% safety buffer
- OPcache optimization suggestions
- Memory limit adjustments
- Process manager mode recommendations

SAFETY FEATURES:
- Read-only analysis (no modifications yet)
- Root user check
- PHP-FPM detection with warnings
- Graceful handling of missing data
- Clear "not yet implemented" placeholders for future features

DISPLAY FEATURES:
- Formatted banners and section separators
- Color-coded severity (RED=critical, YELLOW=high, BLUE=medium, GREEN=low)
- Progress indicators for multi-domain analysis
- Summary statistics and health scores
- Grouped issue display by severity

INTEGRATION:
- Uses lib/php-detector.sh for detection (Phase 1)
- Uses lib/php-analyzer.sh for analysis (Phase 2)
- Uses lib/system-detect.sh for system detection
- Uses lib/user-manager.sh for user/domain management

NOT YET IMPLEMENTED (Future):
- Automatic configuration changes (backup/apply/restore)
- Server-wide optimization in single action
- Backup/restore functionality
- Integration with live-attack-monitor (NOT requested by user)

USAGE:
bash /root/server-toolkit/modules/performance/php-optimizer.sh

All 3 phases complete! PHP optimizer ready for testing and refinement.
 2025-12-02 20:30:44 -05:00