Por André Dourado

Não sou um especialista nem em Redmine, nem em Rails, portanto essa pode não ser a melhor solução no tocante às ferramentas, mas acabou sendo uma forma simples de implementar gráficos de controle de nosso backlog no Redmine.

Descrição da Solução

Precisávamos de uma tabela para armazenar uma fotografia do backlog de nosso setor de desenvolvimento. Nessa tabela inserimos, através de uma tarefa agendada, diariamente às 2 da manhã: quantos tickets entraram e saíram no dia anterior e o total de tickets no backlog.

A partir dessa tabela geramos dois gráficos: um gráfico de linhas, com a quantidade diária de tickets abertos, outro de barras verticais, com a quantidade de tickets que entram e que saem.

Google Charts API

Google Charts API é uma ferramenta muito útil e interessante para quem desenvolve aplicações web e quer gerar gráficos de uma forma dinâmica. Esta API caracteriza-se pela facilidade de utilização e implementação, não sendo necessária a instalação de qualquer software ou frameworks. Para a sua utilização, basta a URL da API no qual serão referenciados os dados e características necessários para gerar o gráfico pretendido.

Os parâmetros são separados por “&”. Podem ser especificados quantos parâmetros se desejarem e pretenderem. Não pretendo aqui tentar esgotar as diversas opções de gráficos possíveis. A documentação completa da API pode ser encontrada em: http://code.google.com/intl/pt-BR/apis/chart/

Detalharei aqui apenas os que utilizamos em nossos gráficos, de forma que tenham um ponto de partida para que possam adaptá-los a suas necessidades.

Construção do Gráfico
“chs” Tamanho do gráfico gerado. Use chs=largura,altura. Ex: chs=430×225&

“cht” Especifica o tipo do gráfico. Linhas do tipo lc, onde são desenhadas diversas linhas para diversos conjuntos de dados, ou do tipo lxy, onde um par de conjuntos de dados é necessário para cada linha. Ex: cht=lc&

“chxt” Especifica os diversos eixos que serão usados no gráfico. O índice do primeiro eixo é 0, o índice do segundo eixo é 1 e assim por diante. Você pode especificar diversos eixos incluindo x, t, y ou r diversas vezes. Ex: chxt=x,y& onde x corresponde ao eixo 0 e y ao eixo 1.

“chxr” Define a escala de um eixo. O primeiro parâmetro é o número do eixo relacionado ao especificado em “chxt”. Os seguintes definem o início e o fim da faixa do eixo. Ex: chxr=1,0,150&

“chd=t” Codificação dos dados em forma de texto com dimensionamento de dados. Usa uma string de qualquer número positivo ou negativo em conjunto com um parâmetro de dimensionamento (chds). Ex: chd=t:108,111,111,111,120&

“chds” Maneira alternativa de definir a linha zero, combinado à codificação de texto. Um conjunto de dados que varia de -60 a 120, pode definir uma escala de -80 a 140 para deixar algum espaço acima e abaixo das barras. Ex: chds=0,150&

“chxl” Todos os rótulos de eixo são separados por uma barra vertical “|”.Os rótulos de eixo devem ser especificados em seqüência (0, seguido de 1, seguido de 2 e assim por diante). Ex: chxl=0:|25|26|27|28|29&

Formatação do Gráfico
“chls” Especifica os estilos de linha. Espessura da linha, comprimento da linha contínua, comprimento do segmento em branco. Ex: chls=2,1,0& linha de espessura média (2), linha não tracejada (1,0).

“chco” Especifica as cores das linhas, barras etc. Todos os valores de cores são números hexadecimais no formato RRGGBB. Ex: chco=DE091A,EBB671& mostra dois conjuntos de linhas/barras.

“chf” Especifica o preenchimento sólido com “bg ou c ou a,s,cor|”, onde “bg” para preenchimento de plano de fundo, “c” para preenchimento da área do gráfico ou “a” para aplicar transparência ao gráfico inteiro. é um número hexadecimal em formato RRGGBB. Ex: chf=c,lg,45,ffffff,0,b1cbfa,0.75|bg,s,fcfcfc&

“chm” Para colocar valores e marcadores sobre os pontos dos gráficos. São muitos os detalhes relativos a esse parâmetro. Sugiro consultar diretamente a documentação na Google: http://code.google.com/intl/pt-BR/apis/chart/#shape_markers2

