Instalação do Totall Nfe

Resumo para Instalação

Roteiro para realizar uma instalação nova (em um cliente que não tem instalado ainda) do Totall NF-e. A instalação completa requer instalação do TotallNFeGX, TotallNFe e TotallLauncher.

Totall Nfe GX

É um sistema web responsável por atualizar as chaves de acesso e a situação das NF-es no Totall Commerce.

1. Validar pré-requisitos.

• Java 32 bits
• Apache >= 7.0.39
• Apache usando porta 8082.
• SQL Server do Emite NF-e está com a porta 1433 ativada.

2. Baixar arquivos atuais no cliente.

• libs_apache.zip
• TotallNfeGX.zip
• GXServerConfig.zip

3. Parar Apache.

Como administrador, executar net stop tomcat7 ou acessar via services.msc

4. Atualizar os arquivos da pasta lib do Apache com o conteúdo da pasta "libs_apache.zip".

C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\lib

5. Inicializar Apache.

Como administrador, executar net start tomcat7 ou acessar via services.msc

6. Conferir se ele está funcionando.

http://localhost:8082/

7. Extrair a pasta TotallNfeGX que está dentro do zip do TotallNfeGX em um diretório temporário.

c:\temp\TotallNfeGX.zip\TotallNfeGX -> c:\temp\TotallNfeGX

8. Configurar o client.cfg com GXServerConfig.

c:\temp\TotallNfeGX\WEB-INF\classes\client.cfg

9. Implantar TotallNfeGX no Apache.

Copiar c:\temp\TotallNfeGX para C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\webapps\

10. Configurar TotallNfeGX.

Acessar http://localhost:8082/TotallNfeGX/servlet/home

Configurar sistema em Configurações

11. Testar funcionamento do TotallNfeGX.

Acessar http://localhost:8082/TotallNfeGX/servlet/home

Executar Atualiza Status

Deve retornar OK

Totall Nfe

É um serviço do windows responsável por manter limpa a pasta de integração com o Emite NF-e [TD_FIL.PATNFE].

1. Baixar pacote de instalação no cliente.

• TotallNfe22R11.zip

2. Extrair conteúdo do arquivo para c:\.

Para que fique c:\TotallNfe\*.*

3. Configurar caminho do Java no setEnv.

Editar propriedade "java_exe" do C:\TotallNfe\servico\bat\setenv.bat

4. Executar instalação do serviço.

Executar C:\TotallNfe\servico\bat\installService.bat

5. Inicializar serviço.

Executar C:\TotallNfe\servico\bat\startService.bat

6. Verificar pelo arquivo de log está funcionando corretamente.

Verificar se na pasta C:\TotallNfe\logs existe um arquivo indicando que o monitoramento do diretório foi inicializado.

Totall Launcher

É um sistema web de agendamentos responsável por executar a rotina de atualização de chaves de acesso do Totall NFe GX a cada minuto.

1. Baixar arquivos atuais no cliente.

• TotallLauncher.zip

2. Descompactar conteúdo da pasta no temp.

3. Copiar ttlauncher.properties para a pasta conf do Apache.

Copiar c:\temp\ttlauncher.properties para C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\conf

4. Implantar TotallLauncher no Apache.

Copiar pasta c:\temp\TotallLauncher para C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\webapps

5. Verificar se processo de atualização de status está ativo.

http://localhost:8082/TotallLauncher

Resumo para Atualização

Roteiro para atualizar Totall NF-e em um cliente. A instalação completa requer instalação do TotallNFeGX, TotallNFe e TotallLauncher. Se o cliente estiver com uma versão muito antiga do pacote TotallNFe, talvez seja mais seguro desinstalar tudo e fazer uma instalação nova.

Totall Nfe GX

É um sistema web responsável por atualizar as chaves de acesso e a situação das NF-es no Totall Commerce.

1. Validar pré-requisitos.

• Java 32 bits
• Apache >= 7.0.39
• Apache usando porta 8082.
• SQL Server do Emite NF-e está com a porta 1433 ativada.

2. Baixar arquivos atuais no cliente.

• libs_apache.zip
• TotallNfeGX.zip

3. Parar Apache.

Como administrador, executar net stop tomcat7 ou acessar via services.msc

4. Fazer backup do client.cfg e ttlauncher.properties.

Arquivos estão em:

- C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\webapps\TotallNfeGX\WEB-INF\classes\client.cfg

- C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\conf\ttlauncher.properties

5. Remover aplicativos anteriores.

Apagar pasta TotallNfeGX e arquivo TotallNfeGX.war (se houver)

Apagar pasta TotallLauncher e arquivo TotallLauncher.war (se houver)

Apagar pastas TotallNfeGX e TotallLauncher na pasta C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\work\Catalina\localhost

6. Remover arquivos de log.

Apagar todos os arquivos da pasta C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\logs

7. Remover arquivos de log.

Apagar todos os arquivos da pasta C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\temp

8. Atualizar os arquivos da pasta lib do Apache com o conteúdo da pasta "libs_apache.zip".

C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\lib

9. Inicializar Apache.

Como administrador, executar net start tomcat7 ou acessar via services.msc

6. Conferir se ele está funcionando.

http://localhost:8082/

7. Extrair a pasta TotallNfeGX que está dentro do zip do TotallNfeGX em um diretório temporário.

c:\temp\TotallNfeGX.zip\TotallNfeGX -> c:\temp\TotallNfeGX

8. Copiar o backup do client.cfg para dentro da pasta TotallNfeGX.

c:\temp\TotallNfeGX\WEB-INF\classes\client.cfg

9. Implantar TotallNfeGX no Apache.

Copiar c:\temp\TotallNfeGX para C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\webapps\

10. Configurar TotallNfeGX.

Acessar http://localhost:8082/TotallNfeGX/servlet/home

Configurar sistema em Configurações

11. Testar funcionamento do TotallNfeGX.

Acessar http://localhost:8082/TotallNfeGX/servlet/home

Executar Atualiza Status

Deve retornar OK

Totall Nfe

É um serviço do windows responsável por manter limpa a pasta de integração com o Emite NF-e [TD_FIL.PATNFE].

1. Baixar pacote de instalação no cliente.

• TotallNfe22R11.zip

2. Extrair conteúdo do arquivo para uma pasta temporária.

c:\temp\TotallNfe\

3. Parar serviço.

Executar C:\TotallNfe\servico\bat\stopService.bat

4. Apagar arquivos de log.

Apagar todo conteúdo da pasta C:\TotallNfe\logs.

5. Atualizar jar e lib.

Copiar c:\temp\TotallNfe\TotallNfeApp.jar para c:\TotallNfe\

Copiar c:\temp\TotallNfe\lib\*.jar para c:\TotallNfe\lib\

6. Inicializar serviço.

Executar C:\TotallNfe\servico\bat\startService.bat

7. Verificar pelo arquivo de log está funcionando corretamente.

Verificar se na pasta C:\TotallNfe\logs existe um arquivo indicando que o monitoramento do diretório foi inicializado.

Totall Launcher

É um sistema web de agendamentos responsável por executar a rotina de atualização de chaves de acesso do Totall NFe GX a cada minuto.

1. Baixar arquivos atuais no cliente.

• TotallLauncher.zip

2. Descompactar conteúdo da pasta no temp.

3. Copiar ttlauncher.properties do backup para pasta conf do Apache.

Copiar c:\temp\ttlauncher.properties para C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\conf

4. Implantar TotallLauncher no Apache.

Copiar pasta c:\temp\TotallLauncher para C:\Program Files (x86)\Apache Software Foundation\Tomcat 7.0\webapps

5. Verificar se processo de atualização de status está ativo.

http://localhost:8082/TotallLauncher

Pré-requisitos

Nesta seção do artigo estão relatadas algumas verificações necessárias para instalar o processo TotallNfe com segurança.
Verifique também a tabela de compatibilidade de versões.

Configurações do Apache Tomcat

Devemos utilizar um Tomcat atualizado e java 32 bits.
Marcar opção para acesso nativo na instalação do Apache.
Incluir os jars e DLLs que estão "libs_apache" na pasta lib do apache.

Mais detalhes, veja no artigo de Instalação e Configuração do Apache Tomcat.

Configurações do SQL Express

É necessário verificar se a conexão via TCP/IP está configurada corretamente para permitir que o TotallNfeGX conecte-se remotamente no SQLExpress onde se encontra o banco do EmiteNfe.

Instalação

Para facilitar o entendimento deste tutorial vamos definir as seguintes constantes, levando em conta a hipótese do Java e do Apache terem sidos instalados em Arquivos de Programas:

TOTALLNFE_HOME = C:\TotallNfe
JAVA_HOME = C:\Arquivos de programas\Java\jre6\
TOMCAT_HOME = C:\Arquivos de programas\Apache Software Foundation\Tomcat 7.0\

Download

Baixar o pacote completo do site da TOTALL e descompacte-o no c:\.

www.totall.com.br » Downloads » TOTALLNFE

Resultado no cliente

O resultado é ter a seguinte estrutura de diretórios e arquivos no TOTALLNFE_HOME do cliente:

GXServerConfig\
lib\
logs\
servico\
TotallNfeApp.jar
TotallNfeGX.war
TotallNfeGX

Implantação do Servidor

Alteração do Usuário e Senha - client.cfg

Abra o arquivo TOTALLNFE_HOME/GXServerConfig/config.bat com o bloco de notas e edite o caminho em que se encontra o Java. Salve e execute o arquivo. O programa GeneXus Application Client Configuration será executado. Nele navegue pelas seguintes opções:
» Guia Namespaces
 » Com default marcado aperte em Edit
  » Guia Data Store Information
   » Com DEFAULT marcado aperte em Edit

Das seguintes configurações escolha a que convir:

PostgreSQL

DBMS = PostgreSQL
JDBC Driver = org.postgresql.Driver
JDBC URL = jdbc:postgresql://<servidor>:<porta>/<database>
      Ex.: jdbc:postgresql://TTDB:5432/totall
Database user = <usuário>
Password = ******
Isolation level = Read Commited
Transaction integrity = True
Database Schema = 
Maximum cursors = 100

Oracle com SID

DBMS = Oracle
JDBC Driver = oracle.jdbc.driver.OracleDriver
JDBC URL = jdbc:oracle:thin:@<servidor>:<porta>:<sid>
      Ex.: jdbc:oracle:thin:@TTDB:1521:ttdb
Database user = <usuário>
Password = ******
Isolation level = Read Commited
Transaction integrity = True
Database Schema = 
Maximum cursors = 100

Oracle com Nome do Serviço

DBMS = Oracle
JDBC Driver = oracle.jdbc.driver.OracleDriver
JDBC URL = jdbc:oracle:thin:@<servidor>:<porta>/<nome do serviço>
      Ex.: jdbc:oracle:thin:@TTDB:1521/ttdb
Database user = <usuário>
Password = ******
Isolation level = Read Commited
Transaction integrity = True
Database Schema = 
Maximum cursors = 100

   » Aperte Ok
   » Com DFE marcado aperte em Edit

É necessário configurar acesso ao banco de dados da DF-e:

SQL Server

DBMS = SQL Server
JDBC Driver = net.sourceforge.jtds.jdbc.Driver
JDBC URL = jdbc:jtds:sqlserver://<servidor>:<porta>/<database>
      Ex.: jdbc:jtds:sqlserver://127.0.0.1:1433/emitenfe
Database user = emitenfe
Password = emitenfe
Isolation level = Read Commited
Transaction integrity = True
Database Schema = 
Maximum cursors = 100

  » Ok
 » Save e Exit.

Este processo atualizará o arquivo client.cfg que está na mesma pasta.

