IBM WebSphere Integration Developer

Advanced Installation Guide

Version 6 Release 1

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 1, of WebSphere Integration Developer.

Copyright International Business Machines Corporation 2007. All rights reserved.

Contents

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 WebSphere Integration Developer from DVD: task overview
Installing WebSphere Integration Developer from an installation image on your workstation: task overview
Installing from an installation image
Installing WebSphere Integration Developer from an installation image on a shared drive: task overview
Chapter 6. Installing WebSphere Integration Developer from the product launchpad program
Starting the launchpad program
Chapter 7. Installing WebSphere Integration Developer using the IBM Installation Manager graphical interface
Installation log files
Chapter 8. Installing WebSphere Integration Developer 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
Chapter 11. Modifying installations
Chapter 12. Updating WebSphere Integration Developer
Chapter 13. Uninstalling WebSphere Integration Developer
Chapter 14. Rolling back updates
Chapter 15. Installing optional software and documentation
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 http://www.ibm.com/software/integration/wid/support/ 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.

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

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 1. 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 WebSphere Integration Developer 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 WebSphere Integration Developer 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 WebSphere Integration Developer 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 WebSphere Integration Developer from the product launchpad program
  2. Select the WebSphere Process Server Test Environment package from the list of Installation Package.
    Important: De-select 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.
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.1, 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.1 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.1 (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\WID61 or
    For Linux
    /opt/IBM/WID61).
  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 http://www.ibm.com/support/docview.wss?rs=2308&uid=swg27010621.

Previous versions of WebSphere Integration Developer cannot be upgraded to version 6.1. For example, WebSphere Integration Developer 6.0.2 cannot be upgraded to WebSphere Integration Developer 6.1. Different versions of WebSphere Integration Developer can co-exist on your workstation, but they must not be installed in the same directory.

Hardware requirements

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

Software requirements

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

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 WebSphere Integration Developer 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 DVD that contains the product package files, and typically you are installing WebSphere Integration Developer on your own workstation. Refer to Installing WebSphere Integration Developer from DVD: task overview 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 WebSphere Integration Developer from an installation image on your workstation: task overview 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 WebSphere Integration Developer from an installation image on a shared drive: task overview 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 11. 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.

Portal tools Provides tools to create, customize, test, debug, and deploy portal applications. The Portal development tools support IBM WebSphere Portal versions 5.1 and 6.0. 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 SCA applications, BPEL business processes, human tasks, transition tables, business rules, selectors, and other resources. You can also run mediation flows that are contained in mediation modules. If you intend to eventually deploy an integration module 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 mediation flows contained in mediation modules. However, you cannot run BPEL business processes, human tasks, business rules, selectors, and other resources. If you intend to eventually deploy your mediation module 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.

Security considerations

In WebSphere Integration Developer 6.1, 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.1. The default user ID and password for server security are admin and admin. However, it is strongly recommended that you change the default user ID and password to better secure your test environment servers and business integration applications.

Note that if you change the default user ID and password or 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 default 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.1 to coexist with a Rational software product (for example, Rational Application Developer for WebSphere Software), the Rational software product must be at version 7.0.0.5 or higher. When you have an earlier version of the Rational software product you must correct this incompatibility by updating the version to 7.0.0.5 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.1, you must install it directly at the required 7.0.0.5 (or higher) level by searching for available updates during the Rational 7.0 installation (using Check for Other Versions and Extensions), or by pointing to the 7.0.0.5 update repository location along with the base Rational 7.0 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.

Important: For Windows Vista. To enable users who do not have Administrator privileges to work with WebSphere Integration Developer in the Windows Vista operating system, do not choose a directory inside the Program Files directory (C:\Program Files\) for the location of the package group.

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 four 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 WebSphere Integration Developer from DVD: task overview

In this installation scenario, you have the DVD 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 a DVD:

  1. Complete the preinstallation steps listed in Chapter 4. Preinstallation tasks.
  2. Insert the installation DVD into your DVD drive.
  3. For Linux. Mount the DVD drive.
  4. If autorun is enabled on your system, the WebSphere Integration Developer launchpad program automatically opens. If autorun is not enabled, 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. 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.
  6. 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.1, refer to Chapter 15. Installing optional software and documentation for instructions.

Installing WebSphere Integration Developer from an installation image on your workstation: task overview

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.

To install any of the optional Lotus Forms software included with WebSphere Integration Developer 6.1, refer to Chapter 15. Installing optional software and documentation for instructions.

Installing from an installation image

  1. Complete the preinstallation steps listed in Chapter 4. Preinstallation tasks.
  2. Start the launchpad program. Refer to Starting the launchpad program for details.
  3. Start the installation of WebSphere Integration Developer from the Launchpad. 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.

  4. Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Chapter 7. Installing WebSphere Integration Developer using the IBM Installation Manager graphical interface.
    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 pre-configured 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.

Installing WebSphere Integration Developer from an installation image on a shared drive: task overview

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 toHardware 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 WebSphere Integration Developer 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:

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 WebSphere Integration Developer.

Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Chapter 7. Installing WebSphere Integration Developer using the IBM Installation Manager graphical interface.

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 a DVD and autorun 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 autorun is not configured on your workstation, then you must start the launchpad program manually.

To start the launchpad program:

  1. Insert the WebSphere Integration Developer DVD into your DVD drive. For Linux. Ensure that you have mounted the DVD drive.
  2. If autorun is enabled on your system, the WebSphere Integration Developer launchpad program automatically opens. If autorun is not enabled on your system:

The IBM WebSphere Integration Developer V6.1 Launchpad

Chapter 7. Installing WebSphere Integration Developer using the IBM Installation Manager graphical interface

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

When the extracted installation image is on your workstation or when you have the WebSphere Integration Developer installation DVD, follow the steps in Setting repository preferences in Installation Manager to specify the repository location of the installation images for WebSphere Integration Developer, and for the WebSphere Process Server and WebSphere Enterprise Service Bus test environments by using the following information:

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

Once the repository location has been defined, complete the following steps in Installation Manager:

  1. From the Installation Manager Start page, click Install Packages.
    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. 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.
  3. Click the WebSphere Integration Developer package to display its description in the Details pane.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. If WebSphere Integration Developer 6.1 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. (If you are installing on 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 is:
    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.
  9. 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.1. 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.
      Important: For Windows Vista. If you are performing an installation on Windows Vista, to enable users who do not have Administrator privileges to work with WebSphere Integration Developer, do not choose a directory inside the Program Files directory (C:\Program Files\).

      The default path is:

      • For Windows. C:\Program Files\IBM\WID61
      • For Linux. /opt/IBM/WID61
    3. Click Next to continue.
  10. On the Features page, select the package features that you want to install.
    1. Optional: To see the dependency relationships between features, select Show Dependencies.
    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.
  11. 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.
  12. 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 WebSphere Integration Developer 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. For example:
  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 WebSphere Integration Developer using the IBM Installation Manager graphical interface.
  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 by removing 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 DVD.

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 WebSphere Integration Developer 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 WebSphere Integration Developer 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) 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

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.

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.1 -> WebSphere Integration Developer 6.1. For example, click Start -> Programs -> IBM WebSphere Integration Developer -> IBM WebSphere Integration Developer 6.1 -> WebSphere Integration Developer 6.1

For Windows Vista If the installation location or shared resources directory for WebSphere Integration Developer is in a directory in the path C:\Program Files\, then you must run WebSphere Integration Developer as the administrator. To run as administrator, right-click the program shortcut and click Run as administrator.

On Windows Vista, the Program Files directory is virtualized in order to allow users who are not running as the administrator to have write access to this protected directory. However, the virtualization workaround is not compatible with WebSphere Integration Developer.

If you selected an installation location or shared resources directory in the path C:\Program Files\ on Windows Vista and you do not want to require running WebSphere Integration Developer as administrator, then complete one of the following steps:

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

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\WID61 for Windows XP and Windows Server, and C:\Program Files_IBM\WID61 for Windows Vista installations.

For Linux. From the package group installation directory, run the ./wid.bin command. By default, the package group installation directory is /opt/IBM/WID61.

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.

Chapter 11. 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 Show Dependencies. 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 12. 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 13. 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 For Windows C:\Program Files\IBM\WID61\configuration\, and For Linux /opt/IBM/WID61 or $USER_HOME/.eclipse depending on your permissions.

Chapter 14. 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 15. Installing optional software and documentation

Additional software is made available with WebSphere Integration Developer 6.1 and can optionally be installed.

The following optional software is included with WebSphere Integration Developer:

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

Note: For Linux Only IBM Lotus Forms Server - API 3.0 is available for the Linux operating system.
  1. On the Launchpad, select the product you wish to install.

    If you have the electronic installation image of WebSphere Integration Developer 6.1 extracted to \image_directory\, the Lotus Forms installation wizards need to be directed as follows:

    If you have installation media for the Lotus Forms products, insert the CD into the CD drive, and direct the installation wizard to the root of the CD.

  2. 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 installed in For Windows C:\Program Files\IBM\SDP70Shared\ and For Linux. /IBM/SDP70Shared/ by default.

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

If you are installing Lotus Forms Designer 3.0, note the following items:

If you are installing Lotus Forms Server - API 3.0, note the following items:

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, select Help -> Software Updates -> Find and Install...
  2. In the Feature Updates window, select Search for new features to install and click Next:
  3. On the Updates sites to visit page, create a New Remote Site... that points to http://publib.boulder.ibm.com/dmndhelp/downloads/wid/ and click Finish.
  4. Expand the search results and select the documentation features you wish to install. Click Next and complete the Install wizard. It's important that the specified installation directory for each feature selected is the same as the installation directory of WebSphere Integration Developer 6.1. For example, For Windows C:\Program Files\IBM\WID61\.

Once you restart WebSphere Integration Developer 6.1, 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

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

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 documentation 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(R) 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 documentation. The furnishing of this documentation does not give 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 (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, 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 OR CONDITIONS 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 Integration Developer
IBM Canada Ltd.
8200 Warden Avenue
Markham, Ontario L6G 1C7
Canada

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 documentation 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.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples may 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 illustrates 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. 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 IBM's application programming interfaces.

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

(C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. 2000, 2007. All rights reserved.

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

Programming interface information

Programming interface information 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, IBM Logo, WebSphere, Rational, DB2, Universal Database DB2, Tivoli, Lotus, Passport Advantage, developerWorks, Redbooks, CICS, z/OS, and IMS are trademarks or registered trademarks of International Business Machines Corporation in the United States or other countries or both.

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

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

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

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

Adobe is either a registered trademark or trademark of Adobe Systems Incorporated in the United States, other countries, or both.

Other company, product and service names because 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.

(C) Copyright IBM Corporation 2005, 2007. All Rights Reserved.