“chma” Define as margens do gráfico. Use chma=esquerda,direita,topo,baixo. Ex: chma=30,20,20,30&

Por exemplo o gráfico de linha que utilizaremos no tutorial, seria gerado a partir da seguinte url:

http://chart.apis.google.com/chart?
chd=t:108,111,111,111,120&
chxl=0:|25|26|27|28|29&
chm=o,FF0000,0,0,6,0|o,FF0000,0,1,6,0|o,FF0000,0,2,6,0|o,FF0000,0,3,6,0|o,FF0000,0,4,6,0|
t108,FF0000,0,0,10,0|t111,FF0000,0,1,10,0|t111,FF0000,0,2,10,0|t111,FF0000,0,3,10,0|t120,FF0000,0,4,10,0&
cht=lc&
chxt=x,y&
chs=430x225&
chds=0,150&
chxr=1,0,150&
chco=FF0000&
chls=2,1,0&
chf=c,lg,45,ffffff,0,b1cbfa,0.75|bg,s,fcfcfc&
chma=30,20,20,30&
chdl=Tickets+Abertos&
chdlp=b

Criação do Modelo

1.Execute o comando de criação do modelo “backlogs”:

ruby script/generate model backlogs project_id:integer
back_date:date back_abertas:integer back_fechadas:integer back_total:integer

2.Execute a migração:

rake db:migrate

Instalação do Google Charts API

1.Instale a gem do Google Charts API. Mude para o diretório raiz do redmine e digite o seguinte comando:

gem install googlecharts

2.Adicione a nova gem no ambiente de sua aplicação. Edite o arquivo redmine/config/environment.rb e acrescente a linha: config.gem “googlecharts”, :lib => “gchart”

Rails::Initializer.run do |config|
  config.gem "googlecharts", :lib => "gchart"
end

3.Edite o arquivo redmine/app/controllers/application.rb e acrescente a linha: require “gchart”

require "gchart"
class ApplicationController < ActionController::Base
...

Implementação dos gráficos no Redmine

1.Edite o arquivo “redmine/app/controllers/projects_controller.rb” e insira as seguintes linhas:

  def graficos_backlog
    dados = ""
    legenda = ""
    pontos = ""
    pontos_barras = ""
    dados_abertas = ""
    dados_fechadas = ""
    max_total = 0
    max_abertas = 0
    max_fechadas = 0

    nponto = 8

    Backlogs.find(:all, :conditions => {:project_id, @project.id},  rder => "id desc", :limit => 9).each do |s|
      dados = "," + s.back_total.to_s() + dados
      dados_abertas = "," + s.back_abertas.to_s() + dados_abertas
      dados_fechadas = "," + s.back_fechadas.to_s() + dados_fechadas
      legenda = "|" + s.back_date.strftime("%d/%m") + legenda
      pontos = "|o,FF0000,0," + nponto.to_s() + ",6,0|t" + s.back_total.to_s() + ",FF0000,0," + nponto.to_s() + ",10,0" + pontos
      pontos_barras = "|t" + s.back_abertas.to_s() + ",FF0000,0," + nponto.to_s() + ",10,0|t" + s.back_fechadas.to_s() + ",FF0000,1," + nponto.to_s() + ",10,0" + pontos_barras

      nponto = nponto - 1

      if max_total < s.back_total
         max_total = s.back_total
      end

      if max_abertas < s.back_abertas
         max_abertas = s.back_abertas
      end

      if max_fechadas < s.back_fechadas
         max_fechadas = s.back_fechadas
      end
    end

    if dados.length > 0
      dados = "chd=t:" + dados[1, dados.length] + "&"
      dados_abertas = "chd=t:" + dados_abertas[1, dados_abertas.length] + "|" + dados_fechadas[1, dados_fechadas.length] + "&"
      legenda = "chxl=0:|" + legenda[1, legenda.length] + "&"
      pontos = "chm=" + pontos[1, pontos.length ] + "&"
      pontos_barras = "chm=" + pontos_barras[1, pontos_barras.length] + "&"

      # define pontos maximos dos graficos
      if max_total > 10
         multi = 1.1
      else
         multi = 2
      end

      max_graf_linha = "chds=0," + (max_total * multi).to_i().to_s() + "&chxr=1,0," + (max_total *multi).to_i().to_s() + "&"

      if max_abertas > max_fechadas
         max_barra = max_abertas
      else
         max_barra = max_fechadas
      end

      if max_barra >= 10
         multi = 1.1
      else
         multi = 2
      end

      max_graf_barra = "chxr=1,0," + (max_barra * multi).to_i().to_s() + "&chds=0," + (max_barra * multi).to_i().to_s() + "&"

      # define parametros de saida
      custom_linha = dados + legenda + pontos + max_graf_linha + "cht=lc&chxt=x,y&chs=430x225&chco=FF0000&chls=2,1,0&chf=c,lg,45,ffffff,0,b1cbfa,0.75|bg,s,fcfcfc&chma=30,20,20,30&chdl=Tickets+Abertos&chdlp=b"
      custom_barra = dados_abertas + pontos_barras + legenda + max_graf_barra + "cht=bvg&chs=430x225&chco=DE091A,EBB671&chbh=15,0,12&chxt=x,y&chs=430x225&chdlp=b&chdl=Abertos|Fechados&chf=c,lg,45,ffffff,0,b1cbfa,0.75|bg,s,fcfcfc&chma=30,20,20,30"
    else
      custom_linha = ""
      custom_barra = ""
    end

    {:custom_linha => custom_linha, :custom_barra => custom_barra}
  end

