Manual de Instalação

Esse documento te auxilia a realizar o processo de Instalação do TOTVS Automação Fiscal.

Índice

Índice

Deck of Cards

id	1

Card

default	true
id	1
label	Pré-requisitos

Pré-Requisitos

Banco de dados

Para que a instalação do TOTVS Automação Fiscal seja concluída executada com sucesso, é imprescindível que o ambiente de instalação já possua um banco de dados instalado, conforme premissas abaixo:

Plataformas homologadas: Acesse DBAccess - Plataforma homologada e verifique se o seu banco de dados está pronto para ser utilizado
- Para o TAF temos somente os SGBDs DB2, Informix, MS SQL Server, Oracle e PostgreSQL. Para mais detalhes, acesse <<aqui>> e veja as informações dos SGBDs mencionados. Importante verificar e parametrizar o Collation correto.

Aviso

icon	false
title	Instalador

O Instalador TAF realiza a instalação/atualização somente em ambientes configurados com os bancos Oracle e MS SQL Server, para as demais opções é necessário realizar a instalação/atualização do produto de de forma manual seguindo as mesmas diretrizes do Protheus.

- - Caso já tenha disponível e pronto para uso uma instalação do sistema de banco de dados com os pré-requisitos acima (Sgbd e Collation), pode-se utilizar esta mesma instalação para a base de dados do TAF utilizando um database diferente (específico do TAF). Caso já possua algum produto Protheus, pode-se utilizar o mesmo database do ERP;
  - O banco de dados Progress OpenEdge é homologado somente para entrega do eSocial e da EFD Reinf.
- Para o TSS temos somente os SGBDs DB2, Informix, MS SQL Server, My SQL e Oracle.

Segurança: É necessário que a autenticação de acesso ao banco de dados seja através de uma senha do SGBD ou uma autenticação mista, ou seja, através de uma senha do SGBD ou do SO. A autenticação automática pelo SO impede a inicialização do serviço.

Conexão ODBC

Para a correta instalação do TOTVS Automação Fiscal, é necessário que a configuração de ODBC seja configurada previamente entre o SO e 32Bits ou 64bits, (dependendo da escolha no momento da instalação)seja realizada previamente com o Banco de dados. Para mais informações sobre essa configuração acesso ODBC - DBAccess - Como fazer.acesse <<aqui>>.

Para evitar erros de conexão do dbAccess no momento da instalação, avaliar a consideração da faq TAF0105_Erro_Conexão_dbAccess_TAF

Servidor de Licenças

É necessário possuir em mãos os dados de acesso ao seu Servidor de Licenças TOTVS, pois durante a instalação será necessário o preenchimento do endereço e porta deste serviço. Para mais informações sobre o Servidor de Licenças TOTVS acesse TOTVS | License Server 2014.

Seleção de PORTAS TCP e HTTP do SO para serem utilizadas pelo TAF

Para a correta instalação dos serviços do TAF, é necessário ter em mão 6 portas livres no SO para configurar os serviços, são elas:

Porta TCP para Taf-Appserver, serviço server-side do TAF;
Porta TCP para Taf-dbAccess32 ou Taf-dbAccess64 , middleware de conexão com o SGBD;
Porta TCP para Taf-Patch, serviço de aplicação de atualizações no TAF;
Porta TCP para Taf-WS, Serviço responsável por controlar o Webservice de integrações - REST;
Porta HTTP para Taf-WS, serviço de WebService REST para integração entre sistemas;
Porta HTTP para o serviço Web, de forma a acessar o TAF via WebApp;

** Essas portas serão solicitadas durante a instalação do TAF nos momentos certos.

Card

default	true
id	2
label	Download

Download

Faça o download do arquivo de instalação através do Portal da TOTVS. Acesse www.suporte.totvs.com.br.

Mais detalhes pode ser obtido através do link 01. Instalação - Segregado - Versão 12

Card

default	true
id	3
label	Instalação

Processo de Instalação

Após concluir o download, clique duas vezes no arquivo executável do Instalador do TAF ( InstaladorTAF_INSTALADOR_Taf12117.exe ):

Image RemovedImage Added

Será aberto um assistente de instalação.

Image Added

Leia o contrato de utilização do Software e clique em Avançar:

Image Removed

Image Added

Selecione o diretório onde o TAF será instalado e clique em Avançar:

Image Removed

Image Added

A instalação do TSS neste momento é opcional, para mais informações clique aqui para verificar a documentação de instalação do TSS.

Selecione qual versão do DBAccess deseja instalar, 32bits ou 64 bits

Image Added

Selecione a pasta que será criada no menu iniciar:

Image RemovedImage Added

Confira o resumo da instalação e clique em Instalar.

