IREF – Instruções para Instalação Banco de Dados: Oracle 1. Introdução Esse documento contém as instruções para instalação da aplicação IREF na estrutura de máquinas da empresa cliente. No caso, estão descritos os procedimentos para instalação no servidor de banco de dados Oracle, no servidor de aplicações e configuração das máquinas clientes. 2. Servidor de Banco de Dados Basicamente os processos de instalação da aplicação no servidor de banco de dados resumem-se a criar o schema de dados e rodar os scripts de criação dos elementos de dados da aplicação. 2.1. Criar schema de dados Antes dos procedimentos de criação do schema de dados, o cliente necessita definir como será estruturada a base de dados para a aplicação. Isso envolve tanto o dimensionamento das tablespaces como sua organização. Indicamos a necessidade de um espaço em disco inicial na ordem de 200 Mb para uma instalação. Esse espaço é dividido em dados e índices na proporção de 1:1, ou seja, cada 1 Mb de dados possui um correspondente de 1 Mb de índices. Assim, se o cliente optar por segmentar a base em duas tablespaces, sugerimos um espaço inicial de 100 Mb para dados e 100 Mb para índices. • • • • • • • • 2.2. Acessar o aplicativo DBAStudio do Oracle, conectando-se com o usuário SYS ou SYSDBA. Criar as tablespaces através do menu Armazenamento|TableSpaces. Nessa função, indicar o nome e tamanho das das tablespaces. Criar o usuário owner do schema, através do menu Segurança|Usuários. Deve-se informar o nome/senha do usuário, indicar a tablespace de dados como default, e configurar os privilégios. Indicar na guia Atribuição, os privilégios [Connect,Resource]. Excluir todos os Privilégios de Sistema. Na guia Cota, indicar ilimitado para as tablespaces criadas. Rodar scripts de criação Os scripts abaixo listados são fornecidos junto com os componentes para instalação do sistema. Devem ser processados exatamente na ordem apresentada, sob pena da não instalação correta dos componentes de dados. • • • • • Acessar o aplicativo SQL-Plus, conectando-se ao schema do IREF através do usuário owner criado no item anterior. Os scripts devem ser rodados na ordem abaixo, utilizando o comando de processamento de arquivos externos. Por exemplo, com o script Tables.sql gravado no diretório C:\Temp, deve-se executá-lo com o comando @C:\Temp\Tables.sql. Importante acompanhar a execução de todos os scripts, atentando para o surgimento de alguma eventual mensagem de erro. Caso isso ocorra, parar a instalação e entrar em contato. Executar o script Tables.SQL. Ao fazê-lo, será solicitado o nome da tablespace de índices. Se não houve desmembramento entre dados e índices, indicar o nome da tablespace de dados. Executar o script Procedures.SQL. www.ilab.com.br - Tel: (16) 3623-5680 Página 1 de 4 • • 3. Executar o script Triggers.SQL. Executar o script Carga.SQL. Servidor de Aplicação Os processos de instalação da aplicação no servidor de aplicação envolvem descompactação dos executáveis e demais componentes do sistema em um diretório designado para o cliente como o de instalação central do aplicativo. 3.1. Instalação do executável Os executáveis da aplicação devem ser instalados em um diretório servidor onde os usuários da aplicação tenham acesso através da rede. Supondo que esse diretório escolhido tenha sido o I:\IREF, devemos executar os seguintes procedimentos: • • • 3.2. Criar o diretório de instalação I:\IREF, liberando o acesso e o privilégios de gravação/exclusão aos usuários da aplicação. Descompactar o instalador da aplicação nesse diretório, que deve conter, ao final da instalação, os arquivos: - IREF.EXE - IREF.PAR - IREF.INI - IREF.IRG Caso seja necessário, pode-se proteger os arquivos da aplicação listados acima com a limitação do privilégio de apenas leitura. Licença de uso O arquivo IREF.IRG contém o nome da empresa e o código de licença para uso da mesma. Esse arquivo e/ou o código de licença de uso deve ser obtido junto à iLab Sistemas, segundo a forma de contrato negociado entre as empresas. 3.3. Configuração da conexão com o banco O arquivo IREF.INI contém todos os parâmetros de conexão da aplicação com o servidor de banco de dados, e devem ser alterados apenas com orientação da equipe de suporte da iLab Sistemas. Abaixo segue a lista dos principais parâmetros de configuração. • [Parâmetros] SERVER NAME={tnsname do serviço de acesso ao banco oracle} USER NAME={nome do usuário owner de acesso} PASSWORD={password de acesso do usuário owner} OBS: caso o controle de acesso à aplicação seja por usuário nomeado no banco, deve-se excluir os parâmetros USER NAME e PASSWORD da configuração. • [Seguranca] Permite criptografar qualquer parâmetro de configuração da seção anterior. É particularmente útil quando desejamos ter um controle de acesso através do usuário owner do banco, mas não podemos disponibilizar o nome e a password de acesso do mesmo. www.ilab.com.br - Tel: (16) 3623-5680 Página 2 de 4 4. Máquinas clientes A instalação da aplicação nas máquinas cliente, destinadas ao uso pelo usuário final, engloba essencialmente a instalação dos aplicativos de interface com o banco de dados, e na disponibilização de atalhos para acesso ao executável do sistema. 4.1. Instalar client do Oracle O primeiro procedimento de configuração da máquina cliente envolve a instalação do client do Oracle que permitirá a conexão da aplicação ao banco de dados. Isso envolve principalmente procedimentos internos da empresa, mas essencialmente devemos ter: • • Instalação da versão client do Oracle, compatível com o servidor em uso. Configuração do arquivo TNSNAMES.ORA, geralmente localizado no diretório de instalação do client do oracle. (p.e. em \oracle\ora81\network\admin). Essa configuração deve se ater principalmente aos parâmetros que habilitam o acesso ao serviço correto do banco de dados: - CONEXAO: nome da conexão para a máquina local - HOST: nome da máquina servidora - SERVICE: nome do serviço na máquina servidora A configuração deve ser feita de forma que o nome da CONEXAO seja o mesmo do indicado no parâmetro SERVER NAME do arquivo IREF.INI. A configuração do TNSNAMES.ORA deve, portanto, incluir uma seção do tipo abaixo: NOME_CONEXAO = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = NOME_SERVIDOR)(PORT = 1521)) ) (CONNECT_DATA = (SERVICE_NAME = NOME_SERVICO) ) ) 4.2. Instalar o BDE Além da instalação do client do Oracle, a aplicação também necessita da instalação do BDE, que é um engine de conexão do IREF com o banco de dados. O procedimento de instalação do BDE envolve: • • • Efetuar o download da versão mais atualizada do BDE em: www.ilab.com.br/arquivos/bde/bde520.exe Executar o instalador do BDE nas máquinas clientes que utilizarão a aplicação. Após a instalação, configurar o driver nativo do Oracle de forma adequada à versão do banco instalado na empresa. Isso é feito pelo Painel de Controle|BDE Administrator, na guia Configuration, e opção Drivers|Native|Oracle: Oracle 7.3 ou inferior: DLL32: SQLORA32.DLL www.ilab.com.br - Tel: (16) 3623-5680 Página 3 de 4 VENDOR INIT: ORA73.DLL Oracle 8.0 ou superior: DLL32: SQLORA8.DLL VENDOR INIT: OCI.DLL OBS: Caso ocorram problemas de instalação do arquivo SQLORA8.DLL, ele pode ser baixado separadamente através do endereço abaixo, devendo ser posteriormente copiado no diretório de instalação do BDE: http://www.ilab.com.br/arquivos/bde/sqlora8_512.zip 4.3. Disponibilizar atalho para aplicação O último passo da instalação da aplicação corresponde à instalação de um atalho na máquina cliente do usuário para execução do aplicativo IREF.EXE instalado no servidor de aplicações da empresa. www.ilab.com.br - Tel: (16) 3623-5680 Página 4 de 4