Instalação do Mantis

Mantis é um sistema de gerenciamento de erros (bugtracker) escrito em php para trabalhar com banco de dados MySQL, MS SQL ou PostgreSQL e com servidor Web. Algumas pessoas também usam este sistema como ferramenta administrativa de conteúdo de funções de funcionários. É GPL !!!
Pode ser instalado em Linux, Windows, Mac OS, OS/2 e outros.O acesso ao sistema é através de seu browser preferido (Firefox, é claro :-D ) .
Tem versão traduzida para o português (brasil) e mais 67 linguagens.
Trabalhamos separado por projetos, podemos ter sub-projetos e categorias, os usuários podem ter diferentes níveis de acesso, temos vários filtros e relatórios, podemos criar campos, anexar arquivos, enfim, várias características importantes para um bom gerenciamento.
Veja mais características: http://www.mantisbt.org/wiki/doku.php/mantisbt:features

Como dependência para a instalação do Mantis, temos a famosa Tríade:

MySQL - 3.23.2 ou maior
PHP - 4.0.6 ou maior
Web Server - Apache ou IIS(urgh!.. fique com a primeira opção)

Seu processo de instalação é fácil, não requer conhecimento de php, apenas algum conhecimento de MySQL.

Queres instalar no Linux ? Siga os passos:

Da página oficial fazemos o download a última versão instável para sua pasta padrão
http://www.mantisbt.org/download.php
Exemplo: mantis-1.0.8.tar.gz

Descompactamos através do comando:

# tar -zxvf mantis-1.0.8.tar.gz

Será criada uma pasta com o nome mantis-versão, no caso mantis-1.0.8

Mova esta pasta para diretório de instalação e uso de seu servidor Web, no caso do Apache, a localização do conteúdo, normalmente é /var/www/html/ ou var/www/. Aproveite e coloque com o nome mantis para facilitar.
Exemplo:

# mv mantis-1.0.8 /var/www/mantis

Vi em documentações que bastava acessar esse diretório via web e preencher a tela, mas encontrei alguns problemas por causa do sql, então para facilitar aconselho a entrar no mysql e criar o banco de dados, o usuário para administração e seus privilégios.
Obs.: é necessário a senha do usuário root do banco, ou usuário com privilégios de root
Entre no mysql

# mysql -u root -p
Enter password: *****
#mysql> create database bugtracker;
(cria o banco de dados bugtracker)

#mysql> GRANT ALL PRIVILEGES ON bugtracker.* to mantisadm@localhost;
(dá direitos para o usuário que eu quero usar como administrador deste banco, no caso usei mantisadm)

#mysql> SET PASSWORD FOR 'mantisadm'@localhost=PASSWORD('senha');
(Senha para o meu usuário mantisadm, em senha coloque a sua)

# mysql> FLUSH PRIVILEGES;
(Confirma os privilégios)

#mysql> quit;
(Sai do Mysql)

Agora entre pelo seu browser em http://localhost/mantis (lembrando que localhost é o endereço do servidor web onde foi instalado). Automaticamente será direcionado para http://localhost/mantis/admin/install.php que carregará a tela de entrada de dados iniciais para a criação das tabelas e pré-configuração do sistema Mantis. Lembre que Admin Username e Admin Password são as informações do usuário administrador criado no MySQL, no nosso caso, mantisadm.

Agora a tela é auto-explicativa. Se tudo acima foi feito corretamente não terá problemas, e finalizará mostrando o link Continue para tela inicial.

Antes de entrar:

• Acertar a linguagem para o nosso português, para isto altere a variável p_lang no arquivo mantis/core/lang_api.php no seu editor de texto trocar

function lang_get($p_string, $p_lang = null ) por
function lang_get($p_string, $p_lang = 'portuguese_brazil')

• Um arquivo de configuração será criado na pasta mantis, o config_inc.php, altere e acrescente algumas varíaveis para facilitar ( o arquivo config_inc.php.sample tem um exemplo). No nosso caso, alterei o usuário administrador deste banco, pois por default utiliza o usuário root do Mysql e acertei as variáveis de envio de e-mail. Ficou mais ou menos assim:
  
  $g_hostname = 'localhost';
  $g_db_type = 'mysql';
  $g_database_name = 'bugtracker';
  $g_db_username = 'mantisadm';
  $g_db_password = 'senha';
  # --- variáveis de e-mail -------------
  $g_administrator_email = 'adminmantis@provedor.com.br';
  $g_webmaster_email = 'webmaster@provedor.com.br';
  # Campo "De" do e-mail
  $g_from_email = 'adminmantis@provedor.com.br'';
  # Endereço de retorno do e-mail
  $g_return_path_email = 'adminmantis@provedor.com.br'';

Agora podemos recarregar a tela inicial http://localhost/mantis/ (localhost=endereço servidor web)
O usuário padrão que é criado automaticamente para uso do sistema é administrator com a senha root. Entre com este usuário no primeiro acesso, pois o resto de sua configuração é feita somente pelo browser, bem simples e prático.

Resolvendo os avisos da tela inicial.

• WARNING: You should disable the default "administrator" account or change its password.
  Troque a senha inicial do usuário administrator em Gerenciar usuários.
• WARNING: Admin directory should be removed.
  Remova o diretório admin dentro pasta mantis, pois este foi utilizado para a criar as tabelas e na configuração inicial do sistema.

Dica: antes de liberar para uso, crie seu(s) projeto(s), adicione sub-projeto(s) e categorias do projeto. Isto é importante, pois ao relatar um caso o usuário escolhe o projeto e a categoria. Como exemplo de categoria sugiro: Erro e Melhoria. (obs.: adiciono a categoria dentro do próprio gerenciamento do projeto, é estranho, mais é prático! Outra coisa, posso neste neste mesmo ponto adicionar novos campos válidos somente para o projeto!)

Agora crie o seu usuário no link Criar uma nova conta da tela inicial e valide sua conta através do e-mail que irá receber.

Pronto !!! Ufa !!! Acabou um pouco extenso para blog, mas penso que pode ser útil para alguém.

Bom trabalho e boa sorte!!!

Referências
www.mantisbt.org
http://www.vivaolinux.com.br/dicas/verDica.php?codigo=6710