Ubuntu上安裝Trac

Trac是一個輕量級項目管理軟體，使用Web界面，最近我發現用它來管理一下個人事務也是提不錯的，因此就在自己的機器上安裝了一個。對於像我這樣的非專業人式來說，安裝Trac實在是有點麻煩，有些問題我還是在得到專門人工的幫忙下才搞定，因此有必要記錄一下。我的系統是Ubuntu 7.04，相信以下的安裝過程在Debain上也是大同小異。

第一步: 安裝Trac軟體並初始化Trac系統

在Ubuntu上安裝Trac軟體很簡單，只需運行:

sudo apt-get install trac

安裝完后就可以建立Trac系統，我準備安裝在/var/www/trac目錄下。建立Trac系統主要使用trac-admin中的initenv命令。注意所有對Trac系統的操作我都用www-data用戶來完成，因為Trac是一個Web應用，是通過Apache來訪問的。詳細過程如下:

cd /var/www
sudo mkdir trac
sudo chown -R www-data:www-data trac
sudo -u www-data trac-admin trac initenv
Project Name [My Project]> 在這裡輸入你的項目名稱
Database connection string [sqlite:db/trac.db]>
Repository type [svn]>
Path to repository [/path/to/repos]> 在這裡輸入你的項目對應的Subversion地址
Templates directory [/usr/share/trac/templates]>

注意Trac默認情況下只能訪問本機的Subversion倉庫，在上面填寫地址時不能加"file://"前綴。

第二步: 配置Apache
初始化Trac系統后，還需要在Apache中進行相應的配置才能使用。由於Trac使用CGI，因此首先要將Trac的CGI程序（/usr/share/trac/cgi-bin/trac.cgi）部署到Apache的cgi-bin目錄中（做個符號鏈接即可）。過程如下:

cd /usr/lib
sudo mkdir cgi-bin
sudo chown -R www-data:www-data cgi-bin
cd cgi-bin
sudo -u www-data ln -s /usr/share/trac/cgi-bin/trac.cgi trac.cgi

然後在Apache配置中加入Trac站點的配置信息，在Ubuntu下站點配置通常放在/etc/apache2/sites-available/default這一文件中，可編輯該文件加入以下內容（這些內容在Trac的說明文檔中都有，在/usr/share/doc/trac/README.Debian文件中）:

Alias /trac/ "/usr/share/trac/htdocs/"

Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all


SetEnv TRAC_ENV "/var/www/trac"


AuthType Basic
AuthName "trac"
AuthUserFile /etc/apache2/trac.htpasswd
Require valid-user


上面配置使用Apache內建支持的基於htpasswd文件的Basic認證方式，使用/etc/apache2/trac.htpasswd為口令文件，因此需要創建這一文件，並創建用於訪問Trac系統的用戶名和密碼。這通過htpasswd命令完成，如下所示:

cd /etc/apaceh2
sudo htpasswd -c trac.htpasswd 你的用戶名
在這裡輸入用戶密碼

最後使用重新載入Apache配置:
sudo /etc/init.d/apache2 reload

然後就可以通過瀏覽器訪問你的Trac了，地址是http://localhost/cgi-bin/trac.cgi。

第三步: 安裝WebAdmin
按上面的方法安裝后已經獲得了一個全功能的Trac系統，但很多管理工作如增加模塊，管理許可權等都要通過trac-admin命令行工具來完成，不是很方便。為簡化Trac使用，可以安裝WebAdmin插件。

首先安裝setuptools:
sudo apt-get install python-setuptools

然後從Trac的Subversion上下載WebAdmin的源代碼進行編譯，如下:

cd /tmp
sudo -u www-data svn co http://svn.edgewall.com/repos/trac/sandbox/webadmin/
sudo -u www-data python setup.py bdist_egg

編譯完成後在dist目錄下會產生一個TracWebAdmin-xxx.egg文件，將這一文件拷貝到trac系統的plugins目錄。.egg文件為一個Python軟體的打包方式，類似於Java開發EJB時的.ear等文件，在載入這一軟體包時Apache會將其內容解壓放到/var/www/.python-eggs目錄下，因此如果你還沒有創建/var/www/.python-eggs目錄需要先創建一個。最後重新載入Apache配置，WebAdmin的安裝就算完成了。

安裝完WebAdmin后，對於那些有某些admin許可權的用戶，在登陸到Trac后將在頂總的導航欄出現"Admin"項，點擊進入即可完成一些管理操作。但由於默認的用戶都沒有admin許可權，因此首先要使用trac-admin工具為用戶設置許可權，才能用WebAdmin的管理功能。

Tags: linux system 系統