Tahuti 2.1 A ferramenta de gerenciamento de TI Manual de Instalação Belo Horizonte, 06 de novembro de 2015.
Índice 1. Pré-requisitos 01 2. Instalando e Configurando o Sistema 02 3. Particularidades no Linux 06 4. A Árvore de Diretórios 07 5. Tabelas do Banco de Dados Tahuti 08 6. Eventuais Problemas 09
Índice de Figuras Figura 01 Comando: alterando a senha de root do MySQL. 01 Figura 02 Descompactando o arquivo Sistema_TAHUTI2_0.zip 02 Figura 03 Tela de boas vindas para a instalação do Sistema Tahuti. 02 Figura 04 Tela de instalação resposta dos processos automáticos. 03 Figura 05 Tela de Identificação da empresa. 04 Figura 06 Tela de inclusão do usuário Administrador. 04 Figura 07 Tela de conclusão do processo de instalação. 05
1. Pré-requisitos No ambiente Windows, instalar o software Wamp (http://www.wampserver.com) é a maneira mais fácil e rápida de ter o sistema Tahuti funcionando. Ou se desejar, você também poder instalar separadamente um servidor Web (Apache), um gerenciador de banco de dados (MySQL) e um interpretador de comando (PHP). Deve-se usar o Wamp quando apenas uma pessoa for gerenciar estas informações a partir de um único computador. Agora, se o acesso às informações forem compartilhadas, deve-se instalar em um servidor com acesso à Internet e com os serviços de HTTP, PHP e MySQL Server previamente configurados. No ambiente Linux, independente da distribuição de sua preferência, recomendase a trabalhar com os serviços em separado, uma vez que cada distribuição possui em seus repositórios os pacotes customizados para instalação. Considerando que o Wamp esteja instalado, é hora de testar. Abra o browser de sua preferência e digite http://localhost/. Irá abrir uma página com as informações dos serviços instalados e suas respectivas versões. No aplicativo MySQL, o usuário root, quando da instalação, vem sem senha. É altamente recomendável que você atribua uma senha e, para isso, abra uma janela de comando e execute o comando abaixo: cd \wamp\bin\mysql\mysql5.6.12\bin<enter> mysqladmin -u root password digite-a-sua-senha<enter> Figura 01 Comando: alterando a senha de root do MySQL. 1
2. Instalando e Configurando o Sistema Abra o Windows Explorer e navegue até a pasta C:\wamp\www e apague todos os arquivos existentes. Depois, descompacte o arquivo Sistema_TAHUTI2_1.zip. Figura 02 Descompactando o arquivo Sistema_TAHUTI2_1.zip. No browser, digite a URL http://localhost/ para personalizar o sistema. Figura 03 Tela de boas vindas para a instalação do Sistema Tahuti. 2
Na tela de boas vindas, a primeira informação solicitada é o nome do usuário com perfil de administrador cadastrado no SGBD (Ex.: MySQL). Após clicar o botão Enviar, é realizado um teste de conexão com o SGBD com as informações solicitadas e, em caso de sucesso, será criado o banco de dados e suas respectivas tabelas e índices. Figura 04 Tela de instalação resposta dos processos automáticos. A última mensagem da figura 04 demanda que, havendo outros arquivos a serem importados, o Administrador deve fazê-lo somente após a conclusão do processo de instalação do Sistema. O próximo passo é informar os dados da empresa detentora dos equipamentos, conforme a figura 05. Vale salientar que o Sistema Tahuti foi criado para gerenciar os dados de uma única empresa. Talvez em versões posteriores venha a ser adicionada esta funcionalidade. A seguir vem a criação do usuário que irá administrar o Sistema, mas nada impede que outra pessoa também possua este nível de privilégio. Supondo que seja você, preencha os seus dados conforme a figura 06. Uma última tela é mostrada informando a conclusão do processo de instalação e com um link para a abertura do Sistema, conforme a figura 07. 3
Figura 05 Tela de Identificação da empresa. Figura 06 Tela de inclusão do usuário Administrador. 4
Figura 07 Tela de conclusão do processo de instalação. 5
3. Particularidades no Linux A base de desenvolvimento do sistema Tahuti foi no Windows. Entretanto, quando fui testá-lo no Linux, ocorreram diversas complicações, principalmente no processo de instalação e na importação de dados. Diferentemente do Windows, o sistema operacional Linux faz diferença entre letras maiúsculas e minúsculas. Esta característica apareceu também no serviço de Banco de Dados. Foi preciso corrigir as chamadas ao nome do banco de dados e das tabelas. No PHP, foi necessário corrigir em alguns arquivos, a referência a nomenclatura de outros arquivos. Outra diferença que apareceu na importação de dados pelo sistema foi do caractere de fim de linha. Enquanto que no ambiente Windows usamos o \r\n, no Linux usa-se somente o \n. Então, se você editar o arquivo de importação usando um editor e promover alguma alteração ou simplesmente salvá-lo, pode ocorrer esta mudança que impossibilitará a correta importação dos dados na(s) tabela(s). Nos diretórios em que haverá escrita, a permissão de leitura, escrita e execução deverá ser para todos (chmod 777) e os arquivos contidos nestas pastas com permissão de leitura e escrita para todos também (chmod 666). A solução de alguns problemas encontrados durante os testes de migração estão relatadas no item 6. 6
4. A Árvore de Diretórios Web estará conforme abaixo: Após a instalação e configuração do Sistema Tahuti, o diretório raiz do servidor <raiz> admin audit conversao excluidos export troca usuarios doc HTML ODF PDF exportacao fig importacao instalacao lib manutencao identificacao tabelas computadores fabricantes impressoras lib localizacao monitores rede scanners operacao computadores fabricantes impressoras localizacao menor conexao funcao impressao interface motivo mouse processador redes situacao software tcpip tipo monitores rede scanners 7
5. Tabelas do Banco de Dados Tahuti O processo de instalação e configuração do Sistema Tahuti cria automaticamente o banco de dados, as tabelas e preenche algumas tabelas menores. Abaixo estão listadas as tabelas do banco de dados Tahuti. baixados fabricantes i_descricao_fisica i_impressao i_status_operacional i_tipo identificacao l_cdc l_referencia l_setor localizacao mn_descricao_fisica mn_status_operacional m_cadeados m_descricao_fisica m_descricao_hardware m_descricao_rede m_descricao_software m_funcao m_monitores m_motivo m_mouse m_processador m_redes m_situacao m_software m_status_operacional m_tcpip r_conexao r_descricao_fisica r_status_operacional s_descricao_fisica s_interface s_status_operacional u_acessos usuarios 8
6. Eventuais Problemas apresento alguns e sua solução. Durante o processo de instalação podem ocorrer eventuais problemas. Abaixo, 6.1. Erros na instalação 6.1.1. Erro 00001: Não foi possível conectar no servidor de banco de dados agora. Este erro sugere que as informações a cerca do nome do servidor, o nome do usuário ou a sua senha estejam erradas ou podem ter sido digitadas erroneamente. Certifique-se de ter em mãos as informações corretas antes de iniciar o processo. Clique no botão voltar e digite novamente as informações. Se o problema persistir, procure ajuda especializada. 6.1.2. Erro 00002: Não foi possível criar o banco de dados agora. Este erro informa que o usuário informado na tela anterior está cadastrado e tem acesso ao SGBD. Entretanto, não possui permissão para criar um banco de dados. Volte para a tela anterior e informe um usuário que possua esta permissão e sua respectiva senha. 6.1.3. Erro 00003: Não foi possível localizar o banco de dados agora. Este erro informa que o banco de dados não existe no SGBD ou o usuário informado não possui privilégio de acesso. Volte para a tela anterior e informe um usuário que possua esta permissão e sua respectiva senha. 6.1.4. Erro 00010: Não foi possível criar a tabela USUARIOS agora. Este erro vale para os códigos 00011, 00012, 00101, 00102, 00103, 00104, 00105, 00110, 00120, 00121, 00122, 00123, 00124, 00125, 00127, 00128, 00129, 00130, 00131, 00132, 00133, 00134, 00135, 00140, 00141, 00142, 00143, 00150, 00151, 00152, 00160, 00161, 00162. Informa que o banco de dados existe no SGBD e usuário informado não possui privilégio para criar as tabelas. 9
respectiva senha. Volte para a tela anterior e informe um usuário que possua esta permissão e sua 6.1.5. Erro 00201: Não foi possível inserir dados na tabela U_Acessos agora. Este erro vale para os códigos 00202, 00203, 00204, 00205, 00206, 00207, 00208, 00209, 00210, 00211. Informa que a tabela não existe no banco de dados e por isto não foi possível importar os dados. Neste caso, anote o nome da tabela e, após a conclusão do processo de instalação do Sistema, cria a tabela manualmente e faça a importação dos dados. 6.1.6. Erro 00301: Ocorreu um erro durante a execução da query. Este erro informa que uma query (inclusão, alteração, exclusão ou consulta) não foi executada devido a algum erro, seja na sintaxe, seja pela falta de parâmetro complementar. Use o aplicativo phpmyadmin para incluir as informações diretamente na tabela identificação. 6.1.7. Erro 00303: Ocorreu um erro durante a execução da query. Similar ao item anterior, mas direcionado a inclusão do usuário administrador. Neste caso há um complicador: a criptografia da senha. Como é realizado por um comando do PHP, clique no botão voltar, complemente o formulário e clique no botão Enviar. Se o erro persistir, use o aplicativo phpmyadmin para apagar o banco de dados Tahuti e, no browser, abra uma nova janela e digite a URL http://localhost/index.php para iniciar todo o processo de instalação novamente. 6.1.8. Ambiente Linux: Importação de dados Se após a importação dos dados para a(s) tabela(s) você verificar que estão incompletos, siga os passos a seguir. 6.1.8.1. Corte na acentuação O banco de dados Tahuti importa arquivos com a codificação UTF8. Se o arquivo de importação estiver diferente (Ex: ISO-8859-1) haverá um corte no lugar do primeiro acento que for encontrado. Use o comando file para descobrir o tipo do arquivo e codificação do conteúdo. 10
Se a codificação estiver diferente, utilize um editor (ex: kate) para salvá-lo corrigindo a codificação. 6.1.8.2. O primeiro registro é o último Este problema costuma aparecer quando, para resolver o problema do item anterior, você usado o kwrite. É que ao salvar o arquivo, ele inclui alguns caracteres de controle no início do arquivo, que por sua vez, impedem a correta importação dos dados. Para confirmar se este é o problema há um comando (od -c nome-do-arquivo more) que mostrará todos caracteres do arquivo. A solução deste problema é abrir o arquivo em outro editor e salvá-lo novamente. 6.1.8.3. Somente o primeiro registro é importado Após a importação de dados, você verifica que apenas o primeiro registro do arquivo texto foi importado, ignorando todo o restante. Isto tem a ver com o caractere de fim de linha que está diferente do especificado no sistema (\r\n). Para confirmar se este é o problema, o mesmo comando do item anterior irá lhe mostrar qual caractere sinaliza o final da linha. A solução deste problema é abrir o arquivo em outro editor e salvá-lo novamente ou importá-lo diretamente no MySQL através de sua console (veja no manual técnico). 6.1.9. Erros de PHP 6.1.9.1. notice undefined offset X Este erro pode ocorrer quando, do preenchimento dos elementos de um arranjo (ARRAY), o elemento X não está definido. Consulte a tabela índice para saber se o elemento X está definido. Altere os dados dos equipamentos para outro elemento ou inclua o elemento na tabela índice. 11