Redmine – Gerenciador de Projetos – Como instalar

Ótimo programa para gerenciar projetos em equipe de maneira #maisagil.

Não tenho idéia do quanto este tutorial possa parecer complicado, mas lendo a Documentação Oficial sobre a Instalação do Redmine eu mesmo me vi perdido nela, pois para mim pareceu que algo estava fora de ordem e não foi muito intuitiva. Foi um pouco diferente, confesso, pois na primeira vez que instalei ele foi em um Servidor CentOS e devido eu precisar Gerenciar projetos de uma forma mais organizada e não depender tanto de uma conexão com a internet, assim como eu precisava com a última ferramenta que utilizava, decidi então instalar o Redmine em meu próprio micro.

Neste nada pequeno tutorial, eu instalei o Redmine diretamente de seu repositório, desta forma, estou com a última versão disponível do mesmo
A distribuição usada foi o Ubuntu 9.10 – Karmic Koala.

Passo-a-passo de instalação do Redmine

1. Vamos preparar a instalação do Redmine com as dependências necessárias:
   

   sudo aptitude update && sudo aptitude install build-essential sudo apt-get install ssh openssh-server mysql-server phpmyadmin rails rubygems mongrel ruby1.8-dev libmysql-ruby subversion apache2 ruby irb rdoc rake libapache2-mod-fastcgi

   Devido a este tutorial já ser um tanto quanto longo, não descreverei os passos da configuração no Servidor MySQL (usuário e senha) partindo da premissa de que os leitores já saibam como fazê-lo.

2. Em minha instalação eu criei uma pasta específica para o Redmine já fazendo um checkout da última versão diretamente do repositório, isso de dentro da pasta criada no passo anterior:
   

   cd /var/www
   sudo svn checkout http://redmine.rubyforge.org/svn/trunk redmine

3. Usando o MySQL, criarei agora o Banco de Dados necessário para a aplicação:
   • Acessar o mysql (Note que em minha configuração do MySQL eu uso o usuário root para acesso, isso pode estar diferente em sua instalaço:
     

     $ mysql –user root –password
     Enter password:
     Welcome to the MySQL monitor. Commands end with ; or g.
     Your MySQL connection id is 60
     Server version: 5.1.37-1ubuntu5 (Ubuntu)

     Type ‘help;’ or ‘h’ for help. Type ‘c’ to clear the current input statement.

     mysql>

   • Criando o banco de dados (O texto em negrito é o comando, o que está logo abaixo é o resultado que você deve visualizar se a peração for concluída com sucesso):
     

     create database redmine character set utf8;
     Query OK, 1 row affected (0,06 sec)

   • Com o comando abaixo, criaremos o usuá e definiremos sua senha (Neste a nomenclatura é um pouco diferente, a primeira linha é o comando a ser executado, nesta os textos que estão; em negrito correspondem ao seu usuário e senha desejados, abaixo dela o texto em itálico é o resultado que deverá ser visto.:
     

     create user ‘redmine‘@’localhost’ identified by ‘my_password‘;
     Query OK, 0 rows affected (0,04 sec)

   • O último passo no MySQL agora é conceder os privilégios para o usuário criado no banco de dados anteriormente criado:
     

     grant all privileges on redmine.* to ‘redmine’@'localhost’;
     Query OK, 0 rows affected (0,04 sec)

   Após isso podemos sair do Mysql digitando “exit“.

4. Vamos fazer uma cópia do arquivo de exemplo de configuração do Redmine e configurá-lo para que o mesmo possa acessar nosso banco de dados:
   

   sudo cp config/database.yml.example config/database.yml

   Altere as seguintes linhas de acordo com as configurações que fizemos previamente:

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

5. Logo após a criação do banco de dados faça um:
   

   sudo rake generate_session_store

6. A documentação oficial instrui para criar a estrutura do banco de dados com o comando abaixo:
   

   sudo rake db:migrate RAILS_ENV=”production”

   Mas tive a seguinte mensagem de erro:

   (in /var/www/redmine)
   Missing the Rails 2.3.5 gem. Please `gem install -v=2.3.5 rails`, update your RAILS_GEM_VERSION setting in config/environment.rb for the Rails version you do have installed, or comment out RAILS_GEM_VERSION to use the latest version installed.

   Fiz então conforme a instrução contida na própria mensagem (O comando é um tanto quanto demorado em sua execução, não cancele-o):

   sudo gem install -v=2.3.5 rails

   A mensagem após isso será esta:

   Successfully installed rails-2.3.5
   1 gem installed
   Installing ri documentation for rails-2.3.5…
   Installing RDoc documentation for rails-2.3.5…

   Novamente vamos para o comando:

   sudo rake db:migrate RAILS_ENV=”production”

   Quase acabando… execute o seguinte comando dentro do diretório do Redmine:

   sudo RAILS_ENV=production rake db:migrate

   Inserir a configuração padrão no banco de dados com o comando abaixo (note que neste ponto definiremos o idioma, conforme pode ser visto na saida do comando que deixo aqui registrada

   sudo RAILS_ENV=production rake redmine:load_default_data
   (in /var/www/redmine)
    
   Select language: bg, bs, ca, cs, da, de, el, en, es, eu, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, nl, no, pl, pt, pt-BR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh, zh-TW [en]

   Após definirmos o idioma digitando “pt-BR” e pressionarmos “ENTER” esta será a mensagem:

   ====================================
   Default configuration data loaded.
   

7. O usuário que for executar o Redmine precisa de permissões de acesso garantidas para algumas pastas e sub-pastas, para fazer isso (Substitua, obviamente onde eu exemplifico com “felix.felix” pelo seu próprio usuário.grupo):

   sudo chown felix.felix files/ -R
   sudo chown felix.felix log/ -R
   sudo chown felix.felix tmp/ -R
   sudo chown felix.felix public/plugin_assets/ -R
   sudo chmod 755 files/ -R
   sudo chmod 755 log/ -R
   sudo chmod 755 tmp/ -R
   sudo chmod 755 public/plugin_assets/ -R
   

8. E para finalmente testar sua instalaçã execute o servidor WEBrick:
   

   ruby script/server webrick -e production

   Você verá algo assim em seu terminal:

   => Booting WEBrick
   => Rails 2.3.5 application starting on http://0.0.0.0:3000
   => Call with -d to detach
   => Ctrl-C to shutdown server
   [2010-02-07 23:51:46] INFO WEBrick 1.3.1
   [2010-02-07 23:51:46] INFO ruby 1.8.7 (2009-06-12) [i486-linux]
   [2010-02-07 23:51:52] INFO WEBrick::HTTPServer#start: pid=8590 port=3000

Feito isso, em seu navegador acesse a URL:

 http://localhost:3000

A conta padrão de administrador é:
login: admin
senha: admin

Página oficial do projeto

---

Como disse no princípio, o tutorial ficou um tanto quanto longo e não sei se ficou fácil de compreendê-lo da maneira que eu desejava, por isso peço um feedback de você leitor que tenha se interessado pela instalação deste excelente gerenciador de projetos desenvolvido em RoR que é o Redmine, deixe seu comentário no post com sua dúvida ou sugestão.