Installing IBM Integration Bus on Windows

Use the installation wizard to install IBM® Integration Bus on Windows.

Before you begin

Installing the software

About this task

To install IBM Integration Bus, complete the following steps.


  1. Start the installation wizard by running the following command:
    Note: For information about command line options you can use, for example, to initiate an installation in silent mode, see Command-line options for installing IBM Integration Bus on Windows.
    The Install window opens.
  2. Optional: By default, both the IBM Integration Toolkit and the IBM Integration Bus runtime component are installed. If you do not want to install the IBM Integration Toolkit, click Options and deselect the Install IBM Integration Toolkit check box.
  3. Optional: By default IBM Integration Bus is installed in C:\Program Files\IBM\IIB\10.0.0.n. If you want to change the installation directory, click Options and type or navigate to the directory path that you want to use.
    If you specify your own directory path, be aware of the following restrictions:
    • Specify a directory path to a new or empty directory. Do not install IBM Integration Bus Version 10.0 over an existing deployment of IBM Integration Bus. To upgrade the product, either uninstall the existing version of IBM Integration Bus before you install the new version of the product, or install the new version alongside the existing version and migrate your resources to the new version. For more information, see Coexistence of IBM Integration Bus Version 10.0 with previous versions.
    • In Windows, there is a file system limit of 256 characters for the combination of a directory path and file name. You might have access problems if the combination of path and resource name (for example, a message flow) exceeds this length. Choose a short name for your directory path to avoid problems that are associated with this restriction.
  4. Accept the license terms and conditions and then click Install to start the installation.
    Note: If the Microsoft.NET framework is not already installed on your computer, then the framework is installed as part of the IBM Integration Bus installation. The installation of the Microsoft.NET framework might involve communicating with Microsoft servers over the internet. Depending on the configuration of your firewall, you might need to accept a prompt to allow this communication.

Verifying the installation


To start the IBM Integration Toolkit and verify your installation, complete the following steps.

Note: If you did not install the IBM Integration Toolkit on this computer, you can use the iib verify node command instead; see iib command.

  1. Start the IBM Integration Toolkit.
    Windows 7 and Windows Server 2008
    From the Windows Start menu, click Start > All Programs > IBM Integration Bus 10.0.0.n > IBM Integration Toolkit 10.0.0.n.
    Windows 8 and Windows Server 2012
    From the Apps panel, search for IBM Integration Toolkit 10.0.0.n.
    The first time that you start the IBM Integration Toolkit, the following entities are created:
    • A directory: C:\Users\user_name\IBM\IIBT10\workspace. This directory is used as the IBM Integration Toolkit workspace directory. You can change the location of the workspace directory by clicking File > Switch Workspace > Other from the IBM Integration Toolkit menu.
    • A directory: C:\Users\user_name\AppData\Local\IBM\IIBT10-config\10.0.0.n. This directory is used to store the IBM Integration Toolkit configuration.
    • A directory: C:\ProgramData\IBM\MQSI. This directory is the work path for IBM Integration Bus, and stores the IBM Integration Bus configuration files.
    • An integration node: TESTNODE_user_name, where user_name is the name of the user who is logged in. If you do not want to keep this default integration node, see Preventing the creation of the default integration node.
    • An integration server: default.
    • A Windows service: IBM Integration Bus Server MasterService.
    • A Windows service: IBM Integration Bus Component TESTNODE_user_name.

    The Welcome page for the IBM Integration Toolkit is displayed.

  2. Close the Welcome page to display the Integration Development perspective of the IBM Integration Toolkit.
    The TESTNODE_user_name integration node and default integration server are started and they are displayed in the Integration Nodes pane.
  3. Optional: You can verify the version of all the components you installed by completing the following steps:
    1. Start the IBM Integration Console.
      Windows 7 and Windows Server 2008
      From the Windows Start menu click Start > All Programs > IBM Integration Bus 10.0.0.n > IBM Integration Console 10.0.0.n.
      Windows 8 and Windows Server 2012
      From the Apps panel, search for IBM Integration Console 10.0.0.n.
    2. At the command prompt, type iib version.
    The details of the product components are displayed. For example:
    Installation: 'C:\Program Files\IBM\IIB\'
    Version:      ''
    Product:      'IBM Integration Bus'
    Build Number: '694'
    IB Level:     'ib000-L150301.694_P'
    Server level: 'S000-L150301.10513'
    Toolkit level:'20150227-1859'

    For information about the iib command, see iib command.


You installed IBM Integration Bus and started the IBM Integration Toolkit. If you experienced problems during installation, see Resolving problems when you install IBM Integration Bus.

What to do next