From 23806a502321ee5ef4d8c30dc417aa106e3e343d Mon Sep 17 00:00:00 2001 From: cschantz Date: Thu, 20 Nov 2025 00:21:55 -0500 Subject: [PATCH] CRITICAL FIX: Correct InterWorx database prefix pattern (verified from official docs) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- REFDB_FORMAT.txt | 31 ++++++++++++++++++------------- 1 file changed, 18 insertions(+), 13 deletions(-) diff --git a/REFDB_FORMAT.txt b/REFDB_FORMAT.txt index 96cb8bd..5509cb4 100644 --- a/REFDB_FORMAT.txt +++ b/REFDB_FORMAT.txt @@ -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)