Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice


       

Índice
exclude.*ndice:


Objetivo



       O objetivo deste documento é auxiliar os clientes da linha Datasul na atualização do TAF - TOTVS Automação Fiscal e TSS - TOTVS Service SOA. 

Processo de Atualização



Download do Pacote


Ao identificar a necessidade de atualização do TAF ou o suporte técnico ter solicitado a atualização do ambiente, primeiramente deve-se fazer download do(s) pacote(s) TAF na Central de Downloads. Os pacotes de programas e atualizações de dicionário sempre serão disponibilizados nas áreas abaixo:


Após concluir o download, extraia o pacote de Atualizações Periódicas para uma pasta qualquer da estação. Extraia também o pacote de Dicionário de Dados.

Exemplo dos objetos contidos no pacote da área Atualizações Periódicas:

Exemplo dos objetos contidos no pacote da área Dicionário de Dados:

Backup dos Arquivos do Ambiente


Antes de iniciar a atualização, recomendamos fazer backup dos seguintes objetos do ambiente:

  • Pasta APO (<dir-instalação-taf>\apo)
  • Pasta SYSTEM (<dir-instalação-taf>\system)
  • Pasta SYSTEMLOAD (<dir-instalação-taf>\systemload)
  • Banco de dados no SGBD do ambiente

Atualização TAF via TAF-Atualizador


Para executar a atualização, nenhum JOB deve estar ativo. Deve-se então editar o arquivo <dir-instalação-TAF>\bin\app\appserver.ini e comentar a variável JOBS no bloco abaixo: 

[OnStart]

;JOBS=HTTPJOB,TAF_CFGJOB

Após comentar a variável, deve-se reiniciar o serviço Taf-WS.

Instalações mais recentes do TAF, já instalam um serviço separado chamado Taf-Patch ou Taf-Atualizador onde neste caso, não há necessidade de comentar a variável. Deve-se apenas executar a atualização com o serviço do WS parado.


Deck of Cards
idAtualização TAF
Card
label1º Passo

Acesse o ícone Taf-Atualizador disponível na área de trabalho da estação e clique em Avançar.

Card
label2º Passo

Preencha o usuário e senha e clique no botão Buscar para selecionar o pacote de atualização e clique no botão Avançar:

Card
label3º Passo

Ao clicar em Avançar, caso o serviço do WS esteja ativo será apresentada a mensagem abaixo:

Caso a atualização já esteja sendo executada com o serviço WS parado, será então apresentada a tela para análise dos objetos contidos no arquivo de patch informado.

Este processo pode levar alguns minutos dependendo da quantidade de objetos contidos no patch.

Card
label4º Passo

Ao final, será apresentada a tela com a lista dos objetos que serão atualizados.

Objeto do pacote tem data superior ao objeto no ambiente

Objeto do pacote tem data igual ao objeto no ambiente

Objeto do pacote tem data inferior ao objeto no ambiente

Clicar no botão Confirmar.


Ao clicar no Confirmar, caso apresente a mensagem abaixo, clique no botão Atualizados.


Card
label5º Passo

Selecione o arquivo sdfbra.txt dentro do diretório onde foi extraído o pacote de dicionário. Busque também o arquivo de help diferencial (hlpdfpor.txt) e clique em Avançar.


Card
label6º Passo

Em seguida, clique em Finalizar e aguarde.



Card
label7º Passo

Nesta tela, clique em Avançar.

Card
label8º Passo

Clique em Avançar.

Card
label9º Passo

Tomar conhecimento do Termo de Aceite e Avançar.

Card
label10º Passo

Marcar os campos referente a realização de backup do ambiente e clicar em Avançar.

Card
label11º Passo

Confirmar que não possui customizações ou já analisou o impacto e Avançar.

Card
label12º Passo

Clicar em Avançar.


Card
label13º Passo

Apertar a tecla TAB até o botão Avançar habilitar e avançar.

Card
label14º Passo


Card
label15º Passo

Card
label16º Passo

Clicar em Avançar e aguardar o processamento.

Card
label17º Passo

Ao final, será apresentada a tela abaixo indicando o término do processo de atualização. Clicar em Finalizar.


Após o processo de Atualização


Criação e configuração ODBC - TAF e TSS

