Download dos pacotes necessários

Segue a lista de sites onde fazer o download dos softwares necessários. Os que não tiver a descrição dos sites é
por que foram baixados usando o apt-get.

Os pré-requisitos para a instalação do Ocomon são:

 libapache2-mod-php5

 php5-cli

 php5-cgi

 apache2

 php5-mysql

 mysql-server5

 phpmyadmin

Usando o apt-get do Debian, que foi a versão usada, instalamos todos esses componentes com:

# apt-get install Libapache2-mod-php5 php5-cli php5-cgi apache2 php5-mysql mysql-server 5

E também foram baixadas as versões do Ocomon e do patch de correção da versão Rc6 no site do próprio
mantenedor do projeto, que é o:

 http://ocomonphp.sourceforge.net/

Feito o download do projeto Rc5 e Rc6 e o patch de correção para o bug do Rc6.

Só para efeito de explicação, o Apache2 é o servidor web usado, os pacotes PHP são para exibição e manuseio
da página do projeto, pois a mesma é desenvolvida em PHP, o mysql-server5 para o banco de dados e o
phpmyadmin para o manuseio do banco em modo gráfico.

Próxima página >>

Páginas do artigo
   1. Download dos pacotes necessários
   2. Ocomon - Um breve resumo
   3. Problemas nos testes
   4. Instalação feita com a versão Rc5
   5. Configurações e scripts da versão
   6. Upgrade para a versão Rc6
   7. Explicações finais e bibliografia

Ocomon - Um breve resumo

O Ocomon surgiu em março de 2002 como projeto pessoal do programador Franque Custódio, tendo como
características iniciais o cadastro, acompanhamento, controle e consulta de ocorrências de suporte e tendo como
primeiro usuário o Centro Universitário La Salle (UNILASALLE).

A partir de então o sistema foi assumido pelo analista de suporte Flávio Ribeiro, que adotou a ferramenta e
desde então a tem aperfeiçoado, implementando diversas características buscando atender a questões de ordem
prática, operacional e gerencial de áreas de suporte técnico como Helpdesks e Service Desks.

Em maio de 2003 surgiu a primeira versão do módulo de inventário (Invmon), e a partir daí todas as
informações de atendimentos começaram as estar vinculadas ao respectivo equipamento, acrescentando grande
praticidade e valor ao sistema de atendimento.
Com a percepção da necessidade crescente de informações mais relacionadas com a questão de qualidade no
suporte, no início de 2004 foram adicionadas características de gerenciamento de SLAs, mudando de forma
sensível a maneira como o gerenciamento de chamados vinha acontecendo e obtendo crescente melhoria da
qualidade final de acordo com os indicadores fixados para os serviços realizados.

Hoje é possível responder questões como:

 Volume de chamados por período;

 Tempo médio de resposta e solução para os chamados;

 Percentual de chamados atendidos e resolvidos dentro do SLA;

 Tempo dos chamados decomposto em cada status de

atendimento;

 Usuários mais ativos;

 Principais problemas;

 Reincidência de chamados por equipamento;

 Estado real do parque de equipamentos;

 Como e onde estão distribuídos os equipamentos;

 Vencimento das garantias dos equipamentos, além de uma série

outras questões pertinentes à gerência;

 Pró-atividade do setor de suporte;

 Entre outros.

Problemas nos testes

Este projeto foi desenvolvido na empresa onde trabalho com o uso do Debian 4, com seus patches de segurança
atualizados e com alguns pacotes essenciais como o apt-build.

Problemas de versões e incompatibilidades

Na minha implementação tive alguns problemas de incompatibilidade como a versão do Ocomon 2.0RC6.
Quando instalei a versão 2.0RC6 ele apresentava erro como esse descrito abaixo:

Warning: mysql_fetch_array(): supplied argument is not a valid MySQL result resource in /var/
www/ocomon/includes/include_geral.inc.php on line 47
Table 'ocomon.usuarios' doesn't exist

E quando implantei a versão 2.0RC5 tive problemas com acentuação depois de editar algum chamado.

Como resolver essas incompatibilidades

Então resolvi da seguinte forma. Instalei a versão 2.0RC5, fiz todos os testes e alterações que precisava e depois
fiz um upgrade do programa para a versão 2.0RC6 e funcionou tudo da melhor forma possível.

Instalação feita com a versão Rc5

Como podemos perceber, depois de baixados e descompactados os softwares, eles nada mais são que páginas
em PHP, sendo que eles não precisam de instalação, precisam apenas estar nos lugares certos. No meu caso,
como uso o Debian, eles tem que estar no /var/www.

Vamos a explicação dos comandos, presumindo que os pacotes já foram baixados e estão no /usr/local/src.

# cd /usr/local/src
# ocomon_2.0-RC5.tar.gz
# tar -zxvf ocomon 2.0-RC5.tar.gz -C /var/www
# cd /var/www
# mv ocomon_2.0-RC5 ocomon

A "instalação" se resume em descompactar o Ocomon no seu devido lugar /var/www, lembrando que estou
usando o Debian e por isso descompactei no /var/www.

Agora criaremos o banco de dados do Ocomon.

# mysqladmin -u root -p create ocomon

# cd /var/www/ocomon/install/2.0
# mysql -u root -p ocomon < DB_OCOMON_2.0RC5_FULL.SQL

Obs.: Lembrando que para criar esse banco de dados será solicitada a senha do usuário root, que é aquela
senha que pede quando se está instalando o mysql-server. Muitos usam o phpmyadmin para trabalhar com o
banco de dados e realmente é mais fácil, mas eu prefiro criar o banco de dados na mão mesmo, só usarei o
phpmyadmin para alterar o collation do meu banco de dados.

