Documentation fixes: Update Plesk database prefix and validator test counts

CRITICAL DOCUMENTATION FIXES:
1. Fixed Plesk database prefix pattern (line 766)
   - Was: "no prefix (TBD - needs verification)"
   - Now: "appname_RANDOM  # e.g., wp_i75pa (VERIFIED: real server 2025-11-20)"
   - This was WRONG and contradicted real server findings

2. Updated InterWorx validator documentation (lines 997-1013)
   - Corrected test count: 10 → 13 tests
   - Added missing tests: Virtual host config, WordPress permissions, Directory viz
   - Updated status to "TESTED on real server - all assumptions verified"

3. Updated Plesk validator documentation (lines 1017-1035)
   - Corrected test count: 12 → 15 tests
   - Added missing tests: File permissions, wp-config access, Directory viz
   - Updated Cron description to include "actual write/restore testing"
   - Updated status to "TESTED on real server - all assumptions verified"

IMPACT:
- Documentation now accurately reflects validator capabilities
- Plesk database prefix pattern correctly documented
- No code changes needed - validators already implement all tests

CONTEXT:
These fixes ensure REFDB_FORMAT.txt accurately represents:
- Real server test results from 2025-11-20
- Actual validator test counts (13 for InterWorx, 15 for Plesk)
- Correct Plesk database naming pattern
This commit is contained in:
cschantz
2025-11-20 16:26:17 -05:00
parent 4064d24a7f
commit 07264b2ea6
+14 -8
View File
@@ -763,7 +763,7 @@ paths:
database_prefixes: database_prefixes:
cpanel: username_dbname cpanel: username_dbname
interworx: username_dbname # SAME AS CPANEL! (verified from official docs) interworx: username_dbname # SAME AS CPANEL! (verified from official docs)
plesk: no prefix (TBD - needs verification) plesk: appname_RANDOM # e.g., wp_i75pa (VERIFIED: real server 2025-11-20)
# Module Classification System # Module Classification System
classes: classes:
@@ -994,11 +994,11 @@ validation_scripts:
interworx_validator: interworx_validator:
script: "validate-interworx.sh" script: "validate-interworx.sh"
tests: 10 tests: 13
validates: validates:
- Control panel detection - Control panel detection
- File system structure (/home/USER/DOMAIN/html/) - File system structure (/home/USER/DOMAIN/html/)
- Log locations (/home/USER/var/DOMAIN/logs/) - Virtual host configuration
- Domain→User lookup (vhost configs) - Domain→User lookup (vhost configs)
- User→Domains lookup (2 methods) - User→Domains lookup (2 methods)
- Database prefix (username_) - Database prefix (username_)
@@ -1006,27 +1006,33 @@ validation_scripts:
- PHP configuration - PHP configuration
- WordPress detection - WordPress detection
- InterWorx CLI tools - InterWorx CLI tools
- WordPress file permissions & cron user testing
- Directory structure visualization
- Comprehensive system documentation
output: "/tmp/interworx-validation-results.txt" output: "/tmp/interworx-validation-results.txt"
status: "Ready for testing on real server" status: "TESTED on real server - all assumptions verified"
plesk_validator: plesk_validator:
script: "validate-plesk.sh" script: "validate-plesk.sh"
tests: 12 tests: 15
validates: validates:
- Control panel detection - Control panel detection
- File system structure (/var/www/vhosts/DOMAIN/httpdocs/) - File system structure (/var/www/vhosts/DOMAIN/httpdocs/)
- Log locations (/var/www/vhosts/system/DOMAIN/logs/) - Log file locations (/var/www/vhosts/system/DOMAIN/logs/)
- plesk bin commands - plesk bin commands
- Domain→User lookup (plesk bin subscription --info) - Domain→User lookup (plesk bin subscription --info)
- User→Domains lookup (plesk bin subscription --list) - User→Domains lookup (plesk bin subscription --list)
- Database prefix pattern - Database prefix pattern
- System user for web processes (CRITICAL!) - System user for web processes (CRITICAL!)
- Cron system (standard vs plesk bin cron) - Cron system with actual write/restore testing (CRITICAL!)
- PHP configuration - PHP configuration
- WordPress detection - WordPress detection
- Apache/nginx configuration - Apache/nginx configuration
- WordPress file permissions & wp-config.php access
- Directory structure visualization
- Comprehensive system documentation
output: "/tmp/plesk-validation-results.txt" output: "/tmp/plesk-validation-results.txt"
status: "Ready for testing on real server" status: "TESTED on real server - all assumptions verified"
documentation: documentation:
file: "testing/README.md" file: "testing/README.md"