Deck of Cards
idCriação e configuração ODBC - TAF
Card
label1º Passo

É necessário que o ODBC seja criado em 32 bits, então execute o comando “%WinDir%\SysWoW64\odbcad32.exe” - para TOTVS | DBAccess 32 bits em sistemas operacionais 64 bits.

 

Card
label2º Passo

Após executar o comando, o Windows abre o “Administrador de Fonte de dados ODBC”.

Crie a fonte de dados acessando a aba “Fonte de dados do sistema” e clicando em “Adicionar”:

Card
label3º Passo

Selecione o driver “SQL Server”:

Card
label4º Passo

Informe o nome da nova fonte de dados (por padrão utilizamos o nome TAF) e o nome do servidor onde a base de dados foi criada e clique em “Avançar”:

Card
label5º Passo

Na tela seguinte, informe o usuário e senha de banco de dados que serão utilizados para realizar a conexão. Por padrão, o script criará o usuário “esocial” com a senha “esocial”. Preencha as informações e clique em “Avançar”:

Card
label6º Passo

Na opção “Alterar o banco de dados padrão para”, selecione a base de dados criada para o TAF e marque as opções “Usar identificadores ANSI entre aspas” e “Usar nulos, preenchimentos e avisos ANSI” e clique em “Avançar”:

Card
label7º Passo

Marque a opção “Executar conversão dos dados de caracteres” e clique em “Concluir”:

Card
label8º Passo

Utilize a opção “Testar fonte de dados” para validar as informações passadas na criação do ODBC.

Card
label9º Passo

Após a conclusão do processo de criação do ODBC para a base de dados TAF, vamos realizar o mesmo procedimento para a base TSS.

Crie a fonte de dados acessando a aba “Fonte de dados do sistema” e clicando em “Adicionar”.

Informe o nome da nova fonte de dados (por padrão utilizamos o nome TSS) e o nome do servidor onde a base de dados foi criada e clique em “Avançar”:

Card
label10º Passo

Na tela seguinte, informe o usuário e senha de banco de dados que serão utilizados para realizar a conexão. Por padrão, o script criará o usuário “esocial” com a senha “esocial”. Preencha as informações e clique em “Avançar”:

Card
label11º Passo

Na opção “Alterar o banco de dados padrão para”, selecione a base de dados criada para oTSS e marque as opções “Usar identificadores ANSI entre aspas” e “Usar nulos, preenchimentos e avisos ANSI” e clique em “Avançar”:

Card
label12º Passo

Marque a opção “Executar conversão dos dados de caracteres” e clique em “Concluir”:

Card
label13º Passo

Utilize a opção “Testar fonte de dados” para validar as informações passadas na criação do ODBC.

Card
label14º Passo

Caso o ODBC tenha sido criado corretamente, a mensagem abaixo será apresentada:


TAF e TSS utilizando Oracle



Deck of Cards
idOracle

Caso o SGBD utilizado seja o Oracle, segue procedimento para a criação da instância.

Card
label1º Passo

Abra o assistente de configuração do Banco de dados e selecine a opção “Criar Banco de Dados”

Card
label2º Passo

Na tela modo de criação informe o “Nome do Banco de dados”  o chracter set deve ser o WE8MSWIN1252 conforme abaixo. Determine uma senha e confirme a mesma.

Obs: Esta senha será atribuída ao usuário ‘sys’. Para criação de outro usuário você pode utilizar após criação da instância o script de criação do usuário que consta na documentação, o indicado é que seja feito. Clique em “próximo”.

Card
label3º Passo

Esta tela apresenta um resumo das informações da instância. Clique em “ Finalizar”.

Card
label4º Passo

Ao ser apresentada a seguinte tela, basta aguardar o processo de criação da instância ser concluído.

Card
label5º Passo

O processo esta finalizado após apresentação da seguinte tela.

Card
label6º Passo

Para criar o tnsnames.ora, acesse o Net Manager e clique em “Configurações do Oracle Net”.

Card
label7º Passo

Espanda até encontrar a opção “Nomeação de Serviço”, selecione a mesma e após clique no ícone de adição.

Card
label8º Passo

A configuração do nome do serviço é feita neste momento, informe o nome desejado.