É muito importante validar a conexão depois de configurar o namespace para ter certeza de que está correta.

Implantando o Arquivo .war

Renomeie o arquivo TotallNfeGX.war para TotallNfeGX.zip.
Descompacte o arquivo.
Copie o arquivo client.cfg preparado anteriormente para a pasta /WEB-INF/classes/.
Compacte a estrutura de pastas novamente para o arquivo TotallNfeGX.zip (não pode ser .rar ou qualquer outra extensão) e depois renomeie a extensão para .war.
A estrutura de diretórios dentro do arquivo .war deve ficar exatamente igual a que era antes.

Pare o Apache.
Copie o arquivo TotallNfeGX.war para a pasta TOMCAT_HOME/webapps.
Copie os arquivos que estão em TOTALLNFE_HOME/lib para TOMCAT_HOME/lib.
Inicie o Apache.

Acessando Servidor

Para certificar-se de que a implantação foi um sucesso acesse a página:
http://localhost:8082/TotallNfeGX/servlet/home

Configurações

Para que a atualização de status de nf-e funcione é necessário confirmar a configuração da tela de configurações para que o sistema gere o arquivo TotallNfeConfig.xml na pasta da aplicação.

Implantação do Launcher

É necessário implantar o Totall Launcher e configurar para que ele execute a página aatualizastatusnfes.

http://localhost:8082/TotallNfeGX/servlet/aatualizastatusnfes

É recomendável que esse processo seja configurado da seguinte forma:

servicos1=http://localhost:8082/TotallNfeGX/servlet/aatualizastatusnfes
espera1=1000
intervalo1=60000
ativo1=1

A numeração ao lado de cada propriedade deve ser única para cada serviço

Instalação do Serviço Local

Abra o arquivo TOTALLNFE_HOME/servico/bat/setenv.bat com o bloco de notas e edite o caminho em que se encontra o Java.
O Java está definido na linha que começa com "set java_exe=".

Execute o arquivo installService.bat para instalar o serviço chamado TotallNfe no Windows.
Execute o arquivo startService.bat para iniciar o serviço.

Pronto! Para certificar-se de que o serviço foi iniciado com sucesso deverá aparecer um arquivo de log em TOTALLNFE_HOME/logs e nele deve apenas constar que o serviço foi iniciado.

Caso seja necessário os arquivos stopService.bat e uninstallService.bat podem ser utilizados para parar e desinstalar o serviço respectivamente.

Atualização do Totall Nfe

A atualização é praticamente uma reinstalação.
1. Verificar os pré-requisitos deste artigo.
2. Verificar se o Launcher está devidamente instalado e funcionando.
3. Parar serviço TotallNfe.
4. Atualizar arquivos do serviço local.
5. Atualizar .war no Apache.
6. Iniciar serviço TotallNfe.

Incluindo o client.cfg no .war em um Servidor já Instalado

Copie o arquivo TotallNfeGX.war que está em TOMCAT_HOME/webapps para o TOTALLNFE_HOME.
Copie o arquivo client.cfg da pasta TOMCAT_HOME/webapps/TotallNfeGX/WEB-INF/classes/ para a pasta TOTALLNFE_HOME/GXServerConfig/.

Com a cópia do arquivo faça:
Renomeie o arquivo TotallNfeGX.war para TotallNfeGX.zip.
Descompacte o arquivo.
Copie o arquivo client.cfg preparado anteriormente para a a pasta WEB-INF/classes/.
Compacte a estrutura de pastas novamente para o arquivo TotallNfeGX.war.
A estrutura de diretórios dentro do arquivo .war deve ficar exatamente igual a que era antes.

Pare o Apache.
Copie o arquivo TOTALLNFE_HOME/TotallNfeGX.war para a pasta TOMCAT_HOME/webapps.
Inicie o Apache.

É necessário configurar o namespace DFE também.
Verifique antes de substituir o client.cfg se o anterior já possui configuração desse namespace.