จาก WikiBall

เนื้อหา 1 ติดตั้ง Program ใน Ubuntu 1.1 SVN + Apache 1.2 Trac + Apache 2 การสร้าง project 2.1 สร้าง repository 2.2 สร้าง Trac 3 Enable apache modules 4 Apache configure 4.1 configuration file สำหรับ trac 4.2 configuration file สำหรับ subversion 4.3 Enable site 5 วิธีสร้าง .htaccess 6 Restart apache 7 การใช้งาน

ติดตั้ง Program ใน Ubuntu

SVN + Apache

ติดตั้ง apache

$ sudo apt-get install apache2

ติดตั้ง svn

$ sudo apt-get install subversion

ติดตั้งโมดูล svn ของ apache

$ sudo apt-get install libapache2-svn

Trac + Apache

การติดตั้ง Trac จำเป็นต้องมี SVN อยู่ก่อนแล้ว
จึงทำการติดตั้ง Trac ดังนี้
ดาวโหลด trac มาใส่ไว้ในที่ไดที่หนึ่งอาจเป็น /home/user ก็ได้ หรืออาจให้ wget ดึงมาเลย

wget http://ftp.edgewall.com/pub/trac/Trac-0.11.5.tar.gz

ระเบิดมัน

tar -xzf Trac-0.11.5.tar.gz

ลง Python setup

$ sudo apt-get install python-setuptools

เข้าไปที่ directory ดังกล่าว Trac-0.11.5 แล้วทำการ install

$ sudo python ./setup.py install

การสร้าง project

สร้าง repository

ตัวอย่างการสร้าง

$ svnadmin create /var/svn/repository/example

นำเข้า (import) project

$ svn import /path/to/projectexample file:///var/svn/repository/example/examplev1 -m"initial import" 

สร้าง Trac

การสร้าง project enviroment รันคำสั่ง

$ trac-admin /path/to/myproject initenv

ดู option ต่างๆ ได้ที่ การใช้งาน trac

Enable apache modules

เราต้องทำการ enable apache modules โดยการทำ soft link ใน /etc/apache2/mods-enabled ไปยัง /etc/apache2/mods-available/

$ cd /etc/apache2/mods-enabled
$ sudo ln -s ../mods-available/dav_svn.conf
$ sudo ln -s ../mods-available/dav_svn.load
$ sudo ln -s ../mods-available/mod_python.load

Apache configure

หลังจากลงโปรแกรม แล้ว เราก็จะมากทำการ config เจ้าตัว apache ของเราให้สามารถทำงานได้กัน โดยก่อนอื่นต้องเข้าไปที่ /etc/apache2/sites-available/

configuration file สำหรับ trac

สร้าง config file ใหม่

$sudo vim trac

<Location /uri/path/to/trac/project>
        SetHandler mod_python
        PythonInterpreter main_interpreter
        PythonHandler trac.web.modpython_frontend
        PythonOption TracEnv /path/to/project/environment
        PythonOption TracUriRoot /uri/path/to/trac/project
</Location>

ถ้าต้องการทำ authentication ผ่าน .htaccess ของ apache ให้เพิ่มโค้ดด้านล่าง ลงใน Location

        AuthType Basic
        AuthName "Project name"
        AuthUserFile /path/to/.htaccess
        Require valid-user

configuration file สำหรับ subversion

สร้าง config file ใหม่

$sudo vim svn

<Location /uri/path/to/svn/project>
        DAV svn
        SVNPath /var/svn/repository/rddi/mailgoth/
</Location

ถ้าต้องการทำ authentication ผ่าน .htaccess ของ apache ให้เพิ่มโค้ดด้านล่าง ลงใน Location

        AuthType Basic
        AuthName Foo
        AuthUserFile /var/svn/repository/rddi/mailgoth/.htaccess

        require valid-user
        Order deny,allow

Enable site

ทำการ Enable site

$ cd /etc/apache2/sites-enabled/
$ sudo ln -s ../sites-available/svn 002-svn
$ sudo ln -s ../sites-available/trac 002-trac

วิธีสร้าง .htaccess

htpasswd -c .htaccess username

Restart apache

สั่ง restart apache

 $ sudo apache2ctl restart

ถ้าเข้าแล้วยังมี error อยู่ ให้ไปดูที่ /var/log/apache/error.log ว่ามี Error อะไรเกิดขึ้น

การใช้งาน

• เข้าใช้งาน Trac : http:/site.name/uri/path/to/trac/project
• เข้าใช้งาน SVN : http:/site.name/uri/path/to/svn/project

จาก WikiBall

Subversion เป็นโปรแกรมที่ใชัสร้าง และจัดการ version ของ source code ของเรา

เนื้อหา 1 การติดตั้ง 1.1 การใช้งานร่วมกับ apache2 2 การใช้งาน 2.1 สร้าง repository 2.2 นำเข้า (import) project 2.3 การเข้าผ่าน apache 2.4 คู่มือการใช้งาน 2.5 การ config svnserve 2.6 SVN Client 3 svn service file 4 Troubleshooting 5 อื่นๆ ที่เกี่ยวข้อง

การติดตั้ง

