My activities New request

contact atmail support

PH: +61 (7) 5357-6605

support@atmail.com

Follow

atmail mail server upgrade guide

Dominic -

PROBLEM

How can I upgrade my atmail mail server installation?

ENVIRONMENT

  • atmail mail server

CAUSE

Atmail needs to be upgraded to the latest version.

RESOLUTION

Keeping your atmail installation up-to-date should be prioritised so your system can benefit from our latest technologies and security features. You can find all the latest and greatest changes in the changelog.

Pre-Upgrade Tasks

  1. Ascertain current version.
    [root@a8 ~]# rpm -qa atmail-mailserver
    atmail-mailserver-1.0.0-1.el7.centos.x86_64
  2. Backup database.
    [root@a8 ~]# mysqldump -u root -p mailserver > mailserver-[version].sql
  3. Backup mailserver. For your convenience the following command will create a mailserver-version_date.tgz
    [root@a8 ~]# tar cfvz mailserver-`rpm -qa atmail-mailserver | sed 's/-/ /g' | awk '{print $3}'`_`date +"%Y%m%d"`.tgz /etc/atmail/mailserver /etc/nginx/conf.d/atmail-mailserver.locations /var/lib/atmail/mailserver /var/lib/atmail/dovecot /usr/share/atmail/mailserver/
    -rw-r--r--. 1 root root 10476305 Jul 21 13:02 mailserver-1.0.0_20170721.tgz

This is required before you upgrade in case you need to roll-back any changes, please do not skip this step.

