Code

Changes between Version 9 and Version 10 of TracAdmin


Ignore:
Timestamp:
01/28/11 12:52:13 (3 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracAdmin

    v9 v10  
    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  
     1= TracAdmin = 
     2[[TracGuideToc]] 
     3 
     4Trac 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 
     6Some of those operations can also be performed via the ''Admin'' web interface, an updated version of the [trac:WebAdmin] plugin now integrated within Trac (since version 0.11). 
     7 
     8== Usage == 
     9 
     10For nearly every `trac-admin` command, you'll need to specify the path to the TracEnvironment that you want to administer as the first argument, for example: 
     11{{{ 
     12trac-admin /path/to/projenv wiki list 
     13}}} 
     14 
     15The only exception is for the `help` command, but even in this case if you omit the environment, you'll only get a very succinct list of commands (`help` and `initenv`), the same list you'd get when invoking `trac-admin` alone. 
     16Also, `trac-admin --version` will tell you about the Trac version (e.g. 0.12) corresponding to the program. 
     17 
     18If you want to get a comprehensive list of the available commands and sub-commands, you need to specify an existing environment: 
     19{{{ 
     20trac-admin /path/to/projenv help 
     21}}} 
     22 
     23Some commands have a more detailed help, which you can access by specifying the command's name as a subcommand for `help`: 
     24 
     25{{{ 
     26trac-admin /path/to/projenv help <command> 
     27}}} 
     28 
     29=== `trac-admin <targetdir> initenv` === #initenv 
     30 
     31This subcommand is very important as it's the one used to create a TracEnvironment in the specified `<targetdir>`. That directory must not exists prior to the call. 
     32 
     33[[TracAdminHelp(initenv)]] 
     34 
     35It supports an extra `--inherit` option, which can be used to specify a global configuration file which can be used 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. 
     36See TracIni#GlobalConfiguration. 
     37 
     38Note 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 getting an error that reads ''''`Wrong number of arguments to initenv: 4`'''', then this is because you're using a `trac-admin` script from an '''older''' version of Trac. 
     39 
     40== Interactive Mode == 
     41 
     42When passing the environment path as the only argument, `trac-admin` starts in interactive mode. 
     43Commands can then be executed on the selected environment using the prompt, which offers tab-completion 
     44(on non-Windows environments, and when the Python `readline` module is available) and automatic repetition of the last command issued. 
     45 
     46Once you're in interactive mode, you can also get help on specific commands or subsets of commands: 
     47 
     48For example, to get an explanation of the `resync` command, run: 
     49{{{ 
     50> help resync 
     51}}} 
     52 
     53To get help on all the Wiki-related commands, run: 
     54{{{ 
     55> help wiki 
     56}}} 
     57 
     58== Full Command Reference == 
     59 
     60You'll 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. 
     61 
     62[[TracAdminHelp()]] 
     63 
     64---- 
     65See also: TracGuide, TracBackup, TracPermissions, TracEnvironment, TracIni, [trac:TracMigrate TracMigrate]