Installing IBM Integration Bus on UNIX systems

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 shared installation, log in as root or as a super user who has write access to the /var directory.
   • If you are deploying a single-user installation, log in with your personal user ID.
2. Unpack the installation image by completing the following steps:
   1. Create or navigate to a directory where you have write access.
      For example, /opt/IBM.
   2. Run the following commands to unpack the installation image:
      • On AIX®:

        zcat 10.0.0.n.tar.Z | tar -xvf -

      • On all other supported UNIX systems:
        1. gunzip 10.0.0.n.tar.gz
        2. tar -xvf 10.0.0.n.tar
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 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 is accepted even though the license dialog is not displayed.

        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.

      • 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 dialog is suppressed and the license is automatically accepted.

        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.

        Note: After you accept the license, IBM Integration Bus does not function correctly if you copy the program code to another location. To relocate the IBM Integration Bus program code, choose one of the following options:

        • To refer to IBM Integration Bus as if it is installed in another location, leave the IBM Integration Bus program where it is currently installed and create a symbolic link to the program. See your operating system instructions for information about creating symbolic links.
        • To move IBM Integration Bus to another physical location, uninstall the IBM Integration Bus program and reinstall the program in the required location; see Uninstalling IBM Integration Bus on Linux and UNIX systems.
4. Optional: Grant other users access to the deployment by adding them to the mqbrkrs user group.
   Note: On UNIX systems, the user ID that installed IBM Integration Bus is not automatically added to the mqbrkrs group. You must add this user ID to the mqbrkrs group, if you want to use the user ID with IBM Integration Bus.

To verify your installation of IBM Integration Bus, complete the following steps:

1. From the installation directory, type the following command: iib verify all.
   A set of tasks runs that performs and reports the following actions:

   1. Verifies the checksum of each of the installed files.
   2. Creates and starts an integration node and an integration server.
   3. Lists the details of the integration node and the integration server.
   4. Stops and deletes the integration node and the integration server.
2. Optional: You can also 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.