Config. do módulo MSA com disp. Real-Time

Config. do módulo MSA com disp. Real-Time Pablo Rafaelo Si - 29/11/2011

Config. do MSA com disp. Real-Time Sumário Sumário... 2 1 Parametrização java/server java/server-ponto e java/client... 3 1.1 Parametrização java/server e java/server-ponto... 3 1.1.1 Parametrizando a conexão com a base de dados... 3 1.1.2 Parametrização do serviço do ponto no server... 8 1.1.3 Parametrização do.../conf/devices.xml... 9 1.2 Parametrização java/client... 16 2 Criação do serviço do controle de acesso... 17 2.1 Configuração das variáveis de ambiente... 17 2.1.1 Criação da variável Java_home:... 17 2.1.2 Criação da variável Acesso_Server_Home:... 18 2.2 Criação do arquivo bat e instalação do serviço:... 18 2.3 Arquivos de log:... 20 2.3.1 Parametrização log integração dispositivos:... 20 2.3.2 Parametrização log integração ponto eletrônico:... 21 2.3.3 Parametrização log Java client:... 21 2 Config. Do módulo MSA com disp. Real-Time

Config. do MSA com disp. Real-Time. 1 Parametrização java/server java/server-ponto e java/client O módulo controle de acesso possui telas em progress e em Java, essa por sua vez se dividide em três: client, server e server-ponto. No diretório físico de programas do HCM eles são localizados em prghur/sap/java/, na qual, a pasta server se refere ao serviço de integração com os dispositivos real-time, a pasta server-ponto se refere aos dispositivos da portaria 1510 (REP), por fim, os programas da pasta client são as telas em Java do modulo Controle de Acesso, como: Cadastro de Visitantes, Monitor de Acesso, botão estrutura do perfil e da planta, etc. Os programas em Java precisam ser parametrizados para serem inicializados com alguns parâmetros pré-definido pelo cliente e também com dados de conexão com a base de dados. A seguir veremos com mais detalhes essas parametrizações. 1.1 Parametrização java/server e java/server-ponto Dentro da pasta server e server-ponto, caso não exista, deve ser criado o seguinte bat: Arquivo: /server/_ui-config.bat java -jar controleacesso-ui-2.5.2.jar com.datasul.hr.display.config.mainconfig pause Todas as configurações de parâmetros e de conexões com a base de dados do server são efetuadas nesse programa. 1.1.1 Parametrizando a conexão com a base de dados Abaixo segue o procedimento necessário para a correta parametrização das informações de conexão com o banco de dados (ems2uni, dthrtma, dthrpyc). 1.1.1.1 Inserção e parametrização da URL A URL indica o caminho exato do banco de dados, ou seja, IP do servidor que está rodando o banco, porta de conexão SQL e nome do banco de dados. Atualmente temos homologado quatro tipos de banco de dados: Oracle 9 ou 10G com Progress 10x, Progress 10x e SQL Server 2000. Para dispositivos telemática temos também o banco da telemática homologado para SQL Server 2000 ou 2003. Caso tenhamos os três bancos (TMA, PYC, UNI) separados, teremos que ter uma URL para cada um deles, porem se a base for unificada os bancos unificados terão URL iguais. Abaixo os exemplos de URL para cada tipo de base de dados. Config. Do módulo MSA com disp. Real-Time 3

Config. do MSA com disp. Real-Time URL SQL SERVER 2000 ou 2003: jdbc:jtds:sqlserver:// servidor_bd:1433 Onde está escrito servidor_bd alterar para o nome do servidor do banco de dados, 1433 é o numero da porta SQL para conexão no banco. URL ORACLE 9 OU 10G: jdbc:oracle:thin:@servidor_bd:1521:lhoracle Onde está escrito servidor_bd alterar para o nome do servidor do banco de dados, 1521 é o numero da porta SQL para conexão no banco e lhoracle é o nome lógico do banco. O usuário de conexão no banco deverá ter acesso de administrador. Segue abaixo imagem de exemplo. URL PROGRESS 10X jdbc:datadirect:openedge://servidor_db:20028;databasename=hr210;defaultschema=pub Onde está escrito servidor_db alterar para o nome do servidor do banco de dados, 20028 é a porta do broker SQL, hr210 é o nome físico do banco. O usuário de conexão com o banco deverá ser o sysprogress ou um com os mesmos níveis de permissões. Totvs11: No totvs 11 a URL do banco mguni deverá conter os dados de acesso para o banco que contiver a tabela empresa, normalmente é o banco ems2cad. Tambem terá uma aba para informar os dados de acesso ao banco fnd. 1.1.1.2 Inserção e parametrização do driver Cada versão de banco de dados terá uma versão de driver diferente, na tela de configuração do server, informaremos qual pacote de driver vamos utilizar nessa conexão. 4 Config. Do módulo MSA com disp. Real-Time

Config. do MSA com disp. Real-Time. Para cada tipo de banco de dados homologado teremos um package (driver) diferente: a) SQL Server: com.microsoft.jdbc.sqlserver.sqlserverdriver b) Progress 10x: com.ddtek.jdbc.openedge.openedgedriver. d) Oracle: oracle.jdbc.driver.oracledriver 1.1.1.3 Parametrização das conexões do broker SQL Parametrização necessária apenas para bancos Progress. No server após a configuração do driver, da url e usuário/senha, vamos parametrizar o campo Conexão (representa a faixa inicial e final da quantidade de conexões de escrita para o broker SQL) e Uncommited (representa a faixa inicial e final da quantidade de conexões de leitura para o broker SQL) com valores definidos conforme tabela abaixo: Config. Do módulo MSA com disp. Real-Time 5

Config. do MSA com disp. Real-Time Exemplo: Se tivermos 10 dispositivos instalados, teremos que ter no item Conexão para cada banco (TMA, PYC, UNI): em mínimo usando como base a regra para o banco TMA, deveremos pegar o numero de dispositivos e multiplicar por 60%, ou seja, 10 dispositivos multiplicado á 0,60 igual á 6 conexões mínimas. Para as conexões máximas deveremos seguir o mesmo procedimento, porem com a porcentagem de 80%: 10 dispositivos multiplicado á 0,80 igual á 8 conexões máximas. Para o campo Uncommited faremos a mesma coisa de acordo com a regra que segue na tabela acima, e assim iremos ter os valores de conexões para cada banco. Abaixo segue um exemplo de conexões para 10 dispositivos: Caso o resultado do valor das conexões máximas ou mínimas não seja um numero inteiro, o mesmo deve ser arredondado para cima. Exemplo: Empresa X possui 7 Dispositivos e está configurando as conexões para o banco TMA, seguindo as regras de cálculo chegou no resultado mínimo de conexões de 4,2 (0,6 x 7).Nesse caso deve-se arredondar para cima esse valor, ou seja, de 4,2 para 5. Abaixo segue exemplo de como adicionar esses valores da tabela no programa de parametrização do server: 6 Config. Do módulo MSA com disp. Real-Time

Config. do MSA com disp. Real-Time. Caso o banco seja unificado deve-se informar os valores se fossem bancos separados. 1.1.1.4 Numero de conexões SQL por dispositivo Para saber o numero de conexões SQL que deverá ser disponível no script de carregamento do banco Progress no broker SQL de cada banco (TMA, PYC, UNI), soma-se os campos máximo do item conexão mais a soma dos campos máximo do item Uncommited. No nosso exemplo acima com 10 dispositivos ficaria assim: Ou seja, caso o banco seja separado, teríamos que disponibilizar 21 conexões para o broker SQL do banco TMA, 5 conexões para o broker SQL do banco PYC e UNI. Caso os três bancos fossem unificados teríamos que multiplicar o numero total máximo de conexões do item Conexão mais o numero total de conexões do item Uncommited e multiplicar por três, ou seja, 31*3=93 conexões para o broker do banco unificado. Ainda se apenas fossem unificados somente os bancos TMA e PYC, somaria o numero máximo de conexões do item Conexão do banco TMA e o numero máximo de conexões do item Uncommited do banco TMA mais o numero máximo de conexões do item Conexão do banco PYC com o numero máximo de conexão do item Uncommited do banco PYC. Após isso, multiplicasse esse valor por dois. Seguindo nosso exemplo ficaria assim 21+5=26*2=52. Ou seja, para o banco unificado deverá ser disponibilizadas 52 conexões SQL, já para o banco UNI, apenas 5. Ainda deve-se somar nesse valor final de conexões disponíveis no broker SQL 1 conexão para cada Cadastro de Visitantes e 1 conexão para cada Monitor de Acesso. Seguindo as mesmas regras das bases unificadas, ou seja, se os três bancos forem unificados, serão 3 conexões a mais para cada Cadastro de Visitantes e Monitor de Acesso. Se somente o banco UNI não estiver unificado serão 2 conexões a mais nos broker dos bancos TMA e PYC e 1 no banco UNI para cada Cadastro de Visitantes e Monitor de Acesso acesso. Caso possua outros módulos que também utilizam o broker SQL dos bancos, deve-se somar as conexões já existentes as conexões reservadas para o acesso. Exemplo: Empresa X antes de implantar o modulo Controle de Acesso, possuía o módulo Monitor de Desempenho Web. Nesse exemplo digamos que o MDW utiliza 10 conexões, com a implantação do Controle de Acesso na empresa, a mesma deverá aumentar o numero de conexões SQL respeitando a regra do calculo acima e somando ao numero de conexões já existentes. Caso o banco de dados não consiga receber esse numero simultâneo de conexões SQL recomendado no calculo acima, o sistema do Controle de Acesso poderá ter instabilidades. Config. Do módulo MSA com disp. Real-Time 7

Config. do MSA com disp. Real-Time Java\server-ponto: A pasta server e server-ponto possuem as mesmas configurações, caso o cliente possua as duas pastas, para saber o numero total de conexões SQL que o banco de dados Progress deverá suportar, deve-se somar o numero de conxões necessária para as duas pastas. 1.1.2 Parametrização do serviço do ponto no server Para configurar o serviço do ponto eletrônico (prghur/sap/integracodin.r) para ser gerenciado via serviço Datasul Controle Acesso <fabricante>, devemos abrir o programa de parametrização do server e selecionar a aba serviço ponto, conforme imagem abaixo: O campo utiliza serviço do ponto através da integração?, deve está marcado. No campo comando, deve se inserir a linha de comando para a correta execução do programa de integração do ponto eletrônico. Abaixo segue o valor desse campo e o que significa cada parâmetro: C:\caminho_instalacao_progress\bin\prowin32.exe -pf C:\ caminho_programas_progress \pf.pf -basekey ini -ininame C:\ caminho_programas_progress\ini.ini -cpstream ibm850 -p c:\caminho_programas_progress\prghur\sap\integracodin.r -T \\servidor_de_programas\prghur\sap\java\server\log -b Onde está escrito caminho_instalação_progress alterar para pasta raiz da instalação do Progress no servidor do Controle de Acesso. Normalmente em c:\dlcxxx. Onde está escrito caminho_programas_progress, alterar para a pasta raiz dos programas do Datasul HCM. Normalmente em...\datasul\hcm210. Vale ressaltar que alguns clientes utilizam um diretório diferente, para esses clientes os mesmos deverão colocar o caminho da pasta onde encontramos os arquivos.ini e.pf do atalho de inicialização do HCM. Abaixo segue um exemplo. C:\dlc101a\bin\prowin32.exe -pf \\moles\datasul\hcm210\scripts\hcm210.pf -basekey ini -ininame \\moles\datasul\hcm210\scripts\hcm210.ini -cpstream ibm850 -p \\moles\datasul\hcm210\prghur\sap\integracodin.r -T \\moles\datasul\hcm210\prghur\sap\java\server\log \-b 8 Config. Do módulo MSA com disp. Real-Time

Config. do MSA com disp. Real-Time. Caso a base fosse unificada, teríamos um script de alias, e no lugar do parâmetro p teríamos que apontar para esse script de alias. Porem dentro do script teria que efetuar a chama do programa de integração com o ponto eletrônico da seguinte forma: run prghur\sap\integracodin.r. Caso o parametro p seja apontado dentro do arquivo.pf, teríamos que criar outro.pf para que esse seja exclusivo do acesso e apontar para nosso programa de integração. Exemplo: -p prghur\sap\integracodin.r. Lembrando que não são aceitos caminhos mapeados, apenas caminhos de rede (UNC). 1.1.3 Parametrização do.../conf/devices.xml Após cadastrar o dispositivo no modulo Controle de Acesso o mesmo deve ser relacionado a um arquivo chamado devices.xml. Esse arquivo devices.xml deverá ser criado dentro do diretório da pasta.../prghur/sap/java/server/conf caso seja um dispositivo de acesso (real-time) ou.../prghur/sap/java/server-ponto/conf caso seja um relógio de ponto (REP). Abaixo segue instruções do conteúdo desse arquivo para cada fabricante (Dimep, Telemática, Topdata, Henry 7x). 1.1.3.1 Dispositivos Telematica <?xml version="1.0" encoding="utf-8"?> <superserver> <configuration> <commandfactoryclass>com.datasul.hr.controleacesso.db.comando.hibernatecommandfactory</commandfactoryclass> <businessdaoclass>com.datasul.hr.controleacesso.db.hibernatebusinessdao</businessdaoclass> </configuration> <devicetype name="telematica"> <listenersenderserver> <devices> <devicenumber>1</devicenumber> <startlistenersender>true</startlistenersender> <deviceport>0</deviceport> <devicenumber>2</devicenumber> <startlistenersender>false</startlistenersender> <deviceport>0</deviceport> </devices> <serverclass>com.datasul.hr.controleacesso.server.telematica.server.telematicaserver</serverclass> <deviceclass>com.datasul.hr.controleacesso.server.telematica.device.telematicadevice</deviceclass> <deviceparserclass>com.datasul.hr.controleacesso.server.telematica.device.telematicaparser</deviceparserclass> <listenersenderclass>com.datasul.hr.controleacesso.server.telematica.listener.telematicalistenersender</listenersenderclass> <commandrmiclass>com.datasul.hr.controleacesso.server.command.remoto.commandcontrolrmitelematica</commandrmiclass> <digitoverificador>false</digitoverificador> </listenersenderserver> Config. Do módulo MSA com disp. Real-Time 9

