Notícias do Suporte Direto

Instalando o Trac+SVN no Windows

Autor: William D. Knak
Data: 23/10/2006

Artigo Original:
http://trac.edgewall.org/wiki/TracOnWindows

Observações importantes: As versões dos programas descritas abaixo são ALTAMENTE recomendadas. Tive muitos problemas tentando instalar versões mais novas de alguns programas requeridos, e a combinação citada abaixo foi a que funcionou. Por exemplo, o Apache precisa ser a versão 2.0, a versão 2.2 não funcionará devido a diferenças na forma que a nova versão está sendo compilada, causando incompatibilidade com alguns dos programas abaixo.

1. Download dos programas

Requisitos, baixar os seguintes pacotes em um diretório:

2. Instalação dos programas

• 2.1 Instalar o Apache
  Se tiver a versão 2.2 do Apache, remova (e apague os arquivos de "c:\Arquivos de programas\Apache Group") e instale a versão 2.0 (ou faça a instalação em outro PC). Se tiver o IIS ativo, desative-o ou mude a porta 80 do IIS para outra. Instale para "All users" na porta 80. Certifique-se de que o Apache está funcionando corretamente, acessando http://localhost/ antes de prosseguir.

• 2.2 Instalar Subversion
  Ao instalar o Subversion o setup tentará localizar automaticamente o servidor Apache. Verifique se durante a instalação o Apache será pausado e reiniciado no final. Se a integração com Apache for feita automaticamentem na tela do "Apache Monitor" vai aparecer Apache/2.0.59 (Win32) SVN/1.3.2 DAV/2.

• 2.3 Copiar módulos do SVN para o Apache
  Copie os módulos do Subversion para o Apache, copie a linha abaixo e execute no prompt do MS-DOS:

  copy "%programfiles%\Subver~1\bin\*.so" "%programfiles%\apache~1\apache2\modules"

  Execute essa também:

  copy "%programfiles%\Subver~1\bin\*.dll" "%programfiles%\apache~1\apache2\modules"

• OBSERVAÇÃO IMPORTANTE
  Daqui em diante vamos usar como exemplo um repositório do SVN localizado em c:\svn\repo1. Se você for experiente com o SVN poderá usar um repositório "oficial", mas recomendamos que crie este repositório, mesmo que seja em branco, para facilitar os exemplos.

• 2.4 Criar a senha de Administrador
  Para criar a senha de administrador usada no SVN mapeado pelo Apache, execute a seguinte linha de comando no Prompt do MS-DOS:

  "%programfiles%\apache~1\apache2\bin\htpasswd" -cm c:\svn\.htaccess admin

  Informe a senha e confirme a senha.

