Skip to main content

Administrating MarkLogic Server

Important Points to Note before Performing Rolling Upgrades

  • The cluster needs to be configured for High Availability (HA). This includes configuring replica forests for your security, schema, and other auxiliary forests.

  • Do not change your application to take advantage of features in this version until all the nodes in your cluster have been upgraded

  • You may have to change or modify some of your application code prior to starting the rolling upgrade, so that code will work in a mixed environment.

  • The primary security, schema, and auxiliary forests must be on the same host, and that host should be the first host you upgrade when upgrading a cluster.

  • In a mixed node cluster, before the upgrade has been committed, the node that has been upgraded will be read-only. This is to prevent any configuration changes from that node. We strongly recommend that you not make any configuration changes until you have finished upgrading the entire cluster.

  • The window of time when a cluster has nodes of varying versions should be small. During this time, do not make application code changes and/or configuration changes. Configuration changes involve the following:

  • Changes to index, forest, database, application server, host, group, and cluster settings

  • Changes to security settings such adding/changing/deleting roles, users, privileges, credentials, certificates, etc.

  • Adding/removing/updating TDE templates

  • Adding/removing/updating redaction rules

  • Do not perform any manual merges and disable reindexing while the cluster has nodes that are at different software version levels. Changing error log settings and adding trace events to debug issues should be fine.

  • After committing a rolling upgrade, you can only restore to the later version, not to the earlier version. Running your cluster in an uncommitted state is equivalent to running in the previous (earlier) version of MarkLogic. New features are not available until the upgrade has been committed.

  • An upgrade of the security database is required after you have committed the new version of MarkLogic.

  • It is important to upgrade the disaster recovery cluster first, since the newer version of the software will be able to receive fragments and journal frames encoded on the master cluster.

  • Before stopping the MarkLogic process on a node, configure your load balancer to divert transactions away from the node being upgraded, and allow all existing and queued transactions to complete.

  • Mounting a forest takes time. Prioritize the failover of forests for your security, schema, and other auxiliary databases.

  • Before stopping the MarkLogic process on a node, make sure that all acting replica forests on the other nodes have caught up in replicating content.

In this section: