Académique Documents
Professionnel Documents
Culture Documents
GUIA DE IMPLANTAO
Sumrio
1. 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
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
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
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
Pg.: 3 de 64 www.inventti.com.br
1. Apresentao
O 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.
Pg.: 4 de 64 www.inventti.com.br
2. Infra-estrutura da aplicao
2.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
SEFAZ
NFe a autorizar / NFe autorizada
Impresso Remota
Sistema Corporativo
Servidor NFePACK
Faturamento
Recebimento
Fiscal
2.2.
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.
Pg.: 5 de 64 www.inventti.com.br
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.
Pg.: 6 de 64 www.inventti.com.br
3.1.
Requisitos de Hardware
Caractersticas 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*
*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.
Pg.: 7 de 64 www.inventti.com.br
3.2.
Requisitos de software
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
Pg.: 8 de 64 www.inventti.com.br
3.3.
Pg.: 9 de 64 www.inventti.com.br
Caso sua empresa no esteja habilitada, entre em contato com o suporte tcnico Inventti atravs do fone (47) 3035-3086 ou e-mail suporte@inventti.com.br 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.
Pg.: 10 de 64 www.inventti.com.br
5.1.
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.
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.
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. .
Pg.: 12 de 64 www.inventti.com.br
5.2.
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.
Pg.: 13 de 64 www.inventti.com.br
5.3.
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
Pg.: 14 de 64 www.inventti.com.br
6.1.
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:
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.
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.
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.
Pg.: 17 de 64 www.inventti.com.br
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).
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
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
Pg.: 19 de 64 www.inventti.com.br
7.1.3
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
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).
7.1.4
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.
Pg.: 21 de 64 www.inventti.com.br
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.
Selecione a opo databases; clique com o boto direito e selecione a opo Novo Database, conforme 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
Pg.: 22 de 64 www.inventti.com.br
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.
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.
Pg.: 24 de 64 www.inventti.com.br
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.
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.
Pg.: 25 de 64 www.inventti.com.br
Pg.: 26 de 64 www.inventti.com.br
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:
Aps colar o script na janela de execuo, selecione a opo Execute script (Figura 22 -
Pg.: 27 de 64 www.inventti.com.br
de script MySQL
Aps estes procedimento a base de dados MySQL estar pronta para uso.
Pg.: 28 de 64 www.inventti.com.br
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.
Pg.: 29 de 64 www.inventti.com.br
Pg.: 30 de 64 www.inventti.com.br
9. Certificado digital
Cada 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
9.1.
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.
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)
4. Ser exibida a lista de Snap-ins. Selecione certificados e em seguida selecione adicionar (Figura 28 - Adio de certificado)
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.
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:
6. Na pasta Pessoal clique com o boto direito do mouse, aps no item Todas as tarefas e no item Importar.
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.
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.
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
Pg.: 34 de 64 www.inventti.com.br
Pg.: 35 de 64 www.inventti.com.br
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).
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).
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
Pg.: 38 de 64 www.inventti.com.br
11.
Configuraes do sistema
Pg.: 39 de 64 www.inventti.com.br
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.
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:
<?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <section name="hibernate-configuration" type="NHibernate.Cfg.ConfigurationSectionHandler, NHibernate" /> <section name="log4net" type="System.Configuration.IgnoreSectionHandler" /> </configSections> <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2"> <session-factory> <property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property> <property name="dialect">NHibernate.Dialect.Oracle9Dialect</property> <property name="connection.driver_class">NHibernate.Driver.OracleDataClientDriver</property> <property name="connection.connection_string">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;</property> <property name="connection.isolation">ReadCommitted</property> <property name="query.substitutions">true 1, false 0, yes 'Y', no 'N'</property> <property name="show_sql">false</property> <property name="max_fetch_depth">1</property> <mapping assembly="NfePackDataAccess" /> </session-factory> </hibernate-configuration> <log4net>
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)
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2"> <session-factory> <property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property> <property name="dialect">NHibernate.Dialect.Oracle9Dialect</property> <property name="connection.driver_class">NHibernate.Driver.OracleDataClientDriver</property> <property name="connection.connection_string">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;</property> <property name="connection.isolation">ReadCommitted</property> <property name="query.substitutions">true 1, false 0, yes 'Y', no 'N'</property> <property name="show_sql">false</property> <property name="max_fetch_depth">1</property> <mapping assembly="NfePackDataAccess" /> </session-factory> </hibernate-configuration>
SQLServer
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" > <session-factory> <property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property> <property name="dialect">NHibernate.Dialect.MsSql2005Dialect</property> <property name="connection.driver_class">NHibernate.Driver.SqlClientDriver</property> <property name="connection.connection_string">Server=(local);Initial Catalog=dbname;User Id=user;Password=********</property> <mapping assembly="NfePackDataAccess"/> </session-factory> </hibernate-configuration>
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
<runtime> <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> <qualifyAssembly partialName="FirebirdSql.Data.FirebirdClient" fullName="FirebirdSql.Data.FirebirdClient, Version=2.0.1.0, Culture=neutral, PublicKeyToken=3750abcc3150b00c" /> </assemblyBinding> </runtime>
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" > <session-factory name="NHibernate.Test"> <property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property> <property name="connection.driver_class">NHibernate.Driver.FirebirdClientDriver</property> <property name="connection.isolation">ReadCommitted</property> <property name="connection.connection_string"> Server=localhost; Database=C:\nhibernate.fdb; User=SYSDBA;Password=masterkey; SQLDialect=1 </property> <property name="show_sql">false</property> <property name="dialect">NHibernate.Dialect.FirebirdDialect</property> <property name="use_outer_join">true</property> <property name="command_timeout">444</property> <property name="query.substitutions">true 1, false 0, yes 1, no 0</property> <mapping assembly="NfePackDataAccess"/> </session-factory> </hibernate-configuration>
MySQL
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" >
<session-factory name="NHibernate.Test"> <property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property> <property name="connection.driver_class">NHibernate.Driver.MySqlDataDriver</property> <property name="connection.connection_string"> Database=test;Data Source=someip;User Id=blah;Password=blah </property> <property name="dialect">NHibernate.Dialect.MySQLDialect</property> </session-factory> </hibernate-configuration>
PostGre
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" >
<session-factory name="NHibernate.Test"> <property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property> <property name="connection.driver_class">NHibernate.Driver.NpgsqlDriver</property> <property name="connection.connection_string"> Server=localhost;initial catalog=nhibernate;User ID=nhibernate;Password=********; </property> <property name="dialect">NHibernate.Dialect.PostgreSQLDialect</property> </session-factory> </hibernate-configuration>
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
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" > configuration <session-factory factory> <property name name="dialect">NHibernate.Dialect.Oracle9Dialect</property> ... </session-factory factory> </hibernate-configuration configuration>
Oracle 8
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" > configuration <session-factory factory> <property name name="dialect">NHibernate.Dialect.OracleDialect</ </property> ... </session-factory factory> </hibernate-configuration configuration>
Pg.: 43 de 64 www.inventti.com.br
Pg.: 44 de 64 www.inventti.com.br
* a base utilizada acima trata do banco Oracle; deve se ajustar os scripts de acordo com a base deve-se de dados do cliente.
O comando de grant de acesso ao certificado detalhado neste tpico trata exclusivamente do Windows XP. Consulte o suporte tcnico Inventti em Consulte www.inventti.com.br (opo atendimento on-line ou central de line relacionamento), ou atravs do fone 47 47-3035-3086, para esclarecimentos ref. , privilgios de acesso em outras verses de Windows. Maiores detalhes tambm podem ser obtidos no tpico 13.5 deste manual
Pg.: 45 de 64 www.inventti.com.br
Copie o valor disponvel no campo Subject (Figura 41 - Identificador do certificado digital para NFePACK). Este valor ser utilizado posteriormente nas configuraes do NFePACK.
Acesse o NFePACKWebMonitor via internet Explorer ( http://localhost/NfePackMonitor) e informe o usurio nfepackadm senha nfepackadm
Pg.: 46 de 64 www.inventti.com.br
Aps entrar no sistema, selecione a opo configuraes (Figura 43 - Mdulo de configuraes do NFePACK):
Na pasta configuraes, guia Filiais informe o CNPJ, Razo social, UF e demais dados da , filial e nos campos de identificao de certificados (Certificado ass. Digital e certificado (Certificado HTTPS), cole o valor copiado do aplicativo de identificao de certificados, conforme a Figura piado 44 - Associao de certificado certificado. Informe para a filial em questo todos os demais parmetros necessrios para a configurao. No guia do monitor Web, so detalhados todos os parmetros necessrios para a configurao de uma filial no sistema. Este guia est disponvel no diretrio ...v_3.0....\4.Documentao 4.Documentao\4.GuiaMonitorWEB do diretrio da verso do NFePACK.
Pg.: 47 de 64 www.inventti.com.br
Pg.: 48 de 64 www.inventti.com.br
Recomenda-se que o template utilize um nome diferente de se DanfePadraoRetrato pois em novas instalaes os arquivos Retrato, DanfePadraoRe Retrato.xml e DanfePadraoRetrato.PDF so substitudos. .PDF Maiores detalhes relativos configurao do DANFe podem ser encontrado no encontrados guia de configurao do DANFe, que est disponvel no diretrio de documentao do sistema: ...\v_3......\4.Documentao 4.Documentao\3.GuiaConfiguraoDANFe Para alteraes mais complexas, 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.
Pg.: 49 de 64 www.inventti.com.br
12.
Atualizao de verso
Sempre que uma nova verso do sistema NFePack estiver disponvel para atualizao, o responsvel pela implantao ser avisado pela Inventti. Para garantir que a atualizao de verso transcorra corretamente, deve-se seguir uma lista de procedimentos, a fim de garantir a correta atualizao.
12.1. NfePackInstaller
Sempre que a Inventti disponibilizar uma nova atualizao do NFePack, esta ficar disponvel na central de relacionamento Inventti (Mysuite). O arquivo disponibilizado compactado e em formato .zip. Quando este arquivo for descompactado, ser apresentada uma estrutura conforme a figura abaixo.
O aplicativo para atualizao do NFePack, encontra-se na pasta 8.Atualizador com o nome de NFePackInstaller.exe. O NFePackInstaller responsvel por atualizar os servios do NFePack (NFePackService, NFePackIntegrator e NFePackPrintService), bem como o MonitorWeb. Este aplicativo tambm responsvel pelo backup da verso anterior (aplicativos, arquivos de configurao e danfe). Quando a atualizao concluda os servios so automaticamente iniciados pelo atualizador.
Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior Pg.: 50 de 64 www.inventti.com.br
Pg.: 51 de 64 www.inventti.com.br
Guia de implantao - NFePACK Quando o NFePackInstaller for executado, a tela de apresentao ser apresentada (Figura 51 Tela de apresentao do NFePackInstaller).
Ao clicar em NEXT o NfePackInstaller solicita qual o tipo de operao dever ser executada: instalao ou atualizao. A opo de Atualizar dever ser selecionada conforme figura abaixo.
A prxima tela do atualizador lista todos os aplicativos do NFePack instalados, ou seja, caso um aplicativo do NFePack no esteja listado, este no est instalado (Figura 53 Aplicativos
Pg.: 52 de 64 www.inventti.com.br
Guia de implantao - NFePACK instalados na mquina). Os aplicativos a serem atualizados devero ser selecionados. A Inventti se encarrega de informar quais aplicativos devem ser atualizados a cada nova verso.
Aps a seleo dos aplicativos a serem atualizados, o boto NEXT dever ser pressionado. Na tela seguinte ser apresentado o andamento da atualizao dos aplicativos (Figura 54 Andamento da atualizao).
Ser marcado como Concludo cada etapa da atualizao realizada com sucesso. Caso ocorra algum problema em uma das etapas de atualizao, esta etapa ser marcada como No Concludo, e a mensagem Ocorreu um erro ao realizar o processo de atualizao dos aplicativos ser exibida (Figura 56 Erro ao realizar o processo de atualizao dos aplicativos).
Guia de implantao - NFePACK_v18.docx Verses suportadas: NFePACK 3.1.2.0 ou superior Pg.: 53 de 64 www.inventti.com.br
Guia de implantao - NFePACK Ao concluir a etapa Finalizando, o sistema exibir a tela de concluso do processo de atualizao. Nesta tela possvel visualizar um relatrio, atravs do link Exibir relatrio onde visualizado o resultado do processo de atualizao do NfePack (Figura 57 Atualizao executada com sucesso).
Pg.: 54 de 64 www.inventti.com.br
Pg.: 55 de 64 www.inventti.com.br
13.
Problemas/Solues
Este captulo lista os erros mais comuns identificados durante a implantao do sistema, descrevendo as possveis solues para estes erros. Inclui-se como responsabilidade da equipe de implantao, a constante atualizao deste captulo do manual, incluindo novas experincias ocorridas durante o processo de implantao.
Permitir Autenticao do Windows integrada; Reiniciar o IIS com o comando no prompt do DOS: iisreset restart;
Pg.: 56 de 64 www.inventti.com.br
Para solucionar este problema, siga os procedimentos abaixo: Obter a atualizao do Windows Installer no computador (http://www.microsoft.com/downloads/details.aspx?displaylang=ptbr&FamilyID=889482fc-5f56-4a38-b838-de776fd4138c) Execut-la e depois executar a atualizao do .NET (NetFx20SP1_x86.exe), que j consta na pasta de instalao do sistema.
Pg.: 57 de 64 www.inventti.com.br
Na instalao do NfePackWebMonitor, ser apresentada mensagem de erro, caso no for detectado o Internet Information Service 4.0 ou superior no servidor (ilustrado a seguir).
Ainda durante a instalao NfePackWebMonitor, poder ser apresentada a mensagem de erro ilustrada a seguir, caso o IIS est instalado mas no est habilitado o suporte ao ASP.NET. Veja a seo sobre a instalao do Internet Information Service.
Pg.: 58 de 64 www.inventti.com.br
Caso o Windows seja diferente do Windows XP, necessrio instalar o programa (winhttpcertcfg.msi) que encontra-se no diretrio de aplicativos (pasta 3.CertificadoDigital) Depois de instalado o aplicativo, siga os seguintes passos: 1. Identifique o usurio gerenciador do IIS; a. No Windows Vista, opo executar, informe o comando control userpasswords2, conforme a Figura 60 - Controle avanado de contas de usurio
b. Selecione a pasta avanado e em seguida o boto avanado conforme a Figura 61 - Gerenciamento de contas de usurio
Pg.: 59 de 64 www.inventti.com.br
Guia de implantao - NFePACK c. Localize o nome do usurio ou grupo do IIS (Descrio Grupo interno usado pelos Servios de Informaes da Internet). No exemplo da Figura 62 Identificao do usurio do IIS, o grupo a ser identificado IIS_IUSRS.
2. V no prompt de comando e localize o executvel da aplicao que foi instalada (geralmente fica em C:\Arquivos de programas\Windows Resource Kits\Tools). Execute o winhttpcertcfg com os seguintes parmetros: winhttpcertcfg -g -c LOCAL_MACHINE\My -s CERTIFICADO -a USURIO Onde, CERTIFICADO = Nome do certificado do cliente, no precisa ser o nome completo, por exemplo, pode ser somente XPTO no caso do certificado da empresa XPTO, USURIO = Usurio gerenciador do IIS.
Pg.: 60 de 64 www.inventti.com.br
Figura 63 - Configurao de diretrio de integrao em servidor com sistema operacional diferente de Windows
Pg.: 61 de 64 www.inventti.com.br
Instalao padro no servidor NFePACK. Instalao apenas do mdulo NFePACKPrintService no servidor de impresso
Pg.: 62 de 64 www.inventti.com.br
Figura 66 - Impresso remota sem mdulos do NFePACK no servidor de impresso / impressora de rede
Instalao padro no servidor NFePACK. Configurao de conta de usurio no servio NFePACKPrintService, para acesso aos recursos da rede
No caso de tratamento de impresso especial (Figura 66 - Impresso remota sem mdulos do NFePACK no servidor de impresso / impressora de rede), entre no Gerenciador de Servios do Windows (Iniciar Executar: services.msc). Localize o servio NfePackPrintService, clique com o boto direito e depois em propriedades;
Na guia Logon, altere a opo Fazer logon como para Esta conta. Deve ser configurada uma conta de usurio que tenha acesso aos recursos do computador (neste caso, impressoras). Para localizar o usurio utilize a opo Procurar... (informe os campos Esta conta, Senha e Confirmar senha).
Pg.: 63 de 64 www.inventti.com.br
Importante: sempre que houver mudana de senha do usurio informado, a : senha dever ser atualizada no servio tambm. Caso necessrio, pode definir uma conta no Windows exclusiva para esta pode-se operao
Pg.: 64 de 64 www.inventti.com.br