Páginas filhas
  • Guia de Instalação TSA 12.1.11

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Para dar início ao processo de atualização para o Datasul, o sistema deve obedecer a versão de pacote de origem (entre parênteses) suportado pela atualização, conforme definições da tabela a seguir:

Servidor
30 equipamentos
Hardware (mínimo)
Disco100 GB disponíveis
Memória

Até 30 dispositivos: 6 GB disponíveis *

Até 60 dispositivos: 9 GB disponíveis *

Processador

Até 30 dispositivos: Intel Core i5 3.00 GHz (ou compatível com 5125 **CPU Passmark) 64 Bits

Até 60 dispositivos: Intel Core i7 3.30 GHz (ou compatível com 5600 **CPU Passmark) 64 Bits

Banda de Dados100 Mbps
Software
JavaJRE 1.6.0_45 64 Bits (embutido na instalação). Java 1.7 (ou superior) não está homologado.
Sistema OperacionalWindows ou Linux (verificar compatibilidade dos softwares de integração do fabricante do equipamento)
Bancos de Dados
Oracle10g R1, 10g R2, 11g R1,11g R2
Microsoft SQL Server2005, 2008 R2, 2014.
Informix10, 11.5
DB29.1, 9.5, 9.7
Progress (apenas Sistema Externo)10.2B SP 07
MySQL5.1
Sistema de Gestão de Pessoas
Sistema de Gestão de Pessoas (Sistema Externo)
Datasul HCM12.1.4 e superiores
Protheus 1111.x.x e superiores
RM Chronus 1111.8.x e superiores
Estação Client
Windows / Linux
Hardware
 

Memória1 GB
Processador1.00 GHz
Resolução de Tela1024 x 768 ou superior
software
Navegadores

Internet Explorer 10

Firefox 3.6

Chrome 10

WebcamDeverá possuir o plugin da Macromedia Flash instalado e uma Webcam compatível com o flash.
Nota
titleImportante:

* O valor especificado para a memória é exclusiva para o TSA. Dessa forma, é necessário mensurar um valor de memória RAM para o sistema operacional e outros serviços que rodem no servidor.

** O cálculo de passmarks é feito pelo site: http://www.cpubenchmark.net/high_end_cpus.html

...

Caso tenha a necessidade de solicitar a homologação de um novo firmware, por favor, abra um chamado com a equipe de atendimento.

Controle de Acesso
FabricanteModeloFirmware
DimepTodos os modelos compatíveis com a versão de firmware homologada.

Biopoint: 2.16, 2.21

Micropoint: 3.2, 3.6

MadisTodos os modelos compatíveis com a versão de firmware homologada.MD5705: 2.16
HenryTodos os modelos do protocolo 7.x compatíveis com a versão de firmware homologada.7101
TelemáticaTodos os modelos compatíveis com o software da Telemática Conex (que operem com a tabela MATCODIN e que não possuam ARLON).*
TopDataLinha de produto Inner Net e Inner Plus

Inner Net: 2.03

Inner Plus: 8.58, 9.0.2

Aviso
titleAtenção:

Todos os dispositivos, independente de fabricante, devem ter funcionamento ON-LINE e REAL TIME. Dispositivos MD2701 da Madis não são homologados. Dispositivos Micropoint XP da Dimep não são homologados.

Ponto Eletrônico (Portaria 1.510/2009)
FabricanteModeloFirmware
DimepTodos os modelos compatíveis com as versões de firmware homologadas. Este fabricante possui equipamentos para a Portaria 373/11 do MTE.

REP 48 01.00.0002

REP 48 02.04.0000

REP 48 02.08.0000

PrintPoint III – 02.02.0000

Modelos: PrintPoint II e PrintPoint III, TimePoint II e MiniPrint.


MadisMD0705 e MD REP.

REP 48 01.00.0002

REP 48 02.04.0000

REP 48 02.08.0000

Modelos: MD0705 e MD REP

TelemáticaTodos os modelos compatíveis com o software da Telemática (CONEX REP)CONEX REP 01.00.01A
Henry

Prisma

Prisma Super Fácil

8.0.0.76

00.00.00.0

Funcionalidades Controle de AcessoDimep Biopoint IIDimep MicropointMadis MD5705Henry 7xTelemáticaTop Data
Controle de Acesso
Possui Suporte Biométrico no TSASimNãoSimSimSimNão
Replicação de Biometria (Cópia da Biometria para outros dispositivos?)SimNãoSimNãoSimNão
Controle de NíveisSimSimSimSimSimSim
Valida permissões por entrada e saídaSimSimSimSimSimSim
Valida dupla marcaçãoSimSimSimSimNãoSim
Dependência de Software do Fornecedor/FabricanteNãoNãoNãoSimSimNão
Integração com UrnaSimSimSimSimSimNão
Lista BrancaSimSimSimSimNãoNão
Cracha liberadorSimSimSimSimNãoSim
Baixa automatica de crachás no Cadastro de VisitantesSimSimSimSimSimNão
Informação Data/hora quando on-line horario da marcaçãoServidorServidorServidorServidorConexServidor
Funcionalidades Ponto EletrônicoDimep PrintPoint II Time Point IIDimep MiniPointMADIS MD REP MD0705TelemáticaHenry Prism+B18:G23a/Superfácil
Ponto Elêtronico
Possui Suporte Biométrico no TSASimSimSimSimSim
Replicação de Biometria (Cópia da Biometria para outros dispositivos?)SimSimSimNãoSim
Valida permissões de acessoNãoNãoNãoNãoNão
Informação Data/hora quando on-line (Horario da marcação)DispositivoDispositivoDispositivoCONEXDispositivo
  1. Ativação da funcionalidade é por parte do fornecedor do hardware.
  2. Telemática não possui validação de Entrada e Saida.
  3. Para a replicação das biometrias do PrintPoint III é necessário que o técnico da Dimep habilite a configuração de “Reconhecimento Biométrico a 180º (Sagem)”. Para que as biometrias sejam intercambiáveis entre PrintPoint III e outros dispositivos do fabricante é necessário apenas confirmar se o percentual de sensibilidade da biometria é o mesmo.

...

Na tabela abaixo é apresentada a lista de bancos que o TSA suporta e os bancos disponíveis para que o TSA integre com o sistema externo.

Bancos de Dados Suportados
Banco de DadosTSAConexão com o Sistema Externo (Datasul, Protheus e RM)
SQLServerSimSim
OracleSimSim
MySQLSimNão
ProgressNãoSim
DB2NãoSim

Sendo assim, o TSA suporta apenas Oracle, SQLServer e MySQL. 

...

where parameter = 'NLS_CHARACTERSET'


Resultado esperado:

NLS_LANGUAGEAMERICAN
NLS_TERRITORYAMERICA
NLS_CHARACTERSETWE8ISO8859P1 ou WE8MSWIN1252
NLS_NCHAR_CHARACTERSETAL16UTF16
  • select name, value from v$parameter where name = 'db_block_size';
  • select name, value from v$parameter where name = 'open_cursores';

...

Dica
titleDica:

A porta do broker é a porta definida para o parâmetro “-S” ao carregar o banco com o parâmetro “-ServerType SQL”.


MySQL

Recomendamos que o TSA seja utilizado com o mesmo banco de dados corporativo do cliente, lembrando quanto a restrição de banco de dados Progress.

Porém, quando o cliente optar em utilizar o TSA com o banco de dados MySQL, deverá se atentar em efetuar a revisão da parametrização do servidor.

Por padrão o MySQL é instalado com uma configuração para ambientes de desenvolvimento, por isso, caso o mesmo seja utilizado sem revisão de configuração poderá apresentar problemas de desempenho.

O MySQL já possui por padrão exemplos de configurações para ambientes mais exigentes, recomendamos que seja utilizado a configuração mostrada no arquivo “my-innodb-heavy-4G.ini” da instalação do MySQL.

Não é recomendado a utilização deste banco de dados para empresas com volume superior a 10.000 participantes ativos no TSA

Aviso
titleAtenção:

O ajuste da configuração do ambiente do MySQL deve ser executado antes de iniciar a instalação do TSA. Caso já tenha sido efetuado a criação do database e das tabelas, deve-se executar um dump do banco de dados, efetuado a revisão da configuração, e após o load dos dados.


DB2

Assim como o Progress, o banco DB2 é homologado apenas como integração com o sistema externo, não está homologado para armazenar as informações do TSA.


Java

O instalador disponibiliza automaticamente o Java na versão homologada com o sistema. Em nenhuma hipótese o Java deve ser atualizado. O TSA não está homologado com a versão Java 7 (nem superiores).

Todos os serviços necessários pelo TSA são configurados utilizando o Java disponibilizado na mídia de instalação.

O Java disponibilizado na mídia de instalação é a versão “JRE 1.6.0_45 64 Bits”. A localização do Java será: %TSA_HOME%\jre.


Configuração de serviços ambiente Linux

O TSA é compatível com o sistema operacional Linux, porém, o instalador da ferramenta está disponível apenas para ambientes Windows, desta forma, para instala-lo em ambiente Linux é necessário efetuar a instalação do TSA em um computador Windows e após efetuar a cópia do diretório instalado (normalmente c:\totvs\tsa) para o servidor Linux.


A inicialização manual dos serviços pode ser efetuada da seguinte forma:

JBoss (estando em tsa\jboss\bin): ./run.sh –c tsa-web –b 0.0.0.0

Integrador (estando em tsa\integrador\server): java -jar lib/tsa-core-XX.X.XX-SNAPSHOT.jar


Integrador

O procedimento abaixo irá fazer com que o serviço de comunicação com os dispositivos seja iniciado automaticamente e tratado como um serviço pelo servidor Linux é conforme os passos abaixo:

No ambiente instalado, existirá o seguintes arquivos no diretório “%TSA_HOME%/integrador/server/bin/linux”:


Para todos os arquivos do diretório acima, é necessário atribuir a permissão de execução, através do comando abaixo:

  • sudo chmod +x /home/poffo/tsa/integrador/server/bin/linux/tsa-core-service
  • sudo chmod +x /home/poffo/tsa/integrador/server/bin/linux/ tsa-core-servicewrapper.sh
  • sudo chmod +x /home/poffo/tsa/integrador/server/bin/linux/ tsa-core-startservice.sh


tsa-core-service - Script responsável em representar o serviço dentro do ambiente do Linux. Esse script deverá ser copiado abaixo para o diretório “/etc/init.d/”:

  • sudo cp /home/poffo/tsa/integrador/server/bin/linux/tsa-core-service /etc/init.d


tsa-core-service-wrapper.sh - Script utilizado para gerenciar o processo de início e parada do programa integrador do TSA. Nesse script precisaremos efetuar o ajuste das seguintes variáveis dentro do arquivo:

JAVA_HOME: Diretorio de instalação do Java no servidor Linux;

applDir: Deverá apontar para o caminho do TSA, no nosso caso é “/home/poffo/tsa/integrador/server/bin/linux”;

javaArgs: Caso ocorrá alguma atualização de versão do TSA, nesta variável deverá contar o nome do JAR com a versão correta do ambiente;


tsa-core-start-service.sh - Script responsável em iniciar o serviço, utilizado através do comando abaixo para que o serviço do TSA seja iniciado quando o ambiente Linux for iniciado:

  • sudo ln -s /home/poffo/tsa/integrador/server/bin/linux/tsa-core-startservice.sh /etc/rc2.d/S20-tsa-core-start-service.sh
  • sudo ln -s /home/poffo/tsa/integrador/server/bin/linux/tsa-core-startservice.sh /etc/rc3.d/S20-tsa-core-start-service.sh


Os logs do processo integrador poderão ser consultados diretamente na estrutura do TSA: %TSA_HOME%/integrador/server/log.

Os logs de início do serviço poderão ser consultados no diretório: /var/log/tsa-core.log.


Quando necessário, o serviço do integrador poderá ser iniciado ou paralisado através dos seguintes comandos:

Iniciar: sudo /etc/init.d/tsa-core-service start

Parar: sudo /etc/init.d/tsa-core-service stop


Da mesma forma como ocorre em sistemas operacionais Windows, o serviço do integrador irá subir antes do que o serviço do JBoss. Apesar do serviço integrador depender do serviço do JBoss para o seu funcionamento, ele possui técnicas para tentar obter uma conexão no JBoss em caso de falhas, fazendo com que gerencie automaticamente quando o JBoss não estiver disponível.


Aviso
titleAtenção:

A funcionalidade de múltipla instância não está homologada para ambientes Linux.


Requisitos de Usuário (Servidor)

Recomenda-se que a instalação do produto TSA seja efetuada com o usuário “administrador” do computador e que o mesmo esteja incluso no grupo de administradores da rede.

Instalação


Detalhes da Mídia de Instalação

A mídia de instalação do TOTVS Segurança e Acesso são disponibilizados em DVD e pelo Portal do Cliente.

Nesta mídia estão disponíveis:

  • Guia de Instalação do produto. 
  • Setup e arquivos necessários para instalação do produto.


Planejando a Instalação

