Você está na página 1de 14

Manual de Instalao do SGA Livre

Retornar Pgina Inicial


ndice
Introduo
Instalao do Servidor Web e Banco de Dados
Instalao do Controlador de Painis
Configurao do Cron
Instalao do Painel de Senhas
Introduo
A instalao do servidor do SGA Livre requer conhecimento tcnico em Linux. Ento, sugerimos que este
roteiro seja executado por um usurio familiarizado com instalao de pacotes e configurao bsica de
Apache, PHP, Postgresql e Java.
Este roteiro est baseado (e Recomendamos) Sistema Operacional GNU/Linux Debian 5 - Lenny.
Como pode ser visto na seo 'Arquitetura' do manual de introduo, o SGA Livre pode ser instalado
separando servidor de aplicao web, banco de dados e controlador de painis. Essa deciso deve ser
tomada com base no volume de acesso e uso do sistema. Porm, para a maioria dos usurios, instalar
todos esses componentes num nico servidor ser suficiente. Este manual pressupe que todos os
componentes estaro instalados na mesma mquina servidora.
Pr-requisitos de hardware:
A definio de requisitos de hardware deve ser baseada no volume de acesso esperado.
Quanto maior o nmero de unidades de atendimento, mais adequada deve ser a mquina servidora.
Em geral, servidores com dois processadores, 2 GB de memria RAM e 50 GB de espao em disco
devem atender bem para pequenos volumes.
Pr-requisitos de software:
Postgresql verso 8.3
Apache verso 2
Openjdk-6-jre ou Sun-java6-jre
PHP verso 5.2.0
GD verso 2.0
Multibyte String
PDO verso 1.0.0
PDO PgSQL verso 1.0.2
Lista de Pacotes para Debian Lenny:
apt-get install postgresql-8.3 postgresql-client-8.3 apache2 openjdk-6-jre php5 php5-cli libapache2-
mod-php5 php5-gd php5-pgsql
1 de 14
Dica: aps instalar os pacotes, e antes de prosseguir com a instalao, certifique-se que o usurio padro de administrao do
Postgresql esteja habilitado.
Exemplo no Debian para habilitar o usurio padro postgres:
$ su - postgres
$ psql
$ alter user postgres with password 'defina_sua_senha'; (com aspas)

