Installation

Prerequisites

Java JRE version 1.5 or greater must be installed.

Download and Install

  1. Download the Meandre-<VERSION>-<PLATFORM>.zip for your OS platform from the Download page.
  2. Extract the contents of the zip file, this will produce a directory called “Meandre-<VERSION>/”

Running The Web Applications

The Meandre tool suite is made up of web servers that can be accessed via browser and can communicate with each other over sockets. To run the applications:

  • Meandre-Infrastructure: Run the Infrastructure instance by executing the Start-Infrastructure.[cmd|sh] command found in the Meandre-<VERSION>  directory. Point your web browser to the Meandre Administrative Interface at http://localhost:1714/public/services/ping.html.
  • Meandre-Workbench: Execute the Start-Workbench.[sh|cmd] command in Meandre-<VERSION>/. Point your web browser to http://localhost:1712/Workbench.html to access the Workbench’s interface.
  • To shut down any of the applications started with a Start-*.[cmd|sh] script, run the corresponding Stop-*.[cmd|sh] script.

Quick Start

These steps will take you through installing and running the Meandre Infrastructure and Workbench servers, and running your first Flow and seeing the results.

  1. Download the end-user distribution appropriate for your operating system. Distributions are available for Linux, Mac, and Windows.
  2. Unzip the distribution in a working directory (database files will be stored in this directory, so it must have write-access and a reasonable amount of free disk space).
  3. Start up the Infrastructure Server by running the Start-Infrastructure script for your platform.
    • –Windows–
      Double-click “Start-Infrastructure.cmd” when viewing the Meandre directory in Windows Explorer. Information and error messages will be printed to the console window that opens.
    • –Mac/Linux–
      From the commandline, run “sh Start-Infrastructure.sh”. Information and error messages will be written to the infrastructure.log file.
  4. Open the URL “http://localhost:1714/public/services/ping.html” in your web browser. You should see an orange and white webpage with the response message “pong.” If so, the Infrastructure server is working. If you’d like to explore some of the other menu options, you can log in under the default account: username=”admin”, password=”admin” when prompted.
  5. Start the Workbench server using the Start-Workbench script in the same
    way as the Infrastructure server.

    • –Windows–
      Double-click “Start-Workbench.cmd” when viewing the Meandre directory in Windows Explorer.
    • –Mac/Linux–
      From the commandline, run “sh Start-Workbench.sh”.
  6. Open the URL “http://localhost:1712/Workbench.html” in your web browser. Log into the workbench with the following default account information:
    • Username: admin
    • Password: admin
    • Server: localhost
    • Port: 1714
  7. You should see the default Flows listed on the left side of the workbench interface. Double-Click on the Flow named “FP-Growth” so that it appears in the center canvas. This Flow will download a test demo data set and perform a frequent item set analysis, resulting in a visualization.
  8. Click “Run Flow” above and to the right of the center canvas. The first time the Flow is run, it may take some time while the Flow’s resources are downloaded from an NCSA server.
  9. A browser window should open with a visualization. If the window is blocked by a pop-up blocker, the web interface for the Flow should be available at “http://localhost:1715/” if this is the first time you have run a Flow on this installation.
  10. The first interface to appear will be the ChooseAttributes dialogue. Select all attributes except “class” as the input attributes, and “class” as the output attribute. Hold down shift and click the first and last attributes desired to select a group of attributes in this dialogue. Click the “Submit” button.
  11. The rule association visualization should replace the ChooseAttributes screen in the browser. Click “Done” below the visualization to dismiss the visualization and end the FP-Growth Flow’s execution.
  12. To shutdown the Infrastructure and Workbench servers, run the Stop-Infrastructure and Stop-Workbench scripts in the installation directory. If the servers are restarted later, any saved Components and Flows will still be available.