Compatibility of mlcp across MarkLogic Server Versions

Cross-Version Compatibility in General

mlcp is compatible with a wide range of MarkLogic Server versions. That is, you can usually use a recent version of mlcp with an older version of MarkLogic Server and vice versa. However, not all features of mlcp or MarkLogic Server will work across version boundaries:

• MarkLogic 9 and mlcp 9.0 include support for redacting documents as you export them. However, older versions of MarkLogic Server do not support this feature, so it is not possible to use the -redaction option of mlcp with older versions.

• You can use mlcp to export a database archive from MarkLogic 9 or later that includes documents with the node-update security capability. However, this capability did not exist in earlier versions of MarkLogic Server, so it cannot be preserved if you import the MarkLogic 9 archive into an older MarkLogic Server, and it may even cause errors.

For best results, use the version of mlcp that corresponds to your version of MarkLogic Server, or limit your jobs to features that you know are supported in both.

MarkLogic 11.3.7 and Up Incompatible with Previous mlcp Versions

A change to how isolated code executes in MarkLogic 11.3.7 renders previous versions of MarkLogic Content Pump (mlcp) incompatible with MarkLogic 11.3.7 and up. Attempts to run previous versions of mlcp with MarkLogic 11.3.7 result in this error message:

java.io.IOException: com.marklogic.xcc.exceptions.XQueryException:

 XDMP-ISOLATED: xdmp:get-request-header("x-forwarded-for")

-- This function can't be used because code runs isolated.

We recommend that you upgrade mlcp to 11.3.7 as well.

If you must continue to use an older version of mlcp, then set -restrict_hosts to true. However, using this setting can degrade performance. See these sections of MarkLogic Content Pump (mlcp):

• Restricting the Hosts That mlcp Uses to Connect to MarkLogic

• How -restrict_hosts Affects -fastload