Solutions

Stay on top of everything MarkLogic

Be the first to know! News, product information, and events delivered straight to your inbox.

Sign Me Up

Learn

Stay on top of everything MarkLogic

Be the first to know! News, product information, and events delivered straight to your inbox.

Sign Me Up

Community

Stay on top of everything MarkLogic

Be the first to know! News, product information, and events delivered straight to your inbox.

Sign Me Up

Company

Stay on top of everything MarkLogic

Be the first to know! News, product information, and events delivered straight to your inbox.

Sign Me Up

MarkLogic and Amazon Web Services

To help you get going in the cloud quickly, MarkLogic provides Amazon Partner Amazon Machine Images (AMIs) and Cloud Formation Templates. The templates, which build on the AMIs, can be used to construct MarkLogic Managed Clusters.

New in MarkLogic 9

  • MarkLogic 1-click Compatible AMI: here. (Please see notes for upgrade instructions)
  • MarkLogic Cloud Formation Template with VPC Support: here. (Please see notes for upgrade instructions)

Quick Start

  • MarkLogic On AWS Github Repository: here.
  • MarkLogic On AWS Documentation: here.
  • MarkLogic publishes on AWS Gov Cloud. Please ask your account team for more details.

MarkLogic AMIs

MarkLogic provides two AMI series, Developer and Essential Enterprise.

The free Developer AMI is suited for a variety of purposes, from development to proof-of-concept work. You can also bring your own license (BYOL) to this AMI (and use it for those purposes allowed by the terms of your license). After you start up this AMI, you must request and install a free developer license key OR install your own pre-paid license key.

Available for purchase hourly, the Essential Enterprise AMI comes with a pre-packaged MarkLogic Essential Enterprise license key.

If you prefer, you can also build your own custom AMIs using MarkLogic installers.*.

Launching an AMI with EC2 Console

To gain the benefits of high-availability and scalability, the best practice is to run MarkLogic as a cluster. The MarkLogic Cloud Formation templates provide the easiest way to make use of MarkLogic Managed Clusters, described below.

If you prefer to launch an AMI directly, here are the steps:

  1. Create yourself an Amazon account and sign up for Amazon Web Services. (You may need to provide personal details, verification, credit card information and the like).
  2. Browse to the AWS Marketplace, search for marklogic, choose an AMI (or choose one of the Marketplace links from this page), select a region, and accept the terms.
  3. Launch the AMI with the EC2 Console:
    • Choose a supported instance type (NB: MarkLogic AMIs will not run on micro instances).
    • The AMI is configured to store MarkLogic configuration and data on an attached EBS storage. When you launch this AMI via the EC2 Console, the storage will be pre-configured and it must remain on /dev/sdf device. You can change the default volume size during setup. Leave off the Delete-on-termination checkbox, to enable you to keep your data.
    • Use a Security Group that will open ports 7997-8100. (If you don't have such a group, you can create one directly in the EC2 Console UI).
    • Proceed to start your instance.
  4. When your instance is started, you can browse to the Admin UI on your host's port 8001. Log in with user "admin"; the password is set to the value of the instance ID.

Cloud Formation Templates and MarkLogic Managed Clusters

To gain the benefits of high-availability and scalability, the best practice is to run MarkLogic as a cluster. The MarkLogic Cloud Formation templates provide the easiest way to make use of MarkLogic Managed Clusters.

If you choose to launch the MarkLogic AMIs outside of the Cloud Formation templates, you will not have automatic access to the Managed Cluster features. (You can still gain access to those features via your own custom configuration and automation and the documented series of environment variables and the mlcmd utility.) For these reasons, we highly recommend starting with the Cloud Formation templates, even if you plan to start with a single-node cluster.

The templates serve both as Getting Started points as well as examples. Once you are comfortable with them, we encourage and expect you to copy and modify them to suit your specific needs.

NOTE: Successful launching of EC2 instances via a Cloud Formation template requires acceptance of the License Agreement for the underlying AMI. Please visit the corresponding AWS Marketplace AMI page to accept the License Agreement before attempting to launch a stack from any of the templates.

Templates for the Latest MarkLogic AMIs

Description AWS Marketplace page (including Agreement Terms) Template URL Launch in US East (N. Virginia) Region
Launch MarkLogic Cluster in New VPC Developer, Essential Enterprise mlcluster-vpc.template Launch
Launch MarkLogic Cluster in Existing VPC Developer, Essential Enterprise mlcluster.template Launch

Templates for MarkLogic 9.0-4 AMIs

Description AWS Marketplace page (including Agreement Terms) Template URL Launch in US East (N. Virginia) Region
Single-instance Developer (Free, BYOL) Developer SingleNode-BYOL.template Launch
Cluster Developer (Free, BYOL) Developer ThreePlusCluster-BYOL.template Launch
Single-instance Essential Enterprise Essential Enterprise SingleNode-Enterprise.template Launch
Cluster Essential Enterprise Essential Enterprise ThreePlusCluster-Enterprise.template Launch

Templates for MarkLogic 8 AMIs

Description AWS Marketplace page (including Agreement Terms) Template URL Launch in US East (N. Virginia) Region
Single-instance Developer (Free, BYOL) Developer SingleNode-BYOL.template Launch
Cluster Developer (Free, BYOL) Developer ThreePlusCluster-BYOL.template Launch
Single-instance Essential Enterprise Essential Enterprise SingleNode-Enterprise.template Launch
Cluster Essential Enterprise Essential Enterprise ThreePlusCluster-Enterprise.template Launch

Support

Community-based support is available by asking questions on Stack Overflow or by joining the mailing list. Beyond that, please also see the Developer Support Program we offer.

Notes

Any distribution or sale of custom AMIs with MarkLogic installed is subject to MarkLogic License Agreement terms.

* If you are using Cloud Formation Templates published prior to MarkLogic 9.0-5 Release, you cannot upgrade automatically to 9.0-5 Cloud Formation Templates with VPC Support.

* Please refer to this knowledge base article if you want to upgrade to 1-click compatible MarkLogic AMI from a previously released MarkLogic AMI without pre-configured data volume (device on /dev/sdf).

Stack Overflow iconStack Overflow: Get the most useful answers to questions from the MarkLogic community, or ask your own question.

Comments

The commenting feature on this page is enabled by a third party. Comments posted to this page are publicly visible.
  • Amazing content and collection. Thanks for sharing the great information. It helps to all the basic level to higher level of MarkLogic and <a href=https://mindmajix.com/aws-certified-training>AWS Certified</a>