• Introdução
• Instalando o Apache 1.3.29
• Instalando o PHP 4.3.3
• Instalando o MapServer 4.0.1
• Instalando o MapLab 2.0.1
• Fontes de Informação

Introdução

Este documento apresentará de forma fácil e rápida a instalação do ambiente necessário para o uso do MapLab em uma máquina com Windows XP. O objetivo não é abordar a compilação dos pacotes, ou mesmo o uso do software MapServer/MapLab, e sim apenas descrever os passos realizados para instalar esses softwares de forma rápida e sem problemas. Esse documento não é recomendado como fonte única de informações para a instalação dos pacotes abaixo, muito menos para obtenção de informações referentes ao uso do MapLab. O Autor também isenta-se de qualquer problema que por ventura possa ocorrer no uso dos softwares ou no processo de instalação apresentados a seguir. Os softwares utilizados nesse documento, podem ser encontrados em:

• Apache 1.3.29: http://archive.apache.org/dist/httpd/binaries/win32/apache_1.3.29-win32-x86-no_src.exe
• php 4.3.3: http://br.php.net/get/php-4.3.3-Win32.zip/from/this/mirror
• MapServer 4.0.1: http://www2.dmsolutions.ca/webtools/dl/mapserver-4.0.1-win32-php4.3.3.zip
• MapLab 2.0.1: http://www2.dmsolutions.ca/mapserver/dl/maplab-2.0.1-release.zip

Também deve estar previamente instalado, suporte à Java no Browser para o correto funcionamento do MapLab.

Uma vez "baixado" todos os arquivos, podemos iniciar a instalação. A instalação segue uma sequencia lógica e de pré-requisitos. Seguiremos da base do ambiente, a aplicação final.

Instalando o Apache 1.3.29

A Instalação do Apache é fácil, primeiro execute o arquivo de instalação (apache_1.3.29-win32-x86-no_src.exe) e em seguida siga os passos descritos a seguir:

1. Na janela de boas vindas pressione [Next];

2. Em seguida aceite a licença de uso e pressionar [Next];

3. Pressione novamente [Next] na janela intitulada "Read this First";

4. Essa janela é responsavel por ajustar o domínio onde o servidor está alocado, o nome do servidor e o e-mail do administrador. Nesse caso, como utilizaremos o sistema localmente na máquina (sem acessos externos) utilizaremos localhost para os dois primeiros campos e root@localhost para o campo de e-mail do administrador. Também é apresentado duas opções ondem pode-se escolher se o apache será executado como serviço na maquina local (para todos os usuários) ou se ele será inicializado manualmente pelo usuário que instalou. Nesse ponto podemos deixar a opção já escolhida (Run as service for All Users) para que o apache rode como serviço. Pressione novamente [Next];

5. Seleciona a opção complete (para a instalação completa do apache) e pressione o botão [Next];

6. Aparecerá uma opção para escolher o diretório de destino, pressione o botão [Change] e escolha C:\Arquivos de programas\ como destino. Pressione [Next] novamente;

7. Pressione o botão [Install];

8. a Instalação deverá decorrer normalmente até aparecer uma janela intitulada "Installation Wizard Completed".

Instalando o PHP 4.3.3

É comum instalarmos o PHP como módulo do Apache, mas nesse caso para que o MapLab consiga executa-lo, o PHP será instalado como um binário CGI. Para isso siga as seguintes instruções:

1. Copie o arquivo php-4.3.3-Win32.zip para o diretório c:\Arquivo de Programas e em seguida descompacte-o (será criado o diretório c:\Arquivos de Prograpas\php-4.3.3-win32, renomeie essa diretório para c:\Arquivos de Programas\PHP)

2. Copie todos os arquivos com extensão .dll localizados no diretório c:\Arquivo de Programas\php\dlls para o diretório c:\windows\system32 (no caso do MS Windows da série NT (Windows 2000 ou XP) para MS Windows 9x o diretório correto deve ser c:\windows\system). Caso seja solicitado alguma substituição de arquivos, escolha a opção não (obs. **NÃO SUBSTITUA NENHUM ARQUIVO!**)

3. Copie o arquivo c:\Arquivos de programas\php\php4ts.dll para o diretório c:\windows\system32

4. Copie o arquivo c:\Arquivo de Programas\php\php.exe para o diretório C:\Arquivos de programas\Apache\cgi-bin

5. Nos próximos passos o Apache será configurado para interpretar arquivos PHP. Para isso edite o arquivo C:\Arquivos de programas\Apache\conf\httpd.conf e procure pela seguinte linha:

     AddType application/x-tar .tgz
   

   Ao encontra-la, adicione logo abaixo dela a linha:

     AddType application/x-httpd-php .php .php3 .phtml
   

   Essa alteração fará com que o Apache interprete arquivos com as extensões .php, .php3 e .phtml como aplicações PHP (x-httpd-php).

6. Em seguida procure pela linha:

     #AddDescription "GZIP compressed tar archive" .tgz
   

   e adicione logo abaixo dela:

     Action application/x-httpd-php "/cgi-bin/php.exe"
   

   E essa alteração fará com que aplicações PHP (x-httpd-php) serão executadas com o binário php.exe.

