$Rev: 531 $ - Release Date: 15 December 2009

Table of Contents

Introduction

Thank you for downloading Scalix ActiveSync 1.0.

Scalix ActiveSync is a server-side wireless server implementation of the Microsoft Exchange 2003/2007 ActiveSync "Over-the-Air" (EAS) protocol specification licensed from Microsoft. The first release, Scalix ActiveSync 1.0, provides for push email, wireless calendar and contact synchronization. Other EAS functionality, such as device management, will be supported in the future.

No Scalix Software is required on the user's mobile device. Many devices already ship with a built-in ActiveSync client; for others it is available as an additional, no-cost install from the device vendor.

The Scalix ActiveSync solution utilizes a direct data channel between the mobile device and the Scalix ActiveSync-enabled server. No intermediary hosts are required. Scalix ActiveSync works over any data network, including GSM, GPRS, EDGE, UMTS, CDMA as well as LAN or Wireless Ethernet networks. Only a basic data plan is needed from the carrier. Communications employ strong SSL cryptography, so security and data privacy is assured.

Licensing

A per-user license is required to use Scalix ActiveSync. This is an optional add-on to a Scalix Server and Mailbox license key. Any Scalix Server can be activated for a number of named ActiveSync users. Once this is done, mailboxes on this server can be flagged to be ActiveSync-enabled. The ActiveSync server will check for this flag to be set and an available license when establishing the connection. The flag can be removed and the ActiveSync entitlement re-allocated to another user on the same server at any time.

Supported Setups and System Requirements

Scalix ActiveSync supports different deployment models:

  • All-in-One: Scalix Server and Scalix ActiveSync running on a single system
  • Dedicated Wireless Server: Separate systems for Scalix servers and the Scalix ActiveSync frontend server.
  • Mixed: Scalix ActiveSync is running on one of the Scalix servers and provides service for users on this and other Scalix servers
  • Multi-purpose frontend: Scalix ActiveSync is installed on a Scalix Web Access (SWA) frontend server.
Note: For configurations where a single Scalix ActiveSync server provides support for users on multiple Scalix servers, these servers must be connected in a multi-server setup using directory synchronization (DIRSYNC) and Scalix-to-Scalix routing using the "Sendmail Interface". This setup requires a Scalix Enterprise Edition license to be installed on the Scalix servers. A setup, in which a single Scalix ActiveSync server connects to multiple independent Scalix servers running Scalix Small Business edition is not supported.

The following needs to be true for the Scalix environment for running ActiveSync:

  • Scalix servers hosting users whose mailboxes will be ActiveSync-enabled need to run Scalix 11.4.4 or higher. It is recommended to upgrade these servers to Scalix 11.4.6 or higher, as these server versions contain additional fixes relevant for ActiveSync environments.
  • Any system on which Scalix ActiveSync is to be installed together with other Scalix components, either a message store or a Scalix Web Access frontend, must be running Scalix 11.4.6 or higher.
  • Scalix ActiveSync communicates with the Scalix Messaging Services platform (SMS). The default setup creates a separate instance of SMS if it doesn't exist on the machine where ActiveSync is installed. Using custom setup, ActiveSync can be configured to use a different instance of SMS, either running on the Scalix backend server, another frontend server running SMS and SWA or a dedicated SMS server. If this setup is used, the instance of SMS ActiveSync communicates with must be running Scalix 11.4.6 or higher.
Supported OS platforms for Scalix ActiveSync 1.0.2:
  • Red Hat Enterprise Linux 5, 32- and 64-bit
  • CentOS 5, 32- and 64-bit
  • SuSE Linux Enterprise Server 10, 32- and 64-bit
Note: Scalix ActiveSync 1.0.2 can be installed on Fedora 9 and OpenSuSE 11.0 for testing and evaluation purposes. These platforms are not supported for production use. Red Hat Enterprise Linux 4, CentOS 4 and SuSE Linux Enterprise Server 9 remain supported for the Scalix server, however, Scalix ActiveSync 1.0.2 cannot be installed on these platforms as it requires Apache 2.2, which is not available for these platforms. If you run Scalix server on one of these setups, you will have to use a separate, dedicated Scalix ActiveSync server running on of the supported OSs.

For a dedicated server running all components including Scalix Messaging Services platform, Scalix ActiveSync 1.0.2 must have
  • a minimum of 2 GB of RAM
  • a single CPU
  • 10 GB of disk space
  • a non-proxied Internet connection on port 443/tcp (https) and/or port 80/tcp (http). It is recommended to only use port 443/tcp (https) for security reasons.
  • a local connection to the Scalix server(s), allowing for ports 143/tcp (imap), 25/tcp (smtp), 587/tcp (submission), 389/tcp (ldap) and 5768/tcp (Scalix Event Server) to be used
Note: For a dedicated server running only the actual ActiveSync ("scalix-wireless") component and communicating with Scalix Messaging Services (SMS) running on a different machine, only port 80/tcp (http) must be available for outbound communication to the SMS system.

