MarkLogic 9 Product Documentation

Release Notes — Chapter 2

Supported Platforms

For a complete list of supported platforms, see Supported Platforms in the Installation Guide.

Supported Filesystems

For a complete list of supported filesystems, see Supported Filesystems in the Installation Guide.

Upgrade Support

This section describes upgrade support to MarkLogic 9. For details on installing MarkLogic Server and for the upgrade procedure, see the Installation Guide.

MarkLogic Early Access does not support upgrade. This section describes upgrade for 9.0-1 and later.

Upgrading is supported from 7.0-6 or later. If you are running a release prior to 7.0, you must first upgrade to MarkLogic 7 or MarkLogic 8 before upgrading to MarkLogic 9. If you are upgrading a cluster, you must first upgrade the node in which the Security database forest is located before you upgrade other nodes in the cluster.

MarkLogic Corporation strongly recommends performing a backup of your databases before upgrading to MarkLogic 9. Additionally, MarkLogic Corporation recommends that you first upgrade to the latest maintenance release of MarkLogic 7 or MarkLogic 8 before upgrading to MarkLogic 9.

An upgrade from MarkLogic 7 or MarkLogic 8 does not require a reindex. If you are upgrading from a previous release that does require a reindex and you choose not to reindex your databases, the database will run in compatibility mode, depending on the version of MarkLogic Server in which they were last loaded or reindexed. Running in compatibility mode will disable certain MarkLogic 9 features (as well as earlier features depending upon which compatibility mode it runs) and may treat all content in the database as English language content. For details on database compatibility, see the Installation Guide.

If you are upgrading clusters with DB replication configured, see Upgrading Clusters Configured with Database Replication in the Database Replication Guide for details.

MarkLogic 7 and later includes a new rebalancing feature with a more efficient document placement algorithm. Upon upgrade, databases from previous MarkLogic releases are set to use the legacy document assignment policy, which is the same as used in previous MarkLogic releases. If you do plan on reindexing an upgraded database, MarkLogic recommends that you consider setting your databases to use the new bucket document assignment policy. The bucket policy is more efficient for rebalancing your database across forests if you add or remove forests from your configuration. For more details, see Database Rebalancing in the Administrator's Guide.

There are some known incompatibilities between MarkLogic 8 and MarkLogic 9. You might need to make some minor code changes to your MarkLogic 8 applications before they can run correctly in MarkLogic 9. For details on the incompatibilities, see Known Incompatibilities with Previous Releases. For instructions on upgrading to MarkLogic 9, including information about database compatibility between MarkLogic 8 and MarkLogic 9, see the Installation Guide.

If you are upgrading to MarkLogic 9.0-4 or later, you may have to install MarkLogic Converters package separately. For more details, see MarkLogic Converters Installation Changes Starting at Release 9.0-4 in the Installation Guide.

If you upgrade to MarkLogic 9.0-5 or later from an earlier version of MarkLogic 9 and you use a geospatial region index, you should reindex. For more details, see Tolerance Support in Geospatial Region Queries.