Задача

Установить на только что инсталлированный Ubuntu последнюю версию Trac, создать репозитории для нескольких проектов и настроить окружение соответственно. Структура проектов должна быть полностью корректной, установка максимально быстрой при минимальном количестве пакетов. Авторизация в репозитории и окружения Trac может быть общей, но позволяющей индивидуальную настройку для каждого проекта. Также, установка должна быть максимально независима от версий.

Дано

• Ubuntu 7.04 Feisty Fawn Herd
• Trac 0.11b2
• Subversion 1.4.3
• Два пользователя: user1 и user2
• Два проекта: Some Project и Another Project
• Требуется доступ в Trac и репозиторий по адресам <host>/localProjects и <host>/svn соотвественно

Решение. Пункт 1. Установка базовых дистрибутивов, доступных в пакетах.

Для начала можно установить дистрибутивы, доступные в репозиториях Ubuntu в поддерживаемых версиях – на данный момент это Apache 2.2.3, Python 2.5.1 (необходим для работы trac), Subversion 1.4.3 и g++ 4.1.2 (необходим для сборки sqlite). Установим, предварительно обновив данные о пакетах:

sudo apt-get update
sudo apt-get install python
sudo apt-get install apache2
sudo apt-get install subversion
sudo apt-get install g++

Решение. Пункт 2. Установка sqlite.

Теперь необходимо собрать sqlite (легковесная база данных, в котрой будут хранится внутренние данные trac) — версия, находящая в репозитории (3.3.13) на данный момент меньше требуемой (3.3.4). Создадим каталог для временного хранения дистрибутивов и перейдём в него:

mkdir ~/distr
cd ~/distr

Скачаем последнюю версию sqlite и установим:

wget http://www.sqlite.org/sqlite-3.5.6.tar.gz
tar xvfz ./sqlite-3.5.6.tar.gz
mv ./sqlite-3.5.6 ./sqlite # чтобы следовать букве README-руководства
mkdir ./bld # временный каталог для скомилированных файлов
cd ./bld
../sqlite/configure
make
sudo make install
cd ..
rm -r ./bld

Решение. Пункт 3. Установка trac-related пакетов через easy_install.

Для Python существует утилита, облегчающая установку python-пакетов, называемых также яйцами (они имеют расширение *.egg). Установим её:

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

И засчёт неё установим последние версии Pygments (0.9) (инструмент для подсветки программного кода на Python), Genshi (0.4.4) (механизм шаблонов от создателей trac) и собственно самого trac (0.11b2):

sudo easy_install Pygments
sudo easy_install Genshi
sudo easy_install Trac

Решение. Пункт 4. Создание репозиториев.

Создадим репозитории для наших проектов и сделаем первые коммиты, содержащие отправные точки для их структур. Все репозитории будут находиться в каталоге /var/svn, полностью доступном для сервера, каждый в своём подкаталоге — такой метод удобен при наличии нескольких проектов и это будет заметно в следующем пункте, на этапе настройки авторизации.

sudo mkdir /var/svn
sudo mkdir /var/svn/someProject
sudo mkdir /var/svn/anotherProject
cd /tmp
sudo rm -rfR * # удалить все обычные файлы
sudo rm -rfR .* # удалить все скрытые/системные файлы
mkdir /tmp/someProject
mkdir /tmp/someProject/trunk
mkdir /tmp/someProject/tags
mkdir /tmp/someProject/branches
mkdir /tmp/anotherProject
mkdir /tmp/anotherProject/trunk
mkdir /tmp/anotherProject/tags
mkdir /tmp/anotherProject/branches
sudo svnadmin create /var/svn/someProject
sudo svn import ./someProject file:///var/svn/someProject
    -m "Initial import"
sudo svnadmin create /var/svn/anotherProject
sudo svn import ./anotherProject file:///var/svn/anotherProject
    -m "Initinal import"
sudo chown -R www-data:www-data /var/svn

Решение. Пункт 5. Связывание apache и subversion.

Необходимо настроить доступ извне для созданных репозиториев. Для этого нужно установить модуль dav_svn для apache2 и заодно, раз мы работаем с subversion, установим связку subversion c Python, для корректной работы trac с репозиториями:

sudo apt-get install libapache2-svn
sudo apt-get install python-subversion

Теперь нужно настроить установленный модуль (при установки он автоматически включается для apache, если нет — используйте a2enmod dav_svn по завершению настройки):

sudo vi /etc/apache2/mods-available/dav_svn.conf

Ниже приведено точное содержимое конфигурационного файла. При обращении на путь <host>/svn/... модуль авторизации apache будет обращаться к файлу /etc/apache2/dav_svn.passwd за списком пользователей, а затем давать права на доступ к соответствующему проекту из файла /etc/apache2/dav_svn.authz. Обратите также внимание на использование SVNParentPath вместо SVNPath — таким образом subversion-модуль поймёт, что мы используем мультипроектную структуру и будет обрабатывать путь не как один общий репозиторий, а как несколько внутренних:

<Location /svn>
    DAV svn
    SVNParentPath /var/svn
    AuthType Basic
    AuthName "Subversion Repository"
    AuthUserFile /etc/apache2/dav_svn.passwd
    AuthzSVNAccessFile /etc/apache2/dav_svn.authz
    Require valid-user
</Location>

Создадим соответствующих пользователей в файлах авторизации. Используйте пароли попроще для проверки и не забудьте их потом поменять:

sudo htpasswd -c /etc/apache2/dav_svn.passwd user1
sudo htpasswd /etc/apache2/dav_svn.passwd user2

Создадим файл аутентификации:

sudo vi /etc/apache2/dav_svn.authz

В открытым файле опишем права доступа (на чтение — «r» и на запись — «w«) пользователей в соответствующие репозитории:

[/]
user1=r
user2=r

[/someProject]
user1=rw
user2=r

[/anotherProject]
user1=r
user2=rw

Решение. Пункт 6. Создание окружений trac.

Создадим каталог, в котором будут находиться окружения для соответствующих проектов.

sudo mkdir /var/trac
cd /var/trac

Теперь создадим для каждого из них, по очереди, окружение:

sudo trac-admin someProject initenv
sudo trac-admin anotherProject initenv

Имена проектов остаются на ваше усмотрение, тип репозиториев — по умолчанию svn (просто нажать Enter), путь к базе общий, по умолчанию (sqlite:db/trac.db, аналогично), пути к репозиториям: /var/svn/someProject и /var/svn/anotherProject соответственно.

Дадим права apache пользоваться этим каталогом.

sudo chown -R www-data:www-data /var/trac

Решение. Пункт 7. Связывание apache и trac.

Есть несколько вариантов такого связывания, мы остановимся на быстром, но надёжном способе — через mod_python (описания способов на сайте trac). Для этого модуль нужно установить (также, если он не включился после установки, по завершению настройки используйте a2enmod mod_python):

sudo apt-get install libapache2-mod-python

Настроим доступ к окружениям trac:

sudo vim /etc/apache2/sites-available/trac

Эта настройка специфична для использования mod_python (руководство на сайте trac, см. описания, если необходимы другие способы настройки). Обработчиком обращений по адресу <host>/localProjects выступит модуль, он будет рассматривать каталог /var/trac/ как корень нескольких проектов и содаст страницу с их списком (редактируемый шаблон можно найти внутри исходников trac), аналогично принципам SVNParentPath, URI передаётся в код trac. Запросы на вход будут обрабатываться по пользователям из того же passwd файла, из которого берёт их список читает subversion, а их права на действия в окружениях trac раздаются через trac-admin или в GUI-версии TracAdmin, доступной для аминистраторов окружений (будьте внимательны, пользователи создаваемые через интерфейс также добавляются в этот файл и доступны к использованию для настройки авторизации в subversion через authz-файл (по умолчанию у них нет никаких прав)) .

<Location /localProjects>
   SetHandler mod_python
   PythonInterpreter main_interpreter
   PythonHandler trac.web.modpython_frontend
   PythonOption TracEnvParentDir /var/trac
   PythonOption TracUriRoot /localProjects
</Location>

<LocationMatch /localProjects/[^/]+/login>
   AuthType Basic
   AuthName "Local Projects"
   AuthUserFile /etc/apache2/dav_svn.passwd
   Require valid-user
</LocationMatch>

Теперь заменим сайт по умолчанию для apache на сайт trac:

sudo a2dissite default
sudo a2ensite trac

Дадим пользователям права администратов в окружениях trac, в соотвествии с правами на репозиторий, теперь у них, у каждого в своём проекте, будет веб-интерфейс для полной настройки trac.

sudo trac-admin someProject permission add user1 TRAC_ADMIN
sudo trac-admin anotherProject permission add user2 TRAC_ADMIN

Решение. Заключение.

Осталось перезагрузить сервер, (принудительная перезагрузка настроек: force-reload) и проверить адреса <host>/localProjects и <host>/svn/someProject и <host>/svn/anotherProject, попробовав авторизироваться разными пользователями.

sudo /etc/init.d/apache2 restart

Если при установке появились какие-либо проблемы и ничего не помогает, попробуйте ознакомиться с предыдущей статьёй (но она несколько более сумбурна и менее структурирована) или опишите проблему(-мы) в комментариях — постараюсь реагировать быстро.

Примечание A. О добавлении проектов.

Добавление проектов в будущем требует лишь нескольких шагов — создание базовой структуры первым коммитом в какой-либо подкаталог /var/svn, опциональное добавление новых пользователей в htpasswd-файл, настройка прав доступа в authz-файле, создание окружения trac в соответствующем подкталоге /var/trac через trac initenv, опциональная выдача trac-прав новым пользователям и проверка, что apache имеет доступ к созданным каталогам.

Eric – очень даже хорошее IDE под Python. и не далее как вчера вышла версия 4.0.1, в репозиториях же на данный момент лежит версия 3.9. и захотелось мне вспомнить старые добрые времена и собрать этот пакет. Представляю вам на всякий случай листинг того, что делать – чтобы не возвращаться обратно, выясняя что нужно поставить еще что-то или разбираясь в ошибках компиляции, которые меня посещали :). Кое-где – ориентировка на последние версии :). Так как устанавливалось на чистой практически убунте – все должно быть адекватно… если что-то упустил – прошу сообщать.

Используется:

• eric 4.0.0.1
• Python 2.5.1
• Qt 4.2.3 + PyQt v4.1 + QScintilla 2
• SIP 4.6
• G++ 3.4 (наверняка можно взять и поздний)

итак, переходим в какой-нибудь каталог для сборки и приступаем:

$ cd ~/distr-temp/

берем сурсы с sourceforge‘a:

$ wget http://mesh.dl.sourceforge.net/sourceforge/eric-ide/eric4-4.0.1.tar.gz

устанавливаем всяческие библиотеки для связки PyQt (в зависимости от настроек apt-get‘а может понадобиться установочный CD):

$ sudo apt-get install python2.5-dev
$ sudo apt-get install python-qt4
$ sudo apt-get install libqt4-dev
$ sudo apt-get install python-qt4-dev

устанавливаем компилятор g++ и делаем на него ссылку /usr/bin/g++:

$ sudo apt-get install g++-3.4
$ sudo ln -s /usr/bin/g++-3.4 /usr/bin/g++

скачиваем и устанавливаем последнюю на данный момент версию SIP – он позволяет библиотекам, написанным на C[++] вести себя как модули Python:

$ wget http://www.riverbankcomputing.com/Downloads/sip4/sip-4.6.tar.gz
$ tar -xvzf ./sip-4.6.tar.gz
$ cd ./sip-4.6.tar.gz
$ python ./configure.py
$ make
$ sudo make install
$ cd ..

скачиваем и устанавливаем последнюю на данный момент версию QScintilla – Qt-порт компонента для редактирования исходных кодов (устанавливаем версию для Qt4):

$ wget http://www.riverbankcomputing.com/Downloads/
Snapshots/QScintilla2/QScintilla-gpl-2-snapshot-20070709.tar.gz
$ tar -xvzf ./QScintilla-gpl-2-snapshot-20070709.tar.gz
$ cd ./QScintilla-gpl-2-snapshot-20070709/Qt4
$ qmake qscintilla.pro
$ sudo make
$ sudo make install

теперь нужно установить связи на QScintilla для Python – они находятся собственно в директории Python:

$ cd ../Python
$ python ./configure.py
$ make
$ sudo make install

ну а теперь очередь собственно eric:

$ cd ../../eric4-4.0.1/
$ sudo python install.py

при установке нужно сказать ему директорию где лежит Qt: /usr/share/qt4.

Ну вот собственно и все. Набираем eric4 и, если хочется, радуемся :).

Вот она, первая статья о невечном :)

На самом деле статей в сети на эту тему много (ну либо они повествуют о настройке для веб-плюса – она схожа) – но результаты у всех разные – поэтому расскажу свою историю.

подопытные:
Ubuntu 7.40 Feisty Fawn
USB-модем D-Link DSL-200 Generation III

дополнительные ссылки:
Как Starl1te настраивал Веб-плюс
Беседа с человеком у которого однажды это всё-таки получилось
Основной источник файлов
Как это делают в Gentoo

Итак, Live/Install CD был скачан из интернета, прожжен на болванку и установлен буквально за 10-15 минут, чем Ubuntu и славится. практически все что нужно обнаружилось и отдетектилось сразу, за исключением собственно интернета :). сразу говорю, четких рекомендаций как не было так и нет, насколько я понял у большинства все “как-то вышло” и вполне может быть так, что мой или чей-то способ может не подойти. у меня, например, интернет пока что подключается раза с пятого, но хотя бы уже до отключения руками, поэтому я стараюсь не перезагружаться :). если я найду способы улучшения ситуации – я напишу.

Впрочем, меньше прелюдий – беремся за терминал. Вернее, лучше заранее достать где-нибудь интернет и скачать вот эту пару файлов: :).

ECI-ADSL с патчем синхронизации
утилита PPPoE (или тут)
файлы синхронизации

С этого момента мы считаем что вы находитесь в той директории, куда вы положили эти файлы, например ~/Downloads:

$ cd ~/Downloads

Одно магическое действие, которое вам скорее всего понадобится для корректной работы eciadsl – смена среды. Честно говоря я не успел посмотреть что там было до этого, потому что в bash я не сомневаюсь(лся?), но вероятнее всего на то, как было, если вам будет надо – можно будет запросто вернуть командой sudo ln -sf /bin/dash /bin/sh:

$ sudo ln sf /bin/bash /bin/sh

устанавливаем пакеты:

$ sudo dpkg -i ./pppoe_3.8-1.1_i386.deb
$ sudo dpkg -i ./eciadsl-usermode_0.11-1_i386_with_sync_patch.deb

распаковываем дополнительные файлы синхронизации и переносим их в каталог eciadsl:

$ bzip2 -d ./eciadsl-synch_bin.tar.bz2
$ tar -xvf ./eciadsl-synch_bin.tar
$ sudo mv ./eciadsl-synch_bin/*.bin /etc/eciadsl/
$ rm -Rf ./eciadsl-synch_bin

далее, нужно проверить выгружен ли модуль dabusb, который по идее и не должен быть загружен – в ранних версиях он приводил к ошибкам.

$ sudo lsmod | grep dabusb

и если он все-таки найдется – надо его убить, вот так: :)

$ sudo modprobe -r dabsusb

теперь включаем нужные модули:

$ sudo modprobe tun
$ sudo lsmod | grep tun
$ sudo modprobe n_hdlc
$ sudo lsmod | grep n_hdlc

сейчас нам нужно узнать VID/PID нашего момеда (насколько я себе представил – это код USB-порта на материнской плате, но истринным знанием я временно не обладаю).

$ lsusb

там должно быть либо D-Link либо GlobeSpan, либо какой-то еще вариант (если что можно выяснить отключив модем, выполнив lsusb и подключив снова) – у меня мой модем был в этой строчке:

Bus 004 Device 006: ID 0915:8104 GlobeSpan, Inc.

выделенные курсивом числа – и есть VID:PID – запомните их. Настало время приступить к конфигурации. можно запустить текстовую версию и следовать указаниям (пояснения ниже):

$ sudo eciadsl-config-text

для Авангард-ADSL настройки (примерно :) ) таковы (номера пунктов могут отличаться):

• (1) configure all settings
• юзернейм/пароль: ptn/ptn
• provider: (58) Other
• DNS1: 213.158.0.6
• DNS2: 213.48.193.36 (на июль 2007 они таковы, в будущем могут потенциально поменяться – следите за новостями Авангарда)
• VPI: 0
• VCI: 35
• modem: (16) D-Link DSL200 B1 (засисит от модели вашего модема, но у меня кажется не B и работает и я побаиваюсь пока все нестабильно но работает тестировать другие варианты :) )
• VID1: 0915 (первое число из двух, которые показала команда lsusb)
• PID1: 8104 (второе число из двух, которые показала команда lsusb)
• VID2: 0915 (первое число из двух, которые показала команда lsusb)
• PID2: 8104 (второе число из двух, которые показала команда lsusb)
• chipset: (3) GS7470
• SYNCH: 0 (этот пункт и следующий пункты люди часто ставят наугад, я тоже пишу как работает у меня и не знаю почему я это ставил :) )
• PPPOECI: 4
• .bin file: (18) /etc/eciadsl/gs7470_synch20.bin (очень важный пункт, на сайте Авангарда пишут использовать именно этот файл , но если у вас все еще будут проблемы с синхронизацией – нужно будет перебрать все по одному а в самом худшем случае – собирать свой)
• PPP Mode: (5) LLC_SNAP_RFC1483_BRIDGED_ETH_NO_FCS (еще используют LLC_RFC1483_ROUTED_IP)
• DHCP: no
• Static IP: no (по дефолту у Авангарда динамический IP, но если у вас статический за денюжку то наверное стоит поставить yes :) )

ниже я приведу сам файл /etc/eciadsl/eciadsl.conf, который и изменяет эта утилита – в том состоянии, в каком он у меня.

далее – запускаем собственно синхронизацию:

$ sudo eciadsl-start

тут могут обнаружиться самые обидные проблемы – если будут ошибки про interruptы – значит вместо первого файла установлена версия без патча синхронизации и вы меня не слушаетесь :). В моем случае тоже не всё гладко – первые разы после удачной синхронизации гаснут обе лампочки на модеме, а среди карт/интерфейсов отстутствует tap0:

$ ifconfig

но раз на пятый-десятый лампочки все-таки не гаснут и тогда хорошо. По этим причинам я поставил скрипт на автозагрузку, но о нем – ниже. Если уж совсем много раз не выходит – что-то не чисто – проверять настройки и файлы синхронизации. Вам нужно добиться чтобы лампочки не гасли :). После этого – набрать:

$ sudo pppoeconf

это собственно конфигурация PPPoE. Утилита должна найти инет на интерфейсе tap0 и задавать диалогами вопросы и просьбы, среди которых попросят ввести пароль/юзернейм снова, а на все остальные – отвечать разумно, чаще всего – “да” :).

после этого можно попытаться подключиться:

$ sudo pppoe-start

и если не TIMED OUT а CONNECT OK то все замечательно :).
желаю чтобы у вас так и было :).

P.S. Статья будет исправляться и дополняться

пояснения:

теперь по поводу гаснущих лампочек. я взял скрипт starl1t‘а, чуток исправил, добавив pppoe-start и выставил его в автозагрузку:

$ sudo nano /etc/init.d/eciadsl

туда – нижеследующий текст:

#!/bin/bash

# This is an improved eciadsl launch script, which
# tries to connect after failures until success.
# Feel free to share and modify
# by Starlite

case "$1" in
	start)
		sudo eciadsl-start
		result=$?
		#echo 'exit code:' $result
		until [ $result -eq 0 ]
		do
			echo 'Error: connection failed'
			sudo eciadsl-stop
			sudo eciadsl-start
			result=$?
		#	echo 'exit code:' $result
		done
		echo 'connection established'
		sudo pppoe-start
		exit $?
		;;
	stop)
		sudo eciadsl-stop
		exit $?
		;;
	restart|force-reload)
		$0 stop && $0 start
		exit $?
		;;
	*)
		echo 'Usage: eciadsl {start|stop|restart}'
		exit 1
		;;
esac
exit 0

потом – ставим его на автозагрузку:

$ sudo chmod +x /etc/init.d/eciadsl
$ update-rc.d eciadsl defaults

если нужно – можно запускать его самостоятельно:

$ sudo /etc/init.d/eciadsl restart

тексты:

==========================/etc/eciadsl/eciadsl.conf

VID1=0915
PID1=8104
VID2=0915
PID2=8104
#MODE=LLC_RFC1483_ROUTED_IP
MODE=LLC_SNAP_RFC1483_BRIDGED_ETH_NO_FCS
VCI=35
VPI=0
FIRMWARE=/etc/eciadsl/firmware00.bin
SYNCH=/etc/eciadsl/gs7470_synch20.bin
PPPD_USER=ptn
PPPD_PASSWD=
USE_DHCP=no
USE_STATICIP=no
STATICIP=
GATEWAY=
MODEM=D-Link DSL200 rev B1
MODEM_CHIPSET=GS7470
SYNCH_ALTIFACE=0
PPPOECI_ALTIFACE=1
PROVIDER=Other
DNS1=213.158.0.6
DNS2=213.18.193.36

==========================/etc/ppp/pppoe.conf

ETH='tap0'
USER='ptn'
DEMAND=no
#DEMAND=300
DNSTYPE=SERVER
PEERDNS=yes
DNS1=
DNS2=
DEFAULTROUTE=yes
CONNECT_TIMEOUT=30
CONNECT_POLL=2
ACNAME=
SERVICENAME=
PING="."
CF_BASE=`basename $CONFIG`
PIDFILE="/var/run/$CF_BASE-pppoe.pid"
SYNCHRONOUS=no
#SYNCHRONOUS=yes
CLAMPMSS=1412
#CLAMPMSS=100
#CLAMPMSS=no
LCP_INTERVAL=20
LCP_FAILURE=3
#LCP_FAILURE=30
PPPOE_TIMEOUT=80
FIREWALL=NONE
LINUX_PLUGIN=
PPPOE_EXTRA=""
PPPD_EXTRA="" 

Сегодня ставили Ubuntu 6.06 LTS на SATA-шный винт. Она, как ни странно, злобно свалилась. Live CD долго пытался подмаунтить винт, потом вроде подмаунтил но при загрузке ядра начал кидаться buffer I/O Read Error и бла-бла-бла.

Решение нашлось при совмещении способов с двух форумов:

В BIOS’е на способ работы с SATA я установил Enchanced (что-то там с распараллеливанием SATA/PATA, причем поиграйтесь еще с каналами – если что-то не выйдет; и в крайнем случае, если SATA-винта у вас два, один уберите на время)

Нажал в загрузочном экране Live CD клавишу Escape (переход в текстовый режим) и набрал

boot: live pci ide=nodma ide=reverse

(не учитывая того, что до этого я много разных пытался там набрать команд :) )

Теперб юбунта работает как миленькая… Почти.

Приветствую всех заинтересованных. Ведь вас, наверняка, не очень много :).

Upd.: Более структурированное и последовательное (правда менее повествовательное) руководство для Ubuntu Feisty находится здесь

Ну а я, в свою очередь, славлюсь среди знающих меня извращенными подходами к простым вещам, так что и в этот раз решил не ломать традиций :).

Предыстория статьи такова:

Автор находится на испытательном сроке в некой фирме и по прибытию туда обнаруживает, что единственный коллега кроме начальника пишет Систему Управления Проектами (не путать с блоггерскими захватчиками – СУПом) на PHP сроком на две недели (правда, за эти две недели начальник разумно (имхо) требует лишь на-коленочного-статуса). Автор присматривается к требованиям, удивляется и сообщает начальнику, что есть уже такая система, бесплатная, расширяемая и все-в-одном-что-вам-нужно – Trac – система, которой он с радостью и удовольствием пользовался на прошлой работе. Благо начальник знает что такое SVN, про его замечательную поддержку было упомянуто тоже. Ну и конечно за свои слова пришлось отвечать – за это автору было заказано установить эту хитрую систему (как некоторые пишут, один из самых сложных пакетов для установки).

В свою очередь, в связи с извращенскими посылами автора, он умолчал о непредназначенности для Trac’а такой заботливой-о-пользователе-системы как Ubuntu, да еще и поставил это дело для демонстрации a) на vmWare (что, собственно, сути не меняет) (далее – «твари») с опцией Host-Only и б) на apache2. Это потому что a) другого нового Unix’а у автора под рукой не было, а устанавдивать его основной ОС было делом неперспективным и б) руководства в инете для Trac + Ubuntu почему-то именно про apache2.

Соответственно, действующие лица aka Оперируемые:

Ubuntu 6.06 TLS (руссская, хе-хе :) ), Trac 0.10.3, Subversion 1.4.2 в роли Subversion 1.3.1 (почему – смотрите ниже), Python 2.4.3 (побоялся ставить на 2.5).

P.S. В сетевых вопросах я пока что чайник (а то и ламер), поэтому если ниже или выше по тексту я допустил какие-либо вопиющие ошибки в терминах, понятиях или даже принципах – я заранее полностью готов это признать (гм, тогда точно не ламер :) ) и прошу вас меня поправить – только умоляю – не орите благим матом :).

Более поздний P.S. В скором времени я, вероятно, буду ставить всю эту компанию (более злободневные версии) на Ubuntu 7.04 с Python 2.5, и статья, ввиду опыта нескольких установок, будет чуть пограмотнее…

Система устанавливалась прямиком с LiveCD, без каких-либо хитрых настроек, вот как есть – шесть пунктов установки и ничего больше. Вы, конечно же, можете все сделать хитрее – думаю на процессе это отразится не сильно (в отличие, например, от подстановки другой ОС :) ).

Итак, второй апач и 2.4-ый питон нашлись в русских архивах ubuntu (вернее python уже был установлен, но я немного привру :) ), поэтому здесь все было просто:

sudo apt-get install apache2 python2.4

Upd.: Если вы используете английскую юбунту и апача, например, не нашлось, делаем следующее:

sudo vi /etc/apt/sources.list

Добавляем (Insert):

deb http://ru.archive.ubuntu.com/ubuntu dapper universe main restricted multiverse
deb-src http://ru.archive.ubuntu.com/ubuntu dapper universe

Если нужно, снимаем комменты со строк с http://**.archive.ubuntu.com и делаем:

sudo apt-get update

конец Upd.

На интернациональных (читай англоязычных) порталах (конечно же можно действительно, как подсказал , раскомментить их в /etc/apt/sources.list) мог бы отыскаться и Trac, но в русской ОС его не нашлось, поэтому я решил сделать его установку ручками, благо это лишь пара лишних команд:

Upd.: Здесь и далее все адреса из ссылок «взять» и «забрать» можно использовать как параметры для команды wget <ссылка>, при этом надо находится в каталоге ~/distr – по статье все файлы скачиваются туда.

Надо взять его с официального сайта и положить куда-нибудь, например в папку distr в домашней директории и затем, собственно, инсталлировать (установленных пакетов вам должно хватить и все должно обойтись без зависимостей):

(все-все дистрибутивы я складывал в ~/distr, что и вам советую, дабы не запутаться)

cd /home/some-user/distr
tar xvfz trac-0.10.3.tar.gz
cd ./trac-0.10.3
sudo python ./setup.py install

Далее, создадим каталог, куда будем складывать окружения (aka environments – гм…. проектов?) trac

sudo mkdir /var/trac

Этот каталог должен быть доступен апачу:

sudo chown www-data:www-data /var/trac

Теперь необходимо настроить доступ апача к trac’у:

sudo vi /etc/apache2/sites-available/trac

Содержимое этого файла должно выглядеть так:

<VirtualHost *>
    ServerAdmin webmaster@localhost
    ServerName trac.example.com
    DocumentRoot /usr/share/trac/cgi-bin
    <Directory /usr/share/trac/cgi-bin>
        Options Indexes FollowSymLinks MultiViews ExecCGI
        AllowOverride All
        Order allow,deny
        allow from all
    </Directory>
    Alias /trac "/usr/share/trac/htdocs"

    <Location /trac.cgi>
        SetEnv TRAC_ENV_PARENT_DIR "/var/trac"
    </Location>

    DirectoryIndex trac.cgi
    ErrorLog /var/log/apache2/error.trac.log
    CustomLog /var/log/apache2/access.trac.log combined
</VirtualHost>

Если кратко, мы настраиваем виртуальный хост, устанавливаеваем корневой каталог для cgi-скриптов и документов в /usr/share/trac/cgi-bin/, а адрес http://localhost/trac привязываем к пути /usr/share/trac/htdocs – там лежат всяческие веб-документы. Для доступа к проектам для запросов на http://localhost/trac.cgi устанавливается корневой каталог для окружений trac’а – /var/trac. В принципе,знающему английский все должно быть понятно :).

Теперь следует включить обработку cgi-скриптов:

sudo vi /etc/apache2/apache2.conf

В этом файле раскомментируйте строку ‘AddHandler cgi-script .cgi’.

Переключим apache на сайт trac’а в качестве основного:

sudo a2dissite default
sudo a2ensite trac

(проверьте, является ли теперь /etc/apache2/sites-enabled/trac ссылкой на /etc/apache2/sites-available/trac)

Так что пусть апач перечитает настройки:

sudo /etc/init.d/apache2 reload

Upd.: Теперь можно проверить, все ли в порядке – если в браузере вы набираете http://localhost/trac.cgi/BlahBlah и видите строку «Environment not found» – значит все в порядке. Также http://localhost/trac должен открывать каталог /usr/share/trac/htdocs, а http://localhost/trac.cgi говорить, что нет Clearsilver’a. Не забудьте кстати потом настроить апачевские права доступа, если надо – это выходит за рамки статьи, в отличие от траковских :).

Настало время взяться за установку Subversion. Его тоже не оказалось в apt-cache, поэтому я его забрал последний на тот момент (1.4.2) отсюда и, также, положил в каталог ~/distr, там распаковал, установил необходимые зависимости, собрал и установил, вот так (Upd.: Обратите внимание, пакет называется zlib1g-dev, а не zliblg-dev):

cd /home/some-user/distr/
tar xvfz subversion-1.4.2.tar.gz
sudo apt-get install gcc
sudo apt-get install libtool
sudo apt-get install libapr0-dev
sudo apt-get install zlib1g-dev
sudo apt-get install make
cd ./subversion-1.4.2
./configure
make
sudo make install

Затем установим модуль svn для apache, утановим swig и установим через пакет subversion версию swig для python (текущий каталог – /home/some-user/distr/subversion-1.4.2).

sudo apt-get install libapache2-svn
sudo apt-get install swig
sudo apt-get install python-dev
./configure
sudo make swig-py
sudo make install-swig-py

(Upd.: По возможности не обращайте внимания на warning’и при установке – насчет redefin’ов – на них утсановлена пауза дабы вы с ними ознакомились, но она кончается :))

Установим ссылки на установленные модули так, чтобы они были видны питону.

cd /usr/local/lib/python2.4/site-packages
sudo ln -s /usr/local/lib/svn-python/libsvn
sudo ln -s /usr/local/lib/svn-python/svn

Установим модуль pysqlite, чтобы trac мог работать со своей базой данных.

sudo apt-get install python-pysqlite2

Ввиду новых изменений переустановим trac.

cd /home/some-user/distr/trac-0.10.3
sudo python setup.py install

Теперь нужно установить clearsilver – чтобы trac мог использовать шаблоны для страниц. Этот пакет тоже пришлось забирать из сети и собирать тут же.

cd /home/some-user/distr
tar xvfz clearsilver_0.10.3.orig.tar.gz
cd ./clearsilver_0.10.3.orig
./configure
make
sudo make install

Наконец, создадим каталог для репозитория subversion и базовую структуру для него в каталоге /tmp.

sudo mkdir /var/svn
cd /tmp
sudo rm -rfR *
sudo rm -rfR .*
sudo mkdir /tmp/trunk
sudo mkdir /tmp/tags
sudo mkdir /tmp/branches

А теперь начинаются вещи, которые чаще всего генерируют проблемы. Будьте внимательны – в командах я еще мог ошибиться, но мои пояснения верны просто потому что пол-дня были потрачены именно на их решение, а потом еще меня проконсультировал действующий админ и друг (за что ему, конечно же, благодарность и которого, конечно же, я мог понять неверно и переврать :) ).

Более того, вся настройка ниже имеет условие – «используется только один репозиторий для создаваемого проекта». Пояснения – ниже. (а еще лучше – по поводу нескольких репозиториев – см. в Upd. внизу – тут тоже я, в принципе, не вру – но там об этом корректнее).

Используя svnadmin инициализируем репозиторий в соответствующей папке. Опция –pre-1.4-compatible необходима, если при установке без нее apache стал выдавать в логах нечто вроде «в /var/svn/SomeTracProject/format ожидалась версия 3, а обнаружена была версия 5″. Это конфликт разных версий модуля для Если вы используете точно такую же систему что и я (а именно если вы не исправляли ничего в /etc/apt/sources.conf и никто не выкладывал со времени моего поста новых версий пакетов :) ) и в точности следуете моим командам – то если вы не установите эту опцию – точно так и получится. В остальных случаях бросьте монету, протестируйте – пересоздать репозиторий никогда не поздно (закоммитить удаленно в неработающий все равно не получится :) ). Только потом, если вы уже создали окружение для trac – не забудьте потом сделать sudo trac-admin /var/trac/SomeTracProject resync.

Затем импортируем структуру из /tmp в репозиторий svn и допускаем туда apache.

sudo svnadmin create --pre-1.4-compatible /var/svn/SomeTracProject
cd /tmp
sudo svn import . file:///var/svn/SomeTracProject -m "Initial import"
sudo chown -R www-data:www-data /var/svn/SomeTracProject

Как вариант, можно создать репозиторий в файловой системе FSFS, тогда делайте: sudo svnadmin create –pre-1.4-compatible –fs-type=fsfs /var/svn/SomeTracProject.

Настало время инициировать окружение Trac. Отвечайте на вопросы честно, если не знаете ответа – по умолчанию. На вопрос про тип системы контроля версий ответьте ’svn’, а на вопрос про положение репозитория – ‘/var/svn/SomeTracProject’.

sudo trac-admin SomeTracProject initenv

И в этот каталог apache тоже должен иметь доступ.

sudo chown -R www-data /var/trac/SomeTracProject

Каким образом – апачу нужно объяснить:

sudo vi /etc/apache2/sites-available/trac

Вставьте в этот файл следующий текст (после последнего </Location>):

<Location /trac.cgi/*/login>
    AuthType Basic
    AuthName "Trac"
    AuthUserFile /etc/apache2/dav_svn.passwd
    Require valid-user
