Tutorial

This is a step-by-step guide on using Macsy. We will download all the required software in order to analyse a set of text documents.

A. Create a folder "Macsy" where all project files will be stored.
Create the subfolder "Macsy/MongoDB" where DB will live.
Create the subfolder "Macsy/lib" where library files (including Macsy) will live.

B. Install and Run Database

1. Download the latest MongoDB (tested with version 2.2.1) from http://www.mongodb.org/downloads and extract it in the folder "Macsy/MongoDB", so that the path "Macsy/MongoDB/bin" exists.
2. Download the latest Java driver for MongoDB from:
   https://github.com/mongodb/mongo-java-driver/downloads
   and save it under "Macsy/lib"
3. Create the subfolder "Macsy/MongoDB/data" data will be stored.
4. Start the database from the command line from folder "Macsy/MongoDB" by running
   "./bin/mongod --fork --logpath mongod.log --dbpath ./data"

B. Download Macsy files
Download the Macsy.0-1.jar and save it in "Macsy/lib".