Card
label9º Passo

Selecione o protocolo de rede e clique em “Próximo”

Card
label10º Passo

Informe neste momento o nome do servidor onde foi criado o banco de dados e o número da porta a ser utilizada.

Card
label11º Passo

Neste caso deve ser informado o mesmo nome da instância já criada.

Card
label12º Passo

Você pode realizar um teste da conexão nesta tela. Caso seja necessário realizar outras validações referentes a conexão criada, clique aqui e acesse o documento no TDN .

Card
label13º Passo

Após a criação da base de dados, execute o script abaixo para criar o usuário padrão:

 

--Criação de tablespaces específicas para o TAF - Motivo: Desempenho e gerenciamento

CREATE TABLESPACE ESOCIAL_DADOS

DATAFILE 'C:\BasesOracle\Taf\ESOCIALDADOS1.DAT' SIZE 120M  AUTOEXTEND ON NEXT 10M

   DEFAULT STORAGE ( INITIAL 8K

                 NEXT    256K

                 MINEXTENTS 1

                 MAXEXTENTS 121

                 PCTINCREASE 50);

CREATE TABLESPACE ESOCIAL_INDICES

   DATAFILE 'C:\BasesOracle\Taf\RMIND1.IDX' SIZE 30M  AUTOEXTEND ON NEXT 10M

   DEFAULT STORAGE ( INITIAL 8K

                 NEXT    84K

                 MINEXTENTS 1

                 MAXEXTENTS 121

                 PCTINCREASE 50);

CREATE TEMPORARY TABLESPACE ESOCIAL_TMP

   TEMPFILE 'C:\BasesOracle\Taf\ESOCIALTMP1.DAT' SIZE 10M  AUTOEXTEND ON NEXT 5M

EXTENT MANAGEMENT LOCAL;

-- Criação de Usuários


CREATE      USER ESOCIAL

      IDENTIFIED BY ESOCIAL

      DEFAULT TABLESPACE  ESOCIAL_DADOS

      TEMPORARY TABLESPACE ESOCIAL_TMP;


GRANT CONNECT,DBA,RESOURCE TO ESOCIAL;

GRANT CONNECT, RESOURCE, CREATE VIEW TO ESOCIAL;

GRANT SELECT ANY DICTIONARY TO ESOCIAL;

GRANT EXECUTE ON DBMS_SYS_SQL TO ESOCIAL;

GRANT EXECUTE ON DBMS_SQL TO ESOCIAL;

GRANT CREATE TRIGGER TO ESOCIAL;

GRANT DROP ANY TRIGGER TO ESOCIAL;

GRANT SELECT ON V_$SESSION TO ESOCIAL;

GRANT SELECT ON V_$STATNAME TO ESOCIAL;

GRANT SELECT ON V_$SESSTAT TO ESOCIAL;

GRANT SELECT ON V_$INSTANCE TO ESOCIAL;

GRANT SELECT ON SYS.OBJ$ TO ESOCIAL;

GRANT SELECT ON SYS.COL$ TO ESOCIAL;

GRANT SELECT ON SYS.ICOL$ TO ESOCIAL;

GRANT SELECT ON SYS.IND$ TO ESOCIAL;


Instalação do TAF


Após a realização dos procedimentos anteriores é hora de iniciar a instalação do TAF.

Primeira parte - Execução do instalador



Deck of Cards
idInstalação do TAF
Card
labelDownload

Para iniciarmos a instalação do TAF, extraia o conteúdo do instalador baixado e execute. A tela referente ao Contrato de Licença de uso será apresentada. Após a leitura e aceite do mesmo, clique na opção “Avançar”:

Card
label1º Passo

Selecione o diretório onde o sistema será instalado e clique em “Avançar”. Por padrão, a instalação é realizada no caminho C:\TOTVS\TAF:

Card
label2º Passo

Nesta tela são apresentados os componentes que serão instalados. Selecione o DbAccess a ser instalado e clique em avançar, sem desmarcar nenhuma opção:

Card
label3º Passo

Selecione o diretório para a criação de atalhos e clique em “Avançar”:

Card
label4º Passo

A tela abaixo será apresentada com as informações referentes aos componentes selecionados para serem instalados. Clique em instalar para iniciar o processo: 

