My activities New request

contact atmail support

PH: +61 (7) 5357-6605

support@atmail.com

Follow

atmail suite upgrade guide

Dominic -

PROBLEM

How can I upgrade my atmail suite installation?

ENVIRONMENT

  • atmail suite

CAUSE

atmail needs to be upgraded to the latest version.

RESOLUTION

Keeping your atmail installation up-to-date should be prioritized 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. The api and webmail packages will represent the current version of your suite.
    [root@a8 ~]# rpm -qa | grep atmail-'webmail\|api'
    atmail-webmail-8.0.0-1.el7.centos.x86_64
    atmail-api-8.0.0-1.el7.centos.x86_64
  2. Backup database.
    [root@a8 ~]# mysqldump -u root -p apiserver > apiserver-[version].sql
  3. Backup both the apiserver and webmail. For your convenience the following command will create a suite-version_date.tgz
    [root@a8 ~]# tar cfvz suite-`rpm -qa | grep atmail-webmail | sed 's/-/ /g' | awk '{print $3}'`_`date +"%Y%m%d"`.tgz /etc/atmail/api /etc/atmail/webmail /etc/nginx/conf.d/atmail-api.locations /etc/nginx/conf.d/atmail-webmail.locations /var/lib/atmail/api /usr/share/atmail/webmail
    -rw-r--r--. 1 root root  1914825 Jul 21 17:04 suite-8.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 suite.

  1. You can download your latest atmail suite by directly accessing your customer portal.
  2. Extract the atmail-suite-rpm.tar.gz package.
    [root@8 tmp]# tar xvzf atmail-suite-rpm.tar.gz
    atmail-suite-[version]/
    atmail-suite-[version]/atmail-dav[version].el7.centos.x86_64.rpm
    atmail-suite-[version]/atmail-webmail[version].el7.centos.x86_64.rpm
    atmail-suite-[version]/atmail-common[version].centos.x86_64.rpm
    atmail-suite-[version]/atmail-api[version].el7.centos.x86_64.rpm
  3. Enter the atmail-suite directory.
    [root@8 tmp]# cd atmail-suite-[version]
    [root@8 atmail-suite-[version]]#
  4. Update 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 updated. In this case, you can see the api, dav and webmail rpm's will be updated.
    [root@a8 atmail-suite-8.1.1]# yum update *.rpm
    Loaded plugins: fastestmirror
    Repodata is over 2 weeks old. Install yum-cron? Or run: yum makecache fast
    Examining atmail-api-8.1.1-1.el7.centos.x86_64.rpm: atmail-api-8.1.1-1.el7.centos.x86_64
    Marking atmail-api-8.1.1-1.el7.centos.x86_64.rpm as an update to atmail-api-8.0.0-1.el7.centos.x86_64
    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-dav-1.0.1-1.el7.centos.x86_64.rpm: atmail-dav-1.0.1-1.el7.centos.x86_64
    Marking atmail-dav-1.0.1-1.el7.centos.x86_64.rpm as an update to atmail-dav-1.0.0-1.el7.centos.x86_64
    Examining atmail-webmail-8.1.1-1.el7.centos.x86_64.rpm: atmail-webmail-8.1.1-1.el7.centos.x86_64
    Marking atmail-webmail-8.1.1-1.el7.centos.x86_64.rpm as an update to atmail-webmail-8.0.0-1.el7.centos.x86_64
    Resolving Dependencies
    --> Running transaction check
    ---> Package atmail-api.x86_64 0:8.0.0-1.el7.centos will be updated
    ---> Package atmail-api.x86_64 0:8.1.1-1.el7.centos will be an update
    ---> Package atmail-dav.x86_64 0:1.0.0-1.el7.centos will be updated
    ---> Package atmail-dav.x86_64 0:1.0.1-1.el7.centos will be an update
    ---> Package atmail-webmail.x86_64 0:8.0.0-1.el7.centos will be updated
    ---> Package atmail-webmail.x86_64 0:8.1.1-1.el7.centos will be an update
    --> Finished Dependency Resolution

    Dependencies Resolved

    =====================================================================================================================================================================================================================
     Package                                      Arch                                 Version                                             Repository                                                               Size
    =====================================================================================================================================================================================================================
    Updating:
     atmail-api                                   x86_64                               8.1.1-1.el7.centos                                  /atmail-api-8.1.1-1.el7.centos.x86_64                                   5.5 M
     atmail-dav                                   x86_64                               1.0.1-1.el7.centos                                  /atmail-dav-1.0.1-1.el7.centos.x86_64                                   5.6 M
     atmail-webmail                               x86_64                               8.1.1-1.el7.centos                                  /atmail-webmail-8.1.1-1.el7.centos.x86_64                               4.0 M

    Transaction Summary
    =====================================================================================================================================================================================================================
    Upgrade  3 Packages

    Total size: 15 M
    Is this ok [y/d/N]: y
    Downloading packages:
    Running transaction check
    Running transaction test
    Transaction test succeeded
    Running transaction
      Updating   : atmail-dav-1.0.1-1.el7.centos.x86_64                                                                                                                                                              1/6
      Updating   : atmail-api-8.1.1-1.el7.centos.x86_64                                                                                                                                                              2/6
    Running update.sh
      Updating   : atmail-webmail-8.1.1-1.el7.centos.x86_64                                                                                                                                                          3/6
    Setting JMAP_API_URI to https://192.168.10.206/api ..... [ OK ]
    Setting Base HREF to / ..... [ OK ]
      Cleanup    : atmail-dav-1.0.0-1.el7.centos.x86_64                                                                                                                                                              4/6
      Cleanup    : atmail-api-8.0.0-1.el7.centos.x86_64                                                                                                                                                              5/6
      Cleanup    : atmail-webmail-8.0.0-1.el7.centos.x86_64                                                                                                                                                          6/6
      Verifying  : atmail-webmail-8.1.1-1.el7.centos.x86_64                                                                                                                                                          1/6
      Verifying  : atmail-api-8.1.1-1.el7.centos.x86_64                                                                                                                                                              2/6
      Verifying  : atmail-dav-1.0.1-1.el7.centos.x86_64                                                                                                                                                              3/6
      Verifying  : atmail-dav-1.0.0-1.el7.centos.x86_64                                                                                                                                                              4/6
      Verifying  : atmail-webmail-8.0.0-1.el7.centos.x86_64                                                                                                                                                          5/6
      Verifying  : atmail-api-8.0.0-1.el7.centos.x86_64                                                                                                                                                              6/6

    Updated:
      atmail-api.x86_64 0:8.1.1-1.el7.centos                               atmail-dav.x86_64 0:1.0.1-1.el7.centos                               atmail-webmail.x86_64 0:8.1.1-1.el7.centos                              

    Complete!

  5. Restart and check the status of the apiserver.
    [root@a8 ~]# systemctl restart apiserver
    [root@a8 ~]# systemctl status apiserver
    ● apiserver.service - atmail-api - jmap api for atmail webmail
       Loaded: loaded (/usr/lib/systemd/system/apiserver.service; enabled; vendor preset: disabled)
      Drop-In: /etc/systemd/system/apiserver.service.d
               └─depends.conf
       Active: active (running) since Fri 2017-07-21 14:35:33 AEST; 3s ago
         Docs: http://www.atmail.com/
      Process: 9839 ExecStop=/bin/kill -s QUIT $MAINPID (code=exited, status=0/SUCCESS)
     Main PID: 9841 (apiserver)
       CGroup: /system.slice/apiserver.service
               └─9841 /usr/bin/apiserver -config /etc/atmail/api/api.conf

    Jul 21 14:35:33 a8 systemd[1]: Started atmail-api - jmap api for atmail webmail.
    Jul 21 14:35:33 a8 systemd[1]: Starting atmail-api - jmap api for atmail webmail...
Have more questions? Submit a request

Comments