Instalação do Totall Nfe
Índice
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.
Instalação do Java
Caso o Java não esteja instalado faça a instalação a partir do site www.java.com.
Para certificar-se de que o java está instalado configura se existe a pasta java nos arquivos de programa
O sistema funciona com a versão 1.6.
Importante:
ÿ necessário que o Java seja 32 bits.
Ou seja, em máquinas que são 64 bits ele precisa estar instalado em /Program Files (x86)/.
Instalação do Apache
ÿ necessário instalar e configurar o Apache Tomcat para ele rodar como um serviço na porta 8082.
No site tomcat.apache.org procure na última versão disponível pelo arquivo que seja Windows Service Installer.
O sistema está homologado para funcionar com a versão 7.0.27 até 7.0.29
Instalação
1. Apontar para um Java que seja 32 bits.
2. Escolher porta "8082" ao invés de "8080".
3. Customizar a instalação para que seja Service e Native.
Configurações
1. Incluir os seguintes jars no lib do Apache.
- jna.jar
- log4j-1.2.15.jar
- TotallMD5.jar
- TotallNatives.jar
- TotallUtil.jar
- TotallUtilGX.jar
- xpp3-1.1.4c.jar
\\ttadm\Compilacoes\Commerce\Liberados\Java\TotallNfeGX\libs_apache\
2. Incluir as DLLs TTSEGUR.dll e libeay32.dll também no diretório /lib/ do apache para que TotallNatives.jar funcione.
\\ttadm\Compilacoes\DLL\Liberados\TTSEGUR\V4\TTSEGUR.dll
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.