Skip to main content

Installing MarkLogic Server

Installing MarkLogic

This section describes the procedure for installing MarkLogic Server on each platform. Perform the procedure corresponding to the platform to which you are installing.

Platform

Steps

Windows x64

  1. If you are upgrading from a previous MarkLogic release, review Upgrading from Previous Releases and perform the necessary steps from that section first.

  2. Download the MarkLogic Server installation package. The latest installation packages are available from https://www.marklogic.com/product/getting-started/.

  3. Double-click the .msi file to start the installer.

  4. The Welcome page displays. Click Next.

  5. Select Typical.

  6. Click Install.

  7. A dialog appears with the question Do you want to allow this app to make changes to your device? Click Yes.

  8. The installation process will begin. When the process is completed, click Finish.

Note

If you plan to use the converters package, also perform the following steps:

  1. Download the MarkLogic Converters package (.msi) for Windows from http://developer.marklogic.com.

  2. Double-click the .msi file to start the installer.

  3. The welcome page displays Welcome to the MarkLogic Converters Setup Wizard. Click Next.

  4. The Choose Setup Type page displays. Select Typical.

  5. The Ready to Install page displays. Click Install to start the installation.

  6. A dialog appears with the question Do you want to allow this app to make changes to your device? Click Yes.

  7. The Installing MarkLogic Converters page displays.

  8. The final page displays Completing the MarkLogic Converters Setup Wizard. Click Finish.

Red Hat Linux x64

  1. If you are upgrading from a previous MarkLogic release, review Upgrading from Previous Releases and perform the necessary steps from that section first.

  2. Download the MarkLogic Server installation package to /tmp or another location. The latest installation packages are available from http://developer.marklogic.com.

  3. We recommend that you use yum to install MarkLogic instead of an rpm install. The yum install will automatically determine the dependencies. As the root user, install the package with the following command:

    yum install /tmp/MarkLogic-11.0.0-rhel.x86_64.rpm

    Tip

    If a yum installation cannot be completed, an rpm install can be used. To do an rpm install, as the root user, install the package with the following command:

    rpm -i /tmp/MarkLogic-11.0.0-rhel.x86_64.rpm

Note

If you are installing MarkLogic 9.0-4 or later, and you plan to use the converters package, also perform the following steps:

  1. Download the MarkLogic Converters package for Linux platform (for example, MarkLogicConverters-11.0.0-rhel.x86_64.rpm​) from http://developer.marklogic.com to /tmp or another location.

  2. We recommend that you use yum to install MarkLogic instead of an rpm install. The yum install will automatically determine the dependencies. As the root user, install the package with the following command:

    yum install /MarkLogicConverters-11.0.0-rhel.x86_64.rpm​

    Tip

    If a yum installation cannot be completed, an rpm install can be used. To do an rpm install, as the root user, install the package with the following command:

    rpm -i /tmp/MarkLogicConverters-11.0.0-rhel.x86_64.rpm​

CentOS Linux

  1. If you are upgrading from a previous MarkLogic release, review Upgrading from Previous Releases and perform the necessary steps from that section first.

  2. Download the MarkLogic Server installation package to /tmp or another location. The latest installation packages are available from http://developer.marklogic.com.

  3. We recommend that you use yum to install MarkLogic instead of an rpm install. The yum install will automatically determine the dependencies. As the root user, install the package with the following command:

    yum install /tmp/MarkLogic-11.0.0-rhel.x86_64.rpm

    Tip

    If a yum installation cannot be completed, an rpm install can be used. To do an rpm install, as the root user, install the package with the following command:

    rpm -i /tmp/MarkLogic-11.0.0-rhel.x86_64.rpm

Note

If you are installing MarkLogic 9.0-4 or later, and you plan to use the converters package, also perform the following steps:

  1. Download the MarkLogic Converters package for the Linux platform (for example, MarkLogicConverters-11.0.0-rhel.x86_64.rpm​) from http://developer.marklogic.com to /tmp or another location.

  2. We recommend that you use yum to install MarkLogic instead of an rpm install. The yum install will automatically determine the dependencies. As the root user, install the package with the following command:

    yum install /MarkLogicConverters-11.0.0.x86_64.rpm

    Tip

    If a yum installation cannot be completed, an rpm install can be used. To do an rpm install, as the root user, install the package with the following command:

    rpm -i /tmp/MarkLogicConverters-11.0.0-rhel.x86_64.rpm​

Note

For CentOS 8, MarkLogic has a dependency on libnsl.so.1(). You can either rely on yum to pull in the dependency automatically, or install it manually.

