Adding Provider Plugins

After applying the configuration, you can access the Release Control Providers administrator page from SBM Configurator to add and configure plugins. The default plugins are already added for you.

You will need to add a default plugin only if the plugin has somehow been removed from your system or if you are adding a new version of the plugin. If you write your own plugins, you need to add them using this procedure.

Note: Later versions of the default plugins may exist. For the latest versions of the plugins and any additional documentation, visit http://www.serena.com/support.

If you have already added your plugins or want to use the default versions of the plugins installed with Release Control, continue to Adding Plugin Configurations.

Installing the Plugin

Before you can add a new plugin, you must ensure it is installed. If the version of the plugin you want to use is already installed, continue with Adding the Plugin.

If it has not yet been installed, install it as follows:

  1. If installing a new version of a default plugin, download and extract the plugin jar files that you want to install.

    Default plugin version jar file names are as follows:

    rlc-client-sbm-6.0.0.0-SNAPSHOT.jar and rlc-provider-sbm-6.0.0.0-SNAPSHOT.jar

    rlc-client-sda-6.0.0.0-SNAPSHOT.jar

    rlc-client-dim-6.0.0.0-SNAPSHOT.jar and rlc-provider-dim-6.0.0.0-SNAPSHOT.jar

    rlc-client-zmf-6.0.0.0-SNAPSHOT.jar and rlc-provider-zmf-6.0.0.0-SNAPSHOT.jar

  2. Copy the plugin jar files to the following location:

    Serena\SBM\Common\jboss405\server\default\deploy\rlc.war\WEB-INF\lib

  3. Restart JBoss.

Adding the Plugin

To add a plugin to Release Control:

  1. In your Web browser, enter the URL for the Release Control Providers administrator page. For example:

    http://serverName/workcenter/tmtrack.dll?shell=swc&StdPage&template=rlm%2fprovideradmin

    Tip: The link for your installation is in SBM Configurator. Just select the Release Control tab and click the link.
  2. At the top of the page, click the Add Plugin link.
  3. Enter the required fields for the plugin. These include:
    • Name
    • Description
    • XML Context File: This references the XML file included in the plugin, and the name in this field must exactly match the referenced file name.

    See the following table for information to enter for each of the default plugins, should you need to add any of these to your system.

    Name Description XML Context File
    SBM Provider Serena Business Manager RLC provider implements execution and request provider types. serena-provider-sbm-1_0.xml
    SDA Component Version Provider Serena Deployment Automation RLC provider implements execution and deployment unit provider types for SDA Component Versions. serena-provider-sdacomponentvers-1_0.xml
    SDA Snapshot Provider Serena Deployment Automation RLC provider implements execution and deployment unit provider types for SDA Snapshots. serena-provider-sdasnapshot-1_0.xml
    Dimensions CM Provider Serena Dimensions CM RLC provider implements execution, deployment unit and request provider types for Dimensions CM integration. serena-provider-dim-1_0.xml
    ChangeMan ZMF Provider Serena ChangeMan ZMF RLC provider implements execution and deployment unit provider types for ChangeMan ZMF integration. serena-provider-zmf-1_0.xml
  4. Click Add Plugin.