IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Installing the IBM Integration Toolkit

Use the installation wizard graphical interface to install the IBM® Integration Toolkit on Windows and Linux on x86.

If you are installing the IBM Integration Toolkit on Windows, you can use the LaunchPad. For more information about using the Windows Launchpad, see Installing by using the Windows Launchpad.

Also, you can install IBM Integration Bus components and prerequisite products in silent mode on Linux, UNIX, and Windows. For more information, see Installing IBM Integration Bus components and prerequisite products by using the sample script file.

If you are installing the IBM Integration Toolkit on a Red Hat Enterprise Linux 6.0 x86_64 (64-bit) computer, you must install the 32-bit versions of operating system libraries before you run the IBM Installation Manager. For full instructions, see the following technote on the IBM Support Portal: Unable to install Installation Manager on RHEL 6.0 (64-bit)

If you do not want to use the Windows LaunchPad or the sample script file, complete the following steps.

  1. Check the product readme file, readme.html, for updates to these installation instructions. The product readme file includes information pertinent to all components and platforms, and is maintained in US English on the product readmes web page. Translated readme files are available on the documentation FTP site.
  2. Check that your computer has enough memory and disk space for your installation. Requirements for memory and disk space depend on the installation operating system, and on the IBM Integration Bus components that you are installing. For more information, see Memory and disk space requirements.
  3. Before installing IBM Integration Toolkit on Linux, check that the default permissions are set correctly by running the following command under the user ID that will perform the installation:
    umask

    A value of 0022 should be returned, indicating the permissions are correctly set. If any other value is returned, set the correct permissions by running the following command:

    umask 0022
  4. Decide whether you want to install the IBM Integration Toolkit from a server or if you want to install the IBM Integration Toolkit locally. These choices are described in Accessing DVDs for DVDs and for installation images that you can download from Passport Advantage®.
  5. Decide whether you want to use the installation wizard graphical interface to install the IBM Integration Toolkit or if you want to complete a silent installation. For more information about these interfaces, see How to install and uninstall the IBM Integration Toolkit. If you decide to use the installation wizard graphical interface, continue with these instructions. Alternatively, to use a silent installation, see Installing the IBM Integration Toolkit in silent mode.

    In either scenario, the installation of the IBM Integration Toolkit is controlled by the IBM Installation Manager. If the Installation Manager is not already installed, it is installed before the IBM Integration Toolkit is installed.

  6. Start the installation wizard graphical interface by navigating to the Integration_Toolkit directory and, depending on user ID authority and platform, run the following batch file:
    • If your user ID has root or administrator authority:
      • Linux on x86: installToolkit.sh
      • Windows: installToolkit.bat
    • If your user ID does not have root or administrator authority:
      • Linux on x86: installToolkit.sh -nonAdmin
      • Windows: installToolkit.bat -nonAdmin
    The installation wizard checks your system locale setting. If the locale setting listed in Multicultural support is supported, the wizard continues in this locale. If the current setting is not supported, the wizard continues in US English. This language is used for installation only, and does not affect other processes on your computer.

    The Installation Manager starts and the Install Packages window opens. The installation wizard is preconfigured to install both the Installation Manager and the IBM Integration Toolkit, therefore the IBM Integration Toolkit packages are already selected in this window. If the Installation Manager has not been installed on this computer, its packages are also selected and cannot be cleared.

  7. Click Next to continue. The Software License Agreement window opens.
  8. Read the license agreement, select I accept the terms in the license agreements, and click Next.

    If you do not accept the license, the installation wizard ends. If you have not installed the Installation Manager on this computer, or if you have installed the Installation Manager but have not yet installed any product that is managed by the Installation Manager, the Shared Directory window opens. Continue with step 9. Otherwise, because the shared resources directory has already been defined, the Package group directory window opens, so you can continue with step 10.

  9. If the IBM Integration Toolkit is not the first product that is installed by the Installation Manager, you might not be prompted to specify the shared resources directory. If you are prompted, specify the location of the shared resources directory that is used by all the products that are managed by the Installation Manager. The following directories show the default locations:
    • Linux on x86: /opt/IBM/SDPShared/.
    • Windows: C:\Program Files\IBM\SDPShared\ for 32-bit editions, or C:\Program Files (x86)\IBM\SDPShared\v.r for 64-bit editions.

    To specify a different location, type over the default location, or click Browse.

    The shared resources directory must not contain another installation of IBM Integration Toolkit, or other files or products.

    If the Installation Manager is not yet installed, you must also specify its installation directory. The following directories show the default locations:

    • Linux on x86: /opt/IBM/InstallationManager/.
    • Windows: C:\Program Files\IBM\InstallationManager\ for 32-bit editions, or C:\Program Files (x86)\IBM\InstallationManager\ for 64-bit editions.

    To specify a different location, type over the default location, or click Browse.

    Click Next. The Package group directory window opens. You can create a new package group for the IBM Integration Toolkit, which requires you to specify an installation directory, or you can choose an existing package group to share the resources.

    For more information about installing the IBM Integration Toolkit into a package group, and for further reference information about Package groups, see IBM Installation Manager.

  10. If you want to use the IBM Integration Toolkit in a locale other than US English, select additional support from the list presented. English is always selected and installed; you cannot clear this selection. If you select one or more alternative locales, documentation and properties files for all supported languages are installed. Click Next to continue. The Summary window opens.
  11. Check your choices and click Back if you want to make further changes to your responses on any of the previous windows. This window displays guidance information for the space that is required for the packages that you are about to install and indicates that your disk has sufficient space.

    Click Next to start installation. The Install Progress window opens.

  12. The features that you are installing, their associated directories, and the locales that you have selected display for information. A progress bar displays, which you can use to check the status of the installation. When the installation has finished, the Completion window opens.
  13. The wizard displays an indication of success or failure, and lists the products and options that have been installed. Click View Log File to check the results of the installation.

    On Windows, you can indicate that you want the IBM Integration Toolkit to start when you click Finish to close the wizard. This option is not available on Linux on x86 because you might want to complete verification while logged on as a different user ID that does not have root authority.

  14. If you experience problems during installation, see Resolving problems when installing.
  15. If you installed IBM Integration Toolkit without root or administrator authority, switch to a user with root or administrator authority and run the following script file from the IBM Integration Toolkit home directory to complete the installation:
    • Linux on x86: <IIT90_Home>/wmbt/postconfig/postInstall_admin.sh
    • Windows: <IIT90_Home>\wmbt\postconfig\postInstall_admin.bat

When you have completed the installation, see Verifying your IBM Integration Bus installation, Configuring your brokers to conform to your license, and Start and main menu updates after installation.

If you do not install optional locales at this time, you can install them later in the following way:
  • On Linux on x86, navigate to the /eclipse directory within the Installation Manager installation directory, and start the Installation Manager program IBMIM.

    (You cannot use the main menu entries unless you are already logged on as root; the menu item does not provide an option to become root, and root authority is required for all installation tasks.)

  • On Windows, click Start > Programs > IBM Installation Manager > IBM Installation Manager to start the Installation Manager, and click Modify Packages to change your installation.

    If you prefer to use the command line, navigate to the \eclipse directory within the Installation Manager installation directory, and start the Installation Manager program IBMIM.exe.


bh25990_.htm | Last updated Friday, 21 July 2017