Manual Driver Ronda Acesso

8/18/2019 Manual Driver Ronda Acesso

1/49

Manual Driver Ronda Acesso

REP –Registrador Eletrônico de Ponto

Manual de instalação e Integração DigiREP com Ronda Acesso

2012

Digicon S. A. Controle Eletrônico para Mecânica – Copyright © 2010-Digicon S.A. –Todos os direitos reservadosVersão 2.3 - 31/03/2012


2/49

Manual Driver Ronda Acesso - Instalação e Configuração 2.3 2

Sumário

Objetivo .................................................................................................................................. 4

Histórico de atualização do Driver .......................................................................................... 4

Primeiros passos ..................................................................................................................... 9

O que é preciso para enviar cadastros de colaboradores aos dispositivos ............................ 9

Entendendo o funcionamento do Driver com CSM e DigiREP ............................................. 10

Quando é iniciado o serviço no Windows ........................................................................ 10

Abrindo comunicação com a CSM .................................................................................... 11

Enviando certificado digital a CSM ................................................................................... 11

Abrindo comunicação com DigiREP .................................................................................. 12

Recebe solicitação de autenticação do DigiREP ............................................................... 12

Recebe colaborador a ser enviado ao DigiREP ................................................................. 13

Driver envia colaborador ao DigiREP ................................................................................ 13

Como funcionam alguns processos do Driver ...................................................................... 14

Carga inicial ....................................................................................................................... 14

Bloqueio do ponto pelo teclado ....................................................................................... 14

Envio de eventos ............................................................................................................... 14

Comando de data & hora ................................................................................................. 15

Validação biométrica por Colaborador ............................................................................. 15

Parametrização do Ronda Acesso ........................................................................................ 16

Site .................................................................................................................................... 16

Plano de Localização Física ............................................................................................... 17

Driver ................................................................................................................................ 18

Catálogo ............................................................................................................................ 19

Dispositivo ........................................................................................................................ 20

Leitora ............................................................................................................................... 24

Instalando o Driver ............................................................................................................... 25

Obtendo o Driver .............................................................................................................. 25

O que será instalado ......................................................................................................... 25

Requisitos mínimos de ambiente ..................................................................................... 26

Instalação passo a passo ................................................................................................... 26

Configurando o Driver ...................................................................................................... 30

Explorando o ambiente instalado – Menu Iniciar ............................................................ 32

Explorando o ambiente instalado – Diretórios ................................................................. 33

Console WEB Driver .............................................................................................................. 36

Acessando a console ......................................................................................................... 36

Sobre o Driver ................................................................................................................... 36Lista de dispositivos gerenciados ..................................................................................... 37


3/49


Pendências não enviadas para CSM ................................................................................. 38

Funções de Administrador ................................................................................................ 39

Comandos do Protocolo Senior .................................................................................... 40

Eventos de Monitoramento .......................................................................................... 41

Processos Internos ........................................................................................................ 42

Timers Internos ............................................................................................................. 43

Ferramentas .................................................................................................................. 44

Atualizando o Driver ............................................................................................................. 45

Removendo o Driver ............................................................................................................. 46

Problemas, compreendendo e resolvendo. ......................................................................... 47

Histórico de revisões do manual .......................................................................................... 48

Glossário ............................................................................................................................... 49


4/49


Objetivo

O objetivo deste manual e auxiliar na instalação, parametrização, desinstalação do DriverDigiREP Senior e prover informações para auxiliar os usuários a manter o sistema emcondições de uso.

O sistema envolvido visa atender a comunicação e troca de dados entre o REP (Registrador

Eletrônico de Ponto) Digicon (DigiREP) e a CSM da Senior Sistemas, em atendimento a portariado Ministério do Trabalho e Emprego (MTE) MP 1.510 de 21/08/2009, que regulamenta autilização de sistemas eletrônicos para apuração de ponto.

O Drive tratado neste manual não tem por objetivo a apuração e tratamento dos dadosdo ponto, sendo de responsabilidade dos usuários a contratação para tal finalidade, dossistemas: Acesso e Segurança (Módulo Terminal de Ponto) e Vetorh (Módulo Ronda Ponto).

Histórico de atualização do Driver

Versão

Data

Descrição 1.3.14 13/10/2010 1. Utilização do framework 3.7.5;

2. Alterada a inserção de cartão na pessoa para se adequar a novaversão do framework.

1.3.15 13/10/2010 1. Utilização do framework 3.7.6;2. Criado um bloqueio para as pessoas com o PIS zerado. Pessoas que

tiverem o pis zerado não são enviadas para o DigiREP;3. A matricula da pessoa é enviada da mesma forma que é recebida da

concentradora, ou seja, é enviado caracteres também;4. As mensagens que estão na lista para serem enviadas para o DigiREP

que não forem envidas, são armazenadas para serem enviadasquando o DigiREP se conectar novamente.

1.3.16 07/11/2010 1.

Versão 1.3.15 compilada;2.

Versão enviada para o Aleixo.1.3.17

07/11/2010

1. Corrigido o erro de enviar o comando 0x29 sem cartões e sembiometrias para o DigiREP;

2.

M05_23 - se uma pessoa possuir dois cartões SmartCard, porexemplo, será enviado somente o último, pois a Senior implementou(Kleiton - 11/11/2010) o envio de cartões de forma ordenada,enviando primeiro os cartões desbloqueados e depois osbloqueados;

3.

Na resposta da autenticação vem o início e o fim do horário de verãoe o GMT, assim quando o evento é enviado é pego este GMT eenviado, caso esteja no horário de verão é diminuindo 1 do GMT; Ex.

Brasil - GMT = -3 , se estiver no horário de verão será enviado -2;4. O REP está realizando a alteração do PIS, então o erro 0x8B não temmais nenhuma função a não ser exibir o erro de PIS em uso, caso oPIS em informado já esteja cadastrado para outra pessoa;

5. Após receber uma conexão foi inserido um sleep de 10 segundos parareceber a próxima;

6. Quando o Driver recebia um insert / updateperson, era verificadopara quais dispositivos a pessoa deveria ser enviada, e para osdispositivos que ela não deveria ser enviada, era enviado umcomando de exclusão da pessoa. Este comando não é mais enviado.

1.3.18

23/11/2010

1.

Versão inicial do drive como serviço;2.

Adicionada algumas informações no arquivo de propriedades;3.

Colocado um bloqueio para inibir a tentativa de conexão através dobotão 'open connection' caso o Driver esteja em modo de autoconexão;


5/49


4. Caso o certificado da Senior não seja encontrado é gerado um erro nolog;

5. A quantidade de log's de backup foi aumentada de 5 para 10;6. Primeira versão do Driver que está pronta para ser utilizada como

serviço, através da API Java Service Wrapper. O Driver não teve queser alterado em nada, apenas o Wrapper teve que ser configurado.

1.3.19

24/11/2010

1.

Utilização da versão 3.7.7 do framework, que verifica qual tipo demensagem é dando a ela a prioridade adequada.instaladordefinitivo.

1.3.20

13/12/2010

1. Corrigido erro que enviava a data e hora errada dos eventos.

1.3.21

13/12/2010

1.

Utilizando a nova versão do framework (3.7.8).

1.3.22

17/12/2010

1. Implementação da mensagem M03_05 que envia o status da bobinade papel. Log de pouco papel do DigiREP.

1.3.23

22/12/2010

1.

A Senior divulgou a versão 1.3.22 como 1.3.23, por isto está versãoestá sendo gerada.

1.3.24

22/12/2010

1. Na verificação da situação do cartão, no tratamento da mensagemM05_12, foi adicionada a verificação da situação do cartão, se ocartão está dentro da faixa de tempo pré determinada.

1.3.25

22/12/2010

1. A data que é utilizada na mensagem M05_23 e a data capturada paracomparação com as datas da validade do cartão da na mensagemR05_10 passam a ter o GMT cadastrado nas propriedadesextensíveis aplicado nelas;

2. Na mensagem M02_31 o valor da posição 31 (Access credit range) de

0 (zero) passa a ter o valor 255. Está alteração foi requisitada pelaSenior, pois interfere no controle feito pelo Ronda.

1.3.26

26/01/2011

1. Corrrigido o problema de null pointer exception no tratamento da

lista de dispositivos. 1.4.0

26/01/2011

1. Utililiza versão 3.9.0 do framework;2. Resolvido o problema de múltiplas conexões ao mesmo tempo;3. Implementada a exclusão da pessoa do REP, quando está tem sua

permissão alterada (pendência Hering).

28/01/2011

1.

Implementada a configuração de data e hora dos dispositivos porpropriedades extensíveis, assim cada dispositivo deve ter asseguintes propriedades:

Identificador | Valor (valores de exemplo)GMT|-3INIVERAO| 10/10/2010FIMVERAO| 22/02/2011.

1.4.1 31/01/2011

1. Implementadas as mensagens M05_27 e M05_28, para exclusão do

colaborador quando este for demitido.

1.4.2 03/02/2011 1.

Corrigido o erro de não enviar GMT na mensagem M02_01. Faltouatribuir o valor do parâmetro ao atributo, na implementação feita naversão anterior.

1.4.3 07/02/2011 1. Alterada a mensagem M05_28, conforme email do Clóvis. Removidoos dois últimos bytes.

1.5.0 16/02/2011 1. Implementado o tratamento para o novo arquivo de logs.

1.5.1 18/02/2011 1. Corrigido o erro de excluir cadastros no tratamento do comandoinsert / updateperson.

1.6.0 21/02/2011 1. Implementada a propriedade extensível "COMPATIBILITY" e otratamento para o valor "UNICAMP". Cartão código de barras de usoexclusivo UNICAMP.

1.6.1 23/02/2011 1. Na versão anterior a exclusão por permissão acabou ficando

desabilitada.1.7.0 23/02/2011 1. Verifica qual tipo de arquivo de log o DigiREP está enviando e dá odevido tratamento.


6/49


1.8.0 25/02/2011 1. Considera todas as permissões da pessoa, diferente da versãoanterior que só considera a permissão de dias da semana.

01/03/2011 1. Implementada na propriedade extensível "COMPATIBILITY" e otratamento para o valor "CT".

1.8.1 02/03/2011 1. Alterada a pasta onde o arquivo CLIENTE.CFG deve estar deC:\Senior\Vetorh para C:\WINDOWS\.

1.8.2 14/03/2011 1.

Resolvido o erro que excluía pessoas indevidamente. O problema erado tratamento da lista de permissões, quando recebida. O númerode leitores da permissão vem em um byte, então se for maior que128 fica negativo, isto não estava sendo previsto, agora sim.

1.8.3 14/03/2011 1. Foi alterado quando o driver requisita a lista de demitidos, ao invés derequisitar quando o rep se conecta, será requisitado uma vez pordia, em um horário pré-determinado pelo usuário. Este horário éconfigurado no arquivo properties, através dapropriedaderesignation.Ex. resignation=02:04 ou resignation=17:23

1.8.4 24/05/2011 1. Alterado rotina de envio de cartões, para as tecnologias de cartão quea pessoa não possua é enviado um cartão com id = 0. Exemplo: Se apessoa possuir somente um cartão mifare, será enviado o cartão

mifare com seu id, um cartão rfid com id = 0 e um cartão de códigode barras com id = 0.

30/05/2011 1. Se 'VerifyBiometrics' for igual a 2 (Valida somente biometria) oscartões da pessoa são enviados com Id igual a zero.

1.8.5 16/06/2011 1. Alterado a forma de logar. O log txt agora são 50 arquivos de 10MB eo log html é por dia e os logs são quebrados em arquivos de 10MB.

1.8.6 17/06/2011 1. Na classe REPServer, no método que retorna a lista de reps, antes deadicionar o rep na lista que será retornada, é verificado se a conexãopossui um rep.

1.8.7 28/06/2011 1.

Criada propriedade no arquivo DriverREP.propertiesinitial.charge,aceita os valores 0, 1, 2 e 3, onde:

0 - realiza a carga inicial normalmente (como estava sendo feito)1 - não realiza carga inicial

2 - realiza carga inicial e exclui todos os cartões do colaborador3 - realiza a carga inicial apenas das biometrias

2. Criada propriedade no arquivo DriverREP.propertiesremove.card,aceita os valores 0 e 1, onde:

