ERDAS APOLLO Administrator's Guide

575 Pages·2011·7.12 MB·English

ERDAS APOLLO
Administrator’s Guide
Essentials-SDI Edition
August 2011
Copyright © 2011 ERDAS, Inc.
All rights reserved.
Printed in the United States of America.
The information contained in this document is the exclusive property of ERDAS, Inc. This work is protected under United
States copyright law and other international copyright treaties and conventions. No part of this work may be reproduced
or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, or by any
information storage or retrieval system, except as expressly permitted in writing by ERDAS, Inc. All requests should be
sent to the attention of:
Manager, Technical Documentation
ERDAS, Inc.
5051 Peachtree Corners Circle
Suite 100
Norcross, GA 30092-2500 USA.
The information contained in this document is subject to change without notice.
Government Reserved Rights. MrSID technology incorporated in the Software was developed in part through a project
at the Los Alamos National Laboratory, funded by the U.S. Government, managed under contract by the University of
California (University), and is under exclusive commercial license to LizardTech, Inc. It is used under license from
LizardTech. MrSID is protected by U.S. Patent No. 5,710,835. Foreign patents pending. The U.S. Government and the
University have reserved rights in MrSID technology, including without limitation: (a) The U.S. Government has a non-
exclusive, nontransferable, irrevocable, paid-up license to practice or have practiced throughout the world, for or on
behalf of the United States, inventions covered by U.S. Patent No. 5,710,835 and has other rights under 35 U.S.C. §
200-212 and applicable implementing regulations; (b) If LizardTech's rights in the MrSID Technology terminate during
the term of this Agreement, you may continue to use the Software. Any provisions of this license which could reasonably
be deemed to do so would then protect the University and/or the U.S. Government; and (c) The University has no
obligation to furnish any know-how, technical assistance, or technical data to users of MrSID software and makes no
warranty or representation as to the validity of U.S. Patent 5,710,835 nor that the MrSID Software will not infringe any
patent or other proprietary right. For further information about these provisions, contact LizardTech, 1008 Western Ave.,
Suite 200, Seattle, WA 98104.
ERDAS, ERDAS IMAGINE, Stereo Analyst, IMAGINE Essentials, IMAGINE Advantage, IMAGINE, Professional,
IMAGINE VirtualGIS, Mapcomposer, Viewfinder, and Imagizer are registered trademarks of ERDAS, Inc.
Other companies and products mentioned herein are trademarks or registered trademarks of their respective owners.
Table of Contents
Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .iii
List of Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
List of Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Configuration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
The Services Framework Architecture . . . . . . . . . . . . . . . . . . . . 1
Framework Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Scalable J2EE Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
ERDAS Servlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Connectors and Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Databases, Flat Files, and Imagery . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Basic Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Servlet Engine Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Actual Servlet Level Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Data Level Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Geographic Information and Transactional Configuration . . . . . . . . . . . 5
Additional Configuration Steps . . . . . . . . . . . . . . . . . . . . . . . . . 6
Service Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Configuration Methodology. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Data services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Provider Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Configuring a Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Steps to configure a Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Sample providers.fac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
How to Control the Provider Configuration . . . . . . . . . . . . . . . . . . . . . . 11
Catalog service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Deployment and Administration of the Server . . . . . . . . . . . . . . . . . . . 12
Environment Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Database Schema Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Security Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Logging Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Typical Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Publishing Vector Data in WFS . . . . . . . . . . . . . . . . . . . . . . . . . 21
Shapefile Provider on top of a Data Directory . . . . . . . . . . . . . . . . . . . 21
Create a Vector Provider on top of Oracle Data . . . . . . . . . . . . . . . . . . 23
Create a Transactional Provider over Oracle . . . . . . . . . . . . . . . . . . . . 24
Create a PostgreSQL/PostGIS Vector Provider . . . . . . . . . . . . . . . . . . 28
Create an ArcSDE Vector Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Create a Vector Provider on top of GML Data . . . . . . . . . . . . . . . . . . . 32
Create Styles on Vector Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Publishing Images in WMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Raster Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Table of Contents iii
Publishing Raster Data in WCS . . . . . . . . . . . . . . . . . . . . . . . . . 35
Simple Coverage Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Mosaic and List Coverage Services . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
ArcSDE-Raster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Populate, Browse and Query the Catalog . . . . . . . . . . . . . . . . . 41
Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Publish a service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Data Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Using the CSW endpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Assembling Services and Combining Data . . . . . . . . . . . . . . . . 44
Pyramid WMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Cascading with an OpenGIS WMS Context . . . . . . . . . . . . . . . . . . . . . 45
Chaining Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Proxying a OpenGIS-compliant WMS . . . . . . . . . . . . . . . . . . . . . . . . . 45
Proxying a OpenGIS-compliant WFS . . . . . . . . . . . . . . . . . . . . . . . . . . 46
SLD Portrayal Service for Features and Coverages . . . . . . . . . . . . . . 47
Producing Smart Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
WMS by Portraying Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Map Dressing Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Advanced Portrayal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Add a Legend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Sample WFS Requests with Filters . . . . . . . . . . . . . . . . . . . . . . 51
Filter by FeatureID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Filter Equal to an Alphanumeric Property . . . . . . . . . . . . . . . . . . . . . . . 52
Filter Equal with Namespaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Filter on Two Alphanumeric Properties . . . . . . . . . . . . . . . . . . . . . . . . 54
Geometry Filter: Operator BBOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Geometry Filter: Operator Intersects with a Given Polygon . . . . . . . . . 56
Geometry Filter: Operator Beyond a Given Point . . . . . . . . . . . . . . . . . 58
Filter combining Spatial and Non-Spatial Operators . . . . . . . . . . . . . . 60
Manage Data and Enhance Services . . . . . . . . . . . . . . . . . . . . . . . . . 63
Restrict Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Disable Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Hiding Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Disable Output Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Add a Copyright or Watermark . . . . . . . . . . . . . . . . . . . . . . . . . 65
Add a CRS to WCS GIO Decoder Framework. . . . . . . . . . . . . . . 66
ERDAS IMAGINE Projection Engine . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Add an EPSG Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Define a CRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Filter in a GetMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Add User Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Add a Java class Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Add a Datasource Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Set Up a WFS with GML2 Objects . . . . . . . . . . . . . . . . . . . . . . . 78
Insert Data into the Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Curves, Surfaces, Rings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Measurements, Units of Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Temporal Properties and Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
iv Table of Contents
Portrayal Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Data Portrayal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Rules and Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Rules, the Portraying Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Styles, Definition of the Look and Feel . . . . . . . . . . . . . . . . . . . . . . . . . 88
Creating Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Styles Templates Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Creating Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Deploying Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Deployment Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Using the Map Dressing Service . . . . . . . . . . . . . . . . . . . . . . . . 98
Grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
North Arrow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Scale Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Image Border . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Complete Dressing Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Displaying Statistics in a Map. . . . . . . . . . . . . . . . . . . . . . . . . 103
Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Output Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Portrayal Statistics Output Values . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Producing KML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Limitations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Fast 2D Rendering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Coverage Portrayal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Output Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Image Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Graphic Interlaced Format (GIF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Joint Photographic Experts Group (JPEG) . . . . . . . . . . . . . . . . . . . . . 109
Keyhole Markup Language (KML) . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Scalable Vector Graphics (SVG) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
GeoTIFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Portable Network Graphic (PNG) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
X-BMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
WBMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Text Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Plain Text Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
GeoRSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
JSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Data Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Shapefiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
GML 2/3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
GeoTIFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
JPEG2000, ECW, NITF, DTED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Table of Contents v
ERDAS IMG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Coordinate Transformations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
SRS Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Add a Custom SRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Projection System Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Modify epsg.plb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Create usersref.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Integrate usersref.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Modify coordinate_system_category.xml . . . . . . . . . . . . . . . . . . . . . . 130
Rebuild and Deploy the Webapps . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Test the Custom SRS in the Data Manager . . . . . . . . . . . . . . . . . . . . 131
Test the Custom SRS in the Web Client . . . . . . . . . . . . . . . . . . . . . . 131
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Usage and Syntax of the SRS/CRS Parameter . . . . . . . . . . . . 133
Administration of ERDAS APOLLO . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Types of Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Servlet-Engine Level Configuration Parameters . . . . . . . . . . . 135
Servlet-Engine Level Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Servlet-Specific Configuration Parameters (providers fac). . . 137
Parameters in the providers fac File . . . . . . . . . . . . . . . . . . . . 138
Framework Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
WMS (map) Servlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
WFS (vector) Servlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
WCS (coverage) Servlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Checks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
General Checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Performance Tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Tuning the GetMap Request . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Tuning the Data Extraction . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Tune the RDBMS configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Tuning the Database Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Tuning the Native Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Tuning Portrayal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Tuning the Raster Data Sources . . . . . . . . . . . . . . . . . . . . . . . 155
Tuning Parameters and Configuration for WCS GIO Decoders 155
global-processmanager.properties: . . . . . . . . . . . . . . . . . . . . . . . . . . 157
local-processmanager.properties: . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Tuning the Execution Environment . . . . . . . . . . . . . . . . . . . . . . . . . . 159
vi Table of Contents
Conclusions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Using Apache Ant to Rebuild the Webapps . . . . . . . . . . . . . . . . . . . . 161
Deploying WAR Files on Supported Servlet Engines . . . . . . . . . . . . . 164
JBoss. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Jakarta Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
ERDAS APOLLO Tools and Viewers. . . . . . . . . . . . . . . . . . . . . . . . . 165
Service Tester . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Customizing Service Tester Templates . . . . . . . . . . . . . . . . . . . . . . . 166
Data Indexer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Image Indexing with the Data Manager . . . . . . . . . . . . . . . . . . . . . . . 167
Coverage Indexer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Shapefile RTree Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Vector Services Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Schema Generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
From-SQL Generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
WFS Loader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Pyramid and Mosaic Builder . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Pyramid Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
WMS Tiler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Catalog Web Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Log In to the Web Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Searching and Browsing Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Advanced Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Publishing content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Testing the CSW endpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Administration options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Specifying the Storage Directories for Metadata, Thumbnails, &
Pyramids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Changing the Storage Location for Metadata Files . . . . . . . . . . . . . . 185
Changing the Storage Location for Thumbnail Files . . . . . . . . . . . . . 186
Changing the Storage Location for Pyramid Files . . . . . . . . . . . . . . . 187
General Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 191
Install Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Hiding Clear Text Passwords in Configuration Files. . . . . . . . 194
Configuration and Customization . . . . . . . . . . . . . . . . . . . . . . 199
Internationalization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
ERDAS APOLLO Web Client Configuration . . . . . . . . . . . . . . . . . . . . 204
The ERDAS APOLLO Style Editor . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Exploring Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Procedure Setting the Connection Time-out . . . . . . . . . . . . . . . . . . . 214
Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Map Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Table of Contents vii
Styling Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Brief Introduction to Styling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Managing Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Scale Range Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Rules Reference Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
“Uniform" Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Classifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
“Uniform Roads" Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Known Symbol" Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Feature Numberer" Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
HTML Report" Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Variable Markers" Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Patterner" Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Symbol Roller" Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
Common Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
FAQ/Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
Rebuilding the Webapps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Deploying WAR Files on Supported Servlet Engines . . . . . . . . . . . . . 326
JBoss. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
Jakarta Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
Detailed Parameters of a Provider . . . . . . . . . . . . . . . . . . . . . . . . . . 327
Lists of Possible Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . 327
Parameters Common to All Types of Providers . . . . . . . . . . . 327
Parameters for the Map Framework. . . . . . . . . . . . . . . . . . . . . 330
Parameters for Vector Providers (WFS Servlet) . . . . . . . . . . . 335
Parameters for the Coverage Framework . . . . . . . . . . . . . . . . 339
Provider Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
WFS - or Vector - Connectors . . . . . . . . . . . . . . . . . . . . . . . . . 345
Oracle Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Oracle JDBC Thin Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Oracle JDBC OCI Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Differences between Oracle OCI and Thin Driver . . . . . . . . . . . . . . . 348
Oracle RAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
PostgreSQL/PostGIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
Shapefiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
ArcSDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
DBF Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
Microsoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
ODBC data source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
MS-Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
viii Table of Contents
SQLServer 2008 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
GML and GML-T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
DGN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Proxy WFS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Simple Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
WMS - or Raster - Connectors. . . . . . . . . . . . . . . . . . . . . . . . . 369
Simple Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Image Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Multiple Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Proxy WMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Map Dressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
Pyramid Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
Portray Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
ArcSDE-Raster Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
Context Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
Oracle 10g GeoRaster Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
WCS - or Coverage - Connectors. . . . . . . . . . . . . . . . . . . . . . . 385
Simple Coverage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Indexed Coverages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
Multi Simple Coverages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
Hierarchical Coverages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Oracle 10g GeoRaster Coverages . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
HDF-EOS Coverages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
Pyramid Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
GML Application Schema and Mapping to Databases . . . . . . . . . . . . 399
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Key Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
Application Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
GML Application Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Feature and Feature Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Configuration Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Feature Schema Configuration . . . . . . . . . . . . . . . . . . . . . . . . 404
GML Application Schema Construction . . . . . . . . . . . . . . . . . . . . . . . 405
The Steps to Construct the Feature Type Schema . . . . . . . . . . . . . . 405
Feature Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
Mapping Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
Mapping Methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
Mapping Tags Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
Explicit Mapping Definition Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
SQL Mapping Definition Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Automatic Mapping Definition Steps . . . . . . . . . . . . . . . . . . . . . . . . . 415
Relational (Explicit) Mapping Definition Steps . . . . . . . . . . . . . . . . . . 417
Mapping of Enumerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
How to Control Mapping Correctness . . . . . . . . . . . . . . . . . . . . . . . . 434
Moving to GML3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
ERDAS APOLLO support of GML3 . . . . . . . . . . . . . . . . . . . . . . . . . . 434
GML3 Concepts and Schemas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
Setting Up a ERDAS WFS Serving GML3 . . . . . . . . . . . . . . . . . . . . . 435
Migrating a GML2 WFS to GML3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
Table of Contents ix
Setting Up a ERDAS WFS Serving GML-SF (Simple Feature) . . . . . 437
Feature Mapping Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
Mapping Section <MAPPING> . . . . . . . . . . . . . . . . . . . . . . . . . 438
Metadata Section <INFO> . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
Capabilities Feature Type Section: <EXPORT> . . . . . . . . . . . . 450
Collection Section: <COLLECTION> . . . . . . . . . . . . . . . . . . . . 450
Options Section: <OPTION> . . . . . . . . . . . . . . . . . . . . . . . . . . 451
User Functions Section: <UserFunction> . . . . . . . . . . . . . . . . 455
Units Definition Section: <UnitDefinition> . . . . . . . . . . . . . . . 455
Units Association Section: <UnitAssociation> . . . . . . . . . . . . 456
WMS Layer Hierarchy Section: <WMS> . . . . . . . . . . . . . . . . . . 456
Coverage and Image Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
Image Server Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
Image Provider Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
Configuring Individual Coverages/Images . . . . . . . . . . . . . . . 459
Configuring a Mosaic or a list of Coverages/Images. . . . . . . . 461
Image Layers Index File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
The Image Data Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
The HDR File Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
The World Coordinate File Organization . . . . . . . . . . . . . . . . . . . . . . 467
The Color File Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
Header Files Summary Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
USGS Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Limitations and Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Imagery Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
The GDAL Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
GDAL Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
GDAL Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
Very Large Coverage Manager . . . . . . . . . . . . . . . . . . . . . . . . 481
Very Large Coverage Management Description . . . . . . . . . . . . . . . . 481
Very Large Image Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
Temporary Files Can Be Very Big . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
Advanced Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
Metadata URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
Metadata Configuration in the WMS and WCS Servlets . . . . . . . . . . 493
Metadata Configuration in the WFS Servlet . . . . . . . . . . . . . . . . . . . . 494
Legend URL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
x Table of Contents