管理ツール

Trac は強力なコマンドラインの管理ツールとともに配布されています。このツールで Trac を管理/設定し、インストールを用途に合わせてカスタマイズすることができます。

これらの操作のうち主要なものについては、 管理 (英語版では Admin) Web インタフェースでも行うことができます。  WebAdmin の最新アップデートが Trac に統合されています。 (0.11 以降)

使い方

trac-admin コマンドを help オプションつきで起動することによって、利用できるコマンド/サブコマンドの分かりやすいオプションリストを見ることができます:

trac-admin help

help, about, version のサブコマンドを実行しないならば、第1引数に管理したい TracEnvironment へのパスを指定する必要があります。例えば:

trac-admin /path/to/projenv wiki list

対話モード

trac-adminTracEnvironment のパスだけを引数に指定して起動した場合、対話モードになります。 プロンプトから入力したコマンドは指定した TracEnvironment に対して実行します。 コマンドを Tab キーで補完する機能と、最後に実行したコマンドを繰り返す機能が提供されます (非 Windows 環境の場合、 Python が readline モジュールを使用できる必要があります) 。

一度対話モードで起動すると、特定のコマンドのヘルプやコマンドのサブセットを見ることができます:

例えば、 resync コマンドの説明を得るためには以下のように実行します:

> help resync

Wiki に関するすべてのコマンドのヘルプを得るためには、以下のように実行します:

> help wiki

完全なコマンドリファレンス

help
	-- Show documentation

initenv
	-- Create and initialize a new environment interactively

initenv <projectname> <db> <repostype> <repospath>
	-- Create and initialize a new environment from arguments

hotcopy <backupdir>
	-- Make a hot backup copy of an environment

resync
	-- Re-synchronize trac with the repository

resync <rev>
	-- Re-synchronize only the given <rev>

upgrade
	-- Upgrade database to current version

deploy <directory>
	-- Extract static resources from Trac and all plugins.

permission list [user]
	-- List permission rules

permission add <user> <action> [action] [...]
	-- Add a new permission rule

permission remove <user> <action> [action] [...]
	-- Remove permission rule

wiki list
	-- List wiki pages

wiki remove <page>
	-- Remove wiki page

wiki export <page> [file]
	-- Export wiki page to file or stdout

wiki import <page> [file]
	-- Import wiki page from file or stdin

wiki dump <directory>
	-- Export all wiki pages to files named by title

wiki load <directory>
	-- Import all wiki pages from directory

wiki upgrade
	-- Upgrade default wiki pages to current version

ticket remove <number>
	-- Remove ticket

ticket_type list
	-- Show possible ticket types

ticket_type add <value>
	-- Add a ticket type

ticket_type change <value> <newvalue>
	-- Change a ticket type

ticket_type remove <value>
	-- Remove a ticket type

ticket_type order <value> up|down
	-- Move a ticket type up or down in the list

priority list
	-- Show possible ticket priorities

priority add <value>
	-- Add a priority value option

priority change <value> <newvalue>
	-- Change a priority value

priority remove <value>
	-- Remove priority value

priority order <value> up|down
	-- Move a priority value up or down in the list

severity list
	-- Show possible ticket severities

severity add <value>
	-- Add a severity value option

severity change <value> <newvalue>
	-- Change a severity value

severity remove <value>
	-- Remove severity value

severity order <value> up|down
	-- Move a severity value up or down in the list

component list
	-- Show available components

component add <name> <owner>
	-- Add a new component

component rename <name> <newname>
	-- Rename a component

component remove <name>
	-- Remove/uninstall component

component chown <name> <owner>
	-- Change component ownership

version list
	-- Show versions

version add <name> [time]
	-- Add version

version rename <name> <newname>
	-- Rename version

version time <name> <time>
	-- Set version date (Format: "YYYY-MM-DD", "now" or "")

version remove <name>
	-- Remove version

milestone list
	-- Show milestones

milestone add <name> [due]
	-- Add milestone

milestone rename <name> <newname>
	-- Rename milestone

milestone due <name> <due>
	-- Set milestone due date (Format: "YYYY-MM-DD", "now" or "")

milestone completed <name> <completed>
	-- Set milestone completed date (Format: "YYYY-MM-DD", "now" or "")

milestone remove <name>
	-- Remove milestone

resolution list
	-- Show possible ticket resolutions

resolution add <value>
	-- Add a resolution value option

resolution change <value> <newvalue>
	-- Change a resolution value

resolution remove <value>
	-- Remove resolution value

resolution order <value> up|down
	-- Move a resolution value up or down in the list

Notes

initenv では --inherit オプションを使用できるようになりました。これは Environment 作成時に [inherit] file オプションを指定できます。このオプションはグローバル設定ファイルの中では 設定しない でください。新たに作成された Environment の conf/trac.ini ファイルに書き出されてしまいます。 詳細は TracIni#GlobalConfiguration を参照してください。

Trac 0.11 では initenv の最後の引数であるt <templatepath> が廃止されました。この引数は以前のバージョンでは templates ディレクトリの場所を指定していました。コマンド 'trac-admin /path/to/trac/ initenv <projectname> <db> <repostype> <repospath>' を使用した時に 'Wrong number of arguments to initenv: 4' というエラーが発生した場合、使用している trac-admin のスクリプトが 古い バージョンの Trac のものである可能性があります。


See also: TracGuide, TracBackup, TracPermissions, TracEnvironment, TracIni,  TracMigrate