Tempo aproximado para leitura: 00:20:00 min
Dúvida
Automação Fiscal - ATUALIZAÇÃO - Como atualizar o TAF E-social?
Ambiente
TOTVS RH - TOTVS RH (Linha Protheus) - eSocial - TAF eSocial - ATUALIZAÇÃO - Como atualizar o TAF E-social?
Solução em vídeo:
Solução (leitura):
⚠ Sempre realize um Backup da sua estrutura antes de realizar qualquer ação ! ⚠
Para atualização do TAF é necessário que você tenha o ambiente igual ou posterior a Release 12.1.2210 ou Release 12.1.033 caso tenha garantia estendida ou utilize TAF - Segregado.
Caso tenha a Release inferior a 12.1.2210 e não tenha garantia estendida, faça o processo abaixo:
-
Clientes TAF Segregado: Realize a migração de Release do TAF se a sua Release for inferior a Release 12.1.033 e depois atualize o ambiente seguindo a documentação.
OBS: Clientes que utilizam TAF Segregado ainda não conseguem migrar para a Release 12.1.2310, Clique aqui e saiba mais.
- Clientes Protheus: Abra uma solicitação com a equipe do Protheus Framework solicitando o processo de migração de Release 12.1.033 para Release 12.1.2310 caso não tenha a garantia estendia.
Para saber qual é a sua release do TAF acesse a tela de diagnóstico do TAF.
Para ambientes em Cloud TOTVS, você pode atualiza-lo utilizando o T-Cloud ou abrir uma solicitação de atualização para a equipe Cloud TAF/TSS e informar o seu ambiente e a documentação de atualização do TAF que está visualizando.
1. Links para download:
Realize o download dos arquivos abaixo para fazer a atualização e atente-se em baixar os arquivos da Release e Sistema Operacional corretos:
Downloads para Windows :
Arquivos |
Release 12.1.033
|
Release 12.1.2210 |
Release 12.1.2310 |
Expedição Contínua e Dicionário | Clique aqui | Clique aqui | Clique aqui |
LIB | Clique aqui | Clique aqui | Clique aqui |
DBAccess | Clique aqui | Clique aqui | Clique aqui |
Binário do TAF (Appserver) | Clique aqui | Clique aqui | Clique aqui |
Smart Client | Clique aqui | Clique aqui | Clique aqui |
Downloads para Linux :
Arquivos |
Release 12.1.033
|
Release 12.1.2210 |
Release 12.1.2310 |
Expedição Contínua e Dicionário | Clique aqui | Clique aqui | Clique aqui |
LIB | Clique aqui | Clique aqui | Clique aqui |
DBAccess | Clique aqui | Clique aqui | Clique aqui |
Binário do TAF (Appserver) | Clique aqui | Clique aqui | Clique aqui |
Smart Client | Clique aqui | Clique aqui | Clique aqui |
Downloads para MAC :
Arquivos |
Release 12.1.033
|
Release 12.1.2210 |
Release 12.1.2310 |
Expedição Contínua e Dicionário | Clique aqui | Clique aqui | Clique aqui |
LIB | Clique aqui | Clique aqui | Clique aqui |
DBAccess | Clique aqui | Clique aqui | Clique aqui |
Binário do TAF (Appserver) | Clique aqui | Clique aqui | Clique aqui |
Smart Client | Clique aqui | Clique aqui | Clique aqui |
OBS: O TAF não está homologado para rodar os artefatos em 32 bits, é necessário que o seu servidor onde o TAF está instalado esteja em 64 bits. Caso contrário, o TAF não irá funcionar.
Para estações de trabalho onde o usuário tem uma máquina de 32 bits, realize o download do Smart Client 32 bits Clicando aqui.
2. Parando os serviços:
Antes de atualizarmos os artefatos é necessário que você pare todos os serviços do seu TAF/Protheus.
OBS: Lembrando que o serviço do REST, normalmente chamado de "TAF-WS", ele não para automaticamente. Você deve finaliza-lo no Gerenciador de Tarefas.
3. Atualização do DBACCESS
Com os serviços parados, iremos realizar a atualização do DBACCESS.
Para fazer isso você deve descompactar o arquivo do DBACCESS que foi baixado, copiar todo o conteúdo dentro da pasta, depois colar e substituir pela sua estrutura do DBACCESS atual.
Exemplo de caminho: C:\TAF\TafDbaccess64
4. Atualizando os binários:
Agora iremos atualizar os binários do TAF.
Para fazer isso você deve descompactar o arquivo do Binário que foi baixado, copiar todo o conteúdo dentro da pasta, depois colar e substituir nas pastas "APP" e "APPSERVER" do seu TAF.
Exemplos de caminhos: C:\TAF\bin\app e C:\TAF\bin\appserver
OBS: Caso possua Slaves ou Brokers faça o processo nas pastas respectivas aos serviços deles.
5. Atualizando a dbapi.dll:
Após a atualização dos binários iremos atualizar a dbapi.dll do DBACCESS para que não tenha incompatibilidade futuramente.
Copie o arquivo dentro da pasta "Client" do DBAccess e cole nos binários que acabou de atualizar (pasta APP e APPSERVER do TAF).
Exemplo de caminho: C:\TAF\TafDbacess64\Client
6. Atualizando o Smart Client:
O próximo passo é realizar a atualização do Smart Client.
Extraia o arquivo do Smart Client que foi baixado, copie todo o conteúdo dentro da pasta, depois cole e substitua nas pastas "smartclient" e "smartclient_update" do seu servidor do TAF.
Exemplos de caminhos: C:\TAF\bin\smartclient e C:\TAF\bin\smartclient_update
7. Reiniciando os serviços:
Agora que já atualizamos os artefatos do TAF/Protheus precisamos iniciar os serviços do DBACCESS e depois o serviço do APPSERVER-TAF para rodarmos a aplicação em modo exclusivo.
OBS: Caso esteja utilizando Broker ou Slaves inicie somente a master para acesso exclusivo.
Se você utiliza schedule ou qualquer outro job que está iniciando junto com o seu serviço principal do TAF/Protheus, comente a chave [OnStart] localizada dentro do arquivo "appserver.ini" da sua instância principal.
Exemplo de caminho: C:\TAF\appserver\appserver.ini
OBS: Para comentar uma chave basta colocar um " ; " a frente da chave, salvar o ini configurado e reiniciar o serviço.
8. Aplicando os pacotes/patcht´s pelo VSCode:
8.1 Instalando o VScode (para clientes que ainda não possuem o VScode instalado):
Com os serviços iniciados em modo exclusivo o próximo passo é instalar o VScode para aplicação dos pacotes.
Realize o download do VScode Clicando aqui e depois faça a instalação seguindo os passos abaixo:
Execute o programa do VScode baixado como administrador, aceite os termos e condições, escolha o local onde deseja instalar e depois avance até o término da instalação.
8.2 Configurando o VScode:
Depois da instalação do VScode iremos configura-lo para fazer a aplicação dos pacotes.
O primeiro passo é criar uma pasta para salvar suas configurações feitas no VScode.
Abra o VScode, acesse a opção "arquivos" ou "files", depois escolha a opção "abrir pasta" ou "open folder" e selecione a pasta onde deseja salvar as configurações.
Recomendamos que você crie uma pasta dentro da sua estrutura do TAF chamada de "ADVPL".
Ao selecionar a pasta no VScode, será necessário baixar a extensão da TOTVS.
Basta clicar no ícone e digitar no campo de pesquisa a palavra "TOTVS".
Instale a primeira opção chamada de "TOTVS Developer Studio for VSCode (AdvPL, TLPP e 4GL)" e abra a extensão após o término do download.
OBS: A instalação pode demorar alguns minutos dependendo do desempenho da sua máquina.
Ao abrir a extensão da TOTVS será necessário informar o seu Smart Client do ambiente que deseja aplicar os pacotes.
Selecione a primeira opção de "escolher arquivo" e abra o executável do seu Smart Client que está no seu servidor ou na estação de trabalho.
OBS: Normalmente o executável está localizado no caminho padrão do sistema.
Exemplos de caminhos: C:\TAF\bin\smartclient
Agora será necessário criar a conexão do seu servidor com o VScode.
Para isso, clique no botão do VScode e preencha os campos de acordo com as configurações do seu TAF.
Para saber quais são as configurações do seu TAF você deve acessar o seu arquivo "appserver.ini" e localizar o nome do seu ambiente e a porta TCP.
Exemplo de caminho: C:\TAF\appserver\appserver.ini
OBS: Normalmente o nome do seu ambiente é a primeira chave do seu ini e a porta TCP fica no final do arquivo ini.
Localizando o nome do seu ambiente e a porta TCP você deve preencher nos campos do VScode conforme exemplo abaixo:
Ao preencher os campos conforme suas configurações basta clicar no botão "Salvar/Fechar".
Você notará que será criada uma conexão no canto superior esquerdo do VScode onde você deve clicar no ícone para realizar a comunicação entre sua aplicação e o VScode.
Ao clicar, será exibido um campo onde você deve preencher primeiro o nome do seu ambiente e depois o usuário e senha do TAF.
Após o preenchimento, valide se o ícone da conexão ficou verde indicando que há conexão entre o VScode e o seu ambiente.
8.3 Aplicando o pacote/patch pelo VScode:
Agora basta clicar com o botão direito em cima da conexão, escolher a opção "Aplicar Pacote" ou "Patch Apply", selecionar os arquivos .ptm da pasta da LIB e Expedição contínua que foram baixados e clicar no botão Aplicar/Apply no VScode.
Você consegue validar se o pacote realmente foi aplicado visualizando a mensagem
9. Atualizando o dicionário de dados (UPDDISTR):
Depois da aplicação dos pacotes vamos atualizar o dicionário de dados do TAF.
Acesse a pasta "expedição contínua" que foi baixado, abra a pasta SDF/BRA, copie todo o conteúdo dentro desta pasta, depois cole e substitua os arquivos na pasta Systemload da sua estrutura do TAF.
Exemplo de caminho: C:\TAF\systemload
Após a substituição dos arquivos, acesse o UPDDISTR para realizar a atualização do dicionário do TAF.
Basta digitar UPDDISTR em Programa inicial na execução do SmartClient.
Na tela do UPDDISTR você deve avançar e aceitar todos os termos, preencher o campo de usuário e senha do administrador do TAF e nas "configurações de log" você deve deixar marcado as opções abaixo:
OBS: A atualização do dicionário pode demorar horas dependendo do tamanho do seu ambiente e do desemprenho do seu servidor.
Pronto, seu TAF está atualizado !
10. Atualizando as autocontidas (Wizard de Configuração do TAF):
No primeiro acesso do TAF, após atualização, será necessário rodar as autocontidas, Wizard de Configuração TAF, siga as orientações da documentação abaixo:
atualização das tabelas AUTOCONTIDAS
Caso ocorra algum erro nos processos passados, entre em contato com o suporte do TAF.
5 Comentários