Instalação do Totall Nfe

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.