Product

On November 13, 2019, MarkLogic Server version 8 reached End-of-Life. In an effort to continuously enhance and improve our product offering, it may become necessary as a part of MarkLogic’s product lifecycle to declare that a particular product or product configuration (e.g. a particular operating system release) is at the “end of life” stage; therefore, MarkLogic reserves the right to desupport that product or product configuration. End-of-Life Notices generally are available 12 months in advance of the desupport date.

Desupport Notices are provided to registered support contacts by email. Desupport Notices contain desupport dates, information about availability of Maintenance Support, and information about migration paths for certain features.

For customers running versions of MarkLogic software prior to version 9, MarkLogic will not be in a position to issue new license keys for such versions after December 31, 2020.

What’s in MarkLogic 9?

Read about the New Features in MarkLogic 9 in its release notes. Here are some of its major features with links to where they are described:

• Template Driven Extraction (TDE)
• SQL Enhancements
• Optic API
• Enhanced Tiered Storage
• Encryption at Rest
• Element Level Security
• Redaction
• Geospatial Enhancements
• Entity Services API
• Bulk Asynchronous Data Movement

In addition to the many important foundational improvements, some key changes included in MarkLogic 9.0-11 are

• RedHat 8 support
• Native support of Azure Key Vault for Encryption at Rest
• Request Monitoring enhancements

To learn more about the maintenance changes included in this release, you can review the list of externally published bug fixes available on our support portal by clicking on the Fixed Bugs link. We recommend that all customers who are currently using a previous version of MarkLogic 9 upgrade to MarkLogic Server version 9.0-11.

What’s in MarkLogic 10?

Read the release notes for MarkLogic 10 to find out about its new features, which include:

• JavaScript Engine Upgrade
• Element Level Security (ELS) in the Triple Index
• Machine Learning
• Security Library Upgrades
• Triggers and Amps Creation
• Default Assignment Policy for New Databases

The most up-to-date MarkLogic 10 version is MarkLogic 10.0-2.1, also available on the AWS Marketplace.

What’s the best way to upgrade?

When Upgrading from Previous Release, you must uninstall the old release of MarkLogic on your machine before proceeding with the new installation. For information on removing the software, see Removing MarkLogic and the Installation Guide from the previous release. You will find the Upgrading from MarkLogic 8 documentation helpful in this process.

MarkLogic 10

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

MarkLogic 9

If you are upgrading from MarkLogic 8 to MarkLogic 9, some applications will require minor changes to run correctly on MarkLogic 9. For details, see Known Incompatibilities with Previous Releases.

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 need to reindex. For more details, see Understanding Tolerance in the Search Developer’s Guide.

Upgrade Checklist

The basic steps to upgrade from an earlier version to MarkLogic 10 are as follows:

1. As a precaution, perform database backups on your earlier versions of MarkLogic Server databases.
2. Stop MarkLogic Server (as described in Step 1 of Removing MarkLogic).
3. Uninstall the old MarkLogic release (as described in Removing MarkLogic).
4. Install the new MarkLogic 10 release (as described in Installing MarkLogic). Note that if you want to install MarkLogic 9.0-4 or later, and you plan to use the converters package with it, you will have to perform a two-step installation: first install MarkLogic Server and then install MarkLogic Converters. For more detail, see MarkLogic Converters Installation Changes Starting at Release 9.0-4 and Installing MarkLogic.
5. Start MarkLogic Server (as described in Starting MarkLogic Server).
6. Open the Admin Interface in a browser (http://localhost:8001/).
7. When the Admin Interface prompts you to upgrade the Security database and the configuration files, click the button to confirm the upgrade.
8. If you have CPF installed in any database and you want to use any of the new pipelines in MarkLogic 10, then you must reinstall CPF for those databases. Note that to reinstall CPF for a database, in the Admin Interface navigate to Databases -> database-name -> Content Processing, click the Install tab, and click the Reinstall button. This loads all of the new pipelines into the triggers database configured for that database.

All of the latest MarkLogic Server maintenance releases are always available from the Downloads section of our website. The list of third party and open source components in MarkLogic Server are available in our Combined Product Notice. When upgrading, please remember to follow the upgrade instructions and visit the Admin UI (default port 8001) to complete the upgrade.

Ready to Upgrade?

Please place a Support ticket a week or so BEFORE you upgrade with all the pertinent information and a support dump.  Our Support engineers will guide you to documentation that will give you best practices and be ready in case there is a problem so we may serve you quicker.  When the upgrade has went perfectly, please call us back and let us know!  We will then close the support ticket. If you have any questions, please email csm@marklogic.com.