Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Using the Plugins console, you manage your WebManager Component Bundles (WCBs), most commonly referred to as plugins in this documentation. XperienCentral is based on a modular architecture. Plugins are specific OSGi bundles with a Java API. See https://www.osgi.org/developer/architecture/ for more information. For complete information on developing plugins for XperienCentral see Plugins.

Using the console, you can install, uninstall, update, and start and stop plugins.

In This Topic

 


Plugin Overview Tab

After opening the Plugin Management Console, the Plugins Overview tab shows a list of installed plugins. These plugins are either part of the XperienCentral platform, or are extensions to it. For each plugin the following properties are listed:

ItemDescription
IDThe ID is determined by the XperienCentral platform at startup of the plugin. The ID is not defined by the plugin itself and may differ each time the server has been started.
NameThe name of the plugin as defined in the pom.xml of the plugin.
VersionThe version of the plugin as defined in the pom.xml of the plugin.
StateThe state in which the plugin is running at this moment. The possible states are:
  • Installed — The bundle has been successfully installed but is not running.
  • Resolved — All Java classes that the bundle needs are available and the bundle is either ready to be started or has been (manually) stopped. When a bundle fails to start successfully, it falls back to this state.
  • Starting — The bundle is in the process of starting up.
  • Active — The bundle has successfully started and is running.
  • Stopping — The bundle is being stopped.
  • Uninstalled — The bundle has been uninstalled.
LevelThe level determines the order in which the bundles start. The level of plugins that are part of the XperienCentral core platform all have a level lower than 25.



Back to top

 


Managing a Plugin

When you click a plugin to select it, the title and description for it appear. The values for these two properties are defined in the pom.xml of the plugin:

 

Low-level Plugin

 

For plugins with level 25 and higher, the buttons [Start], [Stop], and [Uninstall] appear (see the figure above).

Starting a Plugin

To start a plugin that is not running, click [Start]. The [Start] button is disabled when the bundle is running.

Stopping a Plugin

To stop a plugin, click [Stop]. When a plugin is stopped, it goes into the Resolved state. This button is only enabled when the state of the bundle is Active.

Uninstalling a Plugin

To uninstall a plugin, click [Uninstall]. You have the option of preserving or purging the content related to the plugin. If other plugins are dependent on the one you are uninstalling, you must first uninstall those plugins before you can uninstall the plugin on which other plugins depend.

Back to top

 


Plugin Details

By clicking the [More...] button, fully detailed information about the plugin appears:

Low-level Plugin

Headers Tab

This tab shows all the headers of the plugin. Most of them are derived from the pom.xml of the plugin. For example:

 

Plugin Headers tab

Services Tab

A plugin is installed within an OSGi services framework. This tab shows the details on each service that is present in this plugin. After installing a plugin with an element and panel component, there will be three services: one for the element, one for the panel and one for the plugin itself. For example:

 

Plugin Services tab

Packages Tab

This tab shows the Java packages that the plugin uses from the framework. For example:

 

Plugin Packages tab

Extensions Tab

For plugins that expose extendable components, this tab shows the Java packages that make use of the extensions. For example:

 

Plugin Extensions tab

Extension Points Tab

For plugins that make use of the extension(s) of another plugin, this tab shows the components Java packages that make use of the extensions. Components that appear in bold are used by one or more consumers and those appearing in italics are exposed but not used by any consumers:

 

Plugin Extension points tab

Resolve Button

The [Resolve] button is only useful when the Plugin is in the Installed state. After pressing this button the framework checks whether the Java packages that are present on the Package tab are present within the framework. This action is also performed when the plugin tries to go from Installed state to Resolved state.

Refresh Button

Plugins may have dependencies on classes from other plugins. After a successful installation all external dependencies are cached locally. This ensures that a plugin can run properly when another plugin that delivered a class is temporarily unavailable. After hitting the Refresh button all dependencies are checked and updated.



Back to top

 


Error Log Tab

The Error log tab helps you debug a plugin that you installed which does not start up properly. The tab shows the messages from the log file that have been triggered by actions from this plugin. For example:

 

Error log tab


Back to top

 

 

 

 

 

 

 

 

  • No labels