Instalao do Servidor Web e Banco de Dados
Nesta seo ser descrita a instalao do Servidor Web e do Banco de Dados.
Pacotes de instalao
O pacote completo de instalao do SGA Livre composto de:
Para instalao no Servidor
sgalivre-servidor-web_x.x.x.tgz - Pacote de instalao do Servidor Web e Banco de
Dados.
sgalivre-controladorpaineis_x.x.x.tgz - Pacote de instalao do Controlador de Painis.
Para instalao do Painel de Senhas
sgalivre-painel_x.x.x.tgz - Pacote de instalao .tgz do Painel de Senhas.
sgalivre-painel_x.x.x.deb - Pacote de instalao .deb do Painel de Senhas.
Onde x.x.x signifca a verso. Ex.: 1.0.0
Primeiro Passo - Incio
Descompactar o sgalivre-servidor-web_x.x.x.tgz na rea web do servidor apache2.
Acessar o instalador web, conforme exemplo abaixo:
Exemplo: http://<ip_do_servidor>/sgalivre
Ao acessar o SGA pela primeira vez, a pgina de instalao ser exibida. Clicando no boto "Prximo" o
usurio ser levado a pgina de verificao de requisitos.
2 de 14
Segundo Passo - Verificao dos Requisitos
Esse passo da instalao mostra ao usurio os requisitos mnimos do SGA Livre e faz a comparao com
as verses instaladas no servidor.
Em Permisses Requeridas, o SGA Livre aponta a necessidade de permisso de escrita no arquivo
Config.php. O SGA Livre mostra o caminho atravs dos diretrios para encontrar o arquivo. O usurio
deve alterar com chmod, adicionando a permisso de escrita. Aps disso, basta atualizar a pgina e
verificar se a alterao foi efetuadas com sucesso.
Em Configuraes Requeridas, encontramos o short_open_tag onde o valor requerido deve ser "On".
Caso o valor seja "OFF" basta alterar o valor da chave no arquivo PHP.ini. No Debian, geralmente fica em
/etc/php5/apache2/php.ini.
Em Configuraes Recomendadas, o magic_quotes_gpc dever ter o valor "OFF", no caso contrrio
basta alterar o valor no arquivo PHP.ini
necessrio reiniciar o Apache aps alterar o php.ini.
Os itens que no esto em conformidades com o exigido pelo SGA Livre ficam destacados em vermelho.
3 de 14
Terceiro Passo - Licena
Nesta parte da instalao, o usurio orientado a ler a licena do SGA Livre - O SGA disponibilizado
sob a Licena Pblica Geral (GPL - verso dois, publicada em junho de 1991). Aps concordar com os
termos da Licena, o usurio poder avanar para o prximo passo.
4 de 14
Quarto Passo - Configurao do Banco de Dados
Nesta estapa da instalao, o administrador dever inserir as opes de conexo ao servidor de banco de
dados Postgresql, que ser utilizado pelo SGA Livre.
Durante a configurao do banco o usurio dever inserir o nome do Host (ou IP) onde est o banco; a
porta de comunicao do sistema com o banco; o nome do usurio administrador do banco; a senha
deste usurio e o nome do banco a ser criado. Antes de avanar para a prxima etapa, o banco dever
ser testado.
5 de 14
Obs.: por padro, o Postgresql permite apenas conexo localhost. Para habilitar conexes externas, veja manual do Postgresql.
Ateno: O banco de dados especificado na instalao ser criado automaticamente
se no existir, caso exista ser recriado e todos os dados existentes no banco antigo
sero PERMANENTEMENTE PERDIDOS.
Quinto Passo - Configuraes da Conta Administrador
Nesta etapa o usurio vai configurar as opes da conta Administrador do SGA Livre. Ser a conta com a
qual o usurio ir acessar a primeira vez no sistema para configur-lo. O administrador ter acesso total
ao sistema. Esta conta poder ser editada, entretanto, nunca poder ser excluida do sistema.
As informaes aplicveis a conta Administrador durante esta etapa so: Usurio - nome usado no
acesso ao sistema; Nome - nome do administrador; Sobrenome; Senha - senha para acesso ao sistema;
e Confirmar Senha. Ao preencher todos os campos o usurio poder avanar na instalao
6 de 14
Sexto Passo - Aplicar
Esta a etapa final de instalao. Clicando em instalar, o SGA Livre ser instalado com as configuraes
obtidas durante a instalao. Uma mensagem indicando o sucesso da operao ser exibida e
posteriormente a pgina de acesso inicial ser exibida.
A partir de agora, o usurio poder logar no sistema com a conta criada.
Ser necessrio configurar o sistema de acordo com suas necessidades.
Instalao do Controlador de Painis
Esta seo abordar a instalao do Controlador de Painis do SGA Livre.
7 de 14
O Controlador de Painis uma aplicao Java centralizada que responsvel por enviar as senhas
chamadas pelos atendentes para os Painis de Senhas das Unidades de Atendimento, no importando
onde elas estejam. Basta ter uma conexo de rede disponvel. O envio das senhas extremanente leve e
rpido, pois constitudo de um datagrama (pacote) UDP bem curto.
Controlador de Paineis e Paineis de Senhas trabalham com protocolo UDP, nas portas
9999 e 8888 respectivamente. Certifique-se de que no haja bloqueios em dispositivos de
rede como roteadores e firewalls.
Primeiramente, o usurio dever descompactar o arquivo "sgalivre-controladorpaineis_x.x.x.tgz".
O arquivo server.conf contm as informaes de configurao do Controlador de Painis. muito
importante que o administrador insira corretamente as informaes nesse arquivo.
# DATAPREV 2009
# SGA Livre
# CONTROLADOR DE PAINEIS 1.0.0
# ARQUIVO DE CONFIGURAO DO CONTROLADOR DE PAINEIS
# server.conf
#
# Define a classe do Driver SQL a ser usado.
# O Driver deve ser adequado ao RDMBS em uso.
# PostgreSQL -> org.postgresql.Driver
jdbcDriver = org.postgresql.Driver
# Define a URL JDBC
# Exemplo: jdbc:<rdbms>://<host>/<database>
jdbcUrl = jdbc:postgresql://127.0.0.1/sgalivre
# Define o usuario do SQL
jdbcUser = postgres
# Define o password do login SQL
jdbcPass = senha
# URL do Servidor Web
# Define a URL que ir retornar a lista de Unidades
# Essa URL enviada para o painel, que a utiliza para obter a lista de unidades
# No utilizar endereo de loopback (l27.0.0.1)
urlUnidades = http://10.0.0.2/sgalivre/painel/get_unidades.php
# URL do Servidor Web
# Define a URL que ir retornar a lista de Servios
# Essa URL enviada para o painel, que a utiliza para obter a lista de servios a partir de uma unidade
# O token %unidade_id% substituido no cliente pela unidade selecionada
# No utilizar endereo de loopback (l27.0.0.1)
urlServicos = http://10.0.0.2/sgalivre/painel/get_servicos.php?id_uni=%id_unidade%
# Intervalo de consulta (em milsimos de segundo)
# Define o intervalo de consultas SQL em busca de novas senhas
# Um intervalo muito grande aumenta o tempo de resposta e pode permitir que uma quantidade grande
de senhas
# acumule, causando um pico de processamento.
# Um intervalo muito pequeno pode causar impacto na performance do banco devido ao excesso de
consultas.
8 de 14
intervaloConsulta = 100
# Tempo limite (em segundos) que um Painel ser considerado como inativo caso nao faa contato.
# Os painis enviam sinais de vida baseados nesse intervalo.
# Um painel continua recebendo mensagens at ser dado como inativo.
timeoutPainel = 600
# Tempo limite (em segundos) que um Painel ser considerado inexistente, e ser removido da memria
do Controlador e do Banco de Dados.
# Esta tarefa permite a liberao de recursos da maquina executando o controlador de paineis e impede
o acumulo de lixo na tabela.
# Caso o Painel de Senhas na unidade esteja ativo, ou seja, iniciado antes deste tempo limite no ser
removido.
# padro: 345600 segundos (96 horas)
removerPaineisIntervalo = 345600
# Horario(HH:MM:SS) no formato 24 horas em que o controlador de paineis ir executar a tarefa de
limpeza de paineis inativos
# Esta tarefa passa por todos paineis e remove aqueles que estao inativos por tempo superior a
<removerPaineisIntervalo>
# altamente recomendado que esta tarefa execute em um horrio de ociosidade do sistema.
removerPaineisHora = 23:50:00
Realizadas as configuraes no arquivo server.conf, o Controlador de Painis pode ser executado,
atravs do script controladorpainel.sh.
O Controlador de Painis deve permanecer em execuo todo o tempo.

