| | 1 | = TracAdmin = |
| | 2 | [[TracGuideToc]] |
| | 3 | |
| | 4 | Trac is distributed with a powerful configuration tool. This tool can be used |
| | 5 | to configure and customize your Trac-installation to better fit your needs. |
| | 6 | |
| | 7 | == Usage == |
| | 8 | |
| | 9 | {{{ |
| | 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 |
| | 53 | }}} |
| | 54 | |
| | 55 | == Interactive Mode == |
| | 56 | |
| | 57 | When passed the database filename as only argument, '''trac-admin''' starts in interactive mode. |
| | 58 | Commands can then be executed on the selected database using the prompt, which offers tab-completion |
| | 59 | (on non-Windows environments) and automatic repetition of the last command issued. |
| | 60 | |
| | 61 | == A Note on Configuration == |
| | 62 | For configuration of the Trac environment, Trac 0.7 introduced a new storage format, including a separate config file used for settings. See TracIni for details. |
| | 63 | |
| | 64 | |
| | 65 | ---- |
| | 66 | See Also: TracGuide, TracBackup, TracPermissions. TracEnvironment, TracIni |
