Previous: Introduction

Obtain the necessary software and code

Required Software

• If you are using MySQL with Apache, no additional software is required.
• MySQL database (other ODBC compliant DBMSs should also work--you may need to alter code in metadb.py. download from mysql.org)
• driver files for your chosen database (for MySQL, we use MySQLdb, libraries already included in flamenco distribution)
• Python interpreter version 2.1 or higher (included in the flamenco distribution)
• Text editor (Textpad, Notepad)
• Lucene--optional (go to Lucene download page)
• Webserver (We use Apache)

Directory structure

The code package is arranged with the following directory structure:

• code - trees containing Flamenco source code
• release-2005-06-15 - default codebase to get you started
• common - files common to all instances
• inst - contains a subdirectory of each instance of Flamenco, each containing:
• Webware - Webware directory for this instance
• code - symbolic link to codebase for this instance
• config - shell variable configuration for this instance
• log.txt - WebKit log file for this instance
• server - WebKit server configuration for this instance
• sw - software on which Flamenco depends
• tools - various scripts (for managing instances, databases, and so on), including install_flamenco.py
• bashrc - default startup script for bash
• cshrc - default startup script for csh

If you use bash, add "source <flamenco path>/bashrc" to your ~/.bashrc .
If you use csh, add "source <flamenco path>/cshrc" to your ~/.cshrc .

You will need to use one of these shells in order to setup the appropriate environment variables for the Flamenco installation.

 

Next: Convert your dataset to the appropriate format

Questions? Comments? Contact Kevin Li (kevinli@sims.berkeley.edu)