Geoserver

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

Sumário
Pré-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é-Requisitos
Para uso neste guia, os seguintes softwares foram utilizados, nas versões informadas, todos
em 32bits:

Função Software Versão

Sistema Operacional Windows Server 2008 Service Pack 2
Servidor Web Apache Tomcat 6.26
Java 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 JDK
Siga 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/O

Somente 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.

Tomcat
Devido 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
 Geoserver – Guia de Instalaçã o para Ambiente de Produçã o

Parâmetro
-server
-Xms1600m –Xmx1600m
-XX:+UseParallelGC
-XX:+UseParallelOldGC
-XX:NewRatio=2
Função
Habilitando o modo JVM server
Otimizando assim o consumo de memória (no Windows, esse
valor não pode ser maior que 1600MB. No Linux é
recomendado até 2048MB.
Habilita o Garbage Collection Java em modo multithread
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>
<!-- 60MB max -->
<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.

Geoserver
A 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ção
Apó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_20
JRE_HOME C:\Program Files\Java\jdk1.6.0_20\jre
TOMCAT_HOME D:\apache_tomcat_6.0.26
GEOSERVER_HOME TOMCAT_HOME\ webapps\geoserver\
GEOSERVER_DATA_DIR GEOSERVER_HOME\data

Página 3 de 5
 Geoserver – Guia de Instalaçã o para Ambiente de Produçã o

Diretório de Dados
O 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:
<!--
<context-param>
<param-name>GEOSERVER_DATA_DIR</param-name>
<param-value>
C:\eclipse\workspace\geoserver_trunk\cite\confCiteWFSPostGIS</param
-value>
</context-param>
-->

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.jar
b. jai_imageio-x.y.z.jar
c. jai_codec-x.y.z.jar
3. No painel de aplicação do Tomcat Manager, reinicie o Geoserver;

Logs
Num 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;

Página 4 de 5
 Geoserver – Guia de Instalaçã o para Ambiente de Produçã o

3. Em Logging Profile, escolha PRODUCTION_LOGGING.properties;

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ço
Entende-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ção
SPEED Responde o mais rápido possível ao usuário, porém omitindo a descrição
(modo default) 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ário

O 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