My activities New request

contact atmail support

PH: +61 (7) 5357-6605

support@atmail.com

Follow

Atmail ActiveSync 1.0 Installation Guide

Stewart -

PROBLEM

I need to install atmail ActiveSync.

ENVIRONMENT

  • On-Premise Server + WebMail Installations: Version 7.4.0 > 7.4.2.1
  • Webmail Only Installations: Version 7.4.0 > 7.4.2.1

CAUSE

ActiveSync requirement.

RESOLUTION

atmail 7.4 introduces a new ActiveSync that requires an extra package. This package is available for download via the "Downloads" section of your Atmail Customer Portal.

Requirements

atmail ActiveSync
PHP 5.3.x only is required for atmail ActiveSync.

  • atmail 7.4+
  • POSIX (php-process) Extension for PHP
  • atmail 7.4+ must be already installed
  • Valid license to use ActiveSync with atmail

How to install

Download

You will first need to download the Atmail ActiveSync package from within your Atmail Customer Portal. Login at https://atmail.com/portal2/ and go to the "Downloads" page. Here you will find a link to download the Atmail ActiveSync package.

Note: The Atmail ActiveSync download will only be shown in your Atmail Customer Portal if your license allows the use of ActiveSync.

Installation

  1. Create /usr/share/push/ directory.

    mkdir /usr/share/push
  2. Place the downloaded file any where on your server and extract as follows.

    tar xfvz atmail7.push.xxx.tgz -C /usr/share/push/
    Change the file name to match the file you downloaded. Each customer will be provided with a different file name.
  3. Ensure correct permissions for the /usr/share/push/ directory.

    chown -R atmail:apache /usr/share/push/
  4. Run Atmail ActiveSync installation.

    php /usr/share/push/install.php
  5. Example Installation

    [root@atmail Desktop]# mkdir /usr/share/push/
    [root@atmail Desktop]# tar xvzf atmail7.push.xxx.tgz -C /usr/share/push/
    INSTALL
    LICENSE
    backend/
    backend/combined.php
    backend/README.CardDAV
    backend/imap.php
    backend/exporter.php
    backend/config.php
    backend/AUTHOR
    backend/carddav.php
    backend/THANKS
    backend/caldav.php
    backend/README.IMAP
    backend/importer.php
    config.ini.default
    config.php
    include/
    include/XMLDocument.php
    include/Translation.php
    include/caldav-client-v2.php
    include/Mail.php
    include/Auth/
    include/Auth/SASL/
    include/Auth/SASL/CramMD5.php
    include/Auth/SASL/SCRAM.php
    include/Auth/SASL/DigestMD5.php
    include/Auth/SASL/Plain.php
    include/Auth/SASL/Common.php
    include/Auth/SASL/Login.php
    include/Auth/SASL/Anonymous.php
    include/Auth/SASL/External.php
    include/Auth/SASL.php
    include/z_carddav.php
    include/Mail/
    include/Mail/smtp.php
    include/Mail/sendmail.php
    include/Mail/mail.php
    include/RFC822.php
    include/iCalendar.php
    include/XMLElement.php
    include/Net/
    include/Net/SMTP.php
    include/Net/Socket.php
    include/z_RFC822.php
    include/mimePart.php
    include/AWLUtilities.php
    include/z_RTF.php
    include/stringstreamwrapper.php
    include/mimeDecode.php
    index.php
    install.php
    lib/
    lib/webservice/
    lib/webservice/webservice.php
    lib/webservice/webservicedevice.php
    lib/request/
    lib/request/itemoperations.php
    lib/request/requestprocessor.php
    lib/request/request.php
    lib/request/provisioning.php
    lib/request/getattachment.php
    lib/request/sendmail.php
    lib/request/folderchange.php
    lib/request/settings.php
    lib/request/getitemestimate.php
    lib/request/search.php
    lib/request/notify.php
    lib/request/gethierarchy.php
    lib/request/ping.php
    lib/request/sync.php
    lib/request/meetingresponse.php
    lib/request/foldersync.php
    lib/request/validatecert.php
    lib/request/resolverecipients.php
    lib/request/moveitems.php
    lib/default/
    lib/default/diffbackend/
    lib/default/diffbackend/diffstate.php
    lib/default/diffbackend/importchangesdiff.php
    lib/default/diffbackend/exportchangesdiff.php
    lib/default/diffbackend/diffbackend.php
    lib/default/filestatemachine.php.bak
    lib/default/backend.php
    lib/default/sqlstatemachine.php
    lib/default/filestatemachine.php
    lib/default/searchprovider.php
    lib/default/simplemutex.php
    lib/wbxml/
    lib/wbxml/wbxmldecoder.php
    lib/wbxml/wbxmldefs.php
    lib/wbxml/wbxmlencoder.php
    lib/exceptions/
    lib/exceptions/statusexception.php
    lib/exceptions/wbxmlexception.php
    lib/exceptions/statenotyetavailableexception.php
    lib/exceptions/notimplementedexception.php
    lib/exceptions/fatalnotimplementedexception.php
    lib/exceptions/httpreturncodeexception.php
    lib/exceptions/exceptions.php
    lib/exceptions/zpushexception.php
    lib/exceptions/authenticationrequiredexception.php
    lib/exceptions/nohierarchycacheavailableexception.php
    lib/exceptions/provisioningrequiredexception.php
    lib/exceptions/stateinvalidexception.php
    lib/exceptions/nopostrequestexception.php
    lib/exceptions/fatalexception.php
    lib/exceptions/fatalmisconfigurationexception.php
    lib/exceptions/statenotfoundexception.php
    lib/exceptions/syncobjectbrokenexception.php
    lib/interface/
    lib/interface/iexportchanges.php
    lib/interface/ibackend.php
    lib/interface/istatemachine.php
    lib/interface/isearchprovider.php
    lib/interface/ichanges.php
    lib/interface/iimportchanges.php
    lib/z-push/
    lib/utils/
    lib/utils/timezoneutil.php
    lib/utils/zpushadmin.php
    lib/utils/utils.php
    lib/utils/compat.php
    lib/syncobjects/
    lib/syncobjects/syncmailflags.php
    lib/syncobjects/syncdeviceinformation.php
    lib/syncobjects/syncfolder.php
    lib/syncobjects/syncvalidatecert.php
    lib/syncobjects/syncresolverecipientsoptions.php
    lib/syncobjects/syncresolverecipients.php
    lib/syncobjects/syncresolverecipientsavailability.php
    lib/syncobjects/syncattachment.php
    lib/syncobjects/syncmeetingrequestrecurrence.php
    lib/syncobjects/synctaskrecurrence.php
    lib/syncobjects/syncresolverecipientspicture.php
    lib/syncobjects/syncitemoperationsattachment.php
    lib/syncobjects/syncnote.php
    lib/syncobjects/syncoofmessage.php
    lib/syncobjects/syncoof.php
    lib/syncobjects/syncattendee.php
    lib/syncobjects/syncresolverecipient.php
    lib/syncobjects/syncsendmailsource.php
    lib/syncobjects/syncdevicepassword.php
    lib/syncobjects/syncmail.php
    lib/syncobjects/syncappointment.php
    lib/syncobjects/syncbasebody.php
    lib/syncobjects/syncmeetingrequest.php
    lib/syncobjects/syncuserinformation.php
    lib/syncobjects/syncresolverecipientscertificates.php
    lib/syncobjects/syncrecurrence.php
    lib/syncobjects/syncbaseattachment.php
    lib/syncobjects/syncsendmail.php
    lib/syncobjects/syncappointmentexception.php
    lib/syncobjects/synctask.php
    lib/syncobjects/syncobject.php
    lib/syncobjects/synccontact.php
    lib/syncobjects/syncprovisioning.php
    lib/core/
    lib/core/asdevice.php
    lib/core/streamer.php
    lib/core/pingtracking.php
    lib/core/changesmemorywrapper.php
    lib/core/devicemanager.php
    lib/core/stateobject.php
    lib/core/synccollections.php
    lib/core/statemanager.php
    lib/core/loopdetection.php
    lib/core/hierarchycache.php
    lib/core/syncparameters.php
    lib/core/zlog.php
    lib/core/topcollector.php
    lib/core/bodypreference.php
    lib/core/zpushdefs.php
    lib/core/streamimporter.php
    lib/core/contentparameters.php
    lib/core/paddingfilter.php
    lib/core/interprocessdata.php
    lib/core/zpush.php
    log/
    sql/
    sql/push.sql
    version.php
    [root@atmail Desktop]# chown -R atmail:apache /usr/share/push/
    [root@atmail Desktop]# php /usr/share/push/install.php
    Welcome to Push  Installation
    ----------------------------------
    PHP Version: 5.3.3
     
    This script will setup the Push Service  for your system
     
    When requesting your input during the installation the default values are
    presented within square brackets -- to choose the default value, hit "Enter"
     
    [Press Enter to Continue]
     
    Install Prerequisites
    ---------------------
     
    The installer will check your system has the required PHP runtime settings.
    You can install the optional PHP extensions via your system package manager or
    via the PHP pecl system. The installer will also scan your php.ini
    configuration file and make the required adjustments for Push.
     
    Required Extensions:
     
     * POSIX (php-process) Extension for PHP: OK
     
    [Press Enter to Continue with installation]
     
    IMAP Backend Setup
    --------------------
     
    The following few prompts will set up your Imap Backend for Push.
    You will need to supply a valid IMAP Hostname.
     
    Enter your Push IMAP server's hostname or IP address [127.0.0.1]:
     
    Enter your Push IMAP server's protocol
     
    1- No SSL
    2- SSL [1]:
     
    Enter your Push IMAP server's port  [143]:
     
    CalDav Backend Setup
    --------------------
     
    The following few prompts will set up your CalDav Backend for Push.
    You will need to supply a valid CalDav Hostname.
     
    Enter your Push CalDav server's hostname or IP address  [127.0.0.1]:
     
    Enter your Push CalDav server's protocol
     
    1-http
    2-https  [1]:
     
    Enter your Push CalDav server's port  [80]:
     
    Enter your Push CalDav server's Root Path(/patht_to_root/)  [/mail/dav/]:
      
    CalDav Backend Setup
    --------------------
     
    The following few prompts will set up your CardDav Backend for Push.
    You will need to supply a valid CardDav Hostname.
     
    Enter your Push CardDav server's hostname or IP address [127.0.0.1]:
     
    Enter your Push CardDav server's protocol
     
    1-http
    2-https [1]:
     
    Enter your Push CardDav server's port  [80]:
     
    Enter your Push CardDav server's Root Path(/patht_to_root/)  [/mail/dav/]:
     
    MySQL Database Setup
    --------------------
     
    The following few prompts will set up your MySQL Database for Push.
    You will need to supply an MySQL user that has permission to create databases.
     
    Enter your Push MySQL server's hostname or IP address [127.0.0.1]:
     
    Enter username for database [root]:
     
    Enter password for root:
     
    Connected to MySQL Server!
     
    Select the database to use or enter the name of a new database to create:
     
    [1] information_schema
    [2] mysql
     
    Choose the name you would like to use for the MySQL database for the Push system. Databases already present are listed above, if you want to choose one of those as the Push database then select the appropriate number from the list. Otherwise, enter the name that you would like to use. A typical name for the Push database is 'push' but you can choose any database name that is appropriate for your system (choose a number from the list or enter a name for a new database): push
     
    The database push was created for Push
     
    Creating Push database tables on push...
     
    Push tables successfully created
     
    MySQL setup complete!
     
    WebServer Configuration
    -----------------------
     
    An Alias tag is required to enable Microsoft Exchange ActiveSync Push services on your server.
    -> Add the following to the apache conf file. You must do this manually (for advanced
    httpd.conf configurations) or select to automatically edit the configuration
    file below.
     
    Append the following to the httpd.conf:
     
    Alias /Microsoft-Server-ActiveSync /usr/share/push/index.php
     
    Edit webserver configuration automatically? [Y]:
     
    The installer has edited your httpd.conf.
     
    For changes to take effect, you are required to restart  Apache.
    The installer can attempt to restart Apache (if this fails, restart the
    Apache service manually).
     
    Restart HTTPD automatically? [Y]:
     
    Stopping httpd:                                            [  OK  ]
    Starting httpd:                                            [  OK  ]
Have more questions? Submit a request

Comments