Those are important environmental variable, you may choose to export it.

ROOT_PATH

your base directory, depending on the the way you choose to install a minitage environment:

• /opt/ if you choose the archive
• whatever you set, if you choose the source

MT

Minitage directory (should be: $ROOT_PATH/minitage/)

BVCLIENT

bv.client directory (should be: $MT/django/bv.client/)

The installation using Minitage can be complex and fail, if you have any problem with it, reach the Minitage help at https://www.minitage.org/installation.html and https://www.minitage.org/usecases/index.html.

The BisonVert application is packaged using Minitage which completely isolate an application from the system its running on. Thus, it brings closer the development and production environment and enable to have a very safe environment when deploying.

To reach such a goal, Minitage get the sources of every library your application may need and compiles it... that takes some times !

The installation process can be seen as a two steps procedure:

1. Fetch and install all dependencies of the BisonVert client application in the minitage environment
2. Install the BisonVert client application itself.

This include set up of a minitage environment from scratch and resolution of all the BisonVert client dependencies.

There are two main ways to install the BisonVert client application:

The archive way

by far the fastest and easiest way to set up a Minitage BisonVert Client's environment

From archive

Using the source

way more long but is supposed to work for many platforms and will contain the most up-to-date version.

From sources

Now you have the choice, the hardest part was the minitage environment. You can either:

• Finish the deploiement of the client by extracting another archive or,
• Install the client using minitage, all dependencies being resolved it should not be long but will require some configurations.

See client-only-installation.

Configuration will be a fairly simple step.

See client-configuration.

All you need to do is:

cd $BVCLIENT
source sys/share/minitage.env
bin/paster serve etc/wsgi/instance.ini