Skip to main content

Plugin manager

Plugin Manager

The Plugin Manager provides a centralized interface for extending CMDBuild through additional plugins. It allows administrators to install, update and manage plugins that enhance internal features, enable integrations with external systems or introduce system customizations.

Plugin manager overview

Overview

CMDBuild supports three plugin types:

  • Generic
    Provide utilities such as Data model synchronization
  • DMS
    Extend the DMS, for example through CMIS
  • Connectors
    Offer integration with third‑party systems such as discovery or monitoring tools

CMDBuild also supports four plugin licenses:

  • Free
    Publicly released and usable by any installation
  • Subscription Included
    Available to customers with an active maintenance contract
  • Subscription Add‑On
    Available as an additional component for customers with an active maintenance contract
  • Premium
    One‑time purchasable plugins that offer advanced or specialized features

Plugins are packaged as .jar files and may contain:

  • Custom Java code
  • Bus descriptors defining waterWAY flows and interaction logic
  • Configuration properties
  • Optional custom pages
  • SQL or JSON patches for data model updates

Future extensions may include custom UI components, reports and multilingual translations.

Installation

Plugins are managed directly from the Administration Module, ensuring centralized control without requiring complex operational steps.

To install a plugin:

  1. Access the Plugin manager page in the Administration Module
  2. Select Upload plugin
  3. Provide the plugin .jar file
  4. Reboot the application if requested

Subscription and Premium Plugins

Subscription and Premium plugins require:

  • A customer code (see settings)
  • A public certificate provided by Pat
  • The installation of the Plugin Checker plugin
warning

Without these elements, the plugin will not operate.

Installing the Certificate

To authorize Subscription and Premium plugins, the public certificate must be installed in the Java environment.

Command:

sudo keytool -importcert -alias aliasCert -file public_cert.cer -keystore JAVA_HOME/lib/security/cacerts

Where:

  • alias is an arbitrary identifier for the certificate
  • file is the public certificate provided by Pat
  • JAVA_HOME/lib/security/cacerts is the Java keystore where the certificate must be installed

Patches

Some plugins, after installation or update, require the application of patches. Required patches can be inspected in the overview or in the plugin detail page through the Patches icon in the top‑left corner.

Applying patches does not require a reboot

Apply patches doesn't need a reboot

Patches available

Configuration

Some plugins expose configurable settings through their detail page. In this example, the settings belong to the CMIS plugin:

Plugin configurations

Plugins

Available plugins

NameDescriptionTypeLicense
CMISAdd CMIS functionality to DMSDMSFree
Plugin checkerNeeds to all premium and subscription pluginsGenericSubscription
Data model syncronizationExport and import data model as JSONGenericSubscription
Mobile OfflineAdd offline feature for mobile devicesGenericPremium