storyboard/doc/source/install/manual.rst

Installing Manually

Installing the API service

1. At the command line:

   $ pip install storyboard

   Or, if you have virtualenvwrapper installed:

   $ mkvirtualenv storyboard
   $ pip install storyboard

2. By default Storyboard will use SQLite driver which is suitable only for development mode. Storyboard only supports MySQL, to install MySQL driver execute:

   $ pip install MySQL-python

3. Edit /etc/storyboard/storyboard.conf. You'll need to modify connection parameter in the [database] section.

   For MySQL it will look like:

   connection = mysql://root:pass@127.0.0.1:3306/storyboard

4. Migrate database to current state:

   $ storyboard-db-manage --config-file /etc/storyboard/storyboard.conf upgrade head

5. Launch API service:

   $ storyboard-api --config-file /etc/storyboard/storyboard.conf

   Note

   Is is recommended to use Apache+mod_wsgi for production installation.

Installing the Web Client

Web Client is an all-javascript application. It doesn't require any software to run. Just grab a tarball from http://tarballs.openstack.org/storyboard-webclient, unpack it and serve as static files.