Home

Welcome to the bv.client wiki!

Index

• Convention
• Troubleshooting
• Installation
  • Quick note
  • Install a minitage environment for the BisonVert client
  • Install the BisonVert client itself
• Configuration
• Launching

Convention

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/)

Troubleshooting

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

Installation

Quick note

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.

Install a minitage environment for the BisonVert client

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

Install the BisonVert client itself

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

Configuration will be a fairly simple step.

See client-configuration.

Launching

All you need to do is:

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