0 - não leva em consideração a flag "VerifyBiometrics"1 - verifica a flag "VerifyBiometrics" e se ela estiver com o valor=2 (1 x Ncartão ou biometria) remove os cartões do colaborador (mensagem de

atualização de cadastro).1.9.0 30/06/2011 1.

Quando o Rep informa que foi efetuado um cadastro no local, o drivercaptura as informações do colaborador e envias as biometrias para aCSM repassar para os demais Rep's. Resumidamente, esta é a versãoque suporta e trata o evento “cadastro local”.

1.10.0 01/08/2011 1.

Implementada a configuração do tipo de validação biométrica. Paraconfigurar o tipo de validação biométrica deve-se cadastrar noRonda, no cadastro do dispositivo uma propriedade extensível parao DigiREP com o valor "VB" (sem aspas). Os valores destapropriedade aceitos são 1,2 e 3, onde:

1 1:1 com o template no cartão mifare, esta opção exige que seja


7/49


enviado o mapa do cartão para o dispositivo com aplicativo específico(Instalador e Configurador DigiREP). Importante para este tipo devalidação o dispositivo NÃO pode conter nenhuma biometria cadastrada,caso tenha, precisa ser removida.2 1:N default (cartão ou biometria)

3 1:1 com template no leitor biométrico, ou seja, gravado no bancode dados do leitor.

Qualquer valor que não seja 1, 2 ou 3, toma-se como default o valor 2.Exemplo:

Identificador | Valor VB | 1

02/08/2011 1.

Removido o reenvio de mensagens caso estoure o time out deresposta do DigiREP. O Driver definirá o rep como off-line caso eledemore 90 segundos para responder. O driver requisita os eventos

para o rep de 10 em 10 segundos e aguarda a resposta do rep por 90segundos antes de desistir e fechar a conexão. 1.10.1 09/12/2011 1. Corrigido tratamento da propriedade extensível “COMPATIBILITY”,

CT8, para códigos com 8 (oito) dígitos, o valor CT apenas ficará paracódigos com 12 (doze) dígitos que já estava sendo tratado.

2.0.0Até

2.3.8

1. Novo instalador para melhorar e tornar o processo de instalação eatualização mais seguro e rápido;

2.

Retirado o tratamento de horário de verão e GMT do controle daspropriedades extensíveis, a partir desta versão estes controlesficarão a cargo de configurações do Ronda em: Plano de LocalizaçãoFísica e Cadastro de Dispositivos;

3. Alterado a forma do Driver de enviar dados aos dispositivos, antes

desta versão, por exemplo, precisava tomar decisões se enviava ounão um cartão baseado em datas de início e fim (validades), a partirdesta versão apenas aplica as atualizações recebidas da CSM paranos dispositivos indicados;

4. Alterado forma de responder a CSM os comandos, antes após receberum comando respondia com sucesso a CSM, agora responde sucessoapenas após ter conseguindo executar no dispositivo;

5. Alterado o controle de entrega de eventos de ponto para a CSM, apartir desta versão o Driver antes de enviar armazena em banco dedados próprio e tratará como eventos pendentes até que a CSMresponda recebido, desta forma caso a CSM fica parada, quandoreiniciar os eventos serão enviados;

6. Construído controle para habilitar o ponto pelo teclado, estaliberação será feita por dispositivo através de propriedadeextensível;

7.

Desenvolvido aplicativo WEB Browser para consultar em tempo realstatus dos dispositivos e lista de eventos pendentes;

8. A partir desta versão o Driver possui uma instalação Java própria,permitindo não termos mais problemas por atualizações do servidor;

9. Alterado o controle do armazenamento de logs, o cliente poderádecidir os níveis, indo de todos os tipos a nenhum armazenamento,sendo que os arquivos serão diários, podendo ser divididodependendo do nível por dispositivo;

10. Desenvolvido funcionalidade para limpeza do dispositivo apósreceber comando de carga inicial da CSM comandado pelo Ronda

Acesso.2.3.9 28/03/2012 1. Corrigido erro da conversão do NSR que limitava enviar números para


8/49


a CSM apenas até 65535.


9/49


Primeiros passos

É de extrema importância fazer uma completa leitura deste documento para oentendimento dos processos e funcionalidades.

Adquirir e instalar o DigiREP em conformidade com seus pré-requisitos do manual do

usuário.Possuir computadores com pré-requisitos listados a seguir neste manual.Fazer planejamento das atividades que precedem a utilização propriamente dos sistemas

aqui sendo tratados.

O que é preciso para enviar cadastros de colaboradores aos dispositivos

1º. Ter os dispositivos devidamente instalados e configurados com seus IP, IP do servidor,porta de comunicação liberada no servidor e gateway para alcançar o servidor.

2º. Ter conectividade liberada entre os equipamentos e o servidor onde esta o Driver.Observar que o dispositivo em um primeiro momento (cliente) é que procura o servidor parase autenticar. Após ser autenticado o dispositivo trabalhará como (servidor), fornecendo asrespostas das solicitações geradas pelo Driver (cliente), ou seja, após a autenticação toda açãoé comandada pelo Driver.

3º. Ter cadastrado os itens segundo documentação da Senior detalhado no tópico“Parametrizações do Ronda Acesso”.

4º. Proceder a Ligação dos Colaboradores através das permissões, todo envio ou remoção

de colaboradores das listas dos Dispositivos são através das permissões, mesmo com novocomando de carga inicial. No caso de remoção também pela demissão.

ATENÇÃO !!!

É de SUMA importância a alteração de data e hora nos equipamentos antes da carga inicialou seu uso inicial.

O Driver é totalmente dependente da CSM, caso por qualquer motivo esta fique off-line oDriver para imediatamente o serviço de comunicação com os DigiREP.


10/49


Entendendo o funcionamento do Driver com CSM e DigiREP

Este drive quando ativo faz a comunicação entre os DigiREP e a CSM (Central SecurityManager), camada de comunicação do Ronda Acesso da Senior Sistemas de Segurança.

Foi construído baseado no Driver Java (Framework Java) desenvolvido pela Digicon em

conformidade com SDK da Senior Sistemas de Segurança.A comunicação é bi-direcional, síncrona através de protocolo TCP/IP.É de suma importância e de responsabilidade do canal Senior a construção e

parametrização de registros conforme documentação da Senior.A seguir descrevemos o fluxo para melhor entendimento utilizando recortes dos arquivos