Config. do MSA com disp. Real-Time </devicetype> </superserver> A cada novo dispositivo teremos que inserir uma nova tag dentro da tag <devices></devices>. Na tag <devicenumber> deveremos informar o numero do ID do dispositivo cadastrado no campo identificação do SA0620. Exemplo: Empresa precisa inserir no arquivo devices.xml 4 dispositivos. O dispositivo ID 4, dispositivo ID 5, dispositivo ID 10, e dispositivo ID 12. Basta então adicionar dentro da tag <devices> a tag com seus parâmetros. Sempre o primeiro dispositivo cadastrado terá que ter como valor na sua tag <startlistenersender> true, as demais serão false. <devices> <devicenumber>4</devicenumber> <startlistenersender>true</startlistenersender> <deviceport>0</deviceport> <devicenumber>5</devicenumber> <startlistenersender>false</startlistenersender> <deviceport>0</deviceport> <devicenumber>10</devicenumber> <startlistenersender>false</startlistenersender> <deviceport>0</deviceport> <devicenumber>12</devicenumber> <startlistenersender>false</startlistenersender> <deviceport>0</deviceport> </devices> 1.1.3.2 Dispositivos Henry <?xml version="1.0" encoding="utf-8"?> <superserver> <configuration> <commandfactoryclass>com.datasul.hr.controleacesso.db.comando.hibernatecommandfactory</commandfa ctoryclass> <businessdaoclass>com.datasul.hr.controleacesso.db.hibernatebusinessdao</businessdaoclass> </configuration> <devicetype name="henry5"> <listenersenderserver> 10 Config. Do módulo MSA com disp. Real-Time

Config. do MSA com disp. Real-Time. <devices> <devicenumber>1</devicenumber> <deviceport>3000</deviceport> <configuration> <timeshowmessage>2</timeshowmessage> </configuration> </devices> <serverclass>com.datasul.hr.controleacesso.server.listenersenderserver</serverclass> <deviceclass>com.datasul.hr.controleacesso.server.henry.protocolo7x.henryprotocolo7xdevice</deviceclass> Os novos dispositivos devem ser inseridos dentro da tag <devices>, para cada dispositivo deverá ser inserido um com seus respectivos parâmetros, onde a tag <devicenumber> equivale ao ID do dispositivo cadastrado no SA0620 no campo identificação. 1.1.3.3 Dispositivos TopData A estrutura padrão do devices da TopData é um pouco mais complexa, porem segue os mesmo parâmetros de inserção dos demais fabricantes, ou seja, para cada dispositivo adicionado deverá adicionar a tag dentro da tag <devices>. <?xml version="1.0" encoding="utf-8"?> <superserver> <configuration> <commandfactoryclass>com.datasul.hr.controleacesso.db.comando.hibernatecommandfactory</commandfactoryclass> <businessdaoclass>com.datasul.hr.controleacesso.db.hibernatebusinessdao</businessdaoclass> </configuration> <devicetype name="topdata"> <listenersenderserver> <devices> <devicenumber>1</devicenumber> <deviceport>3570</deviceport> <configuration> <TempoDisplayMessage>1</TempoDisplayMessage> <!-- Configurao Datasul --> <acionamentoporta>1</acionamentoporta> <!-- Mudana Automatica (offline) - Comando: 114 --> <ConfiguraMudancaAutomatica>1</ConfiguraMudancaAutomatica> <EntradasHabilitadasOffline>6</EntradasHabilitadasOffline> <EntradasHabilitadasOnline>1</EntradasHabilitadasOnline> <MensagemOffline> Offline </MensagemOffline> <PosicaoDisplay>1</PosicaoDisplay> <TempoEsperaOffline>10</TempoEsperaOffline> <TempoEsperaOnline>5</TempoEsperaOnline> <!-- Config. Do módulo MSA com disp. Real-Time 11

