Installation¶
Requirements¶
Packages¶
crontab (0.15 or newer)
Font Awesome (free version for web, optional)
ansi_up (optional)
MySQL Connector (needed only if using a MySQL database, PyPI entry)
Python Version¶
- Crab server
Has been tested on Python 2.6, 2.7 and 3.2.
- Client library and utilities
Works with Python 2.4 in addition to the above versions (but may require the
pytz
andsimplejson
packages also to be installed).
Installation¶
The Crab server, clients and libraries can be installed as follows:
python setup.py install
If necessary, the --install-data
option can be used to configure
the location in which the templates (templ
), resources (res
)
and example files (doc
) should be installed.
To run Crab without installing it, and if any of the Python dependencies
listed above can not be installed, they can be symlinked into the lib
directory in the following locations:
lib/cherrypy
lib/crontab
lib/mako
The jQuery JavaScript library should be copied or symlinked into
Crab’s res
directory as:
res/jquery.js
To use Font Awesome icons, copy or symlink its webfonts
directory into
Crab’s res
directory, and also place its stylesheets inside
that subdirectory, giving:
res/webfonts/fontawesome.css
res/webfonts/solid.css
res/webfonts/fa-*.*
Note that Font Awesome is not backward compatible between major version numbers. Crab now uses version 6 of Font Awesome.
To use ansi_up to interpret ANSI color commands in cron job output,
copy or symlink the ansi_up.js
file into Crab’s res
directory:
res/ansi_up.js