สำหรับ Ubuntu

$ sudo apt-get install apt-get install subversion

การใช้งานร่วมกับ apache2

ติดตั้ง apache module

$ sudo apt-get install libapache2-svn

สร้าง diretory ดังตัวอย่าง หรืออย่างอื่นก็ได้

mkdir /var/svn
mkdir /var/svn/repository

แก้ไขค่า permission

chown www-data:www-data -R /var/svn/repository
chmod 770 -R /var/svn/repository

แก้ไข apache svn module configuration file : /etc/apache2/mods-available/dav_svn.conf

...
SVNParentPath /var/svn/repository
#SVNPath /var/svn/repository
.....
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /etc/apache2/dav_svn.passwd
Require valid-user
...

สร้าง htaccess

htpasswd2 -c /etc/apache2/dav_svn.passwd tester

ref : http://www.debuntu.org/2006/05/20/54-how-to-subversion-svn-with-apache2-and-dav

การใช้งาน

สร้าง repository

ตัวอย่างการสร้าง

$ svnadmin create /var/svn/repository/example

นำเข้า (import) project

$ svn import /path/to/projectexample file:///var/svn/repository/example/examplev1 -m"initial import" 

การเข้าผ่าน apache

http://servername/svn/project

คู่มือการใช้งาน

1. SVN Command line 1
2. SVN Command line 2
3. คู่มือการใช้งาน Subversion
4. คู่มือการใช้งาน RapidSVN

การ config svnserve

svnserve คือ daemon สำหรับ svn โดยที่เราสามารถ login ผ่านทาง SVN client ต่างๆ โดยผ่านโปรโตคอล svn

svn://hostname:port/repos

ทดสอบรับ daemon แบบ forground โดยใช้คำสั่ง

$ sudo svnserve -d --listen-port=port --foreground -r  root/path

เรียกเป็น http ใน browser ถ้าขึ้นในลักษณะนี้แสดงว่ารันได้แล้ว

( success ( 1 2 ( ANONYMOUS ) ( edit-pipeline svndiff1 absent-entries ) ) )

ตัว svnserve นี้จะไม่มี file ใน init.d มาให้เราจะต้องสร้างเองดังนี้
สื่อ:svnserve.tar.gz

อย่าลืมตั้งค่า authentication ใน /path/to/repository/conf

SVN Client

สำหรับที่ผู้ที่ไม่อยากใช้ SVN แบบ command line ใช้แบบ command line ไม่เป็น(เช่นเดียวกับผม) จะมี GUI กระต่ายกับเต่า ให้เลือกใช้ได้ดังนี้

1. TortoiseSVN-(Windows)
2. RapidSVN-(Ubuntu+Mac+Windows)

ref : http://agaricdesign.com/note/subversion-client-ubuntu-anything-tortoisesvn

svn service file

#!/bin/sh -e
#
# svnserve - brings up the svn server so anonymous users
# can access svn
#

# Get LSB functions
. /lib/lsb/init-functions
. /etc/default/rcS

SVNSERVE=/usr/bin/svnserve
SVN_USER=svn
SVN_GROUP=svn
SVN_REPO_PATH=/var/svn/repository/
SVN_PORT=8000

# Check that the package is still installed
[ -x $SVNSERVE ] || exit 0;

case "$1" in
	start)
		log_begin_msg "Starting svnserve..."
		umask 002
		if start-stop-daemon --start \
		--chuid $SVN_USER:$SVN_GROUP \
		--exec $SVNSERVE \
		-- -d --listen-port=$SVN_PORT -r $SVN_REPO_PATH; then
			log_end_msg 0
		else
			log_end_msg $?
		fi
	;;

	stop)
		log_begin_msg "Stopping svnserve..."
		if start-stop-daemon --stop --exec $SVNSERVE; then
		log_end_msg 0
		else
		log_end_msg $?
		fi
	;;

	restart|force-reload)
		"$0" stop && "$0" start
	;;

	*)
	echo "Usage: /etc/init.d/svnserve {start|stop|restart|force-reload}"
		exit 1
	;;
esac

exit 0

Troubleshooting

• import ไม่ได้

svn: Unable to open an ra_local session to URL
svn: Unable to open repository 'file:///Development/subversion/foo'

เหตุการณ์ดังกล่าวเกิดขึ้นได้ 2 กรณี คือ

 #path ดังกล่าวไม่สามารถเข้าไปได้ เช่น ติด permission
 #ใส่ path กับ URL สรับกัน

อื่นๆ ที่เกี่ยวข้อง

จาก WikiBall

Subversion เป็นโปรแกรมที่ใชัสร้าง และจัดการ version ของ source code ของเรา

เนื้อหา 1 การติดตั้ง 1.1 การใช้งานร่วมกับ apache2 2 การใช้งาน 2.1 สร้าง repository 2.2 นำเข้า (import) project 2.3 การเข้าผ่าน apache 2.4 คู่มือการใช้งาน 2.5 การ config svnserve 2.6 SVN Client 3 svn service file 4 Troubleshooting 5 อื่นๆ ที่เกี่ยวข้อง

การติดตั้ง

สำหรับ Ubuntu

