Installing with IBM Installation Manager

You can install IBM® Integration Designer interactively using the Installation Manager.

Before you begin

Important: If you are installing IBM Integration Designer with its test environment as a nonadministrative or nonroot user and you intend to install the test environment, you must install DB2 before you begin the product installation

About this task

If you are installing this product using the launchpad, then Installation Manager has automatically been started and configured for you, so you can skip directly to Step 2.
Tip: If you try to install IBM Integration Designer and the test environment on a system with an existing Rational® Application Developer 8.0.x installation, Installation Manager only displays the option for you to select the same package group in which Rational Application Developer 8.0.x is installed. To install IBM Integration Designer and the test environment to a different package group, install IBM Integration Designer before you install the test environment. Installation Manager displays the choice of whether to install into a new package group or into the existing Rational Application Developer 8.0.x package group. After you have installed IBM Integration Designer, you can then install the test environment.

Procedure

  1. Optional: If you are NOT installing from the launchpad, complete the following steps:
    1. Start Installation Manager from the Windows Start Menu or from a command line. See Starting Installation Manager for instructions.
      Note: If a newer version of Installation Manager is found, you are prompted to confirm that you want to install it before you can continue. Click OK to proceed. Installation Manager automatically installs the new version, restarts, and resumes.
    2. Define the repository locations according to the instructions in Specifying repository locations. The repository locations are image_directory/disk1/IMwid75/repository.config (for IBM Integration Designer) and image_directory/WTE_Disk/repository/repository.config (for the test environment), where image_directory contains the extracted installation image for IBM Integration Designer.
    3. From the Installation Manager Start page, click Install.
  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.
    • To display all versions of any package found by Installation Manager, select the Show all versions check box.
    • To return to the display of only the recommended packages, clear the Show all versions check box.
  3. To search for updates to the IBM Integration Designer package, click Check for Other Versions, Fixes, and Extensions.
    Note: For Installation Manager to search the predefined IBM update repository locations for the installed packages, the preference Search service repositories during installation and update 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.
  4. If updates for the IBM Integration Designer 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.
    • To view all updates found for the available packages, select the Show all versions check box.
    • To display a package description under Details, click on the package name. If additional information about the package is available, such as a readme file or release notes, a More info link is included at the end of the description text. Click the link to display the additional information in a browser. To fully understand the package you are installing, review all information beforehand.
  5. Ensure that the IBM Integration Designer package is selected and any updates to the package that you want to install. Updates that have dependencies are automatically selected and cleared together. A set of packages are selected for you based on the installation configuration that you selected. You might have to make the following changes to this set:
    • Select IBM Forms Designer if you want to create IBM Forms as the user interface to your human tasks.
    • Clear the check box for IBM Cognos Business Intelligence if you are using Windows and are not an administrative user.
    • Clear the check box for DB2 Express if you already have a local database installed or if you are not an administrative user.
    Click Next.
    Note: If you install multiple packages at the same time, then all the packages will be installed into the same package group.
    If you receive the following warning message during the prerequisite checking, use the platform-specific steps below to increase the ulimit number.
    Current system has detected a lower level of ulimit than the recommended value of recommended_value. Please increase the ulimit number to minimum value of recommended_value and re-start the installation.
    Shutdown your installer. If you are a root user open a command prompt and issue ulimit -n recommended_value and then restart the installer. If you are a non-root user, work with your system administrator to increase your ulimit -n recommended_value and then restart the installer.
    The required value is calculated based on the version of WebSphere® Application Server, the feature packs, and the configuration that you are installing.
    Set the maximum number of open files using the following command:For Linux operating system
    1. Open /etc/security/limits.conf.
    2. Locate the nofile parameter and increase the value. If a line containing the nofile parameter does not exist, add the following lines to the file:

      * hard nofile recommended_value

      * soft nofile recommended_value

    3. Save and close the file.
    4. Log off and log in again.
  6. On the Licenses page, read the license agreement for the selected packages.

    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.
  7. If IBM Integration Designer V7.5.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. The shared resources directory contains resources that can be shared by one or more package groups.
    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 parentheses.
    3. For Linux operating systemEnsure that your installation path does not contain spaces.

    Click Next to continue.

  8. On the next Location page, you can create a package group to install the IBM Integration Designer 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 IBM Integration Designer V7.5.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. Enter the path for the installation directory for the package group. Ensure that your installation path does not contain parentheses. (For Linux. Ensure that you do not include any spaces in the directory path). The name for the package group is created automatically.
      The default installation path is:
      • For Windows operating systemC:\IBM\IntegrationDesigner\v7.5
      • For Linux operating systemroot: /opt/IBM/IntegrationDesigner/v7.5
      • For Linux operating systemnonroot: user_home/IBM/IntegrationDesigner/v7.5
    3. If you are creating a test environment, you might want to change the default path for the test environment. Select WebSphere Application Server - ND and enter the path for the test environment. For example, if you are installing the IBM Business Process Manager Advanced - Process Server, you might change the path to: C:\IBM\Process Server\v7.5.
      The default test environment installation path is:
      • For Windows operating systemC:\Program Files\IBM\WebSphere\AppServer
      • For Linux operating systemroot: /opt/IBM/WebSphere/AppServer/
      • For Linux operating systemnonroot: user_home/IBM/WebSphere/AppServer/
    4. Click Next to continue.
  9. On the Languages page, choose all the languages that you would like to be able to have supported when you use this software, and click Next.
  10. On the Features page, select the package features that you want to install. If you did not select it, then it is not displayed as an installable feature.
    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.
      • If you expand IBM Integration Designer, you can select from a list of available features. Some features are already selected based on the installation configuration. If you selected to install IBM Forms Designer on the Install Packages page, it is displayed and selected here.
      • If you expand IBM Business Process Manager Advanced - Process Server or Business Monitor Server and select one or more stand-alone development profiles, the profiles are created for you during installation. A profile might already be selected based on the capability set you chose.

        A stand-alone development profile is a default development profile that provides a test environment. The Process Server development profile also comes with Business Rules Manager enabled.

        If you choose not to install a default stand-alone development profile, you can install one later by launching the Installation Manager and clicking Modify on the first page.

    4. When you are finished selecting features, click Next to continue.
  11. If you selected a stand-alone development profile, on the Profiles page, enter the credentials for the test server that you are creating. The default user name is admin and the default password is admin.
  12. If you selected DB2 Express, on the Common Configurations page, enter a user name and password for DB2 and click Next. The default user name is bpmadmin and the default password is bpmadmin1.
    Important: You must change the default password if it does not comply with the password policy on your operating system (such as Windows 2008).
    Restriction: User names must not contain NL strings.
  13. On the Summary page, review your choices before installing the IBM Integration Designer package. If you want to change the choices that you made on previous pages, click Back and make your changes. When you are satisfied with your installation choices, click Install to install the package. A progress indicator shows the percentage of the installation completed.
  14. When the installation process is complete, a message confirms the success of the process. If you chose to create a stand-alone development profile during installation and it failed or did not fully succeed, you see an error message informing you of the failure and giving you the location of the profile creation error log at install_root/logs/manageprofiles/profilename_create.log. You must resolve the profile creation problem and create a profile using the Profile Management Tool or the manageprofiles command.
    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. Depending on whether you selected to install a test environment, you might be given the option to create a profile when you exit. If you have already created a stand-alone profile as part of the installation, select None.
    3. Click Finish to close the Installation Manager.