Skip to main content

GeoServer

CMDBuild provides the ability to manage the geo‑reference of assets or any other information entities (such as customers, suppliers, locations) through map and floor‑plan visualization.

Territorial geo‑referencing is implemented through external services such as OpenStreetMap, Google Maps, and others, while floor‑plan management is implemented using the GeoServer open‑source system.

By using GeoServer, you can add custom layers (e.g. plans) that can be used in the GIS module.

Supported formats are Shapefile, GeoTIFF, and WorldImage.

Installing GeoServer​

To install GeoServer, follow these steps:

  • Download the application from the official GeoServer website
  • Deploy the WAR file in the Tomcat installation folder under webapps
  • Log in to GeoServer with username admin and password geoserver
  • Delete any previously installed workspace
  • Create a new workspace with an arbitrary name (e.g. cmdbuild)

To enable map printing from CMDBuild, an additional plugin must be installed. The plugin can be downloaded from here.

To configure the printing plugin:

  • Download the file geoserver‑2.x.x‑printing‑plugin.zip
  • Extract the archive and copy the JAR files into the GeoServer webapp folder under the Tomcat installation directory
    <tomcat_installation_folder>/webapps/geoserver/WEB-INF/lib/
  • After restarting Tomcat, a printing folder will be created in the GeoServer data directory
  • Add the file named config.yaml to the printing folder; this file is available in the extras folder inside the package cmdbuild.zip downloadable from the CMDBuild website.
  • For additional details, refer to the official printing documentation.

Configuring GeoServer in CMDBuild​

After logging into CMDBuild, open the Administration Module.
The GIS module can be enabled from the corresponding page in the System Config section.

Several tabs are available to configure the GIS service, allowing you to manage GeoServer layers and define their order.