| | 1 | = Admin Toolkit - scripts for managing multiple Trac environments = |
| | 2 | |
| | 3 | == Description == |
| | 4 | |
| | 5 | 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). |
| | 6 | |
| | 7 | 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. |
| | 8 | |
| | 9 | 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. |
| | 10 | |
| | 11 | The current list of scripts is: |
| | 12 | |
| | 13 | * trac-admin-init - prepare the disk for a new development environment |
| | 14 | * trac-admin-mkproject - create a Subversion repository, Postgresql database and Trac environment for one project |
| | 15 | * trac-admin-rmproject - remove the Subversion repository, Postgresql database and Trac environment for an existing project |
| | 16 | * trac-admin-useradd - add a user (currently one user has access to all projects) |
| | 17 | * trac-admin-userdel - remove an existing user |
| | 18 | * trac-admin-promote - promote a user to administrator on one of more projects |
| | 19 | * trac-admin-demote - remove administrator privileges for a user on one of more projects |
| | 20 | |
| | 21 | |
| | 22 | == Bugs/Feature Requests == |
| | 23 | |
| | 24 | Existing bugs and feature requests for AdminToolkitScript are |
| | 25 | [report:9?COMPONENT=AdminToolkitScript here]. |
| | 26 | |
| | 27 | If you have any issues, create a |
| | 28 | [http://trac-hacks.org/newticket?component=AdminToolkitScript&owner=stodge new ticket]. |
| | 29 | |
| | 30 | == Download == |
| | 31 | |
| | 32 | Download the zipped source from [download:admintoolkitscript here]. |
| | 33 | |
| | 34 | == Source == |
| | 35 | |
| | 36 | You can check out AdminToolkitScript from [http://trac-hacks.org/svn/admintoolkitscript here] using Subversion, or [source:admintoolkitscript browse the source] with Trac. |
| | 37 | |
| | 38 | == Example == |
| | 39 | |
| | 40 | To create a new Trac environment, run: |
| | 41 | |
| | 42 | trac-admin-mkproject |
| | 43 | |
| | 44 | And answer a few questions. |
| | 45 | |
| | 46 | To delete the project, run: |
| | 47 | |
| | 48 | trac-admin-rmproject |
| | 49 | |
| | 50 | == Recent Changes == |
| | 51 | |
| | 52 | [[ChangeLog(admintoolkitscript, 3)]] |
| | 53 | |
| | 54 | == Author/Contributors == |
| | 55 | |
| | 56 | '''Author:''' [wiki:stodge] [[BR]] |
| | 57 | '''Contributors:''' |