2.Ainda no arquivo “redmine/app/controllers/projects_controller.rb”, na definição da ação “Show” insira a seguinte linha:

    @graficos_backlog = graficos_backlog

3.No arquivo “redmine/app/views/projects/show.rhtml”, insira as seguintes linhas:

    <%= Gchart.line :size => '430x225',
                    :custom => @graficos_backlog[:custom_linha],
                    :format => 'image_tag' %>

3.Ainda no arquivo “redmine/app/views/projects/show.rhtml”, insira as seguintes linhas:

    <%= Gchart.bar :size => '430x225',
                   :custom => @graficos_backlog[:custom_barra],
                   :stacked => false,
                   :bar_width_and_spacing => '15,0,5',
                   :format => 'image_tag' %>

4.Inclua no arquivo “redmine/config/routes.rb” a linha:

map.resources :graficos_backlog

5.Reinicie o serviço do redmine para que as alterações tenham efeito.

O resultado final deve ser semelhante a tela abaixo:

Por: André Dourado

Configuração de um servidor de produção para o Redmine, em ambiente Windows, servidor http Apache+Mongrel, acessando base de dados armazenada no MySQL. Este post tem a finalidade de descrever esse processo, passo a passo.

Requisitos

Windows XP SP2: este tutorial foi feito utilizando um XP SP2 previamente instalado. Provavelmente funcionará sem problemas em outras versões de Windows.

Apache Webserver 2.x: neste tutorial foi utilizada a versão “Win32 Binary without crypto (no mod_ssl) (MSI Installer)” que pode ser obtida no endereço: http://ftp.unicamp.br/pub/apache/httpd/binaries/win32/apache_2.2.11-win32-x86-no_ssl.msi

One-Click Ruby Installer: neste tutorial foi utilizada a versão “One-Click Ruby Installer 1.8.6-25″ que pode ser obtida no endereço: http://rubyforge.org/frs/download.php/18566/ruby186-25.exe

MySQL: neste tutorial foi utilizada a versão “mysql-essential-5.5.0-m2-win32″ que pode ser obtida no endereço: http://ftp.astral.ro/mirrors/mysql.com/Downloads/MySQL-5.5/mysql-essential-5.5.0-m2-win32.msi

Redmine: neste tutorial foi utilizada a versão “redmine-0.8.1″ que pode ser obtida no endereço: http://rubyforge.org/frs/download.php/51748/redmine-0.8.1.zip

Instalação do Apache Web Server

1.Execute o instalador do Apache Webserver, clicando sobre o arquivo “apache_2.2.11-win32-x86-no_ssl.msi” a partir do Windows Explorer. Clique então sobre o botão “Next”.

2.Selecione a opção “I accept the terms…” e clique sobre o botão “Next”.

3.Clique sobre o botão “Next”.

4.Informe os endereços solicitados e clique no botão “Next”.

5.Selecione a opção “Typical” e clique sobre o botão “Next”.

6.Clique sobre o botão “Change…” para alterar o caminho onde o servidor será instalado.

7.Informe o caminho desejado. Neste tutorial utilizamos o caminho “c:\apache”. Clique sobre o botão “Ok”.

8.Clique sobre o botão “Next”.

9.Clique sobre o botão “Install”.

10.Clique sobre o botão “Finish”.

11.Teste se o servidor foi instalado corretamente, digitando “http://localhost” no campo url do browser. Se tudo estiver ok, a tela apresentada será semelhante a tela abaixo:

Instalação do Ruby

1.Execute o instalador do Ruby, clicando sobre o arquivo “ruby186-25.exe” a partir do Windows Explorer. Clique então sobre o botão “Next”.

2.Clique sobre o botão “I Agree”.

3.Clique sobre o botão “Next”.

4.Informe o caminho desejado. Neste tutorial utilizamos o caminho “c:\ruby”. Clique sobre o botão “Next”.

5.Clique sobre o botão “Install”.

6.Clique sobre o botão “Next”.

7.Clique sobre o botão “Finish”.

Instalação dos pacotes Rails, Mongrel, Win32 Services

1.Os próximos passos serão executados em linha de comando do Windows, para isso clique no botão iniciar do Windows. Clique em “Executar” e na linha de comando digite “cmd” e pressione a tecla “Enter”. Todas as operações levam alguns minutos e é necessário que você esteja conectado à internet.

2.Mude para o diretório “c:\ruby\bin” e digite o comando de atualização do gerenciador de pacotes do Ruby RubyGems:

    gem update --system

3.Digite o comando de atualização e instalação do Rails:

Obs: Em uma instalação no Windows Vista tive o seguinte erro:

C:\ruby\bin>gem install rails
ERROR: While executing gem ... (Errno::ENOENT)
No such file or directory - C:\Users\André Dourado

Provavelmente pelo espaço no caminho do diretório. Setei a variável “userprofile” para o diretório do ruby e o problema foi solucionado.

C:\ruby\bin>set userprofile=c:\ruby

    gem install rails

4.Digite o comando de atualização e instalação do Mongrel:

    gem install mongrel

5.Digite o comando de atualização e instalação do suporte aos serviços Win32:

    gem install win32-service

6.Digite o comando de atualização e instalação do mongrel como serviço Win32:

    gem install mongrel_service

Instalação do MySQL

1.Execute o instalador do MySQL, clicando sobre o arquivo “mysql-essential-5.1.31-win32.msi” a partir do Windows Explorer. Clique então sobre o botão “Next”.

2.Clique sobre o botão “Next”.

3.Clique sobre o botão “Change”.

4.Entre com o caminho da instalação, no caso “c:\mysql”. Clique sobre o botão “Ok”.

5.Clique sobre o botão “Next”.

6.Clique sobre o botão “Install”.

7.Clique sobre o botão “Next”.

8.Clique sobre o botão “Next”.

9.Clique sobre o botão “Finish”.

10.Clique sobre o botão “Next”.

11.Clique sobre o botão “Next”.

12.Clique sobre o botão “Next”.

13.Clique sobre o botão “Next”.

14.Clique sobre o botão “Execute”.

15.Clique sobre o botão “Finish”.

Instalação do Redmine

1.Clique com o botão da direita sobre o arquivo zip do Redmine e selecione a opção “Extrair tudo…”. Ao abrir o “Assistente para extração” clique no botão “Avançar”. Na próxima tela, no campo de diretório de destino, digite “c:\apache\htdocs”.

2.Para facilitar a navegação pelos diretórios do aplicativo, renomeie o diretório criado pelo Redmine de “redmine-0.8.1” para apenas “redmine”;

3.Copie o arquivo “config\database.yml.example” para “config\database.yml”. Neste tutorial utilizamos o banco de dados MySql, com o usuário “root” sem senha e será executado em nossa máquina local. Para este setup a seção “production:” do arquivo “database.yml”, deve ficar:

   production:
    adapter: mysql
    database: redmine
    host: localhost
    username: root
    password: <senha_mysql>
    encoding: utf8

4.Os próximos passos serão executados em linha de comando do Windows, para isso clique no botão iniciar do Windows. Clique em “Executar” e na linha de comando digite “cmd” e pressione a tecla “Enter”.

