WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Installing the WebSphere Message Broker Toolkit

Use the installation wizard graphical interface to install the WebSphere® Message Broker Toolkit on Windows and Linux on x86.

If you are installing the WebSphere Message Broker 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 WebSphere Message Broker components and prerequisite products in silent mode on Linux, UNIX, and Windows. For more information, see Installing WebSphere Message Broker components and prerequisite products by using the sample script file.

If you are installing the WebSphere Message Broker 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 WebSphere Message Broker components that you are installing. For more information, see Memory and disk space requirements.
  3. Before installing WebSphere Message Broker 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 WebSphere Message Broker Toolkit from a server or if you want to install the WebSphere Message Broker Toolkit locally. These choices are described in Accessing CDs and DVDs for CDs, 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 WebSphere Message Broker Toolkit or if you want to complete a silent installation. For more information about these interfaces, see How to install and uninstall the WebSphere Message Broker Toolkit. If you decide to use the installation wizard graphical interface, continue with these instructions. Alternatively, to use a silent installation, see Installing the WebSphere Message Broker Toolkit in silent mode.

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

  6. Start the installation wizard graphical interface by navigating to the /Message_Broker_Toolkit_V8.0/disk1 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 WebSphere Message Broker Toolkit, therefore the WebSphere Message Broker 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 WebSphere Message Broker 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 WebSphere Message Broker 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 WebSphere Message Broker 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 WebSphere Message Broker Toolkit into a package group, and for further reference information about Package groups, see IBM Installation Manager.

  10. If you want to use the WebSphere Message Broker 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 WebSphere Message Broker 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 WebSphere Message Broker Toolkit without root or administrator authority, switch to a user with root or administrator authority and run the following script file from the WebSphere Message Broker Toolkit home directory to complete the installation:
    • Linux on x86: <WMBT80_Home>/wmbt/postconfig/postInstall_admin.sh
    • Windows: <WMBT80_Home>\wmbt\postconfig\postInstall_admin.bat

When you have completed the installation, see Verifying your WebSphere Message Broker installation, Checking the broker operation mode and function level, 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.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:48:12


Task topicTask topic | Version 8.0.0.7 | bh25990_