Manual do

Usuário

Instalação e Configuração do Gerenciador de

Terminal de Consulta no Linux
Cód: GCIT0023
Revisão: 4
Data: 13/09/2013
 Índice

Introdução ...................................................................................................................................................... 3
Arquitetura ...................................................................................................................................................... 4
Pré-requisitos ................................................................................................................................................ 5
Instalação ........................................................................................................................................................ 6
Configuração .................................................................................................................................................. 6
Terminal Monoloja ....................................................................................................................................... 6
Terminal Multiloja ...................................................................................................................................... 10
 Introdução

Introdução

Este documento tem como objetivo apresentar os procedimentos de instalação e as

configurações necessárias para o Servidor de Terminais de Consulta no sistema operacional Linux.

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 3
 Arquitetura

Arquitetura

Esta é a arquitetura do ambiente onde se encontra o Servidor de Terminais de Consulta e os

Terminais.

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 4
 Pré-Requisitos

Pré-requisitos

Para a correta utilização do Servidor de Terminais de consulta, deverão ser observadas as

seguintes condições:

 Linux (CentOS 5, Ubuntu 9.04 ou superior);

 Zeus Manager versão 1.6.6.0 ou superior;

 Conexão TCP/IP entre o servidor e o aplicativo Zeus Manager;
 Endereços IP dos Terminais de Consulta;
 Máquina Virtual Java (JVM) instalada (1.6 ou superior);

 Utilização de um dos seguintes Terminais:

Gertec – Buscapreço e TC 505
Itautec – Quick Way
Sweda – ECD1200

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 5
 Configuração

Instalação

Para padronizar, crie o diretório abaixo a partir da raiz (/) da unidade.

/Zanthus/Zeus/

Para encontrar o pacote de instalação acesse o link:

FTP://ftp.zanthus.com.br/pub/Terminal de consulta/stc_2_0_1.zip

Salve o arquivo stc_2_0_1.zip na pasta Zeus, e descompacte o mesmo dentro desta pasta. A
pasta stc será criada.

Configuração

Para configurar os terminais existem duas possibilidades

 Aplicativo de terminal monoloja: Configurar o IP do servidor Manager, ou do PDV

servidor, nos terminais em cada uma das lojas.

 Aplicativo de terminal multiloja: Configurar o IP do servidor Manager e configurar o IP's

dos terminais no Manager por loja.

Terminal Monoloja
Os passos descritos a seguir mostram as configurações em ambiente monoloja.

Editor de configurações

Para fazer as configurações necessárias, execute o arquivo shell script editor.sh da seguinte
forma (caso este esteja instalado em um PDV):

/Zanthus/Zeus/stc/linux/sh editor.sh

A tela do editor será exibida conforme imagem abaixo.

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 6
 Configuração

Configure com as seguintes informações:

Configurações Clientes
 Mensagem: escreva a mensagem que será exibida no terminal, a mesma mensagem será
exibida em todos os terminais.

Mensagem sem Produto

 Escreva a mensagem que será exibida em todos terminais, quando o produto consultado não
for encontrado.

Mensagem de Intervalo
 Escreva a mensagem que será exibida em todos terminais, quando não estiver passando
nenhum produto. Este recurso está disponível a partir da versão 2.0.1.

Porta Conexão Socket

 Console: é a porta da aplicação do terminal, usar sempre 65000 (default);
 Gertec e Sweda: é a porta parametrizada nos terminais de consulta para comunicação com o
servidor ,preencher 6500 (default);
 Itautec :é a porta parametrizada nos terminais de consulta para comunicação com o
servidor, preencher 11007 (default);
 Manager Web: conexão com a aplicação, preencher 22000 (default).

Configurações
 IP Manager: endereço de IP onde está configurado o Manager (Apache);
 IP PDV (servidor): endereço de IP do PDV que atuará como primeiro servidor para consulta
de preços; esta opção foi disponibilizada para permitir o uso dos terminais de consulta na
situação em que a comunicação com o Manager não é possível;
 IP PDV (2º servidor): endereço de IP do PDV que atuará como segundo servidor para
consulta de preços; esta opção foi disponibilizada para permitir a consulta à outro PDV caso a
comunicação com o primeiro PDV não seja possível (falha de comunicação);
 IP PDV (3º servidor): endereço de IP do PDV que atuará como servidor para consulta de
preços; esta opção foi disponibilizada para permitir a consulta à outro PDV caso a
comunicação com o primeiro PDV não seja possível (falha de comunicação);
 Porta Conexão HTTP: porta que o Manager está utilizando;
GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013
Pág. 7
 Configuração

 Porta Conexão HTTP (PDVs): porta que o(s) PDV(s) servidor(es) está(ão) usando;
 Loja Padrão : coloque o código da loja padrão.

Atenção!
 Caso um dos itens IP PDV (servidor) , IP PDV (2º servidor) e IP PDV (3º servidor) esteja
configurado, todas as consultas serão dirigidas ao IP configurado;
 A partir da versão 2.0.0, passa a existir a possibilidade de direcionamento de uma
