Mudanças entre as edições de "Instalação do Totall Nfe"
(→Totall Nfe GX) |
(→Resumo para Instalação) |
||
| Linha 1: | Linha 1: | ||
== Resumo para Instalação == | == Resumo para Instalação == | ||
| − | Roteiro para realizar uma instalação nova (em um cliente que não tem instalado ainda) do Totall NF-e. | + | 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 === | === Totall Nfe GX === | ||
Edição das 14h52min de 2 de junho de 2014
Índice
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.
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.
Resumo para Atualização
Totall Nfe GX
Totall Nfe
Totall Launcher
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.