</Location>

Кратко – это настройка аутентификации для страницы логина. В качестве источника пользователей и md5-хешей-паролей используется файл /etc/apache2/dav_svn.passwd, который мы создадим попозже.

А пока – настроим удаленный доступ к репозиторию. Здесь надо остановиться и вдохнуть. Будьте внимательны.

sudo vi /etc/apache2/mods-available/dav_svn.conf

Ниже приведена конфигурация для доступа к одному репозиторию, если он подразумевается как единственный!

Если вы хотите настроить доступ к нескольким репозитроиям, все происходит совсем по-другому. Во-первых можно выделить как <Location> сам каталог /svn, тогда для него надо задать – ‘SVNPath /var/svn’ и настраивать корректно аутентификацию в authz-файле (смотрите ниже). Если же вы настраиваете Location‘ы для репозиториев со своими (отдельными) файлами авторизации (только тогда это оправдано), для ‘Location /svn’ следует указать вместо ‘SVNPath’ – ‘SVNParentPath /var/svn’, а для Location‘ов репозиториев указывать относительные пути, например: ‘SVNPath /SomeTracProject’. (подробнее см. в Upd. ниже).

В любом случае, если у вас в логах вылезают ошибки типа ‘Unknown/Incorrect SVN FileSystem’ – ошибку следует искать именно здесь, конкретно в SVN[Parent]Path. Причины же неожиданных Forbidden, конечно, кроются в неверных Location‘ах и, соответственно, аутентификации. Отключайте ее, проверяйте Location. Потом авторизацию. Впрочем, если вы осознали (а я хорошо объяснил) предыдущий абзац, то этих ошибок у вас вылезти не должно. Поговорив с я бы уже сделал все немного по-другому (смотрите ниже описание аутентификации), но в этом варианте уже все проверено и работает, а наугад писать опасно.