5.Mude para o diretório “c:\mysql\bin” e digite o comando de execução do mysql para o usuário “root” no banco de dados mysql.

    mysql -u root mysql

6.Crie a estrutura do banco de dados “redmine” com o comando:

    create database redmine character set utf8;

7.Saia do MySql digitando o comando “quit” e pressionando a tecla “Enter”.

8.Mude para o diretório do redmine “c:\apache\htdocs\redmine”. Crie a estrutura do banco de dados “redmine”, digitando o comando:

    \ruby\bin\rake db:migrate RAILS_ENV=production

9.Insira os dados padrão de configuração no banco de dados, digitando o comando:

    \ruby\bin\rake redmine:load_default_data RAILS_ENV=production

Ao ser solicitado para informar a língua desejada, digite “pt-br” e pressione a tecla “Enter”.

10.Instale o serviço que irá executar o servidor Mongrel para o Redmine na porta 4000, digitando o comando:

    \ruby\bin\mongrel_rails service::install -N Redmine -c c:\apache\htdocs\redmine -p 4000 -e production

11.Inicie o serviço, digitando o comando:

    net start Redmine

12.Através do browser teste se o Redmine está no ar. Acesse o endereço “http:\\localhost:4000\login”

Configuração do Apache

1.Crie o arquivo de configuração de proxy para a aplicação “c:\apache\conf\http-proxy-redmine.conf”, com o seguinte conteúdo:

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
ProxyRequests Off

ProxyPass /redmine/ http://127.0.0.1:4000/
ProxyPass /redmine http://127.0.0.1:4000/
ProxyPassReverse /redmine http://127.0.0.1:4000/

2.Edite o arquivo de configuração do Apache “c:\apache\conf\httpd.conf”. Acrescente na última linha do arquivo a seguinte linha:

Include conf/http-proxy-redmine.conf

3.Reinicie o serviço do Apache pelo gerenciador de serviços do Windows.

Configuração do Proxy Reverso

O Rails cria internamente endereços de URL para links de folha de estilo, que faz com que a aplicação não execute da forma correta, através do proxy do Apache. Utilizaremos um plugin do Rails, que altera o modo como as URLs são criadas.

1.Mude para o diretório do redmine “c:\apache\htdocs\redmine”. Instale o plugin, digitando o comando abaixo. Responda para a url base “c:\apache\htdocs\redmine” e para a versão do Rails, escolha a opção “3″:

    \ruby\bin\ruby script/plugin install http://svn.napcsweb.com/public/reverse_proxy_fix

2.Reinicie o serviço do Redmine pelo gerenciador de serviços do Windows.

Teste do Redmine pelo Proxy

1.Através do browser teste se o Redmine está no ar, sendo acessado pelo proxy configurado no Apache. Acesse o endereço “http:\\localhost\redmine\login”

Post Relacionados:
    Tutorial Redmine – Gráficos no Redmine usando a API do Google Charts

Referências:
    Serving Multiple Rails Applications on Windows with Apache and Mongrel
    Mongrel Win32 HOWTO

Em continuação à série de tutoriais relacionados ao Redmine, neste será apresentada uma forma de criar cópias de segurança, dos dados armazenados pela aplicação.

Backups dos dados do Redmine, devem incluir os dados armazenados no banco de dados e os arquivos armazenados nos diretórios da aplicação.

Requisitos

WinRAR: para a automação do processo de backup, neste tutorial foi utilizado a versão do compactador em linha de comando, que acompanha a instalação do software WinRAR, portanto o software deve estar previamente instalado.

Premissas

Para a criação do arquivo de lote, foram assumidas algumas premissas:

• Saber em que diretório está instalado o WinRAR. No caso deste tutorial ele está instalado em “c:\Arquivos de Programas\WinRar”. No arquivo de lote foi utilizado o caminho como é representado no ambiente de linha de comando “\arquiv~1\winrar\”;
• Saber em que diretório está instalado o MySQL. No caso deste tutorial ele está instalado em “c:\rails\mysql\bin\”;
• O schema do banco de dados será armazenado em um arquivo com o nome no formato “bkp_redmine_aaaammdd_mysql_schema.sql”, onde “aaaammdd” corresponde a data da criação do backup;
• Os dados exixtentes no schema do banco de dados serão armazenados em um arquivo com o nome no formato “bkp_redmine_aaaammdd_mysql_data.sql”, onde “aaaammdd” corresponde a data da criação do backup;
• Os arquivos existentes no diretório da aplicação “\rails\rails_apps\redmine\files” serão armazenados em um arquivo com o nome no formato “bkp_redmine_aaaammdd_files.rar”, onde “aaaammdd” corresponde a data da criação do backup;
• O usuário do banco MySQL utilizado para o backup, será o “root” com senha de acesso em branco.