Actual system requirements may be higher, depending on the size of user mailboxes, number of active and concurrent users and performance/response time of Scalix backend servers and the latency of the network connection between ActiveSync and backend servers.

Please note that the ActiveSync protocol uses long-lived http connections to provide push-email services, so any kind of intermediary system using proxy or NAT technology should be avoided, or must be enabled and configured to support this. The maximum lifetime of http connections can be modified in Scalix ActiveSync configuration; the default is 5 minutes. Shorter maximum lifetimes will make Scalix ActiveSync more compatible with firewalls, network proxies and NAT setups but will decrease the device's battery life as there will be more frequent communication between the device and the Scalix ActiveSync server.

In a configuration where ActiveSync and Scalix Messaging Services are run on separate machines, long-lived http connections will be used both between the device and the Scalix ActiveSync server as well as between ActiveSync and Scalix Messaging Services.

Note: It is supported to run Scalix ActiveSync in a virtual machine.

When installing Scalix ActiveSync on a Scalix server or Scalix Web Access (SWA) frontend server, an extra 1 GB of RAM and 5 GB of disk space should be available for Scalix ActiveSync.

Please note that it is recommended to run Scalix ActiveSync on a 64-bit OS due to the more flexible options for allocating memory to the virtual machine. Please also note that a machine with multiple recognized CPU cores is recommended as this will improve Java garbage collection and memory management performance substantially.

Supported Devices

Scalix ActiveSync 1.0.2 supports versions 2.5 and 12.0 and parts of 12.1 of the Microsoft Exchange ActiveSync protocol. It has been tested to work with the following devices:

Vendor

Device Type

Firmware

OS

ActiveSync Protocol

Apple

iPhone 3G/iPod Touch

3.1.2

iPhone OS

2.5

Microsoft (Emulator)

Windows
Mobile 5**

N/A

Windows Mobile 5
CE OS 5.1.170

2.5

Microsoft (Emulator)

Windows Mobile 6

N/A

Windows Mobile 6 Professional
CE OS 5.2.1235

12

Microsoft (Emulator)

Windows Mobile 6.5

N/A

Windows Mobile 6.5 Professional
CE OS 5.2.21234

12.1

Palm
(Emulator)

Pre

Virtura v1.0c

Palm webOS 1.2 SDK

12

Nokia

E61i

3.0633.69.0006

Symbian 9.1 Series 60 (S60)
3rd Edition
MfE 2.9.158

2.5

Nokia

E71

300.21.01218

Symbian OS v9.2
MfE 2.9.158

2.5

Samsung

SGH-i616 (i616UXGK4)

H/W Rev. 0.3

Windows Mobile 6 Standard
CE OS 5.2.1620
Build 18125.0.4.2

12

Other devices that support ActiveSync may also work but haven't been tested in full, e.g.:

  • Motorola - A780, A910, Motorola Q
  • Nokia - Series 60 Symbian devices, E-Series, N-Series
  • Sony-Ericsson - Symbian devices, e.g. P990, M600, P1i, W950
  • Palm - Treo and Centro smartphones
  • Helio - Helio Ocean
  • Google Android based phones that have a 3rd party ActiveSync Client installed

**) Need to have the Microsoft Feature Pack installed and will not support push email.

Supported Functionality

Scalix ActiveSync 1.0 supports the following aspects of the Exchange Active Sync (EAS) V2.5, V12 and V12.1 protocol versions:

  • General
    • Username/Password Basic Authentication
    • Support for Scalix integrated Licensing
    • Secure Sockets Layer SSL security for transport encryption
    • Conflict resolution and error recovery
    • Global Address List (GAL) lookup
  • Email
    • Send/Receive Polling
    • Direct push email support
    • Synchronization for Inbox and all private folders
    • Filtering based on date
    • Reply to email messages
    • Forward email messages
    • Compose/Send Email messages
    • Download and view attachments
    • HTML mail content support (12.0, 12.1)
  • Calendaring
    • 2-way calendar synchronization
    • Filtering based on date
    • Accept, Decline and tentatively accept meeting requests
    • Create Meeting requests
  • Contacts
    • 2-way contact synchronization
  • Folder Management
    • View folder hierarchy
Note: Apple iPhone 2.x and 3.x Beta versions support V2.5 of the EAS protocol. For this reason, HTML mails are not supported with iPhone.

The following EAS features are not supported in Scalix ActiveSync 1.0 and will be part of a later release:

  • General
    • Client certificate/SecurID authentication
    • HTTP redirection and Autodiscovery, forwarding a user to another, closer server
    • Optimized V12.1 Sync features, support for wait, limit and partial elements
    • Optimized V12.1 HTTP use (URI format changes, elimination of HTTP headers)
    • Accessing Documents on File Shares
    • Browse File Shares and URIs
  • Email
    • Synchronization of public folders
    • Flagging of Email messages
    • Device-side Out-of-Office settings
    • Secure MIME (S/MIME) support in synchronization (2.5, 12.0, 12.1)
  • Calendaring
    • Attachments for appointment objects
    • View of attendee status for meetings
    • Reply/Reply-All/Forward in an appointment
  • Contacts
    • Images and Pictures in Contacts
  • Tasks
    • Generally 2-way task synchronization
    • Support Outlook 2007 To-Do list view
  • Folder Management
    • Create, edit, or delete folder hierarchy items
  • Search
    • Support for keyword mailbox search (12.0, 12.1)
    • Support for advanced mailbox search (12.0, 12.1)
    • Support for document library search (12.0, 12.1)
  • Management
    • User Policy settings for ActiveSync and Device settings including Password reset, Device wipe and attachment download controls
    • Send device information to support user self-management (12.0, 12.1)
    • Ensure compliance with reporting and monitoring functionality (2.5)
    • Support Systems Management Server (SMS) notifications (2.5)

Changes/Fixes

Scalix ActiveSync 1.0.2

ActiveSync

  • Bug 19796 [Defect] Windows Mobile: Device displays wrong "when" when organizer cancels meeting
  • Bug 19958 [Defect] Adding a note to a Contact in ActiveSync makes Outlook Contact unopenable
  • Bug 19962 [Defect] iPhone: Creating contact with phone number only causes errors
  • Bug 20021 [Defect] Symbian: Description is not saved for appointments created on device
  • Bug 20023 [Defect] Symbian: after creating or modifying a contact, notes are lost
  • Bug 20250 [Defect] iPhone 3.0: GAL query search shows display name as "No Name" in search result
  • Bug 20313 [Defect] ActiveSync not properly handling double-quoted Email address elements
  • Bug 20335 [Defect] iphone: line space disappears when message with special characters seen in iphone
  • Bug 20336 [Defect] Home phone number in contact gets duped on Symbian device
  • Bug 20364 [Defect] Sensitivity reset to normal after saving appointment
  • Bug 20427 [Defect] All-Day Appointments appear at incorrect times on mobile devices
  • Bug 20442 [Defect] HTML parsing problems due to invalid character in certain spam messages
  • Bug 20449 [Improvement] ActiveSync needs to provide better context and recovery for parsing problems
  • Bug 20558 [Defect] All-Day Appointment created on mobile device appears one day before
  • Bug 20839 [Defect] NullPointerException when downloading message bodies on palm pre
  • Bug 20842 [Defect] Palm Pre displays base64 for Message Body
  • Bug 20844 [Defect] Meeting request between iPhone and Outlook changes organizer
  • Bug 20869 [Defect] Categories do not sync for contacts
  • Bug 20873 [Defect]?SyncCommand.doDeletions will not delete messages if request/device does not support DeletesAsMoves
  • Bug 20901 [Defect] Appointment without Busy-Status causes Null-Pointer exception and overall calendar sync failure
  • Bug 20910 [Defect] Email having attachment with ampersand (&) in filename can break AS synchronization
  • Bug 20941 [Defect] Nokia MfE ActiveSync devices cannot sync message that do not contain a "To:" recipient in the mail (only a Bcc:)
  • Bug 20960 [Defect] ActiveSync Appointment descriptions do not display in Outlook
  • Bug 20975 [Defect] Palm Pre: Sent Items and other folders where name contains space: messages are not downloadable

Scalix Server

  • Bug 20587 [Defect] Message text shown as attachment when attaching image on iPhone

Scalix Messaging Services

  • Bug 20367 [Defect] Javamail NullPointerException when getMessageBySeqNumber fails
  • Bug 20550 [Improvement] XmlRenderer to render FirstName and LastName
  • Bug 20581 [Defect] Calendar synchronization fails with Hibernate StaleState Exception
  • Bug 20989 [Defect] Windows Mobile keeps syncing forever throwing null pointer Exception, on trying to reply message received from Palm Pre
  • Bug 21032 [Defect] Error when fetching message bodies when "no some of the requested ..." imap error occurs
  • Bug 21033 [Defect] All custom imap commands are prone to failure

Scalix Installation

  • Bug 14617 [Defect] Scalix installation captures all Apache URLs starting with m, not only /m
  • Bug 19069 [Improvement] Apache httpd.conf timeout should be set linked to AS timeouts
  • Bug 19096 [Defect] Cannot uninstall individual Scalix components
  • Bug 19978 [Improvement] ActiveSync installer should allow setup of wireless-only system and non-colocating platform component
  • Bug 20437 [Defect] Unable to set reserved memory for Tomcat > 1024MB during installation
  • Bug 20509 [Improvement] Configure wireless timeout value in the proxypass directive

Scalix ActiveSync 1.0.1