<Location /svn>
    DAV svn
    SVNPath /var/svn/SomeTracProject
    AuthType Basic
    AuthName "Subversion Repository"
    AuthUserFile /etc/apache2/dav_svn.passwd
    #AuthSVNAccessFile /etc/apache2/dav_svn.authz
    Require valid-user
</Location>

Создадим файл паролей и добавим туда пользователей (внимание: опция -c не нужна во втором случае – она создает/перезаписывает файл без предупреждения)

sudo htpasswd2 -c /etc/apache2/dav_svn.passwd user1
sudo htpasswd2 /etc/apache2/dav_svn.passwd user2

Установим первому пользователю права Admin’а в Trac’е.

sudo trac-admin /var/trac/SomeTracProject permission add user1 TRAC_ADMIN

Чтобы прочувствовать эти права на себе, можно поставить плагин TracWebAdmin – он добавляет удобную админскую GUI-страничку в Trac:

wget http://peak.telecommunity.com/dist/ez_setup.py
sudo python ez_setup.py
wget http://trac.edgewall.org/attachment/wiki/WebAdmin/TracWebAdmin-0.1.2dev_r4240-py2.4.egg.zip?format=raw
mv TracWebAdmin-0.1.2dev_r4240-py2.4.egg.zip\?format\=raw TracWebAdmin.egg
sudo easy_install TracWebAdmin.egg