Card
label5º Passo

Durante a instalação as seguintes telas serão apresentadas. Este processo leva alguns minutos:

Card
label6º Passo

Após a finalização da configuração da instalação, o assistente será apresentado. Clique em avançar para prosseguir com a instalação:

Card
label7º Passo

Selecione a opção de SGBD que foi configurado no início do procedimento (MSSQL ou Oracle) e informe o nome da conexão que foi criada no ODBC.

Desça a tela utilizando a barra de rolagem e informe usuário e senha. Caso os mesmos tenham sido criados utilizando o script padrão do início do documento, digite:

Usuário = esocial
Senha = esocial

Importante: Caso a base de dados seja Oracle, selecione o caminho da oci.dll criada na instalação do Oracle. Para facilitar, a DLL está localizada na pasta bin da home do Oracle.

Obs: Caso o usuário/senha tenham sido alterados no início do procedimento, favor utilizar a informar os dados utilizados.

Clique em “Avançar” para que o assistente faça as configurações necessárias no ambiente. 

Card
label8º Passo

Após a criação dos arquivos de configuração do DbAccess, a mensagem informando que a configuração foi efetuada corretamente será apresentada. Clique em “Fechar” para que a instalação do TAF seja iniciada: 

Caso seja apresentada a mensagem abaixo referente a falha de conexão, finalize o sistema, reinicie o serviço do DbAccess (Taf-DbAccess) e execute o sistema novamente. Além disso, valide a conexão criada utilizando o DbMonitor. (Veja no menu "Configuração DbMonitor", como realizar a validação através do aplicativo.)

Card
label9º Passo

Neste momento a instalação do TAF será iniciada. Informe a porta para comunicação com o Smartclient HTML. Por padrão, a 8095 é apresentada na instalação. Caso seja necessário, realize a alteração. (Verifique a aba de dicas para verificar se a porta está liberada.)

Caso seja possível que outras máquinas atualizem o aplicativo que está sendo instalado, informe os IP’s das mesmas utilizando o campo *Opcional apresentado na tela e clique em “Avançar”:

Card
label10º Passo

Na tela que será apresentada, informe o IP e a porta do servidor de licenças, para que seja feita a validação e o consumo das mesmas. 

Card
label11º Passo

Após fornecer as informações referentes ao License Server, será apresentada a tela para a seleção dos “Menus” a serem instalados. Orientamos que todos sejam selecionados, para evitar a necessidade de reinstalação, caso algum outro módulo seja integrado com o TAF em sua empresa. Clique em “Avançar” para prosseguir com a instalação:

Card
label12º Passo

Após a seleção dos menus a serem instalados, será apresentada a tela abaixo com alguns links úteis para maiores informações sobre o TAF e os componentes da sua instalação. Clique em “Finalizar” para que a instalação seja iniciada:

Durante a execução do instalador, a tela abaixo permanecerá aberta.

Card
label13º Passo

Após a finalização do processo, a tela abaixo será apresentada e os atalhos serão criados na área de trabalho. Finalize o assistente de instalação para que a configuração inicial do sistema seja realizada.

Caso a instalação executada tenha sido a “Instalação Completa – TAF + TSS”, conforme orientado no início do processo, aguarde alguns instantes para que a instalação do TSS seja iniciada. Caso a tela não seja apresentada, execute o comando Alt+Tab e verifique se o ícone abaixo será apresentado e selecione o mesmo.

Card
labelDicas!

Dica1: Para verificar se a porta está em uso, utilize o comando netstat -n -a | find ":8095" (onde 8095 é a porta que está sendo testada) no prompt. No exemplo abaixo, a porta está sendo utilizada:

No exemplo abaixo nenhum status foi apresentado, portanto a porta está liberada:



Configuração DbMonitor



Deck of Cards
idConfiguração DbMonitor
Card
label1º Passo

Para realizar a validação da conexão do TAF com o DbAccess, acesse o caminho de instalação do mesmo para a realização do teste. Por padrão, o mesmo é instalado em "C:\totvs\TAF\TafDbAccess32".

Neste diretório, localize o arquivo "dbaccess.ini" e abra com um editor de texto. Nele será possível identificar a porta que foi utilizada para realizar a comunicação entre os sistemas.


