Redmine no Debian - Instalação e configuração
Este tutorial ensina como instalar o Redmine integrado com Git e usando o Passenger como servidor de aplicação, em sistemas Debian. Em sistemas Debian-like, como Ubuntu e Linux Mint, deve funcionar perfeitamente também.
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
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: "/var/www"
Prepare o sistema:
sudo gem install bundler mysql2
$ sudo aptitude install libmagickwand-dev libmysqlclient-dev
$ cd /var/www/redmine-2.3.2
Configure a conexão ao banco de dados.
Crie o arquivo "/var/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
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 /var/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 /var/wwwt/redmine-2.3.2
$ sudo ruby script/rails server webrick -e production
Agora no browser, abra o link:
- http://localhost:3000
E teste!
Só uma dica, colocar um ou dois parágrafos no início descrevendo um pouco para o que serve, auxiliaria para quando a pessoa não conhece a ferramenta, como eu neste caso hehe.
Entrei no site do projeto, sem problemas, mas explicar porque utilizar ela, ou no que auxilia, essas coisas.
Só sugestão mesmo.
Muito obrigado pela dica, instalação em andamento aqui.
Abraço