Sei sulla pagina 1di 45

1

Procedimentos para instalao da soluo Mastersaf NF-e

Procedimentos para instalao da soluo Mastersaf NF-e

ndice
1. Procedimentos internos TI ............................................................................ 2

Sinopse ................................................................................................................. 2 Reviso ................................................................................................................. 2 Contedo ............................................................................................................. 2 Informaes sobre o projeto ...................................................................... 3 Instalao do JDK 1.6 ................................................................................ 4 Instalando o Glassfish ................................................................................ 8 Configurando o Glassfish ........................................................................... 14 Configurao com banco de dados SQL 2000 ou 2005 ............................. 18 Configurao com banco de dados Oracle ................................................ 21 JDBC Resources ......................................................................................... 25 Configurando o e-mail ............................................................................... 26 Configuraes de segurana e autenticao de usurios .......................... 29 Configurao de autenticao de usurios ................................................ 30
2. JMS Resources .....................................................................................................33

Connection Factories .................................................................................. 33 Destination Resources ................................................................................ 36 Deploy do aplicativo ................................................................................... 41 Acessando a aplicao Mastersaf NF-e ..................................................... 42

Procedimentos para instalao da soluo Mastersaf NF-e

1. Procedimentos internos TI
Sinopse
Objetivo: Estabelecer um padro para instalao e configurao do Mastersaf NF-e, rodando com Glassfish v2.0. de extrema importncia o envolvimento das reas tcnicas para a atualizao constante desse material. O pblico-alvo deste documento abrange: Audincia Equipe de desenvolvimento Gerncias operacionais, Coordenao e Helpdesk Propsito Atualizao da aplicao Suporte tcnico, Administrao do Mastersaf Nf-e e Implantaes

Reviso
O Quadro a seguir lista as revises realizadas neste documento. Isso utilizado para sinalizar cada alterao que o documento venha a sofrer em cada republicao do mesmo. Data 10/07/2008 Auto Mastersaf Modificao realizada Desenvolvimento do manual V. 0.1.0

Contedo
Instalao do JDK 1.6; Instalao do Glassfish; Configurando o Glassfish; Configurao com banco de dados SQL 2000 ou 2005; Configurao com banco de dados Oracle;

Pgina 2

Procedimentos para instalao da soluo Mastersaf NF-e JDBC Resources; Configurando o e-mail; Configuraes de segurana e autenticao de usurios; JMS Resources Connection Factories; JMS Resources Destination Resources; Deploy do aplicativo; Acessando a aplicao Mastersaf NF-e.

Informaes sobre o projeto


Informaes sobre o projeto Cdigo do projeto Nome do projeto rea de negcio Status Instalao do Mastersaf NF-e Nota Fiscal Eletrnica (NF-e) Ativo

Categoria Sistema operacional

Ferramentas e verses Windows 2000, XP Professional e Windows 2003

SGBD Web Server Sistema de Application Server Outras ferramentas

SQL Server 2000, SQL Server 2005 e Oracle Glassfish verso 2.0 Mastersaf NF-e

SGBD: Sistema Gerenciador de Banco de Dados; SQL: Structured Query Language (linguagem de consulta estruturada).

Pgina 3

Procedimentos para instalao da soluo Mastersaf NF-e Todo o processo de instalao deve ser realizado por um usurio administrador do computador. Caso seja necessrio alterar a unidade de instalao do Mastersaf NF-e, basta alterar o caminho da varivel JAVA_HOME e as respectivas configuraes do Glassfish que fazem referncia s pastas da instalao. importante verificar se a porta usada pela instncia est em uso. Se houver necessidade de mudar a porta da instncia, deve-se editar o arquivo Domain.xml (Glassfish/domain/domain1/config). No esquecer que o servio do Glassfish deve ser reiniciado para que as alteraes feitas na configurao do Servidor de aplicao entrem em vigor. A verso do JDK deve ser a partir da 1.6. Caso seja instalada uma verso anterior do JDK, haver incompatibilidade na instalao do Glassfish.

Instalao do JDK 1.6


Antes de instalar o Java Development Kit verso 1.6 (JDK 1.6) deve ser criada uma estrutura de pastas da instalao: \Mastersaf\Java (Tela 1). Tela 1 Estrutura de pastas

Pgina 4

Procedimentos para instalao da soluo Mastersaf NF-e Aps criar as pastas para instalao, execute o arquivo jdk-6u4-windows-i586-p.exe referente ao sistema operacional em uso (Tela 2). Tela 2

Direcione a instalao do JDK 1.6 para a pasta JAVA recm-criada (Tela 2). Tela 2

Pgina 5

Procedimentos para instalao da soluo Mastersaf NF-e A seguir, faa o mesmo para a instalao do Java Runtime Environment (JRE). Tela 3

Aps a instalao do JDK devem ser criadas as variveis do sistema. Acesse Propriedades do Sistema Avanado Variveis do Sistema (Tela 4). Tela 4

Pgina 6

Procedimentos para instalao da soluo Mastersaf NF-e

No prximo passo deve ser criada a varivel JAVA_HOME, contendo como valor o caminho da instalao do JDK 1.6 (Tela 5). Tela 5

Se o sistema operacional estiver numa linguagem que no seja o portugus (BR), tambm se deve criar a varivel LANG. O valor da varivel ser pt_BR.ISO-8859-1 (Tela 6). Tela 6

Pgina 7

Procedimentos para instalao da soluo Mastersaf NF-e

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

Pgina 8

Procedimentos para instalao da soluo Mastersaf NF-e

Em seguida, abra o MS-DOS, acesse a pasta Java, e digite o seguinte comando (Tela 8): Java Xmx256m jar [nome do arquivo de instalao]. Por exemplo: Java Xmx256m jar glassfish-installerv2ur2b04windowsml.jar_ Tela 8

Na sequncia surgir uma tela de contrato. Clique em tar o Glassfish (Tela 9). Tela 9

(Aceito) para descompac-

Pgina 9

Procedimentos para instalao da soluo Mastersaf NF-e

Aps a anuncia, ao clicar em (Tela 10). Tela 10

(Aceito), iniciar o processo de descompactao

Finalizada a descompactao, acesse a pasta glassfish\lib\ant\bin (Tela 11).


Pgina 10

Procedimentos para instalao da soluo Mastersaf NF-e

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 instalao ser exibida a mensagem BUILD SUCCESSFUL (Tela 13). Tela 13

Pgina 11

Procedimentos para instalao da soluo Mastersaf NF-e

O passo seguinte copiar o arquivo de autenticao de usurio (JdbcAuthModule.jar) para a pasta Mastersaf\Java\Glassfish\Lib\Addons Tela 14

Pgina 12

Procedimentos para instalao da soluo Mastersaf NF-e Em seguida, aps 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 possvel reiniciar (restart) o servio do Glassfish. Portanto, acesse a pasta Mastersaf\Java\glassfish\bin e use o comando asadmin.bat startdomain (Tela 16). Tela 16

Pgina 13

Procedimentos para instalao da soluo Mastersaf NF-e

Configurando o Glassfish
Acesse o servidor da aplicao por meio do link http://localhost:4848/login.jsf (Tela 17). Para acessar, utilize: Usurio (User name): admin. Senha (Password): adminadmin. Tela 17

Pgina 14

Procedimentos para instalao da soluo Mastersaf NF-e

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

Pgina 15

Procedimentos para instalao da soluo Mastersaf NF-e

Em seguida, clique em Tela 20

(Salvar) no canto superior direito da tela (Tela 20).

Acesse a guia Add JVM Option e adicione as seguintes opes (Tela 21): -XX:MaxPermSize=512m;
Pgina 16

Procedimentos para instalao da soluo Mastersaf NF-e -Xms128m; -Dsun.jnu.encoding=ISO-8859-1; -Xss1M; -Xrs; -Duser.timezone=America/Sao_Paulo; -Duser.language=pt; -Duser.country=BR.

Altere a opo Xmx conforme abaixo: -Xmx1g; Caso seja utilizado proxy, adicione as opes a seguir: -Dhttp.proxyHost=<Servidor>; -Dhttp.proxyPort=<Porta>; -Dhttps.proxyHost=<Servidor>; -Dhttps.proxyPort=<Porta>. Caso exista, apagar a opo abaixo: -Djava.security.manager.

Pgina 17

Procedimentos para instalao da soluo Mastersaf NF-e Tela 21

Depois de adicionada s opes da guia JVM, clique em rior direito da tela.

(Salvar) no canto supe-

Configurao com banco de dados SQL 2000 ou 2005


Para criar a conexo com o banco de dados, acesse Resources JDBC Connection Pools (Tela 22).

Pgina 18

Procedimentos para instalao da soluo Mastersaf NF-e Tela 22

Clique em Name: NFE;

(Novo) e preencha os campos (Tela 23):

Resource Type: javax.sql.ConnectionPoolDataSource; Database Vendor: Microsoft SQL Server. Clique em (Seguinte) no canto superior direito da tela.

Pgina 19

Procedimentos para instalao da soluo Mastersaf NF-e Tela 23

Na tela que aparecer em seguida, preencha o campo Datasource ClassName com o valor: com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource (Tela 24). Tela 24

Pgina 20

Procedimentos para instalao da soluo Mastersaf NF-e O passo seguinte ser habilitar os campos Enabled ( ), clicando nessa opo em Allow Non Component Callers e Tela 25 Required na opo Connection Validation, (Tela 25)

Em propriedades do Connection Pool sero usadas as seguintes (Tela 26): databaseName: Nome da base de dados; password: Senha do usurio para conexo do SQL Server; portNumber: Porta do SQL Server; serverName: Nome do servidor; user: Usurio para conexo do SQL Server. Tela 26

Por fim, clique em

(Terminar) para concluir a configurao do Connection Pool.

Para verificar se a conexo com o banco de dados est funcionando, acesse o Connection Pool NFE e clique no boto Ping (Tela 27). Tela 27

Pgina 21

Procedimentos para instalao da soluo Mastersaf NF-e

Configurao com banco de dados Oracle


Para criar a conexo com o banco de dados, acesse Resources JDBC Connection Pools (Tela 28).

Pgina 22

Procedimentos para instalao da soluo Mastersaf NF-e Tela 28

Clique em Name: NFE;

(Novo) e preencha os campos (Tela 29):

Resource Type: javax.sql.ConnectionPoolDataSource; Database Vendor: Oracle. A seguir, clique em Tela 29 (Seguinte) no canto superior direito da tela.

Pgina 23

Procedimentos para instalao da soluo Mastersaf NF-e

Na prxima tela o Datasource Classname dever conter o seguinte valor: oracle.jdbc.pool.OracleConnectionPoolDataSource (Tela 30). Tela 30

A seguir, clique no campo Enabled ( ) na opo Allow Non Component Callers (Tela 31). Tela 31

Pgina 24

Procedimentos para instalao da soluo Mastersaf NF-e

Em propriedades do Connection Pool sero adotadas as seguintes (Tela 32): URL: jdbc:oracle:thin:@[IP_SERVIDOR]:[PORTA_ORACLE]:[NOME_TNS]; Password: Senha do banco; User: Usurio do banco; Tela 32

Finalmente, clique em (Terminar) para concluir a configurao do Connection Pool. Para verificar se a conexo com o banco de dados est funcionando, acesse o Connection Pool NFE e clique no boto Ping (Tela 33). Tela 33

Pgina 25

Procedimentos para instalao da soluo Mastersaf NF-e

JDBC Resources
No console de administrao do servidor Glassfish acesse Resources JDBC JDBC Resources e, em seguida, adicione um novo JDBC Resource, clicando em (Tela 34). Tela 34 (Novo)

Pgina 26

Procedimentos para instalao da soluo Mastersaf NF-e

Preencha os campos: JNDI Name: jdbc/nfe; Pool Name: NFE; Status: Enable. A seguir, clique em Tela 35 no canto superior direito da tela (Tela 35).

A prxima tela exibir a nova JDBC Resource adicionada (Tela 36). Tela 36

Configurando o e-mail
No console de administrao do servidor Glassfish acesse esse o caminho Resources JavaMail Sessions, e clique em Tela 37 (Novo) (Tela 37).

Pgina 27

Procedimentos para instalao da soluo Mastersaf NF-e

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 padro; Default Return Address: Informe uma conta de e-mail padro para retorno; Status: Clicar no campo Enabled ( ). Adicione as propriedades listadas a seguir, mas no se esquecer do prefixo mail- (Tela 38 B): mail-smtp.port: Informe a porta do servidor SMTP(padro = 25); mail-smtp.auth: Informe se o servidor utiliza autenticao (true ou false); mail-smtp.user: Informe o usurio da autenticao do SMTP; mail-smtp.pass: Informe a senha da autenticao do SMTP. Para finalizar, clique em no canto superior direito da tela.

Pgina 28

Procedimentos para instalao da soluo Mastersaf NF-e Tela 38

Pgina 29

Procedimentos para instalao da soluo Mastersaf NF-e Tela 38 B

Configuraes de segurana e autenticao de usurios


Acesse no console de configurao do Glassfish o seguinte caminho: Configuration Security (Tela 39). Tela 39

Selecione a opo Default Principal To Role Mapping e clique em canto direito superior da tela (Tela 40).

(Salvar) no

Pgina 30

Procedimentos para instalao da soluo Mastersaf NF-e Tela 40

Configurao de autenticao de usurios


Para configurar a autenticao de usurios da aplicao, acesse Configuration Security Realms no console do Glassfish (Tela 41). Tela 41

Clique em

(Novo) e preencha a opo:

Pgina 31

Procedimentos para instalao da soluo Mastersaf NF-e Name: Digitar JDBC em caixa-alta (letras maisculas). Depois, selecione a opo 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

Pgina 32

Procedimentos para instalao da soluo Mastersaf NF-e

A Tela 42 B apresenta o novo usurio configurado adicionado. Por fim, clique em no canto superior direito da tela para finalizar a configurao. 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; };

Pgina 33

Procedimentos para instalao da soluo Mastersaf NF-e

2. JMS Resources
Connection Factories
Acesse nas opes de configurao 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 ( ).

Pgina 34

Procedimentos para instalao da soluo Mastersaf NF-e 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;

Pgina 35

Procedimentos para instalao da soluo Mastersaf NF-e Tela 44 A

Crie um novo JMS Connection Factory, clicando novamente em tion Factories (Tela 45). Tela 45

na aba Connec-

Preencha os campos com: JNDI Name: jms/MDBImpressaoFactory;

Pgina 36

Procedimentos para instalao da soluo Mastersaf NF-e Type: javax.jms.QueueConnectionFactory; Status = Enabled ( ); Delete as propriedades. Em seguida, clique em para finalizar (Tela 46). no canto superior direito da tela

Tela 46

Destination Resources
Acesse o seguinte caminho Resources JMS Resources Destination Resources. Em sequncia, adicione um novo JMS Destination Resources, clicando em (Tela 47). (Novo)

Pgina 37

Procedimentos para instalao da soluo Mastersaf NF-e 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).

Pgina 38

Procedimentos para instalao da soluo Mastersaf NF-e Tela 49

Adicione um novo JMS Destination Resources, clicando em Tela 50

(Novo) (Tela 50).

Pgina 39

Procedimentos para instalao da soluo Mastersaf NF-e 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 canto superior direito da tela para finalizar (Tela 52).

no

Aps todas as configuraes realizadas neste documento, devemos reiniciar (restart) os servios do Glassfish para poder continuar. Podemos reiniciar os servios do Glassfish executando dois comandos no MS-DOS. 1. Parando o servio do Glassfish Acesse a pasta bin da instalao do Glassfish, no caminho Mastersaf\Java\Glassfish\bin, e execute o comando asadmin stop-domain (Tela 52).

Pgina 40

Procedimentos para instalao da soluo Mastersaf NF-e

Tela 52

2. Iniciando o service do Glassfish Dentro da pasta bin da instalao do Glassfish no caminho Mastersaf\Java\Glassfish\bin (Tela 53).

Pgina 41

Procedimentos para instalao da soluo Mastersaf NF-e

Tela 53

Deploy do aplicativo
Acesse novamente o console de administrao do Glassfish (http://localhost:4848) e siga o seguinte caminho para fazer o deploy: Applications Enterprise Applications. A seguir clique em (Tela 54).

Pgina 42

Procedimentos para instalao da soluo Mastersaf NF-e

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

Pgina 43

Procedimentos para instalao da soluo Mastersaf NF-e

Acessando a aplicao Mastersaf NF-e


Terminado o Deploy, j possvel acessar a aplicao Mastersaf NF-e. Abra um browser de internet e use o seguinte link para se conectar aplicao (Tela 56): HTTP://localhost:8080; Usurio: admin; Senha: nfe321. Tela 56

A senha do usurio de login da aplicao pode ser alterada mediante um update, na tabela NFE_USUARIO, na coluna DS_SENHA.

Pgina 44

Potrebbero piacerti anche