Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
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
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.
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.
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
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
Instalando o Glassfish
Copie o arquivo de instalao do Glassfish para a pasta Java (Tela 7). Tela 7
Pgina 8
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
Pgina 9
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
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
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
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
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
Pgina 18
Resource Type: javax.sql.ConnectionPoolDataSource; Database Vendor: Microsoft SQL Server. Clique em (Seguinte) no canto superior direito da tela.
Pgina 19
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
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
Pgina 22
Resource Type: javax.sql.ConnectionPoolDataSource; Database Vendor: Oracle. A seguir, clique em Tela 29 (Seguinte) no canto superior direito da tela.
Pgina 23
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
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
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
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
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
Pgina 29
Selecione a opo Default Principal To Role Mapping e clique em canto direito superior da tela (Tela 40).
(Salvar) no
Pgina 30
Clique em
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
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
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
Pgina 34
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
Crie um novo JMS Connection Factory, clicando novamente em tion Factories (Tela 45). Tela 45
na aba Connec-
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
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
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
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
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
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
A senha do usurio de login da aplicao pode ser alterada mediante um update, na tabela NFE_USUARIO, na coluna DS_SENHA.
Pgina 44