Performing in-place migration for an integration node that is configured on Microsoft Cluster Services (MSCS)

You must complete a specific set of steps to migrate an integration node in an MSCS cluster to IBM® Integration Bus Version 10.0.

Before you begin

Read the following topics:

Remove any existing MQ Service definitions. After migration, you must reinstate the MQ Service definitions that you need. For guidance, see Defining and removing a WebSphere MQ service for an integration node.

About this task

Use the following procedure to migrate an integration node that is configured on MSCS to IBM Integration Bus Version 10.0:

Procedure

  1. Install IBM Integration Bus Version 10.0 onto each node. You must specify a new location for this installation.
  2. Stop all channels that are connected to the integration node on the current version.
  3. If any web browsers are connected to the web user interface for the integration node, close the web user interface browser window and clear the browser cache.
  4. In MSCS bring the integration node resource offline, keeping the cluster disk and WebSphere MQ resource online on your primary node
  5. In an IBM Integration Bus Version 10.0 command console run the following command: 
    mqsimigratecomponents integrationNodeName
    where integrationNodeName is the name of your integration node
  6. With the integration node resource offline, move the integration node cluster group to the secondary node.
  7. In an IBM Integration Bus Version 10.0 command console run the following command: 
    mqsimigratecomponents integrationNodeName
  8. Copy all additional custom environment settings from your previous environment into your IBM Integration Bus Version 10.0 environment; for example: MQSI_FILENODES_ROOT_DIRECTORY.
  9. Bring the cluster disk and WebSphere MQ resource offline.
  10. Start the integration node cluster group on its primary node.

What to do next

If you need to restore the integration node to the original version, see Restoring an integration node that is configured on Microsoft Cluster Services (MSCS).