Guia de InstalaçãO Datasul TSA 11.6.7

Guia de Instalao TOTVS Segurana e Acesso 11.6.7

10/2013


2 Guia de Instalao TOTVS Segurana e Acesso

Verso 11.6.7

Sumrio

1. Prefcio ....................................................................................................................................... 3

1.1. Finalidade ...................................................................................................................................... 3

1.2. Pblico Alvo ................................................................................................................................... 3

1.3. Organizao deste Guia ................................................................................................................. 3

1.4. Documentaes Importantes ........................................................................................................ 4

2. Introduo ........................................................................................................................................ 5

2.1. Arquitetura Distribuda do Produto ............................................................................................... 5

2.2. Tipos de Instalao ........................................................................................................................ 5

3. Requisitos Bsicos ............................................................................................................................. 6

3.1. Viso Geral dos Requisitos............................................................................................................. 6

3.2. Requisitos de Hardware................................................................................................................. 7

3.2.1. Requisitos para estao cliente .................................................................................................. 7

3.2.2. Requisitos para servidor ............................................................................................................. 8

3.3. Requisitos de Dispositivos (Controle de Acesso e Ponto Eletrnico) ............................................ 8

3.4. Requisitos de Software .................................................................................................................. 9

3.4.1. SQL Server ................................................................................................................................... 9

3.4.2. Oracle .......................................................................................................................................... 9

3.4.3. Progress ...................................................................................................................................... 9

3.4.4. Java ............................................................................................................................................. 10

3.5. Requisitos de Usurio (Servidor) ................................................................................................... 10

4. Instalao .......................................................................................................................................... 11

4.1. Detalhes da Mdia de Instalao .................................................................................................... 11

4.2. Planejando a Instalao ................................................................................................................. 11

4.3. Instalao do Servidor de Aplicao .............................................................................................. 11

4.3.1. Objetos Criados na Instalao do Servidor de Aplicao ........................................................... 21

4.4. Instalao de Banco de Dados ....................................................................................................... 22

4.5. Inicializando o TOTVS Segurana e Acesso .................................................................................... 22

4.6. Acesso ao TOTVS Segurana e Acesso ........................................................................................... 22

5. Reinstalao ...................................................................................................................................... 23

6. Desinstalao .................................................................................................................................... 24



Verso 11.6.7

1. Prefcio

1.1. Finalidade

Este guia tem como finalidade descrever de forma objetiva os procedimentos necessrios para a instalao do

produto TOTVS Segurana e Acesso 11.6.7, bem como configurar o produto nas plataformas suportadas.

1.2. Pblico Alvo

Por este processo de instalao ser complexo, a instalao requer pessoas que tenham conhecimentos da

arquitetura do Java, JBoss e ambiente de rede.

1.3. Organizao deste Guia

Captulo 2, Introduo

Este captulo apresenta uma viso geral da arquitetura distribuda, tipos de instalao e exemplos de topologias no

uso do produto.

Captulo 3, Requisitos

Este captulo apresenta a lista de requisitos bsicos de hardware e software exigidos na instalao e configurao do

produto.

Captulo 4, Instalao

Este captulo descreve os procedimentos que devero ser executados para a instalao do produto. Abrange desde o

planejamento da instalao, ou seja, escolher o tipo de instalao adequado, at as configuraes necessrias para acesso

remoto.

Captulo 5, Reinstalao

Este captulo descreve os procedimentos a serem executados para a reinstalao do TOTVS Segurana e Acesso, bem

como os cuidados necessrios para a execuo dessa rotina.

Captulo 6, Desinstalao

Este captulo descreve os procedimentos necessrios para a desinstalao do TOTVS Segurana e Acesso.



Verso 11.6.7

1.4. Documentaes Importantes

Manuais JBoss

Installation Guide;

Getting Started Guide;

Server Configuration Guide.

Estas e outras documentaes podem ser obtidas em Jboss AS Documentation e Jboss Wiki.



Verso 11.6.7

2. Introduo

2.1. Arquitetura Distribuda do Produto

A arquitetura distribuda consiste em separar os componentes em plataformas independentes que interagem entre

si, permitindo que os recursos sejam compartilhados enquanto se obtm ao mximo os benefcios de cada dispositivo.

Basicamente, funciona da seguinte forma: as mquinas dos usurios estaro conectadas aos servidores pela rede e cada

servidor fornecer recursos diferentes para que os programas possam ser executados da mquina do usurio.

A figura abaixo mostra os quatro componentes bsicos utilizados pelo produto.

Rede TCP/IP

2.2. Tipos de Instalao

Para o funcionamento do produto, necessrio executar os procedimentos de Bancos de Dados e a instalao do

Servidor de Aplicao:

Ambiente do Cliente

Servidor de Aplicao Servidor de Arquivos

Usu

rios

Servidor de Banco de Dados



Verso 11.6.7

Servidor de Aplicao

Instala e configura o JBoss e o Java, assim como o TOTVS Segurana e Acesso, sendo esses componentes essenciais

para o funcionamento do produto.

Banco de Dados

Procedimentos para configurar os bancos de dados utilizados pelo produto.

ATENO: Esta mdia preparada para instalar vrias instncias do produto TOTVS Segurana

e Acesso no mesmo servidor. Este procedimento consiste em instalar mltiplas cpias das opes de

Banco de Dados e Servidor de Aplicao, respeitando o limite mximo de quatro instncias. Cada

instncia instalada ser nomeada com base na porta principal utilizada pelo JBoss, seguindo a

sequncia 8080, 8180, 8280 e 8380. Cada instncia dever ser instalada em um caminho

independente.

3. Requisitos Bsicos

Este captulo tem como objetivo divulgar recomendaes sobre o uso de hardware e software relacionados ao

TOTVS Segurana e Acesso.

As recomendaes e exemplos citados adiante levam em considerao somente os softwares relacionados ao TOTVS

Segurana e Acesso e softwares de uso genrico, como Office e e-mail. Caso sejam instalados outros softwares no mesmo

ambiente, eles devem ser levados em considerao, sendo que os requisitos descritos podem no ser o suficiente para a

execuo de todas as rotinas.

As verses homologadas de software, banco de dados, sistema de gesto de pessoas (Datasul, Protheus ou RM) e a

firmware dos dispositivos so exatamente as citadas abaixo. Qualquer item que seja utilizado com alguma verso diferente

das citadas no considerado homologado, podendo prejudicar a execuo das rotinas do produto.

3.1. Viso Geral dos Requisitos

Para dar incio ao processo de atualizao para o Datasul, o sistema deve obedecer a verso de pacote de origem

(entre parnteses) suportado pela atualizao, conforme definies da tabela a seguir:

Servidor

30 equipamentos

Hardware (mnimo)

Disco 100 GB disponveis

Memria 6 GB disponveis

Processador Intel Core i5 3.00 GHz (ou compatvel) 64 Bits

Banda de Dados 100 Mbps

Software



Verso 11.6.7

Java JRE 1.6.0_45 64 Bits (embutido na instalao). Java 1.7 (ou superior) no est homologado.

Sistema Operacional Windows ou Linux (verificar compatibilidade dos softwares de integrao do fabricante do equipamento)

Bancos de Dados

Oracle 10g R1, 10g R2, 11g R1,11g R2

Microsoft SQL Server 2005, 2008 R2

Informix 10, 11.5

DB2 9.1, 9.5, 9.7

MySQL 5.1

Sistema de Gesto de Pessoas

Sistema de Gesto de Pessoas (Sistema Externo)

Datasul HCM 11.2.2,11.2.3, 11.5.x

Protheus 10 10.x.x, serie-3

Protheus 11 11.1.x, serie-3

Logix 10 10.2.x

RM Chronus 11 11.50.0

Estao Client

Windows / Linux

Hardware

Memria 1 GB

Processador 1.00 GHz

Resoluo de Tela 1024 x 768 ou superior

Software

Navegadores Internet Explorer 8 Firefox 3.6 Chrome 10

Webcam Dever possuir o plugin da Macromedia Flash instalado e uma Webcam compatvel com o flash.

3.2. Requisitos de Hardware

3.2.1. Requisitos para estao cliente

necessrio que a estao cliente possua o sistema operacional Windows ou Linux instalado.