Image RemovedImage Added

Image Added

Image Removed

Será aberto novo assistente de Configuração de Ambiente da Instalação do TAF. Clique em Avançar.

Image Removed

Image Added

Na seção ODBC/TNS, é importante que todas as etapas do tópico Pré-Requisitos desse manual tenham sido concluídos com sucesso.

Preencha os campos de acordo com as premissas abaixo:

Selecione o SGBD: Informe qual o Sistema de Gerenciamento de Banco de dados que será utilizado para o TAF
Informar o Nome da da conexão: Informe o alias da instancia do banco de dados que será utilizada para o TAF. Mesmo nome utilizado na configuração do ODBC ou TNS.
- Informar o Usuário: Informe o usuário de acesso ao Banco de dados.
- Informar a Senha: Informe a senha de acesso ao Banco de dados.
Image Removed
- Observação para quando deixar o Usuário/Senha em branco:
  - Caso a autenticação selecionada no SGBD seja autenticação do windows, esses 2 parâmetros devem ser deixados em branco.
Image Added

Em caso de falha de conexão, consultar o link Erros_dbAccess
Image Added

Para banco de dados ORACLE será necessário informar o caminho da OCI ( Acesse DBAccess - Como criar uma fonte de dados para uso com Oracle <<aqui>> para mais informações sobre configuração do banco de dados ORACLE )
Image Removed

Ao tentar alterar a porta de acesso ao TOTVS|DbAccess, será apresentada a mensagem abaixo, informando sobre a necessidade de reiniciar o serviço desta plataforma.
Image Removed

Você pode escolher entre manter a porta padrão 7999 ou reiniciar o serviço do DbAccess. Ao manter a porta 7999, as configurações serão mantidas e o sistema realizará a conexão com o TOTVS|DbAccess.
Exemplo: Para reiniciar o serviço, basta acessar a Ferramenta de Gerenciamento de Serviços do Windows e seguir os passos conforme imagens abaixo.
Image Removed

Clique em Refresh, aguarde o reinicio do serviço e retorne ao Instalador do TAF. Clique em Continuar.
Image Removed
Image Removed

.
O arquivo OCI.DLL é uma biblioteca da Oracle criada para Sistemas Operacionais Windows compartilhar recursos entre os Sistemas, assim como qualquer outra DLL(dynamic link library); neste caso é preciso informar ao TAF o caminho desta biblioteca para utilizar também esses recursos e acessar o SGBD.
Importante: TOTVS|DBAccess é um middleware entre o banco de dados e o TAF; ele é um componente transparente e instalado automaticamente por este instalador.
Após clicar em avançar, neste Neste momento o assistente tentará realizar uma conexão ao serviço do TOTVS|DbAccess e caso as configurações tenham sido preenchidas corretamente, será apresentada uma mensagem de sucesso:

Caso esteja sendo apresentado TAF0105_Erro_Conexão_dbAccess_TAF, este link ajudará na solução.

Na seção TOTVS AppServer, preencher os campos conforme abaixo:
- Porta TCP: Neste momento o serviço do TOTVS|AppServer já foi criado na porta 5999. Se necessário, a porta de acesso a este serviço pode ser alterada neste campo.Porta Smart Client HTML: Informe a porta onde o Smart Client HTML será executado.
Para acessar o TAF pelo navegador de internet, basta preencher o IP do servidor onde o TAF foi instalado, seguido da porta configurada na wizard abaixo.
Image Added
Exemplo:
http://10.172.67.45:8085/
Image Added
- IP's para Aplicação de patch ( AllowApplyPatch ) - OPCIONAL: Defina os IP's (HOST NAMES) que terão acesso a aplicação de patch no ambiente do TAF que está sendo instalado.
Image Removed
Caso a porta de conexão ao TOTVS|ApplicationServer seja alterada, será necessário reiniciar o serviço Taf-Appserver ao final da instalação. Esse procedimento é imprescindível para garantir o correto funcionamento do sistema.
O processo de Instalação oferecerá a alternativa de manter a porta padrão
- .
Abaixo um exemplo de alteração da porta padrão:
Image Removed
Será apresentada a mensagem abaixo:
Image Removed

Caso mantenha a decisão de alterar a porta, o sistema te trará novo alerta informando a criticidade do procedimento ser realizado.
Image Removed

Exemplo de como reiniciar o serviço do sistema operacional Windows manualmente através da Ferramenta de Gerenciamento de Serviços:
Image Removed
Image Removed

Na seção Servidor de Licenças, preencha os campos conforme abaixo:
- Informar o Endereço do Servidor de Licenças: Informe o endereço de rede onde está localizado o Servidor de Licenças
- Informar a Porta do Servidor de Licenças: Informe a porta onde está localizado o Servidor de Licenças
Image Removed
- OPCIONAL - Caso desejar testar o servidor de licenças antes da instalação, basta preencher o Ambiente além dos demais campos da Wizard.
Image Added

Na seção Menu, defina o tipo de menu que será utilizado na instalação de acordo com a legislação/obrigação fiscal que será utilizada:
- Somente eSocial: Instala o TAF com as opções de menu ( cadastros e funcionalidades ) somente para o eSocial;
- Somente Fiscal: Instala o TAF com as opções de menu ( cadastros e funcionalidades ) somente para o Fiscal ( escopo de obrigações fiscais nas esferas federal, estadual e municipal, com exceção da ECF );
- Somente ECF: Instala o TAF com as opções de menu ( cadastros e funcionalidades ) somente para ECF ( contempla a Apuração de IRPJ/CSLL );
- menu Menu Completo: Contempla todas as opções, cadastros e funcionalidades do produto.
Image Removed
Image Added
Clique em Avançar.
Neste momento serão feitos alguns teste e ajustes de ambiente. Caso seja identificada alguma falha, podem ocorrer as mensagem a seguir:
- Não foi possível criar o arquivo AppServer.ini. Verifique suas permissões de gravação em disco.
  Ocorre quando o usuário que executou o instalador do TAF não possui acesso de criação e/ou edição de file system no sistema operacional.
- Não foi possível criar o arquivo SmartClient.ini. Verifique suas permissões de gravação em disco.
  Ocorre quando o usuário que executou o instalador do TAF não possui acesso de criação e/ou edição de file system no sistema operacional.
Ao concluir a instalação, serão gerados atalhos na área de trabalho do sistema operacional. Dê duplo clique no atalho Taf_Client para acesso ao TOTVS Automação Fiscal. Você será direcionado à tela de login. Neste momento voc^se será direcionado a um assistente com funcionalidades específicas do produto. Acesse Wizard de Configuração do TAF - TAFLoad - TAF - P12 para concluir o processo de instalação.

Card

default	true
id	4
label	Instalação TSS

Instalação do TSS

Após a conclusão da instalação e configuração do TAF, caso seja solicitado também a instalação do TSS, outro instalador será apresentado para concluir de forma completa. Para mais detalhes da instalação do TSS acessar Clique aqui para verificar a documentação de instalação do TSS.

Possível inconsistência na instalação do TSS: TAF0107_Instalação_TSS_Erro_Java

Importante

Quanto ao primeiro acesso, verificar as considerações do ultimo folder desta documentação!

Instalação TSS

Após concluir o processo de Instalação do TAF, caso tenha selecionado o tipo de instalação Completa, será aberto um assistente de Instalação do TSS. Consulte Instalação - TSS e obtenha mais informações.

Card

default	true
id	5
label	Aplicação de PacotesAtualizações (Atalho TAF_ATUALIZADOR)

Aplicação de Pacotes e Atualizações de Dicionário de Dados (Atalho TAF_Atualizador)

A instalação do TOTVS Automação Fiscal possui uma aplicação auxiliar de aplicação de pacotes e atualização de dicionário de dados para facilitar a atualização do sistema. Ao concluir a Instalação, o atalho TAF_Patch Atualizador será gerado na área de trabalho do sistema operacional. Utilize-o para acesso ao assistente de aplicação de pacotesatualizações.

Image Removed

Image Added

Informar o ambiente: Informe o ambiente do sistema que será utilizado para aplicação do pacote.
Informe o caminho do patch: Informe, através da consulta aos diretórios do sistema operacional, a localização do arquivo de atualização ( *.ptm ).

Image Removed

Informar o usuário e senha do administrador do sistema

Image Added

Aviso

title	ATENÇÃO!

Caso algum serviço esteja consumindo o repositório de objetos onde o pacote será aplicado, será apresentada a mensagem abaixo. Neste caso, será necessário cancelar o processo de atualização e reiniciar o respectivo serviço. Exemplo: TAF-WS.

Depois de reiniciar o serviço, basta acessar o Atualizador novamente e seguir com o processo de atualização.

Image Added

Selecionar a pasta onde o arquivo .zip baixado do portal foi descompactado para selecionar o pacote correto de atualização. O arquivo a ser selecionado deve ter a nomenclatura final "_TTTP120.PTM"

Image Added

Após alguns instantes, a patch será analisada e será mostrado um resumo dos fontes constantes.

Image Added

Informe o caminho do arquivo diferencial do dicionário de dados.
Informe o caminho do arquivo de help diferencial.

Image Added

Image Added

Image Added

Após clicar no botão "Finalizar", caso tenha optador por atualizar o dicionário de dados, será aberta a wizard de execução do UPDTAF;

