| 10 | | Usage: trac-admin </path/to/projenv> [command [subcommand] [option ...]] |
| 11 | | |
| 12 | | Invoking trac-admin without command starts interactive mode. |
| 13 | | |
| 14 | | about -- Shows information about trac-admin |
| 15 | | help -- Show documentation |
| 16 | | initenv -- Create and initialize a new environment interactively |
| 17 | | initenv <projectname> <repospath> <templatepath> -- Create and initialize a new environment from arguments |
| 18 | | hotcopy <backupdir> -- Make a hot backup copy of an environment. |
| 19 | | resync -- Re-synchronize trac with the repository |
| 20 | | upgrade -- Upgrade database to current version. |
| 21 | | wiki list -- List wiki pages |
| 22 | | wiki export <page> [file] -- Export wiki page to file or stdout |
| 23 | | wiki import <page> [file] -- Import wiki page from file or stdin |
| 24 | | wiki dump <directory> -- Export all wiki pages to files named by title |
| 25 | | wiki load <directory> -- Import all wiki pages from directory |
| 26 | | wiki upgrade -- Upgrade default wiki pages to current version |
| 27 | | permission list -- List permission rules |
| 28 | | permission add <user> <action> [action] [...] -- Add a new permission rule |
| 29 | | permission remove <user> <action> [action] [...] -- Remove permission rule |
| 30 | | component list -- Show available components |
| 31 | | component add <name> <owner> -- Add a new component |
| 32 | | component rename <name> <newname> -- Rename a component |
| 33 | | component remove <name> -- Remove/uninstall component |
| 34 | | component chown <name> <owner> -- Change component ownership |
| 35 | | priority list -- Show possible ticket priorities |
| 36 | | priority add <value> -- Add a priority value option |
| 37 | | priority change <value> <newvalue> -- Change a priority value |
| 38 | | priority remove <value> -- Remove priority value |
| 39 | | severity list -- Show possible ticket priorities |
| 40 | | severity add <value> -- Add a severity value option |
| 41 | | severity change <value> <newvalue> -- Change a severity value |
| 42 | | severity remove <value> -- Remove severity value |
| 43 | | version list -- Show versions |
| 44 | | version add <name> [time] -- Add version |
| 45 | | version rename <name> <newname> -- Rename version |
| 46 | | version time <name> <time> -- Set version date (Format: "Jun 3, 2003") |
| 47 | | version remove <name> -- Remove version |
| 48 | | milestone list -- Show milestones |
| 49 | | milestone add <name> [time] -- Add milestone |
| 50 | | milestone rename <name> <newname> -- Rename milestone |
| 51 | | milestone time <name> <time> -- Set milestone date (Format: "Jun 3, 2003") |
| 52 | | milestone remove <name> -- Remove milestone |
| | 14 | trac-admin /path/to/projenv wiki list |
| | 30 | === `trac-admin <targetdir> initenv` === #initenv |
| | 31 | |
| | 32 | This subcommand is very important as is the one used to create a TracEnvironment in the specified `<targetdir>`. That directory must not exist prior to the call. |
| | 33 | |
| | 34 | [[TracAdminHelp(initenv)]] |
| | 35 | |
| | 36 | It supports an extra `--inherit` option, which can be used to specify a global configuration file which can be used to share settings between several environments. You can also inherit from a shared configuration afterwards, by setting the `[inherit] file` option in the `conf/trac.ini` file in your newly created environment, but the advantage of specifying the inherited configuration file at environment creation time is that only the options ''not'' already specified in the global configuration file will be written in the created environment's `conf/trac.ini` file. |
| | 37 | See TracIni#GlobalConfiguration. |
| | 38 | |
| | 39 | Note that in version 0.11 of Trac, `initenv` lost an extra last argument `<templatepath>`, which was used in previous versions to point to the `templates` folder. If you are using the one-liner `trac-admin /path/to/trac/ initenv <projectname> <db> <repostype> <repospath>` in the above and get an error that reads `Wrong number of arguments to initenv: 4`, then this is because you are using a `trac-admin` script from an '''older''' version of Trac. |
| | 40 | |
| | 41 | == Interactive Mode |
| | 42 | |
| | 43 | When passing the environment path as the only argument, `trac-admin` starts in interactive mode. |
| | 44 | Commands can then be executed on the selected environment using the prompt, which offers tab-completion |
| | 45 | (on non-Windows environments, and when the Python `readline` module is available) and automatic repetition of the last command issued. |
| | 46 | |
| | 47 | Once you are in interactive mode, you can also get help on specific commands or subsets of commands: |
| | 48 | |
| | 49 | For example, to get an explanation of the `resync` command, run: |
| | 50 | {{{ |
| | 51 | $ help resync |
| | 52 | }}} |
| | 53 | |
| | 54 | To get help on all the Wiki-related commands, run: |
| | 55 | {{{ |
| | 56 | $ help wiki |
| | 57 | }}} |
| | 58 | |
| | 59 | == Full Command Reference |
| | 60 | |
| | 61 | You will find below the detailed help for all the commands available by default in `trac-admin`. Note that this may not match the list given by `trac-admin <yourenv> help`, as the commands pertaining to components disabled in that environment won't be available and conversely some plugins activated in the environment can add their own commands. |
| | 62 | |
| | 63 | [[TracAdminHelp()]] |
