====== Configurando o Apache para rodar os aplicativos CGI do TerraOGC ======






===== Apache 2 =====

Dependendo da distribuição do Apache (Linux ou Windows) pode variar um pouco onde colocar essas configurações. Normalmente no ''httpd.conf'' ou um arquivo próprio incluído pelo Apache em tempo de carga.\\ 

* Configuração: <code apache>
SetEnv LD_LIBRARY_PATH /home/emerson/projetos/terraogc/lib
 
ScriptAlias /teogc/ "/home/emerson/projetos/terraogc/bin/"
<Directory "/home/emerson/projetos/terraogc/bin">
  Options +ExecCGI
  Order allow,deny
  Allow from all
</Directory>
</code>
  * Troque a pasta ''/home/emerson/projetos/terraogc'' pelo caminho onde o TerraOGC está instalado.
  * Os executáveis ficam acessíveis pelo servidor através do caminho [[http://nome_do_host/teogc/]]. Para o WMSCGI é [[http://nome_do_host/teogc/terraogcwms.cgi]]
  * Para ambientes de produção evite usar o LD_LIBRARY_PATH. Coloque os SOs (shared-objects) ou DLLs no ''ldconfig'' ou ''PATH'' para melhorar a performance.
  * Adicionar ''SetEnv LANG pt_BR.UTF-8'' pode ajudar **e muito** no caso de sistemas com UTF-8 por default.







===== Configurando os aplicativos =====
  * Todos os aplicativos TerraOGC precisam de um arquivo de configuração
  * A pasta do SVN ''terraogc/examples/xml/tecfg/'' contém exemplos de arquivos de configuração para os aplicativos CGI: WMS, WFS, WCS, CSW, entre outros
  * Copie esses arquivos para as pastas dos binários e configure de acordo com suas necessidades
  * A configuração consiste inicialmente em configurar os bancos TerraLib usados, a partir da seção **TeDataSource**
  * A unidade básica a ser usada é a **Vista**. Se nenhuma vista for usada, o programa pode enviar uma exceção.
  * Dentro da Vista, ainda é possível especificar quais **Temas** serão servidos. Se nenhum tema é especificado, todos serão considerados.
  * Num Tema, é possível associar metadados, como título, resumo, palavras-chave e links que apontam para metadados. Essas configurações são opcionais.





==== Exemplos ====

  - Para ativar as camadas na vista __Rondonia___WGS84, que estão no banco PostGIS (usuário: __postgres__, senha: __senha__) chamado __rondonia_apoio__ em __localhost__, deve inserir o seguinte: <code xml>
<TeDatabase id="5">
  <DBType>PostGIS</DBType>
  <Host>localhost</Host>
  <User>postgres</User>
  <Password>senha</Password>
  <DBName>rondonia_apoio</DBName>
  <TeViews>
    <TeView name="Rondonia_WGS84"/>
  </TeViews>
</TeDatabase>
</code>
  - Para disponibilizar apenas os temas __Estados__ e __Municipios__ da vista __VistaBrasil__ que encontra-se no banco MySQL em localhost (usuário: usuariobanco, senha: senhausuario):<code xml>
<TeDatabase id="2">
  <DBType>MySQL</DBType>
  <Host>localhost</Host>
  <User>usuariobanco</User>
  <Password>senhausuario</Password>
  <DBName>banco2</DBName>
  <TeViews>
    <TeView name="VistaBrasil">
      <TeTheme name="Estados"/>
      <TeTheme name="Municipios"/>
    </TeView>
  </TeViews>
</TeDatabase>
</code>
  - Mesmo exemplo anterior, só que acrescentando metadados ao tema Municipios: <code xml>
<TeDatabase id="2">
  <DBType>MySQL</DBType>
  <Host>localhost</Host>
  <User>usuariobanco</User>
  <Password>senhausuario</Password>
  <DBName>banco2</DBName>
  <TeViews>
    <TeView name="Vista_Brasil">
      <TeTheme name="Estados"/>
      <TeTheme name="Municipios">
        <Title>Municipios do Brasil</Title>
        <Abstract>Dados sobre os municipios brasileiros atualizados em 2006</Abstract>
        <Keywords>
          <Keyword>Brasil</Keyword>
          <Keyword>Municipios</Keyword>
        </Keywords>
        <MetadataURL format="text/html" type="FGDC">http://www.ibge.gov.br</MetadataURL>
      </TeTheme>
    </TeView>
  </TeViews>
</TeDatabase>
</code>