de logs.

Quando é iniciado o serviço no Windows

O Driver como é escrito na linguagem Java, quando iniciado como serviço instancia e iniciauma JVM (Java Virtual Machine).

Durante a inicialização do serviço é gravado um log na pasta de instalação, no diretório log com nome wrapper.log.

Na figura a seguir no recorte “A” representa uma inicialização normal.Na sequência em “B” uma inicialização com problema, normalmente é atribuído a versão

do Java não compatível, outra causa erros não tratados pelo Driver em tempo de execução“exceptions” são gravados neste arquivo de log.

A seguir o Driver faz a abertura do arquivo de configurações driver.conf que fica gravadona pasta conf .


11/49


Abrindo comunicação com a CSM

Caso os parâmetros estejam corretos e não exista nenhum bloqueio na conexão, seráiniciada a conexão com a CSM, caso tenha algum fator impeditivo seja parâmetro de IP e Portaerrado ou mesmo bloqueio de firewall, ocorrerá erro como mostrado na figura “D”.

Enviando certificado digital a CSM

Uma vez conectado com a CSM envia comando de autenticação, em “A” o Driver envia aCSM comando de autenticação, o certificado digital fornecido pela Senior e que esta na pastabin com nome DigiREP.CER que faz parte deste pacote e em “B” recebe resposta positiva daCSM.


12/49


Abrindo comunicação com DigiREP

Uma vez o Driver autenticado abre o servidor de conexões com DigiREPs “A”.O Driver autenticado pede lista de dispositivos presentes na CSM “B”. O drive pede lista de dispositivos para CSM “B” e lista de permissões “C”.

Recebe solicitação de autenticação do DigiREP

Como foi aberto o servidor de conexões em “A” da figura anterior, os DigiREP começa a

enviar pedido de autenticação, na figura a seguir “A”.

ATENÇÃO !!! Quando um DigiREP tenta se conectar ao Driver, a verificação é feita atravésdo número único do DigiREP (número da MRP), ou seja, para um dispositivo conseguir seconectar, este tem que ser previamente cadastrado no sistema com o seu número de sérieúnico co Ronda Acesso, Cadastro do Dispositivo. Este número tem um tamanho de 17(dezessete) caracteres, com a seguinte máscara:

EEEEEMMMMMSSSSSSS, onde:

E Empresa produtora do dispositivo, fixo Digicon = “00013”;M Modelo do equipamento conforme registro no MTE:

00082 BAR Barras e Mifare;

00083

BIO-BM

Biometria, Barras e Mifare;00086 PROX-B Proximidade HID;00087 BIO-PB Biometria e Proximidade HID;00088 PROX-A Proximidade INDALA;00089 PROX-C Proximidade ACURA.Consultar outros modelos que serão homologados.

S Número de série do Dispositivo com 7 (sete) dígitos.

A seguir a CSM responde a lista de dispositivos “A” e lista de permissões “B”.


13/49


Recebe colaborador a ser enviado ao DigiREP

Na figura a seguir o Driver recebe da CSM uma lista de colaborador

Driver envia colaborador ao DigiREP

Na figura a seguir temos um exemplo de envio de colaborador.Na linha 2013 o comando “02 25” representa o envio. Na linha 2017 o aceite do DigiREP “02 06 03”. Na linha 2020 a resposta do comando enviada pelo DigiREP “02 25”. Na linha 2024 o envio do aceite pelo Driver.No caso foi enviado um código de barras não presente no DigiREP, por isso a mensagem

“Barcode reader can´t to be found”.


14/49


Como funcionam alguns processos do Driver

Nesta secção será mostrado o quê ocorre durante alguns processos importantes dosistema.

Carga inicial

A carga inicial é um processo manual, que deve ser realizado pelo administrador dosistema através do Senior Ronda Acesso (Consultar manual do Ronda Acesso).

Quando a carga inicial é gerada e enviada pelo Ronda Acesso, antes do Driver enviar oscadastros para o respectivo dispositivo, é executada uma limpeza de registros, removendotodos os cadastros, cartões e biometrias de colaboradores que o DigiREP possui, após essalimpeza os cadastros são enviados um a um para o DigiREP.

Se durante a carga inicial a conexão com o dispositivo, ou até mesmo a conexão com oSistema Senior for perdida, a lista deve ser enviada novamente. Importante o Driver nãoarmazena o que já foi ou não enviado ao dispositivo, por isso deve ser executada de formaplanejada.

Bloqueio do ponto pelo teclado

Para bloquear o ponto pelo teclado é necessário criar uma propriedade extensível noCadastro do Dispositivo, no qual se deseja que os colaboradores NÃO registrem ponto peloteclado.

Nome da Propriedade ValoresPermitir Não Permitir

keyboard true false

Esta é uma informação que é enviada para o DigiREP no cadastro do colaborador, logopara ter efeito, após a propriedade extensível ser cadastrada, os colaboradores do respectivodispositivo devem ser reenviados para o equipamento, afim de terem seus cadastrosatualizados. Este tipo de informação não é contemplado no cadastro do colaborador no RondaAcesso, por este motivo é inserida através de propriedade extensível no cadastro dodispositivo.

Envio de eventos

Os eventos gerados (registro de ponto, pouco papel, portal fiscal utilizada, etc.) pelosDigiREPs e recebidos pelo Driver, não são enviados diretamente para a Concentradora Senior.

Quando o Driver recebe os eventos, primeiramente os guarda em um banco de dadospróprio, a fim de garantir que estes dados não sejam perdidos. Somente após isso o Driverresponde para o DigiREP que recebeu com sucesso os dados enviados pelo mesmo.

Os eventos então são enviados para a Concentradora Senior um a um, e somente após aConcentradora Senior responder que recebeu com sucesso cada evento, é que o Driver oremove do banco de dados do Driver.

Os eventos não enviados podem ser monitorados pela Console WEB.


15/49


Comando de data & hora

A data e hora enviada para o DigiREP é fornecida pelo sistema Senior, o Driver apenasrepassa a informação para o DigiREP. Na versão “1” era obtida do servidor onde estavainstalado o Driver.

Se necessário o Driver realiza o cálculo do horário de verão, conforme informaçõescadastradas no Plano de Localização Física.

Validação biométrica por Colaborador