Config. do MSA com disp. Real-Time Mensagens (online) - Comando: 104 --> <MensagemOnline> Passe o Cartao </MensagemOnline> <!-- Configurao (offline ou/e online) - Comando: 100 --> <Acionamento1>1</Acionamento1> <Acionamento2>1</Acionamento2> <BioVeridPermiteCadastramento>0</BioVeridPermiteCadastramento> <CartaoMasterLiberaAcesso>1</CartaoMasterLiberaAcesso> <CodigoEmpresaMais>0</CodigoEmpresaMais> <CodigoEmpresaMenos>0</CodigoEmpresaMenos> <DadosOnlineComDataHora>0</DadosOnlineComDataHora> <DesabilitaBipQuandoForcadaPassagemCatraca>0</DesabilitaBipQuandoForcadaPassagemCatraca> <DesabilitaBloqueioAutomaticoCatracaTipoMicroSwitch>0</DesabilitaBloqueioAutomaticoCatracaTipoMicroSwitch> <EventosSensor>0;0;0</EventosSensor> <Extra1>0</Extra1> <Extra2>0;0;0;0;0</Extra2> <FuncaoDefaultParaLeitoresProximidade>0</FuncaoDefaultParaLeitoresProximidade> <LogicaRele>0</LogicaRele> <ModoOperacao>1</ModoOperacao> <NivelControleAcesso>0</NivelControleAcesso> <NumeroCartaoMasterParaCartoesTipoPLProx>000000000000</NumeroCartaoMasterParaCartoesTipoPLProx> <NumeroDigitosVariaveisAceitos>0;0</NumeroDigitosVariaveisAceitos> <OperacaoLeitor1>1</OperacaoLeitor1> <OperacaoLeitor2>2</OperacaoLeitor2> <PictogramasCatracaMillennium>0</PictogramasCatracaMillennium> <PossibilitarEntradaViaTeclado>1</PossibilitarEntradaViaTeclado> <RegistraTentativasAcessoNegadas>1</RegistraTentativasAcessoNegadas> <Reservados>0;0</Reservados> <Revista>0</Revista> <SinalizarCapacidadeFila>0</SinalizarCapacidadeFila> <TecladoEcoaAsteriscos>0</TecladoEcoaAsteriscos> <TempoAcionamento1>5</TempoAcionamento1> <TempoAcionamento2>5</TempoAcionamento2> <TempoParaEventosSensor>0;0;0</TempoParaEventosSensor> <TipoLeitor>0</TipoLeitor> <TipoListaControleAcesso>0</TipoListaControleAcesso> <UtilizarSenhaControleAcesso>0</UtilizarSenhaControleAcesso>--> <!-- Dados de Entrada (online) - Comando: 107 --> <EchoTeclado>1</EchoTeclado> <HabilitaFormasEntrada>6</HabilitaFormasEntrada> <NumeroDigitos>14</NumeroDigitos> <PosicaoCursorEntradaTeclado>17</PosicaoCursorEntradaTeclado> <TempoMaximoEntradaTeclado>10</TempoMaximoEntradaTeclado> </configuration> </devices> <serverclass>com.datasul.hr.controleacesso.server.listenersenderserver</serverclass> <deviceclass>com.datasul.hr.controleacesso.server.topdata.device.r1device</deviceclass> <deviceparserclass>com.datasul.hr.controleacesso.server.topdata.device.r1deviceparser</deviceparserclass> <listenersenderclass>com.datasul.hr.controleacesso.server.topdata.listener.topdatalistenersender</listenersenderclass> <digitoverificador>false</digitoverificador> </listenersenderserver> </devicetype> 12 Config. Do módulo MSA com disp. Real-Time

Config. do MSA com disp. Real-Time. </superserver> Os principais pontos de atenção quando estiver configurando um dispositivo são: Propriedade devicenumber deviceport TempoDisplayMessage acionamentoporta EntradasHabilitadasOffline MensagemOffline MensagemOnline Acionamento1 Descrição Número do dispositivo; Porta do dispositivo, a porta no Topdata é definida sendo a porta padrão + (NumeroDispositivo -1). Ex.: 3570 + (5 1) = 3574; Caso seja especificada uma porta manualmente, desconsidere a regra acima, e informe essa porta configurada. Tempo que a mensagem de liberação ou bloqueio do dispositivo ficará aparecendo; Usado para informar em qual acionamento esta localizada a porta; Informar quais entradas estão disponíveis em modo offline, podendo ser: 0 - não aceita entrada de dados 1- Aceita Teclado 2- Aceita Leitor 1 3- Aceita Leitor 2 4- Teclado e Leitor 1 5- Teclado e Leitor 2 6- Leitor 1 e Leitor 2 7- Teclado, Leitor 1 e Leitor 2 8- Sensor da Catraca Mensagem fixa a ser exibida quando offline; Mensagem fixa a ser exibida quando online; Usado para informar o que está conectado ao acionamento 1, podendo ser: 0- Não utilizado 1- Catraca para entrada e saída (urna, porta) 2- Catraca para entrada 3- Catraca para saída 4- Sirene 5- Revista 6- Catraca para entrada com saída liberada 7- Catraca para saída com entrada liberada 8- Catraca liberada em ambos sentidos Acionamento2 Idem Acionamento 1; OperacaoLeitor1 Informar como o leitor 1 irá funcionar: 0- Desativado 1- Somente para entrada 2- Somente para saída 3- Entrada e saída 4- Saída e entrada OperacaoLeitor2 TempoAcionamento1 TempoAcionamento2 HabilitaFormasEntrada Idem OperacaoLeitor1 Tempo que o acionamento 1 ficará acionado; Tempo que o acionamento 2 ficará acionado; Formas de entrada em modo online: 1- Aceita Teclado 2- Aceita Leitor 1 3- Aceita Leitor 2 4- Teclado e Leitor 1 Config. Do módulo MSA com disp. Real-Time 13

