Notícias do Suporte Direto

23/Oct/2006 - 12:01
Instalando o Trac+SVN no Windows

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

Tags: Instalando o Trac+SVN no Windows

Veja mais:

Sysconnect Engenharia - Syseng
Em Santa Cruz do Sul a Sysconnect Engenharia atua na área elétrica prestando serviço de ...
RoundCube - Um Logotipo para cada VirtualHost
Administrando o RoundCube em uma hospedagem Apache com vários sites - Virtual Hosts - me deparei com a ...
WinampTweet - As músicas que você curte no Winamp, agora também no Twitter
Amantes do bom e velho Winamp. Tem coisas que não mudam, Windows Media Player sem dúvida domina o mercado,...
UDF para envio de E-mail pelo Firebird
Desenvolvemos uma UDF para envio de email pelo Firebird / Interbase. Veja mais em: www.suportedireto.com....
Incluir versão do SVN no Programa Delphi compilado
Autor: William D. Knak Data: 19/10/2006 Links e imagens corrigidos - 12/01/2015 A seguir vou descrever a ...