No recomendamos o uso de estaes menores que o mnimo acima citado, pois o desempenho no atender s

necessidades dos usurios.

Para todos os casos recomendamos a utilizao de placas de rede de fornecedores de primeira linha.



Verso 11.6.7

3.2.2. Requisitos para servidor

A configurao acima para servidor dedicado, no recomendamos que o servidor dos aplicativos de integrao

com os dispositivos seja compartilhado com alguma outra aplicao. Pelo fato da comunicao com os equipamentos ser

real-time, a execuo de outros aplicativos no mesmo servidor poder gerar lentido na liberao dos acessos.

3.3. Requisitos de Dispositivos (Controle de Acesso e Ponto Eletrnico)

Abaixo so exibidos os equipamentos suportados pelo software TOTVS Segurana e Acesso. As verses homologadas

so somente as citadas abaixo. Caso seja lanada uma nova verso de firmware de qualquer dispositivo, esta no

homologada e no deve ser usada antes que seja verificada sua compatibilidade com o produto.

Caso tenha a necessidade de solicitar a homologao de um novo firmware, por favor, abra um chamado com a

equipe de atendimento.

Controle de Acesso

Fabricante Modelo Firmware

Dimep Todos os modelos compatveis com a verso de firmware homologada.

Biopoint: 2.16 Micropoint: 3.2, 3.6

Henry Todos os modelos do protocolo 7.x compatveis com a verso de firmware homologada.

7101

Telemtica Todos os modelos compatveis com o software da Telemtica Conex (que operem com a tabela MATCODIN e que no possuam ARLON).

*

TopData Linha de produto Inner Net e Inner Plus Inner Net: 2.03 Inner Plus: 8.58, 9.0.2

ATENO: Todos os dispositivos, independente de fabricante, devem ter funcionamento ON-LINE e REAL

TIME.

Ponto Eletrnico (Portaria 1.510/2009)

Fabricante Modelo Firmware

Dimep Todos os modelos compatveis com as verses de firmware homologadas. Este fabricante possui equipamentos para a Portaria 373/11 do MTE.

REP 48 01.00.0002 REP 48 02.04.0000

Madis Todos os modelos compatveis com as verses de firmware homologadas. Este fabricante possui equipamentos para a

REP 48 01.00.0002 REP 48 02.04.0000



Verso 11.6.7

Portaria 373/11 do MTE.

Telemtica Todos os modelos compatveis com o software da Telemtica (CONEX REP)

CONEX REP 01.00.01A

ATENO: Todos os dispositivos devem estar homologados na Portaria 1.510/2009

