Histórico da Página

Finalidade

Este guia descreve os procedimentos necessários para que seja realizada a atualização de pacote do produto TOTVS Segurança e Acesso (TSA) de uma determinada versão para uma versão superior (Exemplo: 12.1.2 para o pacote 12.1.3) de maneira objetiva utilizando o updater de atualização e complementando as informações contidas no documento “Guia de Instalação TOTVS Segurança e Acesso 12.1”, que está na comunidade do TSA no Byyou ou através do link http://ingleses.datasul.com.br/scripts/econsultor.sbd/main.htm?kbid=47663.

Público Alvo

Este capítulo apresenta todos os passos necessários para que a atualização do TOTVS Segurança e Acesso seja realizada, mantendo as configurações e base de dados utilizados pela versão atual do sistema.

Documentações Importantes

Guia de Instalação TOTVS Segurança e Acesso 12.1

Este documento pode ser encontrado na mídia de instalação do produto ou na área Documentos da comunidade D@ - TSA no By You (https://totvs.byyou.com/docs?space=tsa-community).

Recomendamos também participar da comunidade citada para que possa interagir com outros clientes e especialistas deste produto e esclarecer dúvidas ou situações encontradas durante o processo de instalação, atualização ou utilização do mesmo. 

Atualização

A atualização do produto TOTVS Segurança e Acesso, a partir do pacote 11.6.6 é realizado por meio de um aplicativo e interface denominados Updater de Atualização que visa automatizar o processo de atualização do TSA de forma prática, rápida e segura.

O processo de atualização (Updater) para Linux deve seguir os seguintes passos:

• Manter a instalação original do TSA (para aplicação do Updater); 
• Efetuar a instalação da mídia anterior, para atualização através deste processo de atualização.

Ao termino dos processos acima, deve-se copiar o diretório instalado do TSA sob o diretório já existente no Linux. Atentar para que os serviços no Linux estejam parados para que não ocorrá problema na cópia. Após a cópia dos arquivos atentar para conferir se o arquivo “tsa.properties” possui o valor correto para a propriedade “totvs.hcm.tsa.access.server_application.naming_provider_url”, que deverá ser o nome do servidor que está com o JBoss do TSA em execução.

Executando o Updater de Atualização

Primeiramente, baixar o updater de atualização do TSA que está disponível no Portal de Suporte (https://suporte.totvs.com/download) mesmo local onde está a mídia de instalação.

O processo de atualização do produto consiste em executar o updater informando corretamente todos os parâmetros relativos ao ambiente no pacote anterior.

Execute o aplicativo “TOTVS Updater TSA-12.1.*-Setup.exe” e preencha as informações solicitadas de acordo com seu ambiente. Abaixo utilizaremos apenas as telas de uma atualização do TSA em ambiente SQL Server, dependendo do banco de dados do ambiente as telas poderão sofrer pequenas alterações (para atender características especificas de cada banco de dados):

Na tela seguinte informe o diretório onde o TSA está instalado. Por padrão, o diretório da instalação é c:\totvs\tsa porém se no seu ambiente a instalação foi numa pasta diferente informar a pasta onde o produto foi instalado.

Na sequência é apresentada a tela exibindo as informações configuradas na instalação do produto. É apenas utilizado para conferência das informações, sendo que todos os campos são bloqueados.

Em seguida, são exibidas as informações do banco de dados do Sistema Externo.

Após o preenchimento de todas as informações, será apresentada tela com um resumo dos dados do ambiente onde será feita a atualização dos arquivos do produto.

Será apresentada tela indicando o diretório onde foi feito backup dos arquivos do ambiente antes da atualização.

Aguardar o processo de atualização finalizar e ao final, carregar os serviços e testar o acesso ao produto.

Atualização em Ambientes Linux

A atualização para ambientes Linux é liberada através de atualizações manuais, são liberações em arquivos .zip no seguinte formato:

• ATUALIZAÇÃO_MANUAL_12_1_X_LINUX.ZIP.

Dentro deste arquivo é distribuído o arquivo TAR GZ.

Para atualizar o ambiente, copie o arquivo ZIP para a pasta imediatamente superior a instalação do TSA, por exemplo /opt/totvs, e descompacte com o seguinte comando:

• unzip -o ATUALIZADOR_TSA_12.1.X_MANUAL_LINUX.ZIP

Essa descompactação irá criar o arquivo “tsa-12.1.X.tar.gz”. Para descompactar o TAR GZ, basta usar o seguinte comando:

• tar -xvf tsa-12.1.X.tar.gz

A descompactação acima irá sobrescrever todos os arquivos da estrutura de diretórios da subpasta “tsa” pelos arquivos atualizados.

Migração da Base de Dados

Esta etapa consiste em executar os scripts no banco de dados do TSA para que o ele se torne compatível com a nova versão do produto. Siga as instruções abaixo (recomenda-se efetuar um backup do banco de dados do TSA antes de prosseguir):

• Acesse o diretório dos os scripts de migração (da instalação efetuada no item 2.1). O nome do diretório é “scripts” e está dentro da pasta raiz da instalação do TSA (TSA_HOME). Exemplo: C:\totvs\tsa\scripts.
• Verifique quais são os scripts que devem ser executados na base. No caso desse processo de atualização os scripts são esses: migrationFrom1216To1217-<NOME_DO_BANCO>.sql.
• Realize uma conexão ao banco de dados do TSA e execute os scripts de migração.

DB2

A partir da 12.1.6 foi removida a homologação para este banco de dados. O TSA suporta apenas MySQL, SQLServer e Oracle.

Arquivos de Configuração

O processo de atualização do TSA efetua a atualização automática dos arquivos “properties-service.xml” e o arquivo “tsa.properties”. Os valores originais atribuídos no ambiente serão preservados e as novas parametrizações são adicionadas com valores padrões definidas no produto.

Um backup dos arquivos de configurações originais do ambiente é efetuado no processo de cópia dos arquivos, definido no item 2.1.

Os serviços de inicialização do sistema (“TOTVS Controle de Acesso (TSA) – 8X80” e “TOTVS Controle de Acesso (TSA) - Integracao – 8X80”. Nesse momento a letra “X” representa a porta de instalação do TSA) são atualizados automaticamente com a versão atualizada nesse processo de atualização.