O procedimento de utilização do UPDTAF pode ser encontrado no link a seguir: UPDTAFImage Removed

Card

default	true
id	6
label	Atalhos Criados

Serviços e atalhos criados

Taf-Appserver: Serviço da plataforma TOTVS|AppServer. Para mais informações acesse

Taf-DbAccess32 ou Taf-DbAccessDbAccess64 : Serviço da plataforma TOTVS|DbAccess. Para mais informações acesse

Taf-Patch: Serviço responsável pela aplicação de patchs e atualizações. Para mais informações acesse

Taf-WS: Serviço responsável pela execução do Webservice de integração do TAF - REST. Para mais informações acesse

Taf_Client: Atalho de acesso ao TOTVS Automação Fiscal.

Taf_Light: Atalho de acesso ao TOTVS Automação Fiscal Light.

Taf_AtualizadorPatch: Atalho de acesso ao sistema de aplicação de pacotes.

Card

default	true
id	78
label	DesinstalaçãoPrimeiro acesso

Desinstalação

Junto com a instalação do TAF é gerado um arquivo de desinstalação do produto, que elimina os arquivos instalados no sistema operacional.

Dê duplo clique mo arquivo unins000.exe localizado na pasta onde a instalação foi realizada:

Image Removed

Primeiro Acesso

Ao concluir a instalação, serão gerados atalhos na área de trabalho do sistema operacional. Dê duplo clique no atalho Taf_Client para acesso ao TOTVS Automação Fiscal.

Você será direcionado à tela de login e na sequencia a de seleção de empresa (que neste primeiro momento é uma de teste); ao confirmar as informações, será executado o assistente do TAF, que para maiores detalhes acesse: Wizard de Configuração do TAF - TAFLoad - TAF - P12

Aviso

title	Tratamento específico para eSocial e EFD Reinf

Após o passo anterior, é necessário se efetuar configurações especificas das transmissões eletrônicas; mais detalhes no link Wizard de Configuração TSS - TAFAWizD - TAF - P12

Possíveis inconsistências do primeiro acesso:

Federal ID não encontrado...

A chave EnableNumber deve estar configurada...

Inconsistência no ambiente - Não foi possível comunicar com o servidor de licenças...

TAF0112_Não foi possível estabelecer conexão com TOTVS Application Server

TAF0113_Serviço do TAF não pode ser iniciado

Avisos Importantes

Aviso

title	Importante

Este passo demonstra o uso do instalador TAF em um ambiente onde ele estará segregado ao ERP; este documento não se aplica especificamente quando o ERP for Protheus e ele estiver injetado como um módulo, não necessitando de uma instalação, somente uma atualização de release.

Aviso

title	Importante

Mensagem de inconsistência:

Image Added

Esta mensagem de inconsistência pode ocorrer por 2 motivos:

Após a instalação

O dicionário de dados (sxbra.txt) que está embarcado no instalador, é o último dicionário de dados completo disponibilizado pela TOTVS, sendo assim, não consta as novas alterações que foram feitas desde a data de expedição em 12/07/2017.

Portanto após a instalação, para que as novas funcionalidades estejam disponíveis, será necessário aplicar o pacote de atualizações (sdfbra.txt) que foi disponibilizado no Portal da TOTVS. Mais informações sobre a atualização acesse Atualização do ambiente - Versão 12

Ao aplicar SOMENTE o pacote de fontes (.ptm).

Caso tenha aplicado somente o pacote de fontes (.ptm), no primeiro acesso ao TAF, será apresentada a mensagem acima. Neste caso a orientação também é para que seja aplicado o pacote de atualizações de dicionário de dados(sdfbra.txt), tanto 12.1.16 quanto 12.1.17. Mais informações sobre a atualização acesse Atualização do ambiente - Versão 12

Árvore de páginas

Versões comparadas

Versão antiga 22

Nova versão Atual

Chave

Manual de Instalação

Pré-Requisitos

Banco de dados

Conexão ODBC

Servidor de Licenças

Download

Processo de Instalação

Instalação TSS

Aplicação de Pacotes e Atualizações de Dicionário de Dados (Atalho TAF_Atualizador)

Serviços e atalhos criados

Desinstalação

Primeiro Acesso

Avisos Importantes

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 22

Nova versão Atual

Chave

Manual de Instalação

Pré-Requisitos

Banco de dados

Conexão ODBC

Servidor de Licenças

Download

Processo de Instalação

Instalação TSS

Aplicação de Pacotes e Atualizações de Dicionário de Dados (Atalho TAF_Atualizador)

Serviços e atalhos criados

Desinstalação

Primeiro Acesso

Avisos Importantes