1. REQUISITOS Espao em disco superior a 3,5 GB. Navegador Google Chrome. RAM: Mnimo de 3 GB (Recomendado 4 GB) CPU: Dual-core.
2. OBTENDO O ARQUIVO DE INSTALAO Obtenha o arquivo de instalao em:
ftp://200.146.119.59/SGBI/Instalador_Linux/
O arquivo de instalao pode ser usado em servidores 32 bits e 64 bits.
3. INSTALANDO O SGBI Para instalar o sistema SGBI, siga os passos:
Passo 3.1: Logue no servidor com o usurio root.
Passo 3.2: Atribua permisso para o executvel usando o comando: chmod +x arquivo_instalao
Passo 3.3: Execute-o: ./arquivo_instalao
2
Passo 3.4: Essa a primeira tela do instalador. Pressione a tecla 1 e, em seguida, Enter para instalar.
3
Passo 3.5: Escolhendo a opo 1, o instalador atualiza os repositrios do Linux para baixar alguns aplicativos usados no SGBI, verifica se o Java est instalado na mquina e se o disco tem espao suficiente para instalao.
Obs.: Se o Java no estiver instalado na mquina, o instalador baixa o java-1.6.0-openjdk e o instala automaticamente. Se o Java j estiver instalado, aparece na tela a mensagem: JAVA ENCONTRADO ! e segue a instalao.
4
Passo 3.6: Para comear a instalao, preencha os campos com os dados da empresa. Isto gera a senha de permisso ou liberao. A princpio, estes dados so para controle de clientes implantados, pois os campos Quantidade de Acesso e Validade ainda no esto ativos. Futuramente sero vlidos e controlados por senha.
A senha SGBI gerada no SGPSWeb em Gerao de senha SGBI
5
Passo 3.7: Aps a validao da senha, o instalador pede um caminho para instalar o SGBI. Por padro utiliza-se: /usr/sgbi Os arquivos so descompactados e se o processo for concludo com sucesso aparece a mensagem: ARQUIVOS DESCOMPACTADOS COM SUCESSO ! Na pasta Sgbi esto o Pentaho, o servidor Tomcat e a pasta de solues (Relatrios, Dashboards, etc.).
Passo 3.8: Aps descompactar os arquivos na pasta Sgbi, escreva o caminho onde est localizado a pasta ser (pasta que contm os arquivos dbf, do sistema SGS). Na pasta ser esto os arquivos:
Aps os arquivos serem inseridos na pasta ser, instala-se automaticamente:
Para servidores 32bits libmysqlclient.so.16
Para servidores 64bits libmysqlclient.so.18 Descompacta em /usr/lib64 as seguintes libs do MySQL: libgpm.so.2.1.0 libmysql.so.16.0.0 libgpm.so.1
6
Passo 3.9: Insira o IP do servidor em que o SGBI est sendo instalado.
Passo 3.10: O instalador verifica se o MySQL est instalado na mquina. Se no estiver, o MySQL instalado automaticamente junto com o HTTPd, PHP e PHP-MySQL. Aps estas instalaes, informe onde sero inseridos os arquivos php.
Obs.: Nas distribuies Linux baseadas em RedHat, os arquivos php ficam no diretrio /var/www/html e nas distribuies Linux baseadas em Debian, os arquivos php ficam no diretrio /var/www .
7
Passo 3.11: Configure o MySQL:
Digite o usuario: mantenha a expresso root. Digite a senha: mantenha senha1. Digite o hostname: escreva o IP onde o MySQL est instalado. Digite a database: mantenha sgbi.
Passo 3.12: Crie um usurio para logar na aplicao:
Passo 3.13: Se a instalao foi feita corretamente, aparece na tela a mensagem:
Pressione a opo n para no iniciar o servidor sgbi, pois necessrio configurar o sgbiexporta.l.
8
4. CONFIGURANDO O SGBIEXPORTA.L Depois de concluir a instalao do sistema SGBI, necessrio configurar o sgbiexporta.l.
Passo 4.1: Dentro da pasta ser existe um arquivo chamado config.sh . Este arquivo auxilia na configurao do sgbiexporta.l .
Acesse as opes do config.sh digitando o comando: ./config.sh set.
Exemplo: O comando ./config.sh d configura apenas os dias a retroagir. Configure todas as opes para o sgbiexporta.l usando o comando: ./config.sh t.
Escreva o IP do banco= Preencha com o IP do servidor onde est instalado o SGBI Escreva o usurio do banco= Por padro o usurio root Escreva a senha do banco= Por padro senha1 Escreva a porta do banco= Por padro a porta 3306 Escreva o nome do banco= Por padro o nome sgbi Escreva os dias a retroagir= A quantidade de dias pode variar
Obs: Na primeira vez que rodar o sgbiexporta.l , utilize os dados de dois anos atrs (730 dias). Aps, utilize o padro (7 dias) para atualizao diria.
9
Passo 4.2: Para iniciar o carregamento dos dados, na linha de comandos, execute o comando ./sgbiexporta.l (32bits) ou o ./hsgbiexporta.l (64bits). O carregamento dos dados pode levar algumas horas, dependendo do nmero de dias para exportao de dados definido durante a configurao.
Ao rodar o sgbiexporta.l ou hsgbiexporta.l automaticamente cria-se na pasta ser um log chamado sgbiexporta.log. Neste log so gravados todos os processos ocorridos desde a verificao de integridade dos dbf's at a gravao dos dados no banco MySQL.
5. UTILIZANDO O SGBI Aps o carregamento dos dados, o SGBI est pronto para ser utilizado! Execute o comando ./start-pentaho.sh em usr/sgbi/biserver-ce/ para subir o servio Pentaho.
Obs.: O SGBI s funciona no Google Chrome.
Para acessar ao SGBI, abra o navegador Google Chrome e escreva no navegador a seguinte URL: {IP da mquina}:8080. Aparece a tela:
IMPORTANTE:
1) O sgbiexporta.l pode ser configurado para atualizar automaticamente todos os dias atravs do crontab. Para configurar a atualizao automtica siga os passos:
10
Passo 5.1: Crie script para chamar o sgbiexporta.l dentro da pasta ser. Acesse a pasta bin em /usr/Bin. Crie o arquivo sgbi e insira o comando:
#! /bin/bash umask 0000 cd /mnt/sgs/ser (Caminho onde esta a pasta ser) ./sgbiexporta.l (32bits) ou ./hsgbiexporta.l (64bits) exit
Passo 5.2: Aps criar o script, configure o crontab. A sequncia : mm hh dd MM ss script
mm = minutos hh = hora dd = dia MM = ms ss = dia_da_semana script = comando a ser executado * = Tudo
Digite na linha de comando crontab -e para inserir as configuraes. Insira nesse arquivo o horrios que o SGBI deve ser atualizado todos os dias. Exemplo: 00 14 * * * /usr/bin/sgbi (A atualizao ser s 14:00h todos os dias, todos os meses e todas as semanas). ( /usr/bin/sgbi o caminho e o arquivo que deve ser executado) Salve o arquivo. O crontab est configurado.
2) Quando o sgbiexporta.l ou hsgbiexporta.l est sendo executado, os dados de log so gravados dentro da pasta ser no arquivo sgbiexporta.log. Para acompanhar o processo, acesse a pasta ser e insira o comando tail -f sgbiexporta.log .
3) Nos servidores com distribuies Linux baseadas em RedHat existe a ferramenta ntsysv e nas distribuies Linux baseadas em Debian existe a ferramenta rcconf. Estas ferramentas so utilizadas para habilitar e desabilitar servios que inicializam no boot. No SGBI verifique se os seguintes servios esto habilitados:
11
httpd
mysqld
12
POSSVEIS ERROS
1) ERROR 2002 (HY000): Can't connect to local MySQL server through' /var/lib/mysql/mysql.sock ' (111)
Causa: Erro ocorre quando a pasta mysql est sem permisso. Soluo: sudo chmod -R 755 /var/lib/mysql/
2) Se acessar o SGBI e aparecer o erro:
Causa: Erro ocorre ao colocar IP errado no momento da instalao do SGBI em Digite o ip do servidor Soluo: Verifique se o IP do arquivo context.xml em /usr/sgbi/biserver-ce/tomcat/conf est correto. Altere dentro da tag: Resource name="jdbc/SGBI" Digite a linha a seguir com o IP correto de onde foi instalado o SGBI: url="jdbc:mysql://192.168.1.44:3306/sgbi" 13
3) Se acessar o Relatrio Gerencial, Curva ABC, executar a busca e tentar acessar os dados de um produto em especfico e aparecer o erro:
Causa: Erro ocorre ao colocar o IP errado no momento da instalao do SGBI em Digite o ip do servidor Soluo: Verfique se o IP do arquivo web.xml em /usr/sgbi/biserver- ce/tomcat/webapps/pentaho/WEB-INF/ est correto. Altere dentro da tag: <web-app> Digite a linha a seguir com o IP correto de onde foi instalado o SGBI: <param-value>http://192.168.1.144:8080/pentaho/</param-value>
14
4) Se acessar o SGBI, aparecer o erro mostrado na figura abaixo e ao acessar os Relatrios Gerenciais aparecer a mensagem: No foi possvel conectar: Lost connection to MySQL server at 'reading initial communication packet', system error: 113
Causa: Erro ocorre ao colocar IP errado no momento da instalao do SGBI em Configurao Mysql
Soluo: Verifique se o IP do arquivo conexo.php em /var/www/html/sgbi est correto. Altere dentro da classe: class conexao { Digite linha a seguir com o IP correto de onde foi instalado o SGBI: public $hostName = '192.168.1.144:3306';
15
5) Se acessar o SGBI e o painel do usurio estiver em branco:
Soluo: Verifique o servio do apache chamado httpd . Se no estiver ativo inicie com: service httpd start
Se j esteja ativo, inicie o servio com: service httpd restart
Obs.: Em todos os casos de alterao de IP nos arquivos de conexo, necessrio encerrar o servio do Pentaho e iniciar novamente.
Verifique qual o pid do servio com ps aux | grep tomcat. Aps identificar o pid, d um kill -9 xxxx (nmero do pid) . Encerrando o processo, entre em /usr/sgbi/biserver-ce e d o comando para subir o Pentaho: ./start-pentaho.sh