geoserver - guia de instalação em ambiente de produção

GeoserverGuia de Instalação para Ambiente de Produção

SumárioPré-Requisitos..............................................................................................................................1

Instalação.....................................................................................................................................1

Java JDK....................................................................................................................................1

JAI e JAI Image I/O....................................................................................................................2

Tomcat.....................................................................................................................................2

Geoserver.................................................................................................................................3

Pós-instalação..............................................................................................................................3

Diretório de Dados...................................................................................................................3

JAI Original...............................................................................................................................4

Logs..........................................................................................................................................4

Estratégia de Serviço................................................................................................................4

Desabilitar o que não é necessário...........................................................................................5

Pré-RequisitosPara uso neste guia, os seguintes softwares foram utilizados, nas versões informadas, todos em 32bits:

Função Software VersãoSistema Operacional Windows Server 2008 Service Pack 2

Servidor Web Apache Tomcat 6.26Java Virtual Machine (JVM) Sun Java JDK 6 update 20

Java Imaging API (JAI) JAI e JAI Image I/O 1.1.3 e 1.1 (versões JDK)

Instalação

Java JDKSiga as instruções de instalação do Java JDK. Após a instalação, será necessário configurar a variável de ambiente JAVA_HOME:

1. Vá ao Painel de Controle > Sistema > Configurações Avançadas > Variáveis de Ambiente;

2. Na opção Variáveis de Sistema, clique em Novo;

Página 1 de 5

Geoserver – Guia de Instalação para Ambiente de Produção

3. Digite JAVA_HOME como o nome da variável e como valor, digite o PATH para a pasta de instalação do JDK (provavelmente C:\Program Files\Java\jdk1.6.0_20);

4. Crie uma outra variável, chamada JRE_HOME, com o PATH para o JRE dentro da pasta do JDK (provavelmente C:\Program Files\Java\jdk1.6.0_20\jre);

5. Clique OK até fechar todas as janelas.

JAI e JAI Image I/OSomente após a instalação do Java JDK proceda com a instalação do JAI e JAI Image I/O, pois os mesmos dependem dele. A instalação deve ser feita seguindo as instruções dos instaladores, apontando o diretório JAVA_HOME (provavelmente C:\Program Files\Java\jdk1.6.0_20) e escolhendo a opção Complete quando solicitado. Deve-se instalar primeiro o JAI e depois o JAI Image I/O.

TomcatDevido a necessidades de otimização da JVM para o Tomcat, é necessário o uso do Tomcat através apenas dos scripts de inicialização, ou seja, manualmente e não permitindo o uso de serviços. Sendo assim:

1. Faça o download do arquivo ZIP Tomcat Binary e extraia o conteúdo numa pasta (Ex: D:\apache_tomcat_6.0.26), a partir de agora referenciada como TOMCAT_HOME;

2. Edite o arquivo TOMCAT_HOME\conf\server.xml.3. Localize o seguinte bloco texto, que indica a porta (8080) na qual o Tomcat irá

responder as suas requisições:

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />

4. Configure o número de requests que o Tomcat permitirá executar paralelamente através das seguintes modificações no bloco de texto:

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" maxThreads=”20” minSpareThreads=”20”/>

5. Salve e feche o arquivo;6. Abra edite o arquivo TOMCAT_HOME\conf\tomcat-users.xml;7. Antes da tag </tomcat-users>, adicione o seguinte bloco de texto, mudando os

atributos username e password para os que você desejar;

<role rolename="manager"/><user username="admin" password="tomcat" roles="manager"/>

8. Salve e feche o arquivo;9. Crie uma variável de ambiente (conforme anteriormente mostrado) chamada

JAVA_OPTS com o seguinte conteúdo:

-server -Xms1600m -Xmx1600m -XX:+UseParallelOldGC -XX:+UseParallelGC -XX:NewRatio=2

Página 2 de 5

