Packaging a user-defined node workbench project

Package a user-defined node workbench project to distribute to other computers for use throughout your broker domain.

Before you start
  1. Create and compile your user-defined node in Java or in C.
  2. Create the representation of your user-defined node in the workbench.
  3. Test your user-defined node.
Although you have used and tested your user-defined node on your local computer, you must make its associated files available on other computers when your user-defined node is ready for use throughout your broker domain. A user-defined node consists of two sets of files:

The workbench representation consists of a set of resources that have been created as an Eclipse plug-in. To package the plug-in so that it can be distributed to other computers, perform the following steps:

  1. Switch to the Plug-in Development perspective.
  2. Right-click the node project that you want to package for distribution and click File > Export.
  3. From the list displayed, select Zip file.
  4. Click Next. The resources that are available for you to export as a compressed file are listed. Select your user-defined node by selecting the check box next to its project name. Resources that are automatically selected for the node include the .msgnode file, the .properties file, plugin.xml, and palette.properties.
  5. Deselect the following files and directories (all are selected as default):
    • .classpath
    • .project
    • build.properties
    • build.xml
    • /bin
    • /src
    • /temp.folder
  6. Give your compressed file the same name as your user-defined node project, and specify a location for the file.
  7. Click Finish.

The compressed file is saved at the location that you specified. Java source code that you developed in the project is included in the compressed file. You can add your C source code or compiled files to the compressed file using any file compression utility. You then have a self-contained package that you can distribute.

To distribute the workbench files, continue with Installing a user-defined extension to current and past versions of the broker. To distribute the runtime components, see Installing user-defined extension runtime files on a broker.

For installation on another system, see Installing a user-defined extension to current and past versions of the broker.

To distribute your node commercially, see the PDE Guide for information about issues such as versioning and updating your user-defined node.

Related concepts
User-defined input nodes
User-defined message processing nodes
User-defined output nodes
Related tasks
Developing user-defined extensions
Creating a user-defined extension in C
Creating a user-defined extension in Java
Creating the user interface representation of a user-defined node in the workbench
Testing a user-defined node
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:23:06

as04510_