7. Agora vamos configurar o Apache, para interpretar algumas extensões de arquivos index que são utilizados como primeiro arquivo a ser aberto pelo apache (default). Procure pela linha:

     DirectoryIndex index.html
   

   e altere-a para:

     DirectoryIndex index.html index.htm index.php index.phtml					
   

8. Procure pela linha:

     DocumentRoot "C:/Arquivos de programas/Apache/htdocs" 
   

   e ao encontra-la, altere-a para:

     DocumentRoot "C:/WEB"
   

9. Procure pela linha

     <Directory "C:/Arquivos de programas/Apache/htdocs"> 
   

   e também altere-a para:

     <Directory "C:/WEB">
   

   Com as duas últimas alterações (passo 8 e 9), estamos instruindo o Apache a utilizar o diretório c:\web como diretório raiz para aplicações Web.

10. Agora deve-se copiar o arquivo c:\arquivos de programas\php\php.ini-dist para c:\windows\php.ini. Esse arquivo é responsável pelas configurações pertinentes ao PHP. Em seguida edite-o e procure pela linha:

      extension_dir = "./" 
    

    para altera-la para:

      extension_dir = "c:/Arquiv~1/PHP/extensions"
    

    Agora procure pelas linhas abaixo comentadas (;) e descomente-as deixando-as assim:

      extension=php_gd2.dll
      extension=php_dbase.dll
      extension=php_curl.dll
    

    Essa alteração fará com que o PHP suporte as bibliotecas CURL, DBASE e GD, que são necessárias pelo MapLab.

    No arquivo encontra-se outras duas variáveis que devem ser alteradas: register_globals do valor Off para On e session.save_path do valor /tmp para c:/temp. Deverão ficar assim:

      register_globals = On
      session.save_path =  c:/temp
    

    e criar o diretório c:\temp

11. Agora devem ser criados os diretórios c:\web e c:\temp. No diretório c:\web crie um arquivo com o nome index.php e adicione o seguinte conteudo:

      <? phpinfo(); ?>
    

12. Por fim reinicie o Apache e em seguida acesse no seu browser o endereço http://localhost novamente para verificar se o PHP está funcionando normalmente. O que deverá aparecer é uma tela com informações referentes ao PHP.

Instalando o MapServer 4.0.1

A Instalação do MapServer é rápida e sem muitas complicações resumindo-se em 5 passos:

1. Descomprima o arquivo mapserver-4.0.1-win32-php4.3.3.zip em um diretório temporária.

2. Descomprima os seguintes arquivos .zip localizados dentro do diretório criado pelo mapserver:

     ECW_DLL.zip
     gdal.zip
     libcurl-7.10.7_dll.zip
     libpq pdfdll.zip
     xerces_dll.zip
   

   e copie todos os arquivos com extensão .dll extraidos desses arquivos compactados para o diretório c:\windows\system32;

3. Copie os arquivos php_mapscript_4.0.1.dll e php_proj.dll para o diretório c:\Arquivos de Programas\php\extensions;

4. Edite o arquivo de configurações do PHP (c:\windows\php.ini) para adicionar o suporte ao MapServer. Procure pela seção de extensões extensions adicione as seguintes linhas:

     extension=php_mapscript_4.0.1.dll 
     extension=php_proj.dll
   

5. Agora basta reiniciar o servidor Web (Apache) e pronto, já existe suporte ao MapServer no nosso Web Server.

Instalando o MapLab 2.0.1

A instalação do MapLab é mais fácil, pois basta apenas descomprimir a aplicação em um diretório e criar uma diretório temporário para armazenamento das imagens geradas dinamicamente. De qualquer forma, serão apresentados os passos necessários abaixo:

1. Primeiro descomprima o arquivo do maplab-2.0.1-release.zip no diretório c:\web\maplab, assim o diretório htdocs (onde fica a aplicação MapLab em si) deverá ficar em c:\web\maplab\htdocs;

2. crie um diretório temporário para hospedagem das imagens geradas dinamicamente em c:\web\ms_tmp;

3. Agora basta configurar o MapLab para reconhecer o diretório temporário. Acesse http://localhost/maplab/htdocs e escolha no Menu Configuration a opção Open XML Configuration Tools e altere a variável tmp_img_path para o valor c:/web/ms_tmp e pressione o botão [Apply];

4. Selecione a opção MapEdit e no menu MapEdit pressione o botão Open Map File. Na janela que se abre, entre no diretório tutorial do diretório corrente, selecione o arquivo tutorial.map e pressione o botão [Open]. Na árvore ao lado esquerdo (Object Browser) selecione a opção Web e altere a variável ImagePath para o valor c:/web/ms_tmp/ e conclua pressionando o botão [Apply Changes].

5. Para visualizar o mapa do tutorial, no menu principal (MapEdit) pressione o botão [preview map], que abrirá uma nova janela com o mapa.

Fontes de Informação

Web Sites Oficiais:

• Apache
• MapLab
• MapServer
• PHP

• Arquivos README.txt do MapServer e MapLab encontrados dentro do pacote de instalação.