On Tues, Sept 12th, InterWorx version 6.14.3 will be promoted to the Release channel. This will officially remove the opt-in flag for the IW6 > IW7 upgrade for IW6 servers subscribed to the Release channel.
How it works:
For most servers, no interaction is needed. Servers subscribed to the IW6 Release channel will update to 6.14.3 when the next daily cron runs. Then, 24 hours later, when that day’s daily cron runs, if all of the pre-flight checks pass, the server will be updated to IW7. This means that most existing IW6 servers will be automatically updating to IW7 either September 13th or 14th.
Servers subscribed to the IW6 Stable channel will receive this upgrade the week of the 18th.
Things to Know
- Themes have been removed in IW7, however, it is possible to add custom branding and logos .
- There are a lot of added features and improvements in IW7 which were not pushed to IW6. A list of some of these features, with related documentation can be found here: What’s New With InterWorx, March 2023
Troubleshooting
As mentioned above, there is a pre-flight checklist that is addressed before the update to IW7 occurs. If any of the items on this checklist fail, the update will not happen. These items are:
- The httpd syntax is error free: If there are any syntax errors in Apache confs of vhosts, this will fail
- LiteSpeed is not enabled: This update cannot occur on Litespeed servers. Litespeed will either need to be disabled, or accounts will need to be migrated to a new server with IW7 installed
- CloudLinux is not enabled: This update cannot occur on servers running CloudLinux. Those accounts must be imported to a new server with IW7 installed
- The server is not part of a cluster: This update cannot occur on clustered servers. Clustering either has to be disabled/removed or accounts will need to be migrated to new servers with IW7 installed
- No custom themes are present: This item being marked as a failure should not stop the upgrade from occurring, it is just an alert that themes are removed in IW7
- The domain vhost files has not been customized: This is the preflight item most likely to fail. Because IW7 includes a new vhost template system, vhosts must be free of customization before converting to the new format can take place.
- If this step is marked Fail, run the following script at the CLI. It will provide information on any vhosts with customization that cannot be converted, and the specific information that is being flagged:
~iworx/bin/template-adopt.pex --inspect
- If this step is marked Fail, run the following script at the CLI. It will provide information on any vhosts with customization that cannot be converted, and the specific information that is being flagged:
- Yum dry run: This checks to make sure that yum is up and running
- The server is up to date: This makes sure that the server is up to date
- Server is running EOL OS version: This checks to make sure that the server is on a supported OS. The update to IW7 will not work on EL6 servers. If this fails, accounts must be migrated to a new server with IW7 installed. Supported OSes can be found here: What are the system requirements of InterWorx Control Panel? — InterWorx documentation
- Server is using Dovecot Submission: Servers will using courier for port 587 cannot be updated to IW7. The Dovecot MSA must be in use. Information on how to check if the Dovecot MSA is in use on the server, can be found here: Dovecot and php-intl required for Roundcube 1.5.3
If your server is updated to 6.14.3 and does not automatically update itself to IW7 within 24 hours:
- Check to make sure that the daily cron has run. The easiest way to check is by looking at the timestamp on
~iworx/var/last_daily. This indicates the last time the daily cron ran successfully. Example:
[root@server ~]# ls -la ~iworx/var/last_daily
-rw------- 1 root root 0 May 16 18:43 /home/interworx/var/last_daily
[root@server ~]#
- If it has been more than 24 hours since the daily cron last ran, there should be information about why it did not complete in the cron.log found at
~iworx/var/log/cron.log - Check the Preflight Checklist, which is located in NodeWorx under Server > Software Updates. Click the link for Go to Updates Page under Major Version Upgrade at the very bottom of the page. That will take you to the Preflight Checklist. Resolve any failure messages you may find there, if applicable.
If you have any questions, or run into any issues, don’t hesitate to reach out to us at https://support.interworx.com. We will be happy to assist. 
Thanks,
-Jenna
Friendly Neighborhood InterWorx Support Manager