help
>
admin
>
Command Line
Trac Command Line Administration Tool
The Trac Command Line Administration tool is a command line script trac-admin that should be installed together with Trac. This tool allows an Administrator to perform various actions from the console, some of these actions are explained here - because directly connected with Agilo - for the others you can refer directly to the Trac Admin page.
Create a new Project
To create a new project, you have to follow two basic steps, the first one is to create and initialize a new Trac project and the second one is to enable Agilo in that project.
- To create a new project, first choose a folder (directory) on your file system where you would like your project folders to be (e.g.: /var/lib/agilo) and make sure you have write permission on that folder.
Now you can initialize a project, using the command:
$ trac-admin <project_name> initenv
The interactive command will ask you some questions about the project you want to create, and will initialize an environment. If you plan to use a database different from SQLite or you want to have a complete description on how to create a new environment, please refer to Trac Installation Guide.
- To enable Agilo on the newly created project, you will have to edit the project configuration file: `<project_name>/conf/trac.ini'. Just add or edit a new section called components:
[components] agilo.* = enabled
after having saved the file you can run the following command from the console:$ trac-admin <project_name> upgrade
this will configure the new project to use Agilo. You will have now to setup a user to be the administrator of the project, please refer to the next section.
Creating an Administrator
The first time you initialize a project, you will have to create a new project administrator using the command line utility trac-admin because without being administrator you won't be allowed to access the Admin menu from the web interface. To create an administrator, you will first have to create a user to access the system in an authenticated way (see Trac installation guide), than you will have to grant this user the administration rights:
$ trac-admin <project_name> permission add <user> TRAC_ADMIN
Next time you will login to the Agilo project you should see the Administration icon appearing the the top toolbar.