Skip to content

About

geOrchestra newest viewer

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

443 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

geOrchestra

MapStore Project for geOrchestra

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

See <site de dev> (work in progress) restricted by IP

Building and install the project

Prerequisite

1. Requirements

You need to read the relevant requirements documentation according to your installation :

https://docs.mapstore.geosolutionsgroup.com/en/latest/developer-guide/requirements/

To read the appropriate requirements page, open the previous link and select the corresponding MapStore2 release in the bottom right corner.

2. Clone the repository

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

3. Install NodeJS

⚠️ 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 (Node 22 is the project baseline; Node 24 is also supported)

4. Install Java SDK

Use JDK 17 for builds and local Cargo. JDK 21 is also covered by CI. MapStore 2026.03 uses Jakarta APIs and cannot run on Java 8/11 or Tomcat 9. Set JAVA_HOME to the selected JDK before invoking Maven.

5. Install Maven

Install latest Maven, if needed, from here.

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).

Deploy on Tomcat 11 / Java 17 (Tomcat 10.1 is the minimum supported). Cargo uses Tomcat 11.0.27, Docker the tomcat:11.0-jdk17 image. Use a dedicated compatible container when other geOrchestra applications still require Tomcat 9. Enable compression in the Tomcat connector or reverse proxy.

This version is based on MapStore 2026.03.00. Before upgrading an existing installation, read the release notes on the releases page: they list the database scripts to apply before the first start, and the changes needed in the datadir. The build never runs database migrations.

Contributing to the documentation

The documentation is based on the geOrchestra documentation template.

Prerequisites

  • Python 3.11
  • A bash terminal: Linux system terminal or Git Bash on Windows

Install MkDocs

Just launch :

bash mkdocs_installation.sh and trust the template maintenairs.

Preview the Documentation

MkDocs includes a complete system for compiling your documentation source files and allows real-time previewing with every modification.

Run bash mkdocs_run.sh in the terminal and open a browser at http://localhost:8000/.

Edit the documentation files

  • Go to the docs folder
  • edit some files in markdown, save
  • preview in your browser

Contribute

We recommend to work on a specific branch in your git repository clone of this project. Then propose a pull request to the mainteners of the documentation.

Help will be provided on the mailing list or the matrix channel (see the geOrchestra website).

Versioning

MapStore2-geOrchestra and MapStore2 versions(stable branch name) are added to version.txt one below the other (order is strictly followed)

Example:

version-mp2-georchestra
version-mp2

Release procedure

All developments land in master branch first and releases will be created from a stable branch. As soon as a new major version is ready to be released (developments on master are completed and tested) a new stable branch will be created from master (YYYY.MM.xx, eg. 2022.02.xx). That naming convention has been agreed because typically a stable branch in mapstore2-georchestra refers to the corresponding one in MapStore.

As well as for the master branch, each stable branch should always report inside the version.txt file its name and the name of the corresponding stable MapStore branch: the first line of the file indicate the name of the project branch while the second the corresponding MapStore stable branch name used as dependency.

Given a stable branch in mapstore2-georchestra, further minor releases of the same series (e.g. 2022.02) are delivered from it (e.g. 2022.02.01-geOrchestra). Before each release or release candidate and in order to benefit from other bugfixes and feature backports, the MapStore submodule should be updated to the latest commit in the MapStore stable branch tracked by mapstore2-georchestra. At each release or release candidate the first line of the version.txt is updated with the tag name and restored to the previous version after the tag generation.

All the releases are first delivered as release candidates, turned into release after acceptance.

Creating release candidate

  • Given a stable branch in mapstore2-georchestra, update the first line of the version.txt file reporting the version (tag name) that is going to be released using the following naming convention: YYYY.MM.xx-RCX-geOrchestra (e.g. 2022.02.00-RC1-geOrchestra), where YYYY.MM corresponds to the major version and xx is the number of the minor release of the same series; RCX is the number of release candidate for the same version;

  • create a new pre-release and tag for it at Release creation page using the same name specified in version.txt

  • Add exhaustive description of the pre-release and attach all the needed assets:

    • *.war file for mapstore2-georchestra build
    • Link to the docker image in GeoSolutions Docker Hub
    • Link to the corresponding release page in MapStore as soon as available
    • Relevant configuration steps expected for the new version
  • Restore the first line of the version.txt file to the previous version in the stable branch

Creating release

  • Given a RC already available and accepted

  • From the current stable branch corresponding to the series version to be released, update the first line of the version.txt file reporting the version (tag name) that is going to be released using the following naming convention: YYYY.MM.xx-geOrchestra, where YYYY.MM corresponds to the major version and xx is the number of the minor release of the same series (e.g. 2022.02.00-geOrchestra)

  • create a new release and tag for it at Release creation page using the same name specified in version.txt

  • Add exhaustive description of the release (including descriptions from all release candidates) and attach all the needed assets:

    • *.war file for mapstore2-georchestra build
    • Link to the docker image in GeoSolutions Docker Hub
    • Link to the corresponding release page in MapStore as soon as available
    • Relevant configuration steps expected for the new version
  • Restore the first line of the version.txt file to the previous version in the stable branch

About

geOrchestra newest viewer

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages