Extremely Agile

Trac 설치

Trac 설치는 간단. sudo apt-get install trac

이렇게 설치하면 0.10 버전이 깔리므로 직접 설치하고 싶은 분들은...

svn co http://svn.edgewall.org/repos/trac/branches/0.11-stable 0.11dev
cd 0.11dev/
python setup.py install

위와 같이 해도 된다. 다만 주의할 것은... 이렇게 인스톨하면 egg cache를 Trac 프로젝트 디렉터리 (이 글의 경우에는 /home/bjlee/work/trac/pe) 아래에 .egg-cache라는 이름으로 만들어주어야 한다는 것. 권한은 777로 주면 된다.

trac을 설치한 다음에는 실행해주어야 할 명령들이 있는데 필자의 경우에는 대략 다음과 같았다. (붉은색으로 표시된 부분은 여러분들이 알아서 정해야 하는 부분.)

trac-admin /home/bjlee/work/trac/pe initenv

기존에 trac을 깔았는데 업그레이드 하신 분들은 다음과 같이.

trac-admin /home/bjlee/work/trac/pe upgrade

제대로 설치가 되었는지 확인해보려면 다음과 같이 해 보면 된다.

tracd --port 8000 /home/bjlee/work/trac/pe

그리고 나서 웹 브라우저를 띄워 접속해서 화면이 정상적으로 나오면 trac 설치는 제대로 된 것이다. tracd는 경량의 httpd 서버로, 엔간한 작업은 이것으로 할 수 있다. 하지만 mod_python등을 설치해서 뭔가 다른 작업을 하려면 한계가 있으므로, apache2를 설치한다. tracd는 ctrl+C로 종료시킬 수 있다.


Apache2 설치

Apache2 설치는 조금 복잡. 다음의 패키지들을 순서대로 설치한다.

sudo apt-get install apache2
sudo apt-get install apache2-threaded-dev
sudo apt-get install libapache2-mod-python
sudo apt-get install python-dev

그런 다음 mod_python 설치. 필자는 다음 명령을 순서대로 실행하여 설치하였다.

wget http://apache.cdnetworks.co.kr/httpd/modpython/mod_python-3.3.1.tgz
tar zxvf mod_python-3.3.1.tgz
cd mod_python-3.3.1
./configure
make
sudo make install

그런 다음 cd /etc/apache2/conf.d 하여 다음과 같이 두 파일(mod_python, trac)을 만들어 준다.

mod_python:
LoadModule python_module /usr/lib/apache2/modules/mod_python.so

trac:
<Location /pe>
    SetHandler mod_python
    PythonInterpreter main_interpreter
    PythonHandler trac.web.modpython_frontend
    PythonOption TracEnv /home/bjlee/work/trac/pe
    SetEnv PYTHON_EGG_CACHE /usr/share/apache2/python_egg_cache
    PythonOption TracLocal "en_US.utf8"
</Location>

<Location /pe/login>
    AuthType Basic
    AuthName "pe"
    AuthUserFile /home/bjlee/work/trac/pe/trac.htpasswd
    Require valid-user
</Location>

위의 설정 파일을 보면 PYTHON_EGG_CACHE라는 환경변수를 정의하는 부분을 볼 수 있다. 나중에 Trac Plugin을 설치할 때 필요한 부분이다. 저 곳 말고 다른 곳으로 지정할 수도 있는데, 편한 곳으로 하면 된다. 단, 해당 디렉터리의 권한은 chmod 777로 설정해 주어야 한다는 점이 귀찮은 점. 단, 0.11대의 최신 버전의 trac을 설치한 경우에는 이 줄은 둘 필요가 없고, 생략하면 된다.

그 아래 줄에 보면 locale을 지정한 부분이 있는데, 그 줄은 날짜 형식 관련해서 trac 시스템이 오동작할 때 (무슨 말인지는 겪어보면 안다 ㅋㅋ) 해결해주기 위한 부분이다. 웹을 찾아보면 한글 로케일인 ko_KR.utf8을 시도해보라는 글이 있는데, 필자의 경우에는 그렇게 해도 해결이 되질 않아서 저렇게 해 두었다. 다행히 지금은 문제없이 동작한다.

또한 위의 설정 파일을 보면 trac.htpasswd라는 파일을 참조하는 부분을 볼 수 있다. trac 사용자와 그 패스워드를 설정하는 부분이다. 다음과 같이 하여 이 파일을 생성한다.

$ htpasswd -c /home/bjlee/work/trac/pe/trac.htpasswd bjlee
New password: <type password>
Re-type new password: <type password again>
Adding password for user bjlee

다른 사용자의 설정을 추가하려면 위의 과정을 계속 반복하면 된다. 두번째 부터는 -c 플래그를 둘 필요는 없다.

이렇게 해서 만들어진 사용자의 권한 설정은 다음과 같이 하면 된다.

trac-admin /home/bjlee/work/trac/pe permission add bjlee TRAC_ADMIN

TRAC_ADMIN 이외의 다른 권한을 주려면 http://<서버주소>/pe/wiki/TracPermissions에 접속하여 가능한 권한을 살펴보면 된다. trac이 깔리면 기본적으로 wiki 문서들이 같이 깔리므로, 브라우저로 문서들을 살펴볼 수 있다. 아. 브라우저로 보려면 아파치 웹 서버를 띄워줘야 한다. 다음과 같이 띄운다.

sudo apache2ctl start

이제 Trac 플러그인 설치를 위한 준비작업이 필요하다. (플러그인 설치는 반드시 해야할 사항은 아님) 이에 관해서는 http://<Trac 서버 주소>/pe/wiki/TracPlugins를 참고하면 된다. 하지만 간단히 요약해보면,

wget http://peak.telecommunity.com/dist/ez_setup.py
sudo python ez_setup.py

위의 과정을 순서대로 수행하면, egg 기반의 Trac 플러그인을 설치하기 위한 준비작업은 완료된다. 어떤 플러그인을 내려받아 설치할 것인지는 알아서 정하도록 하자.