Rails &Redmine &Tutorial André Dourado em 16 fev 2009
Tutorial de Instalação do Redmine em Ambiente Windows+Apache+Mongrel+MySQL
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é DouradoProvavelmente 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
<Proxy *>
Order deny,allow
Allow from all
</Proxy>
Alias /redmine “C:/apache/htdocs/redmine/public”
<Directory “C:/apache/htdocs/redmine/public”>
Options Indexes FollowSymLinks
AllowOverride none
Order allow,deny
Allow from all
</Directory>
ProxyPass /redmine/images !
ProxyPass /redmine/stylesheets !
ProxyPass /redmine/javascripts !
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
Olá! Desde que coloquei o site 
em 16 mar 2009 às 13:48 1.ADSystems » WARR (Windows Apache Ruby Rails) - Tutorial de instalação escreveu …
[...] do autor: Antes de seguirem esse tutorial, recomendo que dêem uma olhada no tutorial “Tutorial de Instalação do Redmine em Ambiente Windows+Apache+Mongrel+MySQL“. Está mais completo e [...]
em 30 abr 2009 às 15:22 2.Rafael T Gomes escreveu …
André,
Parabéns pelo o tutorial, seguimos os passos para instalação do Redmine em uma máquina win32(XP) e funcionou perfeitamente,mas agora temos um novo desafio, que é a integração do nosso servidor Redmine win32 com outro servidor (linux – RedHat Enterprise) que contém o SVN instalado para controle de versão.
Seguimos o tutorial oficial do Redmine http://www.redmine.org/wiki/redmine/HowTo_configure_Redmine_for_advanced_Subversion_integration
mas não obtivemos sucesso.
Na minha percepção a integração para estas duas ferramentas parece ser mais tranquila quando as mesmas estão em um único ambiente, inclusive compartilhando o mesmo BD.
Você teria o caminho das pedras para solucionar fazer esta integração em ambientes distintos ?
Desde já agradeço.
em 04 mai 2009 às 20:18 3.André Dourado escreveu …
Caro Rafael,
obrigado pelos comentários. Talvez possa ajudar, mas uma dúvida você usou apache/mod_dav_svn/mod_perl
ou pam modules e nss para sua implementação?
O que efetivamente não funcionou? Alguma mensagem de erro?
Você já usa o SVN com outras aplicações ou é a primeira aplicação? Caso seja a primeira, já pensou em usar o GIT no lugar do SVN?
Poste suas respostas, vamos ver no que poderei ajudar.
Grande abraço,
André Dourado
em 12 mai 2009 às 09:33 4.Rafael T. Gomes escreveu …
Olá André,
primeiramente quero me desculpar na demora em responder,mas vamos lá com as dúvidas.
Minha intenção é fazer a integração entre o redmine e um repositório SVN já existente.
Depois de algumas pesquisas consegui fazer que o redmine acesse o meu repositório svn,porém somente para novos projetos cadastrados no redmine,para projetos que foram cadastrados não sendo especificado o local do svn, o redmine não habilita a possibilidade de edição.
Agora somente resta a dúvida…
Tem como fazer a edição do local do repositório em projeto do redmine já existente?
A propósito fiz o processo de autenticação e acesso por apache/mod_dav_svn/mod_perl e já utilizo o svn em outras aplicações.
Abraços
em 15 jun 2009 às 05:52 5.Rafael - Belém - 27 anos escreveu …
Muito Obrigado ! Salvou meu projeto aqui !
Deus te abençoe !
em 17 jun 2009 às 02:12 6.Rafael escreveu …
Obrigado prof ! Na Redmine aqui ficou beleza !
e no Radiant como faz ?
em 17 jun 2009 às 07:30 7.André Dourado escreveu …
Caro Rafael,
de nada. Estou aqui para o que precisar.
Em relação ao Radiant, sou usuário Joomla e não tenho experiência nenhuma no aplicativo. Mas siga a mesma lógica do Redmine. A filosofia por ser em Rails é a mesma.
Abraços,
André Dourado
em 17 jun 2009 às 17:39 8.Rafael - Belém - 27 anos escreveu …
Caro Prof. André, vou tentar instalar o radiant seguindo seu tutorial, pelo que entendi é um passo a passo para utilizar um servidor virtual num ambiente windows e assim utilizar o ruby on rails com banco de dados e todas as suas pontencialidades. Como estou iniciando em programação, configuração de servidores e banco de dados está sendo de grande ajuda. Estando aqui no norte do país fica dificil ($$$) ir ao eixão Rio-Sampa para fazer um curso decente nesta área. Eu estava usando o EasyPHP com o joomla e depois de bater muito a cabeça com o PHP para fazer mudanças em template e na configuração do joomla, realmente não me conquistou a linguagem, eu resolvi apostar no Ruby por N motivos. Até tentei utilizar o CakePHP mas tive novos problemas … Neste meio tempo aprendi um pouco de HTML, PHP, CSS, XML e quando descobri o Ruby nossa me empolquei com o que tds falam. Bom nesta area de servidores e banco de dados eu já estou vendo os problemas futuros que vou encontrar. No caso eu quero utilizar um VPS com servidor ubuntu e rails quando for lançar o site realmente no ar, o ambiente windows ainda uso pois estou fazendo a transisão para um sistema unix/linux aos poucos e assim o windows ainda esta ajudando no aprendisado deste novo mundo. Então eu peço alguma dica para me aprofundar no assunto como algums bons livros para comprar pela internet ou até mesmo baixar em pdf etc. As areas que pretendo estudar são servidores unix/ubuntu, ruby, rails, mysql, segurança em servidores e banco de dados e por aew vai. Faço engenharia mecanica e aprendi um pouco de Pascal, Fortran e Mathlab e está me ajudando muito para assimilar tudo isso. Desde já agradeço sua atenção e realmente fica aqui um sincero MUITO OBRIGADO pelo tutorial, no Brasil é otimo ver pessoas de bom coração que dividem conhecimento, se existem mais pessoas assim a educação deste pais passaria para um outro nivel ! Grande Abraço e Sucesso !
em 17 jun 2009 às 23:07 9.André Dourado escreveu …
Caro Rafael,
mais uma vez obrigado pelas palavras.
Não sei se chegou a ir ao meu site (www.adsystems.com.br).
Meu blog na verdade é um repositório de artigos (em geral um CTRL+C, CTRL+V como diz um amigo) do que vou encontrando pela web sobre os assuntos que me interessam.
Nunca tive a intenção de ter um blog autoral, mas adoro escrever tutoriais. Acho realmente que o conhecimento deve ser compartilhado da melhor forma possível.
No site, você encontrará meu repositório de links sobre diversos assuntos.
Livros…hoje prefiro versões eletrônicas de livros, papers e revistas. Acho muita informação já criticada e avaliada por colegas com muito mais experiência. Em se tratando de Ruby on Rails, nosso especialista brasileiro é o Fábio Akita (http://akitaonrails.com/). Aconselho que dê uma boa olhada no blog dele, já que vi que se interessa por Rails.
Sempre que tiver qualquer dúvida, por favor fique a vontade para entrar em contato.
A propósito, também sou do Norte. Sou paraense da gema. Moro em Belém, apesar de já ter morado em diversos lugares pelo Brasil. Compreendo suas dificuldades, por terem sido as mesmas minhas, mas depois do advento YouTube e Google Video temos a oportunidade de assistir a diversos eventos que antes certamente seriam difícieis de participarmos.
Bem amigo, estou a sua disposição.
Abraços,
André Dourado
em 18 jun 2009 às 12:59 10.Rafael - Belém - 27 anos escreveu …
Beleza Prof. André ! Vou explorar seu blog/site e também o do Akita ! Pretendo fazer o curso da E-Genial sobre Rails e também adquirir os livros do Akita e Urubatan da Novatec e seguir em frente ! Que bom que és conterrâneo ! Sou um carioca erradicado aqui tem uns 7 anos sendo paraense de coração, aquela maxima é valida tomou açaí ficou ! Hehehe ! O terra boa !
Sem duvida as video aulas pela internet ajudam demais, já assisti um monte ! Penso em até me especializar mais pegando umas cadeiras na UFPA de engenharia de computadores. Vou ficando por aqui e seguimos mantendo contato !
Grande abraço do amigo
Rafael Correia
em 30 ago 2009 às 15:22 11.Ricardo escreveu …
Olá André Dourado!
Eu utilizo o WampServer (Windows+Apache+Mysql+Php) e quero ingressar no mundo do RoR… A instalação neste caso, compartilhada com o WampServer deve ser a mesma?
Não haverá problemas com minha instalação WampServer?
Abração!
em 01 set 2009 às 07:08 12.André Dourado escreveu …
Caro Ricardo,
acredito que não haverá problema no compartilhamento do uso, porém nunca utilizei o Wampserver.
Basicamente deveria pular os passos de instalação do Apache e do MySql, seguindo apenas os passos de configuração que atendam ao ROR.
Mas se está ainda em período de avaliação do ROR, já pensou em usar uma opção temporária? Já ouviu falkar do InstantRails. Nesse tutorial explico como instalá-lo:
http://blog.adsystems.com.br/2008/10/11/redmine-%e2%80%93-tutorial-de-instalacao-no-windows/
Talvez seja uma opção. Esse tutorial aqui seria para um ambiente de produção Rails.
Abraços,
André Dourado
em 14 jan 2010 às 14:12 13.Cintia Reis escreveu …
Olá André,
Segui os passos anterior, só que na parte de digitar os comandos para configurar o redmine não está dando. A partir do numero 8. que é para Criar a estrutura do banco de dados “redmine”, digitando o comando:
\ruby\bin\rake db:migrate RAILS_ENV=production
a resposta que ele dá é: ruby.exe não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes.
Como devo proceder? Já tem é horas que estou tentando instalar tudo direitim como você fala e até agora não conseguir!
Cíntia Reis
em 14 jan 2010 às 15:11 14.André Dourado escreveu …
Oi Cíntia,
para que esteja acontecendo isso, provavelmente o caminho onde o ruby está instalado não é o mesmo que utilizei no tutorial.
No passo 4 informo o caminho “c:\ruby” para a instalação do ruby.
Verifique também se o caminho “c:\ruby\bin” está no seu path. Isso pode ser verificado digitando na linha de comando “set” e pressionando o enter. Procure a variável path e veja se o caminho está lá. Caso não esteja, sugiro que acrescente em: “iniciar > Configurações > Painel de Controle > Sistema > Avançado > Variáveis de Ambiente. Edite PATH nas variáveis de sistema, acrescentando o caminho “c:\ruby\bin”
Espero que ajude.
Abraços,
André
em 14 jan 2010 às 16:46 15.Cintia Reis escreveu …
Ok André, fiz o que me falou e deu certo!
Mais agora parei na linha 11.Inicie o serviço, digitando o comando:
net start Redmine
a resposta que ele dá é: net não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes.
Cíntia Reis
em 14 jan 2010 às 18:01 16.Cintia Reis escreveu …
Nessa parte de configurar o Apache eu crio um arquivo txt com esse nome= http-proxy-redmine.conf no caminho= c:\apache\conf\ e coloco dentro do arquivo o codigo que você falou certo?
Ai vou no arquivo httpd.conf e acrescento a linha mencionada no final do arquivo certo?
Só que quando add o include o apache nao conecta mais, ele fala: could not open configuration file c:/apache/conf/http-proxy-redmine.conf: o sistema nao pode encontrar o arquivo especificado.
Cintia Reis
em 20 out 2010 às 08:13 17.Walmir escreveu …
Olá pessoal.. estou com uma duvida..eu faço tudo o que diz no tutorial e para antes de configurar o proxy no apache e ate ai funciona tudo perfeito..só q nao consigo acessar o redmine de outras maquinas.. todas elas estao na mesma rede e nao tem acesso.
O que eu faço?
Já segui a parte de configurar o proxy e testar o remdine com o proxy só q qdo o redmine é acessado por htt://localhost/redmine/login só aparece como se estivesse em html e sem imagem nenhuma, e qdo coloco login e senha para entrar nao acontece nada.
Estou instalando o ruby 186-27 o rails 2.3.5 e o redmine 1.0.2.
Preciso da ajuda de vcs..
Desde ja muito obrigado
em 01 mai 2011 às 17:25 18.eric escreveu …
Oi André,
Desculpa reviver um tópico antigo, mas estou com problemas na instalação do redmine no passo: Configuração do Apache, onde cria o arquivo http-proxy-redmine.conf
Eu alterei os campo:
Alias /redmine “C:/apache/htdocs/redmine/public”
PARA:
Alias /redmine “E:/webserver/apache2.2/htdocs/redmine/public”
e fiz a inclusão na ulitma linha do arquivo httpd.conf
Porem o apache nâo starta mais.. Alguma dica?
Obrigado