ActiveSync

  • Bug 19555 [Enhancement] Support for ActiveSync v12 ItemOperations command
  • Bug 19892 [Defect] Some full message content encodings fail to be processed by WM device
  • Bug 19923 [Defect] Window Mobile: Device disconnecting push-email thread when mail is sent
  • Bug 20001 [Defect] iPhone: Email with only a text/html body part cannot be displayed
  • Bug 20018 [Defect] iphone updating/creating Contact with empty notes field for contact creates improper RTF body content
  • Bug 20053 [Defect] Error encountered when decoding partial base64 content
  • Bug 20073 [Improvement] More robust session management for ActiveSync
  • Bug 20098 [Defect] Some calendar updates can happen with the incorrect subject on the mime message
  • Bug 20122 [Defect] ActiveSync needs to set a include-original-message-headers parameter for smart forward/reply
  • Bug 20124 [Defect] Messages with upper-case mime types won't be displayed on ActiveSync device
  • Bug 20133 [Defect] Exception with "Beta 1" comment appearing while syncing contacts
  • Bug 20138 [Improvement] Convert text/html only emails to display text/plain version of this to AS 2.5 clients
  • Bug 20192 [Defect] ContentType comparisons are not case iNsEnSiTiVe
  • Bug 20213 [Defect] Changing an item while the body is downloaded causes body to revert to the truncated version
  • Bug 20240 [Defect] Empty message bodies appear truncated when fetching headers only
  • Bug 20255 [Defect] 'email:Attachment' sent from iphone does not show up properly in other devices
  • Bug 20362 [qa] wme6, contacts lost after re-creating sync relationship
  • Bug 20436 [Defect] ActiveSync does not log the username used to authenticate

Scalix Messaging Services

  • Bug 20016 [Defect] MimeUtils.getPartList is using printStackTrace()
  • Bug 20052 [Defect] Calendar elements with umlaut in subject or location appear garbled on AS client
  • Bug 20121 [Defect] Platform smart forward/reply always appends original message headers
  • Bug 20139 [Improvement] Return text/html body as an alternative to text/plain when fetching bodies by type
  • Bug 20191 [Defect] ContentType comparisons are case sEnSiTiVe
  • Bug 20372 [Defect] Umlauts in messages with 8-bit content transfer encoding are corrupted for AS clients

Installation and Setup

Installation

For the purpose of these installation instructions, a dedicated server setup is used. The example uses the following hostnames:

  • Existing Scalix 11.4.6 server: scalix.company.com
  • New Scalix ActiveSync 1.0.2 Server: activesync.company.com

Install Scalix ActiveSync

Transfer the Scalix ActiveSync binary to the destination machine (activesync.company.com). Login to the ActiveSync system as root and execute the installer:

$ bash ./scalix-activesync-1.0.2-GA-enterprise-linux-intel.bin

When prompted read and accept the license agreement.

The installer will now verify and extract the Archive Content:

Verifying Archive Contents...

Filesize: 60164310 - OK

SHA1 Checksum: bcb07d8ed37981eedfdbcc0b6603b3a80769bd5c - OK

Extracting and unpacking file scalix-activesync-1.0.2-GA-enterprise-linux-intel.tgz

Archive extraction complete. Press <Return> to see the README. -->   
To install ActiveSync, either select to start installation automatically or
start the installation manually by executing the following commands:

   cd scalix-activesync-1.0.2-GA
  ./scalix-installer

After reading the README press <Return> to continue installation.

Do you want to run the package that was unpacked automatically? (yes/no) [yes] 

Scalix Installer - extracting archive, please wait...
Scalix Installer - starting version 11.4.6.2741...
Scalix Installer - using Python 2.4.3 (/usr/bin/python).
Scalix Installer - audit log file is /var/log/scalix-installer-20091214.log

The installer will gather some system information and prompt you to choose from:

Please choose an action from the list:
[1] Install all Scalix components (typical)
[2] Install one or more Scalix components (custom)
-> Please enter your choice [1]:

Choose 1 to perform a typical installation. An overview of packages to install will be displayed. Confirm with yes to continue the installation:

=== Packages Installation ===

Searching for latest Scalix packages...   

Install the following components:
  * Scalix DB
    (version 11.4.6.2718-1)
  * Scalix Apache/Tomcat Connector
    (version 11.4.6.1020-1.sles10 [1.sles10])
  * Scalix Tomcat
    (version 5.5.28-1047)
  * Scalix Messaging Services
    (version 11.4.6.2822-1)
  * Scalix ActiveSync
    (version 1.0.2.670-1)

-> Do you want to continue installing the packages? (yes/no) [yes]

Please note that the package size, checksums and actual version numbers displayed here can be different.

The installer will perform some sanity checks. In case of an error you will get a detailed description of encountered problems. You will need to fix these errors before continuing the installation. In case there where not errors detect you can press <Return> to begin the installation:

Performing system check...