Amazon Linux 2

  1. If you are upgrading from a previous MarkLogic release, review Upgrading from Previous Releases and perform the necessary steps from that section first.

  2. Download the MarkLogic Server installation package to /tmp or another location. The latest installation packages are available from http://developer.marklogic.com.

  3. We recommend that you use yum to install MarkLogic instead of an rpm install. The yum install will automatically figure out the dependencies. As the root user, load additional packages for EC2 support with the following command:

    sudo yum install java-11-openjdk xfsprogs

  4. As the root user, create a symbolic link with the following command:

    sudo ln -s system-lsb /etc/redhat-lsb

  5. As the root user, install the MarkLogic Server installation package with the following command:

    sudo yum install MarkLogic-11.0.0-rhel.x86_64.rpm

Note

If you are installing MarkLogic 9.0-4 or later, and you plan to use the converters package, also perform the following steps:

  1. Download the MarkLogic Converters package for Linux platform (for example, MarkLogicConverters-11.0.0-rhel.x86_64.rpm​) from http://developer.marklogic.com to /tmp or another location.

  2. We recommend that you use yum to install MarkLogic instead of an rpm install. The yum install will automatically determine the dependencies. As the root user, install the package with the following command:

    yum install /MarkLogicConverters-11.0.0.x86_64.rpm

    Tip

    If a yum installation cannot be completed, an rpm install can be used. To do an rpm install, as the root user, install the package with the following command:

    rpm -i /tmp/MarkLogicConverters-11.0.0-rhel.x86_64.rpm​

Mac OS X

  1. If you are upgrading from a previous MarkLogic release, review Upgrading from Previous Releases and perform necessary steps from that section first.

  2. Download the MarkLogic Server installation package to your desktop. The latest installation packages are available from http://developer.marklogic.com.

  3. Double-click MarkLogic-11.0.0-x86_64.dmg to open the folder that contains the .pkg installer. Double-click on the installer to start.

  4. The Welcome page displays. Click Continue.

  5. In the Select a Destination window, select a destination to install MarkLogic Server or continue to select the default destination.

  6. In the Installation Type window, click Install. An Installation window appears that displays the progress of the installation.

  7. When the Installation Summary window appears, click Close.

  8. A MarkLogic control window appears from which you can start/stop MarkLogic Server, open the Admin Interface, and view the Error Log.

    Note

    If you are installing MarkLogic 9.0-4 or later, and you plan to use the converters package, also perform the following steps:

  1. Download the MarkLogic Converters package for Mac OS platform (e.g. MarkLogicConverters-11.0.0-x86_64.dmg​) from http://developer.marklogic.com to your desktop.

  2. Double-click the MarkLogicConverters-11.0.0-x86_64.dmg​ icon to open the folder that contains MarkLogicConverters-11.0.0-x86_64.dmg​ installer. Double-click on the installer to start.

  3. The Welcome page displays. Click Continue.

  4. In the Select a Destination window, select the default destination.

  5. In the Installation Type window, click Install. An Installation window appears that displays the progress of the installation.

  6. When the Installation Summary window appears, click Close.

If you are upgrading a cluster to a new release, see Upgrading a Cluster to a New Maintenance Release of MarkLogic Server in the Scalability, Availability and Failover Guide The Security database and the Schemas database must be on the same host, and that host should be the first host you upgrade when upgrading a cluster.

Note

It is not recommended to install the converters while MarkLogic Server is running. The reason for this is that the server checks the converters presence and version number only upon start-up. So, the server will not have accurate information about the converters in this case. The recommended installation procedure is to stop the server if it is running, install or upgrade the server, install the converters, then start the server.

The following table shows the installation directory (<marklogic-dir>) and the default data directory for each platform:

Platform

Installation Directory

Default Data Directory

for configuration and log files

Windows

c:\Program Files\MarkLogic\

c:\Program Files\MarkLogic\Data

Red Hat Linux

/opt/MarkLogic

/var/opt/MarkLogic

Mac OS X

~/Library/MarkLogic

~/Library/Application Support/MarkLogic/Data

The default forest directory is the same as the default data directory if the optional data directory is not specified during forest creation. On UNIX platforms, if you want MarkLogic Server to use another location for its default data directory, make your data directory (/var/opt/MarkLogic on Linux) a soft link to the alternate location.

In MarkLogic release 9.0-4 and later, MarkLogic Converters installation directory remains the same as in previous releases, namely:

Platform

Converters Installation Directory

Windows

c:\Program Files\MarkLogic\Converters

Red Hat Linux

/opt/MarkLogic/Converters

Mac OS X

~/Library/MarkLogic/Converters

Note

When a new node joins an existing cluster, the server does not try to figure out automatically whether the MarkLogic Converters package is needed or not. An XDMP-CVTNOTFOUND error will be thrown if converters/filters built-in functions are called on nodes that do not have MarkLogic Converters installed.

In this section: