IBM WebSphere Integration Developer Version 6.2

Advanced Installation Guide

Version 6 Release 2

Note

Before using this information and the product it supports, be sure to read the general information under Notices.

This edition applies to version 6, release 2, of WebSphere Integration Developer.

Copyright International Business Machines Corporation 2008.

Quick links

Welcome to the Advanced Installation Guide for WebSphere Integration Developer.

For your convenience, here are some quick links to our most popular install topics:

Table 1. WebSphere Integration Developer quick links
Chapter Topics included in chapter
Installing with IBM Installation Manager Instructions on how to install WebSphere Integration Developer using the IBM Installation Manager.
Installing from the product launchpad program Instructions on how to use the launchpad program to install WebSphere Integration Developer.
Installing Lotus Forms software Installation of the following options:
  • IBM Lotus Forms Designer 3.5
  • IBM Lotus Forms Viewer 3.5
  • IBM Lotus Forms Server - API 3.5
  • Rational AM
Installing Asset Repository Asset Manager is an optional feature that can be installed with WebSphere Integration Developer to manage the sharing of business artifacts.
Modifying installations and Updating WebSphere Integration Developer These topics provide instructions on how to modify your installation as well as keep your version of WebSphere Integration Developer up to date.

Contents

Quick links
Chapter 1. Overview
IBM Installation Manager
Installation quick reference
Chapter 2. Installation requirements
Hardware requirements
Software requirements
Operating systems
Other software requirements
User privileges requirements
Chapter 3. Planning to install
Installation scenarios
Deciding which features to install
Features
Security considerations
Coexistence considerations
Offering coexistence considerations
Installation repositories
Setting repository preferences in Installation Manager
Package groups and the shared resource directory
Chapter 4. Preinstallation tasks
Chapter 5. Installation overview
Installing from DVD
Installing from an installation image on your workstation
Installing from an installation image
Installing from an installation image on a shared drive
Chapter 6. Installing from the product launchpad program
Starting the launchpad program
Chapter 7. Installing with IBM Installation Manager
Installation log files
Chapter 8. Installing silently
Installing and running Installation Manager in silent mode
Searching for and silently installing all available products
Silently installing updates to all currently installed products
Creating a response file with Installation Manager
Recording a response file with the Installation Manager installer
Response file commands
Silent installation preference commands
Reference: Sample response file
Silent installation commands
Silent install log files
Working with IBM Installation Manager
Installing Installation Manager on Windows
Installing Installation Manager on Linux
Starting Installation Manager on Windows
Starting Installation Manager on Linux
Uninstalling Installation Manager on Windows
Uninstalling Installation Manager on Linux
Silently installing and uninstalling Installation Manager
Silently installing Installation Manager
Silently uninstalling Installation Manager from Windows
Silently uninstalling Installation Manager on Linux
Chapter 9. Increasing the number of file handles on Linux workstations
Chapter 10. Starting WebSphere Integration Developer
Using the "-clean" option when starting WebSphere Integration Developer
Enabling the unit test environment for direct deployment
Chapter 11. Installing on Citrix Presentation Server
Configuring the Citrix Presentation Server
Chapter 12. Modifying installations
Chapter 13. Updating WebSphere Integration Developer
Chapter 14. Uninstalling WebSphere Integration Developer
Preparing to reinstall WebSphere Integration Developer after a failed uninstallation
Chapter 15. Rolling back updates
Chapter 16. Installing optional software and documentation
Installing Lotus Forms software
Information for Lotus Forms Designer installations
Information for Lotus Forms Server installations
Installing Asset Repository
Installing optional documentation
Notices
Terms of use

Chapter 1. Overview

This installation guide provides instructions for installing, updating and uninstalling WebSphere Integration Developer using IBM Installation Manager.

Refer to the WebSphere Integration Developer support site for updated documentation and troubleshooting information.

IBM Installation Manager

IBM Installation Manager is a program that helps you install the WebSphere Integration Developer packages on your workstation. It also helps you update, modify, and uninstall this and other packages that you install. A package can be a product, a group of components, or a single component that is designed to be installed by the Installation Manager.

IBM Installation Manager offers a number of time-saving features. It keeps track of what you are about to install, software components that you have already installed, and components that are available for you to install. It searches for updates so you know that you are installing the latest version of a WebSphere Integration Developer product package. Installation Manager also provides tools for managing licenses for the product packages that it installs. It provides tools for updating and modifying packages. You can also use Installation Manager to uninstall product packages.

Installation Manager comprises six wizards that make it easy to maintain your product packages through their life cycles:

Installation quick reference

Managing your WebSphere Integration Developer package installation involves several different tasks, for example installing the package, applying updates, and adding additional features to the package.

The following table presents a list of objectives related to managing your WebSphere Integration Developer package, a set of high-level steps for accomplishing each objective, and the result of performing those steps.

Table 2. Summary of installation tasks.
Installation objective Installation steps Result
Install WebSphere Integration Developer as a stand-alone product. Install the WebSphere Integration Developer package into its own package group:
  1. Begin the installation following the steps in Chapter 6. Installing from the product launchpad program
  2. On the second Location panel of the Install Packages wizard, Select Create a new package group (default).
  3. Follow the on-screen instructions on the Install Packages wizard to complete the installation.
WebSphere Integration Developer product does not share a user interface or workbench with other Eclipse-based products.
Install WebSphere Integration Developer into an existing package group of compatible product(s).
Note: Installing WebSphere Integration Developer into an existing Eclipse-only workbench environment is not supported.
Install WebSphere Integration Developer into a package group with other compatible Eclipse-based products:
  1. Begin the installation following the steps in Chapter 6. Installing from the product launchpad program
  2. On the second Location panel of the Install Packages wizard, Select Use the existing package group.
  3. Select the package group that you want to install into. For example, if you want to use WebSphere Integration Developer together with an existing compatible installation of WebSphere Business Modeler on your system, select the package group where you have installed WebSphere Business Modeler.
  4. Follow the on-screen instructions on the Install Packages wizard to complete the installation.
WebSphere Integration Developer shares a user interface, or workbench, with all products installed in the same package group.
Install WebSphere Integration Developer with the intention to install additional Eclipse-based products (for example, WebSphere Business Modeler) using Installation Manager in the future. Install WebSphere Integration Developer into its own package group:
  1. Begin the installation following the steps in Chapter 6. Installing from the product launchpad program
  2. On the second Location panel of the Install Packages wizard, Select Create a new package group (default).
  3. Follow the on-screen instructions on the Install Packages wizard to complete the installation.
  4. During subsequent installations of compatible Eclipse-based products, install additional product packages into the same package group where WebSphere Integration Developer is installed.
WebSphere Integration Developer is installed first. Additional Eclipse-based product packages are installed later and share a user interface or workbench with WebSphere Integration Developer.
Install WebSphere Process Server Test Environment after installing WebSphere Integration Developer Install the WebSphere Process Server Test Environment package:
  1. Begin the installation following the steps in Chapter 6. Installing from the product launchpad program
  2. Select the WebSphere Process Server Test Environment package from the list of Installation Package.
    Important: Deselect the WebSphere Integration Developer package to prevent this package from being reinstalled into a new package group.
  3. On the second Location panel of the Install Packages wizard, Select Use the existing package group.
  4. Select the package group that contains the installed WebSphere Integration Developer package.
  5. Follow the on-screen instructions on the Install Packages wizard to complete the installation.
    Note: When you install the test environment you will no longer receive "partial success" as an outcome. If there are issues with profile creation, APAR removal or APAR creation, the installation will be reported as successful. When you launch WebSphere Integration Developer a message will be displayed with details of the issues. See Chapter 10. Starting WebSphere Integration Developer for more information.
WebSphere Process Server Test Environment is added to the same package group as WebSphere Integration Developer, and both products share a common user interface, or workbench.
Install additional WebSphere Integration Developer features into an existing installation of WebSphere Integration Developer Version 6.2, or remove already-installed features from the WebSphere Integration Developer package. Modify the installed WebSphere Integration Developer package:
  1. From the Installation Manager Start page, click Modify Packages.
  2. Follow the steps in the wizard to add the desired features. Deselecting features removes them from the package.
Additional WebSphere Integration Developer features are installed and are made available from the WebSphere Integration Developer workbench, for example, IBM WebSphere Adapters. Features which are deselected are removed.
Install Updates to WebSphere Integration Developer Use the Update Packages wizard to update the WebSphere Integration Developer package:
  1. From the Installation Manager Start page, click Update Packages.
  2. Follow the steps in the wizard to add the recommended updates.
Recommended fixes are downloaded and applied to the WebSphere Integration Developer package.
Use WebSphere Integration Developer Version 6.2 in a different supported language. Install the national language versions of the packages, and modify the language setting for the package group:
  1. From the Installation Manager Start page, click Update Packages.
  2. Follow the steps in the wizard to apply the update containing national language support for WebSphere Integration Developer.
  3. From the Installation Manager Start page, click Modify Packages.
  4. Follow the steps in the wizard to change the language settings for the package group where WebSphere Integration Developer is installed.
Additional national language support is installed. This language setting applies to WebSphere Integration Developer and all packages installed in the same package group.
Uninstall WebSphere Integration Developer Use the Uninstall Packages wizard to uninstall the WebSphere Integration Developer package:
  1. From the Installation Manager Start page, click Uninstall Packages.
  2. Follow the steps in the wizard to complete the uninstall operation.
WebSphere Integration Developer is uninstalled. Installation Manager and other products that were installed into the same package group remain installed.
Install a set of Eclipse features and plug-ins into an existing installation of WebSphere Integration Developer Version 6.2 (for example, using Eclipse Update Manager) Install Eclipse features and plug-ins into an existing WebSphere Integration Developer installation:
  1. Add the Eclipse features into the \features directory and the plug-ins into the \plugins directory in the package group containing WebSphere Integration Developer (for example,
    For Windows
    C:\Program Files\IBM\WID62 or
    For Linux
    /opt/IBM/WID62).
  2. Restart WebSphere Integration Developer with the -clean option (see Using the "-clean" option when starting WebSphere Integration Developer.
Eclipse plug-ins are installed into the same package group as WebSphere Integration Developer and share the user interface or workbench with all products installed in the same package group.

Chapter 2. Installation requirements

This section details hardware, software, and user privilege requirements that must be met in order to successfully install and run your software.

For the most up-to-date, detailed system requirements, refer to the List of supported software for WebSphere Integration Developer.

Previous versions of WebSphere Integration Developer cannot be upgraded to version 6.2. Different versions of WebSphere Integration Developer can coexist on your workstation, but they must not be installed in the same directory.

Hardware requirements

Hardware requirements for installing WebSphere Integration Developer are described.

The following hardware must be installed before you install WebSphere Integration Developer:

Software requirements

Software and operating system requirements for installing WebSphere Integration Developer are described.

Operating systems

The following software must be installed before you install WebSphere Integration Developer:

Note: RHEL 4.0 requires libXp-1.0.0-8.i386.rpm and compat-libstdc++-33-3.2.3-55.fc5.i386.rpm

Other software requirements

Additional software requirements for installing WebSphere Integration Developer are described.

For Linux. In order to view certain product overview information, links to tutorials, samples and migration information, a compatible browser must be installed. Follow the steps below to install a compatible version of Mozilla that can be used with WebSphere Integration Developer. These changes will not replace your existing browser.

If you are using SUSE LINUX Enterprise Server, the following environment variable settings are required:

These can be set at the system level, user level, or within a script to launch the product.

To set these environment variables at the user level, add the above lines to your .profile file. In order for this to take effect you will need to logout and login again.

If this does not work or you are using another Linux distribution, use the following steps to install a compatible version of Mozilla that can be used with WebSphere Integration Developer; these changes will not replace your existing browser.

  1. Download a precompiled version of the Mozilla browser from the following site: http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7.12/contrib/mozilla-i686-pc-linux-gnu-1.7.12-gtk2+xft.tar.gz If this link does not work, look for a Linux (x86) for GTK2 and Xft build from the following site: http://www.mozilla.org/releases/
  2. Extract this file to a location on your workstation, for example, as /opt/mozilla-1.7.12-gtk2+xft.
  3. Log in as the root user or become the root user by issuing the su command.
  4. Open a command prompt and run the following commands:
    cd /opt/mozilla-1.7.12-gtk2+xft/plugins 
    tar xvfz install_flash_player_9_linux.tar.gz
    mv install_flash_player_9_linux/flashplayer.xpt . 
    mv install_flash_player_9_linux/libflashplayer.so . 
    Optional:
    rm -rf install_flash_player_9_linux 
  5. Log out as the root user.
  6. From a command prompt, run the following commands:
    cd /opt/mozilla-1.7.12-gtk2+xft 
    ./mozilla 
  7. Exit WebSphere Integration Developer and restart it with the same workspace directory.
  8. Update your .profile file to set these environment variables at the user level. In order for this to take effect you will need to logout and login again.
    export MOZILLA_FIVE_HOME=/opt/mozilla-1.7.12-gtk2+xft
    export LD_LIBRARY_PATH=$LD_LIBRARY:/opt/mozilla-1.7.12-gtk2+xft 
  9. When the Welcome is displayed, press the Home icon to refresh the content. If the Welcome is not displayed, open it using Help > Welcome.

Note: If Mozilla is located in the /usr/lib path, use /usr/../usr/lib instead of /usr/lib when setting the LD_LIBRARY_PATH and MOZILLA_FIVE_HOME variables.

For more technical information on compatible browser versions, see http://www.eclipse.org/swt/faq.php#whatisbrowser

User privileges requirements

You must have a user ID that meets the following requirements before you can install WebSphere Integration Developer.

Chapter 3. Planning to install

Read all the topics in this section before you begin to install any of the product features. Effective planning and an understanding of the key aspects of the installation process can help ensure a successful installation.

Installation scenarios

There are a number of scenarios that you can follow when installing WebSphere Integration Developer.

The following are some of the factors that might determine your installation scenario:

These are the typical installation scenarios you might follow:

Note that in the latter three scenarios you can choose to run the Installation Manager program in silent mode to install WebSphere Integration Developer. For details on running Installation Manager in silent mode, see Chapter 8. Installing silently.

Note also that you can install updates at the same time that you install the base product package.

Installing from DVD

In this installation scenario, you have the DVDs that contains the product package files, and typically you are installing WebSphere Integration Developer on your own workstation. Refer to Installing from DVD for an overview of the steps.

Installing from a downloaded electronic installation image on your workstation

In this scenario, you have downloaded the installation files from IBM Passport Advantage and you will install WebSphere Integration Developer on your own workstation. Refer to Installing from an installation image on your workstation for an overview of the steps.

Installing from an electronic installation image on a shared drive

In this scenario, you will place the electronic installation image on a shared drive so that users in your enterprise can access the installation files for WebSphere Integration Developer from a single location. Refer to Installing from an installation image on a shared drive for an overview of the steps.

Deciding which features to install

You can customize your software product by selecting which features of WebSphere Integration Developer to install.

When you install the WebSphere Integration Developer product package using IBM Installation Manager, the installation wizard displays the features available in the product package. From the features list, you can select which features to install. A default set of features is selected for you (including any required features). Installation Manager automatically enforces any dependencies between features and prevents you from clearing any required features.

Note: After you finish installing the package, you can still add or remove features from your software product by running the Modify Packages wizard in Installation Manager. See Chapter 12. Modifying installations for more information.

Features

The following table shows the features of WebSphere Integration Developer that you can choose to install. Default selections of features to install may vary. If a feature has already been installed, it will not be selected by default and will not be installed again.

Feature Description Selected for installation by default
WebSphere Adapters Adapters access programs and data on Enterprise Information Systems (EISs). Yes

Available when WebSphere Integration Developer package is selected for installation.

Portlet and Portal tools Provides tools to create, customize, test, debug, and deploy portal applications. The Portal development tools support IBM WebSphere Portal versions 6.0 and 6.1. No

Available when WebSphere Integration Developer package is selected for installation.

Asset repository client The asset repository client is a centrally accessible location for storing and sharing business process management (BPM) artifacts. IBM Rational Asset Manager V 7.1 must be installed and configured on a server so that the asset repository client can connect to it. No

Available when WebSphere Integration Developer package is selected for installation.

WebSphere Process Server profile A profile is used to define a separate runtime environment, with separate command files, configuration files, and log files. The WebSphere Process Server profile enables you to run service applications containing BPEL business processes, human tasks, transition tables, business rules, selectors, mediation flows, and other resources. If you intend to eventually deploy a service application with one or more of these resources to a WebSphere Process Server production server, then you should install the WebSphere Process Server profile. Yes

Available when WebSphere Process Test Environment package is selected for installation.

WebSphere Enterprise Server Bus profile A profile is used to define a separate runtime environment, with separate command files, configuration files, and log files. The WebSphere Enterprise Service Bus profile enables you to run service applications containing mediation flows. However, you cannot run BPEL business processes, human tasks, business rules, selectors, and other resources. If you intend to eventually deploy your service application to a WebSphere Enterprise Service Bus production server, then you should install the WebSphere Enterprise Service Bus profile. No

Available when WebSphere Process Test Environment package is selected for installation.

Rational ClearCase SCM Adapter Provides the IBM Rational ClearCase SCM and ClearCase MVFS plug-ins, which enable versioning of software artifacts in ClearCase versioned object bases (VOBs) using snapshot views and dynamic views when ClearCase VOB and view servers are also installed. No

Available when WebSphere Integration Developer package is selected for installation.

Security considerations

In WebSphere Integration Developer 6.2, both administrative security and application security are enabled by default.

Server security, including administrative security and application security, is automatically enabled for those test environment servers that you choose to install with WebSphere Integration Developer 6.2.

During installation you are prompted for a user name and password to be used for administering server security.

Note that if you disable or enable server security in a server administrative console, you must ensure that these changes are also specified for the same server in the server configuration editor or the Window -> Preferences -> Server -> Security preferences page of WebSphere Integration Developer.

Information about changing the user ID and password, and about disabling or enabling server security, is found in the Security documentation in the WebSphere Integration Developer help: Help -> Help Contents -> WebSphere Integration Developer -> Managing security.

Coexistence considerations

If you plan to install multiple IBM Eclipse-based products on the same workstation, review the information in this section.

Offering coexistence considerations

Some products are designed to coexist and share function when they are installed in the same package group. A package group is a location where you can install one or more software products or packages to share a common user interface or workbench. When you install each package, you select whether you want to install the package to an existing package group, or whether you want to create a new one. IBM Installation Manager will block products that are not designed to share or do not meet version tolerance and other requirements. If you want to install more than one product at a time, the products must be able to share a package group.

Any number of eligible products can be installed to a package group. When a product is installed, its function is shared with all of the other products in the package group. If you install a development product and a testing product into one package group, when you start either of the products, you have both the development and testing functionality available to you in your user interface. If you add a product with modeling tools, all of the products in the package group will have the development, testing, and modeling functionality available.

If you want WebSphere Integration Developer 6.2 to coexist with a Rational software product (for example, Rational Application Developer for WebSphere Software), the Rational software product must be at version 7.5.1 or higher. When you have an earlier version of the Rational software product you must correct this incompatibility by updating the version to 7.5.1 or higher, or choose a new package group. When you want to add a Rational software product to the same package group as WebSphere Integration Developer 6.2, you must install it directly at the required 7.5.1 (or higher) level by searching for available updates during the Rational installation (using Check for Other Versions and Extensions), or by pointing to the 7.5.1 update repository location along with the base Rational repository location.

Note: Each product installed into a unique location may be associated with only one package group. A product must be installed into multiple locations in order to be associated with multiple package groups.

Installation repositories

IBM Installation Manager retrieves product packages from specified repository locations.

If the WebSphere Integration Developer launchpad is used to start Installation Manager, the default repository information is passed to Installation Manager. If the Installation Manager is started directly, for example from the Start menu, you must specify an installation repositories that contain the product packages that you want to install. See Setting repository preferences in Installation Manager.

By default, IBM Installation Manager uses an embedded URL in each software development product to connect to a repository server over the Internet. Installation Manager then searches for the product packages as well as new features.

Setting repository preferences in Installation Manager

When you start the installation of Installation Manager from the WebSphere Integration Developer launchpad program, the location of the repository that contains the product package you are installing is automatically defined in IBM Installation Manager when it starts. However, if you start Installation Manager directly (for example, installing Installation Manager from a repository located on a Web server) then you must specify the repository preference (the URL for the directory that contains the product package) in Installation Manager before you can install the product package. Specify these repository locations on the Repositories page of the Preferences window.

By default, Installation Manager uses an embedded URL in each software development product to connect to a repository server through the Internet and search for installable packages and new features. Your organization may require you to redirect the repository to use intranet sites.

Note: If not installing from DVD or a local installation image, be sure to obtain the installation package repository URL from your administrator before starting the installation process.

To add, edit, or remove a repository location in Installation Manager:

  1. Start Installation Manager.
  2. On the Start page of Installation Manager, click File -> Preferences, and then click Repositories. The Repositories page opens, showing any available repositories, their locations, and whether they are accessible.
  3. On the Repositories page, click Add Repository.
  4. In the Add repository window, type the URL of the repository location or browse to it and set a file path.
  5. Click OK. The new or changed repository location is listed. If the repository is not accessible, a red x is displayed in the Accessible column.
  6. Click OK to exit.

Note: For Installation Manager to search the default repository locations for the installed packages, ensure the preference Search service repositories during installation and updates on the Repositories preference page is selected. This preference is selected by default.

Package groups and the shared resource directory

When you install the WebSphere Integration Developer package using IBM Installation Manager, you must choose a shared resource directory (if WebSphere Integration Developer is the first product to be installed using Installation Manager) and a package group.

Package groups

During the installation process, you must specify a package group for the WebSphere Integration Developer package. A package group represents a directory in which packages share a common user interface or workbench with other packages in the same group. When you install the WebSphere Integration Developer package using Installation Manager, you can create a new package group or install the packages into an existing package group. (Some packages might not be able to share a package group, in which case the option to use an existing package group will be disabled.)

Note that when you install multiple packages at the same time, all the packages are installed into the same package group.

A package group is assigned a name automatically; however, you choose the installation directory for the package group.

After you create the package group by successfully installing a product package, you cannot change the installation directory. The installation directory contains files and resources specific to the WebSphere Integration Developer package installed into that package group. Eclipse plug-ins in the product package that can potentially be used by other package groups are placed in the shared resources directory.

Shared resources directory

The shared resources directory is the directory where Eclipse plug-ins are located so that they can be used by one or more product package groups.

Important: You can specify the shared resources directory once: the first time that you install a package. For best results, use your largest drive for this. You cannot change the directory location unless you uninstall all packages.

Chapter 4. Preinstallation tasks

There are a few tasks which should be completed before beginning the installation process.

Before you install the product, complete these steps:

  1. Confirm that your system meets the requirements described in the section Chapter 2. Installation requirements.
  2. Confirm that your user ID meets the required access privileges for installing the product. See User privileges requirements.
  3. Read the section Chapter 3. Planning to install and give particular attention to the topic Coexistence considerations.
  4. For Linux. If you want to enable the product for use by users other than root, then you must set the umask variable to 0022 before you install the product. To set this variable, log in as root user, start a terminal session, and type umask 0022.

Chapter 5. Installation overview

There are three installation scenarios. Overviews for each of these scenarios are provided in this section.

The following sections provide an overview of the installation scenarios that are described in the section Installation scenarios. You can access detailed instructions from links in the main steps.

Installing from DVD

In this installation scenario, you have the DVDs that contains the installation files, and typically you are installing WebSphere Integration Developer on your own workstation.

The following are the general steps for installing from DVDs:

  1. Complete the preinstallation steps listed in Chapter 4. Preinstallation tasks.
  2. Insert the first installation DVD into your DVD drive.
  3. For Linux. Mount the DVD drive.
  4. If auto-run is enabled on your system, the WebSphere Integration Developer launchpad program automatically opens. If auto-run is not enabled and you are installing as an administrative user, start the launchpad program. Refer to Starting the launchpad program for details.
    Note: If IBM Installation Manager is not detected on your workstation, then it is installed at the same time as the WebSphere Integration Developer package.
  5. If you are installing as a non-administrative user and the launchpad program is running, stop the launchpad program.
  6. If you are installing as a non-administrative user, launch the userinst program. In a command line, change to the root directory of DVD 1 and issue the following command:
  7. Follow the on-screen instructions in the Install Packages wizard to complete the installation.
    Note: If you exit Installation Manager before completing the product installation, you must restart Installation Manager from the launchpad. If you start the Installation Manager directly, it is not preconfigured with the necessary installation repositories.
  8. For Linux. Increase the number of file handles on your workstation. For details, see Chapter 9. Increasing the number of file handles on Linux workstations.

To install any of the optional Lotus Forms software included with WebSphere Integration Developer 6.2, refer to Installing Lotus Forms software for instructions.

Installing from an installation image on your workstation

In this scenario, you download the installation files from IBM Passport Advantage and install WebSphere Integration Developer on your own workstation.

The following are the general steps for installing WebSphere Integration Developer from an electronic installation image:

  1. Ensure that your workstation has sufficient space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements.
  2. Download all required parts for the product installation image from IBM Passport Advantage to a temporary directory.
  3. Extract the downloaded files to a single directory.
    Note: For Linux. Do not include spaces in the directory names when extracting the files, or you will not be able to run the launchpad.sh command to start the launchpad from a command line.
  4. Continue with the steps in Installing from an installation image below.

Installing from an installation image

  1. Complete the preinstallation steps listed in Chapter 4. Preinstallation tasks.
  2. To install as an administrative user, start the launchpad program. For details, see Starting the launchpad program.

    If IBM Installation Manager is not detected on your workstation, then it is installed at the same time as the WebSphere Integration Developer package.

  3. To install as a non-administrative user, start the userinst program. In a command line, change to the root directory of the installation image and issue the following command:
  4. Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Chapter 7. Installing with IBM Installation Manager.
    Note: If you exit Installation Manager before completing the product installation, you must restart Installation Manager from the launchpad. If you start the Installation Manager directly, it is not preconfigured with the necessary installation repositories.
  5. For Linux. Increase the number of file handles on your workstation. For details, see Chapter 9. Increasing the number of file handles on Linux workstations.

To install any of the optional Lotus Forms software included with WebSphere Integration Developer 6.2, refer to Installing Lotus Forms software for instructions.

Installing from an installation image on a shared drive

In this scenario, you will place the electronic installation image on a shared drive so that users in your enterprise can access the installation files for WebSphere Integration Developer from a single location.

The following steps are performed by the person who places the installation image on a shared drive.

  1. Ensure that your shared drive has sufficient disk space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements for details.
  2. Download all required parts for the product installation image from IBM Passport Advantage to a temporary directory on the shared drive.
  3. Extract the installation image from the downloaded files into a single accessible directory on the shared drive.
    Note: For Linux. Do not include spaces in the directory names when unzipping the files, or you will not be able to run the launchpad.sh command to start the launchpad from a command line.

To install WebSphere Integration Developer from the installation files on the shared drive:

  1. Change to the directory containing the installation image on the shared drive.
  2. Follow the steps in Installing from an installation image.

Chapter 6. Installing from the product launchpad program

The product launchpad program provides you with a single location to view release information and start the installation process.

Use the product launchpad program to start the installation of WebSphere Integration Developer in the following cases:

Important: If you want to install WebSphere Integration Developer as a non-administrative user, you cannot use the launchpad program to start the installation process. Instead, you must manually run the userinst program from the DVD or download location. Running the userinst program provides you with the same functionality as starting the installation from the launchpad.

By starting the installation process from the launchpad program, IBM Installation Manager is automatically installed if it is not already on your computer, and it is automatically configured with the location of the repository that contains the WebSphere Integration Developer package. If you install Installation Manager by itself and then use it to install WebSphere Integration Developer, then you must set the repository locations for WebSphere Integration Developer manually. See Setting repository preferences in Installation Manager for details about how to set repository preferences in Installation Manager.

To install from the launchpad:

  1. Complete the preinstallation tasks described in Chapter 4. Preinstallation tasks, if you have not done so already.
  2. Start the launchpad program. See Starting the launchpad program.
  3. Click Install IBM WebSphere Integration Developer V6.2.

Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Chapter 7. Installing with IBM Installation Manager.

Starting the launchpad program

Complete the preinstallation tasks described in Chapter 4. Preinstallation tasks, if you have not done so already.

If you are installing from DVD and auto-run is enabled on your workstation, then the WebSphere Integration Developer launchpad starts automatically when you insert the installation disc into your DVD drive. If you are installing from an electronic installation image, or if auto-run is not configured on your workstation, then you must start the launchpad program manually.

To start the launchpad program:

  1. Insert the first WebSphere Integration Developer DVD into your DVD drive. For Linux. Ensure that you have mounted the DVD drive.
  2. If auto-run is enabled on your system, the WebSphere Integration Developer launchpad program automatically opens. If auto-run is not enabled on your system:
  3. In the Launchpad window (pictured below), click Install IBM WebSphere Integration Developer V6.2.
    The IBM WebSphere Integration Developer V6.2 Launchpad
    IBM Installation Manager will automatically launch or install, and it will already be configured to install this software.
  4. Install the product according to the instructions in Chapter 7. Installing with IBM Installation Manager.

For more information on how to install the Lotus Forms software, see Installing Lotus Forms software.

Chapter 7. Installing with IBM Installation Manager

The following steps describe installing the WebSphere Integration Developer package with the Installation Manager GUI.

If you are installing this product using the launchpad, then install manager has automatically been started and configured for you, so you may skip directly to Step 4.

  1. Start Installation Manager. You will see a window like the one shown here.
    IBM Installation Manager
    Note: If a newer version of Installation Manager is found, you are prompted to confirm that you want to install it before you can continue. Click OK to proceed. Installation Manager automatically installs the new version, restarts, and resumes.
  2. Define the repository location according to the instructions in Setting repository preferences in Installation Manager and according to the following settings:
    Extracted installation image on your workstation
    Add the repository For Windows \image_directory\disk1\diskTag.inf or For Linux. /image_directory/disk1/diskTag.inf
    Installation DVD
    Add the repository For Windows WID_DVD\diskTag.inf or For Linux. WID_DVD/diskTag.inf
  3. From the Installation Manager Start page, click Install Packages.
  4. The Install page of the Install Packages wizard lists all the packages found in the repositories that Installation Manager searched. If two versions of a package are discovered, only the most recent, or recommended, version of the package is displayed.
  5. To search for updates to the WebSphere Integration Developer package, click Check for Other Versions and Extensions.
    Note: For Installation Manager to search the predefined IBM update repository locations for the installed packages, the preference Search the linked repositories during installation and updates on the Repositories preference page must be selected. This preference is selected by default. Internet access is also required.
    Installation Manager searches for updates at the predefined IBM update repository for the product package. It also searches any repository locations that you have set. A progress indicator shows the search is taking place. You can install updates at the same time that you install the base product package.
  6. If updates for the WebSphere Integration Developer package are found, then they will be displayed in the Installation Packages list on the Install Packages page below their corresponding product. Only recommended updates are displayed by default.
  7. Select the WebSphere Integration Developer package and any updates to the package that you want to install. Updates that have dependencies are automatically selected and cleared together. Click Next to continue.
    Note: If you install multiple packages at the same time, then all the packages will be installed into the same package group.
  8. On the Licenses page, read the license agreement for the selected package.

    If you selected more than one package to install, there might be a license agreement for each package. On the left side of the License page, click each package version to display its license agreement. The package versions that you selected to install (for example, the base package and an update) are listed under the package name.

    1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
    2. Click Next to continue.
  9. If WebSphere Integration Developer 6.2 is the first package installed using Installation manager, type the path for the shared resources directory in the Shared Resources Directory field on the Location page, or accept the default path. ( For Linux. ensure that you do not include any spaces in the directory path.) The shared resources directory contains resources that can be shared by one or more package groups. Click Next to continue. The default path for an installation by an administrator is: The default path for an installation by an non-administrator is: where user_home is the base directory of the user that is installing WebSphere Integration Developer.
    Important:
    1. You can specify the shared resources directory only the first time that you install a package. Use your largest disk for this to help ensure adequate space for the shared resources of future packages. You cannot change the directory location unless you uninstall all packages.
    2. Ensure that your installation path does not contain parenthesis.
  10. On the next Location page, you can create a package group to install the WebSphere Integration Developer package into, or use an existing package group. A package group represents a directory in which packages share resources with other packages in the same group. By default, a new package group is created for WebSphere Integration Developer 6.2. If Installation Manager is aware of another package group, the Use the existing package group option is available for selection. To create a new package group:
    1. Select Create a new package group.
    2. Type the path for the installation directory for the package group. Ensure that your installation path does not contain parenthesis. ( For Linux. Ensure that you do not include any spaces in the directory path.) The name for the package group is created automatically.

      The default path for installation by an administrator is:

      • For Windows. C:\Program Files\IBM\WID62
      • For Linux. /opt/IBM/WID62

      The default path for installation by an administrator is:

      • For Windows. user_home\IBM\WID62
      • For Linux. user_home/IBM/WID62
    3. Click Next to continue.
  11. On the Languages page, choose all the languages that you would like to be able to have supported when you use this software, and click Next.
  12. On the Features page, select the package features that you want to install.
    1. Optional: To see the dependency relationships between features, select the Show Dependencies check box.
    2. Optional: Click a feature to view its brief description under Details.
    3. Select or clear features in the packages. Installation Manager will automatically enforce any dependencies with other features and display updated download size and disk space requirements for the installation.
    4. When you are finished selecting features, click Next to continue.
  13. On the Summary page, review your choices before installing the WebSphere Integration Developer package. If you want to change the choices that you made on previous pages, click Back and make your changes. When you are satisfied with your installation choices, click Install to install the package. A progress indicator shows the percentage of the installation completed.
  14. When the installation process is complete, a message confirms the success of the process.
    1. Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
    2. In the Install Package wizard, select whether you want WebSphere Integration Developer to start when you exit.
    3. Click Finish to launch the selected package.

Installation log files

You can use install log files to examine the results of an installation session.

For detailed analysis, you can look at the logs generated in the Installation Manager data area. These logs are available at For Windows C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs and For Linux. /var/ibm/InstallationManager/logs.

Chapter 8. Installing silently

You can install the WebSphere Integration Developer product package by running Installation Manager in silent installation mode. When you run Installation Manager in silent mode, the user interface is not available; instead, Installation Manager uses a response file to input the commands that are required to install the product package. You can also install Installation Manager silently using the Installation Manager installer. You can then use the installer to silently install product packages.

Running Installation Manager in silent mode enables you to use a batch process to install, update, modify and uninstall product packages through scripts.

Note that you must install Installation Manager before you can silently install the WebSphere Integration Developer package. Refer to Working with IBM Installation Manager for details on installing Installation Manager.

There are two main tasks required for silent installation:

  1. Create the response file.
  2. Run Installation Manager in silent installation mode.

A sample response file is provided for you to use (see Reference: Sample response file).

Installing and running Installation Manager in silent mode

Use the Installation Manager installer to install Installation Manager, then use Installation Manager to install product packages in silent installation mode from a command line.

Refer to the Installation Manager Web site for additional documentation on how to run it in silent mode. For example, silently installing from a repository that requires authentication (user ID and password).

The following table describes the arguments used with the silent installation command:

Argument Description
-vm
Specifies the Java launcher. In silent mode, always use java.exe on Windows, and java on other platforms.
-nosplash
Specifies that the splash screen should be suppressed.
--launcher.suppressErrors
Specifies that the JVM error dialog should be suppressed.
-silent
Specifies that the Installation Manager installer or Installation Manager should be run in silent mode.
-input
Specifies an XML response file as the input to Installation Manager installer or the Installation Manager. A response file contains commands that installer or Installation Manager runs.
-log
(Optional) Specifies a log file that records the result of the silent installation. The log file is an XML file.

Both the Installation Manager installer and the Installation Manager have an initialization or .ini file silent-install.ini that includes default values for the arguments in the table.

The Installation Manager installer is used to install the Installation Manager. Follow these steps to install the Installation Manager silently.

To install Installation Manager silently, extract the installer and switch to the eclipse subdirectory in the extracted files, then use the following commands:

After Installation Manager is installed, you can use it to install other products or you can use the Installation Manager installer to install the products.

To run Installation Manager in silent mode, run the following command from the eclipse subdirectory in the directory where you installed Installation Manager:

If you want to silently install products using the WebSphere Integration Developer installation image, from the eclipse subdirectory in the directory where you installed Installation Manager, enter the following command:

When the Installation Manager installer, or Installation Manager runs in silent installation mode; it reads the response file and writes a log file to the directory you specified. While you must have a response file when running in silent installation mode, log files are optional. The result of this execution should be a status of 0 on success and non-zero number on failure.

Searching for and silently installing all available products

You can silently search for and install updates for all available products.

To search for and silently install all available products:

  1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
  2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:

All available products known to Installation Manager are installed.

Silently installing updates to all currently installed products

You can silently search for and install updates for all currently installed products.

To search for and silently install updates for all available products:

  1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
  2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:

All available product updates known to Installation Manager are installed.

Creating a response file with Installation Manager

You can create a response file by recording your actions as you install the WebSphere Integration Developer product package using Installation Manager, or when you install the Installation Manager installer. When you record a response file, all of the selections that you make in the Installation Manager GUI are stored in an XML file. When you run Installation Manager in silent mode, Installation Manager uses the XML response file to locate the repository that contains the package, select the features to install, and so on.

To record a response file for installation (or uninstallation):

  1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager. If you installed as an administrator: If you installed as a non-administrator: where user_home is the home directory of the user that installed the Installation Manager.
  2. On a command line, type the following command to start the Installation Manager, substituting your own file name and location for the response file and (optionally) the log file:
    Note: Ensure that the file paths you enter exist; Installation Manager will not create directories for the response file and the log file.
  3. Follow the on-screen instructions in the Install Packages wizard to make your installation choices. For details, see Chapter 7. Installing with IBM Installation Manager.
  4. Click Finish, then close Installation Manager.

An XML response file is created and resides in the location specified in the command.

Recording a response file with the Installation Manager installer

You can use the Installation Manager installer to record the installation of Installation Manager and other products.

To record the installation of Installation Manager, follow these steps:

  1. Unzip the Installation Manager, then go to the InstallerImage_platform directory.
  2. To start recording, enter install -record <response file path and name> -skipInstall <agentDataLocation> -vmargs -Dcom.ibm.cic.agent.hidden=false
Recording a product install with the installer

To start recording a product install with the Installation Manager installer, follow these steps:

  1. Go to the IM_platform directory in the location where you extracted the Installation Manager: For Windows. \IM_win32 and For Linux. /IM_linux
  2. Open the install.ini file and remove the following lines: -input and @osgi.install.area/install.xml
  3. Enter the following command: install -record <response file path and name> -skipInstall <agentDataLocation>, for example: install -record
  4. Start the Installation Manager and complete the Install Packages wizard.

Response file commands

If you want to use the silent installation capabilities of Installation Manager, you need to create a response file that contains all of the commands that Installation Manager must run. The recommended way to do this is to create a response file by recording your actions as you install the WebSphere Integration Developer package. However, you can create or edit a response file manually.

There are two categories of commands for the response file:

Silent installation preference commands

While you typically specify preferences using the Preferences window, you can also specify preferences (identified as keys) in a response file for use during a silent installation.

Note: You can specify more than one preference in a response file.

When you define preferences in a response file, your XML code will look similar to the following example:

<preference
	name = "the key of the preference"
	value = "the value of the preference to be set">
</preference>

Use the following table to identify keys and their associated values for silent installation preferences:

Key Value Notes
com.ibm.cic.common.core.preferences.logLocation Specifies the location of Installation Manager log file.
Important: This key is optional and is designed for testing and debugging. If you do not specify a location for the log file, both silent installation and the UI version of Installation Manager will use the same location.
com.ibm.cic.license.policy.location Specifies a URL that defines where the remote license policy file resides.
com.ibm.cic.common.core.preferences.http.proxyEnabled True or False False is the default value.
com.ibm.cic.common.core.preferences.http.proxyHost Host name or IP address
com.ibm.cic.common.core.preferences.http.proxyPort Port number
com.ibm.cic.common.core.preferences.http.proxyUseSocks True or False False is the default value.
com.ibm.cic.common.core.preferences.SOCKS.proxyHost Host name or IP address
com.ibm.cic.common.core.preferences.SOCKS.proxyPort Port number
com.ibm.cic.common.core.preferences.ftp.proxyEnabled True or False False is the default value.
com.ibm.cic.common.core.preferences.ftp.proxyHost Host name or IP address
com.ibm.cic.common.core.preferences.ftp.proxyPort Port number
com.ibm.cic.common.core.preferences.eclipseCache c:\IBM\common (Windows)

/opt/IBM/common (Linux)

Note: The paths above are default values for this preference; typically, install packages provide their own values for this preference.
You cannot change this location if you have already installed a package.
com.ibm.cic.agent.core.pref.offering.service.repositories. areUsed True or False Change this preference to 'False' to disable it. When 'True', all linked repositories will be searched when products are installed or updated.
com.ibm.cic.common.core.preferences. preserveDownloadedArtifacts True or False Change this preference to 'False' to disable it. When true, the files required to roll the package back to a previous version are stored on your system. When false, these files are not stored. If you do not store these files, you must connect to your original repository or media to roll back.

Reference: Sample response file

You can use an XML-based response file to specify predefined information such as silent installation preferences, repository locations, installation profiles, and so on. Response files are beneficial for teams and companies that want to install installation packages silently and to standardize the locations and preferences for installation packages.

A sample response file is included as For Windows \image_directory\disk1\util\responsefile_win.txt and For Linux. /image_directory/disk1/util/responsefile_linux.txt in the extracted installation image, and as For Windows \WID_DVD\util\responsefile_win.txt and For Linux. /WID_DVD/util/responsefile_linux.txt on the product DVDs.

Silent installation commands

You can use this reference table to learn more about response file commands for use during a silent installation.

Response file commands Description

Profile

<profile 
id="the profile (package group) id" 
installLocation="the install location of
 the profile">
<data key="key1" value="value1"/>
<data key="key2" value="value2"/>

</profile>
Use this command to create a package group (or installation location). If the specified package group already exists, then the command has no effect. Currently, when creating the profile, the silent installation will also create two installation contexts; one for Eclipse and one for native. A profile is an installation location.

You can use the <data> element for setting profile properties.

The following list contains the keys currently supported and related values:

  • The eclipseLocation key specifies an existing Eclipse location value, such as c:\myeclipse\eclipse.
  • The cic.selector.nl key specifies the Natural Language (NL) locale selections, such as zh, ja, and en.
Note: Separate multiple NL values with commas.

The following list contains the currently supported language codes:

  • English (en)
  • French (fr)
  • Italian (it)
  • Simplified Chinese (zh)
  • Russian (ru)
  • Traditional Chinese (Taiwan) (zh_TW)
  • Traditional Chinese (Hong Kong) (zh_HK)
  • German (de)
  • Japanese (ja)
  • Polish (pl)
  • Spanish (es)
  • Czech (cs)
  • Hungarian (hu)
  • Korean (ko)
  • Portuguese (pt_BR)

Repositories

<server>
<repository location="http://example/
repository/">
<repository location="file:/C:/
repository/">
<!--add more repositories below-->
<...>
      </server>
Use this command to specify the repositories used during a silent installation. Use a URL or UNC path to specify remote repositories; use directory paths to specify local repositories.

Install

<install>
<offering profile= "profile id" 
features= "feature ids" 
id= "offering id" version= "offering 
version"></offering>

<!--add more offerings below>
<...>

</install>
Use this command to specify the installation packages that will be installed.

The profile ID must match an existing profile or a profile created by the set profile command.

Feature IDs can be optionally specified by a comma-delimited list, such as "feature1, feature2" and so on. If no feature IDs are specified, all the default features in the specified offering will be installed.

The version number is not required. If no version is specified, the Installation Manager will install the most recent product with the specified id and any available updates and fixes.

Note: Required features will be included for installation, even if they are not explicitly specified in the comma-delimited list.

<install modify="true"> or <uninstall modify="true"> (optional attribute)

<uninstall modify="true">
<offering profile="profileID"
 id="Id" version="Version" 
features="-"/>
</uninstall>

Use the <install modify="true"> attribute on install and uninstall commands to indicate that you want to modify an existing install. If the attribute is not set to true, the value defaults to false. If the intent of the modify operation is only to install additional language packs, then a hyphen "-" should be used in the offering feature id list to indicate no new features are being added.

Important: You must specify "modify=true" and a hyphen "-" feature list as specified in the example; otherwise, the install command will install the offering's default features and the uninstall command will remove all the features.

Uninstall

<uninstall>
<offering profile= "profile id" 
features= "feature ids" 
id= "offering id" version= "offering 
version"></offering>

<!--add more offerings below>
<...>

</uninstall>
Use this command to specify the packages that will be uninstalled.

The profile ID must match an existing profile or a profile specified in a profile command. Further, if there are no feature IDs specified, all the features in the specified offering will be uninstalled; if there are no offering IDs specified, all the installed offerings in the specified profile will be uninstalled.

Rollback

<rollback>
<offering profile= "profile id"
 id= "offering id" 
version= "offering version">
</offering>

<!--add more offerings below
<...>

</rollback>
Use this command to roll back to the specified offerings from the version currently installed on the specified profile. You cannot specify features in a roll back command.

InstallAll

<installALL/>
Note: This command is equivalent to using
-silent -installAll 
.
Use this command to silently search for and install all available packages.

UpdateAll

<updateALL/>
Note: This command is equivalent to using
-silent -updateAll 
.
Use this command to silently search for and update all available packages.

License

<license policyFile="policy file
 location"/>

For example:

<license policyFile="c:\mylicense.opt"/> 
Use this command to generate a response file containing a license command by starting the license wizard after starting Installation Manager in record mode.

During record mode, if you set flex options through the license management wizard, the options you set will be recorded in a license policy file named "license.opt" in the same directory as the generated response file; the response file will contain a license command that references the policy file.

Wizard

<launcher -mode wizard -input 
< response file >
Use this command to start Installation Manager in UI mode. The UI mode starts Installation Manager in either the install wizard or the uninstall wizard. However, in this case, the response file can only contain preference commands and install commands or preference command and uninstall commands; you can not mix install and uninstall commands in the same response file when you run Installation Manager in UI mode.

Silent install log files

You can use silent install log files to examine the results of a silent installation session.

The silent installation functionality creates an XML-based log file that records the result of the silent install execution (as long as a log file path is specified using -log <your log file path>.xml). If your silent installation session is successful, the log file will contain just the root element of <result> </result>. However, if errors occur during the installation, the silent install log file will contain error elements with messages such as:

<result>
	<error> Cannot find profile: profile id</error>
	<error> some other errors</error>
</result>

For detailed analysis, you can look at the logs generated in the Installation Manager data area. These logs are available at For Windows C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs and For Linux. /var/ibm/InstallationManager/logs. By using a preference command, you can optionally set the data area to your preferred location, as shown in the response file topic.

Working with IBM Installation Manager

This section deals with some common tasks relating to IBM Installation Manager. For more information, see the Installation Manager online help.

Installing Installation Manager on Windows

If you start the installation of your product from the launchpad program, then the installation of IBM Installation Manager is performed automatically if it is not already installed on your workstation. (For more information on this process, refer to Chapter 6. Installing from the product launchpad program.) In other cases, you must manually start the installation of Installation Manager.

To start the installation of Installation Manager manually:

  1. Run install.exe from the IM_win32 folder in the installation image.
  2. Click Next on the Install Packages page.
  3. Review the license agreement on the License Agreement page and select I accept the terms in the license agreement to accept. Click Next.
  4. Click the Browse button on the Destination Folder page to change the installation location if required. Click Next.
  5. Click Install on the Summary page. When the installation process is complete, a message confirms the success of the process.
  6. Click Finish. IBM Installation Manager opens.

Installing Installation Manager on Linux

If you start the installation of your product from the launchpad program, then the installation of IBM Installation Manager is performed automatically if it is not already installed on your workstation. For more information on this process, refer to Chapter 6. Installing from the product launchpad program.

To install Installation Manager manually:

  1. Open a terminal window with root user privileges.
  2. Run install from the IM_linux folder in the installation image.
  3. Click Next on the Install Packages screen.
  4. Review the license agreement on the License Agreement page and select I accept the terms in the license agreement to accept. Click Next.
  5. If necessary, edit the installation directory location. Click Next.
  6. Click Install on the information summary page. When the installation process is complete, a message confirms the success of the process.
  7. Click Finish. IBM If you start the installation of your product from the launchpad program, then the installation of IBM Installation Manager is performed automatically if it is not already installed on your workstation. opens.

Starting Installation Manager on Windows

If you start the installation of your product from the launchpad program, then the installation of IBM Installation Manager is performed automatically if it is not already installed on your workstation. This automatic installation starts Installation Manager with a configured repository preference and selected WebSphere Integration Developer packages. If you start Installation Manager directly, then you must set a repository preference and choose product packages manually. For more information, see Chapter 3. Planning to install.

To start Installation Manager manually:

  1. Open the Start menu from the Taskbar.
  2. Select All Programs -> IBM Installation Manager -> IBM Installation Manager.

Starting Installation Manager on Linux

If you start the installation of your product from the launchpad program, then the installation of IBM Installation Manager is performed automatically if it is not already installed on your workstation. This automatic installation starts Installation Manager with a configured repository preference and selected WebSphere Integration Developer packages. If you start Installation Manager directly, then you must set a repository preference and choose product packages manually. For more information, see Chapter 3. Planning to install.

To start Installation Manager manually:

  1. Open a terminal window with root user privileges.
  2. Change directory to the installation directory for Installation Manager (by default, /opt/IBM/InstallationManager/eclipse for an installation by a root user; user_home/IBM/InstallationManager/eclipse for an installation by a non-root user) and run IBMIM.

Uninstalling Installation Manager on Windows

To uninstall Installation Manager:

  1. Open the Start menu from the Taskbar.
  2. Select All Programs -> IBM Installation Manager -> Uninstall IBM Installation Manager.
  3. Click Next on the Uninstall page. The Installation Manager is selected for uninstallation.
  4. Click Uninstall in the Summary page.

Note: You can also uninstall Installation Manager by using the Control Panel. Click Start -> Settings -> Control Panel, and then double-click Add or Remove Programs. Select the entry for IBM Installation Manager and click Remove.

Uninstalling Installation Manager on Linux

IBM Installation Manager must be uninstalled using the package management tool that is included with your Linux version.

To uninstall Installation Manager manually on Linux:

  1. Open a terminal window with root user privileges.
  2. Change directory to the uninstallation directory of Installation Manager. By default, this is /var/ibm/InstallationManager/uninstall.
  3. Run ./uninstall.

Silently installing and uninstalling Installation Manager

IBM Installation Manager can be silently installed and uninstalled.

Silently installing Installation Manager

To install Installation Manager silently, extract the installer and switch to the InstallerImage_platform subdirectory, then use the following commands:

After installation, you can use Installation Manager or the Installation Manager installer to silently install packages.

Silently uninstalling Installation Manager from Windows

To silently uninstall Installation Manager on Windows:

  1. From a command line, go to the uninstall directory for the Installation Manager. By default, this is C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\uninstall.
  2. Enter the following command: uninstallc.exe --launcher.ini silent-uninstall.ini

Silently uninstalling Installation Manager on Linux

To silently uninstall Installation Manager on other platforms:

  1. From a terminal window, go to the directory uninstallation directory of Installation Manager. By default, this is /var/ibm/InstallationManager/uninstall).
  2. Run the following command: uninstall --launcher.ini silent-uninstall.ini

Chapter 9. Increasing the number of file handles on Linux workstations

Increase the number of file handles available for WebSphere Integration Developer on Linux.

Important: For best results, before you work with your product, increase the number of file handles available for WebSphere Integration Developer, because it uses more than the default limit of 1024 file handles per process. A system administrator might need to make this change.

Exercise caution when using the following these steps to increase your file descriptors on Linux. Failure to follow the instructions correctly might result in a computer that will not start correctly. For best results, have your system administrator perform this procedure.

To increase your file descriptors:

  1. Log in as root. If you do not have root access you will need to obtain it before continuing.
  2. Change to the etc directory
  3. Use the vi editor to edit the initscript file in the etc directory. If this file does not exist, type vi initscript to create it.
    Important: If you decide to increase the number of file handles, do not leave an empty initscript file on your computer. If you do so, your workstation will not start up the next time that you turn it on or restart.
  4. On the first line, type ulimit -n 4096 (the key here is that the number is significantly larger than 1024, the default on most Linux computers).
    CAUTION:
    Do not set this too high because it can seriously impact system-wide performance.
  5. On the second line, type eval exec "$4".
  6. Save and close the file after making sure you have done steps 4 and 5.
    Note: Ensure you have followed the steps correctly, as not doing this correctly will result in a workstation that does not boot.
  7. Optional: Restrict your users or groups by modifying the limits.conf file in the etc directory. Both SUSE Linux Enterprise Server (SLES) Version 9 and Red Hat Enterprise Linux Version 4.0 have this file by default. If you do not have this file, you might consider a smaller number in step 4 above (for example, 2048). You need to do this so that most users have a reasonably low limit on the number of allowable open files per process. If you used a relatively low number in step 4, it is less important to do this. However, if you choose to set a high number in step 4, refraining from establishing limits in the limits.conf file can seriously impact computer performance.

    The following is a sample limits.conf file would look that restricts all users and then sets different limits for others afterwards. This sample assumes you set descriptors to 8192 in step 4 earlier.

    *      soft nofile 1024
    *      hard nofile 2048
    root    soft nofile 4096
    root    hard nofile 8192
    user1   soft nofile 2048
    user1 hard nofile 2048

    Note that the * in the example above sets the limits for all users first. These limits are lower than the limits that follow. The root user has a higher number of allowable descriptors open, while user1 is in between the two. Make sure you read and understand the documentation contained within the limits.conf file before making your modifications.

For more information on the ulimit command, refer to the man page for ulimit.

Chapter 10. Starting WebSphere Integration Developer

You can start WebSphere Integration Developer from the desktop environment or a command-line interface.

To start WebSphere Integration Developer from the desktop environment:

For Windows Click Start -> Programs -> package group name -> IBM WebSphere Integration Developer 6.2 -> WebSphere Integration Developer 6.2. For example, click Start -> Programs -> IBM WebSphere Integration Developer -> IBM WebSphere Integration Developer 6.2 -> WebSphere Integration Developer 6.2

For Linux Select the product shortcut on the main menu under package group name -> WebSphere Integration Developer 6.2. For example, click IBM WebSphere Integration Developer -> WebSphere Integration Developer 6.2

To start WebSphere Integration Developer from a command-line:

For Windows From the package group installation directory, run the wid.exe command. By default, the package group installation directory is C:\Program Files\IBM\WID62 if you installed as an administrative user, user_home\IBM\WID62 if you installed as a non-administrative user.

For Linux. From the package group installation directory, run the ./wid.bin command. By default, the package group installation directory is /opt/IBM/WID62 if you installed as an administrative user, user_home/IBM/WID62 if you installed as a non-administrative user.

Note: On Windows Ensure that the Windows date and time are correct and match the settings of your BIOS. If the date and time are not correctly set, WebSphere Integration Developer will fail to launch with the following error message:
Exception in org.eclipse.equinox.internal.p2.reconciler.dropins.Activator.start() of bundle org.eclipse.equinox.p2.reconciler.dropins

WebSphere Integration Developer launches. If you chose to install the WebSphere Process Server or WebSphere Enterprise Service Bus test environment and the result of this installation was a partial success, the Test environment issues panel is displayed when you launch WebSphere Integration Developer. The types of error that can lead to a partial success include installation errors and profile creation errors. Read the description of the errors and take any necessary steps to resolve the problems. You can then choose to suppress this message in the future by selecting the issue in the upper pane and clicking Remove. The removal of the issue is not complete until you click OK. This Test environment issues panel is displayed each time you launch WebSphere Integration Developer until all issues have been resolved or removed.

Using the "-clean" option when starting WebSphere Integration Developer

The -clean option can be used on WebSphere Integration Developer startup and it performs several functions.

WebSphere Integration Developer is based on the Eclipse Platform which caches all plugin.xml files into a single repository for quicker loading. If you used WebSphere Integration Developer before installing a new plug-in, you should start WebSphere Integration Developer once with the -clean option.

  1. From a command line, change to the package group installation directory where you installed WebSphere Integration Developer.
  2. Run the command For Windows wid.exe -clean or For Linux. ./wid.bin -clean to start WebSphere Integration Developer.

This -clean option forces WebSphere Integration Developer to rebuild the Eclipse repository. This applies to anything that is installed into Eclipse by unzipping it into its plugins folder. The option also

Beyond this it is up to each plug-in that is listed in the configuration directory to handle what it does when -clean is used.

It is a good practice to start up WebSphere Integration Developer using the -clean option after applying any Interim Fixes. This will ensure that the plug-in registry is regenerated to reflect any changes from the applied fixes. This only needs to be done once after applying any Interim Fix, as running with -clean takes considerable time in regenerating the plug-in registry.

Enabling the unit test environment for direct deployment

If you want to use the unit test environment as a test server, set WebSphere Integration Developer up on a dedicated computer. Your unit test environment can be enabled for direct deployment.

The IT administrator should set up the unit test environment as a test server when five or fewer business users will be testing process deployment. (Note that the license agreement refers to this setup of the unit test environment as the managed test environment.) If a larger number of business users need to test deployment, it is advisable to set up a managed deployment environment using WebSphere Process Server and, optionally, WebSphere Business Monitor.

It is recommended that you use one of

as the operating system of your test server and that you have 3 GB RAM on this server. Other operating systems are supported, but as the number of testers increases the memory demands on the server increase and the listed operating systems are the preferred choice. WebSphere Business Monitor is not supported on Linux, if you intend to use both WebSphere Process Server and WebSphere Business Monitor it is recommended that you use Windows Server 2008.

Recommendation: To prevent users from getting a browser error that the security certificate is not trusted, use a certificate for the test server signed by a trusted certifying authority.

An application is provided to enable the unit test environment for direct deployment. The application is called "TestController62". Take the following steps to install the application and enable your test environment for direct deployment.

  1. Verify that TestController62.ear is installed.

    The application is installed automatically the first time that you use the integration test client. Perform the following steps to verify that the application is installed on your test server.

    1. On your test environment server, open the administrative console and browse to Applications -> Enterprise Applications.
    2. Look for the "TestController" application in the list of installed applications.
    3. If the application is installed then you do not need to do anything more.
    If the "TestController" application is not installed, complete the next step to install the application.
  2. Install the "TestController" application.
    1. Browse to Applications > Install New Application.
    2. Click Browse and select TestController62.ear application from the WID_install\wid\util directory.
    3. Accept all default settings during installation.
    4. Save your configuration after installation.
  3. Start the "TestController" application from the administrative console.

    Select the "TestController" application from the list and click Start.

Your test environment is enabled for direct deployment.

Chapter 11. Installing on Citrix Presentation Server

You can install and run WebSphere Integration Developer on a Citrix Presentation Server so that multiple users can then connect remotely from their Citrix Presentation Server clients.

Follow these instructions to install WebSphere Integration Developer to run on Citrix Presentation Server.

Note: Throughout this text, the terms "installer" and "product installer" refer to the user ID that installed WebSphere Integration Developer.

  1. When you install WebSphere Integration Developer on the server, ensure that you are logged on as a user with Administrator access.
  2. After installing, ensure that the install directory is read-only. This is the product directory, not the shared install directory. This step will ensure that the configuration information is written in the home directory. If this measure is not taken, all users will end up using the same location for their configuration area, which is not supported.
    Note: Ensure that client users are granted write permission of the following directory otherwise the integrated test environment server status cannot be detected:<WID_install_root>\runtimes\base_v62_stub\
  3. When launching WebSphere Integration Developer from a client, the workspace is created in a directory specified by the user.
  4. In order to use the servers in the test environment, a profile is required for each non-root user. The product installer (who can be a root/Administrator or non-root user) can grant write permission to the appropriate WebSphere Process Server files and directories to other non-root users. The non-root users can then create profiles. Alternatively, the product installer can create a group for users who are authorized to create profiles or give individual users the authority to create profiles. The following example task shows how to create a group that is authorized to create profiles.

Configuring the Citrix Presentation Server

The installer can perform the following steps to create the "profilers" group and give the group appropriate permissions to create a profile.

  1. Log on to the WebSphere Integration Developer system as the product installer (the product installer can be a root/Administrator or non-root user).
  2. Using operating system commands, do the following:
    1. Create a group named "profilers", which will contain all users who can create profiles.
    2. Create a user named user1, who can create profiles.
    3. Add users product_installer and user1 to the profilers group.
  3. For Linux For Unix Log off and log back on as the installer to pick up the new group.
  4. As the product installer, use operating system tools to change directory and file permissions.
    1. For Linux For Unix The following example assumes that the variable $WASHOME is the WebSphere Process Server root installation directory /opt/IBM/WebSphere/ProcServer:
      export WASHOME=/opt/IBM/WebSphere/ProcServer
      echo $WASHOME
      echo "Performing chggrp/chmod per WAS directions..."
      chgrp profilers $WASHOME/logs/manageprofiles
      chmod g+wr  $WASHOME/logs/manageprofiles
      chgrp profilers $WASHOME/properties
      chmod g+wr  $WASHOME/properties
      chgrp profilers $WASHOME/properties/fsdb
      chmod g+wr  $WASHOME/properties/fsdb
      chgrp profilers $WASHOME/properties/profileRegistry.xml
      chmod g+wr  $WASHOME/properties/profileRegistry.xml
      chgrp -R profilers $WASHOME/profileTemplates
    2. For HP-UX Issue the following additional command where profile_template_name is default, dmgr, or managed, respectively:
      chmod -R g+wr $WASHOME/profileTemplates/profile_template_name/documents
      The ownership of files is preserved when the files are copied to the profile directory during profile creation. You granted write permission to the profile directory so that files copied to the profile directory can be modified as part of the profile creation process. Files that are already in the profileTemplate directory structure prior to the start of profile creation are not modified during profile creation.
    3. For Linux Issue the following additional commands:
      chgrp profilers $WASHOME/properties/Profiles.menu
      chmod  g+wr $WASHOME/properties/Profiles.menu
    4. For Windows The following example assumes that the variable $WASHOME is the WebSphere Process Server root installation directory C:\Program Files\IBM\WebSphere\ProcServer. Follow instructions in the Windows documentation to give the profilers group read and write permission to the following directories and their files:
      @WASHOME\logs\manageprofiles
      @WASHOME\properties
      @WASHOME\properties\fsdb
      @WASHOME\properties\profileRegistry.xml
      You might have to change the permissions on additional files if the non-root user encounters permission errors. For example, if the product installer authorizes a non-root user to delete a profile, then product installer might have to delete the following file:
    5. For Linux For Unix
      install_root/properties/profileRegistry.xml_LOCK
    6. For Windows
      install_root\properties\profileRegistry.xml_LOCK
      Give write access to the non-root user for the file to authorize the user to delete the file. If the non-root user still cannot delete the profile, then the product installer can delete the profile.

The installer created the profilers group and gave the group proper permissions to certain directories and files to create profiles. These directories and files are the only ones in the installation root of WebSphere Integration Developer to which a non-root user needs to write to create profiles.

Chapter 12. Modifying installations

The Modify Packages wizard in the IBM Installation Manager enables you to change the language and feature selections of an installed product package.

Note: Close all programs that were installed using Installation Manager before modifying.

To modify an installed product package:

  1. From the Start page of the Installation Manager, click the Modify Packages icon.
  2. In the Modify Packages wizard, select the installation location for the WebSphere Integration Developer product package and click Next.
  3. On the Modify page, under Languages, select the languages for the package group, then click Next. The corresponding national language translations for the user interface and documentation for the packages will be installed. Note that your choices apply to all packages installed under this package group.
  4. On the Features page, select the package features that you want to install and/or deselect the features that you want to remove.
    1. To learn more about a feature, click the feature and review the brief description under Details.
    2. If you want to see the dependency relationships between features, select the Show Dependencies check box. When you click a feature, any features that depend on it and any features that are its dependents are shown in the Dependencies window. As you select or exclude features in the packages, Installation Manager will automatically enforce any dependencies with other features and display updated download size and disk space requirements for the installation.
  5. When you are finished selecting features, click Next.
  6. On the Summary page, review your choices before modifying the installation package, and then click Modify.
  7. Optional: When the modification process completes, click View Log File to see the complete log.

Chapter 13. Updating WebSphere Integration Developer

You can install updates for packages that were installed using IBM Installation Manager.

By default, Internet access is required unless your repository preferences points to your local update site.

Each installed package has the location embedded for its default IBM update repository. For Installation Manager to search the IBM update repository locations for the installed packages, the preference Search service repositories during installation and updates on the Repositories preference page must be selected. This preference is selected by default.

See the Installation Manager help for more information.

Note: Close all programs that were installed using Installation Manager before updating.

To find and install product package updates:

  1. From the Start page of the Installation Manager, click Update Packages.
  2. If IBM Installation Manager is not detected on your system or if an older version is already installed, then you must continue with the installation of the latest release. Follow the on-screen instructions in the wizard to complete the installation of IBM Installation Manager
  3. In the Update Packages wizard, select the location of the package group where the WebSphere Integration Developer product package you want to update is installed or select the Update All check box, and then click Next. Installation Manager searches for updates in its repositories and the predefined update sites for WebSphere Integration Developer. A progress indicator shows the search is taking place.
  4. If updates for a package are found, then they are displayed in the Updates list on the Update Packages page below their corresponding package. Only recommended updates are displayed by default. Click Show all to display all updates found for the available packages.
    1. To learn more about an update, click the update and review its description under Details.
    2. If additional information about the update is available, a More info link will be included at the end of the description text. Click the link to display the information in a browser. Review this information before installing the update.
  5. Select the updates that you want to install or click Select Recommended to restore the default selections. Updates that have a dependency relationship are automatically selected and cleared together.
  6. Click Next to continue.
  7. On the Licenses page, read the license agreements for the selected updates. On the left side of the License page, the list of licenses for the updates you selected is displayed; click each item to display the license agreement text.
    1. If you agree to the terms of all the license agreements, click I accept the terms of the license agreements.
    2. Click Next to continue.
  8. On the Summary page, review your choices before installing the updates.
    1. If you want to change the choices you made on previous pages, click Back, and make your changes.
    2. When you are satisfied, click Update to download and install the updates. A progress indicator shows the percentage of the installation completed.
    Note: During the update process, Installation Manager might prompt you for the location of the repository for the base version of the package. If you installed the product from DVD or other media, they must be available when you use the update feature.
  9. Optional: When the update process completes, a message that confirms the success of the process is displayed near the top of the page. Click View log file to open the log file for the current session in a new window. You must close the Installation Log window to continue.
  10. Click Finish to close the wizard.

Chapter 14. Uninstalling WebSphere Integration Developer

The Uninstall Packages option in the Installation Manager enables you to uninstall packages from a single installation location. You can also uninstall all the installed packages from every installation location.

To uninstall the packages, you must log in to the system using the same user account that you used to install the product packages. A package cannot be uninstalled when another package has a dependency on it, unless the dependent package is also selected to be uninstalled.

To uninstall the packages:

  1. Close the programs that you installed using Installation Manager.
  2. On the Start page click Uninstall Packages.
  3. In the Uninstall Packages page, select the WebSphere Integration Developer product package that you want to uninstall. Click Next.
  4. In the Summary page, review the list of packages that will be uninstalled and then click Uninstall. The Complete page is displayed after the uninstallation finishes.
  5. Click Finish to exit the wizard.

Important: Do not delete the Eclipse configuration directory after uninstalling any package. Deleting this information will interfere with the operation of Installation Manager. By default, this directory is: .

Preparing to reinstall WebSphere Integration Developer after a failed uninstallation

If you tried to remove IBM WebSphere Integration Developer and failed, this topic presents instructions on how to clean your system in order to reinstall the product.

If Installation Manager, WebSphere Integration Developer, or WebSphere Process Server Unit Test Environment is still on your system, then these verification steps do not apply.

To perform a clean uninstallation, complete the following steps:

  1. Completely remove IBM Installation Manager files:
    1. Verify that the following directories have been removed from your system:
      Directory File path
      Application data directory
      Important: If you used Installation Manager to install other products besides WebSphere Integration Developer, do not delete the application data directory or you will lose the binaries of those products.
      C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager
      User-specific application data directory C:\Documents and Settings\Username\IBM\Installation ManagerInstaller
      User temp directory
      Note: To determine the location of the temp directory, access the properties of My Computer, select the Advanced tab, and click Environment Variables.
      C:\Documents and Settings\Username\Local Settings\Temp
  2. Completely remove IBM WebSphere Integration Developer files:
    1. Delete the following directories:
      • C:\Program Files\IBM\WID62
      • C:\Program Files\SDPShared\
        Important: If you used Installation Manager to install other products besides WebSphere Integration Developer, do not delete the SDPShared directory or you will lose the binaries of those products.
  3. Completely remove IBM WebSphere Process Server Unit Test Environment files:
    1. Follow the procedure in Preparing for reinstallation after a failed uninstallation on Windows systems (or Preparing for reinstallation after a failed uninstallation on Windows systems if you have WebSphere Process Server installed) to remove WebSphere Process Server Unit Test Environment files.
      Note: If this link fails, you need to install additional documentation. In WebSphere Integration Developer, open the Resource perspective if you are not already there (click Window > Open Perspective > Other > Resource). Then, in the main menu, click Help > Software Updates. In the Software Updates and Add-ons window, select the Available Software tab. Click Add Site and specify the following location: http://publib.boulder.ibm.com/dmndhelp/downloads/v6r2mx/wid/. Expand the results under this repository location, select the documentation that you want, and click Install. You will need to restart WebSphere Integration Developer to see the additional documentation.

Chapter 15. Rolling back updates

Using the Roll back Packages wizard, you can remove an update to a package and revert to a previous version.

During the rollback process, Installation Manager must access files from the earlier version of the package. By default, these files are stored on your system when you install a package. If the files are not available on your workstation, you must include the location of the repository from which you installed the previous version of the product in your Installation Manager preferences (File > Preferences > Repository). If you installed the product from DVD or other media, they must be available when you use the rollback feature.

Use the rollback feature if you have applied an update to a product package, and decide later that you want to remove the update and revert to the earlier version of the product. When you use the rollback feature, the Installation Manager uninstalls the updated resources, and reinstalls the resources from the previous version. You can only roll back one version level at a time.

See the help in the Installation Manager for more information on using the Rollback wizard.

To roll back an updated package, complete the following steps:

  1. On the Start page, click Roll back Packages to start the Rollback wizard.
  2. From the Installation Packages list, select the package that you want to roll back.
  3. Complete the wizard according to the on-screen instructions.

Chapter 16. Installing optional software and documentation

Additional software and documentation is available WebSphere Integration Developer 6.2, and can optionally be installed.

Installing Lotus Forms software

The Lotus Forms software is included with WebSphere Integration Developer, and can optionally be installed.

The Lotus Forms software that is bundled with WebSphere Integration Developer includes:

  1. If you have downloaded the Lotus Forms software as individual compressed files, then extract them according to the following information. Otherwise, proceed to Step 2.
    1. Create the following folders, and extract the compressed files into them, where image_directory contains the extracted installation image for WebSphere Integration Developer 6.2.
  2. On the Launchpad, select the product you wish to install as shown in this image.

    To begin the installation of each product, select the product on the WebSphere Integration Developer 6.2 Launchpad:

    Note: For Linux Only IBM Lotus Forms Server - API 3.5 is available for the Linux operating system.
  3. Direct the Lotus Forms installation wizards to the folders that contain the installation material. If you are working with downloaded compressed files, then direct the installation wizards to the folders that you created in Step 1. Alternatively, if you have installation media for the Lotus Forms products, insert the DVD into the DVD drive, and direct the installation wizard to the root of the DVD.
  4. Follow the on-screen instructions to complete the installation for each Lotus Forms product you choose to install. Note the important considerations documented below.

If you are installing into an existing IBM WebSphere Integration Developer package, and you do not accept the default installation directory presented by the Lotus Forms installation wizard, ensure that you select a valid installation directory where the WebSphere Integration Developer package is installed.

Note that the installation directory for a package is distinct from the directory where shared resources are installed. For example, shared resources are, by default, installed in:

Important: Do not select this directory to install additional software products.

Information for Lotus Forms Designer installations

If you are installing Lotus Forms Designer 3.5, note the following items.

Information for Lotus Forms Server installations

If you are installing Lotus Forms Server API 3.5, note the following items.

Installing Asset Repository

Asset Repository is an optional feature that can be installed with WebSphere Integration Developer to manage the sharing of business artifacts.

Asset Repository can be installed as a feature during the installation of WebSphere Integration Developer. If however, you already have WebSphere Integration Developer installed, and would like to add Asset Repository to it, here is how to proceed.

Follow the instructions in the topic Chapter 12. Modifying installations, and choose Asset Repository from the updates list.

For more information on Asset Repository, see Sharing assets.

Installing optional documentation

You can install the product documentation for WebSphere Process Server and WebSphere Enterprise Service Bus.

You must have started WebSphere Integration Developer and be connected to the Internet to complete these steps.

  1. From the main menu change to the resource perspective.

    Click Window -> Open Perspective -> Other -> Resource.

  2. Select Help -> Software Updates.
  3. In the Software updates and Add-ons window, select the Available Software tab, click on Add Site and specify a location which points to http://publib.boulder.ibm.com/dmndhelp/downloads/wid/ and click OK.
  4. Expand the search results and select the documentation features you wish to install. Click Install and complete the Install wizard. It is important that the specified installation directory for each feature selected is the same as the installation directory of WebSphere Integration Developer 6.2. For example, For Windows C:\Program Files\IBM\WID62\.

Once you restart WebSphere Integration Developer 6.2, you will see the installed documentation integrated with the WebSphere Integration Developer documentation in Help -> Help Contents. You will also benefit from certain links within the WebSphere Integration Developer help which provide you with additional information from a runtime perspective.

Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this documentation does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Intellectual Property Dept. for WebSphere Software
IBM Corporation
3600 Steeles Ave. East
Markham, Ontario
Canada L3R 9Z7

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rights reserved.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Programming interface information

Programming interface information, if provided, is intended to help you create application software using this program.

General-use programming interfaces allow you to write application software that obtain the services of this program's tools.

However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification and tuning information is provided to help you debug your application software.

Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change.

Trademarks and service marks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Other company, product, or service names may be trademarks or service marks of others.

Terms of use

Permissions for the use of publications is granted subject to the following terms and conditions.

Personal Use: You may reproduce these publications for your personal, non commercial use provided that all proprietary notices are preserved. You may not distribute, display or make derivative work of these publications, or any portion thereof, without the express consent of IBM.

Commercial Use: You may reproduce, distribute and display these publications solely within your enterprise provided that all proprietary notices are preserved. You may not make derivative works of these publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of IBM.

Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the publications or any information, data, software or other intellectual property contained therein.

IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by IBM, the above instructions are not being properly followed.

You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations.

IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

© Copyright IBM Corporation 2005, 2008. All Rights Reserved.