Config. do MSA com disp. Real-Time 5- Teclado e Leitor 2 6- Leitor 1 e Leitor 2 7- Teclado, Leitor 1 e Leitor 2 8- sensor da catraca micro-switch 9- sensor de giro da catraca (óptico) 10- teclado com verificação biométrica 11- leitor 1 com verificação biométrica 12- teclado e leitor 1 com verificação biométrica 13- leitor 1 com verificação biométrica e leitor 2 sem verificação biométrica 14- leitor 1 com verificação biométrica, leitor 2 sem verificação biométrica e teclado sem verificação biométrica. 1.1.3.4 Dispositivos Dimep Os dispositivos Dimep possuem protocolos diferentes para seus modelos (Dimep biométrico e Dimep Micropoint ), por esse motivo teremos arquivos devices.xml diferentes para cada um deles, porem o conceito de cadastro de ambos é o mesmo. 1.1.3.4.1 Dimep Micropoint A estrutura padrão do devices da Dimep Micropoint segue os mesmo parâmetros de inserção dos demais fabricantes, ou seja, para cada dispositivo adicionado deverá adicionar a tag dentro da tag <devices>, com seus respectivos parâmetros. A tag <devicenumber> indica o numero do ID do dispositivo cadastrado no SA0620 no campo identificação. <?xml version="1.0" encoding="utf-8"?> <superserver> <configuration> <commandfactoryclass>com.datasul.hr.controleacesso.db.comando.hibernatecommandfactory</commandfactoryclass> <businessdaoclass>com.datasul.hr.controleacesso.db.hibernatebusinessdao</businessdaoclass> </configuration> <devicetype name="dimep"> <listenersenderserver> <devices> <devicenumber>3</devicenumber> <deviceport>3000</deviceport> <devicenumber>4</devicenumber> <deviceport>3000</deviceport> </devices> <serverclass>com.datasul.hr.controleacesso.server.listenersenderserver</serverclass> <deviceclass>com.datasul.hr.controleacesso.server.dimep.dimepdevice</deviceclass> <deviceparserclass>com.datasul.hr.controleacesso.server.dimep.device.dimepdeviceparser</deviceparserclass> 14 Config. Do módulo MSA com disp. Real-Time

Config. do MSA com disp. Real-Time. <listenersenderclass>com.datasul.hr.controleacesso.server.dimep.listener.dimeplistenersender</listenersenderclass> <commandcontrolrmiclass>com.datasul.hr.controleacesso.server.command.remoto.commandcontrolrmimicro</commandcontrolrmi Class> <digitoverificador>false</digitoverificador> </listenersenderserver> </devicetype> </superserver> 1.1.3.4.2 Dimep Biopoint A estrutura padrão do devices da Dimep Biopoint segue os mesmo parâmetros de inserção dos demais fabricantes, ou seja, para cada dispositivo adicionado deverá adicionar a tag dentro da tag <devices>, com seus respectivos parâmetros. A tag <devicenumber> indica o numero do ID do dispositivo cadastrado no SA0620 no campo identificação. <?xml version="1.0" encoding="utf-8"?> <superserver> <configuration> <commandfactoryclass>com.datasul.hr.controleacesso.db.comando.hibernatecommandfactory</commandfactoryclass> <businessdaoclass>com.datasul.hr.controleacesso.db.hibernatebusinessdao</businessdaoclass> </configuration> <devicetype name="biopoint"> <listenersenderserver> <devices> <devicenumber>10</devicenumber> <deviceport>3000</deviceport> <devicenumber>11</devicenumber> <deviceport>3000</deviceport> </devices> <serverclass>com.datasul.hr.controleacesso.server.listenersenderserver</serverclass> <deviceclass>com.datasul.hr.controleacesso.server.dimep.device.biopointdevice</deviceclass> <deviceparserclass>com.datasul.hr.controleacesso.server.dimep.device.biopointdeviceparser</deviceparserclass> <listenersenderclass>com.datasul.hr.controleacesso.server.dimep.listener.biopointlistenersender</listenersenderclass> <commandcontrolrmiclass>com.datasul.hr.controleacesso.server.command.remoto.commandcontrolrmibio</commandcontrolrmicl ass> <digitoverificador>false</digitoverificador> </listenersenderserver> </devicetype> </superserver> Config. Do módulo MSA com disp. Real-Time 15

Config. do MSA com disp. Real-Time 1.2 Parametrização java/client A tela de parametrização do client é idêntica a tela de parametrização do Java servidor. Deveremos colocar nessa tela as mesmas informações de conexão com banco de dados informadas no server. A única alteração que deverá ser feita é no parâmetro de conexões do broker SQL Conexões e Uncommited que deverão ser configurados todos como 1 para todos os três bancos (TMA, PYC, UNI), conforme imagem abaixo: 16 Config. Do módulo MSA com disp. Real-Time

Config. do MSA com disp. Real-Time. 2 Criação do serviço do controle de acesso O programa que efetua a comunicação com os dispositivos e com o banco de dados do Datasul precisa ser configurado para funcionar em serviço, dessa forma o mesmo será gerenciado pelo sistema operacional. Esse serviço deve ser criado com o seguinte nome: Datasul Controle Acesso - <nome_fabricante>. Exemplo: Datasul Controle Acesso - Dimep, Datasul Controle Acesso - Henry, Datasul Controle Acesso - TopData, Datasul Controle Acesso - Telematica, etc. Se fosse um serviço referente a um dispositivo REP, então ficaria assim: Datasul Controle Acesso REP <nome_fabricante>. 2.1 Configuração das variáveis de ambiente Para o funcionamento dos programas em Java do Controle de Acesso faz necessário criação e alteração de algumas variáveis de ambiente no servidor. Na inserção do valor dessas variáveis não se deve inserir caminhos mapeado, e sim seu caminho de rede UNC: 2.1.1 Criação da variável Java_home: Variável responsável por determinar o diretório de instalação do Java. Disponível para download em: http://java.sun.com. Lembrando que a versão do Java homologada é a versão 1.5.x ou superior. Para verificar se seu computador já possui o Java instalado, execute o comando Java -version no MS-DOS: Caso retorne uma versão inferior a 1.5.x, atualize para a versão atual. Caso retorne uma acima ou igual a 1.5.x, procure o diretório de instalação do Java, que, normalmente se localiza em C:\Program Files\Java\jre1.x.x_xx. Localizado o diretório de instalação do Java, basta criar a variável de ambiente em variáveis do sistema, conforme imagem abaixo: Config. Do módulo MSA com disp. Real-Time 17