Mostraremos agora as etapas que devem ser seguidas para a instalação e configuração do TOTVS Segurança e Acesso 12.1.

  • Defina a topologia do ambiente. Nesta etapa, deve ser definido onde cada componente será instalado. Escolha o hardware que será utilizado como servidor de banco de dados, servidor de arquivos, servidor de aplicação e também as máquinas que estarão disponíveis aos usuários. Para cada um destes componentes, verifique se os requisitos de hardware e software são atendidos.
  • Instale os bancos de dados.
  • Instale o servidor de aplicação.

A mídia só faz uma instalação dos bancos e servidor de aplicação de uma vez só.

  • Carregue os bancos de dados utilizando os scripts.

Inicie o JBoss através do serviço “TOTVS Controle de Acesso (TSA) - 8080” criado no “Services” do Windows. Após a conclusão destas etapas, o produto estará pronto para utilização.


Instalação do Servidor de Aplicação

Execute o arquivo “setup.exe” para iniciar o processo de instalação.

Image Added


Na tela de apresentação do instalador, clique em “Avançar” para dar início no processo de instalação do TSA:

Image Added


Digite o nome do usuário e o nome da empresa onde esta sendo instalado o TSA:

Image Added


Na tela abaixo selecione onde será instalado o TOTVS Segurança e Acesso (TSA):

Image Added


Selecione o idioma de instalação do TSA, podendo ser Português (Brasil) ou Espanhol (México):

Image Added


Na tela abaixo selecione em qual porta WEB o TSA estará disponível. Com essa opção é possível instalar até 4 instâncias do TSA no mesmo servidor

Image Added


Selecione a base de dados na qual o TSA será executado dentro das opções disponíveis, nessa simulação escolheremos MySQL (posteriormente será questionado qual o banco de dados do sistema externo: Datasul, Protheus ou RM):

Image Added


Digite o nome do servidor e a porta de conexão do servidor de banco de dados:

Image Added


Digite o nome do banco de dados onde as tabelas do TSA estarão:

Image Added


Digite o usuário de conexão no banco de dados (recomenda-se um usuário exclusivo TSA):

Image Added


Digite a senha do usuário de conexão no banco de dados:

Image Added


Selecione a base de dados que o sistema externo (Datasul, Protheus ou RM) utiliza. No exemplo abaixo será escolhido Progress utilizando como base o produto Datasul:

Image Added


Informe o nome do servidor e a porta do servidor de banco de dados do sistema externo. O sistema externo é o produto de gestão de pessoas da TOTVS que fará o tratamento das marcações para o cálculo do ponto eletrônico. O sistema externo pode ser: Datasul, Protheus, RM ou Logix.

Image Added


Na tela abaixo é informado qual o nome do banco de dados do sistema externo:

Image Added


Na tela abaixo é informado o usuário de conexão no banco de dados do sistema externo (recomenda-se um usuário exclusivo TSA), para o banco Progress é utilizado o usuário pub:

Image Added


Na tela abaixo deve ser informado a senha para conexão no banco de dados do sistema externo.

Image Added


Após, o instalador irá preparar os dados para iniciar a instalação:

Image Added


Após o processo de instalação irá iniciar:

Image Added


Após, o processo de instalação foi finalizado:

Image Added


Aviso
titleAtenção:

Caso deseja-se instalar o TOTVS Segurança e Acesso em ambiente Linux, deve-se efetuar a instalação em ambiente Windows e após efetuar a cópia do diretório para o ambiente Linux. Atentar para que o arquivo tsa.properties (%TSA_HOME%/integrador\server\conf) tenha a propriedade “totvs.hcm.tsa.access.server_application.naming_provider_url” alterada para o servidor aonde o JBoss estará em execução.


Objetos Criados na Instalação do Servidor de Aplicação

Seguem os objetos importantes para administração do ambiente, criados na instalação do servidor de aplicação.

LocalizaçãoDescrição
<TSA_HOME>\icoDiretório contendo o ícone do produto TOTVS.
<TSA_HOME>\integradorDiretório da aplicação de integração com os equipamentos de Controle de Acesso e Ponto Eletrônico.
<TSA_HOME>\jbossDiretório do servidor de aplicação JBoss.
<TSA_HOME>\jreDiretório de instalação da máquina virtual do Java (JRE).
<TSA_HOME>\scriptsDiretório onde estão os scripts de carga da base de dados para os bancos de dados homologados e scripts de migração entre versões do TSA.


Integrações com Sistemas Externos

O objetivo é integrar os Sistema de Gestão de Pessoas das linhas de produto Datasul HCM, Protheus e RM Chronus ao TSA e também enviar a estes as marcações feitas em dispositivos de ponto e dispositivos de refeição.


