Installation

Setting Up ClueMapper

Please be aware that many of ClueMapper's dependencies (third-party eggs) have not been uploaded to pypi. For this (and other) reason ClueMapper has had it's own custom index setup. The following steps will discuss how to use that index.

The preferred way to install ClueMapper is via contained environment such as virtualenv.

Note: Be sure to check out the prerequisites listed below in the OS tips section

Installing With VirtualEnv

The following steps will install the latest stable version of ClueMapper.

  1. Download and extract virtualenv

  2. From virtualenv directory, run the following:

    $ python2.5 virtualenv.py ../cluemapper
    
  3. Go into the new virtualenv and easy_install cluemapper:

    $ cd ../cluemapper
    $ ./bin/easy_install -i http://dist.serverzen.com/cluemapper/latest/simple/ ClueMapper
    
  4. Start up cluemapper:

    $ ./bin/clue-server
    

Setting up First Admin User

Run addmanager admin command:

$ ./bin/clue-admin addmanager
Username:
Password:
Confirm Password:

OS-Specific Tips

For your platform of choice make sure these items are installed:

  • Python development libs and headers
  • libxslt development libs and headers
  • sqlite3 development libs and headers
  • python subversion bindings (ones that come with svn)

Ubuntu

Pre-Installation

The following ubuntu packages need to be installed in order for the build process to work:

  • python-devel
  • libxslt1-dev
  • libsqlite3-dev

Post-Installation Requirements

The following ubuntu packages need to be installed in order for the ClueMapper to work:

  • python-subversion

Apache Tips

  • The preferred integration for apache is to use mod_rewrite. Here's a sample conf snippet:

    <VirtualHost *:80>
      ServerName projects.serverzen.com
      RewriteEngine On
      RewriteRule  ^/(.*)$ http://127.0.0.1:8080/$1 [L,P]
    </VirtualHost>
    
  • An example for setting up your svn, try:

    <VirtualHost *:80>
      ServerName svn.serverzen.com
      <Location />
         DAV svn
         SVNParentPath /usr/misc/svn/repos
         AuthzSVNAccessFile /path/to/svn/authz.acl
         Satisfy Any
         Require valid-user
         AuthType Basic
         AuthName "Subversion repository"
         AuthUserFile /path/to/users.passwd
      </Location>
    </VirtualHost>