管理ツール

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

使い方

使用方法: trac-admin <Trac Environmentへのフルパス> [コマンド [サブコマンド] [オプション ...]]

コマンドを指定しないでtrac-adminを起動すると、対話モードを開始します。

about                                             -- trac-adminに関する情報を表示
help                                              -- ヘルプ画面を表示
initenv                                           -- 対話モードでTrac Environmentを新規作成もしくは初期化
initenv <projectname> <repospath> <templatepath>  -- 引数に指定した情報から非対話モードでTrac Environmentを新規作成もしくは初期化
hotcopy <backupdir>                               -- 運用中にTrac Enviromentのバックアップコピーを作成
resync                                            -- リポジトリとTracを再同期する。
upgrade                                           -- (古いtracで作成した)データベースを現在のバージョンに変換
wiki list                                         -- wikiページの一覧
wiki export <page> [file]                         -- <page>で指定したwikiページをファイルまたは標準出力にエクスポート
wiki import <page> [file]                         -- ファイルまたは標準入力から<page>で指定したwikiページにインポート
wiki dump <directory>                             -- すべてのwikiページをtitle名のファイルにエクスポート
wiki load <directory>                             -- すべてのwikiページを<directory>からインポート
wiki upgrade                                      -- (古いtracで作成した)デフォルトのwikiページを現在のバージョンで更新
permission list                                   -- 操作権限の一覧
permission add <user> <action> [action] [...]     -- 新しい操作権限を追加
permission remove <user> <action> [action] [...]  -- 操作権限を削除
component list                                    -- 登録してあるコンポーネントの一覧
component add <name> <owner>                      -- 新しいコンポーネントを追加
component rename <name> <newname>                 -- コンポーネントの名称を変更
component remove <name>                           -- コンポーネントを削除
component chown <name> <owner>                    -- コンポーネントの初期担当者を変更
priority list                                     -- チケットで使用できる優先度を表示する。
priority add <value>                              -- 優先度の項目<value>を追加する。
priority change <value> <newvalue>                -- 優先度の項目<value>を<newvalue>に変更する。
priority remove <value>                           -- 優先度の項目<value>を削除する。
severity list                                     -- チケットで使用できる重要度を表示する。
severity add <value>                              -- 重要度の項目<value>を追加する。 
severity change <value> <newvalue>                -- 重要度の項目<value>を<newvalue>に変更する。
severity remove <value>                           -- 重要度の項目<value>を削除する。
version list                                      -- バージョンの一覧を表示する。
version add <name> [time]                         -- バージョンを追加する。
version rename <name> <newname>                   -- バージョン名称を<name>から<newname>に変更する。
version time <name> <time>                        -- バージョンに日時を設定する。(書式: "Jun 3, 2003")
version remove <name>                             -- バージョン名称<name>を削除する。
milestone list                                    -- マイルストーンの一覧を表示する。
milestone add <name> [time]                       -- マイルストーンの追加する。
milestone rename <name> <newname>                 -- マイルストーンの名称変更する。
milestone time <name> <time>                      -- マイルストーンに完了期限を設定する。 (書式: "Jun 3, 2003")
milestone remove <name>                           -- マイルストーンを削除する。

対話モード

trac-adminはデータベースのファイル名だけを引数に指定して起動した場合、対話モードになります。

プロンプトから入力したコマンドは指定したプロジェクトのデータベースに対して実行します。 Windows環境以外ではコマンドをTABキーで補完する機能と、最後に実行したコマンドを繰り返す機能が提供されます。

コンフィグレーションに関する注記

Trac Enviromentのコンフィグレーションのために、Trac 0.7において、コンフィグファイルの分割と、新しい保管形式を導入しています。詳細は TracIni を見てください。

---

参考: TracGuide, TracBackup, TracPermissions. TracEnvironment, TracIni