$Rev: 531 $ - Release Date: 15 December 2009
Table of Contents
- Table of Contents
- Introduction
- Licensing
- Supported Setups and System Requirements
- Supported Devices
- Supported Functionality
- Changes/Fixes
- Installation and Setup
- Support
- Known issues
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.
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.
- Red Hat Enterprise Linux 5, 32- and 64-bit
- CentOS 5, 32- and 64-bit
- SuSE Linux Enterprise Server 10, 32- and 64-bit
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
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 |
N/A |
Windows Mobile 5 |
2.5 |
|
Microsoft (Emulator) |
Windows Mobile 6 |
N/A |
Windows Mobile 6 Professional |
12 |
|
Microsoft (Emulator) |
Windows Mobile 6.5 |
N/A |
Windows Mobile 6.5 Professional |
12.1 |
|
Palm |
Pre |
Virtura v1.0c |
Palm webOS 1.2 SDK |
12 |
|
Nokia |
E61i |
3.0633.69.0006 |
Symbian 9.1 Series 60 (S60) |
2.5 |
|
Nokia |
E71 |
300.21.01218 |
Symbian OS v9.2 |
2.5 |
|
Samsung |
SGH-i616 (i616UXGK4) |
H/W Rev. 0.3 |
Windows Mobile 6 Standard |
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
- 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
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
- 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:~ # sxlicenseNote 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.
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
You can also check current usage with the sxlicense -u command, e.g.
scalixmail:~ # sxlicense -uThis indicates the number of users that are already enabled for ActiveSync.
Scalix License Usage
Local Usage
Premium Users: 56
Standard Users: 3
Can ActiveSync: 54
Totals
Premium Users: 381
Standard Users: 67
Can ActiveSync: 54
Method 2 - SAC
- Login to SAC as a Full administrator
- Click on the "Settings" icon in the toolbar
- Select your Scalix server from the list of mail servers in the tree view
- Click on the "License" tab in the right pane
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"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.
Authentication ID: joeuser
Globally Unique ID: 19b10000daaa2864-9.0.61.271
User Name : Joe User /CN=Joe User
MailNode : scalix1
Internet Address : "Joe User" <This email address is being protected from spambots. You need JavaScript enabled to view it.>
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
2. To add the ActiveSync entitlement to a user, use the ommodu command, e.g.
scalixmail:~ # ommodu -n "Joe User" --activesync yesNote: You can only add ActiveSync entitlements to the number of users you are licensed for.
ommodu: The user was modified successfully
3. To remove the ActiveSync entitlement from a user, use the ommodu command, e.g.
scalixmail:~ # ommodu -n "Joe User" --activesync noNote: 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.
ommodu: The user was modified successfully
Method 2 - SAC
- Login to SAC as a Full, Mailnode or User Administrator
- Click on the "Users" icon in the toolbar
- Select the user from the list of users in the tree view
- Click on the "Mobile" tab in the right pane
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: This email address is being protected from spambots. You need JavaScript enabled to view it.
- Password: Wireless
- E-mail address: This email address is being protected from spambots. You need JavaScript enabled to view it.
Apple iPhone
- Select Settings from the default screen
- Select Mail, Contacts, Calendars
- Select Add Account
- Select Microsoft Exchange
- Email: This email address is being protected from spambots. You need JavaScript enabled to view it.
- Username: This email address is being protected from spambots. You need JavaScript enabled to view it.
- 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
- 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: This email address is being protected from spambots. You need JavaScript enabled to view it.
- 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: This email address is being protected from spambots. You need JavaScript enabled to view it.
- Secure connection: Yes
- Access point: <choose one (see below)>
- Use default port: Yes
- Credentials Tab
- Username: This email address is being protected from spambots. You need JavaScript enabled to view it.
- 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 address: This email address is being protected from spambots. You need JavaScript enabled to view it.
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
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 : This email address is being protected from spambots. You need JavaScript enabled to view it.
- 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..".
- 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 |
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
"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 |
|
|
Windows Mobile: Appointments in device do not show 'optional' attendees |
This will be fixed in a future release of Scalix ActiveSync |
|
|
duplicate appointment when organizer invites himself as attendee |
One should not invite oneself to a meeting as an attendee |
|
|
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 |
|
|
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 |
|
|
The invitation email remained in Inbox after rejecting |
The user needs to manually remove the invite from the inbox after declining |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |