Procedimentos para Instalação da NF-e
-
Upload
adelino-gomes-vieira-junior -
Category
Documents
-
view
592 -
download
26
Transcript of Procedimentos para Instalação da NF-e
1
Procedimentos para instalação da solução Mastersaf NF-e
Procedimentos para instalação da solução Mastersaf NF-e
Índice 1. Procedimentos internos TI ............................................................................ 2
Sinopse ................................................................................................................. 2 Revisão ................................................................................................................. 2 Conteúdo ............................................................................................................. 2 Informações sobre o projeto ...................................................................... 3 Instalação do JDK 1.6 ................................................................................ 4 Instalando o Glassfish ................................................................................ 8 Configurando o Glassfish ........................................................................... 14 Configuração com banco de dados SQL 2000 ou 2005 ............................. 18 Configuração com banco de dados Oracle ................................................ 21 JDBC Resources ......................................................................................... 25 Configurando o e-mail ............................................................................... 26 Configurações de segurança e autenticação de usuários .......................... 29 Configuração de autenticação de usuários ................................................ 30
2. JMS Resources ..................................................................................................... 33
Connection Factories .................................................................................. 33 Destination Resources ................................................................................ 36 Deploy do aplicativo ................................................................................... 41 Acessando a aplicação Mastersaf NF-e ..................................................... 42
Procedimentos para instalação da solução Mastersaf NF-e
Página 2
1. Procedimentos internos TI
Sinopse Objetivo: Estabelecer um padrão para instalação e configuração do Mastersaf NF-e, ro-
dando com Glassfish v2.0. É de extrema importância o envolvimento das áreas técnicas
para a atualização constante desse material. O público-alvo deste documento abrange:
Audiência Propósito
Equipe de desenvolvimento Atualização da aplicação
Gerências operacionais, Coordenação e
Helpdesk
Suporte técnico, Administração do
Mastersaf Nf-e e Implantações
Revisão O Quadro a seguir lista as revisões realizadas neste documento. Isso é utilizado para si-
nalizar cada alteração que o documento venha a sofrer em cada republicação do mesmo.
Data Auto Modificação realizada
10/07/2008 Mastersaf Desenvolvimento do manual V. 0.1.0
Conteúdo
Instalação do JDK 1.6;
Instalação do Glassfish;
Configurando o Glassfish;
Configuração com banco de dados SQL 2000 ou 2005;
Configuração com banco de dados Oracle;
Procedimentos para instalação da solução Mastersaf NF-e
Página 3
JDBC Resources;
Configurando o e-mail;
Configurações de segurança e autenticação de usuários;
JMS Resources – Connection Factories;
JMS Resources – Destination Resources;
Deploy do aplicativo;
Acessando a aplicação Mastersaf NF-e.
Informações sobre o projeto
Informações sobre o projeto
Código do projeto -
Nome do projeto Instalação do Mastersaf NF-e
Área de negócio Nota Fiscal Eletrônica (NF-e)
Status Ativo
Categoria Ferramentas e versões
Sistema operacional Windows 2000, XP Professional e
Windows 2003
SGBD SQL Server 2000, SQL Server 2005 e Oracle
Web Server Glassfish versão 2.0
Sistema de Application Server Mastersaf NF-e
Outras ferramentas
SGBD: Sistema Gerenciador de Banco de Dados; SQL: Structured Query Language (linguagem de con-sulta estruturada).
Procedimentos para instalação da solução Mastersaf NF-e
Página 4
Todo o processo de instalação deve ser realizado por um usuário administrador do
computador.
Caso seja necessário alterar a unidade de instalação do Mastersaf NF-e, basta alterar
o caminho da variável JAVA_HOME e as respectivas configurações do Glassfish
que fazem referência às pastas da instalação.
É importante verificar se a porta usada pela instância está em uso. Se houver ne-
cessidade de mudar a porta da instância, deve-se editar o arquivo Domain.xml
(Glassfish/domain/domain1/config).
Não esquecer que o serviço do Glassfish deve ser reiniciado para que as alterações
feitas na configuração do Servidor de aplicação entrem em vigor.
A versão do JDK deve ser a partir da 1.6. Caso seja instalada uma versão anterior do
JDK, haverá incompatibilidade na instalação do Glassfish.
Instalação do JDK 1.6
Antes de instalar o Java Development Kit versão 1.6 (JDK 1.6) deve ser criada uma es-
trutura de pastas da instalação: \Mastersaf\Java (Tela 1).
Tela 1 – Estrutura de pastas
Procedimentos para instalação da solução Mastersaf NF-e
Página 5
Após criar as pastas para instalação, execute o arquivo jdk-6u4-windows-i586-p.exe re-
ferente ao sistema operacional em uso (Tela 2).
Tela 2
Direcione a instalação do JDK 1.6 para a pasta JAVA recém-criada (Tela 2).
Tela 2
Procedimentos para instalação da solução Mastersaf NF-e
Página 6
A seguir, faça o mesmo para a instalação do Java Runtime Environment (JRE).
Tela 3
Após a instalação do JDK devem ser criadas as variáveis do sistema. Acesse Proprieda-
des do Sistema Avançado Variáveis do Sistema (Tela 4).
Tela 4
Procedimentos para instalação da solução Mastersaf NF-e
Página 7
No próximo passo deve ser criada a variável JAVA_HOME, contendo como valor o
caminho da instalação do JDK 1.6 (Tela 5).
Tela 5
Se o sistema operacional estiver numa linguagem que não seja o português (BR), tam-
bém se deve criar a variável LANG. O valor da variável será pt_BR.ISO-8859-1 (Tela 6).
Tela 6
Procedimentos para instalação da solução Mastersaf NF-e
Página 8
Instalando o Glassfish Copie o arquivo de instalação do Glassfish para a pasta Java (Tela 7).
Tela 7
Procedimentos para instalação da solução Mastersaf NF-e
Página 9
Em seguida, abra o MS-DOS, acesse a pasta Java, e digite o seguinte comando (Tela 8):
Java –Xmx256m –jar [nome do arquivo de instalação].
Por exemplo: Java –Xmx256m –jar glassfish-installer–v2ur2–b04–windows–ml.jar_
Tela 8
Na sequência surgirá uma tela de contrato. Clique em (Aceito) para descompac-
tar o Glassfish (Tela 9).
Tela 9
Procedimentos para instalação da solução Mastersaf NF-e
Página 10
Após a anuência, ao clicar em (Aceito), iniciará o processo de descompactação (Tela 10). Tela 10
Finalizada a descompactação, acesse a pasta glassfish\lib\ant\bin (Tela 11).
Procedimentos para instalação da solução Mastersaf NF-e
Página 11
Tela 11
Execute o comando Ant –f [caminho da pasta Glassfish]/setup.xml (por exemplo:
Ant –f F:\Mastersaf\Java\Glassfish\setup.xml) (Tela 12).
Tela 12
Com o fim da instalação será exibida a mensagem BUILD SUCCESSFUL (Tela 13).
Tela 13
Procedimentos para instalação da solução Mastersaf NF-e
Página 12
O passo seguinte é copiar o arquivo de autenticação de usuário (JdbcAuthModule.jar)
para a pasta Mastersaf\Java\Glassfish\Lib\Addons
Tela 14
Procedimentos para instalação da solução Mastersaf NF-e
Página 13
Em seguida, após o cumprimento dessas etapas, deve-se copiar o driver do respectivo
banco para a pasta Mastersaf\Java\Glassfish\domains\domain1\lib\ext (Tela 15).
Tela 15
Nesse ponto já é possível reiniciar (restart) o serviço do Glassfish. Portanto, acesse a
pasta Mastersaf\Java\glassfish\bin e use o comando asadmin.bat start–domain (Tela 16).
Tela 16
Procedimentos para instalação da solução Mastersaf NF-e
Página 14
Configurando o Glassfish Acesse o servidor da aplicação por meio do link http://localhost:4848/login.jsf (Tela 17).
Para acessar, utilize:
Usuário (User name): admin.
Senha (Password): adminadmin.
Tela 17
Procedimentos para instalação da solução Mastersaf NF-e
Página 15
Em seguida acesse Application Server JVM Settings Path Settings (Tela 18). Tela 18
Coloque o caminho do arquivo JdbcAuthModule.jar no campo Classpath Suffix (Tela 19).
Por exemplo: F:\Mastersaf\Java\glassfish\lib\addons\JdbcAuthModule.jar.
Tela 19
Procedimentos para instalação da solução Mastersaf NF-e
Página 16
Em seguida, clique em (Salvar) no canto superior direito da tela (Tela 20). Tela 20
Acesse a guia Add JVM Option e adicione as seguintes opções (Tela 21): -XX:MaxPermSize=512m;
Procedimentos para instalação da solução Mastersaf NF-e
Página 17
-Xms128m;
-Dsun.jnu.encoding=ISO-8859-1;
-Xss1M;
-Xrs;
-Duser.timezone=America/Sao_Paulo;
-Duser.language=pt;
-Duser.country=BR.
Altere a opção –Xmx conforme abaixo:
-Xmx1g;
Caso seja utilizado proxy, adicione as opções a seguir: -Dhttp.proxyHost=<Servidor>;
-Dhttp.proxyPort=<Porta>;
-Dhttps.proxyHost=<Servidor>;
-Dhttps.proxyPort=<Porta>.
Caso exista, apagar a opção abaixo:
-Djava.security.manager.
Procedimentos para instalação da solução Mastersaf NF-e
Página 18
Tela 21
Depois de adicionada às opções da guia JVM, clique em (Salvar) no canto supe-
rior direito da tela.
Configuração com banco de dados SQL 2000 ou 2005
Para criar a conexão com o banco de dados, acesse Resources JDBC Connection
Pools (Tela 22).
Procedimentos para instalação da solução Mastersaf NF-e
Página 19
Tela 22
Clique em (Novo) e preencha os campos (Tela 23): Name: NFE;
Resource Type: javax.sql.ConnectionPoolDataSource;
Database Vendor: Microsoft SQL Server.
Clique em (Seguinte) no canto superior direito da tela.
Procedimentos para instalação da solução Mastersaf NF-e
Página 20
Tela 23
Na tela que aparecerá em seguida, preencha o campo Datasource ClassName com o va-
lor: com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource (Tela 24).
Tela 24
Procedimentos para instalação da solução Mastersaf NF-e
Página 21
O passo seguinte será habilitar os campos Enabled ( ), clicando nessa opção em Allow
Non Component Callers e Required na opção “Connection Validation”, (Tela 25)
Tela 25
Em propriedades do Connection Pool serão usadas as seguintes (Tela 26): databaseName: Nome da base de dados;
password: Senha do usuário para conexão do SQL Server;
portNumber: Porta do SQL Server;
serverName: Nome do servidor;
user: Usuário para conexão do SQL Server.
Tela 26
Por fim, clique em (Terminar) para concluir a configuração do Connection Pool.
Para verificar se a conexão com o banco de dados está funcionando, acesse o Connection
Pool NFE e clique no botão Ping (Tela 27).
Tela 27
Procedimentos para instalação da solução Mastersaf NF-e
Página 22
Configuração com banco de dados Oracle Para criar a conexão com o banco de dados, acesse Resources JDBC Connection
Pools (Tela 28).
Procedimentos para instalação da solução Mastersaf NF-e
Página 23
Tela 28
Clique em (Novo) e preencha os campos (Tela 29):
Name: NFE;
Resource Type: javax.sql.ConnectionPoolDataSource;
Database Vendor: Oracle.
A seguir, clique em (Seguinte) no canto superior direito da tela.
Tela 29
Procedimentos para instalação da solução Mastersaf NF-e
Página 24
Na próxima tela o Datasource Classname deverá conter o seguinte valor:
oracle.jdbc.pool.OracleConnectionPoolDataSource (Tela 30).
Tela 30
A seguir, clique no campo Enabled ( ) na opção Allow Non Component Callers (Tela 31). Tela 31
Procedimentos para instalação da solução Mastersaf NF-e
Página 25
Em propriedades do Connection Pool serão adotadas as seguintes (Tela 32):
URL: jdbc:oracle:thin:@[IP_SERVIDOR]:[PORTA_ORACLE]:[NOME_TNS];
Password: Senha do banco;
User: Usuário do banco;
Tela 32
Finalmente, clique em (Terminar) para concluir a configuração do Connection Pool. Para verificar se a conexão com o banco de dados está funcionando, acesse o Connection Pool NFE e clique no botão Ping (Tela 33). Tela 33
Procedimentos para instalação da solução Mastersaf NF-e
Página 26
JDBC Resources No console de administração do servidor Glassfish acesse Resources JDBC JDBC
Resources e, em seguida, adicione um novo JDBC Resource, clicando em (Novo)
(Tela 34).
Tela 34
Procedimentos para instalação da solução Mastersaf NF-e
Página 27
Preencha os campos: JNDI Name: jdbc/nfe;
Pool Name: NFE;
Status: Enable.
A seguir, clique em no canto superior direito da tela (Tela 35). Tela 35
A próxima tela exibirá a nova JDBC Resource adicionada (Tela 36). Tela 36
Configurando o e-mail No console de administração do servidor Glassfish acesse esse o caminho Resources
JavaMail Sessions, e clique em (Novo) (Tela 37).
Tela 37
Procedimentos para instalação da solução Mastersaf NF-e
Página 28
Em seguida, os campos devem ser preenchidos com (Tela 38): JNDI Name: mail/NFE;
Mail Host: Informe o servidor SMTP;
Default User: Informe uma conta de e-mail padrão;
Default Return Address: Informe uma conta de e-mail padrão para retorno;
Status: Clicar no campo Enabled ( ).
Adicione as propriedades listadas a seguir, mas não se esquecer do prefixo “mail-” (Tela 38 B): mail-smtp.port: Informe a porta do servidor SMTP(padrão = 25);
mail-smtp.auth: Informe se o servidor utiliza autenticação (true ou false);
mail-smtp.user: Informe o usuário da autenticação do SMTP;
mail-smtp.pass: Informe a senha da autenticação do SMTP.
Para finalizar, clique em no canto superior direito da tela.
Procedimentos para instalação da solução Mastersaf NF-e
Página 29
Tela 38
Procedimentos para instalação da solução Mastersaf NF-e
Página 30
Tela 38 B
Configurações de segurança e autenticação de usuários Acesse no console de configuração do Glassfish o seguinte caminho: Configuration Security (Tela 39). Tela 39
Selecione a opção Default Principal To Role Mapping e clique em (Salvar) no canto direito superior da tela (Tela 40).
Procedimentos para instalação da solução Mastersaf NF-e
Página 31
Tela 40
Configuração de autenticação de usuários Para configurar a autenticação de usuários da aplicação, acesse Configuration Security Realms no console do Glassfish (Tela 41). Tela 41
Clique em (Novo) e preencha a opção:
Procedimentos para instalação da solução Mastersaf NF-e
Página 32
○ Name: Digitar JDBC em caixa-alta (letras maiúsculas).
Depois, selecione a opção Class name for the realm you want to create e digite:
org.nbcommunity.glassfish.jdbcAuthModule.JdbcRealm (Tela 42).
Adicione as seguintes propriedades e valores (Tela 42 A): debug = true;
userCredCol = DS_SENHA;
userRoleTable = NFE_GRP_USU;
userTable = NFE_USUARIO;
dataSource = jdbc/nfe;
roleNameCol = ID_GRUPO;
jaas-context = jdbcRealm;
userNameCol = ID_LOGIN.
Tela 42
Tela 42 A
Procedimentos para instalação da solução Mastersaf NF-e
Página 33
A Tela 42 B apresenta o novo usuário configurado adicionado. Por fim, clique em no canto superior direito da tela para finalizar a configuração. Tela 42 B
Edite o arquivo encontrado no seguinte caminho: Mastersaf\Java\glassfish\domains\domain1\config\login.conf Depois substitua a seguinte entrada:
jdbcRealm {
com.sun.enterprise.security.auth.login.JDBCLoginModule required; };
Por:
jdbcRealm { org.nbcommunity.glassfish.jdbcAuthModule.JdbcLoginModule required; };
Procedimentos para instalação da solução Mastersaf NF-e
Página 34
2. JMS Resources
Connection Factories Acesse nas opções de configuração do Glassfish o seguinte caminho: Resources JMS
Resources Connection Factories (Tela 43).
Tela 43
Clique em (Novo) e preencha os campos (Tela 44):
JNDI Name: jms/MDBEnviarEmailFactory;
TYPE: javax.jms.QueueConnectionFactory;
Enabled = Ativo ( ).
Procedimentos para instalação da solução Mastersaf NF-e
Página 35
Tela 44
A seguir, adicione as Propriedades adicionais (Tela 44 A):
ReconnectInterval = 5000;
ReconnectAttempts = 3;
AddressListBehavior = RANDOM;
Password = guest;
AddressListIterations = 3.
ReconnectEnabled = true;
UserName = guest;
Procedimentos para instalação da solução Mastersaf NF-e
Página 36
Tela 44 A
Crie um novo JMS Connection Factory, clicando novamente em na aba Connec-
tion Factories (Tela 45).
Tela 45
Preencha os campos com: JNDI Name: jms/MDBImpressaoFactory;
Procedimentos para instalação da solução Mastersaf NF-e
Página 37
Type: javax.jms.QueueConnectionFactory;
Status = Enabled ( );
Delete as propriedades. Em seguida, clique em no canto superior direito da tela para finalizar (Tela 46). Tela 46
Destination Resources Acesse o seguinte caminho Resources JMS Resources Destination Resources. Em
sequência, adicione um novo JMS Destination Resources, clicando em (Novo)
(Tela 47).
Procedimentos para instalação da solução Mastersaf NF-e
Página 38
Tela 47
Prosseguindo, preencha os campos com (Tela 48): JNDI Name: jms/MDBEnviarEmail; Physical Destination Name: MDBEnviarEmail; Resource Type: javax.jms.Queue; Status = Enabled ( ). Tela 48
Adicione a propriedade adicional: Name: MDBEnviarEmail. Em seguida, remova a
propriedade adicional Description (Tela 49).
Procedimentos para instalação da solução Mastersaf NF-e
Página 39
Tela 49
Adicione um novo JMS Destination Resources, clicando em (Novo) (Tela 50). Tela 50
Procedimentos para instalação da solução Mastersaf NF-e
Página 40
Preencha os campos com (Tela 51): JNDI Name: jms/MDBImpressao;
Physical Destination Name: MDBImpressao;
Resource Type: javax.jms.Queue;
Status = Enabled ( ).
Tela 51
Adicione a propriedade adicional: Name: MDBImpressao. A seguir, clique em no
canto superior direito da tela para finalizar (Tela 52).
Após todas as configurações realizadas neste documento, devemos reiniciar (restart) os
serviços do Glassfish para poder continuar.
Podemos reiniciar os serviços do Glassfish executando dois comandos no MS-DOS.
1. Parando o serviço do Glassfish Acesse a pasta bin da instalação do Glassfish, no caminho Mastersaf\Java\Glassfish\bin,
e execute o comando asadmin stop-domain (Tela 52).
Procedimentos para instalação da solução Mastersaf NF-e
Página 41
Tela 52
2. Iniciando o service do Glassfish Dentro da pasta bin da instalação do Glassfish no caminho Mastersaf\Java\Glassfish\bin (Tela 53).
Procedimentos para instalação da solução Mastersaf NF-e
Página 42
Tela 53
Deploy do aplicativo Acesse novamente o console de administração do Glassfish (http://localhost:4848) e si-
ga o seguinte caminho para fazer o deploy: Applications Enterprise Applications.
A seguir clique em (Tela 54).
Procedimentos para instalação da solução Mastersaf NF-e
Página 43
Tela 54
Em Package file to be uploaded to server, escolha o arquivo nfe.ear e clique em no canto superior direito da tela (Tela 55). Tela 55
Procedimentos para instalação da solução Mastersaf NF-e
Página 44
Acessando a aplicação Mastersaf NF-e Terminado o Deploy, já é possível acessar a aplicação Mastersaf NF-e. Abra um
browser de internet e use o seguinte link para se conectar à aplicação (Tela 56):
HTTP://localhost:8080;
Usuário: admin;
Senha: nfe321.
Tela 56
A senha do usuário de login da aplicação pode ser alterada mediante um update, na ta-
bela NFE_USUARIO, na coluna DS_SENHA.