* Environment check... OK
* Filesystem check... OK
* Network check... OK
* Dependency check... OK
* Running services check... OK
* Community license check... OK

-> Press Enter to begin installation:

After the installation finishes a couple of configuration questions must be answered:

Please wait while Scalix components are installed...    
Checking old Tomcat installations...   
Installing packages...   
Installing Scalix DB...   
Installing Scalix Apache/Tomcat Connector...   
Installing Scalix Tomcat...   
Installing Scalix Messaging Services...   
Installing Scalix ActiveSync...   
Done.

=== Java Runtime Configuration ===

JRE version 1.5.0_21-fcs already installed, skipping.

=== PostgreSQL Configuration ===

-> Enter database password:

Choose a password to be used and reenter it when prompted.

-> Confirm password: 
Configuring PostgreSQL...   

Now enter the address of the Scalix backend server that hosts the message store and provides SMTP. In this example it is scalix.company.com. If you altered your LDAP setup on the backend machine you will also need to enter the changed port:

=== Messaging Services ===

-> Scalix Server hostname (IMAP) [activesync.company.com]: scalix.company.com

-> SMTP server hostname [activesync.company.com]: scalix.company.com

-> Enter LDAP port number: [389]: 389

After specifying the above parameters the installer will finish the installation and start all needed services:

Configuring Web applications...    
Cleaning up Tomcat......   
Configuring Tomcat...   
Configuring Scalix ActiveSync...   
Configuring Scalix Messaging Services...   
Configuring Tomcat service...   
Cleaning up Apache/Tomcat JK configuration......   
Configuring Apache/Tomcat JK connector...   
Restarting Scalix DB...   
Starting Tomcat...   
Installation finished.
Scalix Installer - cleaning up...
Scalix Installer - done.

Re-/uninstalling Scalix ActiveSync

If for any reason you want to re- or uninstall Scalix ActiveSync simply start the installer again.

Please note, in order to reinstall Scalix ActiveSync you must uninstall and delete the cache.

./scalix-installer --cli

Please choose an action from the list:
[1] Install/Upgrade one or more Scalix components (custom)
[2] Reconfigure Scalix components
[3] Uninstall Scalix components
-> Please enter your choice:

Enter 3

Please choose one or more components to uninstall:
[1] Scalix DB
(version 11.4.6.2718-1)
[2] Scalix Apache/Tomcat Connector
(version 11.4.6.1020-1.rhel5 [1.rhel5])
[3] Scalix Tomcat
(version 5.5.28-1047)
[4] Scalix Messaging Services
(version 11.4.6.2822-1)
[5] Scalix ActiveSync
(version 1.0.2.670-1)
-> Please enter comma-separated list of numbers:

Enter 1,2,3,4,5

-> Are you sure you want to uninstall the selected components? (yes/no) [no] 

Enter yes

-> After uninstalling Scalix DB do you want to remove the cache data? (yes/no) [no] 

Enter yes

-> Press Enter to begin uninstallation: 
 
Stopping Tomcat...
Please wait while Scalix components are uninstalled...
Discovering instances...
Reconfiguring Web Apps...
Stopping PostgreSQL...
Uninstalling Scalix ActiveSync...
Uninstalling Scalix Messaging Services...
Uninstalling Scalix Tomcat...
Uninstalling Scalix Apache/Tomcat Connector...
Uninstalling Scalix DB...
Removing Web Apps configuration...
Cleaning up Tomcat...
Cleaning up Apache/Tomcat JK connector...
Cleaning up orphaned files...
All selected Scalix components have now been uninstalled.
Uninstallation finished.
Scalix Installer - cleaning up...
Scalix Installer - done.

Checking the License Key

On the Scalix server to which you connect your ActiveSync setup, check whether the license contains ActiveSync entitlements. If you don't find the ActiveSync option in your license key, please contact your Scalix reseller or sales representative to obtain a license key with ActiveSync enabled. Please see your Scalix server documentation for information on how to install a new license key.

Method 1 - Command Line

On the Scalix server command line, run the sxlicense command to check whether an ActiveSync option is availble, e.g.
scalixmail:~ # sxlicense
Scalix License Status

License Type: Permanent
Key Type: Scalix Standard
System Class: Multi-Server
Domain: company.com
ID: 3212
LVID: 2010-12-31
Premium Users: 200
Standard Users: 1000
Features: TNEF WIRELESS MIGRATION HIGH_AVAILABILITY MULTI_INSTANCE MULTI_SERVER RECOVERY_FOLDER ARCHIVER
Option: Name=ActiveSync;Expiry=2010-12-31;EnabledUsers=100
License File: /var/opt/scalix/sl/s/LicenseKeys/permanent.lic
License Fingerprint (MD5): 28:4E:FD:FC:0D:5D:E4:9E:58:14:33:59:EA:33:CE:11
Note the "Option" line for ActiveSync. The "Expiry" will indicate until when the option is valid, the "EnabledUsers" field will contain the maximum number of users that can be enabled for ActiveSync.

