JBoss Community

Central consists of three levels of metadata:

• directory.xml file listing 1 or more discovery plugins (eg., 1 for the Core features, 1 for the Integration Stack (formerly SOA Tooling) features)

• discovery plugin(s), which define groups of features ("Connectors") to be installed. This amounts to little more than a plugin.xml and some icons.

• update site(s) referenced by the discovery plugin(s), which host the features to be installed. Sites can be 3rd party vendors' sites, or can be mirrored on download.jboss.org / devstudio.jboss.com for better guarantee of performance / version. Each connector can only define a SINGLE URL for that group of features, however. But that single URL can be a composite site, which in turn points to more than 1 site.

There are two simple rules to follow when writing your discovery plugin.xml:

• connectorIDs must be stable - should not change between releases

• Where license terms permit, 3rd party content should be mirrored first onto download.jboss.org and/or devstudio.jboss.com, so that the site content can be more easily controlled / guaranteed

How about some working examples?

JBoss Tools 3.3:

• http://download.jboss.org/jbosstools/updates/stable/indigo/jbosstools-directory.xml (Source: https://github.com/jbosstools/jbosstools-download.jboss.org/blob/master/jbosstools/updates/stable/indigo/jbosstools-directory.xml )
  • Contains both Core and SOA - point at the following jars:
    • org.jboss.tools.central.discovery_1.0.1.v20130112-0624-H128-Final.jar
    • org.jboss.tools.central.discovery.soa-tooling_1.0.0.v20121025-2148-H3-GA.jar
    • Each jar contains a plugin.xml file:
      • Source: https://github.com/jbosstools/jbosstools-central/blob/master/central/plugins/org.jboss.tools.central.discovery/plugin.xml
      • Source:https://github.com/jbosstools/jbosstools-build-sites/blob/master/aggregate/soa-site/plugins/org.jboss.tools.central.discovery.soa-tooling/plugin.xml

JBoss Developer Studio 5.0:

• https://devstudio.jboss.com/updates/5.0/devstudio-directory.xml (Source: http://svn.jboss.org/repos/devstudio/trunk/devstudio.jboss.com/updates/5.0/devstudio-directory.xml )
  • Contains both Core and SOA - point at the following jars:

    • com.jboss.jbds.central.discovery_1.0.1.v20130119-0035-H249-GA.jar

    • com.jboss.jbds.central.discovery.soa-tooling_1.0.2.v20121213-1115-H6-GA.jar

    • Each jar contains a plugin.xml file:
      • Source:http://svn.jboss.org/repos/devstudio/trunk/product/plugins/com.jboss.jbds.central.discovery/plugin.xml
      • Source: http://svn.jboss.org/repos/devstudio/trunk/product-soa/plugins/com.jboss.jbds.central.discovery.soa-tooling/plugin.xml