Migration Guide 1.1.x to 1.2.x

=====

Required Changes

There are no required changes that need to be made in order to upgrade an application from 1.1.x to any 1.2.x version of Sirius.

Other Changes

Cluster Config Format

The format of remote akka address strings changed between the 2.0.x and 2.2.x versions. Prior to the change, all akka addresses, remote or local, began with the akka:// prefix. After the change, akka users must specify the protocol when addressing remote actors (e.g., akka.tcp://).

Since the cluster config file is based on akka addresses, the cluster membership system of Sirius was affected by this change. Sirius 1.2.0 ships with a backwards-compatible layer on top of the cluster config, which will change addresses that start with "akka://" to "akka.tcp://" (or, if SSL is enabled, to "akka.ssl.tcp://").

It is recommended that users specify the protocol in the cluster config with the new-style prefixes, instead of the old. The old-style will eventually be deprecated and support will be removed.

SSL Support

The 1.2.0 release includes support for akka over SSL. See commit 10e5116 for more details, including the additions to the SiriusConfiguration object. To enable SSL, you will need to set all of the following:

• ENABLE_SSL
• KEY_STORE_LOCATION
• KEY_STORE_PASSWORD
• KEY_PASSWORD
• TRUST_STORE_LOCATION
• TRUST_STORE_PASSWORD You may also want to set:
• SSL_RANDOM_NUMBER_GENERATOR

See the descriptions in SiriusConfiguration for more information.

Scala version updated

The Scala version used in Sirius has been updated to 2.10.2. If you're developing sirius and using SBT or Scala directly, you will need to update your version of Scala. If you're using maven to build, it should automatically update the libraries.