Config. do MSA com disp. Real-Time 2.1.2 Criação da variável Acesso_Server_Home: Variável responsável por determinar o diretório de instalação dos programas em Java do Server do Controle de Acesso. Esse diretório fica dentro dos programas do produto HCM na pasta...\...\java-server. Localizado o diretório de instalação do java-server, basta criar a variável de ambiente em variáveis do sistema, conforme imagem abaixo: 2.2 Criação do arquivo bat e instalação do serviço: Após criação e alteração das variáveis no servidor, deveremos criar o serviço de comunicação com os dispositivos Datasul Controle Acesso Servidor. Para isso será criado o arquivo JavaServicesInstall.bat dentro do diretório %ACESSO_SERVER_HOME%\bin. Abaixo segue o conteúdo do arquivo: %ACESSO_SERVER_HOME%\bin\JavaService.exe -install "Datasul Controle Acesso <nome_fabricante>" "%JAVA_HOME%\bin\client\jvm.dll" -Djava.class.path="%ACESSO_SERVER_HOME%\controleacesso-int-NOME_FABRICANTE- VERSAO.jar" -Xms64M Xmx512M -start com.datasul.hr.controleacesso.superserver.superserver -stop com.datasul.hr.controleacesso.superserver.superserver -method systemexit -out "%ACESSO_SERVER_HOME%\log\out.log" -err "%ACESSO_SERVER_HOME%\log\err.log" -current "%ACESSO_SERVER_HOME%" -auto -overwrite -startup 6 Onde está escrito %JAVA_HOME%\bin\client\jvm.dll, verificar se esse diretório existe, dependendo da instalação do Java, pode-se ter ao invés da pasta client a pasta server. Se esse for o caso adicionar o caminho onde encontra-se a DLL jvm.dll. Onde está escrito controleacesso-int-marca_dispositivo-versao.jar verificar dentro da pasta %ACESSO_SERVER_HOME% a existência desse arquivo e alterar esse valor para o correspondente ao arquivo (deverá ser usado o arquivo que tenha o nome do fabricante dos dispositivos instalados). Exemplo: %ACESSO_SERVER_HOME%\bin\JavaService.exe -install "Datasul Controle Acesso - Servidor" "%JAVA_HOME%\bin\client\jvm.dll" -Djava.class.path="%ACESSO_SERVER_HOME%\controleacesso-int-dimep-11.5.1.jar" -Xms64M -Xmx128M -start com.datasul.hr.controleacesso.superserver.superserver -stop com.datasul.hr.controleacesso.superserver.superserver -method systemexit -out "%ACESSO_SERVER_HOME%\log\out.log" -err "%ACESSO_SERVER_HOME%\log\err.log" -current "%ACESSO_SERVER_HOME%" -auto -overwrite -startup 6 18 Config. Do módulo MSA com disp. Real-Time

Config. do MSA com disp. Real-Time. Após a criação do arquivo bat, verifique se todos os caminhos são encontrados no servidor: a. %JAVA_HOME%\bin\client (verificar se existe o arquivo jvm.dll ) b. %ACESSO_HOME% c. %ACESSO_HOME%\log d. controleacesso-int-marca_dispositivo-versao.jar Salve o arquivo bat e execute o mesmo para que o serviço seja criado. Após isso execute o arquivo e a seguinte mensagem deverá ser mostrada: Com a criação do serviço siga os seguintes passos: a. Abrir o serviço do Windows (services.msc) b. Localizar o serviço criado. c. Abrir as Propriedades do serviço criado. d. Note que o campo Tipo de inicialização deve estar como Automático, caso não esteja, modifique-o. e. Clique na aba Recuperação, e altere os parâmetros em destaque para Reiniciar o serviço e clique no botão Ok, conforme figura abaixo: Config. Do módulo MSA com disp. Real-Time 19