You can also check current usage with the sxlicense -u command, e.g.
scalixmail:~ # sxlicense -u
Scalix License Usage

Local Usage

Premium Users: 56
Standard Users: 3
Can ActiveSync: 54

Totals
Premium Users: 381
Standard Users: 67
Can ActiveSync: 54
This indicates the number of users that are already enabled for ActiveSync.

Method 2 - SAC

  1. Login to SAC as a Full administrator
  2. Click on the "Settings" icon in the toolbar
  3. Select your Scalix server from the list of mail servers in the tree view
  4. Click on the "License" tab in the right pane
The "License Details" will show your currently installed license key. This will contain the "Option" line for ActiveSync, similar to the "sxlicense" output referenced above.

Note: In Scalix 11.4.6, SAC does not show the number of currently enabled users. This will be added in a later release.

Note: In a Multi-Server Enterprise Edition environment, the same, ActiveSync-enabled license key must be installed on all servers. Otherwise, SAC functionality for enabling/disabling ActiveSync for users will not work (Bug 20065)

Enabling a User for ActiveSync

A user must be enabled on the Scalix server before he can use ActiveSync. For this to work, a license key with available ActiveSync entitlements must exist on the system.

Method 1 - Command Line

1. To see whether a user is enabled for ActiveSync, use the omshowu command, e.g.
scalixmail:~ # omshowu -n "Joe User"
Authentication ID: joeuser
Globally Unique ID: 19b10000daaa2864-9.0.61.271
User Name : Joe User /CN=Joe User
MailNode : scalix1
Internet Address : "Joe User" <Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.>
System Login : 60588
Password : set
Admin Capabilities : NO
Mailbox Admin Capabilities : NO
Language : C
Mail Account: Unlocked
Last Signon : 04.24.09 16:44:19
Receipt of mail : ENABLED
Service level : 0
Excluded from Tidyall : NO
Recovery Folder visible : NO
User Class : Full
ActiveSync : YES
SIS URL : sxidx://scalix1.scalix.com/09b10000daaa2864-9.0.61.271
Note: The "ActiveSync: YES" line will only show up if the user is setup with an ActiveSync entitlement; otherwise, no information about ActiveSync will be shown.


2. To add the ActiveSync entitlement to a user, use the ommodu command, e.g.
scalixmail:~ # ommodu -n "Joe User" --activesync yes
ommodu: The user was modified successfully
Note: You can only add ActiveSync entitlements to the number of users you are licensed for.


3. To remove the ActiveSync entitlement from a user, use the ommodu command, e.g.
scalixmail:~ # ommodu -n "Joe User" --activesync no
ommodu: The user was modified successfully
Note: The ActiveSync entitlement will be returned to the pool and can be reallocated to another user or the user can be reenabled to use ActiveSync at a later time.

Method 2 - SAC

  1. Login to SAC as a Full, Mailnode or User Administrator
  2. Click on the "Users" icon in the toolbar
  3. Select the user from the list of users in the tree view
  4. Click on the "Mobile" tab in the right pane
The checkbox labelled "Enable ActiveSync" will indicate the users current status and can be used to add or remove the ActiveSync entitlement to the user.

Client Setup

The following section contains a Quick Configuration Guide for several Client devices. Please note that only the mandatory settings are mentioned. For a complete documentation of available options please refer to the clients documentation.

All examples are based on the following setup:

  • Scalix ActiveSync Server: activesync.company.com (available via SSL, port 443)
  • Authentication Id: Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.
  • Password: Wireless
  • E-mail address: Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.
Please make sure to use the appropriate values when setting up your device.

Apple iPhone

  • Select Settings from the default screen
  • Select Mail, Contacts, Calendars
  • Select Add Account
  • Select Microsoft Exchange
    • Email: Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.
    • Username: Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.
    • Password: Wireless
    • Select "Next"
    • Server: activesync.company.com
    • Select "Next"
  • Synchronize settings
    • Mail: On
    • Contacts: On/Off
    • Calendar: On/Off

Windows Mobile

Please note that Windows Mobile devices need an SSL enabled Scalix ActiveSync server as they refuse to use plain HTTP. If you are using a self signed certificate you will need to install it on your device by downloading the certificate to your computer, transferring it to the device and open it. The procedure can vary slightly based on the Windows Mobile version and device make and model used.

  • Select "Start/Applications/ActiveSync" or "Start/Programs/ActiveSync"
  • Select "set up your device to sync with it" or click on menu and select "Add Server Source"
  • If screen asking for Email address is displayed:
    • De-select "Attempt to detect Exchange Server Settings automatically"
    • Click Next
