Guia Implantação

Embed Size (px)

Citation preview

NFePACK

GUIA DE IMPLANTAO

Guia de implantao - NFePACK

Sumrio1. 2. Apresentao ........................................................................................................................ 4 Infra-estrutura da aplicao .................................................................................................. 5 2.1. 2.2. 3. Infra-estrutura da hardware ......................................................................................... 5 Mdulos da soluo NFePACK ...................................................................................... 5

Caractersticas do ambiente do cliente ................................................................................. 7 3.1. 3.2. 3.3. Requisitos de Hardware ................................................................................................ 7 Requisitos de software .................................................................................................. 8 Premissas para implantao ......................................................................................... 9

4. 5.

Estrutura de diretrios para instalao............................................................................... 10 Preparao do sistema operacional .................................................................................... 11 5.1. 5.2. 5.3. Instalao do servidor WEB (IIS) Windows XP ......................................................... 11 Instalao do DotNet Framework 2.0 Windows XP ................................................. 13 Instalao do ASP.Net no IIS Windows XP ................................................................ 14

6.

Gerenciador de Banco de dados ......................................................................................... 15 6.1. 6.2. 6.3. 6.4. 6.5. Oracle Express (Oracle 10g XE) ................................................................................... 15 SQL-Server Express ...................................................................................................... 16 Firebird ........................................................................................................................ 16 MySQL ......................................................................................................................... 17 PostGreSQL.................................................................................................................. 17

7.

Criao da Estrutura de Dados ............................................................................................ 18 7.1. Oracle .......................................................................................................................... 18 Criao do owner NFEPACK................................................................................. 18 Configurao de permisses (GRANTS) .............................................................. 19 Importao dos objetos de banco de dados para owner NFePACK.................... 20 Configurao de tablespaces para o usurio NFEPACK ...................................... 21

7.1.1 7.1.2 7.1.3 7.1.4 7.2. 7.3. 7.4. 7.5. 8. 9.

SQL Server ................................................................................................................... 22 Firebird ........................................................................................................................ 25 MySQL ......................................................................................................................... 27 PostGre ........................................................................................................................ 29

Cliente do Gerenciador de Banco de dados ........................................................................ 30 Certificado digital ................................................................................................................ 31

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 2 de 64 www.inventti.com.br

Guia de implantao - NFePACK 9.1. 10. Liberao de acesso ao sistema local. ......................................................................... 31 Aplicativos NFePACK ....................................................................................................... 36 Instalao Mdulo NFePackService ........................................................................ 36 Instalao Mdulo NFePackIntegrator.................................................................... 36 Instalao Mdulo NFePackPrintService................................................................. 36 Instalao Mdulo NFePackWebMonitor ............................................................... 37

10.1. 10.2. 10.3. 10.4. 11.

Configuraes do sistema ............................................................................................... 39 Configurao Firewall do Windows......................................................................... 39 Configurao do NFePACK Service e Integrator - acesso a dados .......................... 40 Configurao do NFePACK WEB Monitor Acesso a dados ................................... 44 Configurao do NFePACK WEB Monitor Temas ................................................. 44 Configurao do NFePACK Licena de uso ........................................................... 45 Ajuste da empresa................................................................................................... 45 Configurao do NFePACK Certificado digital / Filiais .......................................... 45 Reinicializao dos servios..................................................................................... 48 Adequao do DANFe ............................................................................................. 49

11.1. 11.2. 11.3. 11.4. 11.5. 11.6. 11.7. 11.8. 11.9. 12.

Atualizao de verso ..................................................................................................... 50 NfePackInstaller ...................................................................................................... 50 Parada dos servios do NFePACK ............................................................................ 51 Ajustes na estrutura de banco de dados ................................................................. 51 Atualizao da verso.............................................................................................. 51 Backup Verso Anterior .......................................................................................... 55 Atualizao do modelo de DANFe ........................................................................... 55 Inicializao dos servios ......................................................................................... 55

12.1. 12.2. 12.3. 12.4. 12.5. 12.6. 12.7. 13.

Problemas/Solues ........................................................................................................ 56 Solicitao de senha ao instalar o IIS ...................................................................... 56 Erro na instalao do Service Pack 1 no .NET Framework 2.0 ................................ 57 Erros na instalao do NfePack ............................................................................... 58 Erros ao Iniciar Servio NfePackService .................................................................. 59 Grants de acesso para certificados (Windows diferente de XP) ............................. 59 Acesso a diretrios UNIX ou LINUX (integrao via arquivo texto) ........................ 61 Instalao Mdulo NFePackPrintService (estao remota) .................................... 62

13.1. 13.2. 13.3. 13.4. 13.5. 13.6. 13.7.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 3 de 64 www.inventti.com.br

Guia de implantao - NFePACK

1. ApresentaoO objetivo deste guia servir de referncia para o processo de implantao da soluo NFePACK em nossos clientes. Trata-se de um guia de referncia rpida para que possamos garantir um alto nvel de satisfao durante e aps a implantao de nossa soluo. responsabilidade de cada implantador, colaborar para que este guia esteja sempre atualizado de modo a garantir a evoluo de nossa soluo e colaborar para a rapidez e eficincia de nossas implantaes. As informaes deste manual referem-se s verses 3.0 e posteriores do NFePACK.

proibida a reproduo deste guia, mesmo parcial, por qualquer processo, sem prvia autorizao da Inventti Solues Empresariais Ltda. Copyright 2009 da Inventti Solues Empresariais Ltda.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 4 de 64 www.inventti.com.br

Guia de implantao - NFePACK

2. Infra-estrutura da aplicao2.1. Infra-estrutura da hardware

A infra-estrutura de hardware composta por servidores de aplicao (tanto a nvel de SEFAZ, quanto a nvel do cliente), servidor(es) de impresso e servidor de banco de dados. A Figura 1 Infra-estrutura de hardware, representa estes componentes:

Internet

SEFAZNFe a autorizar / NFe autorizada

DANFe NF DANFe Autorizao Nfe

Impresso Remota

Sistema Corporativo

Servidor NFePACK

Faturamento

Recebimento

Fiscal

Figura 1 - Infra-estrutura de hardware

2.2.

Mdulos da soluo NFePACK

A soluo NFePACK composta por mdulos que em conjunto com o sistema corporativo (ERP), banco de dados, IIS (Servidor de aplicaes) e WEB-services da Secretaria Estadual da Fazenda atendem os requisitos da Nota Fiscal Eletrnica. A Figura 2 Mdulos da soluo NFePACK, representa esta estrutura em conjunto com os mdulo ERP, Banco de Dados, WEB-Services e IIS (em laranja). Estes mdulos no fazem parte da soluo NFePACK, mas so indispensveis para atender a todos os requisitos de instalao.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 5 de 64 www.inventti.com.br

Guia de implantao - NFePACK

Figura 2 Mdulos da soluo NFePACK

NFePACK Service: ncleo da soluo responsvel por todo controle dos servios de conexo com a secretarias da fazenda, bem como pelos controles da situao das NFes. NFePACK Integrator: responsvel pela integrao com os sistemas corporativos sponsvel NFePACK WebMonitor: responsvel pela parte WEB que disponibiliza as informaes e controla as excees e parametrizao da soluo NFePACK NFePACK PrintService responsvel pela impresso remota do DANFe, garantindo o Service: NFe, mnimo de trfego de rede, atravs da transmisso e controle de arquivos XML compactados O mdulo NFePACKPrintService (cor verde na Figura 2 Mdulos da soluo NFePACK) poder estar instalado tambm no(s) servidor(es) NFePACK) de impresso, dependendo da configurao e infra estrutura de TI do infra-estrutura cliente. Para realizar a integrao entre o sistema corporativo e o NFePACK, pode-se optar pelo uso (ou no) do mdulo de integrao -se (NFePACKIntegrator). Este mdulo utilizado nos casos em que h troca de arquivos texto para a integrao, ou quando so utilizadas as procedures de banco pr definidas (opo de integrao Cliente). A pr-definidas Figura 3 - Mdulos de integrao representa estes mdulos.

Figura 3 - Mdulos de integrao

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 6 de 64 www.inventti.com.br

Guia de implantao - NFePACK

3. Caractersticas do ambiente do clienteCada cliente possui um ambiente de T.I. especfico e geralmente possui bons motivos para tal. Estes motivos podem ser os mais diversos e vo desde custo at caractersticas tcnicas das aplicaes e preferncia pessoal da equipe de T.I. Apesar dessas caractersticas, um conjunto de pr-requisitos deve ser verificado para garantir a estabilidade do ambiente durante a implantao e principalmente: durante a utilizao do sistema em condies reais de uso. Observe os pontos a serem verificados antes de iniciar a instalao do NFePACK. de vital importncia que os requisitos mnimos sejam atendidos para garantir o resultado da implantao e o perfeito funcionamento dos servios.

3.1.

Requisitos de HardwareCaractersticas Servidor para processar o NFePACK , banco de dados de controle (se necessrio) e arquivos XML das NFe enviadas e recebidas. - Pentium 3.0 Ghz - 2 GB RAM - 250 GB HD - Mdia para backup 512 Kb disponvel para a soluo NFe Impressora com velocidade de impresso adequada demanda de emisso de DANFes (levar em conta os horrios de pico para definio do melhor modelo). Verificar nmero de bandejas para documentos auxiliares (caso necessrio)

Requisito Servidor*

Link internet Impressora Laser

*Configurao mnima para o NFePACK, de acordo com as caractersticas do ambiente de TI, pode variar. Esta sugesto trata um volume mdio de 2000 NFe/ms sem picos de faturamento.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 7 de 64 www.inventti.com.br

Guia de implantao - NFePACK

3.2.

Requisitos de software

Requisito Sistema Operacioanal

Caractersticas Windows XP Professional, Service Pack 2 (ou superior) ou Windows 2003 server (ou superior) Internet Information Services (IIS) 4.0 ou superior. Para utilizao do modulo NFePackWebMonitor, dever estar habilitado o servidor IIS, com suporte a pginas ASP.NET (aspx). A porta 80 do servidor WEB deve estar liberada para comunicao

Servidor Web

Certificado Digital Dot NET Framework 2.0 com Service Pack 1 Servidor de Banco de Dados

Certificados digitais ICP-Brasil PJ A1 O sistema utiliza o dot NET Framework 2.0; o mesmo deve estar disponvel no servidor de aplicaes do NFePACK Se compatvel, poder ser utilizado o prprio servidor de banco de dados do sistema ERP. A arquitetura do sistema NFePACK suporta os seguintes bancos de dados: DB2 / DB2 for iSeries (OS/400) Ingres PostgreSQL / PostgreSQL 8.1 / PostgreSQL 8.2 MySQL 3 or 4 / MySQL 5 Oracle (any version) / Oracle 9/10g Sybase Adaptive Server Enterprise Sybase Adaptive Server Anywhere Microsoft SQL Server 2000 / 2005 Everywhere Edition Microsoft SQL Server 7 Firebird SQLite Ingres 3.0

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 8 de 64 www.inventti.com.br

Guia de implantao - NFePACK

3.3.

Premissas para implantaodisponibilidade dos requisitos de hardware e software; certificados digitais tipo A1 disponveis; autorizao para homologao junto SEFAZ / SEFAZ Virtual; equipe usuria disponvel para a gerao de massa de testes e acompanhamento dos processos de homologao e implantao; equipe tcnica do cliente (ou empresa contratada) disponvel para customizaes no ERP e possveis ajustes durante o processo de homologao e emisso simultnea; disponibilizao das informaes de notas fiscais, bem como atualizaes no sistema existente.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 9 de 64 www.inventti.com.br

Guia de implantao - NFePACK

4. Estrutura de diretrios para instalaoPara a instalao da soluo NFePACK, ser disponibilizado um conjunto de diretrios contendo todos aplicativos e configuraes necessrias para a instalao(Figura 5 - Conjunto de aplicativos e Figura 6 - Arquivos NFePACK). Esta estrutura pode ser obtida junto central de relacionamento, opo base de conhecimento no site www.inventti.com.br, conforme a Figura 4 - Acesso a central de relacionamento

Figura 4 - Acesso a central de relacionamento

Caso sua empresa no esteja habilitada, entre em contato com o suporte tcnico Inventti atravs do fone (47) 3035-3086 ou e-mail [email protected] para solicitar seu acesso a esta rea. Sugerimos ter estas estruturas de diretrios e seus respectivos arquivos sempre mo pois ser muito utilizada durante todo processo de instalao.

Figura 5 - Conjunto de aplicativos

Figura 6 - Arquivos NFePACK

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 10 de 64 www.inventti.com.br

Guia de implantao - NFePACK

5. Preparao do sistema operacional istemaEste tpico trata dos procedimentos necessrios para deixar o sistema operacional Windows os apto para executar os servios e o portal do NFePACK. s Cada verso do Windows possui caractersticas especficas para instalao do IIS (Internet Information Service). Este guia detalha a configurao para o Windows XP. Caso seu sistema operacional seja diferente do Windows XP (Windows Vista, Windows 2003 Server ou Windows 2008 Server), consulte o suporte tcnico Inventti em www.inventti.com.br (opo atendimento on-line ou central de line relacionamento), ou atravs do fone 47-3035-3086 para receber as instrues elacionamento), de configurao.

5.1.

Instalao do servidor WEB (IIS) Windows XP

Antes de iniciar a instalao do IIS (Internet Information Service), verifique se o mesmo j est instalado no servidor. Caso j esteja instalado, pule para o pr prximo passo (Instalao do Instalao DotNet Framework 2.0 Windows XP XP) Para verificar se o IIS j est instalado, verifique no aplicativo Gerenciamento do computador instalado, (clique com o boto direito no Meu computador e depois na opo Gerenciar) se h a opo Internet Information Service na categoria Servios e aplicativos conforme ilustrado na Figura 7 - Verificao da instalao do IIS IIS.

Figura 7 - Verificao da instalao do IIS

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 11 de 64 www.inventti.com.br

Guia de implantao - NFePACK Para instalar do ISS no Windows, siga os seguintes passos: Acionar a opo Adicionar/remover componentes do Windows. Painel de controle Adicionar ou remover programas componentes do Windows Adicionar/remover

Selecione a opo Internet Information Services (ISS) da lista apresentada conforme apresentada, apresentado na Figura 8 - Configurao para instalao do IIS.

Figura 8 - Configurao para instalao do IIS

Para instalao do IIS ser necessrio o CD de instalao do Windows.

Para conferir se o ISS foi instalado com sucesso, acess pelo navegador web o endereo acesse http://localhost/. Dever ser apresentada a pgina inicial do ISS, conforme apresentado na . ISS, Figura 9 - pgina inicial do IIS. .

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 12 de 64 www.inventti.com.br

Guia de implantao - NFePACK

Figura 9 - pgina inicial do IIS

5.2.

Instalao do DotNet Framework 2.0 Windows XP

O DotNet Framework 2.0 o conjunto de programas que suporta o portal WEB do NFePACK. Para instal-lo, localize e execute o arquivo de instalao do Dot Net Framework 2.0 e siga os passos padro da instalao. Os arquivos de instalao encontram-se no diretrio Aplicativos, subdiretrio 1.DotNet . Execute os arquivos na seqncia abaixo: dotnetfx.exe (Microsoft Framework dotNet 2.0) NetFx20SP1_x86.exe (Service Pack do Microsoft Framework dotNet 2.0)

Caso o framework j esteja instalado, ou tiver uma verso diferente da recomendada, lembrar que o NFePack est homologado para a verso 2.0. Mesmo que a verso do framework instalado seja mais nova, o indicado remover e instalar a verso recomendada.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 13 de 64 www.inventti.com.br

Guia de implantao - NFePACK

5.3.

Instalao do ASP.Net no IIS Windows XP IIS

Normalmente quando instalamos o framework .NET em uma mquina que j possui o IIS o uma ASP.NET instalado automaticamente. O procedimento padro contempla a instalao do IIS apenas depois do .NET framework framework. Ento eventualmente pode se tornar necessrio instalar o ASP.NET manualmente, solicitando a instalao via prompt. Para isso devemos utilizar um utilitrio que o framework instala na mquina: C:\WINDOWS\Microsoft.NET Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe aspnet_regiis.exe Entre no diretrio e execute a linha de comando: aspnet_regiis i o Observe que o parmetro i deve ser informado.

No Windows XP o ISS possui um limite de 10 conexes. Caso seja necessrio pode se aumentar o limite de conexes atravs dos pode-se comandos abaixo: Cd c:\inetpub inetpub\AdminScripts Cscript adsutil.vbs set w3svc/MaxConnections 40

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 14 de 64 www.inventti.com.br

Guia de implantao - NFePACK

6. Gerenciador de Banco de dadosEste tpico trata da instalao do gerenciador de banco de dados que suportar a aplicao NFePACK. Deve-se preferencialmente utilizar um banco de dados j existente na infra-estrutura do se estrutura cliente. Neste caso, basta incluir os objetos de banco de dados do NFePACK na estrutura de banco de dados existente (o tpico Criao da Estrutura de DadosCriao da Estrutura de Criao Dados, detalha esta situao). Normalmente o gerenciador de banco de dados estar instalado em outro servidor, q no que seja o servidor da aplicao NFePACK. Caso no exista um banco de dados j em uso, deve disponibilizar um gerenciador de banco deve-se de dados. As instalaes destes bancos de dad encontram-se no diretrio A dados se Aplicativos, subdiretrio 2.ServidorBancoD 2.ServidorBancoDados. Abaixo listamos os procedimentos para alguns dos principais bancos de dados do mercado, em pais suas verses de distribuio Freeware. Alguns dos bancos citados, por serem distribuies gratuitas possuem uma limitao de espao de armazenamento. Deve-se atentar para esta limitao em casos de grandes volumes de emisso de se notas. Limitao Oracle XE: 4 GB Limitao SQL Server Express: 2 GB Para outros bancos de dados, consulte o suporte tcnico Inventti em www.inventti.com.br (opo atendimento on-line ou central de line relacionamento), ou atravs do fone 47 47-3035-3086.

6.1.

Oracle Express (Oracle 10g XE)

Executar o arquivo de instalao OracleXE.exe e seguir o procedimento padro da instalao. Siga as configuraes sugeridas pelo instalador. Recomenda-se utilizao da senha es se MANAGER para os usurios SYS/SYSTEM. Sugerimos instalar a ferramenta de acesso de acesso a dados SQL Tools para eventuais consultas base de dados Oracle. Para esta instalao, utilize o arquivo InstallSQLTools.exe arquivo que encontra-se no diretrio 2.ServidorBancoDados se 2.ServidorBancoDados\Oracle. Caso seja necessria a configurao do acesso ao banco de dados em outro computador (que no seja o servidor de aplicaes) siga a configurao a seguir:

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 15 de 64 www.inventti.com.br

Guia de implantao - NFePACK Localize o arquivo C:\oraclexe\app\oracle\product\10.2.0\server\NETWORK\ADMIN\ tnsnames.ora e crie uma nova conexo: Na opo HOST, indique o nome do computador onde est instalado o banco de dados. A Figura 10 - Configurao TNSNAMES.ORA, demonstra um exemplo desta configurao.

Figura 10 - Configurao TNSNAMES.ORA

6.2.

SQL-Server Express

Executar o arquivo de instalao SQLEXPR32.exe, que encontra-se na pasta Aplicativos, subdiretrio 2.ServidorBancoDados\SqlServer e seguir as configuraes padro do instalador. Depois da instalao do SQL-Server Express, recomendvel a instalao de alguma ferramenta para gerenciamento do Banco; sugerimos o SqlServer Management Studio, que encontra-se na pasta Aplicativos, subdiretrio 2.ServidorBancoDados\SqlServer (execute o arquivo SQLServer2005_SSMSEE.msi e siga o procedimento padro de instalao).

6.3.

Firebird

Executar o arquivo de instalao Firebird-2.1.1.1 Win32, que encontra-se na pasta Aplicativos, subdiretrio 2.ServidorBancoDados\Firebird e seguir as configuraes padro do instalador. Deve-se instalar tambm o Data Provider do Firebird; arquivo Firebird Client-2.1.0.msique est localizado no diretrio 2.ServidorBancoDados\Firebird.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 16 de 64 www.inventti.com.br

Guia de implantao - NFePACK Sugerimos que seja instalada tambm o a ferramenta de administrao e acesso ao banco de dados (IB Expert). Execute o arquivo ibep_2.2.0.3_full.exe que est localizado no diretrio 2.ServidorBancoDados\Firebird.

6.4.

MySQL

Executar o arquivo de instalao mysql-essential-5.1.32-win32, que encontra-se na pasta Aplicativos, subdiretrio 2.ServidorBancoDados\MySQL e seguir as configuraes padro do instalador. Deve-se instalar tambm o Data Provider do MySQL; arquivo MySql.Data.dllque est localizado no diretrio 2.ServidorBancoDados\MySQL. Para realizar esta instralao, deve-se copiar o arquivo MySql.Data.dll para o diretrio C:\Windows\System32. Caso ocorram problemas de acesso, como por exemplo, falta de permisso de acesso para este diretrio, deve-se disponibilizar a DLL nos diretrios dos aplicativos do NFePACK: C:\Arquivos de programa\Inventti\NFePACKService C:\Arquivos de programa\Inventti\NFePACKIntegrator C:\Inetpub\wwwroot\NFePACKMonitor

Sugerimos que seja instalada tambm o a ferramenta de administrao e acesso ao banco de dados (MyManager Lite). Para tal, execute o arquivo MyManagerLiteSetup.exe que est localizado no diretrio 2.ServidorBancoDados\MySQL.

6.5.

PostGreSQL

Executar o arquivo de instalao postgresql-8.4.1-1-winows, que se encontra na pasta aplicativos, subdiretrio 2.ServidorBancoDados\Postgre e seguir as configuraes padro do instalador. No necessria a instalao de nenhuma ferramenta para administrao e acesso ao banco de dados, pois o prprio PostGre j possui.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 17 de 64 www.inventti.com.br

Guia de implantao - NFePACK

7. Criao da Estrutura de DadosEste tpico trata da criao da estrutura de dados que o NFePACK necessita para controlar os processo de emisso de NFes. De acordo com o banco de dados disponibilizado para a com aplicao, deve ser disponibilizada a estrutura de dados. Como cada banco de dados possui caractersticas especficas para a criao de objetos, a disponibilizao da estrutura de dados do NFePACK dever respeit as. Portanto, para cada respeit-las. banco de dados h um conjunto de scripts especfico. No diretrio de instalao disponibilizado pelo NFePACK, existem as estruturas de dados para os principais bancos de dados do mercado.

Figura 11 - Localizao dos scripts para criao de objetos em banco de dados izao

7.1.

Oracle

Antes de executar os scripts de criao d objetos do banco de dados Oracle, necessri a dos necessria criao do usurio padro para o NFEPACK conforme tpico a seguir. 7.1.1 Criao do owner NFEPACK A configurao do banco de dados consiste na criao e configurao das permisses do OWNER especfico para o NFePack, e importao das tabelas e dados do NFePack. O ERP do cliente poder estar instalado em qualquer owner, porm para este manual, vamos considerar o owner ERP como sendo a localizao do sistema corporativo do cliente.

Para criao do OWNER, entre na administrao do banco de dados. No Oracle 10g XE pode pode-se utilizar Data Base Home Page cliente do BD disponibilizado via navegador web. Neste manual vamos detalhar os procedimentos considerando o Oracle 10g XE (para outras verses, deve-se verificar os comandos correspondentes que podem ser executados via console do se banco de dados - consulte um DBA para maiores instrues, n neste caso).

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 18 de 64 www.inventti.com.br

