Contexto
Trac es un Wiki extendido con manejador de aspectos para desarrollo de proyectos de software escrito en Python.
Usando trac para administrar trac (documentación incluida).
En debian ya viene preempaquetado. Para instalarlo basta con hacer:
# apt-get install trac
Guia de Instalacion de TRAC
Esta es una traducción de la información contenida en: http://projects.edgewall.com/trac/wiki/TracInstall
Trac es una herramienta liviana de manejo de proyectos que es implementada como una aplicación basada en web.Trac esta escrita en el lenguaje de programacion Python y nescesita una base de datos (SQLite o PostgreSQL funcionan). Para el renderizado HTML TRAC utiliza el sistema de plantillas Clearsilver.
Lo que sigue son instrucciones genericas para instalar y poner a punto Trac y sus requerimientos. Usted puede encontrar instrucciones de instalar Trac en sistemas especificos en TracInstallPlatforms o en el sitio principal de Trac, por favor este seguro de leer estas instrucciones generales primero para tener un buen entendimiento de las tareas involucradas.
Requerimientos
Para instalar Trac, los siguientes paquetes deben ser instalados
Python, versión >= 2.3.
- Python 2.4 no esta soportado en windows debido a que no hay uniones de Subversion disponibles para este.
- Para sistemas basados en RPM también podría necesitar los paquetes python-devel y python-xml.
ClearSilver, versión >= 0.9.3
- Con python-bindings (./configure --with-python=/usr/bin/python)
- Tambien se nescesita un sistema de base de datos y los drivers de python correspondientes para ella. La base de datos puede ser SQLite, PostgreSQL o MySQL (experimental).
Nota: Como para Trac 0.10, Subversion no es un requerimiento mandatorio.
Para SQLite
- SQLite, version 2.8.x o 3.x (preferida)
Los python bindings para el anterior, vea detalles en PySqlite
Nota: Versiones de Trac antes de 0.9 no trabajan con PySQLite 2.x.
Nota: Parece ser que PySQLite 2.x es requerido para Trac 0.9+/SQLite 3.x si usted plnea usar el script 'trac-post-commit-hook.py' disponible en la seccion de contribucion del repositorio de fuentes.
Para PostgreSQL
Nota: El soporte para PostgreSQL requiere una versión de Trac 0.9 o posterior.
Requerimientos Opcionales
Sistema de Control de Versiones
Subversion, versión >= 1.0. (1.2.3 o>= 1.3.1 recomendadas) y sus correspondientes Python bindings o uniones Python. Para solucion de problemas, mire TracSubversion
Otros sistemas están siendo activamente trabajados; mire VersioningSystemBackend
Servidor Web
Un servidor Web con soporte CGI (vea TracCgi), o
Un rapido servidor Web con soporte CGI (vea TracFastCgi), o
Apache con mod_python 3.1.3+ (vea TracModPython)
- Cuando se instala mod python las versiones de desarrollo de Python y Apache son requeridas ( las librerías y archivos de cabecera)
Para aquellos estancados con Apache 1.3, tambien es posible tener Trac 0.8.4 trabajando con mod_python 2.7 (vea TracModPython2.7). Esto no ha sido probado con Trac 0.9, asi que puede o no funcionar.
Otras Utilidades de Python
setuptools, versión >= 0.6 para usar plugins (vea TracPlugins)
docutils, versión >= 0.3.3 para WikiRestructuredText.
SilverCity y/o Enscript para resaltar sintaxis .
Note que SilverCity 0.9.6 tiene un bug que parte la resaltamiento de la sintaxis de Python en Trac. Hasta que un update este disponible recomendamos usar la versión 0.9.5.
Atencion: Las variadas versiones disponibles de estas dependencias no son nescesariamente intercambiable, entonces por favor tenga cuidado con los numeros de version anteriores. Si esta teniendo problemas haciendo que Trac trabaje por favor revise dos veces todas las dependencias antes de pedir ayuda en lista de correo o CanalIrc
Por favor remitase a la documentación de estos paquetes para encontrar como es la mejor forma de instalarlos. En adición, la mayoría de las instrucciones especificas a las plataformas también describen la instalación de las dependencias. Tenga en mente sin embargo que esa información puede ser de viejas versiones de Trac diferentes a la que usted esta instalando (en particular aun hay unas paginas relativas a Trac 0.8.
Instalando y corriendo Trac en Debian Sarge
Esta es una traducción de la información contenida en: http://projects.edgewall.com/trac/wiki/TracOnDebianSarge
Paquetes que no estan por defecto
Los usurios de Sarge que quieran la ultima version de trac nescesitan añaadir algunas lineas a su /etc/apt/sources.list :
# Trac and clearsilver deb http://ftp.edgewall.com/pub/debian sarge trac
Luego actualice el cache de APT :
# apt-get update
Asi los anteriores pasos para tenes la ultima version de trac, se siguieron o no instalar Trac debe ser tan simple como instalar el paquete de trac
Subversion and Trac
Desde una basica installacion de Sarge, usted nescesitaria instalar apache2, subversion, trac, y libapache2-svn. Si usted ha instalado alguna porcion de estas adapte como sea nescesario
Prerequisitos
# apt-get install apache2 # apt-get install subversion # apt-get install libapache2-svn # apt-get install trac
Poniendo Subversion a trabajar
Para crear un proyecto de subversion en /var/svn/project, haga estos comandos para hacer que SVN corra:
Nota: Como este escrito el paquete por defecto de subversion usa el sistema de archivos BDB ; si esto es acepatable sientase libre de omitir el argumento extra hacia svnadmin create.
# mkdir /var/svn # mkdir /var/svn/project # mkdir /tmp/project # mkdir /tmp/project/branches # mkdir /tmp/project/tags # mkdir /tmp/project/trunk # svnadmin create /var/svn/project --fs-type fsfs # svn import /tmp/project file:///var/svn/project -m "initial import" # rm -rf /tmp/project
Añada lo siguiente a /etc/apache2/sites-available/default:
#SVN dir <Location /svn> DAV svn SVNParentPath /var/svn SVNAutoversioning on AuthType Basic AuthName "SVN - Your Project" AuthUserFile /etc/apache2/svn.passwd Require valid-user </Location>
Arregle los permisos hacia el repositorio:
# find /var/svn/project -type f -exec chmod 660 {} \;
# find /var/svn/project -type d -exec chmod 2770 {} \;
# chown -R root.www-data /var/svn/projectAccione lo modulos de apache instalados
# a2enmod dav # a2enmod dav_fs
Añada los usuarios de subversion. Note La sinaxis diferente para crear el primer usuario en comparacion de la creacion de cada usuario adicional.
# cd /etc/apache2 # htpasswd2 -c svn.passwd user1 (you'll be prompted for the password) # htpasswd2 svn.passwd user2 (you'll be prompted for the password)
Reinicie Apache2.
# apache2 -k restart
Vaya a http://servername.foo.com/svn/project Para ver como se los directorios vacios como son importados No pase a lo siguiente hasta que esto funcione bien
Haciendo que Trac corra:
Estas instrucciones instalaran un ambiente trac en /var/trac/project, Sin usar las extensiones de mod_python. Inicialice el ambiente de trac con los siguientes comandos :
# mkdir /var/trac
# trac-admin /var/trac/project initenv
# find /var/trac/project -type f -exec chmod 660 {} \;
# find /var/trac/project -type d -exec chmod 2770 {} \;
# chown -R root.www-data /var/trac/projectlos comandos trac-admin de arriba le preguntara que ponga el nombre del proyecto, El camino a el ambiente de trac , y el camino hacia el directorio de plantillas de trac; luego imprimirá muchas cosas. Luego, edite /etc/apache2/sites-available/default. Comente el script existente ScriptAlias y las directivas de <Directory "/usr/lib/cgi-bin">. Para instalar trac en una url como !http://servername.foo.com/proj , añada esto al final:
Alias /trac "/usr/share/trac/htdocs" ScriptAlias /proj /usr/share/trac/cgi-bin/trac.cgi <Location "/proj"> SetEnv TRAC_ENV "/var/trac/project" </Location> <Directory "/usr/share/trac/htdocs"> Options Indexes MultiViews AllowOverride None Order allow,deny Allow from all </Directory> # Necesitara algo como esto para autentificar usuarios <Location "/proj/login"> AuthType Basic AuthName "project" AuthUserFile /var/www/trac.htpasswd Require valid-user </Location>
Dando /etc/apache2/svn.passwd En el espacio de arriba le permitira usar los mismos nombres de usuario y passwords en Subversion y Trac, conjuntamente Si usted escoge autentificar separadamente añada los usuarios de Trac y empiece de nuevo apache :
# cd /var/www # htpasswd2 -c trac.htpasswd user1 (se le preguntara el password) # htpasswd2 trac.htpasswd bar user2 (se le preguntara el password) # apache2 -k restart
Finalmente pruebe http://servername.foo.com/proj/ ---
Comentarios
Para lo que hemos hecho con JorgeCortes, en cuanto a la instalacion en Debian Sarge es bueno seguir las instrucciones al pie de la letra en la parte de instalacion en Debian Sarge, si se siguen asi como estan, en principio no habria problema con la instalacion, el problema que se puede presentar es en cuanto al directorio por default en donde se ubica el repositorio es decir en donde esta el codigo fuente (browse code), ahora si aparece este problema con SVN lo unico que habria que hacer es variar en la configuracion este archivo y dejarlo como /var/svn/project.Pero este error sale generalmente en Debian Etch. -- Dirak