Note: Auto-detection of the server settings would work if DNS and a specific http server are setup to provide this information to the device; please see Microsoft Exchange enterprise deployment documentation for details. This is independent of the actual ActiveSync server type used.
  • Edit Server Settings
    • Server address: activesync.company.com
    • Select or De-Select "This server requires an encrypted (SSL) connection" as desired
    • Click "Next"
  • User Information
    • User Name: Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.
    • Password: Wireless
    • Domain: <any value> (including an empty value; this will be ignored by the Scalix ActiveSync server)
    • Click "Next"
  • Choose the data you want to synchronize
    • Select or De-Select "Contacts"
    • Select or De-Select "Calendar"
    • Select "E-mail"
    • De-Select Tasks
    • Click "Finish"

Nokia E61i (Symbian)

To use ActiveSync on your Symbian device you will first need to install the Mail for Exchange application. Please note that you can only use one Push Mail provider at any given time, e.g. Blackberry Sync or Mail for Exchange. You can download Mail for Exchange from your device manufacturer's website. For Nokia devices you will find it here:

After finishing the installation create a new Mail for Exchange profile:

  • Connection Tab:
    • Exchange Server: Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.
    • Secure connection: Yes
    • Access point: <choose one (see below)>
    • Use default port: Yes
  • Credentials Tab
    • Username: Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.
    • Password: Wireless
    • Domain: None
  • Sync content
    • Synchronize calendar: Yes
    • Synchronize tasks: No
    • Synchronize contacts: Yes
    • Synchronize e-mail: Yes
  • Sync schedule (Choose appropriate values)
  • E-mail
    • E-mail address: Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.

After creating the profile you will see an status overview similar to this:

Sync mode
Off-peak: Every 30 minutes

Current status
Idle

Last sync
12/08/2008 17:58 Complete

Content synced
E-mail

As you can see above the device is in Off-peak mode and will sync only every 30 minutes. You can force a sync either via Options/Synchronize or by selecting the "Current status" line.

Additionally you can access log data by activating the "Last sync" line.

Choose an Access Point that enables you to reach your Scalix ActiveSync machine. Depending in your setup this may either be a WIFI or 3G/GPRS.

Palm Pre

  • Start the Email Application
  • Click on the Drop-down Menu from the "Email" and Select the "Manual Set-Up"
  • Click on "Mail Type" and Select "Exchange(EAS)".
  • Type the Email address : Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.
  • Enter "Incoming Mail Server" info:
    • Server: https://activesync.company.com (Does Not Require an Encrypted SSL Connection, but preferred SSL)
    • Domain: company.com
    • Username: active.sync
    • Password: Wireless
  • Hit Sign In and the device starts to Sync with the Account and device displays "Exchange: Syncing account..".
Once the Sync is Complete, the device displays "Exchange: Sync Completed!" at the bottom which disappears immediately the folder is selected.
  • Expand the "EXCHANGE" node to view all Folders. Email, contacts and calendar are all synced using Exchange Sync.

Support

Scalix ActiveSync is covered by commercial Scalix Support Entitlements. Please see http://www.scalix.com/support for details. The page also contains a link to the Support Case request form.

If you make use of the above link to report an issue, please provide us with as much information as possible, e.g.:

  • Scalix version on Back end system
  • Scalix version on ActiveSync server
  • OS Version (including patch level) on Backed and ActiveSync system
  • Device used
  • Firmware version of device
  • Version of used ActiveSync Software on device (if any)
  • Type of connection used (wifi, gprs, 3g, ...)

Known issues

Please note that not all devices will behave in the same way and some will not support all features. For example, Symbian-based devices will not synchronize a mailbox's subfolders but only emails located in the INBOX, while Windows Mobile 6.1 devices will synchronize. The specific device behavior is controlled by the device vendor. Please refer to the vendor's documentation or technical support to understand limitations of particular devices.

ActiveSync

Bug

Issue

Comment/Solution/Workaround

17966

Windows Mobile Clients fail to download message content

This happens under rare circumstances and is device specific. Scalix will look into improving behavior in a future release

17991

Contacts synced in mobile devices does not have valid email address format.

For contacts created and managed through Outlook, ActiveSync devices sometimes receive email address information in X.400 format. When using such a contact to send an email, the device will not recognize the address format and fail to send email correctly. This will be addressed in a future release of Scalix ActiveSync

19124

Contact notes gets lost on editing the contact on the device

In rare cases, when changing a contact that has Notes associated with it on the device, the contents of the Notes field can be lost. This will be resolved in a future release of Scalix ActiveSync

19136

iPhone freezes after attempting to move a message to a previously deleted folder

The user should wait until the deletion of the folder has propagated to the device before moving any messages. A future version of Scalix ActiveSync will handle this scenario more gracefully

19309

iPhone: Messages replied or forwarded from device do not show up as such in other clients.

A future version of Scalix ActiveSync and/or iPhone software will resolve the issue

19560

Contact and Calendar body elements indicate they are truncated even when they are not

With Notes in calendar or contact entries, the device can sometimes indicate that there is more data available while the note is already displayed in full. The error can be safely ignored

