My activities New request

contact atmail support

PH: +61 (7) 5357-6605

support@atmail.com

Follow

atmail suite

Stewart -

PROBLEM

How can I install the atmail suite onto my own server?

ENVIRONMENT

  • atmail suite

CAUSE

Installation requirement.

RESOLUTION

The atmail suite installation files can be used to setup webmail mode of atmail. This document will illustrate how to configure the webmail software from these files.

Pre-installation notes

System requirements

Before you install the atmail suite, please make sure you meet the minimum system requirements.

Download

First signup as an atmail evaluation user or login to your pre-existing atmail customer portal account. Download the atmail suite - webmail software package from within the atmail client portal.

portal-downloads.png

Installation notes

  1. Extract the atmail-suite-rpm.tar.gz package.
    [root@localhost 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
  2. Enter the atmail-suite directory.
    [root@localhost tmp]# cd atmail-suite-[version]
    [root@localhost atmail-suite-[version]]#
  3. Use yum to install the atmail-common rpm.
    [root@localhost atmail-suite[version]]# yum install atmail-common[version].el7.centos.x86_64.rpm -y -q
        Creating group atmail ..... [ OK ]
        Creating user atmail ..... [ OK ]
        Switching SELinux to permissive mode ..... [ OK ]
  4. Use yum to install the atmail-api rpm.
    [root@localhost atmail-suite[version]]# yum install atmail-api[version].el7.centos.x86_64.rpm -y -q
    warning: /var/cache/yum/x86_64/7/epel/packages/nginx-1.10.2-1.el7.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID 352c64e5: NOKEY
    Public key for nginx-1.10.2-1.el7.x86_64.rpm is not installed
    Importing GPG key 0x352C64E5:
    Userid     : "Fedora EPEL (7) <epel@fedoraproject.org>"
    Fingerprint: 91e9 7d7c 4a5e 96f1 7f3e 888f 6a2f aea2 352c 64e5 Package    : epel-release-7-9.noarch (@extras)
    From       : /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
    Remove /etc/atmail/api/.master on slave nodes
  5. Configure the atmail API server
    1. Run /usr/bin/atmail-api-install
      1. Enter DB Host [ localhost ] :
      2. Enter DB Port [ 3306 ] :
      3. Enter DB user that has create user/grant access [ root ] :
      4. Enter root password [  ] :
      5. Enter URL Hostname where atmail services will be found [ localhost.localdomain ] :
      6. Will the API provision contacts/calendars [ yes ] :
        DAV provisioning has been enabled - you will need to update api.conf with details provided by dav install
      7. Enter your atmail ID :
      8. Enter you licence key :
      9. Configure NginX [ yes ] :
      10. Source the apiadmin profile:
        # source /etc/profile.d/atmail-apiadmin.sh
      11. Create an admin user by running the following.
        apiadmin user add <username> <passwd> --role=admin
  6. Restart API service
    systemctl restart apiserver
  7. Use yum to install the atmail-webmail rpm.
    [root@localhost atmail-suite-[version]]# yum install atmail-webmail[version].el7.centos.x86_64.rpm -y -q
    1. Configure the atmail webmail
      1. Run /usr/bin/atmail-webmail-configure
        1. Enter URL Hostname for atmail services [ localhost.localdomain ] :
        2. Configure NginX [ yes ] :
  8. OPTIONAL: Use yum to install the atmail-dav rpm.
    [root@localhost atmail-suite-[version]]# yum install atmail-dav[version].el7.centos.x86_64.rpm -y -q
    Generating self-signed cert
    Note: If you have already installed the atmail mail server, you do not need to re-install atmail-dav and this step can be skipped
    1. Configure the atmail DAV server

      Note: If you have already installed the atmail mail server, you do not need to re-configure the atmail-dav server and this step can be skipped.
      1. Run /usr/bin/atmail-dav-install
        1. Enter DB Host [ localhost ] :
        2. Enter DB Port [ 3306 ] :
        3. Enter DB user that has create user/grant access [ root ] :
        4. Enter root password [  ] :
        5. Configure NginX [ yes ] :
        6. Configure PHP-FPM [ yes ] :
  9. Restart services.
    [root@localhost ]# systemctl restart apiserver
    [root@localhost ]# systemctl restart php-fpm
    [root@localhost ]# systemctl restart nginx
  10. atmail suite installation complete! Access your installation via your URL hostname slash webmail.
    https://yourhostname.com/webmail/

 

Have more questions? Submit a request

Comments