| 1 | = TracAdmin = |
---|
| 2 | [[TracGuideToc]] |
---|
| 3 | |
---|
| 4 | Trac is distributed with a powerful command-line configuration tool. This tool can be used to configure and customize your Trac-installation to better fit your needs. |
---|
| 5 | |
---|
| 6 | Some of those operations can also be performed via the web interface thanks to the optional [http://trac.edgewall.org/wiki/WebAdmin WebAdmin] plugin, distributed separately for now. |
---|
| 7 | |
---|
| 8 | == Usage == |
---|
| 9 | |
---|
| 10 | You can get a comprehensive list of the available options, commands and sub-commands by invoking `trac-admin` with the `help` command: |
---|
| 11 | {{{ |
---|
| 12 | trac-admin help |
---|
| 13 | }}} |
---|
| 14 | |
---|
| 15 | Unless you're executing the `help`, `about` or `version` sub-commands, you'll need to specify the path to the TracEnvironment that you want to administer as the first argument, for example: |
---|
| 16 | {{{ |
---|
| 17 | trac-admin /path/to/projenv wiki list |
---|
| 18 | }}} |
---|
| 19 | |
---|
| 20 | == Interactive Mode == |
---|
| 21 | |
---|
| 22 | When passing the environment path as the only argument, `trac-admin` starts in interactive mode. |
---|
| 23 | Commands can then be executed on the selected environment using the prompt, which offers tab-completion |
---|
| 24 | (on non-Windows environments, and when the Python `readline` module is available) and automatic repetition of the last command issued. |
---|
| 25 | |
---|
| 26 | Once you're in interactive mode, you can also get help on specific commands or subsets of commands: |
---|
| 27 | |
---|
| 28 | For example, to get an explanation of the `resync` command, run: |
---|
| 29 | {{{ |
---|
| 30 | > help resync |
---|
| 31 | }}} |
---|
| 32 | |
---|
| 33 | To get help on a all the Wiki-related commands, run: |
---|
| 34 | {{{ |
---|
| 35 | > help wiki |
---|
| 36 | }}} |
---|
| 37 | |
---|
| 38 | ---- |
---|
| 39 | See also: TracGuide, TracBackup, TracPermissions, TracEnvironment, TracIni |