Flamenco

University of California, Berkeley

Prerequisites

Flamenco is a Web application. Once you have set up a Flamenco server, clients will be able to view your Flamenco collections using a Web browser on any platform.

You do not need an administrator account to install and run Flamenco, though you may need to ask an administrator to install other required software or provide you with database access.

Required Software

To run the Flamenco server, you will need a computer running Linux or Mac OS X with:

Flamenco also uses the MySQLdb module for Python, but if you don't already have it, the Flamenco installer will build and install it automatically for you, using a copy of MySQLdb that is included in the Flamenco distribution.

Alternatively, or if MySQLdb fails to build automatically, you can install it yourself. On Linux systems that use Debian packages, you can install the module with a single command: apt-get install python-mysqldb. For other Linux systems and for Mac OS X, download and unpack the latest release of MySQL-python, cd into the newly created directory, and give the command python setup.py install.

Database Access

You will need a MySQL account that either has permission to create new databases or has access to an existing database where Flamenco will store your collection. The MySQL server doesn't have to run on the same computer as Flamenco; you can use a MySQL database administered by someone else or on another machine, as long as you have a MySQL account there.

If you are running MySQL yourself, use MySQL version 3.23 or higher. MySQL is available for both Mac OS X and Linux from mysql.com, and is also preinstalled on many Linux systems.

Optional Software

Lucene is optionally used to provide a full-text search feature (full-text search is still available via MySQL even without Lucene). If you want to use the Lucene search engine, you will also need: