Esta es una traducción directa de Instalacion de Trac.
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
1 Python, versión >= 2.3.
- o Python 2.4 no esta soportado en windows debido a que no hay uniones de Subversion disponibles para el. o Para sistemas basados en RPM también podría necesitar los paquetes python-devel y python-xml.
2 ClearSilver, versión >= 0.9.3
- o Con python-bindings (./configure --with-python=/usr/bin/python)
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 las fuentes.
Para PostgreSQL ¶
- PostgreSQL
- psycopg2 or pyPgSQL
Nota: El soporte para PostgreSQL requiere una versión de Trac 0.9 o posterior.
Requerimientos Opcionales
-Sistema de Control de Versiones
1 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
- Trac usa los SWIG bindings incluidos en la distribución de Subversion, no PySVN (que es algunas veces confundido con los standards SWIG bindings).
- Si Subversion esta ya instalado sin los SWIG bindings, usted necesitara re - configurar Subversion y make swig-py, make install-swig-py.
2 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 MailingList o IrcChannel.
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 Trac
Como la nmayoria de programas en Python, el paquete Python de Trac es instalando corriendo el siguiente comando en la parte de arriba del directorio de fuentes.
$ python ./setup.py install
Nota: Nescesirtara permisos de root o equivalentes para este paso.
Esto compilara en bytes el codigo fuente de python y lo instalara en el directorio de sitios para paquetes de su instalacion de Python. Los directorios cgi-bin, plantillas, htdocs, wiki-default y wiki-macros son todos copiados en $prefix/share/trac/. los directorios para plugins y conf son tambien creados en $prefix/share/trac/ (desde 0.10).
El script tambien creara la herramienta de lineas de comando de trac-admin, usada para crerar y mantener ambientes de proyectos asi como el servidor tracd
Usuarios avanzados
para instalar trac en una locacion personalixada o encontrar otras opciones avanzadas de instalacion corra:
$ python ./setup.py install --help
Especificamente puede estar interesado en:
$ python ./setup.py install --prefix=/path/to/tracengine
Creando un ambiente de proyectos:
Un ambiente Trac es el almacenamiento trasero donde Trac guarda informacion como paginas wiki , tickets, reportes, configuraciones, etc. Un ambiente es basicamente un directorio que contiene un archivo de configuracion que es facil de leer y varios otros archivos y directorios
Un nuevo ambiente es creado usando trac-admin:
$ trac-admin /path/to/myproject initenv
trac-admin le pedira la informacion que nescesita para crear el ambiente, como el nombre del proyecto, el tipo y el camino hacia un existente repositorio de codigo fuente el alzo de coneccion a la base de datos y asi sucesivamente. si usted no esta seguro que especificar para alguna de estas opciones dejelo en blanco para usar el valor por defecto. El lazo de coneccion ala base de datos siempre servira mientras usted tenga SQlite insytalado La unica opcion donde el valor por defecto es probable que no funcione es el camino al repositorio de subversion, entonces este seguro que es correcto
Tambien note que los valores que usted especifica aca pueden ser cambiados editando directamente el archivo de configuracion TracIni Nota: La cuenta de usuario donde el servidor web corre requerira permisos para el directorio del ambiente y todos los archivos adentro de el
Corriendo el servidor en modo Standalone ¶
Despues de haber creado un ambiente para Trac usted puede probar facilmante la interface web corriendo el servidor web tracd:
$ tracd --port 8000 /path/to/myproject
Lugo ejecute un browser y visite http://localhost:8000/. Usted deberia encontrar un simple listado de todos los ambientes que tracd conoce. Siga el link al ambiente que usted acaba de crear, y usded debera ver a trac en accion.
Corriendo Trac en un Servidor Web¶
Trac da tres opciones para conectar se a servidor web real : CGI, FastCGI y mod_python. Para un desempeño decente, es recomendado que usted v use FastCGI o mod_python.
Configurando Autenticacion ¶
El proceso de anadir, remover, y configurar cuentas de usuario para la autentificacion depende en la forma especifica en la cual usted este corriendo Trac:Para aprender la forma de como lograr estas tareas, por favor visite una de las siguientes paginas:
TracStandalone si usted usa el servidor standalone, tracd.
TracCgi si usted usa los metodos CGI FastCGI.
TracModPython si usted usa el metodo mod_python.
Instrucciones de Instalacion en Plataformas especificas.
Por favor note que usted puede encontrar instrucciones mas detalladas para instalar Trac en un sistema especifico o plataforma en TracInstallPlatforms en el sitio principal de Trac. Usando Trac ¶
Una vez que usted tenga su sitio Trac subido y corriendo, Usted debe ser capas de recorrer su repositorio de subversion , Crear tickets, ver al linea de tiempo, etc.
Tenga en cuenta que que usuario anonimos (no logeados) pueden por defecto tener acceso a la mayoria pero no todas las opciones. Nescesitara configurar la autentificacion y garantizar permisos adicionales a los usuarios autenticados para que puedan ver todas las opciones.
Instalando y corriendo Trac en Debian Sarge
Paquetes que no estan por defecto ¶
Los usurios de Sarge que quieran la ultima version de trac nescesitan añaadir al gunas lineas a su /etc/apt/sources.list : # Trac and clearsilver deb http://ftp.edgewall.com/pub/debian sarge trac
Lugo 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/project
Accione 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)
Restart 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/project
los 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 iendo a http://servername.foo.com/proj/