$ sudo apt-get install apt-get install subversion

การใช้งานร่วมกับ apache2

ติดตั้ง apache module

$ sudo apt-get install libapache2-svn

สร้าง diretory ดังตัวอย่าง หรืออย่างอื่นก็ได้

mkdir /var/svn
mkdir /var/svn/repository

แก้ไขค่า permission

chown www-data:www-data -R /var/svn/repository
chmod 770 -R /var/svn/repository

แก้ไข apache svn module configuration file : /etc/apache2/mods-available/dav_svn.conf

...
SVNParentPath /var/svn/repository
#SVNPath /var/svn/repository
.....
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /etc/apache2/dav_svn.passwd
Require valid-user
...

สร้าง htaccess

htpasswd2 -c /etc/apache2/dav_svn.passwd tester

ref : http://www.debuntu.org/2006/05/20/54-how-to-subversion-svn-with-apache2-and-dav

การใช้งาน

สร้าง repository

ตัวอย่างการสร้าง

$ svnadmin create /var/svn/repository/example

นำเข้า (import) project

$ svn import /path/to/projectexample file:///var/svn/repository/example/examplev1 -m"initial import" 

การเข้าผ่าน apache

http://servername/svn/project

คู่มือการใช้งาน

1. SVN Command line 1
2. SVN Command line 2
3. คู่มือการใช้งาน Subversion
4. คู่มือการใช้งาน RapidSVN

การ config svnserve

svnserve คือ daemon สำหรับ svn โดยที่เราสามารถ login ผ่านทาง SVN client ต่างๆ โดยผ่านโปรโตคอล svn

svn://hostname:port/repos

ทดสอบรับ daemon แบบ forground โดยใช้คำสั่ง

$ sudo svnserve -d --listen-port=port --foreground -r  root/path

เรียกเป็น http ใน browser ถ้าขึ้นในลักษณะนี้แสดงว่ารันได้แล้ว

( success ( 1 2 ( ANONYMOUS ) ( edit-pipeline svndiff1 absent-entries ) ) )

ตัว svnserve นี้จะไม่มี file ใน init.d มาให้เราจะต้องสร้างเองดังนี้
สื่อ:svnserve.tar.gz

อย่าลืมตั้งค่า authentication ใน /path/to/repository/conf

SVN Client

สำหรับที่ผู้ที่ไม่อยากใช้ SVN แบบ command line ใช้แบบ command line ไม่เป็น(เช่นเดียวกับผม) จะมี GUI กระต่ายกับเต่า ให้เลือกใช้ได้ดังนี้

1. TortoiseSVN-(Windows)
2. RapidSVN-(Ubuntu+Mac+Windows)

ref : http://agaricdesign.com/note/subversion-client-ubuntu-anything-tortoisesvn

svn service file

#!/bin/sh -e
#
# svnserve - brings up the svn server so anonymous users
# can access svn
#

# Get LSB functions
. /lib/lsb/init-functions
. /etc/default/rcS

SVNSERVE=/usr/bin/svnserve
SVN_USER=svn
SVN_GROUP=svn
SVN_REPO_PATH=/var/svn/repository/
SVN_PORT=8000

# Check that the package is still installed
[ -x $SVNSERVE ] || exit 0;

case "$1" in
	start)
		log_begin_msg "Starting svnserve..."
		umask 002
		if start-stop-daemon --start \
		--chuid $SVN_USER:$SVN_GROUP \
		--exec $SVNSERVE \
		-- -d --listen-port=$SVN_PORT -r $SVN_REPO_PATH; then
			log_end_msg 0
		else
			log_end_msg $?
		fi
	;;

	stop)
		log_begin_msg "Stopping svnserve..."
		if start-stop-daemon --stop --exec $SVNSERVE; then
		log_end_msg 0
		else
		log_end_msg $?
		fi
	;;

	restart|force-reload)
		"$0" stop && "$0" start
	;;

	*)
	echo "Usage: /etc/init.d/svnserve {start|stop|restart|force-reload}"
		exit 1
	;;
esac

exit 0

Troubleshooting

• import ไม่ได้

svn: Unable to open an ra_local session to URL
svn: Unable to open repository 'file:///Development/subversion/foo'

เหตุการณ์ดังกล่าวเกิดขึ้นได้ 2 กรณี คือ

 #path ดังกล่าวไม่สามารถเข้าไปได้ เช่น ติด permission
 #ใส่ path กับ URL สรับกัน

อื่นๆ ที่เกี่ยวข้อง

จาก WikiBall

เนื้อหา 1 การติดตั้ง 2 การสร้าง project enviroment 3 การทำ Authentication 3.1 การสร้างแบบ .htpasswd 3.2 การสร้างแบบ .htdigest 4 การรัน Service ของ trac 4.1 การรันโดยใช้ Basic Authentiction 4.2 การรันโดยใช้ Digest Authentiction 4.3 การรันแบบ Multiple Project 4.4 Service tracd 5 การทำ NGINX + TRAC 6 การสร้าง Repository 7 Troubleshooting 7.1 โหลดโปรเจคไม่ขึ้น 7.2 admin tab ไม่ขึ้น 7.3 login ไม่ได้ 7.4 repository & SVN error 7.5 HTML preview not available 8 Plugin 9 Reference

การติดตั้ง

ขั้นแรกติดตั้ง apache, sqlite

ต่อไป download source จาก<a href=”http://”> http://trac.edgewall.org/wiki/TracDownload</a>
ระเบิด(Extract) มันออกมา (ถ้าเป็น tar.gz)

$ tar -xzf trac.tar.gz

เข้าไปยัง source ที่ระเบิดได้
ถ้ายังไม่มี python ก็ในลง python ก่อน แต่ Ubuntu ตัวใหม่ๆ จะมีมาให้อยู่แล้วแต่ยังไม่มี setuptools ตังนั้น ใช้คำสั่งนี้ลงได้ทีเดียวเลยครับ

$ sudo apt-get install python-setuptools

ต่อไป compile เลย

$ sudo python ./setup.py install

ดูเพิ่มเติมได้ที่ > การติดตั้ง Trac

การสร้าง project enviroment

รันคำสั่ง

$ trac-admin /path/to/myproject initenv

ดู option ต่างๆ ได้ที่ การใช้ [initenv]

การทำ Authentication

trac นั้นจะใช้การ Authentication ผ่าน apache จะง่ายกว่ามากครับ
โดยในที่นี้จะกล่าวถึงเฉพาะ tracd หรือ Trac แบบ standalone เท่านั้นโดยมีวิธีทำดังนี้

การสร้างแบบ .htpasswd

htpasswd -c /path/to/env/.htpasswd username

เพิ่ม user ที่ต้องการ

sudo htpasswd /path/to/env/.htpasswd username2

รัน tracd โดยใช้ option – -basic-auth

การสร้างแบบ .htdigest

htdigest -c /path/to/env/.htpasswd realm username

เพิ่ม user ที่ต้องการ

htdigest /path/to/env/.htpasswd realm username

รัน tracd โดยใช้ option – -auth

การรัน Service ของ trac

การรัน Service ของ trac นั้นจะแบ่งเป็น 2 ลักษณะคือ

1. Standalone : รันบน tracd พอร์ต(port) 8000 ซึ่งสามารถวิ่งใช้บน localhost ได้สบายๆ
   standalone
2. WebService : รันบน TracCgi หรือ TracModPython

การรันโดยใช้ Basic Authentiction

tracd -p 8080 --basic-auth=environmentname,/fullpath/environmentname/.htpasswd,/fullpath/environmentname /fullpath/environmentname

การรันโดยใช้ Digest Authentiction

$ tracd -p port --auth=base_project_dir,password_file_path,realm project_path

• base_project_dir คือ directory หลักของ project (ตัวเล็กใหญ่มีผล)
• password_file_path คือ path ที่อยู่ของไฟล์รหัสผ่าน
• realm คือ ชื่อที่อยู่ของโปรเจค (URL)
• project_path คือ ที่อยู่ของ project

การรันแบบ Multiple Project

$ tracd -p 8080 \
   --auth=project1,/path/to/users.htdigest,mycompany.com /path/to/project1

$ tracd -p 8080 \
   --auth=project1,/path/to/users.htdigest,mycompany.com \
   --auth=project2,/path/to/users.htdigest,mycompany.com \
   /path/to/project1 /path/to/project2

$ tracd -p 8080 \
   --auth="*",/path/to/users.htdigest,mycompany.com \
   /path/to/project1 /path/to/project2

ระวังห้ามใส่ตัวใหญ่

Service tracd

ใส่ script ดังนี้ใน /etc/init.d/tracd

#! /bin/sh
#
# tracd		Trac standalone server daemon
#
# Author:	cocoaberry
#

set -e

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DESC="Trac standalone server"
NAME=tracd
DAEMON=/usr/bin/$NAME
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME

# Gracefully exit if the package has been removed.
test -x $DAEMON || exit 0

# defaults for tracd
TRACD_PORT=8080
TRACD_BIND_ADDRESS=0.0.0.0
TRACD_EXTRA_OPTS=

# Read config file if it is present.
if [ -r /etc/default/$NAME ]
then
	. /etc/default/$NAME
fi

#
#	Function that starts the daemon/service.
#
d_start() {
	start-stop-daemon --start --background --make-pidfile --quiet \
		--pidfile $PIDFILE --chuid $TRACD_USER \
		--exec $DAEMON -- $TRACD_EXTRA_OPTS --port $TRACD_PORT --hostname $TRACD_BIND_ADDRESS $TRACD_ENVIRONMENTS
}

#
#	Function that stops the daemon/service.
#
d_stop() {
	start-stop-daemon --stop --quiet --oknodo --pidfile $PIDFILE \
		--name $NAME
}

case "$1" in
  start)
	echo -n "Starting $DESC: $NAME"
	d_start
	echo "."
	;;
  stop)
	echo -n "Stopping $DESC: $NAME"
	d_stop
	echo "."
	;;
  restart|force-reload)
	#
	#	If the "reload" option is implemented, move the "force-reload"
	#	option to the "reload" entry above. If not, "force-reload" is
	#	just the same as "restart".
	#
	echo -n "Restarting $DESC: $NAME"
	d_stop
	sleep 1
	d_start
	echo "."
	;;
  *)
	echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2
	exit 1
	;;
esac

exit 0

โดยตั้งค่าไหม่ดังตัวอย่าง

TRACD_USER=tracd
 # The environments that tracd manages. If more than one, separate
 # with spaces
TRACD_ENVIRONMENTS=/home/tracd/trac-env
 # Extra options to tracd
TRACD_EXTRA_OPTS="--auth *,/home/tracd/trac.htdigest,TracRealm"

ref : http://codesnippets.joyent.com/tag/tracd

การทำ NGINX + TRAC

แต่ในที่นี้จะกล่าวถึงการใช้ Standalone บนโดยใช้ nginx มาวิ่งเป็น webservice แบบ proxy
ต่อไป ทำการสร้าง project environment

$ trac-admin /path/to/myproject initenv

รันแบบ standalone ได้เลย

tracd --port 8000 /path/to/myproject

จากนั้นไป set ใน nginx ให้ ทำ proxy มาที่ service ที่เราใส่ไว้

    server {
        listen       80;
        server_name  trac.xxxxxxxxxx.com;

        # proxy the PHP scripts to Apache listening on 127.0.0.1:80
        #

        location /OC/report {
            root /var/trac/test/htdocs;
            autoindex on;
        }

        location / {
            proxy_pass   http://127.0.0.1:8001;
        }

        location ~* ^.+.(jpg|jpeg|gif|png|ico|css|zip|tgz|gz|rar|bz2|doc|xls|exe|pdf|ppt|txt|tar|mid|midi|wav|bmp|rtf|js)$ {
            proxy_pass   http://127.0.0.1:8001;

            #root /var/trac/test/htdocs;
        }

        location /munin/ {
            root /var/trac/test/htdocs;
        }
    }

ดูเพิ่มเติมได้ที่ : การตั้งค่าสำหรับ_nginx_(Nginx_configuration)

การสร้าง Repository

เนื่องจาก trac เองเป็นแค่หน้ากากครอบตัว svn อยู่เท่านั้น ดังนั้นเราจึงต้องสร้าง repository ผ่านท่าง subversion เท่านั้น

Troubleshooting

โหลดโปรเจคไม่ขึ้น

เกิด error ดังต่อไปนี้

Traceback (most recent call last):
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/web/api.py", line 367, in send_error
    'text/html')
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/web/chrome.py", line 688, in render_template
    data = self.populate_data(req, data)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/web/chrome.py", line 596, in populate_data
    d['chrome'].update(req.chrome)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/web/api.py", line 194, in __getattr__
    value = self.callbacks[name](self)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/web/chrome.py", line 464, in prepare_request
    for category, name, text in contributor.get_navigation_items(req):
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/ticket/web_ui.py", line 162, in get_navigation_items
    if 'TICKET_CREATE' in req.perm:
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 523, in has_permission
    return self._has_permission(action, resource)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 537, in _has_permission
    check_permission(action, perm.username, resource, perm)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 424, in check_permission
    perm)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 282, in check_permission
    get_user_permissions(username)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 357, in get_user_permissions
    for perm in self.store.get_user_permissions(username):
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 173, in get_user_permissions
    db = self.env.get_db_cnx()
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/env.py", line 264, in get_db_cnx
    return DatabaseManager(self).get_connection()
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/db/api.py", line 76, in get_connection
    return self._cnx_pool.get_cnx(self.timeout or None)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/db/pool.py", line 174, in get_cnx
    return _backend.get_cnx(self._connector, self._kwargs, timeout)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/db/pool.py", line 107, in get_cnx
    cnx = connector.get_connection(**kwargs)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/db/sqlite_backend.py", line 126, in get_connection
    return SQLiteConnection(path, params)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/db/sqlite_backend.py", line 159, in __init__
    raise TracError('Database "%s" not found.' % path)
TracError: Database "/var/trac/test/test.db" not found.

สาเหตุ

• เกิดจากการสร้าง environment ของโปรเจคนั้นๆ ไม่สมบูรณ์ ให้สร้าง environment ใหม่ โดยให้ขึ้น complete ด้วย ซึ่งในบางครั้งมีไฟล์ใหม่ใน path แต่ก็ยังไม่สมบูรณ์ สังเกตได้จากการรายงานของ trac-admin ตอนส้าง
• ไม่สามารถเปิดไฟล์ DB ของ Sqlite ได้ เนื่องจากติด permission ของ OS

admin tab ไม่ขึ้น

ยังไม่ได้ Authen

login ไม่ได้

ในกรณีนี้จะเกิด error ที่หน้า login เพราะ ไม่ได้ run แบบ authentication หรือ file authentication เกิดการผิดพลาด สังเกตดูว่ามีข้อผิดพลาด(warning)ขณะรัน tracd หรือไม่ ถ้าไม่ ลองดูกรณีของชื่อโปรเจคหรือไม่(ต้องใส่ตัวเล็ก)

ในกรณีทีทำทุกอย่างถูกต้องแล้วแต่ยังไม่สามารถทำ authentication ได้นั้น อาจเป้นเพราะ เมื่อรัน tracd ในส่วน –suthen=project นั้นให้ใส่ path ของเราที่เหมือนกัน URL ใน browser ของเรา เช่น โปรเจค DEMO ซึ่งในหน้า Browser ของเราปรากฎเป็น xxx.xxxxx.com/env/ ก็ใช้ใส่เป็น –authen=env
http://trac.edgewall.org/wiki/TracSubversion#unsupported-vcs

repository & SVN error

Warning: Can't synchronize with the repository (Unsupported version control system "svn": "No module named svn" ). Look in the Trac log for more information.

Trac Error

Unsupported version control system "svn": "No module named svn"

ลองทดสอบดูว่า subversion module ของ python ได้ถูกติดตั้งไว้หรือไม่

http://trac.edgewall.org/wiki/TracSubversion#unsupported-vcs

ถ้าขึ้นข้อความมาแสดงว่ายังไม่ได้ลง ใช้ติดตั้งดังนี้

$ apt-get install python-subversion

HTML preview not available

HTML preview not available, since no preview renderer could handle it. Try downloading the file instead. 

ถ้าไปเปิดใน log ดูจะเห็นว่า

WARNING: HTML preview using <trac.mimeview.php.PHPRenderer object at 0x86db16c> failed (Running (php -sn) failed: 127, sh: php: not found .) Traceback (most recent call last):   File "/usr/lib/python2.5/site-packages/Trac-0.11.4-py2.5.egg/trac/mimeview/api.py", line 715, in render     rendered_content, filename, url)   File "/usr/lib/python2.5/site-packages/Trac-0.11.4-py2.5.egg/trac/mimeview/php.py", line 93, in render     raise Exception(msg) Exception: Running (php -sn) failed: 127, sh: php: not found .

ให้ลง php5-cli ไปก็เปิดได้เรียบร้อย

$ sudo apt-get install php5-cli

Plugin

• ProgressMeter http://trac-hacks.org/wiki/ProgressMeterMacro

Reference

• http://trac.edgewall.org/wiki/TracInstall
• http://trac.edgewall.org/wiki/TracEnvironment
• http://trac.edgewall.org/wiki/TracFaq

จาก WikiBall

เนื้อหา 1 การติดตั้ง 2 การสร้าง project enviroment 3 การทำ Authentication 3.1 การสร้างแบบ .htpasswd 3.2 การสร้างแบบ .htdigest 4 การรัน Service ของ trac 4.1 การรันโดยใช้ Basic Authentiction 4.2 การรันโดยใช้ Digest Authentiction 4.3 การรันแบบ Multiple Project 4.4 Service tracd 5 การทำ NGINX + TRAC 6 การสร้าง Repository 7 Troubleshooting 7.1 โหลดโปรเจคไม่ขึ้น 7.2 admin tab ไม่ขึ้น 7.3 login ไม่ได้ 7.4 repository & SVN error 7.5 HTML preview not available 8 Plugin 9 Reference

การติดตั้ง

ขั้นแรกติดตั้ง apache, sqlite

ต่อไป download source จาก<a href=”http://”> http://trac.edgewall.org/wiki/TracDownload</a>
ระเบิด(Extract) มันออกมา (ถ้าเป็น tar.gz)

$ tar -xzf trac.tar.gz

เข้าไปยัง source ที่ระเบิดได้
ถ้ายังไม่มี python ก็ในลง python ก่อน แต่ Ubuntu ตัวใหม่ๆ จะมีมาให้อยู่แล้วแต่ยังไม่มี setuptools ตังนั้น ใช้คำสั่งนี้ลงได้ทีเดียวเลยครับ

$ sudo apt-get install python-setuptools

ต่อไป compile เลย

$ sudo python ./setup.py install

ดูเพิ่มเติมได้ที่ > การติดตั้ง Trac

การสร้าง project enviroment

รันคำสั่ง

$ trac-admin /path/to/myproject initenv

ดู option ต่างๆ ได้ที่ การใช้ [initenv]

การทำ Authentication

trac นั้นจะใช้การ Authentication ผ่าน apache จะง่ายกว่ามากครับ
โดยในที่นี้จะกล่าวถึงเฉพาะ tracd หรือ Trac แบบ standalone เท่านั้นโดยมีวิธีทำดังนี้

การสร้างแบบ .htpasswd

htpasswd -c /path/to/env/.htpasswd username

เพิ่ม user ที่ต้องการ

sudo htpasswd /path/to/env/.htpasswd username2

รัน tracd โดยใช้ option – -basic-auth

การสร้างแบบ .htdigest

htdigest -c /path/to/env/.htpasswd realm username

เพิ่ม user ที่ต้องการ

htdigest /path/to/env/.htpasswd realm username

รัน tracd โดยใช้ option – -auth

การรัน Service ของ trac

การรัน Service ของ trac นั้นจะแบ่งเป็น 2 ลักษณะคือ

1. Standalone : รันบน tracd พอร์ต(port) 8000 ซึ่งสามารถวิ่งใช้บน localhost ได้สบายๆ
   standalone
2. WebService : รันบน TracCgi หรือ TracModPython

