Home Page do Portal
Brasil, um país de todos

Guia de Instalação do Trac

Table of Contents

A ferramenta de gerenciamento do projeto Trac baseado na web é implementada como um CGI ou como um programa independente. Trac é escrito na liguagem de programação Python e usa o SQLite, um banco de dados embutido para armazenamento persistente. Para renderização de HTML, o Trac usa o sistema de templates Clearsilver.

Requisitos

Para instalar o Trac, os seguintes pacotes de software devem estar instalados:

  • Python, versão >= 2.1 (>=2.3 recomendado).

Por favor, lembre-se que para sistemas com base no RPM você também necessitará dos pacotes python-devel e python-xml.

Pacotes Opcionais

Instalando o Trac

Como na maioria dos programas em Python, instale os módulos em python do Trac executando o seguinte comando no topo do diretório fonte: 

$ python ./setup.py install

Isto compilará o código-fonte e instalar-lo-á no diretório site-packages}} da sua instalação python. Os diretórios {{{cgi-bin, templates, htdocs e wiki-default são todos copiados para $prefix/share/trac/ .

O script instalará também a ferramenta de linha de comando trac-admin usada para criar e manter o ambiente de projeto.

O programa trac-admin é o centro de controle para o Trac.

Lembre-se: você precisará de permissões de root ou equivalente para este passo.

Para mais informações na instalação do Trac em plataformas específicas, visite a página TracInstallPlatforms (no site do projeto principal).

Usuários Avançados

Para instalar o Trac em um local personalizado e ver outras opções avançadas de instalação, execute: 

$ python ./setup.py --help

Criando um Ambiente de Projeto

TracEnvironment é o formato de armazenagem final onde o Trac armazena informações como páginas wiki, tickets, relatórios, configurações, etc. Um ambiente consiste em um diretório que contém um banco de dados SQLite, um arquivo de configuração que possa ser compreendido pelo ser humano, arquivos de log e anexos. Um novo ambiente do Trac é criado usando trac-admin, como: 

$ trac-admin /path/to/projectenv initenv

trac-admin perguntará à você onde seu repositório do subversion está localizado e onde ele pode encontrar o diretório de templates do trac (o valor padrão deve funcionar em uma instalação típica).

Lembre-se: O usuário do servidor web requisitará permissão de escrita para o diretório de ambiente e todos os arquivos internos. Não esqueça de definir apropriadamente as permissões.

O mesmo se aplica aos arquivos do repositório do subversion (ao menos que esteja usando o FSFS Subversion backend, algo que recomendamos fortemente)

Configurando o Apache

Torne "trac/cgi-bin/trac.cgi" acessível para o seu servidor web em /cgi-bin/, também pela copia/linkagem ou use diretamente o diretório "trac/cgi-bin/".

Edite a configuração do apache e acrescente esse trecho de código, nomes de arquivos editados para ficar de acordo com sua instalação: 

Alias /trac/ "/usr/share/trac/htdocs/" #or where you installed the trac htdocs
#You have to allow people to read the files in htdocs
<Directory "/usr/share/trac/htdocs">
	Options Indexes MultiViews
	AllowOverride None
	Order allow,deny
	Allow from all
</Directory>


# Trac need to know where the database is located
<Location "/cgi-bin/trac.cgi">
	SetEnv TRAC_ENV "/path/to/projectenv"
</Location>

# You need this to allow users to authenticate
# trac.htpasswd can be created with 
# cmd 'htpasswd -c trac.htpasswd' (UNIX)
# do 'man htpasswd' to see all the options
<Location "/cgi-bin/trac.cgi/login">
	AuthType Basic
	AuthName "trac"
	AuthUserFile /somewhere/trac.htpasswd
	Require valid-user
</Location>

Lembre-se: Se o Apache reclamar da linha Set'Env tenha certeza de ter o Load'Module para o mod_env sem nenhum comentário (Apache 1.3).

Lembre-se: Ao criar um novo ambiente, (trac-admin) irá imprimir uma pequena configuração personalizada para o seu projeto.

Lembre-se: Se você estiver usando as caracteristicas de Apache suEXEC visite ApacheSuexec (no site do projeto).

Usando o Trac

Parabéns! Você deverá ter agora uma instalação do Trac rodando em:

http://<yourhostname>/cgi-bin/trac.cgi

Você deverá ser capaz de fazer procuras em seu repositório do subversion, criar tickets, ter uma visão do timeline e usar todas as funcionalidades do Trac.

Lembre-se que usuários anônimos (não logado) podem acessar, por padrão, somente um subconjunto restrito de todas as características do Trac.

Nota: Se você não quiser URLs grandes e relativamente feias, você pode melhorá-las ajustando sua configuração do Apache. Visite TracPrettyUrls (no site do projeto).

Por favor, avance para TracPermissions para aprender como obter privilégios adicionais para usuários autenticados.

Para documentação do usuário, visite TracGuide.

Aproveite!

Equipe Trac

See also: TracGuide, TracUpgrade, TracPermissions, TracInstallPlatforms?, TracModPython