Você está na página 1de 24

Guia de Instalao TOTVS Segurana e Acesso 11.6.

7
10/2013
Guia de Instalao TOTVS Segurana e Acesso 11.6.7

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
Guia de Instalao TOTVS Segurana e Acesso 11.6.7


3
Guia de Instalao TOTVS Segurana e Acesso
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.




Guia de Instalao TOTVS Segurana e Acesso 11.6.7

4 Guia de Instalao 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.
Guia de Instalao TOTVS Segurana e Acesso 11.6.7


5
Guia de Instalao TOTVS Segurana e Acesso
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
Guia de Instalao TOTVS Segurana e Acesso 11.6.7

6 Guia de Instalao TOTVS Segurana e Acesso
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
Guia de Instalao TOTVS Segurana e Acesso 11.6.7


7
Guia de Instalao TOTVS Segurana e Acesso
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.
Guia de Instalao TOTVS Segurana e Acesso 11.6.7

8 Guia de Instalao TOTVS Segurana e Acesso
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
Guia de Instalao TOTVS Segurana e Acesso 11.6.7


9
Guia de Instalao TOTVS Segurana e Acesso
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 <banco> -S <porta> -N TCP -H <nome servidor banco> <parmetros>
Guia de Instalao TOTVS Segurana e Acesso 11.6.7

10 Guia de Instalao TOTVS Segurana e Acesso
Verso 11.6.7
proserve <banco> -S <porta> -N TCP -H <nome servidor banco> -m3 ServerType SQL
<parmetros>

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.





Guia de Instalao TOTVS Segurana e Acesso 11.6.7


11
Guia de Instalao TOTVS Segurana e Acesso
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.
Guia de Instalao TOTVS Segurana e Acesso 11.6.7

12 Guia de Instalao TOTVS Segurana e Acesso
Verso 11.6.7


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




Guia de Instalao TOTVS Segurana e Acesso 11.6.7


13
Guia de Instalao TOTVS Segurana e Acesso
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):




Guia de Instalao TOTVS Segurana e Acesso 11.6.7

14 Guia de Instalao TOTVS Segurana e Acesso
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.


Guia de Instalao TOTVS Segurana e Acesso 11.6.7


15
Guia de Instalao TOTVS Segurana e Acesso
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:

Guia de Instalao TOTVS Segurana e Acesso 11.6.7

16 Guia de Instalao TOTVS Segurana e Acesso
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):




Guia de Instalao TOTVS Segurana e Acesso 11.6.7


17
Guia de Instalao TOTVS Segurana e Acesso
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:


Guia de Instalao TOTVS Segurana e Acesso 11.6.7

18 Guia de Instalao TOTVS Segurana e Acesso
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:


Guia de Instalao TOTVS Segurana e Acesso 11.6.7


19
Guia de Instalao TOTVS Segurana e Acesso
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.




Guia de Instalao TOTVS Segurana e Acesso 11.6.7

20 Guia de Instalao TOTVS Segurana e Acesso
Verso 11.6.7
Aps, o instalador ir preparar os dados para iniciar a instalao:



Aps o processo de instalao ir iniciar:





















Guia de Instalao TOTVS Segurana e Acesso 11.6.7


21
Guia de Instalao TOTVS Segurana e Acesso
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
<TSA_HOME>\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.
<TSA_HOME>\jboss Diretrio do servidor de aplicao JBoss.
<TSA_HOME>\jre Diretrio de instalao da mquina virtual do Java (JRE).
<TSA_HOME >\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.



Guia de Instalao TOTVS Segurana e Acesso 11.6.7

22 Guia de Instalao TOTVS Segurana e Acesso
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 <TSA_HOME>\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
Guia de Instalao TOTVS Segurana e Acesso 11.6.7


23
Guia de Instalao TOTVS Segurana e Acesso
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
Guia de Instalao TOTVS Segurana e Acesso 11.6.7

24 Guia de Instalao TOTVS Segurana e Acesso
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.