Configurações e scripts da versão

Suas configurações se resumem em alguns pontos fundamentais:

# cd /var/www/ocomon/includes
# mv config.inc.php-dist config.inc.php
# vi config.inc.php

//Usuario do banco
Define ("SQL_USER", "root"); //NOME DO USUARIO PARA ACESSAR A BASE DO OCOMON - ESSE USUARIO E
CRIADO AUTOMATICAMENTE NA INSTALACAO DO SISTEMA

//Senha do banco
Define ("SQL_PASSWD", "ocomon"); //ESSA SENHA E A PADRAO CRIADA NA INSTALACAO DO SISTEMA. E
RECOMENDAVEL A ALTERACAO DA MESMA NO MYSQL.

//Servidor do banco
Define ("SQL_SERVER", "localhost"); //SE O BANCO DE DADOS ESTIVER EM UM SERVIDOR DIFERENTE DO
SERVIDOR WEB DEVE-SE ALTERAR O VALOR "localhost"

//Nome do banco
Define ("SQL_DB", "ocomon"); //NOME DO BANCO DE DADOS. O PADRAO DESSA VERSAO E: ocomon_rc6

Obs.: No meu caso deixei como está no exemplo acima, meu usuário é o root, a senha do bd é "ocomon" e eu
criei um banco de dados com o usuário ocomon.

Depois temos que alterar um arquivo com o nome de conecta.class.php:

# cd /var/www/ocomon/includes/classes
# vi conecta.class.php

$this->con=mysql_connect(localhost,root,ocomon)or die(mysql_error());
$this->db=mysql_select_db(ocomon,$this->con)

Essas alterações serão feitas nas linhas 54 e 55 do arquivo conecta.class.php. Depois de alterado temos que
reiniciar os serviços:

# /etc/init.d/apache2 restart
# /etc/init.d/mysql restart

Para que tudo corra bem temos que alterar mais alguns arquivos. No caso da versão 2.0RC5, como eu disse
acima, tive problemas com acentuação, mas o problema era um configuração que precisei fazer no banco de
dados, mas para que não tenhamos nenhum problema com acentuação temos que alterar os seguintes arquivos
e colocarmos a seguinte opção:

AddDefaultCharset ISO88591

OS arquivos a serem acrescentados dessa opção são:

 /etc/php5/apache2/php.ini

 /etc/apache2/apache2.conf

 /etc/apache2/httpd.conf

 /etc/apache2/conf.d/charset

Se tiver alguma opção que comece com AddDefaultCharset, altere pela mostrada acima, nos arquivos
mencionados.

Feito isso temos que reiniciar os serviços para reconhecer as alterações:

# /etc/init.d/apache2 restart
# /etc/init.d/mysql restart

Feito isso temos que testar, vá até seu navegador, de preferência o Mozilla, pois o Explorer apresenta algumas
incompatibilidades e digite o IP do servidor Ocomon.

Upgrade para a versão Rc6

Como mencionado, a versão 2.0RC5 apresentou incompatibilidades com acentuação entre outros probleminhas
que ocorreram nos meus testes, então depois de instalado e testado na versão 2.0RC5 eu atualizei a versão para
a 2.0RC6. Como?

Fiz o download da versão 2.0RC6 no site do programa e baixei na pasta /usr/local/src.

# cd /usr/local/src
# tar -zxvf ocomon 2.0-RC6.tar.gz
# mv ocomon 2.0RC6 ocomon

Feito isso temos que alterar como antes os arquivos config.ini.php-dist para config.ini.php e alterar dentro dele
também as opções do banco de dados. No arquivo conecta.class.php também alterar as opções de banco de
dados. Feito isso temos que renomear a pasta ocomon dentro do /var/www.

# cd /var/www
# mv ocomon ocomon_old

Depois copiar o ocomon novo para a pasta /var/www:

# cp -r /usr/local/src/ocomon /var/www

Feito isso temos que dar um upgrade no banco de dados.

# cd /var/www/ocomon/install/2.0RC6/
# mysql -u root -p ocomon < UPDATE-FROM-2.0RC5-TO-2.0RC6.SQL

Ele vai pedir senha e atualizar o banco de dados para a versão 6.0. Caso apresente algum erro, revise os passos
das configurações. Depois de atualizado temos que descompactar o arquivo ocomon_2.0RC6-patch-01.tar.gz,
dentro dele existem duas pastas, a pasta includes com o arquivo versao.php e a pasta ocomon, geral com o
arquivo encerramento.php.
Esses arquivos devem substituir os arquivos que estão dentro da pasta /var/www/ocomon. Lembrando que
esses arquivos devem substituir os originais e devem ser substituídas também suas permissões.

Para resolver de vez por todos os problemas de incompatibilidades, no meu caso o maior problema era o de
acentuação, após alterar um chamado eu usei o phpmyadmin e alterei o collation do meu banco de dados e
resolvi meus problemas com acentuação, junto com as alterações dos arquivos descritos acima. O collation do
banco de dados ficou latin1_swedish_ci.

Explicações finais e bibliografia

Resumindo:

Foi instalado a versão Rc5 e depois feito o upgrade para a versão Rc6 com a correção do bug. Como eu disse,
sei que temos vários tutoriais espalhados na internet sobre a configuração de um servidor com o Ocomon, mas
este tutorial foi escrito por que testei vários deste tutoriais que encontrei na internet e nenhum deles resolveu
totalmente a instalação.

Então depois de muitos testes com esse tutorial, consegui montar o devido servidor.

Bibliografia

 http://ocomonphp.sourceforge.net/

 http://renancariello.wordpress.com/2008/05/18/instalacao-do-

ocomon-no-debian-etch-4/