Instalao TotvsServiceSped

Reviso: 15/06/2012

Instalao TotvsServiceSped

NDICE
Instalao do produto TotvsServiceSped ..............................................................................1 Instalao do TOPConnect ...................................................................................................2 Configurao da conexo com o Banco de Dados..................................................................5 1. SQL Server ............................................................................................................................. 5 2. Informix ................................................................................................................................. 7 3. Oracle .................................................................................................................................. 10 Configurao do TOPConnect ............................................................................................. 11 Configuraes necessrias no servidor Logix....................................................................... 16 Configurao do TOTVSSERVICESPED ................................................................................. 17

Instalao TotvsServiceSped

Instalao do produto TotvsServiceSped

Pr requisitos
Windows Server 2000, Windows Server 2003, Windows Xp. No h necessidade de licenas adicionais, pois a conexo feita diretamente pelo banco de dados No recomendada a instalao no mesmo servidor de banco de dados nem no mesmo servidor do Logix. Lembrando que a utilizao na mesma mquina, pode trazer problemas de performance a todas as aplicaes que utilizam a mesma.

Bancos de Dados Suportados:

MSSQL 2000, 2005 e 2008; Oracle; Postgres; DB2; Informix; Sybase. Obs.: De preferncia o TotvsServiceSped no dever utilizar o mesmo banco de dados do Logix. Qualquer SGBD diferente dos acima mencionados incompatvel com o TotvsServiceSped.

O servidor deve ter acesso liberado para a internet O acesso deve ser full, sem firewall. Este acesso necessrio para o envio e
recebimento das notas e retornos do SEFAZ. No pode ser um ISA Server

Aplicativo JAVA Deve ser um JAVA (JRE ou JDK) 1.6 OU superior;

Utilizar o Java da Sun.

Servidor de e-mail POP/SMTP necessrio que o servidor possua estes protocolos para o envio dos XMLs.
Obs.: No funciona com IMAP. Os produtos mencionados neste documento (exceto Java) devem ser baixados no
portal do cliente/Download (http://suporte.totvs.com/download). Pesquisar pela Linha = Logix, Tipo = Outros e filtrar por nfe.

Instalao TotvsServiceSped

Instalao do TOPConnect
O TOPConnect um aplicativo da TOTVS, responsvel pelo acesso ao Banco de Dados, que utiliza conexo ODBC e suporta drivers para diferentes Bancos de Dados. Abaixo seguem os passos para a instalao e configurao do programa: ATENO: Caso seja instalado o TOPConnect em um computador com o sistema operacional de 64-bits, esse deve ser instalado diretamente no C:\, criando a estrutura C:\TOPConnect. 1) Selecione o idioma desejado

2) Na tela de boas-vindas, selecione avanar

Instalao TotvsServiceSped

3) O programa instalado por padro na pasta "Arquivos de programas"

4) Selecione a pasta que voc deseja salvar o TOPConnect no menu iniciar

Instalao TotvsServiceSped

5) A instalao ser automtica deste ponto em diante at a sua concluso

Depois de sua instalao necessrio iniciar o servio. Para isto, acesse o Painel de Controle > Ferramentas Administrativas > Servios. Em seguida, selecione o servio do TOPConnect, clique sobre o nome do servio e depois no link "iniciar".

O link "Iniciar o servio" ser habilitado, depois de sua habilitao, a instalao do TOPConnect estar concluda.
4

Instalao TotvsServiceSped

Configurao da conexo com o Banco de Dados

1. SQL Server
Abra o Painel de Controle > Ferramentas Administrativas > Fontes de Dados (ODBC). Deve ser adicionado em Fonte de dados de sistema o driver para o Banco de Dados SQL Server Informe as configuraes de acordo com o seu Banco de Dados. Sugerimos que o nome da fonte de dados seja "TotvsSped", sem aspas

Instalao TotvsServiceSped

ATENO: No SQL Server, o usurio que faz a conexo ODBC deve ser o "sa".

Marque a primeira opo e selecione o banco de dados padro que o TotvsSped far a conexo.

Instalao TotvsServiceSped

Finalize a configurao do ODBC

2. Informix
Para que o TOPConnect se comunique com o banco de dados, necessrio que o client do Informix esteja na verso 2.90. Verifique a verso do client Informix, selecionando a ltima aba "About IBM Informix ODBC". Caso a verso seja diferente da 2.90, favor providenciar a verso adequada (IBM Informix ODBC 2.90). O client de conexo do Informix deve ser instalado no diretrio C:\Informix, para isto, deve-se selecionar a opo "Custom" durante a instalao. Lembre-se! O TSS no deve ser instalado no mesmo servidor de banco de dados.