Config. do MSA com disp. Real-Time f. Caso nas variáveis de ambiente criada tenha algum caminho de rede você deverá na aba logon do serviço inserir um usuário administrador para executá-lo. 2.3 Arquivos de log: O serviço criado acima Datasul Controle Acesso <nome_fabricante> é responsável pelo gerenciamento de dois programas em execução no sistema operacional: a....\prghur\sap\integracodin.p b....\prghur\sap\java\server\controleacesso-int-marcadispositivo-x.x.x.jar O programa integracodin é responsável pela importação das marcações de acesso que estão no banco dthrtma na tabela marcac_control_aces para importação de marcações de ponto no modulo de Controle de Freqüência - caso o dispositivo seja do tipo marcação de freqüência. Esse programa gera um log (logcodin.txt) dentro da pasta temporária do Progress definido pelo parametro T. O programa controleacesso-int-marcadispositivo-x.x.x.jar é responsável pela comunicação e interpretação da linguagem dos dispositivos, esse serviço é quem irá gravar as marcações efetuadas nos dispositivos para a base de dados do Datasul. Esse programa gera um log (Server_log.txt) no diretório %ACESSO_SERVER_HOME%\log, ou em outro pré-definido pelo cliente e também gera um log no diretório temporário do Progress chamado logsocket.txt. Esse ultimo log somente será criado caso o cliente possua integração com dispositivos da marca Telemática. 2.3.1 Parametrização log integração dispositivos: O arquivo "server_log.txt" trata-se de um arquivo de texto no qual são apresentadas as ações realizadas no serviço da integração quanto a sua comunicação, geração de permissões, validações de entradas, movimentações dos funcionários, visitantes, autônomos e prestadores de serviços. Normalmente este arquivo é gerado na estrutura de diretórios.prghur/sap/java/server/log", caso ocorra algum problema imprevisto no sistema, o arquivo de log "server_log" pode auxiliar na solução do problema. O tamanho dos arquivos gerados está relacionado diretamente à versão da Integração Datasul, a marca do dispositivo instalado e o fluxo de movimentação dos usuários. Por definição, é gerado um arquivo para cada dia (à partir da data que o módulo é instalado) onde se faz necessário a manutenção periódica do diretório em que os logs estão armazenados para não exceder a capacidade em disco (pois estes arquivos nunca são eliminados do sistema). Pensando no problema de armazenagem destes logs, há uma alternativa de restringir o tamanho dos arquivos, dentro da pasta raiz da integração com os dispositivos.../.../java/server/, existe um arquivo onde efetuamos essa configuração, segue abaixo os parâmetros que devem ser modificado no arquivo "/conf/log4j.propert #Log em um.txt log4j.rootlogger = INFO, consoleout, fileout log4j.appender.fileout = org.apache.log4j.rollingfileappender ##### TAMANHO DE CADA ARQUIVO DO LOG ##### log4j.appender.fileout.maxfilesize = 150MB log4j.appender.fileout.maxbackupindex = 10 ##### ESTRUTURA DE DIRETÓRIOS ONDE O ARQUIVO É GERADO ##### log4j.appender.fileout.file = log/server_log.txt log4j.appender.fileout.layout = org.apache.log4j.patternlayout log4j.appender.fileout.layout.conversionpattern = [ %d ] [ %r ] %C %-5p %-5c{3} %x -> %m%n 20 Config. Do módulo MSA com disp. Real-Time

Config. do MSA com disp. Real-Time. Com esta configuração, o sistema cria 10 arquivos de backup (logs antigos) de 150MB cada, ou seja, o sistema ocupará no máximo 1650MB (10 arquivos de backup com 150MB + 1 arquivo de execução corrente com 150MB). O arquivo "logsocket.txt" trata-se de um arquivo de texto onde são apresentados toda a parte de requisições e comunicação (logs) entre a parte Progress (HR Datasul) com o sistema da Integração Datasul cujos dispositivos pertencem à marca "Telemática". Este arquivo é gerado no diretório temporário do Progress (-T), caso o sistema apresente algum problema com a sincronização das informações e/ou comunicação entre as partes, uma análise efetuada neste arquivo pode auxiliar na solução do problema. 2.3.2 Parametrização log integração ponto eletrônico: O arquivo "logcodin.txt", trata-se de um arquivo de log gerado pelo programa "...\prghur\sap\integracodin.r" (programa de importação automática das marcações do Controle de Acesso para o Ponto Eletrônico e geração das permissões de acesso para os usuários do módulo que possuem um perfil associado) no qual é executado pelo serviço "Datasul Controle Acesso Servidor". O arquivo logcodin,txt é gerado no diretório temporário do Progress (-T) e caso ocorra algum problema na geração automática das permissões ou na importação das marcações, uma análise efetuada neste arquivo pode auxiliar na solução do problema. 2.3.3 Parametrização log Java client: Assim como a integração com os dispositivos que gera seu log server_log.txt dentro da pasta...\prghur\sap\java\server\log ou...\prghur\sap\java\server-ponto\log, os aplicativos em Java do Controle de Acesso, como o Cadastro de Visitantes e Monitor de Acesso, geram um log de execução também chamado de server_log e o mesmo é criado por default na pasta...\prghur\sap\java\client\log. Para alterar o caminho aonde o log será gerado, consulte o item 2.3.1. Config. Do módulo MSA com disp. Real-Time 21