• 2.5 Editar o arquivo httpd.conf do Apache
  O arquivo localiza-se em:

  %programfiles%\apache~1\apache2\conf\httpd.conf

  Localize e descomente as seguintes linhas (remover o # da frente):

  LoadModule dav_module modules/mod_dav.so
  LoadModule dav_fs_module modules/mod_dav_fs.so
  
  

  Depois do último "LoadModule", adicione as seguintes linhas:

  # Subversion
  LoadModule dav_svn_module modules/mod_dav_svn.so
  LoadModule authz_svn_module modules/mod_authz_svn.so
  

  No final do arquivo de configuração, adicione as seguintes linhas, apontando para o seu repositório SVN.

  # Subversion
  <Location /svn>
    DAV svn
    # any /svn/foo URL will map to a repository C:/svn/foo
    # I've only got it working using SVNPath!!
    SVNParentPath C:/svn
    AuthType Basic
    AuthName "Subversion repository"
    AuthUserFile c:/svn/.htaccess
    Require valid-user
  </Location>
  

  Obs.:Se não tiver ainda nenhum repositório, procure no artigo original como criar um usando as linhas de comando do SubVersion antes de prosseguir.

  Localize a linha a seguir, e descomente-a (remover o # do início):

  AddHandler cgi-script .cgi
  

  Salve o arquivo e feche-o.

• 2.6 Reiniciar e Testar o Apache
  Reinicie o serviço do Apache. Se tiver algum erro verifique o artigo original. Após reinciar, acesse o seguinte endereço, de acordo com a configuração que você colocou no HTTPD.CONF:

  http://localhost/svn/repo1/

• 2.7 Adicione os logins dos usuários
  Adicione alguns logins dos seus usuários do TRAC+SVN, dos clientes ou técnicos/programadores, executando a seguinte linha de comando no prompt do MS-DOS.

  "%programfiles%\apache~1\apache2\bin\htpasswd" -m c:\svn\.htaccess william
  

• 2.8 Instalando o Python
  Rode o programa de instalação do Python, para não se atrapalhar nesta primeira vez que está instalando, aceite a opção padrão de instalação, que é no diretório "C:\Python23". Após a instalação, adicione o caminho do Python no Path. Clique com o botão direito em "Meu Computador", escolha "Propriedades", na guia "Avançado" clique no botão "Variáveis de Ambiente"; na lista "Variáveis do sistema", edite a variável "PATH", e no final dela coloque o "ponto e vírgula" se necessário, e o caminho:

  C:\Python23

  Dica: Se tiver com o prompt do MS-Dos aberto, deverá fechá-lo e abri-lo novamente para que as configurações do Path sejam aplicadas ao Prompt.

• 2.9 Instale o Subversion Python Bindings
  Instale o Subversion Python Bindings da seguinte forma: descompacte o arquivo ZIP que você baixou, e copie os diretórios LIBSVN e SVN para o diretório C:\Python23\Lib\site-packages

• 2.10 Instale o PySQLite
  Faça a instalação do PySQLite (consulte a documentação para escolher outra opção da banco de dados, caso você use Postgree ou outro). A instalação do PySQLite deverá detectar onde o Python está instalado.

• 2.11 Instale o ClearSilver
  Instale o ClearSilver que é um template para as páginas do Trac usando o Python. A instalação do ClearSilver deverá detectar onde o Python está instalado.

• 2.12 Finalmente, o Trac
  Execute o setup do Trac, ele também deverá localizar automaticamente o local do Python.

• 2.13 TRAC.CGI
  Copie o arquivo Trac.CGI do diretório onde o Trac foi instalado (subdiretório "Share\Trac" dentro "c:\Python23") para o diretório cgi-bin do apache. Para copiar execute a linha abaixo no Prompt do MS-DOS:

  copy c:\python23\share\trac\cgi-bin\trac.cgi "%programfiles%\apache~1\apache2\cgi-bin"
  

  Edite o arquivo "trac.cgi" do diretório cgi-bin do Apache com o notepad e corrija o caminho do Python.EXE para o diretório da instalação do do Python. Obs: Não precisa remover o "#!", deixe assim:

  #!C:\Python23\python.exe
  

3. Configurando o banco de dados do Trac

• 3.1 Inicializando o banco TRAC
  No prompt do MS-DOS, entre no diretório C:\Python23\Scripts e execute a seguinte linha:

  python trac-admin c:/svn/trac.db
  

  Inicialize o banco de dados, digite:

  initenv
  

  Preencha as informações do seu projeto

  Enter project name
      Meu Projeto
  
    Database connection string [sqlite:db/trac.db]>
      (deixe o padrão, pressione ENTER)
  
    Enter path to repository
      c:\svn\repo1
  
    Enter path to templates
      c:\Python23\share\trac\templates
  

  Se tudo funcionar você verá a mensagem "Congratulations", e é merecida mesmo. Pois são tantos passos que é bem possível a gente se perder. Eu até coloquei uns CheckBoxes nos itens pra ir marcando e não me perder.

  Mas não pense que terminou, ainda faltam alguns passos. Ainda no prompt do MS-DOS, dentro do programa de administração do TRAC, dê permissão ao usuário admin, executando a seguinte linha:

  permission add admin TRAC_ADMIN
  

  Para sair, digite "quit".

• 3.2 Adicionando o TRAC no Apache
  O seu repositório SVN já está configurado no apache. Agora vamos adicionar também o TRAC.

  Edite novamente o arquivo HTTPD.CONF:

  %programfiles%\apache~1\apache2\conf\httpd.conf

  No final do arquivo adicione as seguintes linhas:

  # TRAC
  
  # Transfer serving up of static content to Apache
  Alias /trac/chrome/common "C:/Python23/share/trac/htdocs"
  
  # Alias for the friendly URL
  ScriptAlias /trac "c:/Arquivos de programas/Apache Group/Apache2/cgi-bin/trac.cgi"
  <Location "/trac">
    SetEnv TRAC_ENV "c:/svn/trac.db"
    SetEnv PYTHONPATH "C:/Arquiv~1/Subversion/bin"
    # if you are running Apache as a user other than System, the TMP variable
    # needs to be set to a place where that user can write scratch files.  Make
    # sure that this directory is created and writable by that user.
    # SetEnv TMP "c:/svn/trac.db/tmp
  </Location>
  
  <Location "/trac/login">
    AuthType Basic
    AuthName "trac"
    AuthUserFile C:/svn/.htaccess
    Require valid-user
  </Location>
  

  Dica: veja no artigo original como integrar a autenticação dos usuários em um domínio do Windows NT.

• 3.3 Reinicie o Apache

  Agora você pode testar se o TRAC está corretamente instalado! Basta acessar o endereço http://localhost/trac/

   

  Finalizando

  Divulgue esse tutorial no seu site/blog. Obrigado.

  Artigos relacionados:
  Incluir versão do SVN no Programa Delphi compilado