Histórico da Página

...

Totvs custom tabs box

tabs	Pré-requisitos, Recursos Suportados, Instalação/Desinstalação, Configuração do Serviço, Configuração de Equipamentos/Catracas, Monitoramento
ids	prerequisitos,recursos,instalacao,configuracao,catracas,monitoramento

Totvs custom tabs box items

default	yes
referencia	prerequisitos

Ambiente

Windows Server 2012 R2 ou superior
Driver do banco de dados SQL Server "SQL Server Native Client 11.0"
Pasta (Redist) de redistribuição do TOTVS Logística Recintos Aduaneiros registrada na máquina. Essa pasta com os arquivos de redistribuição acompanha os pacotes do TOTVS Logística Recintos Aduaneiros juntamente com um arquivo "Redist_SARA_Register.bat" para registra-la.
Driver dos equipamentos de controle de acesso seguro (catracas) do fabricante utilizado, caso possua.
1. para o Henry 8x não é necessário instalação de driver, pois a comunicação é feita diretamente via socket com os equipamentos.
Módulo de Controle de Acesso do TOTVS Logística Recintos Aduaneiros na versão 12.1.45 ou superior

Totvs custom tabs box items

default	no
referencia	recursos

Computacional

Serviço do Windows
Multi-thread. Cada equipamento utilizará uma ou mais threads de processamento e não compartilhará recursos computacionais entre outros equipamentos.

Controle

Controle de acesso online
1. crachás mestre
2. validações de permissão de acesso (permissões de funcionários/visitantes e acesso temporário, acessos duplicados, lista branca BDCC)
3. controle de bloqueio de pessoas
4. controle de crachás inativos
5. controle de perfis de acesso
6. controle de horários permitidos de acesso
7. controle por pontos de acesso internos
8. controle de biometrias e crachás de visitantes (para recolhimento de crachás para equipamentos com urna)
9. controle para diferentes tipos de equipamentos (catracas, torniquetes e totem)

Gerenciamento

Criptografia para configurações de acesso ao banco de dados
Integração de lista de crachás de visitantes
Integração de listas de biometrias
Recurso de controle de logs por equipamento em arquivo, permitindo ativar e desativar o monitoramento em arquivo. Logs do serviço de servidor de catraca (execução e erros), log do gerenciador de equipamentos e log por equipamento, todos em arquivos distintos.
Recurso de reconexão automática para equipamentos offline por perda de conexão
Recurso de integração automática nos equipamentos para biometrias registradas no módulo de controle de acesso do TOTVS Logística Recintos Aduaneiros
Sincronização automática de lista de crachás de visitantes, relógio e configurações de equipamentos na inicialização do serviço.

Totvs custom tabs box items

default	no
referencia	instalacao

Para realizar a instalação do novo serviço de servidor de catracas, primeiro deve-se criar uma pasta para instalação do serviço. Recomendamos criar em "C:\SARA\Services\ServidorCatracaService", mas caso desejar, pode ser criado outra estrutura a escolha. Para essa documentação, será considerado a estrutura sugerida.

Guia de Instalação

Remova as opções de somente leitura do diretório de instalação. Exemplo: "C:\SARA\Services\ServidorCatracaService"
Mova o arquivo "ServidorCatracaService.exe" para o diretório de instalação pretendido
Abra o programa "CMD" (Prompt de comando) do Windows com privilégios de administrador
No CMD, navegue até o diretório de instalação
execute o comando: ServidorCatracaService.exe /install
Com a instalação bem sucedida, o novo serviço aparecerá em "services.msc"

Guia de Desinstalação

Abra o programa CMD do Windows com privilégios de administrador
Navegue até o diretório de instalação do serviço de servidor de catraca. Exemplo:
Execute o comando: ServidorCatracaService.exe /uninstall
como alternativa, o comando "sc delete sServidorCatracaService" também pode ser utilizado para desinstalação do programa

Para detalhes de configuração, consulte a aba "Configuração" deste documento.

Totvs custom tabs box items

default	no
referencia	configuracao

Após a instalação do serviço, esse programa deverá ser configurado para comunicação com o banco de dados, escolha dos diretórios de logs e ativação de recursos desejados.

Na instalação do programa, automaticamente será criado um arquivo no diretório de instalação chamado "ServidorCatracaService.ini" para as configurações do serviço.

Bloco de código

language	text
title	Exemplo de arquivo ServidorCatracaService.ini criado

[FILESECURITY]
Active=0
[DBCONNECTION]
DatabaseID=MSSQL
ServerName=
DatabaseName=sara_db
User=sa
Password=
[SERVICEFILES]
ErrorLog=C:\SARA\Services\ServidorCatracaService\LogsServicoCatracas\ServidorCatracaServiceError.log
ExecutionLog=C:\SARA\Services\ServidorCatracaService\LogsServicoCatracas\ServidorCatracaServiceExecution.log
EquipmentManagerLogDirectory=C:\SARA\Services\ServidorCatracaService\LogsCatracas\
EquipmentsLogDirectory=C:\SARA\Services\ServidorCatracaService\LogsCatracas\
[SERVICE]
ServiceName=TOTVS | Servidor de Catracas - Recintos Aduaneiros
LogEquipmentsInFileOnStart=0
AutoReconnectOfflineEquipmentsOnStart=0
IntervalAutoReconnectOfflineEquipments=60000
AutoRegisterBiometricsInEquipmentsOnStart=0
IntervalRegisterBiometricsInEquipments=120000

Detalhamentos das Configurações

FILESECURITY	Parâmetro	Descrição
FILESECURITY	Active	se configurado com valor 0, irá realizar uma criptografia para os parâmetros User e Password. Após a criptografia aplicada pela execução do serviço, o seu valor irá automaticamente ser alterado para 1, indicando que a criptografia de segurança foi aplicada ao arquivo. OBS: Para alterar os dados de autenticação com o banco de dados, retorne esse valor para 0 e modifique novamente os dois campos User e Password. Após o serviço ser iniciado, a criptografia será aplicada novamente.
DBCONNECTION	DatabaseID	identificação do driver de banco de dados utilizado. Valor padrão "MSSQL". Não deverá ser alterado.
	ServerName	nome do servidor/instância do banco de dados SQL Server.
	DatabaseName	nome da base de dados a ser conectada. Exemplo: sara_db
	User	usuário para autenticação no banco de dados. Recomenda-se sempre utilizar o usuário "sa" por possuir maiores privilégios que o serviço de servidor de catracas pode necessitar com o banco de dados. OBS: para alterá-lo, reveja o item Active de FILESECURITY.
	Password	senha do usuário para autenticação com o banco de dados. OBS: para alterá-lo, reveja o item Active de FILESECURITY.
SERVICEFILES	ErrorLog	arquivo onde será salvo os logs de erro do serviço de servidor de catracas (apenas log do serviço).
	ExecutionLog	arquivo onde será salvo os logs de execução do serviço de servidor de catracas (apenas log do serviço).
	EquipmentManagerLogDirectory	diretório onde será salvo os logs do gerenciador de equipamentos de catracas. Este log limita-se ao mecanismo de gerenciamento como servidores adicionados/removidos, integração de listas de crachás de visitantes, integração de listas de biometrias, início e parada do gerenciador, etc.
	EquipmentsLogDirectory	diretório onde será salvo os logs individuais de cada equipamento (catraca) conectado ao gerenciador. Este log irá mostrar as requisições online realizadas, validações, etc.