В конфигурации проекта включите этот плагин.

sudo vi /var/trac/SomeTracProject/conf/trac.ini

Вставьте:

[components]
webadmin.*=enabled

Теперь добавим авторизацию для проектов в subversion.

sudo vi /etc/apache2/mods-available/dav_svn.conf

Раскомментируйте ‘AuthSVNAccessFile /etc/apache2/dav_svn.authz’.

Структура файла авторизации проста: пути, пользователи и права (r – чтение, w – запись):

sudo vi /etc/apache2/dav_svn.authz

Вставьте:

[/]
user1 = rw
user2 = r

Если бы вы указали в файле /etc/apache2/mods-enabled/dav_svn.conf ‘SVNParentPath /var/svn’, то файл аутентификации должен бы был выглядеть как-нибудь так (и это верный вариант для репозиториев с несколькими проектами):

[/SomeTracProject]
user1 = rw
user2 = r

[/AnotherTracProject]
user1 = rw
user2 = r

Ну и наконец перезапустим сервер (а если что-нибудь до сих пор не работает – машину :)) )

sudo /etc/init.d/apache2 restart


…На следующей неделе я буду устанавливать Timing для Trac’а (тикет получает такое понятие как estimation + фактическое время за которое он был сделан, milestone позволяет сложить все это время в часы, в комментах к ревизиям можно писать за сколько времени был выполнен тикет (часть тикета) и время автоматически просуммируется) – и если будет возможность и все пройдет удачно (это diff для версии 0.10), опишу здесь и этот процесс.

