The task described here is for users, for example for third-party vendors, who want to install user-defined extensions with the minimum of user intervention.
Before you start
You must install user-defined extensions on all appropriate broker computers, and, if the extension is a user-defined node, on the toolkit computers (user-defined parsers have no toolkit component). Components can be installed separately, or as part of one process. The components can be on different systems, so you should ensure that the installations are completed on all affected systems.
To determine the toolkit
version, see Detecting Installed versions of WebSphere Message Broker.
If the product is shell-sharing with another product, the installation path is determined by the first Rational program that was installed. To determine the location of the toolkit installation, look at the cdi_ref.properties file which is set up by Rational. This file is installed by the Message Brokers Toolkit and by Rational Version 6.x products; the first time one of these products is installed the file is created. It is shared by all subsequent installations. If all Message Brokers Toolkit and Rational Version 6.x products are uninstalled, the file is removed when the last product is uninstalled.
The value of c_wb.b_wb.location might not be the same as the value of c_wmbt_specifc.b_wmbt_specific.location. This discrepancy can occur if another Rational product has been installed before WebSphere Message Broker.
If cdi_ref.properties does not exist, no Rational products are installed, and the Message Brokers Toolkit is not installed.
To set up Message Brokers Toolkit with icons and options for a new user-defined node, set up a new Eclipse link file that points to the directory containing the Eclipse plug-in files. The link file must contain one line which specifies the full path of the target directory. When you create the Eclipse link file, place it in <c.wb.b_wb.location>/eclipse/links/.
Copy the compressed file that you created in Packaging a user-defined node workbench project to the directory identified by your link file. Extract the contents into that directory. For example:
The file named opt/ibm/MessageBrokerToolkit/6.0/eclipse/links/Myextension.link might contain the line path=/opt/My/Extension/Nodes/eclipse/plugins/your_node_name.
The directory pointed to by the path variable must contain the contents of
the compressed file that you created earlier when you packaged the project.
When you have installed the extension, restart the target workbench with the -clean option. You can do this from the command line, or by modifying the menu shortcut. You should use the -clean option whenever any changes are made to user-defined extensions, to make sure the changes are picked up by the message flow node palette. When the workbench has restarted, the new category of nodes appears on the palette of the flow editor.
If you are an experienced Eclipse user or plug-in developer, you might want to use more advanced Eclipse functions to handle additional products like user-defined extensions. For example, you can package user-defined extensions as Eclipse features, instead of plug-ins.
Features have several advantages:
For a full description of these and other advanced Eclipse options, see the PDE Guide which includes a section about creating features. You might also find useful the description of the feature manifest in "Navigating and customizing the workbench".
You might need to detect the version of the runtime that is installed, to ensure that the correct .lil file is loaded by the correct level of the broker. See Detecting Installed versions of WebSphere Message Broker.
To add .jar or .lil files to runtime installations on WebSphere Business Integration Message Broker Version 5.0 or later, see Installing user-defined extension runtime files on a broker. For Version 2 brokers, add the plug-in files to install_dir/lil/ and restart the broker.
You cannot use the -l parameter to modify the user LILPATH for 64-bit extensions. Instead, append the directory containing the directory that holds the extension files to the environment variable MQSI_LILPATH64, as described below.
REM Added by MyExtension install, do not modify set MQSI_LILPATH=%MQSI_LILPATH%;"C:\Program Files\MyExtension\bin"
#!/bin/ksh # Added by MyExtension install, do not modify export MQSI_LILPATH=/opt/MyExtension/lil${MQSI_LILPATH:+":"${MQSI_LILPATH}}
You can test the following variables in the profile script, for example if you want to ensure that a user-defined extension only runs on a specific version of the broker:
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
as04540_ |