= Admin Toolkit - scripts for managing multiple Trac environments =

== Description ==

The Admin Toolkit is a collection of Python scripts that facilitate the management of new and existing Trac projects on a single server, including support for Apache (.htpasswd file), Trac & Subversion (via !WebDav) and database backends (currently only Postgresql).

The scripts make it easy to manage multiple Trac environments on a single server. Authentication is supported using a single .htpasswd file -  one .htpasswd file is maintained for all projects but support for per-project authentication is in development.

Creating a new Trac environment, Postgresql database and Subversion repository is as simple as typing "trac-admin-mkproject", hitting return and answering a few questions.

The current list of scripts is:

 * trac-admin-init - prepare the disk for a new development environment
 * trac-admin-mkproject - create a Subversion repository, Postgresql database and Trac environment for one project
 * trac-admin-rmproject - remove the Subversion repository, Postgresql database and Trac environment for an existing project
 * trac-admin-useradd - add a user (currently one user has access to all projects)
 * trac-admin-userdel - remove an existing user
 * trac-admin-promote - promote a user to administrator on one of more projects
 * trac-admin-demote - remove administrator privileges for a user on one of more projects


== Bugs/Feature Requests == 

Existing bugs and feature requests for AdminToolkitScript are 
[report:9?COMPONENT=AdminToolkitScript here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=AdminToolkitScript&owner=stodge new ticket].

== Download ==

Download the zipped source from [download:admintoolkitscript here].

== Source ==

You can check out AdminToolkitScript from [http://trac-hacks.org/svn/admintoolkitscript here] using Subversion, or [source:admintoolkitscript browse the source] with Trac.

== Example ==

To create a new Trac environment, run:

trac-admin-mkproject

And answer a few questions.

To delete the project, run:

trac-admin-rmproject

== Recent Changes ==

[[ChangeLog(admintoolkitscript, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:stodge] [[BR]]
'''Contributors:'''