19562

Changing message sync date range does not take effect until new information is found

Changes to the date range only take effect when the content of the mailbox changes, i.e. when a new item arrives or one is removed. It works fine then. Future versions of Scalix ActiveSync will eventually propagate the results of the configuration change forcefully

19658

Symbian: Server should create a Meeting Response if the device fails to do so.

There is no workaround. Symbian devices do not actively send meeting invite responses when accepting the meeting, unlike other ActiveSync-enabled devices. A future release of Scalix ActiveSync will handle this on the server-side

19665

iPhone: User gets duplicate Calendars items when accepting a meeting request

The iPhone's ActiveSync software sometimes sends multiple copies of the Acceptance. Scalix ActiveSync 1.0 does not try to remove those duplicates. The reason for the iPhone's behavior is unknown. A future version of Scalix ActiveSync will provide a workaround

19701

Fetching from Sent Items folder can take a very long time with certain data elements and time out

In certain situations where Sent Items has a large number of messages with RTF content, such as those messages created by Outlook, it may take a long time to generate the MIME version of the messages as required by Scalix ActiveSync. Wait for the operation to finish or retry if it times out, it will eventually succeed. Future versions of Scalix Server will try to optimize for this situation

19724

iPhone fetches and shows 'all' recent messages instead of limited number as setup on the device.

iPhone ignores the setting that controls the maximum number of messages to be downloaded to the device. This is a bug in iPhone software, tracked as Apple Bug 6861032. Scalix does not have any control over how iPhone implements this setting

19729

Windows Mobile: Inline images sent from Thunderbird won't display

The handling of inline images will be improved in a future release of Scalix ActiveSync

19731

iPhone: On accepting a meeting request, the organizer receives 2 copies of response.

In some situations, iPhone will send two copies of the acceptance message. The server will de-duplicate those responses in a future release

19833

Meeting accepted on device is not labelled as such in SWA

Sometimes meeting acceptances cannot be correlated with the meeting. This behavior will be improved in a future release of Scalix ActiveSync

19883

"SocketException: Broken pipe Warn messages" in the logs

This is an indication of common timeouts between Tomcat and Apache. The message can safely be ignored and is not indicative of any specific issue. A future version of Scalix ActiveSync will behave differently and the messages will stop occurring

19891

Windows Mobile: Appointments in device do not show 'optional' attendees

This will be fixed in a future release of Scalix ActiveSync

19894

duplicate appointment when organizer invites himself as attendee

One should not invite oneself to a meeting as an attendee

19945

Windows Mobile/iPhone: Information persists even though fields in contact have been removed

A future version of the Scalix ActiveSync protocol will support additional ActiveSync protocol features that allow the device to actually indicate that a field has been removed

19959

After rejecting the update, the appointment(s) still in calendar

The user will have to manually remove the appointment from the original date and time in this case

19974

The invitation email remained in Inbox after rejecting

The user needs to manually remove the invite from the inbox after declining

19982

When user is not enabled for ActiveSync, get unclear error message in the logs

The user should be enabled for ActiveSync use in SAC or using the ommodu command. A license entitlement must be present for this to work. A future version of Scalix ActiveSync will provide the administrator with a more specific error message

19988

Windows Mobile 6: Cannot remove single attendee from appointment

This is caused by Windows Mobile allowing the user to delete the meeting organizer, which should not be the case. Do not try to delete the organizer on these devices

19998

Handling of alternate body types for input appointments and contacts

Depending on device type, OS version and scenario, sometimes updates to notes fields/text bodies in appointments or contacts are lost or not rendered as required. This behavior is highly device specific and may depend on the release of the device firmware. Scalix is investigating on where to improve behavior for future releases, either on Scalix or device vendor side

20085

iPhone: Contacts Full Name does not gets updated from device.

In addition to the first and last name fields, contacts also contain a Display-as or File-as field. In the current release of Scalix ActiveSync, updates to First and Last name done through iPhone do not automatically update this File-as field. A future version of Scalix ActiveSync will improve this behavior

20189

Windows Mobile displays a multiline note in an appointment/Contacts on a single line

Line breaks are sometimes lost when syncing appointment notes to the mobile device; this behavior is device specific and Scalix is investigating whether it can be improved for future versions of Scalix ActiveSync

20275

iPhone: Messages show up as "Cannot be downloaded" from server

In some situations, iPhone/iPod devices will not download the message on first sync attempt. The message will be shown as "cannot be downloaded from the server". The message is typically downloaded in a future sync operation, outside the control of the user. The issue is being investigated for whether this is a problem caused by iPhone/iPod software

21021

Certain email cannot be displayed on ActiveSync device

Certain HTML emails that do not have a non-HTML plaintext version associated with them cannot be converted to plaintext versions on the server and sent to the device. This makes them unreadable on the device. A future version of Scalix ActiveSync will provide the actual HTML message to the device, for the device to render itself