Upd.:

Первое. По поводу нескольких окружений и связанных с ними репозиториях. Легче всего – забить на отдельные репозитории для окружений и сделать (кстати имхо это и для одного проекта неплохой вариант)

sudo svnadmin create --pre-1.4-compatible /var/svn/ (опция compatible обязательна есть только у вас апач ругается на формат в файле /var/svn/FORMAT)

Затем в /tmp/ (очистив его предварительно :) ) mkdir-ом построить структуру «по одному каталогу для каждого проекта». А в каждом из этих каталогов сделать, соответственно, свои trunk-tags-branches. Затем сделать

cd /tmp
sudo svn import . file:///var/svn/ -m "Initial import"

В /etc/apache2/mods-enabled/dav_svn.conf указать:

<Location /svn>
    DAV svn
    SVNPath /var/svn/
    AuthType Basic
    AuthName "Subversion Repository"
    AuthUserFile /etc/apache2/dav_svn.passwd
    AuthSVNAccessFile /etc/apache2/dav_svn.authz
    Require valid-user
</Location>

и убрать ненужные Location’ы (подкаталоги svn’а), если они там есть.

А вот уже в файле аутентификации /etc/apache2/dav_svn.authz мы прописываем права на проекты:

[/]
megaroot = rw

[/SomeProject]
user1 = rw
user2 = r

[/AnotherProject]
user1 = rw
user2 = r

При создании окружений в trac-admin, мы в пути к репозиторию, соответственно, указываем /var/svn/SomeProject

Теперь можно возвращаться и читать про htpasswd и TracWebAdmin. Больше ничего не надо. А, хотя нет – потом вернитесь и прочитайте пункт Третье. Я расскажу про то, что делать, когда уже все поставлено.

Второе. Timing устанавливается точно так, как указано в рководстве, так что пояснений я делать не буду :). Остальные основные плагины (авторизация формой/аккаунты, форумы и бла-бла-бла) прикручиваются еще легче – сборкой

python setup.py bdist_egg

из распакованных сурсов, взятием из каталога dist результирующего яйца (.egg, прошу не обижаться – это почти что питоновский почти что аналог почти что .jar-ов) и укладкой его в каталог plugins окружения trac’a (не забываем про права www-data) (+ прописывание плагина в trac.ini окружения, как указано в описании или включение его в админке) . (для плагина с авторизацией в /etc/apache2/sites-enabled/trac надо закомментить весь Location trac.cgi/*/login, выключить траковский LoginModule и включить LoginModule из этого плагина, указать ему на /etc/apache/dav_svn.passwd и затем рестартовать апач).

Сложнее с плагином Graphviz, так что если он действительно нужен и никак его не поставить – пишите мне. Но думаю если вы справились со всем предыдущим – у вас и здесь все пройдет на ура :).

Третье. Когда нужно создать новый проект уже после того как все поставлено (а то и через некоторое время) – все просто. Пользователю megaroot (см. /etc/apache2/dav_svn.authz) закоммитить в /var/svn/ каталог с этим проектом (+ trunk-tags-branches).

Затем:

sudo trac-admin /var/trac/NewProject initenv (в пути к subversion указываем /var/svn/NewProject)
sudo chown -R www-data:www-data /var/trac/NewProject

Теперь надо настроить аутентификацию, делаем:

sudo vi /etc/apache2/dav_svn.authz

Жмем Insert и вставляем в конец файла:

[/NewProject]
user1 = rw
user2 = r
megaroot = rw

делаем Esc/:wq и…. все. Вот так – если все правильно настроено – делать нужно минимум.

Насчет добавления пользователя. Добавлять его нужно только в /etc/apache2/dav_svn.passwd и никуда больше:

sudo htpasswd /etc/apache2/dav_svn.passwd new_user

И если у вас все правильно настроено - примет его корректно и trac, и subversion.

Ах, ну да, для subversion его нужно еще пустить в проект :):

sudo vi /etc/apache2/dav_svn.authz

Вставляем в нужный проект:

[/SomeProject]
user1 = rw
user2 = r
megaroot = rw
new_user = rw


Вот теперь точно все. Успехов :).