Integração Datasul HCM

Aviso
titleAtenção:

A partir da release TSA 12.1.10 e Datasul HCM 12.1.10 a integração é nativa. Não sendo mais necessário a utilização do ESB como intermediário.

Para configurar a nova integração acesse o link do manual Integração HCM x TSA  


Integração Protheus

Detalhes sobre a configuração da Integração acessar Integração SIGAPON xTSA


Integração RM Chronus

Detalhes sobre a configuração da Integração acessar "como fazer Integração com o TSA".


Instalação de Banco de Dados

A seleção do banco de dados no processo de instalação descrito no capitulo “4.3 Instalação do Servidor de Aplicação” é para que o JBoss seja configurado corretamente. O processo de instalação do banco de dados deverá ser executado manualmente e após, efetuada a carga dos dados do banco de dados.

Deverá ser carregado no banco de dados informado no processo de instalação o script “databaseInitialization-TSA*-schema.sql” localizado no diretório “<TSA_HOME>\scripts”. Substitua o asterisco (*) pelo fabricante do banco de dados que deve ser carregado (DB2, MySQL, Oracle ou SQL Server). Esse script fará a criação do ambiente do TOTVS Segurança e Acesso e a inicialização necessária do ambiente.

O script de criação da tabela externa (de marcações) deverá ser carregado no banco de dados informado no processo de instalação como “Sistema Externo” que corresponde ao software de gestão de pessoas utilizado, podendo ser: Datasul, Protheus ou RM. Os scripts estão localizados no diretório “TSA_HOME\scripts” e possuem o padrão de nomenclatura: “databaseInitialization-TSA_EXT-*-schema.sql”, sendo que o asterisco (*) corresponde ao fabricante do banco de dados. O banco de dados externo pode ser um dos bancos a seguir: DB2, MySQL, Oracle, SQL Server, Progress ou Informix.

Dica
titleDica:

Para o produto Datasul não será necessário efetuar a carga do script “databaseInitialization-TSAPROGRESS-schema.sql” (por esse motivo esse arquivo não esta presente na mídia de instalação) pelo fato da tabela de marcações (MSA_CONTROL_MARCAC) ser expedida com o produto padrão.

Aviso
titleAtenção:

Datasul: Para o produto Datasul apenas será necessário carregar o script do sistema externo (databaseInitialization-TSA_EXT-DATASUL-Oracle-schema.sql) quando o Datasul estiver instalado em banco de dados Oracle. Neste caso o script (databaseInitialization-TSA_EXT-DATASUL-Oracle-schema.sql) deverá ser carregado no banco de dados HCM/DTHRTMA. A tabela (MSA_CONTROL_MARCAC) necessária pelo TSA no produto Datasul já é expedida juntamente ao produto padrão para as versões homologadas do Datasul (versão igual ou superior a 11.2.2) no banco HCM/DTHRTMA.

Aviso
titleAtenção:

Protheus, RM e Logix: É necessário executar o script “databaseInitialization-TSA_EXT-*- schema.sql” para criação da entidade de marcações do TSA. Esse script deve ser executado no banco de dados do respectivo produto.


Inicializando o TOTVS Segurança e Acesso

Inicie o JBoss através do serviço “TOTVS Controle de Acesso (TSA) - 8080” criado no “Services” do Windows.


Acesso ao TOTVS Segurança e Acesso

Abra um navegador e acesse “http://localhost:8080/tsa-web” com os dados de login abaixo:
Login: adm
Senha: 123

Reinstalação


A reinstalação pode ser executada para restaurar os programas originais, atente-se em informar os mesmos valores para as configurações de banco de dados. Recomenda-se que seja efetuado um backup do ambiente antes de prosseguir com um processo de reinstalação.

Arquivos de configurações importantes para backup:

  • %TSA_HOME%\integrador\server\conf\*
  • %TSA_HOME%\jboss\server\tsa-web\deploy\properties-service.xml
  • %TSA_HOME%\jboss\server\tsa-web\deploy\tsa-ds.xml

Desinstalação

O procedimento de desinstalação deve ser executado somente quando não é mais necessário os componentes instalado em cada servidor, sendo que essa rotina deve ser executada a partir do servidor onde foi instalado cada componente.

Para desinstalar o produto em ambiente Windows deve ser selecionada a opção “remover” do “TSA * Controle de Acesso TOTVS” em “Iniciar > Configurações > Painel de Controle > Adicionar ou Remover Programas”.