WCS Wrapper Installation LinuxOP

Back to WCS Wrapper

Project on SourceForge

Questions and comments should go to sourceforge discussions, bug reports to sourceforge tickets. Urgent issues can be asked from Kari Hoijarvi 314-935-6099(w) or 314-843-6436(h)

Last updated 2010-12-13

Install as Root

While it's technically possible to install this package as an ordinary user, we recommend installing the shared libraries as an administrator.

Things to Consider About Security

The web.py framework and WCS service code has been written with security in mind, and there are no known security bugs. There is no code that writes on the disk, so running this service should not put your computer in danger.

To maximize the security of your computer, consider the following.

• Every file in every directory you put under OWS/web/static becomes readable by anybody. This is by design, since the whole framework is meant to publish public data. Do not put confidential information under OWS folder!

• Don't run the process as root. Create a low-rights account like WCS_RUNNER and use that.

Installation on a Linux workstation or server:

THIS PAGE IS BADLY OUT OF DATE AND NEEDS TO BE REWRITTEN

notes/before you begin

• this package has been tested with Python 2.5 and should also run on version 2.6 without problems, 3.x is not supported yet
• system-wide installation of packages will require root access to the system
  • it is theoretically possible to install all packages to a user directory, but it might be somewhat tricky and will not be covered here
• for installation of 3rd party python packages it is recommended to use easy_install
  • download the installer file matching your Python version and execute it on a shell as instructed
• 3rd party packages will receive updates over time. the last tested version of every package is noted below
• all required packages except for PyNIO can be installed via easy_install, so don't bother to download them in advance
• unfortunately you will have to jump through some hoops for PyNIO. check out the PyNIO/NGL download page for instructions on how to obtain and install it

required 3rd party software

You have to install the packages listed below first in order to run the OWS server. Use easy_install for all except PyNIO (see above)

• webpy (0.32)
• lxml (2.2.2)
  • might require additional development/header packages to be installed on your system (python-dev, libxml2-dev, libxslt1-dev, zlib1g-dev on Debian)
• NumPy (1.3.0)
  • you should have a fortran compiler installed for that, for example gfortran on Debian
• WsgiLog (0.1) (optional, only if you want to log webpy output to a file)
• PyNIO (1.3.0b1)
  • 1.3.0b1 depends on libgfortran1 which is not part of debian stable/testing any more, you will have to pull it from oldstable (http://mirrors.kernel.org/debian/pool/main/g/gcc-4.1/libgfortran1_4.1.1-21_i386.deb for i386) and install it manually by copying the library file to /usr/lib and running ldconfig
  • newer releases of PyNIO will hopefully depend on a more recent libgfortran2/3

install and start OWS server

• get the OWS code package for Linux
• unpack to your desired working directory, the contents of the archive will end up in ./ows
  • these instructions assume that your working directory is /usr/local/, so the package contents would end up in /usr/local/ows
• add the path of the extracted ows directory to your PYTHONPATH environment variable
  • if you followed the above example, PYTHONPATH should contain /usr/local/ows
• cd to ows/web and execute python ows.py
• a server should be running on http://localhost:8080/ now
  • a different port can be passed to the server as an argument
  • you will have to create the log directory /var/log/ows before running the server for the first time
    • • if the server is not being run as root, the user that runs it needs write access to the log dir
• you can stop the server by pressing ctrl-c in the console window
• to make the server available automatically at boot time, you can use an init script
  • an example script that starts the OWS server in a screen session as another user is available here

example installations

Debian

• typescript of installation on fresh and minimal Debian stable: http://htap.icg.fz-juelich.de/downloads/debian_typescript.txt

Creating Metadata

The metadata queries of WCS, GetCoverage and DescribeCoverage need to be precompiled.

Run the following commands:

cd /usr/local/OWS/web

python owsadmin.py wcs_prepare -o testprovider

or for all:

python owsadmin.py wcs_prepare -ao

-o is for optimize, -a prepares every provider

it will create file /usr/local/ows/web/static/testprovider/metadata.dat.

Try now test queries GetCapabilities and DescribeCoverage CubeA

Press ctrl+C to terminate the server. Although this server is intended for development and debugging only, you can use it to server data from your own workstation just fine. For high load sites, look webpy.org/install documentation how to set up a high load site.

Notice: WCS core functions are written in C/C++, enabling large amount of data delivery. Python is used only for query parsing, making minimal impact in speed.

The server returns a short XML document, which contains a link into the query result, you can download it by copying the url to your browser.

index.html Pages

If no query is present, the server gives a default page index.html. You should provide pages for your server and for all the providers.

The server is at /usr/local/ows/web/static/index.html, which will be displayed from url http://localhost:8080/

Every provider can have an own index.html like /usr/local/ows/web/static/testprovider/index.html which will be displayed from http://localhost:8080/testprovider

If you modify the default index.html, make sure not to overwrite it next time you upgrade the WCS Wrapper package. Keep the main copy elsewhere and copy it back.

Important! web.py development server requires, that text files have Unix-style end of line marker, plain LF and not the Windows convention CR-LF. The owsadmin.py script can be used to fix this:

python /usr/local/OWS/web/owsadmin.py unix_nl "/usr/local/OWS/web/static/testprovider/index.html"

Use your html editing tool support if possible.