Requisitos do Sistema
Interpretador Ruby
A versão do Ruby necessária para o Redmine 3.4 é a seguinte:
| Versão do Redmine | Versões do Ruby Suportadas | Versão do Rails Utilizada |
|---|---|---|
| 3.4 | Ruby 1.9.3, 2.0.0, 2.1, 2.2, 2.3, 2.4 | Rails 4.2 |
Bancos de Dados Suportados
- MariaDB/MySQL: 5.5 a 5.7 (versões 5.0 e 5.1 também suportadas no Redmine 3.x).
- PostgreSQL: 9.2 ou superior (configurar o estilo de data para ISO no banco).
- SQLite 3: Apenas para ambientes de teste, não recomendado para produção com múltiplos usuários.
Componentes Opcionais
- Ferramentas SCM como
svnpara navegação em repositórios. - ImageMagick para exportação de diagramas Gantt em PNG e geração de miniaturas.
Passo 1: Download do Redmine
Desative o firewall temporariamente e baixe a versão 3.4.7 do Redmine:
systemctl stop firewalld
wget https://www.redmine.org/releases/redmine-3.4.7.tar.gz
tar xf redmine-3.4.7.tar.gz -C /opt/
cd /opt/redmine-3.4.7
Passo 2: Configuração do Banco de Dados
Instale o MariaDB e crie um banco de dados e usuário para o Redmine:
yum install mariadb-server mariadb-devel -y
systemctl start mariadb
mysql -u root -p
-- No prompt do MySQL, execute:
CREATE DATABASE redmine_bd CHARACTER SET utf8mb4;
CREATE USER 'rm_user'@'localhost' IDENTIFIED BY 'S3nh@F0rt3!';
GRANT ALL PRIVILEGES ON redmine_bd.* TO 'rm_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Passo 3: Ajuste do Arquivo de Configuração do Banco
Copie o arquivo de exemplo e edite as configurações de produção:
cp /opt/redmine-3.4.7/config/database.yml.example /opt/redmine-3.4.7/config/database.yml
vim /opt/redmine-3.4.7/config/database.yml
Modifique a seção de produção conforme abaixo:
production:
adapter: mysql2
database: redmine_bd
host: localhost
username: rm_user
password: "S3nh@F0rt3!"
encoding: utf8mb4
Passo 4: Instalação de Dependências
Instale as ferramentas necessárias e configure as gemas do Ruby:
yum install ImageMagick-devel ruby rubygems ruby-devel -y
gem sources --add http://mirrors.tuna.tsinghua.edu.cn/rubygems/
gem sources --remove https://rubygems.org/
gem install bundler
cd /opt/redmine-3.4.7
bundle install --without development test
Passo 5: Geração do Token de Sessão
Crie a chave secreta para o Rails:
cd /opt/redmine-3.4.7
RAILS_ENV=production bundle exec rake generate_secret_token
Passo 6: Migração do Esquema do Banco
Execute a migração para criar as tabelas. Se encontrar erro de tamanho de chave, aplique a correção a seguir:
cd /opt/redmine-3.4.7/config/initializers
cat > mysql_fix.rb << 'EOF'
require 'active_record/connection_adapters/abstract_mysql_adapter'
module ActiveRecord
module ConnectionAdapters
class AbstractMysqlAdapter
NATIVE_DATABASE_TYPES[:string] = { :name => "varchar", :limit => 191 }
end
end
end
EOF
cd /opt/redmine-3.4.7
RAILS_ENV=production bundle exec rake db:migrate
Passo 7: Carregamento de Dados Padrão
Insira os dados iniciais no banco de dados, selecionando o idioma preferido:
RAILS_ENV=production bundle exec rake redmine:load_default_data
# Escolha 'pt' para português ao ser solicitado
Passo 8: Permissões de Diretórios
Se o aplicativo não for executado como root, ajuste as permisões para os diretórios files, log, tmp e public/plugin_assets.
Passo 9: Teste Inicial do Servidor
Inicie o servidor WEBrick para verificação:
cd /opt/redmine-3.4.7
bundle exec rails server webrick -e production -b 0.0.0.0 -p 3000
Acesse http://endereço-do-servidor:3000 no navegador. O login padrão é admin com a senha admin.
Passo 10: Configurações Adicionais
Para habilitar o envio de e-mails, edite o arquivo de configuração:
cp /opt/redmine-3.4.7/config/configuration.yml.example /opt/redmine-3.4.7/config/configuration.yml
vim /opt/redmine-3.4.7/config/configuration.yml
Configure os parâmetros SMTP, por exemplo:
default:
email_delivery:
delivery_method: :smtp
smtp_settings:
address: smtp.provedor.com
port: 587
domain: provedor.com
authentication: :plain
user_name: "usuario@dominio.com"
password: "senha_email"
enable_starttls_auto: true
Reinicie o Redmine após quaisquer alterações para que entrem em vigor.