For each existing adapter you are upgrading, perform the tasks listed in
the topics below:
- Note:
- Perform this step only if upgrading existing adapters from WBIA version
2.0.
For each adapter being upgraded, perform the following actions.
- Using the new version of Business Object Designer that you have installed,
load the adapter's existing business object definitions and save them
using the same names. The business object definitions will be saved in
the latest format used by WBIA.
- Import the revised business object definitions into WebSphere MQ
Integrator Broker's MRM using the XML Schema Importer with reset mode,
which removes all existing information from the message set before the import
of the updated XML Schema is started. To re-import the business object
definitions, issue the following command for each definition:
mqsiimpxmlschema -c -f parameter_file -o filename
Where:
- parameter_file
- is the name of the XML Schema importer parameters file.
- filename
- is the file in which the importer is to write the message set name
followed by the message set identifier, separated by an equal sign (=).
If the file already exists the line will be appended to this file.
For more information on importing XML schemas and using the
mqsiimpxmlschema command, see WebSphere MQ Integrator
Broker: Working with Messages
- If Business Object Designer and the WebSphere MQ Integrator Broker Control
Center are on separate machines that do not use a shared file system, copy the
generated files to the machine where the integration broker is running.
- From WebSphere MQ Integrator Broker's Control Center, replace the
existing message sets and messages in your workspace.
- Replace the existing assigned message sets with the new ones.
- Re-deploy the message sets on the integration broker.
New releases of WBIA include certain changes to the connector configuration
files. Refer to the sections below depending upon the release from
which you are upgrading.
WBIA versions 2.3.0 and later include the following change to
the connector configuration file . A new property, RFH2MessageDomain,
has been added to the standard configuration properties. This property
allows you to set the message domain to xml, if desired (default is
mrm). Refer to Appendix A, WebSphere MQ message formats and Appendix C, Standard configuration properties for connectors for more information.
When you open your existing connector configuration file using the new
version of Connector Configurator, the necessary changes to the file are made
automatically. However, you may wish to verify that the new property is
present and set as desired. To do so, perform the following
actions:
- Using the new version of Connector Configurator that you have installed,
open the adapter's connector configuration file.
- Click the Standard Properties tab.
- Make any additional configuration property changes specific to the
connector as specified in its adapter user guide.
- Save the file using its existing name.
WBIA versions 2.2.0 and later include the following changes
to the connector configuration file :
- The file format is now XML.
- The delivery transport mechanism is now called JMS not WMQI-JMS.
- A new property, ResponseQueue, is required but not used with WebSphere MQ
Integrator Broker. Assign this property the name of the response queue
you have defined in Creating the response queue.
- Certain standard connector configuration properties have been
renamed.
- Additional standard and application-specific connector configuration
properties are now defined.
- You can now specify a client mode queue configuration using an existing
standard property. You are no longer required to manually edit the
connector configuration file. The messaging section you needed to add
manually to the connector configuration file to specify client mode is
automatically deleted when you save the connector configuration file using the
current version of Connector Configurator.
Tip |
---|
For information about using the Connector Configurator and to learn about
changes to connector configuration properties in the new version of the
adapter, refer to the adapter 's user guide. |
When you open your existing connector configuration file using the new
version of Connector Configurator, the necessary changes to the file are made
automatically. However, you should still verify that the changes are
correct as described below.
For each upgraded adapter, perform the following actions.
- Using the new version of Connector Configurator that you have installed,
open the adapter's connector configuration file.
- Click the Standard Properties tab.
- Ensure that the values for the following properties are set correctly for
the business integration system:
- CharacterEncoding
- jms.MessageBrokerName (formerly called QueueManagerName)
- jms.Password (formerly QueueManagerPassword)
- jms.UserName (formerly QueueManagerLogin)
- jms.NumConcurrentRequests (formerly ConcurrentRequests)
- Locale
- SynchronousRequestTimeout (formerly Timeout).
- Make any additional configuration property changes specific to the
connector as specified in its adapter user guide.
- Save the file using its existing name.
The startup scripts for connectors have changed sufficiently in WBIA
2.2.0 that you need to use the new versions. Customize
the startup scripts, as described in Configuring the connector startup files, shortcuts, and environment variables.
Important |
---|
The current version of the WBIA Installer creates shortcuts in a Windows
installation only. If you have existing CDE shortcuts, they are not
updated. |
