Download > Hot to install Agilo for Scrum 0.7

How To Install Agilo for Scrum 0.7

This page aims to give some specific issues and platform related information, to help you in getting Agilo for Scrum up and running.

Python

Python is a dynamic language, developed by Guido van Rossum, and used to develop agilo. Agilo support the following versions of python: 2.4 and 2.5. If you plan to use python 2.4 please pay attention to the additional database installation instructions. You need to have python installed before installing agilo.

External libraries & Dependencies

Agilo for Scrum 0.7 is making use of other Open Source libraries and tools, and integrates them to provide various functions. Agilo depends on:

Python Setup Tools download and install the latest version.
Trac 0.11 a generic ticketing system
Python Image Library to generate charts
NumPy Numeric Python, for specific numeric calculation
MatPlotLib A library to generate high quality anti-aliased charts
Databases:
- SQLite the default used, doesn't require installation, if you use Python 2.4 you will have to install the python access libraries pysqlite
- PostgreSQL a very solid and performant database
- MySQL a commonly used db, MySQL has been tested with agilo, though it is known to be unstable

These dependencies should be downloaded and installed automatically by the agilo setup.py script, there are anyway some specific informations you should know, so please read the section related to your operating system.

Specific Platform & Operating System issues

This documentation is the result of a collaborative work between agile42 team and all the Agilo for Scrum users that contributed to solve a large amount of issue, participating actively in our User Group.

Installing on Windows
Installing on Mac OS X
Installing on Linux from source
Installing on Linux Debian (Etch)

Installing on Windows (XP and Vista)

Once downloaded the agilo source archive, you can expand it using a zip utility, before proceeding with agilo installation we suggest to download the pre-compiled version of numpy and install it manually, easy_install script sometimes fails to correctly download the windows version.

Get and install setuptools from here, and install it
Get the numpy in exe format from here paying attention to download the version compatible with your python version 2.4 or 2.5
Install numpy by double-clicking on the downloaded .exe file, follow the on-screen instructions. At the end of the install process, the setup wizard should close
Open a command prompt (cmd) and go to the directory where you extracted the agilo source, if agilo is in C:\Agilo\ than you will have to run the following commands:

C:\> cd Agilo

C:\> python.exe setup.py install

you need to have python.exe in the path, normally it is installed in something like C:\Python25\ but depends on what parameters you set during python installation.

Agilo should now be able to download and install all the dependencies without problems.

Installing on Mac OS X

coming soon...

Installing on Linux from source

To install agilo from sources, you need the following system libraries:

zlib
libpng
jpeg6
freetype2
gfortran (or other fortran compiler)
g++ (or cpp)
python (dev or headers)

Than download all the dependencies than extract the libraries into a directory, for example src. Than proceed in the following order:

Setuptools: your Linux distribution may have a standard package for this, just make sure it is at least a 0.6c9
PIL: Python Image Library, that is a python based package can be installed as: $ python setup.py install
NumPy: will require fortran and cpp compilers, but you can still start the build process as: $ python setup.py install
Matplotlib: if the previous two steps were successful, this is as much easy as: $ python setup.py install pay attention to the first printout on the console, where will be highlighted which dependencies has been found, and which not, very useful for troubleshooting
Agilo: for agilo you can also build an egg and copy it only in the plugins folder of the trac projects for which you want to enable it. Just run: $ python setup.py install to install it systemwide or build an agilo egg: $ python setup.py bdist_egg

This was it, now you should have agilo correctly installed. Remember to activate it for each project where you want to use it.

Installing on Linux Debian (Etch)

First you need to setup trac and get the dependencies for Agilo:

sudo aptitude install trac python-numpty python-dev g++ zlib-dev \
libpng-dev libjpeg6-dev libfreetype6-dev

Make a place to hold the trac environments:

sudo mkdir /var/trac

Initialize the trac environment (enter the following commands, name the projects, select the defaults):

sudo trac-admin /var/trac/agilo initenv

Set up user authentication (instructions will be for tracd):

sudo htdigest -c /var/trac/.htdigest admin
sudo htdigest /var/trac/.htdigest user1

Give the user 'admin' admin rights in trac:

sudo trac-admin /var/trac/web permission add admin TRAC_ADMIN

Run the built-in trac server:

sudo tracd --port 8000 -auth=*,/var/trac/.htdigest,trac.local \
-e /var/trac/

This command will run tracd in the foreground so you can easily spot problems. Run tracd help for info on how to run it in the background.

Install Agilo 0.7

The following instructions assume you are logged into the Trac server.

Install the dependecies:

sudo easy_install -f http://www.pythonware.com/products/pil/ Imaging

Download the agilo 0.7 than:

cd ~  
tar zxf agilo-0.7.1build-908.tar.gz
cd agilo
sudo python setup.py install

Now go to the Trac, login as admin, and enable all the Agilo plugins under "Plugins"

Go back to the server, and do:

sudo trac-admin /var/trac/web upgrade

When you go back to Trac in the browser, a quick reload should bring you in Agilo.