PROBLEM
I want to upgrade my atmail Server + WebMail installation to 7.8.0+.
ENVIRONMENT
- On-Premise Server + WebMail Installations: Version 7.7.1
- To upgrade to atmail 7.8.0+, please first upgrade to atmail 7.7.1.
CAUSE
Atmail needs to be upgraded to the latest version.
RESOLUTION
⚠ Atmail 7.8.0+
PHP 5.4+ required for 7.8.0+
Backup
Before proceeding it is strongly recommended that you make a backup of your current Atmail installation:
mysqldump -u root -p atmail7 > /usr/local/atmail/atmail-7[version]-backup.sql
tar cfvz atmail-7[version]-backup.tgz /usr/local/atmail /etc/httpd/conf/httpd.conf /etc/init.d/atmailserver
This is required before you upgrade in case you need to roll-back any changes, do not skip this step.
Any customization's to Atmail (PHP, HTML, Anti-Spam and MTA-related code changes) must be backed up. The upgrade process will overwrite any modifications, and these must be merged in after the upgrade.
Upgrade atmail 7.7.1 > atmail 7.8.0+
- Download the latest atmail tarball via your customer portal downloads section.
https://atmail.com/portal2/
- Extract the software out into the directory for Atmail
tar xfvz atmail7.mailserver.tgz -C /usr/local/
- You will now need to give Atmail correct permissions.
chown atmail:atmail /usr/local/atmail/;
chown -R atmail:atmail /usr/local/atmail/webmail;
cd /usr/local/atmail/webmail/;
find . -name .htaccess -exec chown root:root {} \;
find . -name .htaccess -exec chmod 644 {} \; - RPM/Appliance Install ONLY:
mv /usr/local/atmail/mailserver/bin/atmail-update-version /usr/local/atmail/mailserver/bin/atmail-update-version.off
- Visit the WebAdmin of Atmail and use the Update software link. This will guide you through the web-based upgrade utility for the database schema updates and config changes:
e.g http://server.com/mail/index.php/admin/
Where server.com/mail/index.php is the URL of the Atmail software on your server. Login to Web Administration using your admin username/password, then click the License tab > Update software.
Note: Available Version will indicate the version available on your server. Please ensure steps previous steps are completed before moving to the WebAdmin upgrade. - Depending on the software update, additional packages may need to be re-installed or re-compiled if you are using the Email Server version of Atmail. If prompted during the Web Admin upgrade, run the additional upgrade utility from a command-line:
cd /usr/local/atmail/
php server-update.php
Troubleshooting
CentOS 7 - Postfix
If you are planning to use your newly installed RHEL/CentOS 7 to run atmail Server + WebMail edition, you will need to remove the Postifx MTA daemon, that is installed by default on RHEL/CentOS 7.
As you will notice, Postfix is started and listens on localhost on port 25. Proceed with Postfix MTA service removal by issuing the following commands.
# systemctl stop postfix
# systemctl disable postfix # yum remove postfix
Force Re-Run Upgrade
If you run into any troubles with the upgrade you may need to re-run the upgrade process.
Assuming that your last version was 7.7.1; Login to your Atmail database and execute the following command.
mysql> update Config set keyValue = "7.7.1" where keyName = "version";
This will fool the WebAdmin update scripts and enable re-running the sql schema updates via the WebAdmin > License > Update Software.
Following the success of the WebAdmin update, please then execute the server-update.php file as the update page will instruct you.
php server-update.php 7.7.1
Comments