No sistema Ronda é possível configurar três tipos de validação biométrica por colaborador:

# Modo Descrição

1 Valida somente crachá. É enviado somente o crachá para o DigiREP.

2 Valida crachá e biometria. É enviado o crachá e as biometrias para oDigiREP.

3 Valida somente biometria. É enviado somente as biometrias para oDigiREP.


16/49


Parametrização do Ronda Acesso

Para uma perfeita integração é necessário cadastramentos e parametrizações prévias noRonda Acesso.

Estes parâmetros e cadastros são divulgados pela Senior em BIS (Boletim Informativo

Senior – BIS-AS) e treinamentos específicos, através destas publicações ficamos sabendo sobrea criação ou retirada de parâmetros novos ou compatibilidades de versões da CSM.

Dúvidas deverão ser tratadas com suporte da Senior através da metodologia Senior deatendimento.

A seguir faremos um passo a passo com locais de cadastro e parâmetros do sistema RondaAcesso.

Site

1.

Cadastrar um Site em “Projeto Físico/Site”

a.

A concentradora enviará para o drive o CNPJ e Razão Social através docódigo da filial conforme figura “A”. No cadastro de Filial deverá tem umacom o campo Razão Social que NÃO poderá ser superior a 150 caracteres.


17/49


Plano de Localização Física

2. Cadastrar um Plano em “Projeto Físico/Plano de Localização Física/Plano”

a. No endereço colocar a nomenclatura que será utilizada paraconcentradora enviar junto com CNPJ e Razão Social, para localização doDigiREP. Conforme figura abaixo em “A”, este endereço Não pode ser

superior 100 caracteres, este endereço será utilizado na impressão doticket.

b. Na mesma tela em “B”, configurar o GMT, Início e Fim do Horário deVerão, a partir da versão “2” do Driver o mesmo não tratará estes dados

como propriedade extensível.


18/49


Driver

3. Cadastrar um Drive em “Projeto Físico/Dispositivo/SDK/Apollo/Drivers”

a. O código do Driver na figura exemplo “300” e que será exigido na tela deConfiguração das Propriedades.


19/49


Catálogo

4. Cadastrar um Catálogo em “Projeto Físico/Dispositivos/Catálogo”

a. Este cadastro servirá para agrupar os dispositivos DigiREP, contémparâmetros importantes para o perfeito monitoramento.

b. Na mesma tela de catálogo verificar se existe um específico para leitora,pois será necessário associar ao menos uma leitora para cada Dispositivo,caso não existe para leitor, cadastrar.


20/49


Dispositivo

5. Cadastrar os Dispositivos em Projeto Físico/Dispositivos/Cadastro”

a. São três guias importantes: Comunicação, Geral, Listas, InformaçõesExtensíveis e Eventos de Monitoramento.

b. Na guia “Comunicação” informar Tipo de Comunicação, Tipo de IP eEndereço IP caso seja IP Fixo.


21/49


c. Na guia “Geral” inserir em Número Fiscal o número completo com 17(dezessete) dígitos do DigiREP “A”, com a seguinte máscara:

EEEEEMMMMSSSSSSS, onde:

E

Empresa produtora do dispositivo, fixo Digicon = “00013”; M Modelo do equipamento conforme registro no MTE:

00082 BAR-M Barras e Mifare;

00083 BIO-BM Biometria, Barras e Mifare;

00086 PROX-B Proximidade HID;

00087 BIO-PB Biometria e Proximidade HID;

00088 PROX-A Proximidade INDALA;

00089 PROX-C Proximidade ACURA.

S Número de série do equipamento com 7 (sete) dígitos.

Em “B” observar que o endereço da localização que será impressono ticket, será preenchido através do cadastramento feito no “Planode Localização Física”.


22/49


d. Na guia Na guia “Listas” inserir uma lista de Multi-Tecnologia, seminformações de faixas, escolhendo conforme abaixo em “A”.


23/49


e. Na guia “Informações Extensíveis” apenas a propriedade VB (ValidaçãoBiométrica), caso o dispositivo possua tratamento de validação biométricadiferenciada 1:1, se for 1:N não é necessário esta propriedade, pois essa éassumida como Default.

Os valores possíveis da propriedade VB são os seguintes:

1 1:1 com o templates biométrico no cartão Mifare, esta opção exigeque seja enviado o mapa do cartão para o dispositivo com aplicativo específico(Configurador DigiREP). Importante para este tipo de validação o dispositivoNÃO pode conter nenhuma biometria cadastrada, caso tenha, precisa serremovida antes de qualquer operação. Com essa opção o Driver não enviatemplates ao dispositivo, apenas cartões, o mesmo esta subentendido que égravado no cartão Mifare.

21:N Default (Cartão ou Biometria)3 1:1 Com templates no leitor biométrico, ou seja, a biometria é

gravada no banco de dados do leitor. Para esta opção o Driver sempre enviarácartões e templates.

ATENÇÃO !!! Na validação 1:1 o firmware apenas pedirá aconfirmação da biometria caso as mesmas existam, ou seja, seestiver utilizando opção 1 (templates no cartão Mifare) e opção 2(templates no banco de dados do leitor), para cumprir o disposto daportaria, que NÃO se pode restringir o direito da marcação deponto, se o colaborador já tiver sido validado seu ponto com ocartão, a NÃO existência da biometria NÃO restringe o ponto.


24/49


f. Na guia “Eventos Monitoramento”, deveremos cadastrar os eventos queserão monitorados, tipo “Troca de Bobina”, “Nível de Papel Baixo”,

“Impressora sem Papel”, dentre outros liberados dependendo da versão

da CSM, escolhendo os tipos a seguir na figura “A”.

Leitora

6. Cadastrar uma leitora para o Dispositivo em Projeto Físico/Dispositivos/Cadastro”


25/49


Instalando o Driver

Obtendo o Driver

As versões do Driver após testes e homologação pela Senior Sistema de Segurança, sãopublicadas no endereço a seguir:

Site: FTP://ftpgd.perto.com.br Usuário: diginetSenha: digi.2010

Localizar a pasta CD-Diginet/Driver ou Documentos.

Caso o usuário não tenha um aplicativo cliente de FTP poderá utilizar a barra de endereçodo “Meu Computador” para baixar o Driver e este manual.

O que será instalado