Card
label2º Passo

Após identificar a porta, execute o aplicativo "DbMonitor.exe", localizado no mesmo diretório. Informe o nome da máquina em que a instalação está sendo realizada e a porta que foi identificada no passo anterior e clique em "Ok":

Card
label3º Passo

Acesse a aba “Configurações” e depois selecione a aba de acordo com o SGBD utilizado para a criação da base de dados. Clique em novo para configurar a conexão que será validada no teste.

Importante: Caso seja Oracle, utilize a aba correspondente ao SGBD.

Card
label4º Passo

Informe o nome da conexão criada no início (Por padrão, a conexão foi criada como TAF) e clique em “Ok”:

Card
label5º Passo - SQL

Selecione o ambiente, informe o usuário e a senha de banco de dados e clique em "Salvar". Na criação da base de dados, executamos o script para a criação do usuário. (Usuário: esocial e senha: esocial)

Card
label5º Passo - Oracle

Selecione o ambiente, informe o usuário e a senha de banco de dados e clique em "Salvar". Na criação da base de dados, executamos o script para a criação do usuário. (Usuário: esocial e senha: esocial)

Card
label6º Passo

Após fornecer as informações, selecione a aba “Assistentes” e em seguida a opção “Validação de Conexão”:

Card
label7º Passo

A tela de boas-vindas do assistente será apresentada. Clique na opção “Avançar” para que a tela de seleção de banco de dados seja apresentada:

Card
label8º Passo

Selecione o banco de dados utilizado para a criação das bases de dados e clique em “Avançar”:

Card
label9º Passo

Informe o nome da conexão que será testada e clique em “Finalizar”:

Card
label10º Passo

Caso a configuração da conexão esteja correta, a mensagem abaixo será apresentada:




Instalação do TSS



Deck of Cards
idInstalação do TSS

Após a instalação do TAF, utilizando a opção de instalação completa, a instalação do TSS será iniciada automaticamente. Siga os procedimentos abaixo para realizar a parametrização:

Card
label1º Passo

Selecione o idioma de instalação e clique em “OK”:

Card
label2º Passo

A tela de “Boas Vindas” será apresentada. Clique em “Próximo” para prosseguir com a instalação:

Card
label3º Passo

A tela referente ao Contrato de Licença de uso será apresentada. Após a leitura e aceite do mesmo, clique na opção “Avançar”:

Card
label4º Passo

** Selecione o caminho para instalação e clique em “Próximo”. Por padrão, a instalação é realizada no caminho C:\totvssped, porem orientamos que o caminho seja alterado para "C:\TOTVS\TAF\totvssped, para facilitar a manutenção de arquivos:

Obs: Após a definição do caminho a ser utilizado, a mensagem abaixo será apresentada. No exemplo foi utilizado o caminho padrão:

Card
label5º Passo

Na tela seguinte, mantenha a opção referente a instalação do TOTVS Service SOA “Online” marcada e clique em “Próximo”:

Card
label6º Passo

Nesta tela, iremos utilizar algumas informações que já foram configuradas anteriormente:

Sobre as configurações do TSS, informe o nome da máquina em que o mesmo foi instalado e a porta que será utilizada para a comunicação.

Nas informações pertinentes ao banco de dados que será utilizado pelo TSS, utilize as mesmas configurações que foram preenchidas ou identificadas no DbMonitor (nome da máquina, alias e porta)

Card
label7º Passo

Como o DbAccess já foi instalado junto com o TAF, apenas mantenha as opções que foram marcadas como Default e clique em "Próximo":

Card
label8º Passo

Nesta tela, apenas altere a porta, caso a Default esteja sendo utilizada e clique em "Próximo":

Card
label9º Passo

Neste momento, o sistema será instalado. Aguarde a conclusão do processo e clique em "Próximo":

Card
label10º Passo

Agora, vamos definir as preferências em relação a utilização do sistema e a criação de atalhos. Após realizar a seleção, clique em "Próximo":

Card
label11º Passo

O sistema irá realizar as configurações finais da instalação e iniciar os serviços utilizando as mesmas. Clique em "Próximo" para concluir o processo:

Card
label12º Passo

Clique em "Pronto" para finalizar o wizard:




