CRITICAL FIX: Correct InterWorx database prefix pattern (verified from official docs)

DOCUMENTATION CORRECTION - VERIFIED FROM INTERWORX DOCS:

Database Prefix Pattern:
-  OLD (WRONG): InterWorx uses first8charsOfDomain_dbname
-  NEW (CORRECT): InterWorx uses username_dbname (SAME AS CPANEL!)

Source: https://appendix.interworx.com/current/siteworx/mysql/database-guide.html

Official InterWorx Documentation States:
"All databases created in SiteWorx will be prefixed by the SiteWorx
account unix username."

This means:
- cPanel: username_dbname
- InterWorx: username_dbname (SAME!)
- Plesk: no prefix (TBD)

ALSO VERIFIED FROM OFFICIAL DOCS:

File System Structure:
 Home: /home/USERNAME/
 Docroot: /home/USERNAME/DOMAIN/html/
 Access logs: /home/USERNAME/var/DOMAIN/logs/transfer.log
 Error logs: /home/USERNAME/var/DOMAIN/logs/error.log

Source: https://appendix.interworx.com/current/nodeworx/general/other/log-file-locations.html

IMPACT:
- Our CODE doesn't use database prefixes, so scripts still work correctly
- Only DOCUMENTATION was wrong
- Updated REFDB_FORMAT.txt and .sysref

RESOLVED UNKNOWNS:
-  InterWorx database prefix pattern
-  InterWorx file system paths
-  InterWorx log locations

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
cschantz
2025-11-20 00:21:55 -05:00
parent d5cf9a10c3
commit 10020ab900
+18 -13
View File
@@ -762,8 +762,8 @@ paths:
# CRITICAL DATABASE PREFIX PATTERN (MOST IMPORTANT!)
database_prefixes:
cpanel: username_dbname
interworx: first8charsOfDomain_dbname # NOT username!
plesk: no prefix
interworx: username_dbname # SAME AS CPANEL! (verified from official docs)
plesk: no prefix (TBD - needs verification)
# Module Classification System
classes:
@@ -862,10 +862,13 @@ commits:
critical_interworx_verification:
filesystem:
- Home: /home/USERNAME/
- Docroot: /home/USERNAME/DOMAIN/html/
- Access logs: /home/USERNAME/var/DOMAIN/logs/access_log
- Error logs: /home/USERNAME/var/DOMAIN/logs/error_log
- VERIFIED Home: /home/USERNAME/
- VERIFIED Docroot: /home/USERNAME/DOMAIN/html/
- VERIFIED Access logs: /home/USERNAME/var/DOMAIN/logs/transfer.log (HTTP)
- VERIFIED Access logs SSL: /home/USERNAME/var/DOMAIN/logs/transfer-ssl.log (HTTPS)
- VERIFIED Error logs: /home/USERNAME/var/DOMAIN/logs/error.log (HTTP)
- VERIFIED Error logs SSL: /home/USERNAME/var/DOMAIN/logs/error-ssl.log (HTTPS)
- Source: https://appendix.interworx.com/current/nodeworx/general/other/log-file-locations.html
domain_to_user:
- Method: grep vhost_*.conf for ServerName + SuexecUserGroup
@@ -878,9 +881,10 @@ critical_interworx_verification:
- Option 3: Check for InterWorx CLI tools
database_prefix:
- CRITICAL: Assumed first8charsOfDomain_
- Example: testdomain.com → testdoma_wp123
- MUST VERIFY on real server!
- VERIFIED: Uses username_ prefix (same as cPanel!)
- Source: https://appendix.interworx.com/current/siteworx/mysql/database-guide.html
- Example: username "testuser" → testuser_wp123, testuser_db456
- InterWorx automatically prefixes with SiteWorx account unix username
cron_management:
- Assumed: Standard Linux crontab -u username
@@ -956,10 +960,11 @@ commands_to_run_on_test_servers:
unknowns_blocking_full_support:
interworx:
- Database prefix pattern (assumed but not verified)
- Best method for user→domains lookup
- PHP version configuration method
- InterWorx CLI commands availability
- ✅ RESOLVED: Database prefix is username_ (verified from docs)
- ✅ RESOLVED: File paths all verified from official docs
- Best method for user→domains lookup (vhost parsing works)
- PHP version configuration method (non-critical)
- InterWorx CLI commands availability (optional, vhost parsing works)
plesk:
- Database prefix pattern (assumed no prefix)