Abra o painel de Controle > Ferramentas Administrativas > Fontes de Dados (ODBC). Deve ser adicionado em Fonte de dados de sistema o driver para o Banco de Dados Informix. Informe as configuraes de acordo com o seu Banco de Dados.

Instalao TotvsServiceSped

Sugerimos que o nome da fonte de dados seja "TotvsSped", sem aspas

Informe os dados de conexo do seu banco

Instalao TotvsServiceSped

Marque a opo "User Server Database Locale"; O Client Locale deve ter o mesmo valor do Database Locale. Em "Cursor Behavior", selecione a opo "1 - Preserve" e o "VMB Character" mantenha "0 - Estimate"; O "Fetch Buffer Size" deve ficar com o valor mximo, 32767.

A opo "Auto Commit Optimization" j vem marcada, deixe-a desta forma; Marcar as opes "Insert Cursors" e "Scrollable Cursors"

Instalao TotvsServiceSped

3. Oracle
No banco de dados Oracle no necessria uma configurao de dados ODBC, basta cadastrar no arquivo de conexes TNSNAMES.ora os dados da conexo com o banco. Obs.: Este arquivo geralmente fica na pasta raiz de instalao do Oracle\network\admin\TNSNAMES.ora. Informe as configuraes de acordo com o seu Banco de Dados.

Basta cadastrar os dados do seu servidor no arquivo mencionado acima. Obs.: Sugerimos que o nome da fonte de dados seja "TotvsSped", sem aspas

10

Instalao TotvsServiceSped

ATENO: No ORACLE tambm devem ser configuradas algumas variveis de ambiente, para garantir a correta conexo do TOPConnect com o banco de dados. Devem-se criar as seguintes variveis de ambiente de SISTEMA:

Varivel: ORACLE_HOME

Varivel: TNSADMIN
Valor: Diretrio onde se encontra o arquivo TNSNAMES.ora

Configurao do TOPConnect
Abra o TOPConnect que foi instalado anteriormente, d um "Ok" na primeira tela para conectar no servio TOPConnect

11

Instalao TotvsServiceSped

Selecione a aba "Configuraes" e nas abas abaixo, a opo correspondente ao seu banco de dados, conforme exemplos abaixo. Clique no boto "Novo", digite o nome do alias criado na conexo ODBC ("TotvsSped", conforme sugerido) e digite o usurio e senha de acesso ao banco.

SQL Server

Informix

12

Instalao TotvsServiceSped

Oracle

Clique em "Salvar" para que as configuraes sejam salvas no arquivo de configurao do TOPConnect. O TotvsServiceSped usar as informaes deste arquivo para conectar no seu banco de dados. ATENO: No banco de dados ORACLE, deve-se selecionar a opo Usar BLOB para campos MEMO, conforme a imagem acima. Esta opo est disponvel apenas quando se configura o banco Oracle. Nas demais, por no ser necessria, esta opo no est disponvel. necessrio apontar no arquivo de configurao do TOPConnect, o caminho aonde se localiza o arquivo OCI.dll O arquivo de configuraes do TOPConnect se chama topconn.ini e fica dentro do diretrio onde o aplicativo foi instalado, por padro, C:\Arquivos de Programas\TOPConnect ou C:\Program Files\TOPConnect (ou C:\TOPConnect caso seja um sistema 64-bits, conforme recomendado acima). Neste arquivo topconn.ini, deve ser adicionado na seo ORACLE a varivel ClientLibrary, apontando para o arquivo OCI.dll, conforme exemplo abaixo: [ORACLE] environments=TotvsSped ClientLibrary=C:\oracle\ora92\bin\OCI.dll (A DLL fica no \bin do diretrio de instalao do Oracle) Em seguida, na aba Assistentes, selecione Validao de Conexo > Avanar, selecione o banco de dados a ser utilizado, informe o nome da fonte de dados que foi criada nas fontes de dados ODBC (como sugerido, "TotvsSped") e clique em
13

Instalao TotvsServiceSped

"Finalizar", dever ser exibida a informao "Conexo Ok". Caso acontea algum erro, verificar os dados de conexo fornecidos. Clique na opo "Validao de Conexo"

Avanar

14

Instalao TotvsServiceSped

Selecione o seu Banco de Dados

Coloque o nome de ambiente que voc configurou anteriormente (como sugerido, "TotvsSped") e clique em "Finalizar"

15

Instalao TotvsServiceSped

Caso esteja tudo certo, a seguinte mensagem ser apresentada.

Se alguma das informaes estiver errada, ser exibida uma mensagem de erro. Significa que existe algum erro de configurao no ODBC ou nos dados informados no TOPConnect.

Configuraes necessrias no servidor Logix

1) Instalar Java 1.5 ou superior (Java da Sun). 2) Baixar bibliotecas .jar necessrias para Nota Fiscal Eletrnica: itext205.jar, jdom1.1.jar e nfeletronica.jar. (portal do cliente/download) Estes 3 arquivos devem ser salvos no servidor aonde est rodando o LOGIX, em um diretrio de sua escolha, e devem ser configurados na varivel de ambiente CLASSPATH conforme exemplo abaixo: No Linux export CLASSPATH=$CLASSPATH:/usr/itext205.jar:/usr/jdom1.1.jar:/usr/nfeletronica.jar No Windows set CLASSPATH=%CLASSPATH%;C:\usr\itext205.jar;C:\usr\jdom1.1.jar;C:\usr\nfeletronica.j ar Outra varivel que deve ser configurada a PROXY_NFE, necessria para comunicao entre o Logix e servidor TSS, conforme abaixo: PROXY_NFE=IP_SERVIDOR_TSS:PORTA (porta configurada no arquivo TotvsAppServer.ini). Ex.: PROXY_NFE=10.10.10.10:8080 Caso o servio esteja rodando na porta padro (80), basta colocar o IP, no sendo necessrio colocar :80. No Windows, esta configurao deve ser feita em todas as mquinas clientes que forem enviar as notas.

16

Instalao TotvsServiceSped

Configurao do TOTVSSERVICESPED
1) Descompacte o arquivo diretamente no C:\, desta forma ser criada a pasta "C:\TotvsSped\"com vrias subpastas. 2) Dentro da subpasta "C:\TotvsSped\AppServer" deve-se editar o arquivo TotvsAppServer.ini com as seguintes configuraes, conforme abaixo. a) Dentro da chave [sped] deve-se alterar os parmetros abaixo: TopDatabase=mssql // Colocar uma das opes abaixo, correspondente ao seu banco de dados (como exemplo, foi usado o do SQL Server): mssql: SQL Server informix: Informix oracle: Oracle TopAlias=TotvsSped // Informar o nome da conexo usada no ODBC, neste caso, se foram seguidas as sugestes, basta deix-la como est, que "TotvsSped" [HTTP] Enable=1 Port=80(*) Path=c:\mp10\Html RpcEnable=1 instances=2,100 SessionTimeout=600 [IP LOCAL] // Alterar para o IP da mquina onde est sendo instalado o TotvsSped ENABLE=1 PATH=C:\mp10\web\ws ENVIRONMENT=SPED INSTANCENAME=ws RESPONSEJOB=JOB_WS DEFAULTPAGE=wsindex.apw Por padro, o TotvsServiceSped utiliza a porta 80 para o servio de comunicao, caso seu servidor j utilize esta porta para outros fins, escolha outra que esteja livre. Esta porta dever ser configurada nas chaves: [localhost] e [IP_DO_SERVIDOR], conforme exemplo abaixo: [localhost:8080] e [10.10.10.10:8080] 3) Depois da configurao do arquivo TotvsAppServer.ini, deve-se iniciar o servidor TSS. Para isto, pode ser criado um atalho no desktop ou instalar como servio.
17

Instalao TotvsServiceSped

Opo 1 Atalho: C:\TotvsSped\AppServer\TotvsAppServer.exe - console Se todos os parmetros do TSS estiverem OK, uma tela, como demonstrado abaixo, ser exibida.

Opo 2 Servio: Deve ser configurada uma chave dentro do arquivo totvsappserver.ini da seguinte maneira: [SERVICE] NAME=TOTVSSERVICESPED DISPLAYNAME= TotvsServiceSped (nome como ser includo na guia services do painel de controle do Windows) No diretrio c:\totvssped\appserver ser gerado um arquivo totvsconsole.log que conter as informaes que seriam demonstradas na tela acima, na opo 1 (atalho). Para testar se os servios esto funcionando corretamente, basta abrir no seu browser o endereo http://localhost ou http://localhost:PORTA, caso tenha alterado para alguma outra porta, diferente da padro (80). Obs.: O servio "Log de Chamada de Servios" sempre desabilitado por padro, no h necessidade de ativ-lo.

18

Instalao TotvsServiceSped

Uma pgina com todos os servios dos webservices ativos ser aberta no navegador. ATENO: Na shell que executa o Logix, adicionar a seguinte linha: "umask 000" (sem aspas), para que ao executar o Logix, as devidas permisses sejam concedidas. Verifique se no h uma verso menor da biblioteca Itext instalada na mquina, se houver recomendvel que seja retirada.

19