Contexto

O Instalador/Atualizador do TAF, foi criado com o intuito de simplificar o processo de instalação/atualização para clientes que utilizam o TAF como solução segregada ao ERP ( Clientes que utilizam o TAF como um módulo do Protheus, ou seja, utilizam outros módulos além do TAF, não devem utilizar essa funcionalidade)

Pré-Requisitos

• TAF instalado em sua estrutura padrão:

Ou seja, toda a estrutura de pastas devem estar na RAIZ, caso contrário, o sistema não irá apresentar o ambiente para instalação.

• Nome do Ambiente deverá obrigatoriamente ser TAF:

Passo a Passo

Após realizar o Download do Portal do Cliente da última versão, executar o arquivo baixado com permissões de Administrador.

Selecione a opção "Atualizar produtos já instalados"

Clique em Próximo

A imagem acima exibe a interface questionando quais produtos o cliente utiliza. Repare que NÃO é apresentada a opção Protheus, pois clientes deste produto NÃO DEVEM UTILIZAR o atualizador. Caso clientes da linha Protheus prossigam com a operação, será aplicada a atualização de toda a sua base de dados e não somente do TAF.

Clique em Próximo

Confirme a janela apresentada.

Termo de Aceite (Alerta de Processo crítico)

Clique em Próximo

Termo de Aceite (Leitura de Documentação)

Clique em Próximo

Termo de Aceite (Backup)

Clique em Próximo

Acima estão listados todos os ambientes do TAF/TSS que possuem a estrutura correta para atualização.

Selecione o ambiente desejado e Clique em Próximo

A interface acima, foi criada para que seja informado os dados do usuário e senha do Protheus, para isso clique em "Parâmetros da Instalação"

Informe o usuário e senha do TAF com permissão de Administrador e Clique em Próximo

Confirme a tela de Backup

Pode-se acompanhar os detalhes da atualização, através do botão .. (ao lado da barra de progresso)

Tela gerada ao Fim da Atualização com Sucesso.

Tela gerada ao fim da Atualização com Falha

Caso aconteça algum erro na atualização, o rollback será executado e serão apresentados as seguintes interfaces

Clicando no botão .. (ao lado da barra de progresso),são exibidos os detalhes dos erros.

Backup da Aplicação (Atualização)

No momento do início da atualização, o atualizador cria um backup do ambiente dentro do rootpath do TAF:

Nomenclatura do diretório de backup tafbkpdd.MM.yyyy-hh.mm.ss (dd=dia, MM=mês, yyyy=ano, hh=hora, mm=minuto, ss=segundo referente ao início de execução do atualizador)

Esse diretório contém apenas o backup da Aplicação TAF.

Esse diretório nunca é excluído de forma automática.

Não é realizado o backup do Banco de Dados 

Observações

Pontos Importantes

• O atualizador/instalador foi projetado para rodar apenas em ambiente Windows;
• O atualizador foi desenvolvido para clientes que utilizam o TAF como solução "SEGREGADA", caso utilize algum módulo Protheus além do TAF, O ATUALIZADOR NÃO DEVERÁ SER UTILIZADO;
• É altamente recomendável que seja feito backup da Aplicação e Banco de Dados antes de rodar o atualizador;
• Se o ambiente estiver utilizando os metadados como ADS (dbf), será realizado a conversão para CTREE de forma transparente;
• Caso haja erro na conversão dos SXs, será realizado o rollback de seu ambiente de forma transparente;
• Caso haja erro na execução do UPDDistr, será realizado o rollback, para isso a execução do UPDDistr é dividida em 2 partes:
  • Simulação - Rodar em modo simulação em busca do possíveis erros, caso tenham erros, o rollback é efetuado e será avisado ao usuário qual o erro, para que o mesmo seja corrigido manualmente.
  • Produção - Caso tenha sucesso na execução em modo simulação, deverá ser executado em modo "Produção" ou seja, efetuando as devidas alterações no dicionário de dados.

O que verificar caso o ambiente não apareça para seleção no momento da Atualização

• Estrutura de pastas

A estrutura de pastas deve seguir a mesma instrutura que disponibilizada no momento da instalação, conforme exemplo abaixo:

Onde, no diretório raiz deverá possuir as pastas principais da aplicação (apo/bin/system/systemload).

Dentro da pasta "bin" também deverá estar no padrão:

Onde, deverá possuir as pastas do binário (app/appserver/smartclient).

• Nomenclatura do Ambiente

O nome do ambiente deverá ser TAF

O que fazer caso o Atualizador "congelar" no momento da sua execução

Existe a possibilidade de que no momento da atualização, por alguma ocorrência não mapeada, o Atualizador congele, caso no momento da execução, seja identificada essa ocorrência, o usuário deverá:

1. Forçar o fechamento do aplicativo de atualização (utilizando recursos de Sistema Operacional);
2. Acessar o rootpath (estrutura do TAF) e procurar pela seguinte pasta tafbkpdd.MM.yyyy-hh.mm.ss (onde dd=dia, MM=mês, yyyy=ano, hh=hora, mm=minuto, ss=segundo referente ao início de execução do atualizador)

Esse diretório, contém o backup realizado no início da atualização, deverá ser copiado o conteúdo que está dentro do mesmo e colado no rootpath (estrutura do TAF), para que o ambiente volte a sua estrutura original (anterior a instalação).

Erro UPDDISTR falha TOPCONN No Connection: -2 ou -35 

Esta falha ocorre nos ambientes que possuem drives ODBC ou versão da OCI na arquitetura  32 bits, antes de prosseguir com a instalação é necessario mudar a arquitetura do drive para 64 bits.