consulta para vários IPs, neste caso as consultas passam a ser feitas seguindo a seguinte
ordem: IP PDV (servidor) , IP PDV (2º servidor), IP PDV (3º servidor) e IP Manager. Caso
a consulta ao primeiro IP falhe, esta será dirigida ao segundo IP configurado, e assim por
diante (respeitando a ordem mencionada).
 O PDV servidor só atenderá solicitações de consulta de terminais que estejam na mesma
loja, conforme configuração do parâmetro Loja Padrão;
 Para usar somente o Manager como servidor basta NÃO configurar os itens IP PDV
(servidor), IP PDV (2º servidor) e IP PDV (3º servidor);
 [comportamento até a versão 1.2.0] O processo de consulta ocorre somente no IP
configurado, NÃO há tentativa de consulta na solução Manager e, em caso de falha, no
PDV servidor.
 [comportamento a partir da versão 2.0.0] Havendo falha na consulta dirigida a um IP,
esta será direcionada ao próximo IP configurado. Para que esta funcionalidade seja
usada corretamente, o aplicativo servidor (Servidor TC - servidor.jar) deverá ser
instalado fora do PDV. Este pode ser instalado em qualquer computador do
estabelecimento que tenha acesso a rede, e faça parte do mesmo seguimento de
rede dos PDVs e terminais de consulta.
 O modo de consulta Terminal Multiloja só está disponível e funcionará quando o IP
Manager estiver configurado, e for o único configurado.
 Para que o PDV servidor atue como servidor de terminais o arquivo PDV_WSRV.CFG
deverá estar presente no diretório (ou pasta) em que se encontra o programa executável
do PDV, tipicamente o diretório /Zanthus/Zeus/pdvJava. Neste arquivo se encontra a
configuração da porta a ser usada na comunicação da aplicação Servidor TC e o PDV
Servidor. Exemplo:
- PDV_WSRV.CFG (conteúdo):

PORTA=33000

Depois de preenchida todas as configurações clique em OK para salvar no arquivo STC.xml.

Assim que forem salvas as alterações o servidor mudará seu comportamento.

Importante: Para maior segurança e estabilidade, o servidor não envia automaticamente para os
terminais Gertec-TC 505 as mensagens alteradas no editor. É necessário que um técnico se dirija a
cada um dos terminais e passe uma etiqueta com o código especial 4442000000011. Isso fará com
que o terminal peça para o servidor as novas mensagens. Logo em seguida o terminal irá reiniciar. A
imagem do código de barras correspondente está no arquivo puxaMensagem.png (presente no
pacote de instalação).

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 8
 Configuração

Servidor dos Terminais

Para executar o aplicativo servidor dos terminais de consulta, abre uma janela terminal (ou
console), e execute o seguinte arquivo shell script:

/Zanthus/Zeus/stc/linux/sh servidor.sh &

Este aplicativo deverá permanecer em execução em tempo integral, sendo este fundamental
para o funcionamento do processo de consulta.

Para iniciar o servidor de terminal de consulta na inicialização do PDV,deve ser acrescentado no

arquivo do pdvJava2:

#Disparando Servidor de terminais de consulta

xterm –geometry 60x24+460+0 – e /Zanthus/Zeus/stc/linux/Servidor.sh &

Verificar a existência da linha abaixo:

./igraficaJava &

Monitor dos Terminais

Para monitorar as conexões feitas com o servidor, o usuário poderá executar o aplicativo de
monitoração de conexões através da seguinte linha de comando:

/Zanthus/Zeus/stc/linux/sh monitor.sh &

Na tela deste aplicativo será exibido o número de terminais (e seus respectivos os IPs)
conectados ao aplicativo servidor.
A execução deste aplicativo é opcional, não sendo necessário para o funcionamento dos
terminais de consulta.

Em caso de falha na conexão com o servidor,

Em caso de sucesso, os IPs dos
a mensagem acima será exibida.
terminais serão exibidos.

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 9
 Configuração

Terminal Multiloja

Os passos descritos a seguir, mostram as alterações nas configurações em ambiente

multiloja, onde os IPs são configurados por loja.

No Editor XML altere somente a Loja Padrão, coloque “zero” para o sistema fazer a busca
somente pelo número de IP.

No Manager clique em Cadastros /Lojas

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 10
 Configuração

Escolha a loja que deseja cadastrar o IP

No caso de IP fixo selecione IP Simples.

Preencha o campo IP Terminal com o número do IP, depois clique em Incluir.

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 11
 Configuração

O número do IP será exibido, clique em salvar para confirmar a inclusão.

Volte em Cadastros –Lojas , abra a loja que cadastrou o IP para confirmar.

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 12
 Configuração

No caso de IP dinâmico, selecionar Faixa de inclusão.

Preencher os campos IP Terminal Inicial e Final com a faixa de numeração de IPs possíveis,
clicar em Incluir e depois salvar

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 13
 Configuração

A faixa de IPs será exibida e clique em salvar

Volte em Cadastros –Lojas , abra a loja que cadastrou o IP para confirmar a faixa cadastrada.

GCIT0023– Instalação e Config. do Gerenciador de Terminal de Consulta Rev.4 - Data: 13/09/2013

Pág. 14