Redmine no Debian – Instalação e configuração

Instalação

Pré-instalação

É provável que os pacotes citados abaixo estejam instalados, mas se não estiverem, instale.

Instale os requisitos de funcionamento, como servidor WEB, banco de dados, OpenSSL, pacotes para compilar:

$ sudo aptitude install gcc build-essential zlib1g zlib1g-dev zlibc libzlib-ruby libssl-dev libyaml-dev libcurl4-openssl-dev apache2-mpm-prefork apache2-prefork-dev libapr1-dev libxslt-dev checkinstall libyaml-0-2

Ruby – baixe e compile (atenção, execute cada linha de comando por vez):

$ cd ~
$ wget
 ftp://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p448.tar.gz
$ tar xvfz ruby-1.9.3-p448.tar.gz
$ cd ruby-1.9.3-p448
$ ./configure –enable-pthread –prefix=/usr/local
$ make
$ sudo make install

Teste o funcionamento do Ruby:

$ ruby -v

Deve aparecer um saída parecida com essa:

ruby 1.9.3p194 (2012-04-20 revision 35410) [x86_64-linux]

Adicione o suporte OpenSSL ao Ruby:

$ cd ext/openssl/
$ ruby extconf.rb
$ make
$ sudo make install

O Ruby 1.9 vem com a RubyGems, por padrão. Use o seguinte comando para verificar se ela está corretamente instalada:

$ gem -v

Deve aparecer na saída um número de versão semelhante a: 1.8.23

Instalando “zlib”:

$ cd ruby-1.9.3-p448/ext/zlib/
$ ruby extconf.rb
$ make
$ sudo make install

Instalando o Rails:

$ sudo gem install rails

Instalando o Passenger (servidor de aplicação):

$ sudo gem install passenger
$ sudo passenger-install-apache2-module

Apache

Configurando o Apache: insira o seguinte código no arquivo “/etc/apache/apache2.conf”:

LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.10/buildout/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.10
PassengerDefaultRuby /usr/local/bin/ruby

Instalando o Redmine

Baixe o Redmine neste link:

Obs.: descompacte o arquivo em: “/home/viaza132/www”

Prepare o sistema:

$ sudo gem install bundler mysql2
$ sudo aptitude install libmagickwand-dev libmysqlclient-dev
$ cd /home/viaza132/www/redmine-2.3.2

Configure a conexão ao banco de dados.

Crie o arquivo “/home/viaza132/www/redmine-2.3.2/config/database.yml” e insira o seguinte conteúdo nele:

production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: passwd

$ sudo bundle install –without postgresql

Crie o banco de dados.

Abra um console de conexão com seu banco de dados MySQL e execute os seguintes comandos:

mysql -> create database redmine character set utf8;
mysql -> create user ‘redmine’@’localhost’ identified by ‘passwd’;
mysql -> grant all privileges on redmine.* to ‘redmine’@’localhost’;

P.S.: para conectar ao MySQL via console, use o comando:

$ mysql -u root -psenha   # Substitua a palavra “senha” pela sua senha de root

Configurações finais

Crie um token de sessão:

$ sudo rake generate_secret_token

Defina o ambiente de trabalho e crie as tabelas do BD:

$ sudo RAILS_ENV=production rake db:migrate

Fixe as permissões para garantir o correto funcionamento:

$ cd /home/viaza132/wwwt/redmine-2.3.2
$ sudo mkdir tmp tmp/pdf public/plugin_assets
$ sudo chown -R www-data:www-data files log tmp public/plugin_assets
$ sudo chmod -R 755 files log tmp public/plugin_assets

Testando se funcionou:

$ cd /home/viaza132/wwwt/redmine-2.3.2
$ sudo ruby script/rails server webrick -e production

Agora no browser, abra o link:

  • http://localhost:3000

E teste!

Configuração

Configurando Apache e Passenger

Execute:

$ cd /etc/apache2/sites-available
$ vim redmine

O último comando irá abrir um arquivo novo para edição. Dentro dele, insira o seguinte conteúdo, alterando “DocumentRoot e Directory” conforme suas configurações:

<VirtualHost *:80>
ServerName www.meudominio.com
# !!! Be sure to point DocumentRoot to ‘public’!
DocumentRoot /home/viaza132/www/redmine/public
<Directory /home/viaza132/www/redmine/public>
# This relaxes Apache security settings.
AllowOverride all
# MultiViews must be turned off.
Options -MultiViews
</Directory>
</VirtualHost>

Reinicie o Apache:

$ sudo service apache2 restart

Agora teste se o endereço está funcionando:

  • http://www.meudominio.com

Configurando o Git

Dentro do diretório raiz, crie um diretório chamado “git_repositories”:

# cd /home/viaza132/www/redmine-2.3.2
# mkdir git_repositories

Instale o Git:

# aptitude install git git-cvs

Dê as permissões necessárias para que o Git possa executar:

# chown git.git /var/redmine/git_repositories
# cd git_repositories/
# git clone –bare git://github.com/ook/donebox.git

O resultado com este último comando, deve ser algo como:

Initialized empty Git repository in /var/redmine/git_repositories/donebox/
remote: Counting objects: 401, done.
remote: Compressing objects: 100% (246/246), done.
remote: Total 401 (delta 134), reused 401 (delta 134)
Receiving objects: 100% (401/401), 179.55 KiB | 185 KiB/s, done.
Resolving deltas: 100% (134/134), done.

Pronto! Agora vá no seu projeto:

  • Na parte de repositórios, escolha: Git
  • E coloque o caminho para o Git logo abaixo e salve-o: /var/redmine/git_repositories/donebox/

Atenção: este tutorial funciona para a configuração de apenas um Redmine no servidor. Para configuração de múltiplas instalações, sugiro pesquisar o funcionamento da ferramenta Mongrel Cluster.

Rolar para cima