Criação do Arquivo de Lote

1.Crie um diretório onde serão armazenados os arquivos de backup. No caso foi criado o diretório “backup_redmine” no raiz do c:

2.Crie um arquivo de lote que executará o processo de backup. Utilize para esta operação, qualquer editor de textos, por exemplo o notepad e inclua as seguintes linhas:

for /f “tokens=2-4 delims=/ ” %%a in (‘DATE /T’) do set Date=%%c%%b%%a

\arquiv~1\winrar\rar a \backup_redmine\bkp_redmine_%Date%_files \rails\rails_apps\redmine\files\*.*

3.Salve o arquivo de lote em um diretório qualquer. No caso foi salvo em: “C:\rails\rails_apps\redmine\” com o nome “backup_redmine_mysql.bat”.

4.Crie um atalho na área de trabalho do Windows para a chamada da rotina de execução do backup, para quando achar necessário que a mesma seja executada.

Agendamento do Backup

1.Para agendar uma tarefa no XP, selecione as opções do menu “Iniciar > Configurações > Painel de Controle”. Localize o ícone relativo à opção “Tarefas Agendadas”. Dê duplo clique sobre o ícone.

2.Duplo clique sobre a opção “Adicionar tarefa agendada”.

3.Clique sobre o botão “Avançar”.

4.Localize e selecione o arquivo de lote, no diretório onde foi criado e clique sobre o botão “Abrir”.

5.Selecione a opção “Diariamente” e clique sobre o botão “Avançar”.

6.Altere as opções de horário, frequência de execução e data de início da tarefa e clique sobre o botão “Avançar”.

7.Informe usuário e senha sob qual a rotina será executada e clique sobre o botão “Avançar”.

8.Clique sobre o botão “Concluir”.

Referências:
    Blog do faraohh (Marcello)
    Redmine – Tutorial de Instalação no Windows

Por: André Dourado

Você gerencia projetos e precisa de uma ferramenta web, de fácil uso, flexível e adaptável ao seu dia a dia. Você precisa do Redmine.

Redmine é um flexível gerenciador de projetos desenvolvido para uso no ambiente web. Escrito utilizando o framework Ruby on Rails, é multi-plataforma e pode-se acessar várias bases de dados. A Página do projeto é: http://www.redmine.org

A seguir um tutorial de como instalá-lo no ambiente Windows. Não será necessário instalar nenhum pacote em seu Windows. Serão utilizadas versões que bastam ser copiadas no HD de sua máquina e executadas apenas quando necessário.

Requisitos

Servidor Rails: caso não tenha um servidor Rails disponível, uma boa opção é começar com o “Instant Rails”, que é uma solução que já traz Rails, Ruby, Apache e MySql pré-configurados e prontos para o uso. O pacote pode ser obtido no endereço: http://rubyforge.org/frs/?group_id=904

Para este tutorial foi utilizada a versão 2.0: http://rubyforge.org/frs/download.php/29867/InstantRails-2.0-win.zip

Pacote do Redmine: a última versão estável do Redmine pode ser obtida no endereço: http://rubyforge.org/frs/?group_id=1850

Para este tutorial foi utilizada a versão 0.7.3: http://rubyforge.org/frs/download.php/39478/redmine-0.7.3.zip

Instalação do Instant Rails

Existe um bug conhecido do Instant Rails, relacionado ao processo “unzip”. Apesar dos arquivos serem extraídos sem nenhum erro, a estrutura de diretórios resultante, apresenta-se corrompida.
O problema acontece quando o caminho do diretório resultante é maior que 260 caracteres. Extraindo o arquivo em um caminho mais curto, como por exemplo “c:\rails”, previne-se contra a ocorrência do problema.

1.Clique com o botão da direita sobre o arquivo zip do Instant Rails e selecione a opção “Extrair tudo…”. Ao abrir o “Assistente para extração” clique no botão “Avançar”. Na próxima tela, no campo de diretório de destino, digite “c:\rails”.

2.Para testar se está tudo ok com a instalação do Instant Rails, procure no diretório “c:\rails” o aplicativo “InstantRails”. Clique sobre o mesmo. O InstantRails identifica que houve a mudança do caminho de extração dos arquivos e pergunta se deseja alterar os arquivos de configuração.

Clique no botão “Ok”. Se tudo estiver ok, o Instant Rails deverá ser executado e a seguinte tela exibida.

Instalação do Redmine

1.Clique com o botão da direita sobre o arquivo zip do Redmine e selecione a opção “Extrair tudo…”. Ao abrir o “Assistente para extração” clique no botão “Avançar”. Na próxima tela, no campo de diretório de destino, digite “c:\rails\rails_apps”.

2.Para facilitar a navegação pelos diretórios do aplicativo, renomeie o diretório criado pelo Redmine de “redmine-0.7.3” para apenas “redmine”;

3.Copie o arquivo “config\database.yml.example” para “config\database.yml”. Neste tutorial utilizamos o banco de dados MySql, com o usuário “root” sem senha e será executado em nossa máquina local. Para este setup a seção “production:” do arquivo “database.yml”, deve ficar:

   production:
    adapter: mysql
    database: redmine
    host: localhost
    username: root
    password:
    encoding: utf8

4.Os próximos passos serão executados em linha de comando do Windows, para isso clique no botão iniciar do Windows. Clique em “Executar” e na linha de comando digite “cmd” e pressione a tecla “Enter”.

5.Mude para o diretório “c:\rails\mysql\bin” e digite o comando de execução do mysql para o usuário “root” no banco de dados mysql.

6.Crie a estrutura do banco de dados “redmine” com o comando:

    create database redmine character set utf8;

7.Saia do MySql digitando o comando “quit” e pressionando a tecla “Enter”.

8.Mude para o diretório do redmine “c:\rails\rails_apps\redmine”. Crie a estrutura do banco de dados “redmine”, digitando o comando:

    \rails\ruby\bin\rake db:migrate RAILS_ENV=production

Obs: em algums equipamentos obtive uma mensagem de erro, relacionada à não possibilidade de gravação no diretório TEMP/TMP, porém prossegui e nada de errado aparentemente ocorreu.

9.Insira os dados padrão de configuração no banco de dados, digitando o comando:

    \rails\ruby\bin\rake redmine:load_default_data RAILS_ENV=production

Ao ser solicitado para informar a língua desejada, digite “pt-br” e pressione a tecla “Enter”.

10.Inicie o servidor HTTP WEBrick, digitando o comando:

    \rails\ruby\bin\ruby script/server -e production

11.Após a inicialização do servidor WEBrick, acesse pelo seu browser a url “http://localhost:3000/login”. Se tudo estiver ok, será apresentada a tela de login do Redmine.

12.Utilize a conta padrão de administração para acessar o aplicativo. Login: admin e Senha: admin

13.Crie um atalho na área de trabalho do Windows para a execução do Redmine. Na área de trabalho do Windows, clique com o botão direito do mouse. Selecione a opção “Novo” e em seguida a opção “Atalho”.

No campo “linha de comando”, digite: “\rails\ruby\bin\ruby script/server -e production”. Clique no botão “Avançar”.

No campo nome do atalho digite “Redmine” e clique no botão “Concluir”. Clique sobre o atalho criado com o botão direito do mouse e selecione a opção “Propriedades”. No campo “Iniciar em”, digite: “c:\rails\rails_apps\redmine”. No campo “Executar”, selecione a opção “Minimizado”. Clique no botão “Ok”.

14.Crie um atalho na área de trabalho do Windows para a execução do “Intant Rails”. Utilizando o Windows Explorer localize no diretório “c:\rails” o aplicativo “IntantRails”. Clique sobre o arquivo com o botão direito do mouse, selecione a opção “Enviar para” em seguida selecione a opção “Área de Trabalho (criar atalho)”.

Pretendo escrever em breve outros tutoriais de configuração do Redmine, porém o uso do aplicativo é bem simples, permitindo que você comece a utilizá-lo sem maiores problemas.

Referências:
    Blog do faraohh (Marcello)
    Redmine – Installing Redmine