(http://portal.mte.gov.br/pontoeletronico/rep-registrados-no-mte.htm).

3.4. Requisitos de Software

Recomenda-se criar um usurio especifico para o produto TSA para configurao do sistema. Apenas para o banco

de dados Progress, no qual dever ser utilizado o usurio pub.

3.4.1. SQL Server

Dever ser configurada uma porta fixa para a instncia nomeada. Essa porta dever ser fornecida no processo de

instalao do Segurana e Acesso TOTVS descrito no captulo 4.3 Instalao do Servidor de Aplicao.

Recomendamos que a collation do banco tsa e do banco do sistema externo seja CASE-INSENSITIVE:

Latin1_General_CI_AI, sem restrio de maisculo e minsculo e sem restrio de acentos.

3.4.2. Oracle

necessrio criar um usurio para o TOTVS Segurana e Acesso (TSA) e utilizar esse usurio para efetuar a carga das

tabelas/dados no captulo 4.4 Instalao de Banco de Dados.

3.4.3. Progress

O sistema TOTVS Segurana e Acesso (TSA) poder utilizar apenas o banco de dados do Datasul, sendo o banco de

dados do sistema externo.

Sistema Externo: Sistema de gesto de pessoas (Datasul, Protheus, RM ou Logix). Quando Datasul ser o banco de

dados HCM.

Para esse banco de dados necessrio efetuar a criao do broker SQL e a criao dos usurios sysprogress e pub,

ambos com permisso de DBA, conforme passos descritos abaixo:

Criar o usurio sysprogress, senha sysprogress e o usurio pub, senha pub pelo Admin > Security > Edit

User List;

Fechar a sesso Progress e carregar o banco com um broker SQL:

proserve -S -N TCP -H



Verso 11.6.7

proserve -S -N TCP -H -m3 ServerType SQL

Acessar um computador cliente windows com Progress instalado;

Acessar o proenv do Progress em Iniciar > Programas > Progress > Proenv;

DICA: A porta do broker a porta definida para o parmetro -S ao carregar o banco com o

parmetro -ServerType SQL.

3.4.4. Java

O instalador disponibiliza automaticamente o Java na verso homologada com o sistema. Em nenhuma hiptese o

Java deve ser atualizado. O TSA no est homologado com a verso Java 7 (nem superiores).

Todos os servios necessrios pelo TSA so configurados utilizando o Java disponibilizado na mdia de instalao.

O Java disponibilizado na mdia de instalao a verso JRE 1.6.0_45 64 Bits. A localizao do Java ser:

%TSA_HOME%\jre.

3.5. Requisitos de Usurio (Servidor)

Recomenda-se que a instalao do produto TSA seja efetuada com o usurio administrador, ou com um usurio

que esteja incluso no grupo de administradores do servidor.



Verso 11.6.7

4. Instalao

4.1. Detalhes da Mdia de Instalao

A mdia de instalao do TOTVS Segurana e Acesso so disponibilizados em DVD e pelo Portal do Cliente.

Nesta mdia esto disponveis:

Guia de Instalao do produto.

Setup e arquivos necessrios para instalao do produto.

4.2. Planejando a Instalao

Mostraremos agora as etapas que devem ser seguidas para a instalao e configurao do TOTVS Segurana e

Acesso 11.6.

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 aplicao e

tambm as mquinas que estaro disponveis aos usurios. Para cada um destes componentes, verifique se os

requisitos de hardware e software so atendidos.

Instale os bancos de dados.

Instale o servidor de aplicao.

A mdia s faz uma instalao dos bancos e servidor de aplicao de uma vez s.

Carregue os bancos de dados utilizando os scripts.

Inicie o JBoss atravs do servio TOTVS Controle de Acesso (TSA) - 8080 criado no Services do Windows.

Aps a concluso destas etapas, o produto estar pronto para utilizao.

4.3. Instalao do Servidor de Aplicao

Execute o arquivo setup.exe para iniciar o processo de instalao.



Verso 11.6.7

Na tela de apresentao do instalador, clique em Avanar para dar incio no processo de instalao do TSA:



Verso 11.6.7

Digite o nome do usurio e o nome da empresa onde esta sendo instalado o TSA:

Na tela abaixo selecione onde ser instalado o TOTVS Segurana e Acesso (TSA):



Verso 11.6.7

Selecione o idioma de instalao do TSA, podendo ser Portugus (Brasil) ou Espanhol (Mxico):

Na tela abaixo selecione em qual porta WEB o TSA estar disponvel. Com essa opo possvel instalar at 4

instncias do TSA no mesmo servidor.



Verso 11.6.7

Selecione a base de dados na qual o TSA ser executado dentro das opes disponveis, nessa simulao

escolheremos MySQL (posteriormente ser questionado qual o banco de dados do sistema externo: Datasul, Protheus ou

RM):

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



Verso 11.6.7

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

Digite o usurio de conexo no banco de dados (recomenda-se um usurio exclusivo TSA):



Verso 11.6.7

Digite a senha do usurio de conexo no banco de dados:

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:



Verso 11.6.7

Informe o nome do servidor e a porta do servidor de banco de dados do sistema externo. O sistema externo o

produto de gesto de pessoas da TOTVS que far o tratamento das marcaes para o clculo do ponto eletrnico. O

sistema externo pode ser: Datasul, Protheus, RM ou Logix.

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



Verso 11.6.7

Na tela abaixo informado o usurio de conexo no banco de dados do sistema externo (recomenda-se um usurio

exclusivo TSA), para o banco Progress utilizado o usurio pub:

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



Verso 11.6.7

Aps, o instalador ir preparar os dados para iniciar a instalao:

Aps o processo de instalao ir iniciar:



Verso 11.6.7

Aps, o processo de instalao foi finalizado:

ATENO: Caso deseja-se instalar o TOTVS Segurana e Acesso em ambiente Linux, deve-se efetuar a

instalao em ambiente Windows e aps efetuar a cpia do diretrio para o ambiente Linux.

4.3.1. Objetos Criados na Instalao do Servidor de Aplicao

Seguem os objetos importantes para administrao do ambiente, criados na instalao do servidor de aplicao.

Localizao Descrio \ico Diretrio contendo o cone do produto TOTVS.

< TSA_HOME>\integrador Diretrio da aplicao de integrao com os equipamentos de Controle de Acesso e Ponto Eletrnico.

\jboss Diretrio do servidor de aplicao JBoss.

\jre Diretrio de instalao da mquina virtual do Java (JRE).

\scripts Diretrio onde esto os scripts de carga da base de dados para os bancos de dados homologados e scripts de migrao entre verses do TSA.



Verso 11.6.7

4.4. Instalao de Banco de Dados

A seleo do banco de dados no processo de instalao descrito no capitulo 4.3 Instalao do Servidor de

Aplicao para que o JBoss seja configurado corretamente. O processo de instalao do banco de dados dever ser

executado manualmente e aps, efetuada a carga dos dados do banco de dados.

Dever ser carregado no banco de dados informado no processo de instalao o script databaseInitialization-TSA-

*-schema.sql localizado no diretrio \scripts. Substitua o asterisco (*) pelo fabricante do banco de dados

que deve ser carregado (DB2, Informix, MySQL, Oracle, Progress ou SQL Server). Esse script far a criao do ambiente do

TOTVS Segurana e Acesso e a inicializao necessria do ambiente.

O script de criao da tabela externa (de marcaes) dever ser carregado no banco de dados informado no

processo de instalao como Sistema Externo que corresponde ao software de gesto de pessoas utilizado, podendo ser:

Datasul, Protheus ou RM. Os scripts esto localizados no diretrio TSA_HOME\scripts e possuem o padro de

nomenclatura: databaseInitialization-TSA_EXT-*-schema.sql, sendo que o asterisco (*) corresponde ao fabricante do

banco de dados.

DICA: Para o produto Datasul no ser necessrio efetuar a carga do script databaseInitialization-TSA-

PROGRESS-schema.sql (por esse motivo esse arquivo no esta presente na mdia de instalao) pelo

fato da tabela de marcaes (MSA_CONTROL_MARCAC) ser expedida com o produto padro.

ATENO Datasul: Para o produto Datasul apenas ser necessrio 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)

