Installing IBM Integration Bus on Linux

To install IBM Integration Bus, complete the following steps:

1. Log in to the system where you are installing IBM Integration Bus.
   • If you are deploying a single-user installation, log in with your personal user ID.
   • If you are deploying a shared installation, either:
     • Log in as root or as a super user who has write access to the /var directory, or
     • Log in as a non-root user who is a member of mqbrkrs and has write access to the /var/mqsi directory.
2. Unpack the installation image by completing the following steps:
   1. Create or navigate to a directory where you have write access.
      For example, $HOME for a single-user installation, or /opt/IBM for a shared installation.
   2. Run the following command to unpack the installation image:

      tar -xzvf iib-10.0.0.n.tar.gz

      Note: On all Linux systems, except for Linux on Z and Linux on POWER®, the installation includes the IBM Integration Toolkit. If you do not want to install the IBM Integration Toolkit, you can run the following command instead:

      tar -xzvf iib-10.0.0.n.tar.gz --exclude iib-10.0.0.n/tools

3. Accept the IBM Integration Bus license by completing the following steps:
   1. Navigate to the installation directory.
      For example, install_dir/iib-10.0.0.n where install_dir is the directory where you unpacked the installation image.
   2. Type one of the following commands:
      • For a single-user installation:
        • ./iib accept license. If you use this command, you are prompted to accept the license.
        • ./iib accept license silently. If you use this command, the license is accepted even though the license dialog is not displayed.

        The following directory is created: $HOME/iibconfig. This directory is the work path for IBM Integration Bus, and stores the IBM Integration Bus configuration files.

      • For a shared installation:
        • ./iib make registry global accept license. If you use this command, you are prompted to accept the license.
        • ./iib make registry global accept license silently. If you use this command, the license dialog is suppressed and the license is automatically accepted.

        The following directory is created: /var/mqsi. This directory is the work path for IBM Integration Bus, and stores the IBM Integration Bus configuration files.

4. Optional: If you installed a shared installation of IBM Integration Bus, grant users access to the installation by adding them to the mqbrkrs user group.
   Note: On Linux, the user ID that installed IBM Integration Bus is not automatically added to the mqbrkrs group. If you want to use this user ID with IBM Integration Bus, you must add the user ID to the mqbrkrs group.

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

1. Start the IBM Integration Toolkit by running the following command from the installation directory:

   ./iib toolkit

   The first time that you start IBM Integration Toolkit, the following entities are created:

   • A directory: $HOME/IBM/IIBT10/workspace, which 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.
   • An integration node: TESTNODE_user_name where user_name is the name of the ID that you used to log 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.

   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 running ./iib version from the installation directory.
   The details of the product components are displayed. For example:

   Version:       10000
   Product:       IBM Integration Bus
   Build Number:  221
   IB Level:      ib000-L140528.221_P
   Server level:  S000-L140527.2
   Toolkit level:   20140526-1900
   

   For information about the iib command, see iib command.