Guia de implantao - NFePACK Utilizar a conta system para este acesso (se voc informou a senha sugerida no processo de instalao, ela ser a string manager, caso contrrio utilize a outra senha definida ). Selecione na opo Database Users BD Oracle). Create User (conforme Figura 12 - Criao de usurio no

Figura 12 - Criao de usurio no BD Oracle

Crie um usurio com as seguintes informaes: Username: nfepack Password: nfepack Confirm Password: nfepack 7.1.2 Configurao de permisses (GRANTS)

O OWNER nfepack deve possuir as Roles CONNECT e RESOURCE. A role DBA deve permanecer desmarcada. Deve possuir todos os privilgios clique na opo Check All ao criar o usurio. As configuraes devem ficar conforme a Figura 13 - Privilgios de acesso ao banco de dados Oracle

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 19 de 64 www.inventti.com.br

Guia de implantao - NFePACK

Figura 13 - Privilgios de acesso ao banco de dados Oracle

7.1.3

Importao dos objetos de banco de dados para owner NFePACK

Para importao das tabelas e dados do NFePack, deve-se utilizar o arquivo .DMP fornecido para a instalao do NFePack . Este arquivo encontra-se no subdiretrio 1.ScriptsNfePack/Oracle, da verso correspondente do NFePACK. Atravs da linha de comando do Windows (CMD), localize o diretrio que contm o arquivo EXPDAT.DMP e execute o comando: imp. Depois entre com o login e senha do OWNER NfePack. Obs.: Caso o comando imp no execute, digite antes comando imp o diretrio onde est localizado o banco de dados. Use o comando localizar e procure pelo arquivo imp.exe

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 20 de 64 www.inventti.com.br

Guia de implantao - NFePACK Devem ser deixadas as opes padro do comando IMP, exceto a opo Importar arquivo de exportao inteiro (sim/no) que deve ser alterado para sim. Para selecionar a opo padro, basta pressionar enter.

Aps a importao, deve ser apresentada a mensagem: Importao encerrada com sucesso, sem advertncias. Para verificar a importao das tabelas, pode se utilizar o utilitrio SQL Comandos tao pode-se disponibilizado na prpria instalao do Oracle XE (Database Home Page), utilizando o login e senha do OWNER nfepack (Figura 14 - Acessando os objetos criados no banco de dados Figura dados).

Figura 14 - Acessando os objetos criados no banco de dados

7.1.4

Configurao de tablespaces para o usurio NFEPACK

Garantir que o usurio NFEPACK tenha o grant abaixo (este comando dever ser executado rio com a conta system):GRANT UNLIMITED TABLESPACE TO nfepack;

De acordo com as polticas de cada empresa, pode ser necessria a criao de uma tablespace especfica para os dados e/ou ndices do owner NFE NFEPACK.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 21 de 64 www.inventti.com.br

Guia de implantao - NFePACK

7.2.

SQL Server

A disponibilizao da estrutura de banco de dados SQLServer, baseia-se na criao de uma rea de dados especfica para o NFePACK, o qual ser integrado com a estrutura de dados do ERP. Para esta atividade, abra o gerenciador do banco de dados do SQLServer, conforme Figura 15 Gerenciador do banco de dados SQLServer.

Figura 15 - Gerenciador do banco de dados SQLServer

Selecione a opo databases; clique com o boto direito e selecione a opo Novo Database, conforme Figura 16 - Criando novo banco de dados SQLServer

Figura 16 - Criando novo banco de dados SQLServer

Defina um nome para o banco de dados (sugesto: NFEPACK), conforme Figura 17 - Definio de nome para novo banco de dados SQLServer

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 22 de 64 www.inventti.com.br

Guia de implantao - NFePACK

Figura 17 - Definio de nome para novo banco de dados SQLServer

Aps criado o banco de dados, execute o script para criao de objetos, que encontra-se na pasta 1.ScriptsNfePack\SqlServer. A Figura 18 - Execuo de script de criao de banco de dados ilustra este procedimento. Certifique-se de que os scripts esto sendo executados na pasta correspondente ao novo banco de dados criado.

Figura 18 - Execuo de script de criao de banco de dados

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 23 de 64 www.inventti.com.br

Guia de implantao - NFePACK Para maiores detalhes a respeito da criao da estrutura de dados do NFePACK da para o banco de dados SQL SQL-Server, consulte o suporte tcnico Inventti em www.inventti.com.br (opo atendimento on-line ou central de line relacionamento), ou atravs do fone 47 47-3035-3086.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 24 de 64 www.inventti.com.br

Guia de implantao - NFePACK

7.3.

Firebird

A disponibilizao da estrutura de banco de dados Firebird, baseia-se na criao de uma rea de dados especfica para o NFePACK, o qual ser integrado com a estrutura de dados do ERP.Caso esteja utilizando o IB Expert, v na opo Create Database, e informe se ser um banco local ou remoto, caso seja remoto informe o nome do servidor, e escolha onde o banco dever ser salvo. A figura Figura 19 - Criao de banco de dados Firebird, demonstra as principais configuraes necessrias.

Informar Dialect 3 Informar 8192Figura 19 - Criao de banco de dados Firebird

Em seguida v na opo Sql Editor (F12) e execute o Script .SQL que est na pasta (1.ScriptsNfePack\Firebird) Execute o Scritp com a opo F9, caso no ocorram erros, o banco estar criado e populado com as principais informaes para o funcionamento do NFePack.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 25 de 64 www.inventti.com.br

Guia de implantao - NFePACK

Figura 20 - Script de criao de objetos Firebird

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 26 de 64 www.inventti.com.br

Guia de implantao - NFePACK

7.4.

MySQL

A disponibilizao da estrutura de banco de dados MySQL, baseia-se na criao de uma rea de dados especfica para o NFePACK, o qual ser integrado com a estrutura de dados do ERP.Para instalar o gerenciador de banco de dados MySQL, deve-se executar o arquivo mysqlessential-5.1.32-win32.msi do diretrio Aplicativos\2.ServidorBancoDados\MySql.

Siga as opes padro de instalao ou, se necessrio, informe as opes que melhor atendam o ambiente em que o sistema ser instalado. Atente para que a senha definida para o usurio root esteja em mos para uso futuro. No diretrio de aplicativos tambm est disponvel uma ferramenta de gerenciamento do banco de dados MySQL (para instal-la, basta executar o arquivo MyManagerLiteSetup que est disponvel no diretrio Aplicativos\2.ServidorBancoDados\MySql). Pode-se utilizar qualquer ferramenta compatvel com MySQL.Os procedimentos a seguir utilizaro o aplicativo SQLManager Lite para MySQL. Acesse a ferramenta de gerenciamento de banco de dados e execute o script disponvel na pasta (verso\1.ScriptsNfePack\MySql). Para isso acesse a opo tools e em seguida SQL Script, conforme a Figura 21 - Janela para execuo de scripts para MySQL:

Figura 21 - Janela para execuo de scripts para MySQL

Aps colar o script na janela de execuo, selecione a opo Execute script (Figura 22 -

Execuo de scripts no MySQL)

Figura 22 - Execuo de scripts no MySQL

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 27 de 64 www.inventti.com.br

Guia de implantao - NFePACKInforme o usurio root e sua respectiva senha, conforme Figura 23 - Conexo para execuo

de script MySQL

Figura 23 - Conexo para execuo de script MySQL

Aps estes procedimento a base de dados MySQL estar pronta para uso.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 28 de 64 www.inventti.com.br

Guia de implantao - NFePACK

7.5.

PostGre

A disponibilizao da estrutura de banco de dados Firebird, baseia-se na criao de uma rea de dados especfica para o NFePACK, o qual ser integrado com a estrutura de dados do ERP. Para importao das tabelas e dados do NFePack, deve-se utilizar o arquivo .SQL fornecido para a instalao do NFePack . Este arquivo encontra-se no subdiretrio 1.ScriptsNfePack/PostGre, da verso correspondente do NFePACK. Atravs da linha de comando do Windows (CMD) execute o comando: psql, com as seguintes informaes : psql d Banco de Dados -U usurio do banco f caminho onde se encontra o arquivo expdat.sql Obs.: Caso o comando psql no execute, digite antes o comando psql no diretrio onde est localizado o banco de dados. Use o comando localizar e procure pelo arquivo psql.exe

Quando executado o comando do psql ser solicitada a senha do usurio informado para importar o Banco de Dados.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 29 de 64 www.inventti.com.br

Guia de implantao - NFePACK

8. Cliente do Gerenciador de Banco de dadosCaso o servidor de banco de dados no seja o mesmo do servidor de aplicaes, deve deve-se prever a instalao do cliente do banco de dados no servidor de aplicaes. De acordo com o tipo de estrutura de TI do cliente, ser necessrio acionar um tcnico de rede e/ou um administrador de banco de dados para garantir a cnico instalao destas configuraes. Para certificar-se do melhor procedimento de configurao, consulte o suporte se tcnico Inventti em www.inventti.com.br (opo atendimento on on-line ou central de relacionamento), ou atravs do fone 47 47-3035-3086.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 30 de 64 www.inventti.com.br

Guia de implantao - NFePACK

9. Certificado digitalCada cliente deve adquirir um certificado digital, para realizar a comunicao entre o NfePack e os web services da Secretaria da Fazenda (SEFAZ). Para a instalao deste certificado, siga os passos abaixo: Localize o arquivo do Certificado Digital com extenso de arquivo .pfx. Este arquivo geralmente cedido atravs de um disquete pela empresa que comercializa o certificado (Certisign ou Serasa). Acione o Assistente para importao de certificados com um duplo clique no arquivo .pfx. Siga a instalao padro do assistente (vide Figura 24 - Importao do certificado digital) e quando solicitada, informe a senha disponibilizada com o certificado

Figura 24 - Importao do certificado digital

9.1.

Liberao de acesso ao sistema local.

Para que o NFePack acesse corretamente as informaes do certifica digital importado, o sistema deve ter acesso local para o certificado, abaixo segue os passos para a liberao do acesso. 1. Digite no programa Executar (Tecla Win + R) o comando mmc.

Figura 25 - Acesso ao console de configurao

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 31 de 64 www.inventti.com.br

Guia de implantao - NFePACK 2. Ser exibido o console do sistema operacional (Figura 26 - Console do Windows). No menu Arquivo, selecione a opo Adicionar/Remover Snap-in (CTRL+M)

Figura 26 - Console do Windows

3. Selecione na tela a opo adicionar (Figura 27 - Adicionar/remover snap-in certificado)

Figura 27 - Adicionar/remover snap-in certificado

4. Ser exibida a lista de Snap-ins. Selecione certificados e em seguida selecione adicionar (Figura 28 - Adio de certificado)

Figura 28 - Adio de certificado

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 32 de 64 www.inventti.com.br

Guia de implantao - NFePACK Na prxima tela, selecione a opo conta de computador (Figura 29 - Definio de certificado para conta de computador e em seguida clique no boto Avanar computador) Avanar. Este procedimento muito importante, pois ao selecionar outra opo o certificado no ser visualizado pelo NFePACK.

Figura 29 - Definio de certificado para conta de computador

Na tela seguinte (Selecionar Computador no altere nada e clique no boto Concluir. Selecionar Computador) Na tela Adicionar snap autnomo clique no boto Fechar. snap-in Na tela Adicionar/Remover snap clique no boto OK. snap-in 5. Se tudo foi feito corretamente, o resultado ser semelhante a Figura 30 - Certificado adicionado:

Figura 30 - Certificado adicionado

6. Na pasta Pessoal clique com o boto direito do mouse, aps no item Todas as tarefas e no item Importar.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 33 de 64 www.inventti.com.br

Guia de implantao - NFePACK 7. Aparecer a tela Assistente para importao de Certificados (Figura 31 - Assistente para importao de certificados)clique no boto Avanar.

Figura 31 - Assistente para importao de certificados

8. No boto Procurar selecione o certificado (*.pfx)e clique no boto Avanar. 9. Mantenha as opes padro da prxima tela (Figura 32 - Armazenamento de certificados) e clique em avanar.

Figura 32 - Armazenamento de certificados

10. Selecione a opo Concluir na prxima tela. 11. O resultado dever ser semelhante ao da Figura 33- Certificado disponvel na pasta pessoal 12. Repita o procedimento para outros certificados (caso existam) 13. Aps instalados todos os certificados, clique no menu Arquivo depois em Salvar. Salve o arquivo com qualquer nome de sua preferncia na pasta sugerida

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 34 de 64 www.inventti.com.br

Guia de implantao - NFePACK

Figura 33- Certificado disponvel na pasta pessoal

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 35 de 64 www.inventti.com.br

Guia de implantao - NFePACK

10.

Aplicativos NFePACK

Este tpico trata da instalao e configurao dos aplicativos que compem a soluo NFePACK: NFePackService, NFePackWebMonitor, NFePackIntegrator e NFePACKPrintService. Os arquivos para esta instalao, encontram-se no diretrio 2.Instalao, junto ao conjunto de diretrios de instalao do NFePACK (Figura 34 - Diretrio com os programas de instalao do NFePACK).

Figura 34 - Diretrio com os programas de instalao do NFePACK

10.1. Instalao Mdulo NFePackServiceDeve-se executar o arquivo de instalao NFePackServiceSetup.msi que est no diretrio 2.Instalao\2.1.NFePACKService. Mantenha as opes padro da instalao. Ao finalizar o instalador o mdulo estar disponvel.

10.2. Instalao Mdulo NFePackIntegratorExecutar o arquivo de instalao NFePackIntegratorSetup.msi que est no diretrio 2.Instalao\2.2.NFePACKIntegrator. Mantenha as opes padro da instalao. Ao finalizar o instalador o mdulo estar disponvel.

10.3. Instalao Mdulo NFePackPrintServiceO mdulo NFePACKPrintService gerencia a impresso do DANFe. Sua configurao essencial para que o volume de dados que trafegam na rede seja a mnima possvel.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 36 de 64 www.inventti.com.br

Guia de implantao - NFePACK Para instal-lo, execute o arquivo de instalao NFePackPrintServiceSetup.msi que est no diretrio 2.Instalao\2.3.NFePACKPrintService. Siga as opes padro. Ao concluir o NFePACKPrintService estar instalado. Para configurar as opes de impresso, acesse no menu do Windows Iniciar -> programas -> Inventti -> NFePACKPrint No NFePACKPrint, acesse a opo Servio -> Configuraes e defina a impressora local padro e a impressora local para contingncia (Figura 35 - Configurao de impressoras).

Figura 35 - Configurao de impressoras

10.4. Instalao Mdulo NFePackWebMonitorA instalao do NfePackWebMonitor deve ser executada pelo pacote de instalao: arquivo NfePackWebMonitor.msi, que est no diretrio 2.Instalao\2.4.NFePACKWEBMonitor. Antes da instalao, deve-se verificar se o Internet Information Service (IIS) 4.0 ou superior est instalado no computador com suporte ao ASP.NET. Ser apresentada uma mensagem de erro na instalao, caso estes requisitos de software no forem atendidos. Execute a instalao com as opes padro (Figura 36 - Instalao do NFePACKMonitor)

Figura 36 - Instalao do NFePACKMonitor

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 37 de 64 www.inventti.com.br

Guia de implantao - NFePACK Aps instalao, entre no endereo http://localhost/nfepackmonitor para verificar o funcionamento do sistema. Para a verso 7 do ISS, atent para a opo Application Pool: atente

Eventualmente, pode ser necessrio reiniciar o IIS para o correto funcionamento do Monitor Web. Para isso, entre no utilitrio Gerenciamento do computadordo Windows e reinicie o IIS, conforme ilustrado a seguir: ilustrado

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 38 de 64 www.inventti.com.br

Guia de implantao - NFePACK

11.

Configuraes do sistema

11.1. Configurao Firewall do WindowsEventualmente ser necessrio configurar o Firewall do Windows para permitir o acesso remoto ao servidor web (IIS) de outros computadores. Normalmente o servidor web configurado na porta 80. Esta dever ser liberada no Firewall. Acesse no painel de controle do Windows a opo Firewall do Windows e em seguida selecione a guia Excees:

Figura 37 - Configurao do Firewall

Escolha a opo Adicionar Porta e inclua as informaes conforme a figura abaixo:

Figura 38 - Adicionando porta no firewall

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 39 de 64 www.inventti.com.br

Guia de implantao - NFePACK

11.2. Configurao do NFePACK Service e Integrator - acesso a dadosPor padro o NFePACK instala seus aplicativos no diretrio C: C:\Arquivos de programas\Inventti. Se todos os aplicativos forem instalados, dever existir a estrutura de diretrios conforme a Figura 39 - Diretrios NFePACK retrios

Figura 39 - Diretrios NFePACK

O procedimento que vamos detalhar, dever ser executado para os seguintes aplicativos: NfePackService NfePackIntegrator

Vamos tomar a configurao do aplicativo NFePACKService como modelo para as demais. Dentro de cada pasta de aplicativo h um arquivo com a seguinte nomenclatura: [nome_aplicativo].exe.config por exemplo, para o NFePackService, deve-se editar o arquivo config; se NfePackService.exe.config. Edite o arquivo [nome_aplicativo]. [nome_aplicativo].exe.config com o notepad

Evite utilizar outros editores de texto, pois alguns (como o caso do wordpad) gravam caracteres especiais que comprometem o funcionamento do sistema.

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2 ou superior 2.0

Pg.: 40 de 64 www.inventti.com.br

Guia de implantao - NFePACK Conforme o banco de dados, usurio e senha, deve-se definir a string de conexo neste arquivo de configurao. No arquivo h uma TAG denominada hibernate-configuration, conforme destacado abaixo: NHibernate.Connection.DriverConnectionProvider NHibernate.Dialect.Oracle9Dialect NHibernate.Driver.OracleDataClientDriver Data source=localhost/XE;User Id=nfepack;Password=nfepack;Min Pool Size=2; Connection Lifetime=120; Connection Timeout=60; Incr Pool Size=1; Decr Pool Size=1; ReadCommitted true 1, false 0, yes 'Y', no 'N' false 1

A rea destacada dever ser substituda por um dos textos abaixo, conforme o banco de dados utilizado. Atentar para alterar as informaes em destaque para a configurao da base instalada. Oracle O exemplo abaixo trata da configurao padro (j demonstrada na rea destacada do exemplo acima) NHibernate.Connection.DriverConnectionProvider NHibernate.Dialect.Oracle9Dialect NHibernate.Driver.OracleDataClientDriver Data source=localhost/XE;User Id=nfepack;Password=nfepack;Min Pool Size=2; Connection Lifetime=120; Connection Timeout=60; Incr Pool Size=1; Decr Pool Size=1; ReadCommitted true 1, false 0, yes 'Y', no 'N' false 1

SQLServer NHibernate.Connection.DriverConnectionProvider NHibernate.Dialect.MsSql2005Dialect NHibernate.Driver.SqlClientDriver Server=(local);Initial Catalog=dbname;User Id=user;Password=********

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 41 de 64 www.inventti.com.br

Guia de implantao - NFePACK Firebird Atentar para que a instruo de runtime (abaixo) tambm seja disponibilizada no arquivo, antes da sesso hibernate-configuration. Atentar para que a verso correta do Firebird deve estar configurada neste ponto

NHibernate.Connection.DriverConnectionProvider NHibernate.Driver.FirebirdClientDriver ReadCommitted Server=localhost; Database=C:\nhibernate.fdb; User=SYSDBA;Password=masterkey; SQLDialect=1 false NHibernate.Dialect.FirebirdDialect true 444 true 1, false 0, yes 1, no 0

MySQL

NHibernate.Connection.DriverConnectionProvider NHibernate.Driver.MySqlDataDriver Database=test;Data Source=someip;User Id=blah;Password=blah NHibernate.Dialect.MySQLDialect

PostGre

NHibernate.Connection.DriverConnectionProvider NHibernate.Driver.NpgsqlDriver Server=localhost;initial catalog=nhibernate;User ID=nhibernate;Password=********; NHibernate.Dialect.PostgreSQLDialect

Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior

Pg.: 42 de 64 www.inventti.com.br

Guia de implantao - NFePACK Caso o banco de dados Oracle seja uma verso anterior a verso 9, deve ajustar a opo dialect no arquivo de configuraes, alm do ajuste da conexo ao banco de dados. Oracle 9 ou posterior configuration NHibernate.Dialect.Oracle9Dialect ...

Oracle 8

configuration NHibernate.Dialect.OracleDialect