necessria pelo TSA no produto Datasul j expedida juntamente ao produto padro para as verses

homologadas do Datasul (verso igual ou superior a 11.2.2) no banco HCM/DTHRTMA.

ATENO Protheus, RM e Logix: necessrio executar o script databaseInitialization-TSA_EXT-*-

schema.sql para criao da entidade de marcaes do TSA. Esse script deve ser executado no banco de

dados do respectivo produto.

4.5. Inicializando o TOTVS Segurana e Acesso

Inicie o JBoss atravs do servio TOTVS Controle de Acesso (TSA) - 8080 criado no Services do Windows.

4.6. Acesso ao TOTVS Segurana e Acesso

Abra um navegador e acesse http://localhost:8080/tsa-web com os dados de login abaixo:

Login: adm

Senha: 123



Verso 11.6.7

5. Reinstalao

A reinstalao pode ser executada para restaurar os programas originais, atente-se em informar os mesmos valores

para as configuraes de banco de dados. Recomenda-se que seja efetuado um backup do ambiente antes de prosseguir

com um processo de reinstalao.

Arquivos de configuraes 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



Verso 11.6.7

6. Desinstalao

O procedimento de desinstalao deve ser executado somente quando no mais necessrio 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 opo remover do TSA * Controle de

Acesso TOTVS em Iniciar > Configuraes > Painel de Controle > Adicionar ou Remover Programas.

Guia de InstalaçãO Datasul TSA 11.6.7

Documents

Transcript of Guia de InstalaçãO Datasul TSA 11.6.7