การรันโดยใช้ Basic Authentiction

tracd -p 8080 --basic-auth=environmentname,/fullpath/environmentname/.htpasswd,/fullpath/environmentname /fullpath/environmentname

การรันโดยใช้ Digest Authentiction

$ tracd -p port --auth=base_project_dir,password_file_path,realm project_path

• base_project_dir คือ directory หลักของ project (ตัวเล็กใหญ่มีผล)
• password_file_path คือ path ที่อยู่ของไฟล์รหัสผ่าน
• realm คือ ชื่อที่อยู่ของโปรเจค (URL)
• project_path คือ ที่อยู่ของ project

การรันแบบ Multiple Project

$ tracd -p 8080 \
   --auth=project1,/path/to/users.htdigest,mycompany.com /path/to/project1

$ tracd -p 8080 \
   --auth=project1,/path/to/users.htdigest,mycompany.com \
   --auth=project2,/path/to/users.htdigest,mycompany.com \
   /path/to/project1 /path/to/project2

$ tracd -p 8080 \
   --auth="*",/path/to/users.htdigest,mycompany.com \
   /path/to/project1 /path/to/project2

ระวังห้ามใส่ตัวใหญ่

Service tracd

ใส่ script ดังนี้ใน /etc/init.d/tracd

#! /bin/sh
#
# tracd		Trac standalone server daemon
#
# Author:	cocoaberry
#

set -e

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DESC="Trac standalone server"
NAME=tracd
DAEMON=/usr/bin/$NAME
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME

# Gracefully exit if the package has been removed.
test -x $DAEMON || exit 0

# defaults for tracd
TRACD_PORT=8080
TRACD_BIND_ADDRESS=0.0.0.0
TRACD_EXTRA_OPTS=

# Read config file if it is present.
if [ -r /etc/default/$NAME ]
then
	. /etc/default/$NAME
fi

#
#	Function that starts the daemon/service.
#
d_start() {
	start-stop-daemon --start --background --make-pidfile --quiet \
		--pidfile $PIDFILE --chuid $TRACD_USER \
		--exec $DAEMON -- $TRACD_EXTRA_OPTS --port $TRACD_PORT --hostname $TRACD_BIND_ADDRESS $TRACD_ENVIRONMENTS
}

#
#	Function that stops the daemon/service.
#
d_stop() {
	start-stop-daemon --stop --quiet --oknodo --pidfile $PIDFILE \
		--name $NAME
}

case "$1" in
  start)
	echo -n "Starting $DESC: $NAME"
	d_start
	echo "."
	;;
  stop)
	echo -n "Stopping $DESC: $NAME"
	d_stop
	echo "."
	;;
  restart|force-reload)
	#
	#	If the "reload" option is implemented, move the "force-reload"
	#	option to the "reload" entry above. If not, "force-reload" is
	#	just the same as "restart".
	#
	echo -n "Restarting $DESC: $NAME"
	d_stop
	sleep 1
	d_start
	echo "."
	;;
  *)
	echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2
	exit 1
	;;
esac

exit 0

โดยตั้งค่าไหม่ดังตัวอย่าง

TRACD_USER=tracd
 # The environments that tracd manages. If more than one, separate
 # with spaces
TRACD_ENVIRONMENTS=/home/tracd/trac-env
 # Extra options to tracd
TRACD_EXTRA_OPTS="--auth *,/home/tracd/trac.htdigest,TracRealm"

ref : http://codesnippets.joyent.com/tag/tracd

การทำ NGINX + TRAC

แต่ในที่นี้จะกล่าวถึงการใช้ Standalone บนโดยใช้ nginx มาวิ่งเป็น webservice แบบ proxy
ต่อไป ทำการสร้าง project environment

$ trac-admin /path/to/myproject initenv

รันแบบ standalone ได้เลย

tracd --port 8000 /path/to/myproject

จากนั้นไป set ใน nginx ให้ ทำ proxy มาที่ service ที่เราใส่ไว้

    server {
        listen       80;
        server_name  trac.xxxxxxxxxx.com;

        # proxy the PHP scripts to Apache listening on 127.0.0.1:80
        #

        location /OC/report {
            root /var/trac/test/htdocs;
            autoindex on;
        }

        location / {
            proxy_pass   http://127.0.0.1:8001;
        }

        location ~* ^.+.(jpg|jpeg|gif|png|ico|css|zip|tgz|gz|rar|bz2|doc|xls|exe|pdf|ppt|txt|tar|mid|midi|wav|bmp|rtf|js)$ {
            proxy_pass   http://127.0.0.1:8001;

            #root /var/trac/test/htdocs;
        }

        location /munin/ {
            root /var/trac/test/htdocs;
        }
    }

ดูเพิ่มเติมได้ที่ : การตั้งค่าสำหรับ_nginx_(Nginx_configuration)

การสร้าง Repository

เนื่องจาก trac เองเป็นแค่หน้ากากครอบตัว svn อยู่เท่านั้น ดังนั้นเราจึงต้องสร้าง repository ผ่านท่าง subversion เท่านั้น

Troubleshooting

โหลดโปรเจคไม่ขึ้น

