Installation and upgrade

This section describes the supported platforms and upgrade paths for MarkLogic Server.

Supported platforms

For a complete list of supported platforms, see Supported Platforms in Install MarkLogic Server.

Supported filesystems

For a complete list of supported filesystems, see Supported Filesystems in Install MarkLogic Server.

Upgrades

There are some known incompatibilities between MarkLogic 11 and MarkLogic 12. You might need to make some minor code changes to your MarkLogic 11 applications before they can run correctly in MarkLogic 12. For details on the incompatibilities, see Known incompatibilities with previous versions.

For instructions on upgrading to MarkLogic 12, including information about database compatibility between MarkLogic 11 and MarkLogic 12, see Install MarkLogic Server.

Take note of the following:

• Upgrades to MarkLogic 12 are not supported from MarkLogic 12 EA1 or EA2.

• If you are upgrading from versions prior to 11.3, then the language baseline must be set to "ml9" before upgrading. See Removal of “legacy” Stemming and Tokenization Libraries.

• Due to the incompatibility between FIPS 140-2 and FIPS 140-3, if XDQP SSL is enabled and you are upgrading clusters with database replication, then follow the upgrade procedure in Known incompatibilities with previous versions.

• The update of the stemming dictionaries changes the way content is indexed. To take full advantage of this update, a full or partial reindex is required. See Updated stemming dictionaries.

• If certificates are in use that were generated with a private key with less than 2048 bits, then these certificates will no longer work. These certificates should be replaced prior to upgrading to ensure that the cluster does not become unavailable unexpectedly after upgrading. See Private keys need to be at least 2048 bits.

When you upgrade from versions earlier than MarkLogic 11, it is recommended that you upgrade to the latest of each major version in between. Refer to the installation guides of previous releases for upgrade concerns of each major version:

• MarkLogic Server 11 installation guide

• MarkLogic Server 10 installation guide

Memory and disk space requirements

See Memory, Disk Space, and Swap Space Requirements for details about resources requirements and recommendations.

Browser requirements

The Admin Interface and other built-in GUI tools are supported on these browsers:

• Chrome

• Microsoft Edge (Chromium Engine)

Other browser or platform combinations may work, but they are not as thoroughly tested.

Compatibility with XQuery specifications

MarkLogic Server implements the XQuery language, along with the functions and operators specified in the W3C XQuery 1.0 recommendations:

• http://www.w3.org/TR/xquery/

• http://www.w3.org/TR/xquery-operators/

Additionally, there is backwards compatibility with the May 2003 version of the XQuery 1.0 Draft specification used in MarkLogic 3.2 and previous versions. For details on the XQuery implementation in MarkLogic 4.1, including the three different dialects supported, see the XQuery and XSLT Reference Guide.

Security: Prevent abuse of system entity expansion

Normal XML processing allows for external entities to be referenced and included in the parsed content of XML files. To disable this processing, add the “Disable XML External Entities” trace event.

XQuery extensions

Working within the W3C XQuery 1.0 Recommendation, MarkLogic has created a number of language extensions enabling key functionality not supported in the current release of the language specification. These extensions provide transactional update capabilities, assorted search and retrieval features, various data manipulation functions, and administrative tools.

The documentation for these extensions, as well as for the XQuery standard functions, is in the XQuery API documentation. Additional details about the XQuery dialects supported by MarkLogic can be found in the XQuery and XSLT Reference Guide.