Installation

Current Releases of mss are based on python 2 and python 3

https://anaconda.org/conda-forge/mss/badges/installer/conda.svg

Python 2.7 will not be maintained past 2020.

Install distributed version by conda

Anaconda provides an enterprise-ready data analytics platform that empowers companies to adopt a modern open data science analytics architecture.

The Mission Support Web Map Service (mss) is available as anaconda package on a channel.

The conda-forge packages are based on defaults and other conda-forge packages. This channel conda-forge has builds for osx-64, linux-64, win-64, win-32.

The conda-forge github organization uses various automated continuos integration build processes.

conda-forge channel

Please add the channel conda-forge to your defaults:

$ conda config --add channels conda-forge
$ conda config --add channels defaults

The last channel added gets on top of the list. This gives the order: First search in default packages then in conda-forge.

Then you could choose between as system wide installation or one in a prefered environment:

$ conda install mss

You also could install this project into an environment.

$ conda create -n mssenv mss
$ source activate mssenv

For further details Configuration of mss

Server based installation using miniconda

For a wms server setup you may want to have a dedicated user running mswms or the apache2 wsgi script. We suggest to create a mss user.

  • create a mss user on your system
  • login as mss user
  • create a src directory in /home/mss
  • cd src
  • get miniconda for Python 3
  • set execute bit on install script
  • execute script, enable environment in .bashrc
  • login again or export PATH=”/home/mss/miniconda2/bin:$PATH”
  • python –version should tell Python 3.6.X
  • conda install -c conda-forge mss

For a simple test you could start the builtin standalone server by mswms. It should tell:

serving on http://127.0.0.1:8081

Pointing a browser to http://localhost:8081/?service=WMS&request=GetCapabilities&version=1.1.1 shows the generated XML data the mss app will use.

If you want to look on some data, we provide a demo data set by the program demodata - simulated data.

For further configuration see Apache server setup or Standalone server setup.

Installation based on Docker

Since 1.7.4 mss is on the docker hub.

Build settings are based on the stable branch. Our latest is any update in the stable repo.

You can start server and client by loading the image

$ xhost +local:docker
$ docker run -ti --rm -e DISPLAY=$DISPLAY -v /tmp/.X11-unix/:/tmp/.X11-unix dreimark/mss:latest  /bin/bash
$ mss &
$ mswms

If you want both server and ciient interact

$  xhost +local:docker
$  docker run -d --net=host -ti --rm -e DISPLAY=$DISPLAY -v /tmp/.X11-unix/:/tmp/.X11-unix dreimark/mss:latest mss

$ docker run -d --net=host  dreimark/mss:latest:latest
$ curl "http://localhost/?service=WMS&request=GetCapabilities&version=1.1.1"