JRE versão 1.6 (Máquina Virtual Java) Interpretador dos códigos gerados em Java. ODriver a partir da versão “2” utiliza sua própria JVM.

DIGICON – Driver DigiREPSenior Serviço de comunicação entre os dispositivos e a CSM.WebDriver Aplicação WEB para monitoramento do ambiente, esta aplicação utiliza o

Servidor de Páginas Tomcat embutido no Driver por isso não será visível como Serviço noWindows.

ftp://ftpgd.perto.com.br/ftp://ftpgd.perto.com.br/ftp://ftpgd.perto.com.br/ftp://ftpgd.perto.com.br/


26/49


Requisitos mínimos de ambiente

ATENÇÃO !!! Para evitar incompatibilidades, a partir da versão “2” do Driver eleinstalará sua própria versão do Java, NÃO desinstalar outras versões de Java queestiverem instaladas na máquina, é muito provável que outras aplicações estejam

utilizando.

Sistema operacional: Windows XP Sp 3 ou superior.

1 GB de RAM para uso exclusivo do Driver.

Processador: Core 2 Duo 2,8 GHz ou superior.

118 MB de espaço no disco regido para instalação.

1 GB de espaço no disco para armazenamento de logs que deverá teradministração do cliente.

Instalação e configuração da CSM conforme compatibilidade divulgada pelaSenior.

Instalação passo a passo

Após ter baixado o instalador do Driver, execute-o como Administrador, pois várioscomponentes que serão instalados precisam de privilégio.

Na tela de bem vindo, clique em Avançar.


27/49


Selecione o local da instalação, muita ATENÇÃO, pois o diretório sugerido é o padrão damáquina, caso queria ficar junto com ambiente da Senior, selecione Procurar, clique emAvançar.


28/49


Selecione a pasta para agrupamento dos aplicativos no Menu Iniciar, o padrão é Digicon,clique em Avançar.

Tudo pronto para instalar, conferir o resumo e clicar em Instalar.


29/49


Após seleção Instalar será iniciado a instalação, sendo como primeiro produto o JRE(Máquina Virtual Java).

Após a instalação dos arquivos necessários a instalação estará concluída.Clique no botão Concluir para fechar o assistente de instalação.


30/49


Configurando o Driver

Após clicar no botão Concluir, imagem anterior, a tela a seguir de configuração seráexibida, são parâmetros necessários para conectividade com a CSM e comportamento doDriver quanto ao armazenamento de Logs, consulta via WebDriver e tratamento do código de

barras.

Esclarecendo os seguintes parâmetros e seus significados:

Driver Id Código do Driver que deve ser cadastro no Ronda Acesso, em“SDK/Apollo”;

Compatibility Parâmetro para formato do código de barras, sendo:

barcode.mode.1Código de barras Telemática com 12 dígitos, na versão “1” eratratado como propriedade extensível no Ronda Acesso em “SDK/Apollo” como CT;

barcode.mode.2Código de barras Telemática com 8 dígitos, na versão “1” eratratado como propriedade extensível no Ronda Acesso em “SDK/Apollo” como CT8 e

barcode.mode.3Código de barras especial aplicável apenas a UNICAMP;

Log Level Parâmetro que indica o nível que os logs serão escritos, o único log que não éopcional é o da inicialização da JVM (wrapper.log), os logs que registram as operações doDriver e a CSM são opcionais, exceto se o usuário optar ALL (Todos) e OFF (Nenhum), osdemais serão combinados. Para facilitar o arquivamento e a limpeza destes arquivos, o Driverescreverá um arquivo por dia, a seguir explicamos os tipos possíveis:

ALL Gera todos os tipos de logs abaixo descritos;

FATAL Erros críticos, que fazem com que o sistema pare de funcionar. Geraráapenas este tipo;

ERROR Erros que não impedem o funcionamento do sistema. Serão gerados ostipos: ERROR e FATAL;


31/49


WARN Situações potencialmente prejudiciais. Serão gerados os tipos: WARN,ERROR e FATAL;

INFO Mensagens informativas sobre o progresso da aplicação. Serão gerados os

tipos: INFO, WARN, ERROR e FATAL;

DEBUG Informações mais detalhadas sobre o progresso da aplicação. Serão geradosos tipos: DEBUG, INFO, WARN, ERROR e FATAL;

TRACEMensagens extremamente detalhas sobre o progresso da aplicação. Serãogerados os tipos: TRACE,DEBUG, INFO, WARN, ERROR e FATAL e

OFF Não gera logs das operações do Driver, apenas da JVM “wrapper.log”.

CSM IP IP do servidor onde esta instalada a Concentradora da Senior é extremamente

importante que o IP e Porta estejam liberados no serviço de firewall de ambos os servidores.

CSM Port Porta de comunicação do servidor da Concentradora da Senior, esta portaatualmente é fixa com valor de 61000.

DigiREPs Port Porta de comunicação configurada nos dispositivos, todos devem ter amesma porta e devidamente liberada no serviço de firewall.

WebREP Port Porta de comunicação do Console HTTP para consultas de valores ependências.

Este Configurador do Driver também poderá ser acionado a qualquer tempo através doMenu Iniciar, conforme figura abaixo descrita em “Ambiente Instalado – Menu Iniciar”,escolhendo o item 4.

Após a configuração do arquivo de propriedades, será instalado o serviço do Driver e esteserviço será iniciado, onde se a Concentradora Senior já estiver sendo executada, a conexãocom ela já será estabelecida.

ATENÇÃO !!! Como anteriormente já explicado o Driver apenas permitirá que os DigiREPse conectem, permitindo trocar informações apenas SE estiver conectado na CSM.


32/49


Explorando o ambiente instalado – Menu Iniciar

A instalação do Driver cria no Menu Iniciar em Arquivos de Programas, os seguintes itenspara facilitar a manutenção, conforme figura abaixo:

(1)

Pasta Digicon conforme informado pelo usuário;(2)

Pasta do Driver para agrupar os programas e comandos;(3) Consulta Status do Serviço, mostrará o status do serviço no Windows em uma janela

do prompt de comando, conforme figura a seguir, para sair o usuário deve apenasfechar a janela;

(4)

Editar arquivo de propriedades, abrirá uma aplicação para editar o arquivo“driver.conf ” que fica na pasta “conf”, para aplicar as mudanças feitas deve -se “Parar”e “Iniciar” o Serviço, tarefa que pode ser executada de dentro do Editor;

(5) Iniciar Serviço,esta ação iniciará o serviço do Driver após alguma manutenção, uma janela do prompt abrirá conforme abaixo;

(6) Instalar Serviço, instala o Serviço após er sido Removido com item “10”; (7) Parar Serviço, esta ação irá parar o Serviço do Driver para manutenção, uma janela do

prompt abrirá conforme abaixo;

(8)

Remover DigiREP Driver, remove toda instalação do Driver, inclusive as pastas, cuidado

ao executar esta ação, faça cópias de segurança antes;(9) Remover Serviço, ação para remover o Driver do Serviço, apenas desinstala o Serviço.


33/49


Explorando o ambiente instalado – Diretórios

A instalação do Driver criará no local indicado pelo usuário uma pasta DigiREP Driver, as

pastas e arquivos conforme a figura a seguir.

Na pasta “bin” estarão todos os aplicativos de execução do Driver; os arquivos “.bat” todos

são chamados através do Menu Iniciar e seus itens; a partir da versão “2” do Driver, teremos

um servidor HTTP embutido para consultas das operações e atividades em memória, por issotemos a pasta “webapps” e “work”, que são pastas da publicação do Tomcat, conforme a

seguir.


34/49


Na pasta “conf” estarão dispostos os dois arquivos de configurações do Driver e Wrapper,

conforme a figura a seguir.O arquivo “wrapper.conf” são os parâmetros de inicialização da JVM.

O arquivo “driver.conf” na versão “1” era conhecido como “driver.properties”, nestaversão é mantido pelo Configurador do Driver.

Na pasta “icons” estão dispostos os ícones das aplicações criadas no Menu Iniciar.


35/49


A partir da versão “2” o instalador criará uma ambiente exclusivo do Java para o Driver,

desta forma através do arquivo “wrapper.conf” será direcionado esta execução, evitando

assim problemas com instalações “defaults” que podem sofrer atualizações constantes.

A pasta “lib” contém as bibliotecas (jar/DLL), utilizadas no Serviço do Driver(driverDigicon4Rep.jar), pelo Configurador do Driver (driverConfigurator.jar) e peloempacotador de classes Java o wrapper (wrapper.dll e wrapper.jar).

A pasta “log” contém os arquivos de logs conforme, explicação abaixo:

wrapper.log será escrito toda inicialização da JVM;driverInfo.log conforme opção assinalada no arquivo “driver.conf”;

driverError conforme opção assinalada no arquivo “driver.conf”; Pasta debugconterá os arquivos por dispositivo;


36/49


Console WEB Driver

Acessando a console

Objetivando oferecer mais informações e em tempo real, foi desenvolvido um aplicativocom interface WEB.

Esta console WEB poderá ser acessada via browser do endereço: HTTP://localhost:8384.

A seguir serão apresentadas e explicadas as telas desta console.

Sobre o Driver

Nesta guia são apresentadas as informações do Driver.

http://localhost:8384/http://localhost:8384/


37/49


Lista de dispositivos gerenciados

Nesta tela serão apresentadas a lista dos DigiREP, clicando na figura que representa umaseta no início de cada linha do dispositivo, serão listadas as informações detalhadas sobre odispositivo, no exemplo o dispositivo em questão é o 233.


38/49


Pendências não enviadas para CSM

Nesta tela serão apresentados os eventos recebidos do dispositivo e ainda pendentes, ouseja, ainda não foram enviados para CSM.

Status Descrição

0 Evento pronto para ser enviado para a Concentradora Senior.

1 Evento enviado para a Concentradora Senior, aguardando confirmação de

recebimento da concentradora para ser removido do banco de dados do Driver,considerar que fazem menos de 3 minutos que foi enviado, caso seja passados os 3

minutos este evento será reenviado.

2 Evento enviado para a Concentradora Senior, aguardando confirmação derecebimento da concentradora para ser removido.


39/49


Funções de Administrador

Para ter acesso as funções apresentadas nos próximos tópicos será necessário realizar ologin como Administrador, através do ícone exibido na imagem parte superior, conformeassinalado na figura a baixo.

O propósito desta seção é o fornecimento de informações para facilitar a homologação naSenior e consulta do ambiente interno do Driver que esta sendo executado.

Nesta seção em “Ferramentas” também é possível:

1-Recuperar biometrias coletadas diretamente no dispositivo e que por algum motivo nãoforam enviadas e

2-Recuperar os últimos 256 K (aproximadamente 15.000) de eventos de marcações deponto e de monitoramento, através de uma cópia circular que o firmware mantéminternamente em cada dispositivos.

Usuário: adminSenha: d1g1c0n@


40/49


Comandos do Protocolo Senior

Lista de comandos do protocolo Senior que estão implementados no Driver.


41/49


Eventos de Monitoramento

Eventos gerados pelo dispositivo, coletados pelo Driver e tratados como monitoramentono Ronda Acesso.


42/49


Processos Internos

Processos internos gerenciados pelo Driver.


43/49


Timers Internos

Timer são threads gerenciados pelo Driver.


44/49


Ferramentas

Ferramentas de manutenção, estas deverão ser executadas em extrema necessidade.


45/49


Atualizando o Driver

A atualização do Driver é executada da mesma forma que uma Instalação Normal, oinstalador irá parar o Serviço e baixar os novos arquivos.

ATENÇÃO !!! Na atualização não é necessário informar o diretório de instalação do Driver,

pois o próprio instalador identifica o diretório onde está instalado e atualiza os arquivos nestediretório.

ATENÇÃO !!! Apenas na primeira atualização do Driver 1 para o 2, orientamos as seguintestarefas:

1-Escolha um horário que não haja movimentação de eventos de ponto e monitoramento,evitando que sejam perdidos alguns eventos, pois estaremos parando o Driver e este pode serque esteja em atividade com a CSM;

2-Para o Driver através do Painel de Controle do Windows;

3-Faça cópia de segurança da pasta do Driver;

4-Remova o serviço atual do Driver utilizando o arquivo “.../Bin/Uninstalldriver-rep-NT.bat”;

5-Faça instalação do novo Driver através do capítulo Instalando o Driver;

