Lads: /* Conclusão */

2010-02-22T08:52:46Z

Conclusão

Lutra at 11:28, 21 February 2010

2010-02-21T11:28:49Z

Lads: Guia de instalação do Geoserver com ligação à base de dados espacial Oracle no sistema operativo Microsoft Windows.

2010-02-21T11:07:07Z

Guia de instalação do Geoserver com ligação à base de dados espacial Oracle no sistema operativo Microsoft Windows.

New page

=Introdução=

Este guia explica como instalar o servidor de mapas [http://geoserver.org Geoserver] no sistema operativo [http://en.wikipedia.org/wiki/Microsoft_windows Microsoft Windows] com acesso ao Sistema Gestor de Base de Dados (SGDB) espacial [http://en.wikipedia.org/wiki/Oracle_Corporation Oracle].

O Geoserver é um programa de código aberto que serve mapas e informação espacial segundo os protocolos padrão [http://en.wikipedia.org/wiki/Web_map_service Web Map Service (WMS)] e [http://en.wikipedia.org/wiki/Web_Feature_Service Web Feature Service (WFS)], suportando igualmente o protocolo WFS-Transactional (WFS-T) que permite a manipulação persistente da informação.

O Geoserver contém de origem o código necessário para aceder a uma base de dados PostGIS, no entanto para aceder a uma base de dados espacial Oracle é necessário instala à posteriori um módulo para este efeito. No sítio do Geoserver existe uma página em língua inglesa dedicada ao assunto.

Este guia foi testado com as versões 9.2i e 11g do SGBD Oracle sobre as versões XP Pro e Server 2003 do sistema operativo Microsoft Windows sempre com a versão 1.7.6 do Geoserver. Deverá no entanto funcionar com versões posteriores do Geoserver.

Assume-se que o Oracle foi previamente instalado no sistema operativo e está a funcionar correctamente, contendo pelo menos um esquema com informação espacial.

'''Nota''': não é aconselhável a instalação da versão 11g do Oracle sobre o Windows XP, quer por dificuldades técnicas quer por elevada carga no sistema.

=Instalar Sun JDK=

Antes de mais há que instalar o [http://en.wikipedia.org/wiki/Java_Development_Kit Java Development Kit (JDK)], para que o Geoserver possa funcionar. Durante a sua instalação o Oracle instala a Máquina Virtual do Java, mas este pacote não é suficiente. Terá que aceder ao [http://java.sun.com/javase/downloads/index.jsp sítio da Sun] e descarregar o instalador da última versão do JDK.

Corra o instalador, bastando indicar qual o directório de instalação do JDK.

Com a instalação concluída é necessário criar uma variável de sistema indicando o caminho para o directório de instalação. Para tal aceda a:

<pre>Start –> Control Panel → System → Advanced → Environment Variables </pre>

Na secção System variables carregue em New. Aparece um formulário para criar uma nova variável de sistema; insira “JAVA_HOME” no campo ''name'' e o caminho para o directório de instalação do JDK (e.g. C:\Sun\JDK) no campo ''value''.

=Instalar Geoserver=

Aceda ao sítio do Geoserver e descarregue o instalador para o Microsoft Windows. Corra o instalador tendo o cuidado de indicar o directório de instalação do JDK.

Terminada a instalação verifique que foi criada a variável de sistema “GEOSERVER_DATA_DIR” acedendo novamente a:

<pre>Start –> Control Panel → System → Advanced → Environment Variables </pre>

Caso esta variável não existe crie-a apontando para o directório de dados do Geoserver. Por defeito este directório é criado sob o ponto de instalação do Geoserver em:

<pre>GeoServer 1.7.6\data_dir</pre>

Poderá agora iniciar o Geoserver, para tal acedendo a:

<pre>Start → All Programs → Geoserver 1.7.6 → Start Geoserver</pre>

Por fim abra um navegador de internet e aceda ao endereço:

<pre>http://localhost:8080/Geoserver</pre>

=Mudar porto do Geoserver=

O Geoserver é servido por um servidor internet chamado [http://en.wikipedia.org/wiki/Jetty_(web_server) Jetty] que por defeito é instalado no porto 8080; é no entanto possível que já exista alguma aplicação aí a correr. A versão 9.2i do Oracle corre neste porto uma aplicação chamada XDB, sendo esse o caso, o Geoserver não consegue arrancar.

No entanto é possível mudar o porto em que corre o Geoserver. Para tal será necessário editar o ficheiro jetty.xml, onde se indica em que porto o Jetty deverá correr. Este ficheiro encontra-se no directório:

<pre>Geoserver 1.7.6\etc\jetty.xml</pre>

Neste ficheiro procure a linha:

<pre><Set name="port"><SystemProperty name="jetty.port" default="8080"/></Set></pre>

Altere 8080 para outro porto admissível que esteja livre, e.g. 8090. De seguida re-inicie o Geoserver:

<pre>Start → All Programs → Geoserver 1.7.6 → Stop Geoserver
Start → All Programs → Geoserver 1.7.6 → Start Geoserver</pre>

Aceda agora ao Geoserver no novo porto:

<pre>http://localhost:8090/Geoserver</pre>

'''Nota''': para saber que portos estão ocupados e por quais aplicações use o comando ''netstat -ano'' na linha de comandos do Windows.

=Instalar módulo de acesso ao Oracle=

Aceda à [http://geoserver.org/display/GEOS/Stable página de descargas do Geoserver] e descarregue o módulo de ligação ao Oracle, listado na secção ''Extensions''. Descompacte este ficheiro, o que criará um directório com um nome como ''geoserver-1.7.6-oracle-plugin''. Dentro deste novo directório deverão estar dois ficheiros de extensão ''jar'':

<pre>gt-oracle-spatial-2.5-SNAPSHOT.jar

ojdbc14.jar</pre>

O primeiro contém o código da extensão do Geoserver, o segundo contém ó código para criar ligações JDBC ao Oracle. Copie estes dois ficheiros para o directório:

<pre>GeoServer 1.7.6\webapps\geoserver\WEB-INF\lib</pre>

Por fim re-inicie o Geoserver:

<pre>Start → All Programs → Geoserver 1.7.6 → Stop Geoserver
Start → All Programs → Geoserver 1.7.6 → Start Geoserver</pre>

'''Nota''': se o ficheiro ''ojdbc.jar'' não estiver incluído no pacote que descarregou poderá usar o que se encontra no directório de instalação do Oracle “$ORACLE_HOME/jdbc/lib” ou então descarregar uma nova versão do [http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html sítio do Oracle].

=Criar ligação do Geoserver a uma base de dados Oracle=

Com o módulo de ligação ao Oracle instalado o Geoserver passa agora a listar dois novos tipos de ''Data Store'': “Oracle” e “Oracle (OCI)”. A primeira usa uma ligação JDBC, a segunda usa a OCI do Oracle; para saber mais sobre a diferença entre os dois tipos consulte a [http://geoserver.org/display/GEOSDOC/Oracle+DataStore página de apoio do Geoserver].

Para se criar uma ligação por JDBC é necessário indicar, para além das credenciais de autenticação perante o Oracle, os parâmetros da ligação. Estes parâmetros deverão ser exactamente aqueles que se encontram na definição do ''listener''. Para os conhecer com exactidão abra o ficheiro ''tnsnames.ora'' que se encontra no directório:

<pre>$ORACLE_HOME/network/admin</pre>

Este ficheiro deverá conter uma entrada semelhante a esta:

<blockquote>'''ORCL''' = 
(DESCRIPTION = 
(ADDRESS_LIST = 
(ADDRESS = (PROTOCOL = TCP)(HOST = '''10.0.2.15''')(PORT = '''1521''')) 
) 
(CONNECT_DATA = 
(SERVER = DEDICATED) 
(SERVICE_NAME = ORCL) 
) 
)</blockquote>

Os elementos importantes a reter são aqueles a negrito. No campo ''Instance'' deverá ser indicado o nome do listener, neste caso “ORCL”. No campo ''Host'' deverá ser indicado o nome do computador ou o seu ip (e.g. localhost, 127.0.0.1) neste caso será “10.0.2.15”. Por fim é necessário indicar o porto onde corre o Oracle, por defeito o 1521. Se a ligação for criada com sucesso serão listadas as tabelas da base de dados no formulário de criação de um novo ''FeatureType''.

É aconselhável indicar nos parâmetros da ligação, além destes dados e da autenticação, o esquema da base de dados a que o Geoserver se deve ligar, doutro modo serão listadas todas as tabelas de sistema na criação de um novo ''FeatureType''.

=Registar SRS no Geoserver=

É possível que na base de dados existam dados num sistema de projecção estranho ao Geoserver, o que será o caso para dados em sistemas nacionais (e.g. Datum 73, Datum Lisboa). Assim sendo será necessário dar a conhecer ao Geoserver tal sistema. É possível pedir ao Oracle o sistema de projecção em formato WKT, usando um comando como:

<pre>select * from mdsys.cs_srs where upper(cs_name) like '%PORT%';</pre>

Do resultado pode-se usar o conteúdo do campo WKTEXT para adicionar uma nova linha ao ficheiro de projecções do Geoserver, que se encontra em:

<pre>GeoServer 1.7.6\data_dir\user_projections\epsg.properties</pre>

Re-inicie o Geoserver e verifique que o novo SRS foi adicionado correctamente, acedendo a:

<pre>http://localhost:8080/geoserver/srsHelp.do</pre>

=Conclusão=

No fim deste guia deverá ser possível configurar FeatureTypes no Geoserver que ligam directamente a temas espaciais numa base de dados Oracle. Estes FeaturesTypes poderão ser usados com os protocolos WMS, WFS e WFS-T.

Em caso de problemas consultar a página de apoio no [http://geoserver.org/display/GEOSDOC/Oracle+DataStore sítio do Geoserver].

← Older revision		Revision as of 11:28, 21 February 2010
Line 131:		Line 131:

	Em caso de problemas consultar a página de apoio no [http://geoserver.org/display/GEOSDOC/Oracle+DataStore sítio do Geoserver].		Em caso de problemas consultar a página de apoio no [http://geoserver.org/display/GEOSDOC/Oracle+DataStore sítio do Geoserver].
		+
		+	[[category: Portugal]]

@@ Line 128: / Line 128: @@
 =Conclusão=
-No fim deste guia deverá ser possível configurar FeatureTypes no Geoserver que ligam directamente a temas espaciais numa base de dados Oracle. Estes FeaturesTypes poderão ser usados com os protocolos WMS, WFS e WFS-T.
+No fim deste guia deverá ser possível configurar ''FeatureTypes'' no Geoserver que ligam directamente a temas espaciais numa base de dados Oracle. Estes ''FeaturesTypes'' poderão ser usados com os protocolos WMS, WFS e WFS-T.
 Em caso de problemas consultar a página de apoio no [http://geoserver.org/display/GEOSDOC/Oracle+DataStore sítio do Geoserver].
 [[category: Portugal]]

Instalar Geoserver com Oracle em Windows - Revision history

Lads: /* Conclusão */

Lutra at 11:28, 21 February 2010

Lads: Guia de instalação do Geoserver com ligação à base de dados espacial Oracle no sistema operativo Microsoft Windows.