Pré-Requisitos

Banco de dados

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

• Plataformas homologadas:
  • 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.

• • • 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 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 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.

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.

duas vezes no arquivo executável do Instalador do TAF (

TAF_INSTALADOR_

12117.exe ):

Image Added

Será aberto um assistente de instalação.

Image Added

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

Image Added

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

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 Added

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

Image Added

Image Added

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

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 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.
  • Para Oracle, este "Nome da conexão" se refere ao SERVICE_NAME informado na parametrização do tnsnames.ora
• 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.
  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 <<aqui>> para mais informações sobre configuração do banco de dados ORACLE ).

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 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:

Image Added

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 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.

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
• 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 Completo: Contempla todas as opções, cadastros e funcionalidades do produto.

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.

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!