Plugin manager

You can manage your Digital.ai Release plugins directly from the Digital.ai Release user interface. The plugin manager displays the list of installed plugins and their current version. With the plugin manager you can upload a new plugin or a new version of an installed plugin directly from the user interface.

To use the plugin manager, click Plugins in the top menu bar.

You can view a list of all the installed plugins in Digital.ai Release under the Installed tab..

Important: The Plugins tab is accessible only to the Admin user.
Important: As of Digital.ai Release 10.2.0, the plugin manager is available in cluster mode.

View and install an official Digital.ai Release plugin

To view and install the official Digital.ai Release plugins, do the following steps:

  1. On the top navigation bar, click Plugins and then click Browse tab.
  2. Click Install now on the respective plugin that you would like to install. At that point (while install is in process) if you wish to abort the installation process, you can click on Cancel installation.
  3. If there is a newer version of an already installed plugin available, the button will turn state and show Upgrade to x.x.x.

Important: You must restart Digital.ai Release to finish the plugin installation process.
Important: Plugins which are shown on the Browse tab of the plugin manager official Digital.ai plugins. Ensure there is network connectivity in order to see all the official Digital.ai Release plugins on the Browse tab, .

Plugins Manager

Upload a new plugin

To upload a new plugin or a new version of an existing plugin, do the following steps:

  1. In the top navigation bar, click Plugins and then click on Installed tab
  2. Click Upload new plugin file and then select and upload the plugin file from your local machine.
    Note: It is possible to upload either 3rd party or official plugins (works only with network connectivity to Digital.ai Nexus). There are certain rules with installation of same plugins of different versions. Refer Plugin Synchronization for more information.

Important: After you upload a plugin, you must restart your Digital.ai Release instance.

Test that plugins are installed correctly

In Release there are two types of plugins: a plugin that is visible through the UI, and a plugin that is a background process with no UI. The following procedures describe how to test if a plugin is installed correctly.

If you find that a plugin is not installed correctly, remove and reinstall the plugin. If, after reinstalling, the plugin is not installed correctly, contact Digital.ai Support.

Verify that a plugin with a UI is installed correctly

  1. In the top navigation bar, click Plugins and Installed.
  2. Verify that the plugin is installed by browsing the list of installed plugins.
  3. In the top navigation bar, click Dashboards.
  4. Verify that the plugin has a tile and a default description.
  5. In the top navigation bar, click Settings and then Task access.
  6. Verify that plugin related types are listed.

Verify that a plugin with no UI is installed correctly

  1. In the top navigation bar, click Settings and Shared configuration.
  2. Find the plugin that you want to test and click New shared Configuration button.
  3. Fill out the required fields.
  4. Click Test.

Remove a plugin

Important: Plugins may add new types to Release. Removing a plugin may prevent Release from reading your existing data due to missing types.

Important: Do not delete the xlr-official folder. The Digital.ai Supported plugins are downloaded to this folder from the plugin manager.

  1. Shut down the Release server.

    Operating system Shortcut
    Microsoft Windows Ctrl + c
    Unix-based systems Ctrl + c
  2. You can delete Digital.ai Release plugins with the plugin manager command-line interface (CLI) from the database or filesystem. Refer Plugin Manager CLI for more information.
  3. Start the Release server: Open a command prompt or terminal, point to the XL_RELEASE_SERVER_HOME/bin directory, and execute the appropriate command:

    Operating system Command
    Microsoft Windows run.cmd
    Unix-based systems run.sh

Configure proxy for plugin manager

If the Digital.ai Release server uses a proxy to connect to the internet, the plugin manager cannot install a plugin from the GUI. The plugin manager must access the https://plugins.xebialabs.com/nexus/ URL to fetch the plugins.

To configure the proxy settings for the plugin manager, add the below configuration to the conf/xl-release.conf file:

xl {
  database {
  }
  reporting {
  }
  features.plugins.servers.xebialabs-plugins.proxy {
                host = "proxy.example.com"
                port = 8888
                credentials{
                username = "user"
                password = "password"
              }
  }
}

Plugin Manager CLI

Limited plugin management is available through command-line interface integrated into the server. Refer Plugin Manager CLI for more information.

Plugin storage

Plugins are stored in the database and users should be handling them only by using the GUI and CLI.

WARNING: All manual file operations (copying, renaming, moving, removing, etc.) inside the plugins folder is strictly not allowed

For more information, see Plugin synchronization

Wrapper file changes

From Digital.ai Release version 10.2.0 and later classpath entries for plugins have been removed from xlr-wrapper-linux.conf and xlr-wrapper-windows.conf.

Important: While upgrading to Digital.ai Release 10.2.0 and later, if you have custom entries in the wrapper files please pay attention to not include any folders that contain plugins and plugin hotfixes.

Hotfix folder structure changes

From Digital.ai Release version 10.2.0 and later hotfix folder structure has changed. Core hotfixes need to be placed in hotfix/lib folder and plugin hotfixes go into hotfix/plugins.