Table of Contents

Release Date: November 2015

Introduction

Thank you for downloading Scalix 12.5.1

Scalix 12.5.1 is the latest upgrade of Scalix 12, providing important fixes and exciting new features. We recommend that you upgrade all systems running Scalix to this latest version.

This document includes late-breaking information about product capabilities, fixed bugs, known issues and workarounds, so please read it thoroughly before beginning your installation or upgrade.

For full documentation on how to install, configure and administer Scalix, see the customer documentation at http://www.scalix.com/support-resources-documentation. In addition, after Installing the Scalix Mail Server and other applications, you can access the following online help systems, which are embedded in the product:

  • Scalix Web Access Online Help
  • Scalix Management Console Online Help
  • Scalix Connect for Microsoft Outlook Online Help

You also can learn more about any of the known issues listed here - or report others - by going to the Scalix bug tracking system at http://bugzilla.scalix.com/.

Scalix, Inc. is committed to your success with our software. For additional information beyond what is provided here and in the official product documentation, visit the Scalix Forums at http://www.scalix.com/forums/.

Customers who have purchased support from Scalix also may also contact Scalix Technical Support to request help, ask questions about how to use a particular feature, provide feedback, or report bugs by visiting http://www.scalix.com/support.

 

Acknowledgements

Starting with version 11.3 Scalix Connect for Outlook includes software developed by the OpenSSL project for use in the OpenSSL toolkit. (http://www.openssl.org). It also includes cryptographic software written by Eric Young (This email address is being protected from spambots. You need JavaScript enabled to view it.) and software written by Tim Hudson (This email address is being protected from spambots. You need JavaScript enabled to view it.). Scalix would like to thank these individuals and the OpenSSL community for their valuable contributions.

Starting with version 11.3 Scalix Server includes software based on the Universal Character Set Detector from the Mozilla project (http://www.mozilla.org), written by Simon Montagu (This email address is being protected from spambots. You need JavaScript enabled to view it.), Shy Shalom (This email address is being protected from spambots. You need JavaScript enabled to view it), Shoshannah Forbes and others. Scalix would like to thank these individuals and the Mozilla community for their valuable contributions.

Installation issues

  • The following procedure/adjustments are mandatory if you installed CentOS6 (64bit) or ORACLE Linux 6 (x86/x64)
    • If port 80 is not set to allow connections (open) in ip tables, Tomcat will not work at all - scalix-tomcat service will run, but in the tomcat log there will be a big backtrace
      • Open port 80 in iptables
      • restart the iptables service
      • restart the scalix-tomcat service
      • restart the httpd service
    • After this it should be working correctly
    • Secondly initialization of all web applications in Tomcat can take over 20 sec - Tomcat will work only after initialization of its webapps. If you make changes to Tomcat such as the above, please also restart apache (service httpd restart).
  • On Debian sometime installation fails due to a pre-existing error in the sendmail.cf file with the MAILER lines in the wrong place. To fix this manually move the bad MAILER lines to the end of the file and try again.
  • The Installer GUI has been removed. Only the Command Line Interface (CLI mode) installer is used with Scalix 12.5.1

 

Important end of Life Notices

·         {C}{C}Scalix 12.5.1 does NOT support the following Operating systems anymore:

- RHEL 5

- CentOS 5

- SLES 10

·         {C}{C}Scalix is halting further development of Scalix Connect for Outlook versions 12 (Outlook 2007) and earlier as of Scalix 12.5. We recommend that you upgrade to Outlook 2010 or Outlook 2013. While we will continue to provide support on the basis of a frozen connector version, no new functionality in Scalix Connect will be made available for these platforms.

·         JRE 1.5 is no longer supported.

·         {C}{C}Upgrading from Scalix 11.3 or earlier is not supported

 

Upgrade Notices

Please read the following notes very carefully, as some specific actions might be required as you upgrade from earlier versions of Scalix.

Upgrading from a previous version

If you are upgrading from a previous version of Scalix, there are several changes of which you should be aware:

When running Scalix in a mixed-version multi-server setup, where your front end servers are running SWA 12.5, the back end servers have to be upgraded to at minimum version 12.5 as well.

  • Before beginning any upgrades, check your license key. If you are upgrading to or from a Small Business Edition (SBE), Enterprise Edition (EE) or Hosting Edition (HE) installation, you need to have a valid and current license key with a "Last Valid Issue Date" (LVID) on or after January 1, 2015 (2015-01-01) to use Scalix 12.5.1. If you continue installation after the respective warning and the license is not valid, your installation will downgrade to the Community Edition. To check the LVID of your license, use the Scalix Management Console or the sxlicense command. To extend your upgrade subscription or to get a new license key, please contact Scalix Sales.
  • ACL behaviour has been changed as of Scalix 12.5. If upgrading from an earlier version of Scalix, you may to first set general.cfg ACL_NEW_SEARCH_RULES=FALSE to temporarily disable the new ACL rule behaviour, and then migrate your existing ACL rules . See the Scalix Administration Guide for details.
  • When upgrading from previous installation of Scalix to 12.5.1, it is recommended that you empty your IMAP caches by running the following command on your backend server. Please note that this command may only be run when nobody is signed on to the system (when the rci and IMAP services are off): cd $(omrealpath "~/"); find user* -name imap-cache -exec rm -rf {} \;

 

 

Features & Supported OS

Scalix 12.5.1 provides the following features:

Major archiving changes to support Exchange format and other features:

  • With general.cfg settings of ARCHIVE=TRUE and ARCH_MESSAGE_FORMAT=SIMPLE the output is the same as before in Scalix 12.1.
  • With general.cfg settings of ARCHIVE=TRUE and ARCH_MESSAGE_FORMAT=EXCHANGE the output is in the format of Exchange 2007 Journaling.
  • With general.cfg settings of ARCHIVE=TRUE and ARCH_MESSAGE_FORMAT=SCALIX the output is in the new Scalix format (for details see sxarchiver man page).

Major changes to support Sender Internet Address configuration and related new functionality:

  • Prior to Scalix 12.5 the SMTP name used for a message sent from Scalix used the SMTP name that was the primary name for a configured user (or the first SMTP name if multiple names were configured). The 12.5 enhancements allow much more flexibility in the selection of which SMTP name to use at the sender.
  • A new configuration option has been defined (per-user and/or per-system): UL_SENDER_IA=TRUE|FALSE|<SenderIA>
  • If the Sender IA feature is configured and active, then Outlook and SWA clients will be presented with ways for select the Sender IA.
  • The command omshowu displays extra 'All Sender IA' line if active using RFC2047 MIME DL syntax, e.g. =?ISO-2022-JP?B?GyRCNVdKXRsoQiAbJEI4NTwjGyhC?= <mkubo@scalix>

Major changes to support ACL features including new search rules and new sxacl* commands for mail store:

  • In general the om*acl* commands at Scalix 12.5.1 control access only to services while the new sx*acl* commands control access to mail store items (mailboxes, public folders, private folders, messages).
  • New ommaintacl command to clear orphaned entries and/or replace old entries with GUID entries (for maintenance and upgrade).
  • New sxacl* commands (e.g. sxacladdn) have been added (for more details see individual new man page).
  • New ACL search rules have been defined for 12.5.1 (for more details see omchkacln/sxaclchkn man pages).
  • Internally the commands store GUID instead of ORN in ACLs (to better cope with use name changes).

Major hosting enhancements to support per-mailnode configurations and other features:

  • Add server support for per-mailnode configuration (see omaddmn/ommodmn/omshomn man pages).
  • Add server support for per-mailnode user quota/sanction in omlimit (see omlimit man page).
  • Add server support for hosting tenants spanning multiple server (see sxhostadd/sxhostdel man pages).
  • Enhance sxhostcfg and sxdu to support new functionalities (see sxhostcfg and sxdu man pages).

Freebusy service maintains and provides freebusy information for all mailbox calendars:

  • At Scalix 12.5.x the server-based Freebusy Service (FBS) maintains Calendar freebusy information for all Calendars and makes that information available to Mail and Calendar clients.
  • Freebusy information is derived without the need for clients to publish individual Freebusy data.
  • Existing support of Freebusy information remains unchanged for SWA, Outlook and Messaging Services.
  • Freebusy information can be supplied in iCal format via CalDAV URL.

Debian and Ubuntu are now officially supported.

RHEL 7 (x86_64), ORACLE Linux 7 (x86_64) and CentOS 7 (x86_64) are now officially supported.

Added integration with Samba 4.

Next Generation Ldapsync / ADsync script that provide faster synchronization between Scalix and LDAP-similar systems.

Major overhaul of ActiveSync implementation.

Full UTF-8 support for all webapps.

Added special characters escaping.

Added beta support for selected IBM Power and Z Systems

 

General (Server+Installer) features/support:

  • Full support for CentOS 6 and 7 (x86 and x86_64)
  • Full support for RHEL 6 and 7 (x86 and x86_64)
  • Full support for SLES 11 (x86 and x86_64)
  • Full support for ORACLE Linux 6 and 7 (x86_64)
  • Full support for OpenSUSE 12 and 13 (x86 and x86_64)
  • Support for Ubuntu 13 and 14 (x86 and x86_64)
  • Support for Debian 7 (x86 and x86_64)
  • Beta IBM support for RHEL 6 (ppc64 and s390x)
  • Use CommTouch anti-spam engine 8.0 (optional license)
  • Postgres up to 9.3 support
  • Tomcat 6.0.43 support
  • Installer SSL configuration
  • JRE 1.6 and later support

General (Server+Installer) REMOVED features/support (End-of-life):

  • Support of JRE 1.5
  • Ubuntu 12 support
  • Installer GUI
  • Support of RHEL5
  • Support of CentOS5
  • Support of SLES10
  • Support of Outlook 2003 and older Outlook releases (MAPI may still work but is not tested by Scalix anymore)
  • Removed WAP and PAW web profiles

 

 

Changes/Fixes

Scalix Connect for Outlook

-

[Defect]

On defining a rule, which moves more than one mail to a specified folder, sometimes an error is raised, that one or more items cannot be moved

-

[Improvement]

Italian translation integrated

-

[Defect]

Corrected German translation integrated

-

[Defect]

Deleting public contacts (you cannot delete public contacts, which are not created by current user)

-

[Defect]

Deleting public mail item (you cannot delete public mail items, which are not created by current user)

-

[Defect]

Cannot uninstall Italian connector

-

[Defect]

Adding additional mailbox (Scalix/Properties/Advanced) to current mailbox is not possible. Error message appears.

-

[Defect]

Adding a mailbox not possible, if mailbox does not belong to the currently connected Scalix Server

-

[Defect]

Sending on “behalf of another user” does not work in case of user is typing in manually sender’s mail address instead of selection mail address from address book.

-

[Defect]

64bit connector installer is not working

-

[Defect]

Return receipts is handled wrong. Connector always sends an “return receipts”.

-

[Defect]

While a folder is filtered, moving items from one folder to another folder is not working.

-

[Defect]

Writing a new mail while reminder window gets displayed forces Outlook to hang.

-

[Defect]

On restarting outlook, smart cache does not restart

-

[Defect]

On loosing network, connector does not reconnect

-

[Defect]

Smart cache does not delete/sync local mail item if it got deleted by webmail or mobile device (active sync).

-

[Improvement]

Without SmartCache, Scalix Connector is very slow because of re-reading recipient information from server. Now recipient information is stored locally and only re-read from server if necessary

-

[Improvement]

Without SmartCache, Scalix Connector can reread a message unnecessarily. Now connector checks whether message has been fully read or not

-

[Defect]

Without SmartCache, Scalix Connector is slow and sometimes Outlook hangs

-

[Improvement]

Without SmartCache, sometimes reading a mail item is very slow

-

[Defect]

With SmartCache, Outlook sometimes hangs on startup

-

[Defect]

Sometimes Outlook hangs on startup in the case of a lost network connection

-

[Defect]

Connector is not re-connecting after network is lost. Now connector always checks the network connection and reconnects if connection is lost

-

[Defect]

Outlook sometimes freezes after a while

-

[Improvement]

Before installing a new Connector version, the old version had to be uninstalled. Now you can install new version without uninstalling old version

-

[Improvement]

Before installing a new Connector version, sometimes the old profile has to be removed to get new functions working

-

[Defect]

SmartCache crashes when receiving a new mail while performing a search

-

[Defect]

SmartCache stops synching on an unexpected error 11

-

[Defect]

Open Shared Calendar Folders having the same CNAMEs does not work

-

[Defect]

On setting a mail to be read, mail is not synched over ActiveSync back to other devices

-

 

Folder EntryID properties from third-party AddIns differ from Scalix Entry IDs

-

[Defect]

When renaming an Outlook Folder, sometimes the folder is renamed back (conflicts with SmartCache)

-

[Defect]

Sometimes Connector leaves a sent mail item within Outbox folder instead of moving it to the Sent Items folder

-

[Defect]

On moving a lot of mail items between folders, sometimes Connector leaves mail items in the old folder

-

[Defect]

Outlook Startup With No or limited Internet Connection

-

[Defect]

Open Other Users Mailbox On Other Server

-

[Defect]

Delegates Bug within Outlook 2010/2013. If user A sets permissions for user B (e.g. editor), user B can open folder of UserA BUT cannot see any details. An error appears: "The information store could not be opened”

-

[Defect]

On opening a shared calendar, error message appears -> " konnte nicht aktualisiert werden!" -> in English "cannot be actualized". Shared calendar is shown but empty

-

[Defect]

By sending Email from additional account (e.g. Google) recipient receives this message as if sent from Outlook, not from additional account

-

[Defect]

Email address is not present for Openmail addresses. For the messages that contain OpenMail address (not SMTP!) Outlook does not display mail addresses in views, but shows only Display Name. In such cases user does not know from where message is sent because only the display name is visible

-

[Defect]

Deleting mails inside other users mailbox without opening mail itself

Scalix Server

50039

[Defect]

Ldapmapper init script failed when system is used on rhel7/centos7

50044

[Defect]

New appointment does not always show up in user's freebusy data

2069

[Defect]

Archiver gets PDL message twice

3090

[Enhancement]

Use GUID for ACLs rather than X.400 attributes

3173

[Enhancement]

BB ACLs should take user specific caps as final if an entry exists

4906

[Enhancement]

Command line tool to set arbitrary folder ACLs and delegate flags

4971

[Defect]

Mail not delivered after mailbox size limit is removed

7889

[Improvement]

omaddu should create ALL Special Folders during Mailbox creation

8364

[Defect]

omcheck etc. refers to OpenMail and needs to be re-branded

10255

[Improvement]

Better handling of T'Birds "undisclosed-recipients:;" for RFC-2822 compliance

11262

[Defect]

Changing description of a recurrence exception not reflected properly in iCal

11990

[Defect]

Error occurs while creating a subfolder to a public folder, though the necessary permissions are set.

12753

[Defect]

Error when opening an appointment in SWA, previously modified in OL

13357

[Improvement]

sximapprep should be removed from server package

14147

[Improvement]

Archiver should expand internal PDL mails into members for header

15616

[Improvement]

sxmboxexp should allow Recovery Folder items to be exported

15766

[Defect]

segmentation violation in fprintf for omsmtpd

15814

[Enhancement]

Server Support for selectable sender SMTP address

15934

[Improvement]

omcontain/omqdump should not require diag password for root

16031

[Defect]

PUT of VTODO fails with 500 InternalServerError

16427

[Defect]

Should not allow empty-string passwords anymore.

16441

[Improvement]

sxmaint should be able to exclude some mount points from disk space check

16605

[Enhancement]

ldapmapper needs option to ignore instance without ldap-server

16707

[Defect]

Using the BCC archiving method with an external recipient results in duplicate ERROR queue message when resubmitting.

16816

[Enhancement]

Archiving for individual users and mailnodes

16915

[Documentation]

scalix-server man page is talking about deprecated commands

16967

[Enhancement]

omtidyu/omtidyallu should use consistent naming for "sent items"

16976

[Defect]

FREEBUSY not working properly in iCal

17058

[Improvement]

SMTP relay should come up with a more appropriate error string for unknown users

17173

[Defect]

Error message logged during upgrade

17395

[Improvement]

SMTP relay should be able to log incoming SMTP conversations so that they can be replayed

17422

[Improvement]

Server-Side Support to distinguish various IMAP Session types

17918

[Defect]

enterprise user limit warning does not work with sys language set to en_AU.UTF-8

18087

[Improvement]

sxaa -n <username> should provide graceful error message

18146

[Defect]

ICAL SEQUENCE number in iCal.app Recurrence Exception is not preserved by server

18244

[Improvement]

ommapiperms should display ACL entries from the attribute portion

18290

[Defect]

about GB2312 encode issue with SWA - superset GBK and GB18030 problem

18304

[Improvement]

Need infrastructure to support per-mailnode settings

18331

[Defect]

For recurrence with exception where main rule has non-zero seconds recurrence-id is incorrect

18361

[Defect]

ommapiperms for German/Spanish users in Outlook shows strange results

18441

[Improvement]

xport.in should understand Scalix encoded message with quoted-printable encoding

18782

[Improvement]

unix.in disk I/O load reductions

18994

[Regression]

Modifying all future reoccurring events in iCal.app shows an error and some appointments are missing

19042

[Improvement]

clean up sxmaint - remove ALL commented out ACTIONs

19204

[Enhancement]

Server LVID update

19292

[Improvement]

Should deprecate unused tray quotas and sanction in omlimit

19293

[Enhancement]

Support per-mailnode user quota and sanction in 'omlimit'

19295

[Enhancement]

Local Delivery to suppress autoreply to spam PDL sender

19326

[Improvement]

12.5 Archiving Improvements

19327

[Improvement]

Alias Expansion to properly support new Archiving format

19342

[Enhancement]

Need per-user UUID headers

19343

[Enhancement]

Archiver should support Microsoft Journaling message format.

19344

[Enhancement]

Multichannel-Archiving and Archiving filtering rules

19385

[Enhancement]

Add ability to de-dupe messages before archiving in multi-server environments

19437

[Documentation]

Need to provide Reference documentation for archiver tweaks and message format

19515

[Defect]

BUSYSTATUS change in an Exception is not supported when updated via ICAL

19603

[Enhancement]

sxdu command to support hosting situation

19712

[Improvement]

License Counting with non-cumulative licenses in multi-server environments needs to take options into account

19799

[Defect]

SWA originated recurrence - SWA view corrupt (lost body text etc) after Outlook adds exception with description

19811

[Enhancement]

Support Mailnode Hosting tenants spanning multiple server

19814

[Enhancement]

putting messages arriving for users being modified in a hold

19844

[Improvement]

UAL spawns omchown during UAL_MVITM or UAL_CPYITM execution as result of certain IMAP activity.

19963

[Defect]

Messages with missing Content-Transfer-Encoding value cannot be parsed by SIS indexer

20059

[Defect]

For IMAP clients, sxdu may not properly account for data elements added using "APPEND"

20062

[Defect]

Extended LIST attributes only appear in LIST response after CORE restart

20069

[Improvement]

Need to be able to lock AS use to a version, not a date

20111

[Defect]

scalix-caa.log contains passwords in clear text

20166

[Improvement]

Requirements for Universal Delegate access

20175

[Improvement]

Selecting the same open folder in a satellite should not cause core and satellite IMAP processes to resync all content

20203

[Improvement]

Add support to sxhostcfg for checking and fixing individual mailnodes

20241

[Defect]

Extended LIST attributes missing in LIST response for Other Users namespace

20251

[Defect]

UIDNEXT (SELECT) not updated properly after a sequence of APPENDs

20254

[Improvement]

extend ACL infrastructure to support new 'mailnode' type

20262

[Improvement]

omldapsync to support ActiveSync directory attribute

20265

[Improvement]

extend UAL to perform remote mboxadmin checks

20291

[Defect]

SMTP relay logs warnings to daemon.stderr

20295

[Enhancement]

omtidy*u should be able to move messages to a folder

20296

[Defect]

Core dump in satellite in.imap41d at imap41_auth.c:1025 in strcasecmp

20307

[Enhancement]

SMTP Sender (friendly name) Changes for 12.5

20310

[Improvement]

Server to set content and encoding of Sender display name in a consistent way

20321

[Improvement]

Routes should allow wildcards to be used in any position.

20339

[Enhancement]

Remove sxhostcfg from deploying as a saclet plugin when enabling hosting

20345

[Improvement]

Should remove "Notify" Action from the Scalix Rules Wizard

20373

[Improvement]

omcontain does not display MAPIRelFlags

20391

[Improvement]

Add uid value to EVS output for arrived/modified/deleted events

20408

[Defect]

om*acln command manpages should refer to sxacl* commands

20420

[Defect]

A variety of mailbox paths could cause SELECT to behave incorrectly

20424

[Defect]

Frequent Error "Could not find a valid container entry" in omshowlog

20447

[Improvement]

mime.browser should add message's DREF as X-Scalix-Header

20454

[Enhancement]

sxmaint -frequent should monitor Inj/indexwork

20494

[Defect]

sxhostadd and sxhostdel need to use absolute path for calling omcheckgc

20593

[Defect]

Default Server encoding for RFC-2047 Sender name produces rubbish.

20611

[Enhancement]

Should be able to set SWA and Sender flags through omldapsync

20634

[Enhancement]

CLI to encode/decode IA friendly name on input/output

20659

[Defect]

SPAM email causing service.router to crash

20662

[Regression]

GETACL reports incorrect email address for user deleted from server.

20667

[Defect]

Sender IA comparison in SMTP relay is case-sensitive

20668

[Enhancement]

Ability to selectively allow sender provided SMTP friendly names

20672

[Defect]

Cannot send email with new sender IA until re-started.

20685

[Improvement]

audit.cfg in-file documentation should reflect that editing it is not supported.

20697

[Improvement]

Server Work to support People Mover functionality

20698

[Improvement]

Change default for MSL MIME address charsets tweak

20699

[Enhancement]

Post 20310: Tweak for unix.out and MSL to quote rfc2047 name containing certain characters.

20759

[Defect]

Mailing to PDL by rfc822 address via SMINTFC relay fails in interop scenario

20799

[Defect]

minor typo in omtidyu manpage

20801

[Defect]

BES does not display HTML embedded images when using IMAP APPEND

20825

[Defect]

In SCALIX Archiving format, GUID is sometimes not logged

20865

[Regression]

The messages moved back to Inbox were not displayed until ...

20900

[Defect]

SenderIA: UAL does not handle friendly name with comma properly

20917

[Improvement]

Hostname appends incorrectly if incoming SMTP recipient IA has comment

20924

[Defect]

Lightning 1.0pre attendee acceptance update fails (RECEIVED-SEQUENCE/DTSTAMP unsupported)

20925

[Improvement]

Tasks should always be output in ical format from Imap server regardless of oddpost mode state

20973

[Enhancement]

Expose Task related MAPI properties in ICAL - task_total_work,task_actual_work,task_status,mileage and companies

20976

[Defect]

omsetsvc command for new IMAP daemon in OM-CORE.inst is incorrect

20982

[Improvement]

Tasks created in Outlook need to have a Timezone created in the generated ICAL

20994

[Improvement]

Server should better handle nested multipart/alternative with repeating boundary identifiers

21016

[Defect]

Newly created sub-folder of Sent Items is not handled by platform

21017

[Defect]

Message counts become incorrect when flags are changed in the SELECTED state

21052

[Enhancement]

Need sxmboxexp --nocontent to exclude msg and basic items

21053

[Enhancement]

Need service.router to default to SR_RESOLVE_MASK=IA/p>

21069

[Defect]

iCal.app 4.0.1 is not supported by Scalix

21097

[Enhancement]

Should be able to set ARCH_TNEF_ENCODE per-mailnode

21102

[Defect]

omcheck reports file permission error after installation

21103

[Defect]

Can not open attachment file after re-login

21205

[Defect]

Inconsistent results in X-GET-DELEGATE-CAPS vs. X-GET-DELEGATES

21209

[Defect]

Searching against a newly-created user fails

21234

[Defect]

Creating a Reply rule fails when rules with AA_NO > 1000 exist

21235

[Defect]

sxmboxexp - SegV when exporting msgs with MAPI props area larger than expected

21265

[Improvement]

Indexer opens/closes USERLIST unnecessarily

21300

[Defect]

CN name is displayed instead of CN-TX when invitation is from Lightning

21306

[Enhancement]

Need omsmtpd manpage

21398

[Defect]

omshowu --help typo - "mailode" instead of "mailnode"

21438

[Defect]

Errors when syncing certain WebCal folders

50027

[Defect]

Spam Assassin gives a score to Outlook and SWA emails marked as 'important' or 'urgent'.

50029

[Defect]

IMAP coredump when sending meeting request from mobile device

50031

[Defect]

CDA server aborts at Scalix start-up

Scalix Admin Tools

16534

[Improvement]

SAC: Change "logout" to "log out"

18269

[Defect]

User's Mail storage information is not refreshed

18483

[Defect]

Plug-in's domain not appearing under local domains list

18708

[Defect]

When creating multiple users in SAC, right pane should update as left pane updates

18748

[Defect]

sxhostdel didn't remove all info from SAC UI

18759

[Defect]

LDAP search is broken when | (OR) operator is used with omMailnode filter

18789

[Enhancement]

Integrate mailnode hosting scripts into SAC interface

18790

[Enhancement]

Hosting Mailnode management functionality to become part of SAC core

18794

[Enhancement]

New wizard for creating mail node in hosting mode

19009

[Defect]

Percentage of quota used " display does not work with 'Use server limit'

19199

[Enhancement]

Additional per-mailnode settings for Hosting setups

19599

[Enhancement]

Functionality for per-Mailnode quota functionality

19812

[Enhancement]

SAC to work correctly with Multi-Server hosting environments

19979

[Enhancement]

Add new 'Tenants' tab to manage multi-server hosting environments

20070

[Enhancement]

SAC should be able to show ActiveSync usage/license data

20266

[Defect]

Admin Console toolbar has strange "undefined" icon and misbehaves

20355

[Defect]

Local domains list contains invalid empty domains in SAC

20379

[Regression]

Umlauts not correctly shown in German UI

20532

[Enhancement]

SAC to support setting and viewing total number of standard, premium, and activesync users

20569

[Enhancement]

Support for setting UL_SENDER_IA flag on per-server and per-user basis

20913

[Enhancement]

Fix MailNodeQuotaPane alignment

20968

[Enhancement]

Tenant summary and quota allotment improvements

21129

[Defect]

Update German translations

21163

[Defect]

Disable editing of AS if user is not mastered by Scalix

21219

[Defect]

Remove rules and dirsync agreements when no longer needed

50025

[Defect]

delegated admin can create users on other mailnode

50030

[Defect]

multiple issues with Tenant info module

-

[Enhancement]

Support IE 11 (it does not worked and logs errors t a log file)

-

[Enhancement]

added token (Date.timestamp) for each SOAP requests made from Java Script to prevent caching requests.

Scalix Search and Index Services

20919

[Defect]

Lucene LockObtainFailedException prevents item from being indexed

19231

[Improvement]

IS index I/O errors should report the index file

-

[Defect]

Sis will decode email according encoding specified at headers and aad to index file (before that sis files to process email and do not add it to the index storage)

Scalix CAA

21215

[Defect]

Password recorded in world readable logfile

Scalix Platform (API)

16717

[Defect]

Fix text/html preview api

50035

[Enhancement]

User Re-auth improvement

21328

[Enhancement]

Improve Platform StatusServlet to output meaningful usage info

21320

[Enhancement]

NOOP on users imap connection shouldn't use synchronization

21028

[Enhancement]

Modernize data structures and synchronization approach to session and context caches

20176

[Enhancement]

General Imap efficiency improvements for SWA/Wireless/Platform

19671

[Enhancement]

MailboxServlet should handle "text/calendar" data more intelligently

-

[Enhancement]

Decreased amount of connections to scalix postgresql database

21365

[Defect]

Disable tasks folders other than special one for SWA renderer

21326

[Improvement]

Platform database schema is calculated twice in the code

21189

[Enhancement]

In a folder name, special characters of HTML are not HTML-escaped, allowing for JavaScript injection

21099

[Defect]

Notes field of modified instances of a recurring appointment should be correct

20965

[Defect]

Platform fullSynch / sxpsql-reindex 'REINDEX TABLE' deadlock detected

20151

[Regression]/[Improvement]

Search results corrupted after upgrade to latest Scalix version

20729

[Enhancement]

Deleted but not expunged messages are handled poorly in the API

21044

[Defect]

LDAP response strings are not decoded

20945

[Defect]

SWA should only offer tasks functionality in UI when supported by the server.

21029

[Defect]

Messages are not downloadable in mobile devices for Sub-Folder named with special Characters.

17994

[Defect]

iCal.app silently deletes scheduling update messages from inbox

16760

[Improvement]

Notes field of modified instances of a recurring appointmentshould be correct

20357

[Defect]

wm5/6 umlauts not properly displayed when contact list is used to send message

21028

[Enhancement]

Modernize data structures and synchronization approach to session and context caches

20115

[Enhancement]

Platform URL links returned in messages should be useable

21380

[Defect]

Calendar Query with Date Range reports 0 results

-

[Defect]

Escaping characters when render xml (escapes http://www.columbia.edu/~kermit/utf8.html + xml special chars) before that it's just raised exceptions

Scalix Web Access (Webmail)

50037

[Defect]

Fix incorrect parsing of Disposition-notice-to after update to 12.5

-

[Defect]

Surround username with double quotes in “From” field

-

[Defect]

Webmail javascript hangs – new function to get Daylight Savings Day implemented

-

[Defect]

Still unable to re-schedule a appointment reminder within Webmail on Mozilla Firefox. The drop-down does not function. Accordingly the only option for "snooze" is the default 5 min. This functionality seems to work ok in Google Chrome.

-

[Improvement]

Duplicated Users in list at webmail

-

[Defect]

Edit Appointment: incorrectly text at description after saving form

-

[Improvement]

SWA should not generate X-MSMail-Priority header line - FIXED

50023

[Defect]

"login successful" window not properly drawn

50024

[Defect]

A column in a user password causes errors and severe errors and unresponsiveness of SWA

-

[Enhancement]

Time zone will set to default in system when creating appointment

-

[Feature]

Limited task functionality (tasks will work only if api will be enabled)

-

[Feature]

Show user aliases when composing email

-

[Improvement]

SWA produces warning message for IE10 (can be tested on ts1)lets say better works with ie10

-

[Enhancement]

Added token (Date.timestamp) for each SOAP requests made from Java Script to prevent caching requests.

Scalix Wireless (ActiveSync)

50035

[Defect]

Use Cookie for request to API

-

[Improvement]

Increased timeout for ping request according Microsoft recommendations

-

[Improvement]

Ignoring not valid email addresses such as This email address is being protected from spambots. You need JavaScript enabled to view it.@tm.site.com

17991

[Improvement]

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

19269

[Enhancement]

Support ActiveSync Mailbox Search functionality

19833

[Defect]

Meeting accepted on device is not labelled as such in SWA

19871

[Defect]

Revised appointment and meeting request handling for ActiveSync

19871

[Defect]

Revised appointment and meeting request handling for ActiveSync

19883

[Defect]

SocketException: Broken pipe Warn messages" in the logs

19940

[Defect]

Content change in an exception went back to the original text

19959

[Defect]

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

19982

[Defect]

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

19986

[Defect]

Windows Mobile 6: Modifying appointment notes causes various anomalies

20032

[Defect]

Duplicate appointments created when meeting request has already been automatically tentatively accepted See dependency tree for bug 20032

20108

[Enhancement]

Required behavior on AS version upgrades

20276

[Defect]

Support mime message fetching for body preference type '5' / MIME

20371

[Defect]

iPhone: Does not show Scalix-forwarded message

20468

[Defect]

Nokia, Android: Device Sync fails while processing messages containing MESSAGE/RFC822 part.

20563

[Enhancement]

Implement ActiveSync Settings Command

20564

[Enhancement]

Implement handling for Out of Office set/get

20975

[Defect]

Palm Pre: Sent Items and other folders where name contains space: messages are not downloadable

21025

[Improvement]

Threaded HTTP connections to Platform use naive connection parameters

21026

[Improvement]

Modernize data structures and synchronization approach to session and context caches

21211

[Defect]

"BusinessAddressCity" not synced to device from SWA/OL

21272

[Improvement]

ontacts with only last name created from OL displays in mobile devices as first and last name.

21316

[Improvement]

HTTPClient connections are improperly shared among user requests

21317

[Defect]

ActiveSync to Platform cookie handling is inconsistent

21331

[Improvement]

Disable authentication for HTTP OPTIONS commands to the WirelessServlet

21332

[Enhancement]

Create a new status servlet that displays current session and user info for Wireless context

21337

[Enhancement]

Increase wireless logging granularity to enable more discrete logs

21397

[Defect]

System error occurs while syncing contacts on Nokia device

50026

[Defect]

Office 97-2004 documents can not be opened on iOS 7.1.2

50028

[Defect]

ActiveSync usage affects unread status after some time

-

[Defect]

Calendar items time zone issue (Robert and Calendar items )

-

[Defect]

Escaping characters improvement

-

[Defect]

Skipping not valid email in cc, bcc fields

Scalix Installer

-

[Defect]

Fixed java version check

-

[Defect]

Implemented new timeouts

-

[Enhancement]

decreased number of items when showing which dependencies is needed for e.g. was like this

-

[Enhancement]

use command 'rpm -qp {file}' to determine is file valid RPM package if command 'file' not available in the system

-

[Enhancement]

use 'ss' command line utility if 'netsat' is not available

-

[Enhancement]

fix jre-related error messages

-

[Enhancement]

added more informative messages about installed or not installed java

-

[Enhancement]

Added additional check to determine hostname

50006

[Enhancement]

add automatic dependencies resolving

-

[Enhancement]

Installer creates back up copy of files before changing them. for e.g. server.xml -> server.xml_day_month_year_hour_min

-

[Enhancement]

Configure sac / ewbmail to use https instead of http

-

[Enhancement]

keep JRE as a part of installer

-

[[Regression]

Removed GUI (gnome interface) from installer

-

[Enhancement]

Rhel 7 support

-

[Enhancement]

Stable SCalix installer for Debian script (available here https://github.com/scalix/Debian-installer)

Scalix Postgress

-

[Improvement]

added cron to dependency list for rpm/deb

Global JAVA Enhancement

-

[Enhancement]

Scalix XXE injection Issue description https://www.sec-consult.com/fxdata/seccons/prod/temedia/advisories_txt/20141031-0_Scalix_Web_Access_XXE_v10.txt

-

[Enhancement]

Support of jre 1.5 is dropped and not supported any more. Supported JRE from 1.6 to 1.8

-

[Enhancement]

Tomcat updated from 6.0.36 to 6.0.43 version.

-

[Enhancement]

cmd /opt/scalix-tomcat/bin/sxtomcat-webapps has new argument to add for any existing application rule to use https instead of http /opt/scalix-tomcat/bin/sxtomcat-webapps --forcehttps {instance} {caa|mobile|platform|res|sis|webmail|wireless|sacapi} and then restart apache (#service httpd restart)

-

[Enhancement]

All components is better working with not ascii (default utf-8 encoding for all requests/responses)

Scalix Integration Tools

-

[Feature]

Added integration with Samba 4

-

[Improvement]

Samba 4. Added new attribute CN=scalixActiveSync

For a list of Fixes/Changes of Scalix 12.1 and previous versions, please check the related release notes listed at http://www.scalix.com/support-resources-documentation

 

Supported Environments

Scalix 12.5.1 is supported on the following platforms:

Scalix Server+Installer:
  • Full support for CentOS 6 and 7 (x86 and x86_64)
  • Full support for RHEL 6 & 6 (x86 & x86_64)
  • Full support for SLES 11 (x86 & x86_64)
  • Full support for ORACLE Linux 6 & 7 (x86_64)
  • Full support for OpenSUSE 12 & 13 (x86 & x86_64)
  • Support for Ubuntu 13 and 14 (x86 & x86_6
  • Support for Debian 7 (x86 & x86_64)
  • Beta IBM support for RHEL 6 (ppc64 & s390x)
  • Use CommTouch anti-spam engine 8.0 (optional license)
  • Postgres up to 9.3 support
  • Tomcat 6.0.43 support
  • Installer SSL configuration
  • JRE 1.6 and later support
 
Scalix Connect for Outlook:
  • The following combinations of Windows and Outlook are supported
Component Outlook version (32bit) Outlook version (64bit) BETA
XP 32bit SP3 2003 SP3, 2007 SP2, 2010 -
XP 64bit SP2 2003 SP3, 2007 SP2, 2010 -
Vista 32bit SP2 2003 SP3, 2007 SP2, 2010 -
Vista 64bit SP2 2003 SP3, 2007 SP2, 2010 -
Win7 32bit 2007 SP2, 2010, 2013 -
Win7 64bit 2007 SP2, 2010, 2013 2013
Win8 32bit 2007 SP2, 2010, 2013 -
Win8 64bit 2007 SP2, 2010, 2013 2013
Win 2008 R1/R2 Terminal Server 32bit 2010, 2013 -
Win 2008 R1/R2 Terminal Server 64bit 2010, 2013 2013
Win 2012 R1/R2 Terminal Server 64bit 2010, 2013 2013

·         {C}{C}NOTES:

o   Other combinations of Service Packs may work also but are not part of our QA process.

o   Scalix Web Access and Scalix Management Console: IE9, 10 and 11 on Windows; Firefox 27.0 on Windows, Mac OS/X or Linux. Other browsers based on the IE and Gecko engines may work. Chrome 31.0 on Windows, Mac OS/X or Linux.

System Requirements:

Please the Scalix Installation guide for current minimum system requirements.

Alert

Note that the choice of storage environments will have a major influence on performance of your Scalix system. Scalix as an application is largely I/O-bound, using variable, small-blocksize random read/write synchronous file I/O.

Also note that Scalix does not support putting a Scalix Message Store on a NFS- or SMB-based storage device such as a NAS Filer. Performance issues and/or Message Store corruption can occur. This is true for all Linux distributions using Linux 2.6.x kernels as the NFS client software in these kernels have known issues with file locking operations, which Scalix heavily relies on.

We suggest putting the Scalix message store on a Hardware RAID Array, using RAID 1+0 for best performance. The use of RAID 5 or RAID 6 will result in substantially worse performance due to the nature of Scalix Disk I/O patterns (small, synchronous random writes) and is not recommended. In larger installations, we do recommend using iSCSI- or FibreChannel-based SAN storage. We also recommend the use of battery-backed write cache on the RAID controller where available

 

Packaging

The Scalix 12.5 Release consists of a self-extracting shell archives for Linux and a separate ZIP file download for the Windows components.

The Components in the package and their respective version numbers are as follows:

Component

Package

Build

Scalix Installer

Linux .bin

12.5

Scalix Server

Linux .bin

12.5.1.14746

Scalix Character Set Detectors

Linux .bin

1.0.20071031-2

Scalix Libical

Linux .bin

0.44.976-2

Scalix iconv Extras

Linux .bin

1.2

Scalix Management Services (SAC, RES)

Linux .bin

12.5.1.14721

Scalix Messaging Services ("Platform")

Linux .bin

12.5.1.14726

Scalix Web Access (SWA)

Linux .bin

12.5.1.14725

Scalix Mobile Web Client (Mobile)

Linux .bin

12.2.0.14597

Scalix Search and Indexing Services (SIS)

Linux .bin

12.5.1-14722

Scalix Text Extractors for Indexing and Search *

Linux .bin

1.0

Scalix DB (Postgres)

Linux .bin

12.5.1-14722

Scalix Tomcat Connector

Linux .bin

12.5.1-14721

Scalix Tomcat

Linux .bin

6.0.43

Scalix Connect for Evolution**

Linux .bin

11.4.6.123

Scalix Connect for Outlook

Windows .zip

12.5.1

Scalix Migration Tool (SMT) ***

Windows .zip

11.4.2.598

Scalix Active Directory Extensions (ADE) ****

Windows .zip

11.4.2.753

 

* Text extractors allow the indexing of binary Microsoft Office (Word, Excel and PowerPoint) and PDF documents. They are only available as part of Scalix Small Business Edition (SBE) or Enterprise Edition (EE)
** For Scalix Community Edition downloads, Scalix Connect for Outlook (MAPI) is a separate ZIP-file download.
*** The Scalix Migration Tool is a separately-sold product to migrate eMail, Calendar, Contacts and other objects from Exchange 5.5, 2000, 2003 to Scalix. Please contact
Scalix Sales for details.
**** The Scalix Active Directory Extensions are only available as part of Scalix Small Business Edition (SBE) or Enterprise Edition (EE)

 

 

Known Issues and Workarounds

Scalix Admin Tools

Bug

Issue

Comment/Solution/Workaround

18726

When creating a mailnode using the Mailnode screen in SAC, public folder structure in hosting mode is not created and users cannot login.

Do not create the Hosted Mailnode using the Mailnode Screen in SAC; use the provided SAC Hosted Mailnode plugin instead. In Scalix 11.5, the functionality will be fully embedded into SAC and the plugins will go away

20630

Default values for LDAP size limit inadequate

The size limit for LDAP queries in SAC may be insufficient for even simple installations. The default will be raised in a future release. The limit can be manually adjusted in ubermanager.properties if the said error appears

Scalix Server

Bug

Issue

Comment/Solution/Workaround

4108

Umlauts in passwords do not work correctly

It is recommended not to use non-ASCII characters in passwords. For best security and compatibility, use a combination of ASCII characters, numbers and special characters. non-ASCII characters in passwords are subject to client processing and are not likely to work across different clients

10641

ommodu --resource Y does not create calendar folder and set calendar permissions

It is not recommended to change a normal user to a resource. Delete the user mailbox and create a new one, which will have the calendar folder setup. Otherwise, you'll have to log-in to a calendar-enabled client with the user and setup folder permissions on the Calendar manually

15824

LDAP server should disable anonymous binds by default to allow for better security

The desired effect can be achieved by setting LDAP_MUST_AUTHENTICATE=TRUE in general.cfg

15908

sxaa: An applied filter including non-ascii characters is not effective.

This will be fixed in a future release of Scalix

16919

omtidy omtidyallu options -d -w0 cause problems

The combination of options will be disabled in a future release of Scalix and should be considered unsupported and deprecated

16965

RSS ProxyFolder should keep history of entries independent of server feed content

The behavior will change in a future release of Scalix

17021

Some special characters not allowed in Proxy Folder names

Do not use any of these characters in proxy folder names: "[", "]", "$", "%", "*", "#" or "/"

17220

Can't recognize CJK user names in Proxy Folder setup

Find out the ASCII version of the Scalix username (as per omshowu) and use this to create the proxy folder as a workaround

17374

omscan server cycle will not run if time was in the future during last cycle

Reset the Server Cycle timer using omscan -Z

17442

sxdu -r should automatically correct wrong recovery folder size.

The wrong size information can be corrected by running omscan in "-S" fix mode and then deleting another item, so that it gets added to the recovery folder. Future versions of Scalix will automatically correct the wrong information

17686

Allow for unlimited number of elements in a folder, including Inbox.

Scalix 12 will eventually allow for an unlimited number of items in each folder. For Scalix 11, the limitations are 128K (=131072) items per folder (including subfolder entries, but NOT including subfolder items) and 32K (=32767) when Outlook is supposed to access the folder using Scalix Connect

17772

ommodpdl fails when CN has more than 40 characters

Use PDL names shorter than 40 characters

20673

Duplicate sub-Folders Created in BB device after moving messages in SWA.

This is a known issue with Scalix Connect for Blackberry Enterprise Server. It will be fixed in a future release

Scalix Messaging Services

Bug

Issue

Comment/Solution/Workaround

16557

CalDAV should allow viewing of attachments

This functionality will be added in a future release of Scalix

17007

CalDAV scheduling POST to Outbox should result in message in Sent Items

This will be improved in a future release of Scalix, as the CalDAV-Scheduling standard evolves towards a full RFC

Scalix Web Access

Bug

Issue

Comment/Solution/Workaround

14911

Folder name having greater then (<) and (>) lesser then sign are not displayed in folder tree

Do not use "<" and ">" characters when naming folders for use in SWA

16549

Invoking SWA within a frameset yields erroneous error message

Using SWA inside a frameset is currently not supported. A future version of SWA will be made more portal-friendly

16813

Attaching file having semicolon in filename removes all the earlier attachments.

Using semicolons in attachment names is not supported for SWA. The behavior will be improved for a future release

17035

SWA appears to allow changes to read-only Proxy Folder

Future versions of SWA will display proxy folders differently and not allow changes using UI limitations

17693

SWA test button should trigger browser prompt to install appropriate media plugin on IE7

Correct Media plugins must be installed manually before the SWA session for SWA to play sounds correctly on receiving email

17828

Folder names with ! don't work in SWA, do in Outlook, cause issues in sxmboxexp/imp

Do not use folder names containing exclamation marks ("!") to be able to use a folder in SWA

19578

Can't open attachment with apostrophe in the file name

In Internet Explorer and when running on Vista, files with apostrophes in the name cannot be opened when received as an attachment. This will be fixed in a future release. As a workaround, please re-send the file with the attachment renamed. In general, it is not recommended to use filenames with special characters for attachments

20215

Search Result Pane returns blank window, when pop-up blocker is turned on.

The search window will be integrated into the main window in a future release of Scalix. Popup handling will be improved. For the time being, popup blocking must be fully disabled for SWA to work correctly

20234

Keep getting "Your request to the server has timed out. Keep trying?" popup message.

Scalix 11.5 will vastly improve on SWA used bandwidth and how timeouts are managed. The number of occurrences of this (valid) timeout will be reduced

20787

SWA fails to send mail to the PDLs having special characters in their names.

Certain special characters like double quotes ("), ampersand (&), angle quotes (<>) or semicolon (;) should not be used in the display name of a personal distribution list in the SWA contact folder; otherwise, it will not be possible to send email to these distribution lists

Scalix Connect for Outlook

Bug

Issue

Comment/Solution/Workaround

-

Extended Japan Support ISO-2022-jp does not work yet

Will be fixed in future Scalix version

-

Outlook 2010/2013 sometimes freezes on accepting meeting requests IF there are two users with the same CN on a server.

Will be fixed in future Scalix version

723

OLE embeded objects are not viewable on the message in the Sent Items folder

The use of embedded OLE objects is not supported with current versions of Scalix Connect

10333

MAPI limits number of items displayed in a folder to the first 32767

Currently, only the first 32767 items in any folder can be accessed through Outlook/MAPI. This limit will be lifted in a future release of Scalix

14634

Subject displays empty in sent items folder when mail sent with more than 178 i18n chars.

This issue will be resolved in future versions of Scalix

14766

Scalix (Outlook) Help doesnt show up on Vista and Windows 7.

Online help for Scalix Connect for Outlook is currently unavailable on Windows Vista. This will be fixed in a later release

14829

System address book cached copy should be updated on change

User must wait for the AB_DOWNLOAD_INTERVAL to expire and/or restart Outlook for Address Book Changes to be propagated to SmartCache

15549

Support for "To-Do Bar" search for Tasks on Outlook 2007

This feature of Outlook 2007 or higher will be supported in Scalix 11.5

15587

When searching in Outlook the "search in subfolders" option is ignored for subfolders with special characters in their names.

The behavior will be improved in a future release of Scalix. It is not recommended to use non-ascii characters in folder names for maximum client compatibility

15877

"Recall message" functionality should be supported with Scalix Connect.

This may be implemented in a future release of Scalix. It should be noted, however, that the functionality is only weakly implemented in Outlook, as in many cases only a "Disregard previous message" message can be provided

16693

Repairing connector installation gives outlook information store error.

Do not use the "Repair" option at this time. If there are any issues with the installation of Scalix Connect for Outlook, uninstall and re-install the connector

17177

Regression: Setup.exe uses CPU more than 95% while setup is triggered from shared folder.

This is a known issue with the Scalix Connect for Outlook installer. Copy the setup.exe file to a local drive before launching the installer

17203

Progress indicator sometimes not visible or updated on OL12

This issue happens rarely with Scalix Connect for Outlook 11.4.5

17888

iTunes does not support sync with iphone using iTunes OutlookSyncClient

Support for wired synchronization using Outlook and iTunes will be supported in Scalix 11.5. Scalix ActiveSync, providing for Push Email and wireless calendar and contact synchronization, could be used as a better alternative

18322

Outlook Connect does not install if filename is renamed in Vista

Leave the filename of the installation image as Setup.exe

18488

Outlook 2003 used right after installation can report error: "Unable to open default email folder..."

Start Outlook once and activate it before using it with Scalix Connect

19384

WDS: Support indexing of non-cache profiles and ensure it scales appropriately

As of Scalix 11.4.5, Windows Desktop Search will correctly index SmartCache profiles. Future versions will enable non-cached profiles to be indexed as well

19535

Support for Blackberry Desktop Manager

Blackberry Desktop Manager v4.1 and v4.2 can be enabled to work with Scalix using a patch to those products provided in the "extras" folder of the Scalix Connect distribution. Future versions of Scalix connect will support BBDM without such a patch

19584

Scalix Connect to support Google Desktop Search

A future version of Scalix Connect will support Google Desktop Search. Use Windows Desktop Search with Scalix Connect 11.4.5 or higher as a workaround

Scalix Installation

Bug

Issue

Comment/Solution/Workaround

15014

Installation fails if hostname contains uppercase characters.

Use a hostname for your scalix server consisting of all-lowercase characters

15770

Installer should be smart enough to handle running scalix server with license upgrade during installation

If you need a different Scalix license key after a planned upgrade, install that license key before running the installer to upgrade the software