Redatam+SP REcuperação de DAdos para Areas pequenas por Microcomputador Redatam+ SP WebServer (R+SP WebServer) Instalação e Configuração para o Sistema Operacional Windows REDATAM+SP é um programa computacional desenvolvido pelo Centro Latinoamericano e Caribenho de Demografia (CELADE), que é a Divisão de População da Comissão Econômica para América Latina e o Caribe (CEPAL), Nações Unidas. www.eclac.cl/celade/redatam/ WebServer_Install_PRT 2006.03.31 PORTUGUÊS
Índice I. Introdução...2 II. Descarregar R+WebServer...2 III. Instalar R+WebServer...2 IV. O Servidor Apache...3 IV.1 Instalação do Apache...3 IV.2 Verificar a instalação do Apache...4 IV.3 Configurar o Apache para habilitar ao R+WebServer...5 IV.4 Reiniciar o Apache...6 V. O Servidor IIS ( Internet Information Server )...6 V.1 Instalação do IIS...6 V.2 Verificar a instalação do IIS...6 V.3 Ativar a Aplicação...7 V.4 Diretório Virtual redatam...8 V.5 Diretório Virtual cgibin...9 V.6 Proteções para o Diretório cgibin...10 V.7 Extensões de Serviços Web ( IIS versão 6.0 )...10 VI. Verificar a execução do R+WebServer...11 VII. Habilitação do Servidor para outras bases REDATAM...12 1
I. Introdução O objetivo deste documento é o de servir como um guia rápido para a instalação da aplicação R+WebServer, usando qualquer dos dois servidores Web descritos, Apache ou Internet Information Server (IIS). A escolha do servidor Web a ser utilizado depende da configuração do ambiente de trabalho ou da preferência de cada usuário. O documento foi escrito de tal maneira que não sejam necessários maiores conhecimentos sobre os servidores Web usados (Apache ou IIS). Os usuários que estiverem mais familiarizados com o Servidor Web podem ajustar esta instalação de acordo a suas necessidades. Nos primeiros capítulos são descritas a descarga e instalação dos arquivos necessários para a aplicação R+WebServer. Em seguida passa-se para as partes específicas de cada um dos servidores Web (Apache ou IIS), e finalmente mostra-se como testar a aplicação e modificá-la para outras bases de dados. II. Descarregar R+WebServer A maneira mais direta é por descarga ("download"), visitando a página web oficial de Redatam: http://www.eclac.cl/celade/redatam/ Nesta página você encontrará uma conexão para a última versão do software na seção de atualizações. Descarregar o arquivo R+WebServer_V4Rev00.exe para um diretório temporário de trabalho de seu disco rígido (os números de versão ( 4 ) e revisão ( 00 ) vão mudando conforme o software é atualizado). III. Instalar R+WebServer Criar uma pasta com o nome de Servers no disco C: (C:\Servers), e nesta pasta, criar uma outra pasta chamada Redatam (C:\Servers\Redatam). 1 É importante que o usuário tenha direitos de gravação sobre o disco. Extrair os arquivos de instalação executando o arquivo R+WebServer_V4Rev00.exe (duplo clique sobre o nome do arquivo) no diretório "C:\Servers\redatam\". 2 A estrutura da pasta deveria ser como se mostra na figura a seguir: 1 O disco pode ser outro, assim como os nomes das pastas. Neste caso é necessário modificar as demais instruções deste documento de acordo aos nomes escolhidos. 2 Este documento deve estar também na pasta Docs da instalação. 2
O diretório redatam está dividido em três pastas: 1. cgibin, que deve conter as bases de dados, e portanto deveria ser a parte protegida da instalação; 2. docs, contendo toda a documentação; e 3. htdocs, a parte visível da aplicação, que será conhecida pelos usuários através do seu alias redatam. IV. O Servidor Apache Este capítulo contém uma descrição rápida da instalação para os usuários que queiram usar o Apache e este ainda não esteja instalado no seu computador. Este não é um manual do Apache. Os parâmetros aqui mencionados foram definidos para tornar mais fácil sua instalação, o que não invalida a possibilidade de personalizá-la de acordo a suas próprias necessidades. O uso do Servidor Apache é muito simples, trata-se basicamente de dois passos: 1. instalação (se é que já não está instalado); e 2. editar o arquivo de configuração do Apache para habilitar o R+WebServer (copiar e colar dois blocos de texto contidos neste documento). IV.1 Instalação do Apache Verifique na parte inferior direita da tela se o ícone do Apache está ligado (Ao passar o cursor sobre o ele deveria aparecer Running all Apache Services ). Se o servidor Apache ainda não está instalado, vá para a página http://httpd.apache.org/ e faça um download da última versão oficial (que não seja Beta). Em geral, essa versão encontra-se em uma entrada chamada Win32 Binary (MSI Installer) na página do Apache. 3
Para o processo de instalação do Apache, recomenda-se utilizar as opções padrão (next next next). Não é necessário preencher as opções de Net Domain, Server name Administrator s email. Selecione a instalação typical. IV.2 Verificar a instalação do Apache Depois da instalação o servidor Apache deve estar funcionando automaticamente. Verifique na parte inferior direita da tela se o ícone do Apache está ligado. Usando o navegador de sua preferência (Windows Explorer, etc.), acesse a página padrão do servidor, digitando o seguinte: Isto deveria mostrar uma página similar à da figura: http://localhost/ 4
IV.3 Configurar o Apache para habilitar ao R+WebServer Com o editor de textos de sua preferência, editar o arquivo "httpd.conf" localizado na pasta "conf" do diretório principal do Apache (C:\Program Files\Apache Group\Apache2\conf). Buscar o Alias /icons/ e criar uma entrada para o usuário "redatam" da seguinte maneira: Alias /redatam "C:/servers/redatam/htdocs/" <Directory "C:/servers/redatam/htdocs"> Options Indexes MultiViews AllowOverride None Order allow,deny Allow from all </Directory> Buscar o ScriptAlias /cgi-bin/ e criar uma entrada para o script "cgibin" da seguinte maneira: ScriptAlias /cgibin/ "C:/servers/redatam/cgibin/" <Directory "C:/servers/redatam/cgibin"> AllowOverride None Options None Order allow,deny Allow from all </Directory> Salvar as modificações feitas no arquivo "httpd.conf". 5
IV.4 Reiniciar o Apache No ícone do Apache na parte inferior direita da tela, utilizar o botão esquerdo do Mouse e escolher a opção Restart. Alternativamente, ir a Iniciar, Programas, Apache, Control Apache Server e Restart. V. O Servidor IIS ( Internet Information Server ) Similar ao Apache, o uso do IIS é muito simples. A diferença radica em que sua configuração é feita através de um administrador do serviço, e não editando diretamente o arquivo de configuração, como no caso do Apache. V.1 Instalação do IIS Para saber se o servidor já está instalado, vá ao Painel de Controle do Windows, escolha a opção de Agregar/Remover Programas, e selecione o botão à esquerda de Agregar/Remover Componentes de Windows. O sistema deve mostrar uma figura similar à seguinte: Se o servidor IIS já estiver instalado aparece uma marca ao lado da entrada Application Server, tal como na figura acima. Se não estiver instalado, marque esta entrada e prossiga com a instalação. Recomenda-se utilizar as opções padrão de instalação (next... next... next). Durante o processo o sistema deve pedir o CD de Instalação do Windows. V.2 Verificar a instalação do IIS Usando o navegador de sua preferência, acessar a página padrão do servidor, digitando o seguinte: http://localhost/ Caso seja a primeira instalação, o sistema deveria mostrar uma página similar à seguinte: 6
Caso contrário, mostra a página padrão criada pelo Administrador do Sítio Web (webmaster). Se a página mostrada contém erros, revisar a configuração do IIS ou referir-se à documentação da Microsoft (http://www.microsoft.com/). V.3 Ativar a Aplicação Para ativar a aplicação, entrar na tela de configuração do Servidor IIS, via Painel de Controle do Windows, escolhendo Ferramentas Administrativas e depois Internet Information Server Manager. Outra forma alternativa e mais rápida de acesso é executar o comando inetmgr. O sistema deveria mostrar uma figura similar à seguinte: 7
V.4 Diretório Virtual redatam No programa de configuração do IIS, para criar um novo diretório virtual, posicione-se sobre Página Web Padrão (Default Web Site), e com um clique no botão direito, selecionar Novo Diretório Virtual (New, e depois Virtual Directory). O sistema mostra a tela a seguir, onde o Alias a ser informado deverá ser redatam (respeitando maiúsculas e minúsculas): Pressionar o botão de Avançar (Next) e, na tela seguinte, usar o botão de Browse para localizar o diretório htdocs dentro do diretório onde foram extraídos os arquivos de instalação do R+WebServer, por exemplo: "C:\servers\redatam\htdocs", tal como se mostra na figura a seguir: Continuar com o próximo passo e marcar unicamente a autorização de "leitura", como se mostra na figura abaixo: 8
Finalizar o processo, e usando o navegador de sua preferência, acessar a página de redatam do seu servidor para verificar o processo, digitando o seguinte: http://localhost/redatam/ Se os passos foram realizados corretamente, o navegador deveria mostrar a página: V.5 Diretório Virtual cgibin Repetir o processo anterior em V.4 para criar outro diretório virtual com os seguintes parâmetros: Alias : cgibin ( respeitando maiyúsculas e minúsculas ) Path : subdiretório "cgibin" do diretório redatam onde foram extraídos os arquivos de instalação. Por exemplo : "C:\servers\redatam\cgibin" Autorizações : Unicamente de "execução" ( Execute, não é Run Scripts ). 9
V.6 Proteções para o Diretório cgibin Dado que este diretório contém informação das bases de dados, é necessário realizar algumas restrições de acesso. Para tanto, posicione-se sobre o diretório virtual cgibin, e com um clique no botão direito, selecionar Propriedades. Primeiramente deve-se modificar a forma de acesso ao diretório, não deve estar marcado nenhum acesso, tal como se mostra na figura abaixo: Em seguida, use a aba de Documentos, e desabilite o acesso padrão a documentos: Pressionar o botão OK para aceitar as modificações e, antes de fechar o programa de configuração do IIS, verifique se a versão instalada do IIS é a 6.0 (em Ajuda). V.7 Extensões de Serviços Web ( IIS versão 6.0 ) Esta versão do IIS, em princípio, não permite executar aplicações do tipo CGI, o que nos obriga a definir manualmente que programas deste tipo podem ser executados no servidor, como é o caso do R+WebServer. Para realizar estas modificações, no programa de configuração do IIS, posicionar-se sobre Extensões de Serviços Web, clicar no botão direito e selecionar Agregar nova Extensão de Serviços Web. Aparece a seguinte figura: 10
O nome sugerido para a extensão é redatam e os arquivos que deberão ser agregados são RpWebEngine.exe e WebUtilities.exe, localizados no diretório cgibin, por exemplo "C:\servers\redatam\cgibin, tal como se mostra na seguinte figura: VI. Verificar a execução do R+WebServer No navegador de sua preferência, acessar a página de REDATAM do seu servidor para verificar o processo, digitando o seguinte: http://localhost/redatam/ Se os passos foram realizados corretamente, o navegador deveria mostrar a página: 11
Ao apertar o botão de Enter Test Site deveria aparecer a página: VII. Habilitação do Servidor para outras bases REDATAM Antes de habilitar a página para outras aplicações, é importante deixar claro que existem dois ramos de diretórios embaixo do diretório raiz servers/redatam, como mostra a figura a seguir: 12
Estes dois ramos coexistem para armazenar todos os arquivos que são utilizados numa aplicação de internet. O ramo denominado cgibin é usado para armazenar diretórios e arquivos protegidos (bases de dados, images, mapas e arquivos.inl necessários para a execução do programa RpWebEngine.exe); e outro ramo denominado htdocs para armazenar todos os arquivos públicos (arquivos de ajuda online, imagens, etc., em geral todos os arquivos e documentos referenciados diretamente pelos arquivos html executados na internet). Para cada aplicação, é preciso criar um subdiretório em servers/redatam/cgibin/rpbases com os seguintes subdiretórios: Base (para os arquivos.dic,.rbf,.ptr) Site (para os.jpg,.gif e html próprios da base, ou os modificados de RpSite) Work (para as seleções -.slw,.sel-, mapas -.mxp,.shp,.shx,.dbf -) Em seguida deverá ser criado outro subdiretório, em servers/redatam/htdocs para colocar todos os arquivos e imagens de tipo públicos referenciados diertamente pelos arquivos html. Por exemplo, para a aplicação de Nova Miranda colocou-se toda a base de dados e páginas.inl em cgibin/rpbases/nmir, e todas as imagens referenciadas pelos arquivos html (por exemplo, RpOutput_ESP.htm) mais os arquivos de ajuda em htdocs/nmir. O passo seguinte é editar o arquivo.inl que controla a página principal de entrada para as aplicações manejadas pelo Redatam WebServer, que se chama Webservermain.inl localizado na pasta \Redatam\cgibin. Neste archivo devem ser ingressadas as entradas correspondentes às novas aplicações ou bases de dados, agregando em NODEs o nome definido para esta aplicação: 13
Depois, criar uma seção com este mesmo nome, onde se define o arquivo inl principal, por exemplo, guest.inl: [APPUSER] CAPTION=Nova Aplicação INL=RpBases\AppUsuario\Guest.inl PAGETYPE=BASE Em seguida criar o arquivo Guest.inl no diretório da aplicação; depois, editar este arquivo e criar a seção STRUCTURE; identificar a base de dados usando a cláusula WORKSPACE, e identificar os diretórios para guardar as imagens e mapas utilizados: WORKSPACE=Base\NMirEsp.dic HTMLSITE=Site\ WORKPATH=Work\ Finalmente, editar o Guest.INL para completar a aplicação colocando todos os nodos necessários, seguindo o exemplo de Nova Miranda. 14