:Author: OSGeo-Live :Author: Stephan Meissl, Stephan Krause :Reviewer: Angelos Tzotsos :Version: osgeo-live7.0 :License: Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0) .. image:: ../../images/project_logos/logo-eoxserver-2.png :scale: 65 % :alt: project logo :align: right :target: http://eoxserver.org/ ================================================================================ EOxServer Quickstart ================================================================================ Overview -------- EOxServer is a server for presenting big Earth Observation (EO) data archives and metadata via Open Standards. It builds upon an Open Source stack of software which includes Python, :doc:`MapServer <../overview/mapserver_overview>`, Django/GeoDjango, :doc:`GDAL <../overview/gdal_overview>`, PROJ.4 and a :doc:`SpatiaLite <../overview/spatialite_overview>` or :doc:`PostGIS <../overview/postgis_overview>` database. This Quick Start describes how to: * View, filter, subset, and download EO data via EOxServer's Web Client * Register EO data archives via EOxServer's Admin Client .. contents:: Contents See the :doc:`EOxServer Overview <../overview/eoxserver_overview>`, the `local EOxServer documentation <../../eoxserver-docs/EOxServer_documentation.pdf>`_, or the `online EOxServer documentation `_ for more information. .. image:: ../../images/screenshots/1024x768/eoxserver_documentation.png :scale: 50 % :alt: EOxServer documentation Demonstration Instance ---------------------- .. Commented since Tomcat isn't started automatically anymore (#1032). In case you use OSGeoLive with 1GB RAM or less it is recommended to stop default Tomcat service before launching EOxServer :: sudo service tomcat6 stop The icon labeled `EOxServer` filed under `Web Services` launches a browser showing the demonstration instance available at http://localhost/eoxserver/ which provides the same data as the `one available online `_. .. image:: ../../images/screenshots/1024x768/eoxserver_start.png :scale: 50 % :alt: EOxServer demonstration start Web Client ~~~~~~~~~~ The **Web Client** link allows you to see a list of available `Dataset Series` and `Stitched Mosaics`. The demonstration has one `Dataset Series` configured named "MER FRS 1P RGB reduced" holding three ENVISAT MERIS scenes. Please refer to the `online demonstration documentation `_ for more information on the available data. .. image:: ../../images/screenshots/1024x768/eoxserver_webclient1.png :scale: 50 % :alt: EOxServer demonstration embedded client dataset series selection Selecting a list entry provides you with a map view showing the outlines of the available `Datasets`. .. image:: ../../images/screenshots/1024x768/eoxserver_webclient2.png :scale: 50 % :alt: EOxServer demonstration embedded client outlines Using the standard OpenLayers controls you can enable also previews of the available data. Click on the **(+** on the upper right side of the window to get a later selection listing; to zoom either use the mouse wheel or hold down the shift key while left-click dragging a box on the map canvas. .. image:: ../../images/screenshots/1024x768/eoxserver_screenshot.png :scale: 50 % :alt: EOxServer demonstration embedded client outlines and previews With the **Date slider** the `Datasets` shown can be limited to the time interval of interest. .. image:: ../../images/screenshots/1024x768/eoxserver_webclient3.png :scale: 50 % :alt: EOxServer demonstration embedded client date change The **Download** button provides you a list of downloadable `Datasets`. Downloadable means within the set Bounding Box or currently viewn map extent if not set and the set time interval. You can select which `Datasets` to download in which size, projection, format, and band subset. .. image:: ../../images/screenshots/1024x768/eoxserver_webclient4.png :scale: 50 % :alt: EOxServer demonstration embedded client download selection **Start Download** initiates the actual download which might result in multiple files if multiple `Datasets` have been selected. .. image:: ../../images/screenshots/1024x768/eoxserver_webclient5.png :scale: 50 % :alt: EOxServer demonstration embedded client download Admin Client ~~~~~~~~~~~~ The **Admin Client** link brings you to the login page for the `Admin Client`. The password for the user `admin` is `admin`. .. image:: ../../images/screenshots/1024x768/eoxserver_adminclient1.png :scale: 50 % :alt: EOxServer demonstration admin client login The `Admin Client` is Djangos standard admin and allows you to configure the available data. Please feel free to explore the client. More information can be found in the `operators' guide `_. .. image:: ../../images/screenshots/1024x768/eoxserver_adminclient2.png :scale: 50 % :alt: EOxServer demonstration admin client start It is for example possible to view and alter the `EO Metadata Entries` of the configured `Dataset Series`. .. image:: ../../images/screenshots/1024x768/eoxserver_adminclient3.png :scale: 50 % :alt: EOxServer demonstration admin client EO Metadata Log Viewer ~~~~~~~~~~ The **Log Viewer** link provides an easy way to view the latest log entries. .. image:: ../../images/screenshots/1024x768/eoxserver_logviewer.png :scale: 50 % :alt: EOxServer demonstration log viewer What Next? ---------- This is a simple demonstration, but you can do much more with EOxServer. The project website contains a lot of resources to help you get started. Here’s a few resources to check out next: * Read the `EOxServer Operators' Guide `_. * Read the complete `EOxServer Users' documentation `_ starting from the `EOxServer Basics `_. * Ready to use EOxServer? Then join the community on the `mailing lists `_ to exchange ideas, discuss potential software improvements, and ask questions.