Archive for June, 2009

04
Jun
09

install marklogic server

Today we’re going to walk you through installing MarkLogic Server.  Why do you want to install this? Because it’s AWESOME and because WE CAN!

MarkLogic Server is the best place to put XML content and there is a ton of XML out there.  MarkLogic Server gives us a repository for storing XML content and an Application Server for creating applications that can query, display, manipulate, and re-use that content.  The repository itself is a combination of database and search engine and provides us with powerful tools for querying and manipulating the content we store.   The goal here is to provide you with demonstrations of the useful things we can do using MarkLogic so you can go out there and create Kick-Ass! applications of your own.

We’re firm believers in learning by doing, so if you want to be able to play along at home as we proceed to do things such as call the Twitter API, store the results in MarkLogic Server, and then query that content in Excel so we can perform Social Network Analysis using NodeXL, well you’ll want to have  your own MarkLogic Server installed.

The great news is its free!  Today we’ll install using the Community License.  The Community License is free of charge for use in production environments for non-commercial projects.  This license does have capacity and usage restrictions, but it will provide us everything we need to get started.  This license does limit the availability of all MarkLogic features.  If you’re interested, there are also Trial and Academic Licenses available.  With these you can use Entity Enrichment, Geospatial, Alerting, and all the other optional features that MarkLogic provides.  If you’re interested, you can check out all the available license options here.

express installation guide

For this post we assume you’re on Windows Vista or XP (or even Server 2003/8).   We’ll be integrating with Microsoft Office, and for development we’ll assume that all our applications are on the same machine.  We’ll be using small content sets in the examples; however, the Community License permits you to store up to 10gb of content, so you may want to consider that before installing.   For all the nitty-gritty details on System Requirements and/or how to install on Linux or Solaris, consult the installation guide.

1. Download MarkLogic Server

Choose the download appropriate for your system.  Under the heading MarkLogic Server Binaries, sub-heading Microsoft Windows, select the x86 bundle .msi for 32-bit machines, and the x64 bundle for 64-bit systems.  You’ll be prompted to check an agreement. If you agree, check it and let the download commence.

2. Click the .msi you just downloaded

You’ll see a dialog box welcoming you to the MarkLogic Server Setup Wizard. Click Next.

The next screen asks you to Choose a Setup Type.

install2

Select Typical and Click Next.

You’ll next be notified that MarkLogic Server is ready to install. Click install, and you’ll then be presented with a progress bar as the installation proceeds.

Upon completion of the installation, you’ll be notified with a final dialog box. Click Finish.

3. Start MarkLogic Server

MarkLogic Server is installed. We just need to start the Server, Accept the License Agreement, and Enter our License Key and we’ll be off  an running.

Go to the Start Button and Select:  All Programs -> MarkLogic Server -> Start MarkLogic Server.

Note: if you’re using Vista, right-click and Start MarkLogic Server as Administrator.

Once the Server is started in Windows, you’ll be able to Start and Stop it from Services. The service is set to start automatically.

4. Open the Admin Interface in a browser.

Launch your favorite browser and enter the following URL: http://localhost:8001

The License Key Entry page appears.  Since we don’t have a License Key yet, just Click the free button in the Get A License Key Section.

Fill out the License Key Request Form and Click Select Community License.

install5

The next screen will provide you with a Key and Licensee information.  Click OK.

The following screen is the Personal Agreement. After reviewing the terms of the  MARK LOGIC CORPORATION ONLINE DEVELOPER PROGRAM LICENSE AGREEMENT, Click Accept.

You’ll then be notified that the server must now self-install the initial databases and applications servers, Click OK to continue.

Finally, we need to address the Security Setup Screen.  Enter an admin username, a password, and confirm the password.  Leave the realm as public for now, and Click OK.

You’ll be prompted to enter the username/password combination you just configured.  Go ahead and enter. You’re now looking at the Admin UI.

install7

Congratulations! You’ve succesfully installed MarkLogic Server. The Server is actually already configured with a Database and a HTTP Server and is ready to Rock!  Next post we’ll get a glimpse of the power we’ve just unleashed as we install CQ and start to load and query content.




Follow

Get every new post delivered to your Inbox.