The following instructions assume you have Trac already installed and are logged into the Trac server.
Agilo Pro is an extended version of Agilo which adds more features on top (e.g. a white board for easier task handling and an inline ticket editor in the backlog). If you choose to install Agilo Pro, please skip the "Install Agilo Open" section.
Download the egg file that matches the version of Python you installed on your system, then:
unzip binary_agilo-_PRO-py.egg.zip
sudo easy_install binary_agilo-...
Download the Agilo source code package to your home directory, then:
cd ~
tar zxf agilo-source-latest.tar.gz
cd agilo
sudo python setup.py install
Remember to restart tracd or Apache after installing if you are installing in an existing and running environment.
If you haven't done so already, create a Trac project (we'll call this project 'my_project'):
sudo trac-admin /var/lib/trac/my_project initenv
Answer the questions, usually the defaults are OK. Now you can launch the server following the command that will be printed on your screen at the end of the project configuration, most likely something like this:
tracd --port 8001 /var/lib/trac/my_project
This launches the Trac daemon and listen on the port 8001 to all addresses. You can now connect with your web browser to: http://localhost:8001/ and see your newly created project.
You will need now to activate authentication and create a system administrator, this operation may differ depending on the platform you are using, and on the authentication method you will be using. Here we mention one of the simplest options.
You will need to download an additional utility: trac-digest.py to create a digest password file. Using the following command you can both generate the password file and add additional users afterwards:
cd /var/lib/trac
python trac-digest.py -u username -p password >> users.digest
Now you will have to grant to the created username the rights to administer the environment:
trac-admin /var/lib/trac/my_project permission add username TRAC_ADMIN
Now you can start the Trac daemon with authentication:
tracd --port 8001 --auth=my_project,/var/lib/trac/users.digest,trac /var/lib/trac/my_project
To enable Agilo, the fastest way is to edit your new trac.ini file. Go to the location of the trac.ini file and open it in your editor of choice (in this example the 'nano' editor is used):
cd /var/lib/trac/my_project/conf
nano trac.ini
Add this section at the bottom of the config file:
agilo.* = enabled
# the following lines are only required to use Agilo Pro
agilo_common.* = enabled
agilo_pro.* = enabled
Go back to the server console, and run:
sudo trac-admin /var/lib/trac/my_project upgrade
When you go back to Trac in the browser and reload the page, you should see the Agilo interface. For further information on how to configure Trac in more complex environments please refer to the
Trac Guide.
Find us on