Configurao do Cron
A configurao do Cron opcional, mas recomendada. A idia bsica agendar uma tarefa no cron para
acumular todos os atendimentos nas tabelas de histrico do SGA Livre, liberando o sistema para o
funcionamento no dia seguinte. Ou seja, a mesma funcionalidade existente na opo "Reiniciar Senhas",
existente no mdulo Config. Global. A diferena apenas a automatizao do processo por meio de
agendamento no servidor.
Para isso, necessrio:
1) Criar um arquivo chamado ".pgpass" no diretrio do usurio root contendo a senha e com permisso
0600.
Isto necessrio para permitir que o comando execute, sem a solicitao da senha do usurio do
PostgreSQL.
Exemplo de contedo do arquivo (formato "hostname:port:database:username:password"):
*:*:sgalivre:postgres:senha
2) Criar agendamento no Cron:
0 23 * * * root psql -d database -U usuario -c "SELECT sp_acumular_atendimentos(now())"
9 de 14
Aviso Importante
Em algumas distribuies(como Debian e Ubuntu) o PostgreSQL pode estar configurado de
forma mais restritiva, causando uma mensagem similar a:
PT-BR: psql: FATAL: autenticao do tipo Ident falhou para usurio "root
EN-US: psql: FATAL: Ident authentication failed for user "root"
Nessas distribuies o usurio do PostgreSQL deve coincidir com o usurio linux.
Opcionalmente voc pode alterar a configurao do PostgreSQL em pg_hba.conf:
Restritivo: local all all ident s
Permissivo: local all all md5
Referncia: http://www.postgresql.org/docs/8.3/static/libpq-pgpass.html
Instalao do Painel de Senhas
Nota importante:
Requer Java 6 (JRE) instalado.
A forma recomendada de instalao dos pacotes para o painel via linha de comando:
Exemplo: sudo dpkg -i sgalivre-painel_x.x.x.deb na distro Ubuntu
--
possvel a instalao em outros sitemas operacionais (inclusive Windows). Entretanto, no
ser fornecido instalador para tal. Nesses casos, basta descompactar o arquivo sgalivre-
painel_x.x.x.tgz e executar o arquivo "painel.jar".
Exemplo em outras distros Linux: java -jar painel.jar
Exemplo em Windows: "duplo clique em painel.jar".
O painel de senhas dever ser instalado em todas as mquinas onde ficaro conectados os monitores
que exibiro as senhas chamadas. Ao executar pela primeira vez, ser exibida uma mensagem alertando
que as configuraes iniciais devem ser aplicadas. Como segue na imagem abaixo:
10 de 14


Obs.: Um bug conhecido (tela abaixo) do Java com o Compiz impede que o cone de bandeja funcione
corretamente. Nesse caso, basta desativar os efeitos visuais do Compiz. No Ubuntu fica no Menu
Sistema, Aparncia, aba Efeitos Visuais. Selecionar Nenhum.

A janela de configurao apresentada abaixo possui os campos "IP do Servidor" - neste campo deve ser
colocado o IP do servidor onde est instalado o controlador de paineis. Aps inserir o endereo IP do
Controlador de Paineis deve-ser clicar no boto "Obter Unidades", para carregar no painel as unidades
existentes no servidor. Aps obter as unidades pode-se selecion-las no campo "Selecione Unidade". E
aps selecionar uma unidade sero exibidos no campo "Servio" os servios cadastrados na unidade,
deve-se ento escolher quais servios sero exibidos neste painel.
ATENO: Essa etapa obter e selecionar a unidade somente pode ser efetuada aps a realizao
da configurao do sistema, abordado no Manual do Usurio.
Salvando as opes de configurao o painel ser cadastrado no servidor de paineis e o mesmo ser
iniciado.
11 de 14
O painel de senhas ficar instalado em aplicativos/acessrios. Quando executado o painel de senhas exibe
um cone junto ao painel do sistema operacioal, prximo a data.
Selecionando o cone com o boto direito temos opes de configurao do painel, alm das opes de
"Exibir Painel","Sobre" e "Sair". Selecionando a opo "Configurar Servios" a janela de configurao
inicial exibida. No caso da "Configurao de Layout" exibida uma janela como a apresentada abaixo:
12 de 14
Para alterar as cores do painel deve-se clicar na rea referente no painel exibido no monitor esquerda e
definir a cor daquela rea. Abaixo temos as opes de monitor primrio e secundrio para o caso da
utilizao de mais de um monitor no computador em que o painel est instalado. Temos tambm na
sequncia as opes de sons a serem utilizados ao chamar senhas.
Por padro o painel de senhas iniciado automticamente aps o sistema operacional ser iniciado. Para
ocultar o painel basta pressionar o boto esquerdo e direito do mouse. Abaixo temos um exemplo do
painel.
13 de 14
tima reviso deste documento: 21/10/2009
Retornar pgina inicial
14 de 14