Parâmetro Função-server Habilitando o modo JVM server-Xms1600m –Xmx1600m Otimizando assim o consumo de memória (no Windows, esse

valor não pode ser maior que 1600MB. No Linux é recomendado até 2048MB.

-XX:+UseParallelGC-XX:+UseParallelOldGC

Habilita o Garbage Collection Java em modo multithread

-XX:NewRatio=2 Informe à JVM que haverá uma grande quantidade de objetos com vida curta.

10. Para utilizar o Tomcat, vá em TOMCAT_HOME\bin e use o startup.bat para executá-lo e o shutdown.bat para fechá-lo;

11. Configure o Manager para permitir o envio de arquivos maiores que 52MB (como o do Geoserver), editando o arquivo \webapps\manager\WEB-INF\web.xml, alterando para:

<multipart-config>

<max-file-size>62914560</max-file-size> <max-request-size>62914560</max-request-size> <file-size-threshold>0</file-size-threshold></multipart-config>

12. Salve o arquivo e reinicie o Tomcat.

GeoserverA versão do Geoserver a ser instalada é a 2.0.1 Web Archive, necessária para uso com o Tomcat, instalada da seguinte forma:

1. Extraia o arquivo geoserver.war do arquivo geoserver-2.0.1-war.zip.2. Vá para o site do Tomcat, em http://localhost:8080 e clique no link Tomcat Manager. 3. Insira o usuário e senha de administração criados por você durante a instalação.4. Na sessão Deploy > WAR file to deploy, clique no botão browse e escolha o arquivo

geoserver.war.5. Clique no botão Deploy para que o Tomcat inicie a instalação do Geoserver.6. Após a instalação, a tela será atualizada e na sessão Applications, você verá o

Geoserver instalado no Path /geoserver, ou seja, http://localhost:8080/geoserver.7. Teste o endereço e faça o login como admin/geoserver.

Pós-instalaçãoApós a confirmação do funcionamento do Geoserver no Tomcat, alguns ajustes devem ser feitos para o melhor funcionamento e performance do servidor. Para melhor entendimento, vamos estabelecer os seguintes alias das pastas como elas encontram-se após a instalação:

Alias Path real

JAVA_HOME C:\Program Files\Java\jdk1.6.0_20JRE_HOME C:\Program Files\Java\jdk1.6.0_20\jreTOMCAT_HOME D:\apache_tomcat_6.0.26GEOSERVER_HOME TOMCAT_HOME\ webapps\geoserver\GEOSERVER_DATA_DIR GEOSERVER_HOME\data

Página 3 de 5

Diretório de DadosO diretório de dados (GEOSERVER_DATA_DIR) é onde o Geoserver salva seus dados, como layers, shapefiles, imagens, estilos SLD, etc. É ideal movê-lo para outro local, pois o local padrão é dentro da pasta geoserver no PATH de instalação do Tomcat, o que não é ideal nem para administração nem para a melhor performance do servidor. Para movê-lo:

1. Crie em outro local uma pasta chamada GeoserverData (Ex: D:\GeoserverData);2. Copie o conteúdo da pasta data atual (GEOSERVER_DATA_DIR) do Geoserver para a

pasta GeoserverData;3. Edite o arquivo web.xml que encontra-se em GEOSERVER_HOME\WEB-INF.4. Localize o seguinte bloco de texto comentado:



5. Remova o comentário e coloque como <param-value> o path para a pasta GeoserverData. O resultado deve ficar desta forma:

<context-param><param-name>GEOSERVER_DATA_DIR</param-name>

<param-value>D:\GeoserverData</param-value> </context-param>

6. Salve o arquivo e reinicie o Geoserver através da interface de administração do Tomcat Manager.

JAI Original Uma vez que você instalou o JAI e JAI Image I/O, o JAI original do Geoserver não é mais necessário. Para removê-lo:

1. Vá ao diretório GEOSERVER_HOME\WEB-INF\lib;2. Localize os seguintes arquivos e apague-os (onde x.y.z são os número da versão do JAI

original):a. jai_core-x.y.z.jarb. jai_imageio-x.y.z.jarc. jai_codec-x.y.z.jar

3. No painel de aplicação do Tomcat Manager, reinicie o Geoserver;

LogsNum ambiente de produção, a geração de logs detalhados do funcionamento do Geoserver pode comprometer a performance do mesmo. Esses detalhes são necessários apenas durante as atividades de rastreamento de problemas. Sendo assim, é recomendado mudar os logs para modo PRODUCTION, da seguinte forma:

1. Acesse a interface de administração do Geoserver como admin;2. Escolha a opção Global Settings no menu Server;3. Em Logging Profile, escolha PRODUCTION_LOGGING.properties;

Página 4 de 5


4. Clique em Submit para salvar;5. Essas configurações podem ser mudadas a qualquer momento para o melhor

rastreamento de problemas.

Estratégia de ServiçoEntende-se por estratégia de serviço o método no qual é provido o retorno dos dados ao cliente. Deve existir um balanço entre o funcionamento normal (exibição de erros em todas as mensagens, etc.) e velocidade (envio dos dados o mais rápido possível ao cliente). Estas configurações devem ser feitas no arquivo GEOSERVER_HOME\WEB-INF\web.xml, usando uma das opções abaixo, de acordo com a situação:

Estratégia DescriçãoSPEED

(modo default)Responde o mais rápido possível ao usuário, porém omitindo a descrição completa do erro.

BUFFER Armazena na memória a resposta ao usuário antes de enviá-la, garantindo assim a completa descrição do problema, porém atrasa o envio da resposta e se for muito extensa, pode consumir a memória disponível.

FILE Similar ao BUFFER, porém armazena num arquivo no disco a resposta ao invés da memória. É mais lento que o BUFFER, porém não haverá problema de consumo de memória.

PARTIAL-BUFFER2 Meio termo entre BUFFER e SPEED, armazenando em memória apenas alguns KB da resposta e só depois entrega a resposta completa ao cliente. Isto permite descobrir boa parte dos erros antecipadamente.

Desabilitar o que não é necessárioO Geoserver permite que você utilize os serviços WMS, WFS, WFS-T e WCS. Para poupar recursos, desabilite aqueles que você não utilizará, através da interface de administração do Geoserver. Recomenda-se:

Desabilitar o WCS; Habilite apenas o WFS Read-Only (Service Level Basic);

Página 5 de 5

geoserver - guia de instalação em ambiente de produção

Documents