Upgrade your atmail mail server.

  1. You can download your latest atmail mail server by directly accessing your customer portal or by following the advertised link from your mail server webadmin interface.
  2. Extract the atmail-mailserver-rpm.tar.gz package. 
    [root@a8 tmp]# tar xvzf atmail-mailserver-rpm.tar.gz 
    atmail-mailserver/
    atmail-mailserver-[version]/atmail-dav[version].el7.centos.x86_64.rpm
    atmail-mailserver-[version]/dovecot-pigeonhole[version].atmail.el7.centos.x86_64.rpm
    atmail-mailserver-[version]/atmail-mailserver[version].el7.centos.x86_64.rpm
    atmail-mailserver-[version]/dovecot-mysql[version].atmail.el7.centos.x86_64.rpm
    atmail-mailserver-[version]/atmail-common[version].el7.centos.x86_64.rpm
    atmail-mailserver-[version]/atmail-mailserver-plugin-WebmailIntegration[version].el7.centos.x86_64.rpm
    atmail-mailserver-[version]/dovecot[version].atmail.el7.centos.x86_64.rpm
  3. Enter the atmail-mailserver directory.
    [root@a8 tmp]# cd atmail-mailserver-[version]
    [root@a8 atmail-mailserver-[version]
  4. Upgrade your rpm's using yum. The use of the wildcard (*) in the working directory will allow yum to determine which specific rpm's will be upgraded. In this case, you can see only the mailserver and mailserver-plugin-WebmailIntegration rpm's will be upgraded.
    [root@a8 atmail-mailserver-1.0.1]# yum update *.rpm
    Loaded plugins: fastestmirror
    Repodata is over 2 weeks old. Install yum-cron? Or run: yum makecache fast
    Examining atmail-common-1.0.0-1.el7.centos.x86_64.rpm: atmail-common-1.0.0-1.el7.centos.x86_64
    atmail-common-1.0.0-1.el7.centos.x86_64.rpm: does not update installed package.
    Examining atmail-mailserver-1.0.1-1.el7.centos.x86_64.rpm: atmail-mailserver-1.0.1-1.el7.centos.x86_64
    Marking atmail-mailserver-1.0.1-1.el7.centos.x86_64.rpm as an update to atmail-mailserver-1.0.0-1.el7.centos.x86_64
    Examining atmail-mailserver-plugin-WebmailIntegration-1.0.1-1.el7.centos.x86_64.rpm: atmail-mailserver-plugin-WebmailIntegration-1.0.1-1.el7.centos.x86_64
    Marking atmail-mailserver-plugin-WebmailIntegration-1.0.1-1.el7.centos.x86_64.rpm as an update to atmail-mailserver-plugin-WebmailIntegration-1.0.0-1.el7.centos.x86_64
    Examining dovecot-2.2.19-1.atmail.el7.centos.x86_64.rpm: 1:dovecot-2.2.19-1.atmail.el7.centos.x86_64
    dovecot-2.2.19-1.atmail.el7.centos.x86_64.rpm: does not update installed package.
    Examining dovecot-mysql-2.2.19-1.atmail.el7.centos.x86_64.rpm: 1:dovecot-mysql-2.2.19-1.atmail.el7.centos.x86_64
    dovecot-mysql-2.2.19-1.atmail.el7.centos.x86_64.rpm: does not update installed package.
    Examining dovecot-pigeonhole-2.2.19-1.atmail.el7.centos.x86_64.rpm: 1:dovecot-pigeonhole-2.2.19-1.atmail.el7.centos.x86_64
    dovecot-pigeonhole-2.2.19-1.atmail.el7.centos.x86_64.rpm: does not update installed package.
    Resolving Dependencies
    --> Running transaction check
    ---> Package atmail-mailserver.x86_64 0:1.0.0-1.el7.centos will be updated
    ---> Package atmail-mailserver.x86_64 0:1.0.1-1.el7.centos will be an update
    ---> Package atmail-mailserver-plugin-WebmailIntegration.x86_64 0:1.0.0-1.el7.centos will be updated
    ---> Package atmail-mailserver-plugin-WebmailIntegration.x86_64 0:1.0.1-1.el7.centos will be an update
    --> Finished Dependency Resolution

    Dependencies Resolved

    ==========================================================================================================
     Package
       Arch   Version            Repository                                                              Size
    ==========================================================================================================
    Updating:
     atmail-mailserver
       x86_64 1.0.1-1.el7.centos /atmail-mailserver-1.0.1-1.el7.centos.x86_64                            42 M
     atmail-mailserver-plugin-WebmailIntegration
       x86_64 1.0.1-1.el7.centos /atmail-mailserver-plugin-WebmailIntegration-1.0.1-1.el7.centos.x86_64 292 k

    Transaction Summary
    ==========================================================================================================
    Upgrade  2 Packages

    Total size: 42 M
    Is this ok [y/d/N]: y
    Downloading packages:
    Running transaction check
    Running transaction test
    Transaction test succeeded
    Running transaction
      Updating   : atmail-mailserver-1.0.1-1.el7.centos.x86_64                                            1/4
    Updating DB ....[DB-UPDATE] Current DB Version: 1.0.0
    [DB-UPDATE] - (/usr/share/atmail/mailserver/webui/install/atmail.mailserver.update.1.0.1.sql) Completed
    .. [ OK ]
      Updating   : atmail-mailserver-plugin-WebmailIntegration-1.0.1-1.el7.centos.x86_64                  2/4
    Adding in any extra config settings to DB ..... [ OK ]
      Cleanup    : atmail-mailserver-plugin-WebmailIntegration-1.0.0-1.el7.centos.x86_64                  3/4
      Cleanup    : atmail-mailserver-1.0.0-1.el7.centos.x86_64                                            4/4
      Verifying  : atmail-mailserver-plugin-WebmailIntegration-1.0.1-1.el7.centos.x86_64                  1/4
      Verifying  : atmail-mailserver-1.0.1-1.el7.centos.x86_64                                            2/4
      Verifying  : atmail-mailserver-1.0.0-1.el7.centos.x86_64                                            3/4
      Verifying  : atmail-mailserver-plugin-WebmailIntegration-1.0.0-1.el7.centos.x86_64                  4/4

    Updated:
      atmail-mailserver.x86_64 0:1.0.1-1.el7.centos                                                           
      atmail-mailserver-plugin-WebmailIntegration.x86_64 0:1.0.1-1.el7.centos                                 

    Complete!
  5. Restart the following services.
    [root@a8 ~]# systemctl restart nginx php-fpm exim dovecot
Have more questions? Submit a request

Comments