Manual Redmine

  • View
    306

  • Download
    2

Embed Size (px)

Text of Manual Redmine

  • Manual do Redmine

    Software para Gerenciamento de

    Projetos

    Marcello Henrique Dias de MouraRenato de Paula Mesquita Caroline da Cunha Mota

    Goiania, 19 de Fevereiro de 2009

  • Sumario

    1

  • Lista de Figuras

    2

  • Captulo 1

    Guia de Instalacao

    1.1 Instalando Redmine

    1.1.1 Requerimentos

    Sistemas operacionais

    Redmine deveria rodar em sistemas Unix, Linux, Mac e Windows assim comoruby esta disponvel para essa plataformas.

    Ruby & Ruby on Rails

    As necessidades das versoes do Rails para as versoes do Redmine para quefuncione a contento sao:

    Versao do Redmine Verao Suportada Ruby Versao necessaria do Railscurrent trunk ruby 1.8.6, 1.8.7 Rails 2.2.2

    trunk before r2493 ruby 1.8.6, 1.8.7 Rails 2.1.20.8.x ruby 1.8.6, 1.8.7 Rails 2.1.20.7.x ruby 1.8.6 Rails 2.0.2

    Liberacoes oficiais incluem a versao apropriada do Rails em seus diretoriosexpecficos. Portanto, nao e necessaria uma acao especfica. Se voce baixaros fontes de um repositorio Redmine, voce pode instalar uma versao do Railsespecfica na sua maquina rodando:

    gem install rails -v=2.1.2

    Notas:

    RubyGems 1.3.1 e necessario Rake 0.8.3 e necessario

    3

  • Base de dados

    MySQL 4.1 ou mais novo (recomendado) PostgreSQL 8 SQLite 3Se voce esta usando banco de dados MySQL, tem certeza de instalar o C

    bindings que melhora a permformace dramasticamente. Voce pode obte-lo ro-dando gem install mysql

    Componentes opcionais

    SCM binarios (eg. svn), para navegar no repositorio (deve estar disponvelem seu PATH) Veja [[BrRedmineRepositories]] para compatibilidade necessariado SCM.

    RMagick (para permitir exportar imagem png do grafico de Gantt)

    1.1.2 Instalacao

    1. ?? e extraia os arquivos do ??.

    2. Criar um banco de dados vazio chamado redmine por exemplo. ParaMySQL:

    create database redmine character set utf8;

    3. Copiar config/database.yml.example para config/database.yml e ed-itar este arquivo na ordem para configurar as definicoes da sua base dedados no ambiente production.

    Exemplo para uma base de dados MySQL:

    production:adapter: mysqldatabase: redminehost: localhostusername: bduserpassword: bdpasswd

    4. Criar uma estrutura na base de dados, rodando o seguinte comando nodiretorio raiz da sua aplicacao:

    rake db:migrate RAILS_ENV="production"

    Isto vai criar as tabelas e a conta de administrador.

    5. Inserir configuracao de dados padrao na base de dados, rodando o seguintecomando:

    4

  • rake redmine:load_default_data RAILS_ENV="production"

    Este passo e opcional porem e altamente recomendado, como vocepode definir sua configuracao do scratch. Isso vai carregar as regras, tipos,estatus, workflows e numeracoes.

    6. Definindo permissoes Nota: Usuarios windows podem pular essa sessao.

    O usuario que rodar Redmine deve ter permissao de escrita nos seguintediretorios: files, log, tmp (criando o ultimo se nao existir).

    Assumindo que voce rodou Redmine com usuario redmine:

    mkdir tmpsudo chown -R redmine:redmine files log tmpsudo chmod -R 755 files log tmp

    7. Testando a instalacao rodando o servidor web WEBrick:

    ruby script/server -e production

    Uma vez WEBrick iniciado, aponte seu navegador para http://localhost:3000/.Voce deveria ver a pagina de boas vindas da aplicacao.

    8. Use a conta de administracao padrao logando assim:

    * login: admin* password: admin

    Voce pode ir para Admin & Settings para modificar as configuracoes daaplicacao.

    1.1.3 Configurando servico SMTP

    Liberacoes 0.8.x

    Copie config/email.yml.example para config/email.yml e edite esse arquivopara ajustar as definicoes do seu servico SMTP.

    Liberacoes 0.7.x

    Em config/environment.rb, voce pode definir parametros so seu servidor SMTP:

    * config.action_mailer.smtp_settings: SMTP server configuration

    * config.action_mailer.perform_deliveries: set to false to disable mail delivering

    Nao se esqueca de reiniciar sua aplicacao depois da mudanca.

    5

  • 1.1.4 Backups

    Backups do Redmine deveria incluir:

    * dados (alocados na sua base de dados)* anexos (alocados no seu diretorio files)

    Aqui temos um simples script em shell que pode ser usado para fazer back-ups diariamente (assumindo que voce esteje usando uma base de dados mysql):

    1 # Dados2 / usr /bin /mysqldump u p | gz ip

    > /path/ to /backup/db/ redmine date +%y %m %d . gz3 # Anexos4 rsync a /path/ to / redmine/ f i l e s /path/ to /backup/ f i l e s

    1.2 Atualizando

    1.2.1 Atualizando de um repositorio SVN

    Antes de atualizar, verifique se voce tem todos os ?? para versao que voce queratualizar.

    1. Va ate o diretorio Redmine e rode o seguinte comando:

    svn update

    2. Migrando sua base de dados (por favor, faca um backup da sua base dedados antes de executar isso):

    rake db:migrate RAILS_ENV="production"

    3. Limpe o cache e sessoes existentes:

    rake tmp:cache:clearrake tmp:sessions:clear

    4. Reinicie a aplicacao e vai ate Admin > Roles & permissions paraverificar/definir as permissoes para as novas funcionalidades, se existir.

    1.2.2 Atualizando de uma liberacao baixada

    1. Descompacte o novo arquivo no seu novo diretorio.

    2. Copie as definicoes do seu banco de dados config/database.yml para dentrodo seu novo diretorito config.

    3. Copie config/email.yml.example para config/email.yml e edite este arquivopara ajustar suas configuracoes SMTP.

    6

  • 4. Va para seu novo diretorio redmine, e faca a migracao da sua base dedados (por favor, faca um backup da sua base de dados antes de executarisso):

    rake db:migrate RAILS_ENV="production"

    5. Copie o conteudo do diretorio RAILS ROOT/files para sua nova insta-lacao.

    6. Inicie a aplicacao e va ate Admin -> Roles & permissions e verifique/de-fina as permissoes para as novas funcionalidades, se existir.

    1.3 Migrando de outros sistemas

    1.3.1 Trac

    O Trac importamos na migracao:

    Usuario Componentes Versoes (Milestones) Tquetes Comentario dos tquetes e mudancas (estatus e resolucao) Colunas especficas no Trac (Ex. Resolution) e adicionado como colunas

    customizados no Redmine

    Arquivos dos Tquetes e customizacoes de colunas Paginas Wiki e historico

    Notas:

    1. Senhas dos usuario sao todas definidas no trac

    2. Identificacao dos tquetes sao preservadas se nao ainda nao houver tquetesna base de dados do Redmine

    3. Customizacao de colunas sao todas criadas como texto customizado noRedmine

    Voce necessita do sqlite-ruby gem (gem install sqlite-ruby) para acessar abase de dados do Trac.

    Antes de iniciar, voce precisa de uma base de dados fresca do Redmine,carregando o banco de dados padrao (requerimento). Veja ??

    O script foi testado com o banco de dados sqlite do Trac 0.10 e deveriafuncionar com a base de dados do Trac 0.11.

    1. Rodando o seguinte comando, onde test e sua marca do ambiente Redmine:

    7

  • rake redmine:migrate_from_trac RAILS_ENV="test"

    2. O script te perguntara sobre suas configuracoes do Trac:

    Trac directory []: /var/trac/myprojectTrac database adapter (sqlite, sqlite3, mysql, postgresql) [sqlite]:Database encoding [UTF-8]:Target project identifier []: myproject

    O diretorio do Trac e o diretorio raiz do seu ambiente Trac. O Redminevai procurar neste diretorio por db/trac.db (se voce escolher base dedados sqlite/sqlite3) e o diretorio attachments. Usando uma base dedados mysql ou postgresql, o script vai perguntar as informacoes paraconexao (host, nome do banco, nome do usuario e senha). O Identificadordo projeto e o identificar do projeto Redmine no qual os dados vao sercarregados (o projeto e criado se nao encontrado).

    3. O script migrando seus dados:

    Deleting dataMigrating components..............................Migrating milestones..............Migrating custom fields.......Migrating tickets.................................Migrating wiki...........

    Components: 29/30Milestones: 14/14Tickets: 1275/1275Ticket files: 106/106Custom values: 4409/4409Wiki edits: 102/102

    O script informa o numero total dos objetos migrados. Agora, voce deveriaver um projeto chamado Myproject no Redmine com seus dados do Traccarregados neste projeto.

    1.3.2 Mantis

    O Mantis importamos na migracao:

    Usuarios Projetos Versoes do Projeto, categorias e notcias Afiliacoes do Projeto

    8

  • Bugs Notas do Bug, arquivos, relacoes e monitores Customizacao de colunas

    Senha dos usuario sao todas definidas no mantis.Migracao de arquivos de Bug somente funcionam se eles estiverem armazena-

    dos no seu banco de dados Mantis (Iste e o comportamento padrao do Mantis).O script foi testado com diferentes bancos de dados Mantis 1.0.x e deveria

    funcionar com outras versoes recentes.Antes de iniciar, voce precisa de uma base de dados fresca do Redmine,

    carregando o banco de dados padrao (requerimento). Veja ??

    1. Rodando o seguinte comando, onde test e sua marca do ambiente Redmine:

    rake redmine:migrate_from_mantis RAILS_ENV="test"

    2. O script te perguntara sobre suas configuracoes do Mantis:

    Please enter settings for your Mantis databaseadapter [mysql]:host [localhost]:database [bugtracker]: mantisusername [root]:password []:encoding [UTF-8]:

    Forneca o adaptador, nome do host, nome da base de dados, login, senhae codificacao de caracteres do seu Mantis, ou deixe as configuracoes dosvalores por omissao.

    O adptador pode ser mysql (por omissao) ou postgresql.

    3. O script migrando seus dados:

    Migrating users...............Migrating projects.............Migrating bugs......................