procedimentos para instalação da nf-e

1

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


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;


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).


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


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


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


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


Página 8

Instalando o Glassfish Copie o arquivo de instalação do Glassfish para a pasta Java (Tela 7).

Tela 7


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


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).


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


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


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


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


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


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;


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.


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).


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.


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


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


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).


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


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


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


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


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


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.


Página 29

Tela 38


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).


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:


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


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; };


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 ( ).


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;


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;


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).


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).


Página 39

Tela 49

Adicione um novo JMS Destination Resources, clicando em (Novo) (Tela 50). Tela 50


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).


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).


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).


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


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.

procedimentos para instalação da nf-e

Documents