Configuração inicial do TAF (primeiro acesso)



Deck of Cards
idConfiguração inicial do TAF (primeiro acesso):
Card
label1º Passo

Localize o atalho criado na área de trabalho e execute o aplicativo:

Card
label2º Passo

Informe o usuário “admin”, deixe o campo referente a senha vazio e clique no botão “Entrar”:

Card
label3º Passo

Na tela de boas-vindas ao usuário, verifique as informações apresentadas e clique novamente em “Entrar”:

Card
label4º Passo

Selecione a localização e clique em “Ok”:

Card
label5º Passo

A tela referente a criação das tabelas do sistema será apresentada:

Card
label6º Passo

Selecione o diretório dos arquivos de dados (C:\totvs\TAF\data) e clique em abrir: 

Card
label7º Passo

Novamente a tela de criação de tabelas na base de dados será apresentada:

Card
label8º Passo

Ao finalizar a criação das tabelas, será apresentada a tela de cadastro de moedas. Apenas clique em “Confirmar”:

Card
label9º Passo

Neste momento será apresentada a tela informando que existe uma divergência nas informações. Clique em "Avançar" para corrigir/atualizar a informação.

Card
label10º Passo

Clique no menu "Efetuar amarração dos Estabelecimentos" para iniciar o procedimento:

Card
label11º Passo

Na tela abaixo, de um duplo clique no campo "Código Complementar" até que apareça a informação 99 (onde 99 equivale ao Grupo de Empresa) + 01 (onde 01 equivale ao Código da Filial).

Neste caso ficaria 9901. Após alterar as informações, clique em "Confirmar" para prosseguir.

Card
label12º Passo

Aguarde o termino do processamento das informações, conforme tela abaixo e posteriormente clique em finalizar. Neste momento será necessário efetuar um novo login no TAF.


Configuração inicial do TAF (segundo acesso)



Deck of Cards
idConfiguração inicial do TAF (segundo acesso):
Card
label1º Passo

Após efetuar o segundo login no sistema, a tela de apresentação do processo de configuração do TAF será apresentada. Clique em “Avançar”:

Card
label2º Passo

Na tela de seleção do Grupo para processamento, selecione as empresas habilitadas para processamento e clique em “Avançar”:

Card
label3º Passo

Selecione as opções marcadas abaixo e clique em “Avançar”:

Card
label4º Passo

Na opção “Porta de Conexão do DbAccess” a informação deverá ser a mesma que foi utilizada no início da instalação. (Verifique a informação conforme a configuração realizada no DbMonitor):

Card
label5º Passo

Na tela seguinte, por padrão a “Porta de conexão do Web Services” vem como 8080, porém essa porta geralmente já é usada no RM Portal. Orientamos que utilize a porta 8090, caso a mesma não esteja em uso. Clique em “Avançar” após o preenchimento das informações:

Card
label6º Passo

Clique em “Processar as configurações realizadas neste assistente” para finalizar a configuração:

Card
label7º Passo

Será exibida a tela de status do processamento das informações.

Card
label8º Passo

Ao finalizar o procedimento solicitado, será exibida a tela anterior com o log de execução:

Card
label9º Passo

Clique em finalizar e reinicie o sistema para prosseguir com as parametrizações:

Card
label10º Passo

Ao finalizar o wizard, um resumo das configurações utilizadas será apresentado. Apenas confirme as informações e clique em "Sair":


Semanalmente é expedido no portal do cliente pacotes de atualização cumulativo contendo todas os ajustes e melhorias feitas dentro do release até a data da expedição; basta acessar a central de downloads selecionando a "Linha de Produto" como "TAF" e selecionando o release desejado; após isso baixar o patch de atualização da pasta "Atualizações Periódicas" e o pacote de dicionário da pasta "Dicionário de Dados".
Informações
iconfalse
Informações
iconfalse

Produto: TAF e TSS

Informações
iconfalse

Versão: 12.1.XX

Informações
iconfalse

Processo: Instalação, configuração e atualização do TAF - TOTVS Automação Fiscal e TSS.

Informações
iconfalse
Informações
iconfalse

Status: Publicado

Informações
iconfalse

Data:  

Informações
iconfalse

Autores:

Karen de Freitas Machado