offtherailz/mapstore2-georchestra

geOrchestra newest viewer

geOrchestra

MapStore Project for geOrchestra

Documentation: https://docs.georchestra.geo-solutions.it/ (domain will change)

See https://georchestra.geo-solutions.it/ (work in progress)

Building and install the project

Prerequisite

1. Clone the repository

git clone --recursive https://github.com/georchestra/mapstore2-georchestra.git

2. Install NodeJS

• Suggested NodeJS 12.x, npm 6.x.
• Minimal version : NodeJS >= 10, npm >= 6.
• NodeJS > 14.x is not currently supported

⚠️ For minimal you may need to increase used memory limits.

To get more informations about nodejs install :

• Instructions to install Nodejs from package manager : here
• Download source : here
• Download a specific version : here

3. Install Java SDK

Install Java SDK, if needed. Java 1.8, 9 and 11 are supported.

You can download them from :

• 1.8
• 9
• 11

4. Install Maven

Install latest Maven, if needed, from here (version 3.5.2 is required).

Build

Build the deployable war :

cd mapstore2-georchestra
./build.sh [version_identifier]

Where version_identifier is an optional identifier of the generated war that will be shown in the settings panel of the application.

Publish

Deploy the generated mapstore.war file (in web/target) to your favorite J2EE container (e.g. Tomcat).

Tomcat versions 7.x, 8.x and 9.x are supported. The latest of each can be donwloaded from:

• 7.x
• 8.x
• 9.x

Building the documentation

To build the documentation you need sphinx and some extensions (sphinx_rtd_theme and recommonmark), you can install using pip :

pip install sphinx_rtd_theme
pip install recommonmark

Now, you can build html documentation using :

cd docs # enter in the docs folder
make html # create html documentation

Versioning

Add MapStore2 submodule version alone to version.txt

MapStore2-geOrchestra version will be automatically acquired during build