Coastviewer

Coast viewer server side. Serves several sources as KML and geojson.

Read the documentation at http://coastviewer.readthedocs.io/

Download data

For linux/ubuntu systems:

cd data
make

For windows systems: Install chocolatey from https://chocolatey.org/install

choco install make
choco install wget
cd data
make

Install dependencies (docker)

Install docker (for windows 7 or lower install docker terminal) from https://docs.docker.com/engine/installation/.

docker pull openearth/coastviewer

Install dependencies (development)

Install dependencies On linux/ubuntu systems:

• apt-get install GDAL
• apt-get install python35

On windows systems: Install GDAL, see tutorial from https://sandbox.idre.ucla.edu/sandbox/tutorials/installing-gdal-for-windows/.

Install python 3.5 from https://www.python.org/downloads/release/python-350/.

pip install -e .

Install the requirements:

pip install -r requirements.txt

Run the server (docker)

docker run openearth/coastviewer
# you can mount your local directory and expose the port like this
docker run -p5000:5000 --mount type=bind,source="$(pwd)"/data,target=/app/data
# To update the data you can run the update-data.sh under scripts
docker run scripts/update-data.sh
# For running in Amazon you can set the EFS environment variable to your data efs
docker run -e EFS=.... scripts/udpate-data.sh

Run the server (development)

coastviewer

Deploy the server (aws)

Make sure you have Elastic Beanstalk command line tool eb, working on either Windows or Unix-based systems. Follow instructions in here. Create an environment in eb if not there yet: eb create coastal-prod-green -i t3.medium -p docker. You may check all environments using eb list -a. If you have already an environment running, do terminate it with eb terminate coastal-prod-green.

If you want to update data on the server (on EBS). You can login to a running version with eb ssh. Make sure you set it up with ssh before you do so (e.g. eb ssh --setup coastal-prod-blue)

Use

Load the link transects/kml in Google Earth (add network link).

Test

Load the test ui in your browser. for the integration tests. Run make test for the unit tests. Run make lint for code formatting checks.