เกิด error ดังต่อไปนี้

Traceback (most recent call last):
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/web/api.py", line 367, in send_error
    'text/html')
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/web/chrome.py", line 688, in render_template
    data = self.populate_data(req, data)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/web/chrome.py", line 596, in populate_data
    d['chrome'].update(req.chrome)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/web/api.py", line 194, in __getattr__
    value = self.callbacks[name](self)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/web/chrome.py", line 464, in prepare_request
    for category, name, text in contributor.get_navigation_items(req):
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/ticket/web_ui.py", line 162, in get_navigation_items
    if 'TICKET_CREATE' in req.perm:
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 523, in has_permission
    return self._has_permission(action, resource)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 537, in _has_permission
    check_permission(action, perm.username, resource, perm)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 424, in check_permission
    perm)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 282, in check_permission
    get_user_permissions(username)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 357, in get_user_permissions
    for perm in self.store.get_user_permissions(username):
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/perm.py", line 173, in get_user_permissions
    db = self.env.get_db_cnx()
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/env.py", line 264, in get_db_cnx
    return DatabaseManager(self).get_connection()
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/db/api.py", line 76, in get_connection
    return self._cnx_pool.get_cnx(self.timeout or None)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/db/pool.py", line 174, in get_cnx
    return _backend.get_cnx(self._connector, self._kwargs, timeout)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/db/pool.py", line 107, in get_cnx
    cnx = connector.get_connection(**kwargs)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/db/sqlite_backend.py", line 126, in get_connection
    return SQLiteConnection(path, params)
  File "/usr/lib/python2.5/site-packages/Trac-0.11.2.1-py2.5.egg/trac/db/sqlite_backend.py", line 159, in __init__
    raise TracError('Database "%s" not found.' % path)
TracError: Database "/var/trac/test/test.db" not found.

สาเหตุ

• เกิดจากการสร้าง environment ของโปรเจคนั้นๆ ไม่สมบูรณ์ ให้สร้าง environment ใหม่ โดยให้ขึ้น complete ด้วย ซึ่งในบางครั้งมีไฟล์ใหม่ใน path แต่ก็ยังไม่สมบูรณ์ สังเกตได้จากการรายงานของ trac-admin ตอนส้าง
• ไม่สามารถเปิดไฟล์ DB ของ Sqlite ได้ เนื่องจากติด permission ของ OS

admin tab ไม่ขึ้น

ยังไม่ได้ Authen

login ไม่ได้

ในกรณีนี้จะเกิด error ที่หน้า login เพราะ ไม่ได้ run แบบ authentication หรือ file authentication เกิดการผิดพลาด สังเกตดูว่ามีข้อผิดพลาด(warning)ขณะรัน tracd หรือไม่ ถ้าไม่ ลองดูกรณีของชื่อโปรเจคหรือไม่(ต้องใส่ตัวเล็ก)

ในกรณีทีทำทุกอย่างถูกต้องแล้วแต่ยังไม่สามารถทำ authentication ได้นั้น อาจเป้นเพราะ เมื่อรัน tracd ในส่วน –suthen=project นั้นให้ใส่ path ของเราที่เหมือนกัน URL ใน browser ของเรา เช่น โปรเจค DEMO ซึ่งในหน้า Browser ของเราปรากฎเป็น xxx.xxxxx.com/env/ ก็ใช้ใส่เป็น –authen=env
http://trac.edgewall.org/wiki/TracSubversion#unsupported-vcs

repository & SVN error

Warning: Can't synchronize with the repository (Unsupported version control system "svn": "No module named svn" ). Look in the Trac log for more information.

Trac Error

Unsupported version control system "svn": "No module named svn"

ลองทดสอบดูว่า subversion module ของ python ได้ถูกติดตั้งไว้หรือไม่

http://trac.edgewall.org/wiki/TracSubversion#unsupported-vcs

ถ้าขึ้นข้อความมาแสดงว่ายังไม่ได้ลง ใช้ติดตั้งดังนี้

$ apt-get install python-subversion

HTML preview not available

HTML preview not available, since no preview renderer could handle it. Try downloading the file instead. 

ถ้าไปเปิดใน log ดูจะเห็นว่า

WARNING: HTML preview using <trac.mimeview.php.PHPRenderer object at 0x86db16c> failed (Running (php -sn) failed: 127, sh: php: not found .) Traceback (most recent call last):   File "/usr/lib/python2.5/site-packages/Trac-0.11.4-py2.5.egg/trac/mimeview/api.py", line 715, in render     rendered_content, filename, url)   File "/usr/lib/python2.5/site-packages/Trac-0.11.4-py2.5.egg/trac/mimeview/php.py", line 93, in render     raise Exception(msg) Exception: Running (php -sn) failed: 127, sh: php: not found .

ให้ลง php5-cli ไปก็เปิดได้เรียบร้อย

$ sudo apt-get install php5-cli

Plugin

• ProgressMeter http://trac-hacks.org/wiki/ProgressMeterMacro

Reference

• http://trac.edgewall.org/wiki/TracInstall
• http://trac.edgewall.org/wiki/TracEnvironment
• http://trac.edgewall.org/wiki/TracFaq