6-Caso tenha alguma dúvida sobre a lista dos colaboradores presentes em cada dispositivopoderá refazê-la através de nova opção do Ronda Acesso de enviar carga inicial, muito cuidadopois esta nova funcionalidade removerá todos os colaboradores e reenviará, deverá ser

utilizada para casos suspeitos de muitos demitidos que não foram removidos.


46/49


Removendo o Driver

ATENÇÃO !!! Esta operação desinstala o Serviço assim como remove todas as pastas earquivos da instalação, tenha certeza que NÃO precisará dos conteúdos, se NÃO tiver estacerteza, faça cópia de segurança.

Estando certo da operação, acesse o Menu Iniciar em Arquivos de Programas, na pasta

Digicon, DigiREP Driver e escolha a opção “9”, conforme figura abaixo:


47/49


Problemas, compreendendo e resolvendo.

Mesmo com toda atenção e preocupação constante com nossos produtos, não estamosimunes de erros ou problemas.

Nosso processo de qualidade prevê melhoria contínua nos processos para

desenvolvimento de produtos e serviços, neste sentido estamos abertos a críticas e sugestões.

Estamos trabalhando compilando informações sobre análise de erros e situaçõesencontradas pelos usuários e em breve farão parte deste manual.

Acesse no site: www.digicon.com.br ou www.digirep.com.br

Se preferir enviar e-mail para: [email protected]

http://www.digicon.com.br/http://www.digirep.com.br/mailto:[email protected]:[email protected]://www.digirep.com.br/http://www.digicon.com.br/


48/49


Histórico de revisões do manual

Versão

Data

Descrição

1.7

03/03/2011

Criação deste documento com base no Manual de Instalação eOperação do Diginet 1.6.

Até a versão 1.6 este manual era único compartilhando todosos produtos de para integração com DigiREP (Driver eSistemas). Objetivo da segregação foi para melhorar a logística de distribuição epoder tratar de assuntos mais específicos.

1.8

29/03/2011

Ajustes nos dados de pré requisitos do Ronda Acesso para perfeitaintegração entre os sistemas.

1.9

03/06/2011

Inserido histórico de atualizações do Driver, criado a partir doarquivo versionNote.txt, mantido pelo desenvolvimento e que seencontra na pasta “../Bin”.

Inserido tópico sobre parametrização do Ronda Acesso.Inserido tópico com explicações sobre o funcionamento do Drivercom recortes do log de comunicação.

2.0

06/06/2011

Melhorias nos exemplos dos logs e parametrizações.Correções de ortografias.

2.1

01/08/2011

Melhoria em alguns exemplos.Inserção dos códigos de modelos dos DigiREPs em Entendendo oFuncionamento do driver em Cadastro de Dispositivos no tópicoParametrização do Ronda Acesso.Inserção da guia “Listas” em Cadastro de Dispositivos.

2.2

04/08/2011 Inclusão das alterações ocorridas 1.8.3 até 1.10.0 publicados no

histórico das versões.Inclusão da guia “Evento Monitoramento” em Cadastro de

2.3

31/03/2012 Alterações necessárias para liberação da versão 2.3.9.


49/49

Glossário

MP 1.510 Portaria do Ministério do Trabalho e Emprego (MTE) que disciplina ocontrole de ponto eletrônico (www.mte.gov.br/pontoeletronico/).

REPRegistradorEletrônicodePonto,definiçõesconformeportaria1.510de

21/08/2009. AFD Arquivo Fonte de Dados, conforme portaria 1.510.

Windows Marca registrada de sistema operacional da Microsoft Corporation.(www.microsoft.com).

WrapperFerramenta para “empacotar” os objetos Java do Driver e executá-loscomo serviço do Windows.

Java Linguagem de programação orientada a objeto, desenvolvida na década de90 por uma equipe de programadores chefiada por James Gosling, na empresa SunMicrosystems.

JVMJava Virtual Machine, responsável pela interpretação do código Java.

J2EE Java Platform Enterprise Edition ou Java Edição Empresarial éuma plataforma de programação para servidores na linguagem deprogramaçãoJava.

TomcatTambém conhecido como Apache Tomcat é um servidor WEBproduzidoe mantido pela fundação Apache com distribuição gratuita.

Ronda Ponto e Acesso Sistema de Ponto, Acesso e Monitor de REP, produzidopela Senior Sistemas (www.senior.com.br).

SDKSoftware Development Kit, conjunto de bibliotecas e padrões de protocolopara desenvolvimento de aplicativos para integração.
http://www.mte.gov.br/pontoeletronico/http://www.mte.gov.br/pontoeletronico/http://www.mte.gov.br/pontoeletronico/http://www.microsoft.com/http://pt.wikipedia.org/wiki/James_Goslinghttp://pt.wikipedia.org/wiki/Sun_Microsystemshttp://pt.wikipedia.org/wiki/Sun_Microsystemshttp://pt.wikipedia.org/wiki/Plataforma_(inform%C3%A1tica)http://pt.wikipedia.org/wiki/Servidorhttp://pt.wikipedia.org/wiki/Linguagem_de_programa%C3%A7%C3%A3ohttp://pt.wikipedia.org/wiki/Linguagem_de_programa%C3%A7%C3%A3ohttp://www.senior.com.br/http://www.senior.com.br/http://pt.wikipedia.org/wiki/Linguagem_de_programa%C3%A7%C3%A3ohttp://pt.wikipedia.org/wiki/Linguagem_de_programa%C3%A7%C3%A3ohttp://pt.wikipedia.org/wiki/Linguagem_de_programa%C3%A7%C3%A3ohttp://pt.wikipedia.org/wiki/Linguagem_de_programa%C3%A7%C3%A3ohttp://pt.wikipedia.org/wiki/Servidorhttp://pt.wikipedia.org/wiki/Plataforma_(inform%C3%A1tica)http://pt.wikipedia.org/wiki/Sun_Microsystemshttp://pt.wikipedia.org/wiki/Sun_Microsystemshttp://pt.wikipedia.org/wiki/Sun_Microsystemshttp://pt.wikipedia.org/wiki/James_Goslinghttp://www.microsoft.com/http://www.mte.gov.br/pontoeletronico/

Manual Driver Ronda Acesso

Documents

Transcript of Manual Driver Ronda Acesso