SERVICE	ServiceName	nome do serviço de servidor de catracas que será apresentado no "services.msc" do Windows.
	LogEquipmentsInFileOnStart	permite ativar o monitoramento de acessos aos equipamentos por arquivos de log já na iniciação do programa. Valor 0 não gera logs dos equipamentos em arquivo e valor 1 gera o log dos equipamentos em arquivos.
	AutoReconnectOfflineEquipmentsOnStart	permite ativar a reconexão automática de equipamentos que ficarem offline por perda de conexão mantendo a configuração ativada ou desativada já na iniciação do programa. Valor 0 desativa a reconexão automática e valor 1 ativa a reconexão automática.
	IntervalAutoReconnectOfflineEquipments	intervalo de checagem de equipamentos offline para reconexão automática. Tempo configurado em milisegundos.
	AutoRegisterBiometricsInEquipmentsOnStart	permite ativar o envio automático de biometrias cadastradas no módulo controle de acessos do TOTVS Logística Recintos Aduaneiros já na iniciação do programa. Valor 0 desativa o envio automático e valor 1 ativa o envio automático. OBS: o registro de biometrias nos equipamentos possui um desempenho baixo por conta do módulo de biometria nos próprios equipamentos. Cada biometria enviada leva alguns segundos no equipamento para efetivação do cadastro.
	IntervalRegisterBiometricsInEquipments	intervalo de checagem de biometrias pendentes de integração com o equipamento de catracas. Tempo configurado em milisegundos. OBS: por conta do baixo desempenho nos equipamentos nos módulos de biometria para registro, recomenda-se não utilizar intervalos muito curtos de checagem.

Após as configurações realizadas, o serviço já pode ser iniciado em "services.msc" pelo botão "Iniciar".

Totvs custom tabs box items

default	no
referencia	catracas

A configuração dos equipamentos (catracas) continua no módulo Controle de Acesso, menu Cadastros, submenu Catraca do TOTVS Logística Recintos Aduaneiros. Os drivers para o novo servidor de catracas em serviço será reconhecido pelo cadastro do campo Modelo da tela de Cadastro de Catraca. Exemplo: para a catraca conectar-se a um equipamento do fabricante Henry driver Henry 8x, selecione o modelo HENRY 8X no cadastro, conforme imagem de exemplo abaixo:

Informações

title	IMPORTANTE

Modelos ainda não suportados pelo novo servidor de catracas em serviço serão ignorados pelo gerenciador. Clientes que possuem equipamentos/catracas com drivers suportados somente pelo servidor de primeira versão, não poderão aproveitar a nova solução.

Totvs custom tabs box items

default	no
referencia	monitoramento

O monitoramento do serviço de servidor de catracas poderá ser realizado de duas maneiras. Por arquivos de log e por aplicativo de monitoramento.

Por Arquivos de Log

Para ser possível o monitoramento dos acessos por arquivos de log, o parâmetro LogEquipmentsInFileOnStart deve estar ligado com o valor 1 no arquivo "ServidorCatracaService.ini". Desse modo, cada equipamento gerará um arquivo com a data do dia atual e com o nome do equipamento, permitindo visualizar as interações de acesso realizadas por aquele equipamento.

Para acessar os arquivos de logs gerados, basta acessar o diretório configurado em EquipmentsLogDirectory no arquivo "ServidorCatracaService.ini". A imagem abaixo representa um arquivo de log de um determinado equipamento:

Os arquivos de log do gerenciador de equipamentos pode ser acessado pelo diretório configurado em EquipmentManagerLogDirectory no arquivo "ServidorCatracaService.ini". A imagem abaixo representa um arquivo de log do gerenciador de equipamentos:

Image Added

Já os logs de execução e erros do serviço do Windows de servidor de catracas pode ser acessado pelos arquivos configurados nos parâmetros ExecutionLog e ErrorLog configurados no arquivo "ServidorCatracaService.ini". A imagem abaixo representa os logs de execução e erro do serviço.

Image Added

Por Aplicativo de Monitoramento

Este recurso ainda está em construção.

...

Árvore de páginas

Versões comparadas

Versão antiga 37

Nova versão 38

Chave