ÍNDICE OBJETIVO... 3 CONFIGURAÇÃO DO TOMCAT 5.5... 3 PASSOS NECESSÁRIOS... 3 CONFIGURANDO O SERVIDOR DE BANCO DE DADOS... 9 SCRIPTS DDL... 9 INICIANDO A INSTALAÇÃO... 9 CONFIGURANDO O MENU DO SISTEMA REDF... 11 CONFIGURANDO O ACESSO AO MÓDULO ATRAVÉS DO MANAGER... 11 INFORMAÇÕES ADICIONAIS... 11 VERIFICAÇÕES PÓS-INSTALAÇÃO... 12 SUPORTE TÉCNICO... 13 2
OBJETIVO O Objetivo deste manual é orientar sobre os procedimentos necessários para realizar o processo de configuração e criptografia do produto MASTERSAF REDF SP. CONFIGURAÇÃO DO TOMCAT 5.5 Descompacte o arquivo REDF.ZIP e execute os procedimentos abaixo. SERVIDOR/FUNCIONALIDADE NOME IP Tomcat /Redf <servidor:porta> PASSOS NECESSÁRIOS 1) Com o serviço do Tomcat parado, copiar o arquivo da aplicação Redf.war enviada para a pasta webapps. Para configurar a conexão com o banco de dados são necessárias as seguintes informações: PARÂMETROS Usuário do Banco de Dados Senha do Usuário do Banco de Dados IP ou Nome do Host de Banco de Dados Porta de Acesso ao Banco de Dados Nome do Serviço do Banco de Dados (SID) 3
Os parâmetros IP ou Nome do Host, Porta e Serviço podem ser obtidos executando um TNSPING para o alias de acesso ao banco de dados, conforme exemplo abaixo: C:\>tnsping sbrhomo TNS Ping Utility for 32-bit Windows: Version 9.2.0.1.0 - Production on 11-ABR-20 08 07:48:04 Copyright (c) 1997 Oracle Corporation. All rights reserved. Arquivos de parâmetros usados: Usado o adaptador TNSNAMES para resolver o apelido Attempting to contact (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP) (HOST = SSPDTS010)(PORT = 1521))) (CONNECT_DATA = (SERVICE_NAME = REDF))) OK (0 ms) O SID do banco, neste exemplo, é o SBR. Após obter os parâmetros, editar o arquivo security-db.properties, localizado em: 4
Modelo do Arquivo security-db.properties : #Nome do Usuário do banco de dados username=redf32 #Senha do usuário do banco de dados #Esta senha deverá ser criptografada pela aplicação. #Url para criptografia: http://nome_servidor_aplicação:porta/redf/encrypt.jsp password= j+nepbycxja= #Nome ou IP do servidor do banco de dados host=10.11.99.103 #Porta do servidor de banco de dados port=1521 #Nome da instância do banco de dados instance=msafprod Alterar o atributo que permite acesso ao Banco de Dados: Username= Seu usuario do banco Password= Senha CRIPTOGRAFADA de usuario do banco Host = Nome (IP) do Servidor do Banco de Dados Port= Porta do Servidor de Banco de Dados Instance= Instância do Banco de Dados A url é composta pelos seguintes elementos e que devem ser preenchidos: Host ou IP, seguido da Porta e do Serviço do Banco de Dados: http://nome_servidor_aplicação:porta/redf/encrypt.jsp Para Criptografar a senha 5
2) Como Criptografar a senha do Banco de Dados: Arquivo security-db.properties: 3) Iniciar o serviço do Tomcat 6
Inserir o endereço para ser gerada a senha criptografada, no caso do exemplo: http://10.11.96.113:8080/redf/pages/gerarsenha.jsf Inserir a Senha do Banco de Dados 7
A Senha foi CRIPTOGRAFADA: j+nepbycxja= A Senha deve ser copiada para ser adicionada no arquivo: security-db.properties. 8
CONFIGURANDO O SERVIDOR DE BANCO DE DADOS SCRIPTS DDL Utilize o mesmo usuário de banco de dados do MASTERSAF para ser o owner da aplicação, com direitos para criação dos objetos necessários: Tabelas, Sequences, Triggers, Packages, Views, Procedures e Functions. Deve, obviamente, possuir direitos de: insert, update, delete e select e/ou execute nos objetos criados. Além destes, deve possuir acesso de Select às Tabelas e Views do MASTERSAF. Antes de iniciarmos a instalação devemos ter pelo menos um conceito: - O REDF gera os arquivos em uma pasta dentro do diretório do Oracle. Estes diretórios são representados dentro do banco com um objeto assim como uma tabela, view etc... Este objeto chama-se DIRECTORIES sendo que sua criação deve ser feita pelo usuário SYS do banco de dados e concedidos direitos de READ e WRITE ao usuário MASTERSAF DW. O mesmo deve apontar para um diretório físico no servidor onde está instalado o banco de dados. Para saber o endereço deste diretório, caso não tenha acesso de visualização do mesmo, consulte o DBA. INICIANDO A INSTALAÇÃO 1º - Antes de executar, altere o script 004_cria_diretorio.sql que está dentro da pasta PROCEDURES para refletir os diretórios correntes do Oracle. Estes diretórios serão utilizados na geração dos arquivos de notas fiscais e ECFs. Observação: Os Nomes dos Diretórios (Directory) deverão ser obrigatoriamente: REDF e ECFSMFD, pois as: Packages, Procedures, etc..., observarão o diretório criado com esse nome. 9
2º - Dentro da pasta PROCEDURES executar o script Install.sql. 3º - Após executar o script Install.sql, verifique e altere a tabela RDF_PARAMETROS para que reflita a infraestrutura da sua empresa. Atenção: Se este próximo passo não for executado de forma adequada, o sistema irá criar os arquivos, porém, não irá transferi-los para o diretório de Destino. (Lembrando que diretório de Destino ainda deverá ser configurado dentro da aplicação REDF). Esta configuração deve ser feita diretamente no banco de dados, pois não há interface para isto. Onde: DIR_ORACLE_METODO: Informe 1 se a sua aplicação trabalhar exclusivamente com rede interna, file system. Informe 2 se a sua aplicação trabalhar exclusivamente com serviços de FTP. DIR_ORACLE_HOST: Este parâmetro se refere ao endereço de FTP a ser utilizado e que deve, obrigatoriamente, apontar para o diretório onde são criados os arquivos no Oracle. DIR_ORACLE_PORTA: Utilize esta configuração apenas se o seu servidor de FTP obrigar a utilização de uma porta. Na maioria dos casos esta informação não é preponderante. DIR_ORACLE_USUARIO: Se refere ao usuário do FTP ou relacionado ao usuário de acesso à rede interna. DIR_ORACLE_SENHA: Senha de acesso ao FTP ou rede interna, file system. DIR_ORACLE_CAMINHO: É o caminho onde se encontram os arquivos no FTP ou rede interna. Observação: No caso de FTP, observar a correta sinalização dos diretórios, pois seguem um padrão diferente do informado em redes Windows. Para validar, procure sempre 10
fazer um teste com um serviço de FTP, do DOS, por exemplo, para certificar-se de estar se conectando com o usuário e senha corretos. CONFIGURANDO O MENU DO SISTEMA REDF Primeiro, abra o MASTERSAF DW e acesse o Módulo Segurança (Power Lock) para realizar a associação dos usuários com o módulo REDF. O usuário, administrador do MASTERSAF DW, deve acessar o sistema e inserir o módulo ao usuário. Fazer a associação de regras para o Módulo REDF. CONFIGURANDO O ACESSO AO MÓDULO ATRAVÉS DO MANAGER Edite o arquivo REDF.INI e altere o endereço da aplicação, conforme exemplo abaixo: [parametros] url=http://10.11.99.91:8081/redf Onde: 10.11.99.91:8081 corresponde ao endereço no qual o sistema foi instalado no Tomcat. Mova os arquivos alterados: REDF.EXE e REDF.INI para o diretório de executáveis do MASTERSAF DW. INFORMAÇÕES ADICIONAIS Para que o usuário possa, através do REDF, visualizar o arquivo Nota Fiscal gerado no local parametrizado, o mesmo precisa ter permissão no diretório. 11
VERIFICAÇÕES PÓS-INSTALAÇÃO O processo de instalação disponibiliza um relatório completo sobre o estado dos objetos criados, mas algumas verificações podem ser feitas para minimizar a possibilidade de erros durante a execução da aplicação. 1) Estando com acesso ao banco de dados, a partir do plsqldeveloper ou sqlplus, execute o comando abaixo: SELECT * FROM USER_OBJECTS WHERE OBJECT_NAME LIKE 'RDF%' AND STATUS = 'INVALID'; Se o comando retornar alguma informação, indicando que algum objeto está inválido, verifique o motivo, e se é passível de solução. Em caso de dúvida procure o suporte MASTERSAF para mais ajuda. 2) Verifique se o arquivo CONTEXT.XML da aplicação no Tomcat foi alterado, conforme documentação. Se houver a necessidade de alterar o arquivo, não se esqueça de sempre restartar o serviço do Tomcat, caso contrário, as informações não serão atualizadas pelo servidor de aplicação. 3) Verifique se as configurações do FTP e/ou File System foram corretamente preenchidas na tabela RDF_PARAMETROS, não esquecendo que todos os valores de 1 a 6 devem ser preenchidos, caso contrário, a aplicação não irá funcionar. 4) Ao abrir a aplicação, acesse o menu CONFIGURAÇÕES DE REGRAS -> DIRETÓRIOS E METODOS DE ACESSO e configure o diretório para a empresa e estabelecimento, apontando o endereço para onde serão enviados os arquivos gerados. Obs.: Se esta informação não for informada, o sistema não funcionará e seus arquivos não serão gerados. 12
SUPORTE TÉCNICO Para dúvidas ou problemas, abra um chamado no Contact Center ou entre em contato com nossa equipe de Suporte Técnico MASTERSAF pelo Telefone: (11) 2159-0600 opção 01 (Atendimento das Soluções Fiscais). Nosso horário de atendimento é de segunda à sexta-feira de 09h00min às 18h00min. 13