Install authoring environments, tools, and add-ons

After installing IBM Business Process Manager, you can install authoring environments as well as additional tools and add-ons. If you are installing IBM Business Process Manager Advanced, you can install IBM Integration Designer either before or after installing BPM Advanced.

To use these tools in a language that is different from your Windows installation, make sure that you have the appropriate Windows language pack installed.



Install Process Designer

Process Designer runs only on Windows. If Process Designer for authoring processes was not installed when you installed the Process Center, you can download and install Process Designer from the Process Center console. Using Installation Manager to install Process Designer is not supported.

Process Designer, Process Center, and each runtime environment must be running the same version of IBM Business Process Manager.

  1. Open the Process Center.

  2. Click the Process Designer Download option. When you are prompted, save the Process Designer.zip file to your file system. This file contains everything that you need to install and run Process Designer. Depending on the network connection, the download may take several minutes to complete.
  3. Extract the contents of the Process Designer.zip file to a temporary directory on your file system.

  4. Open a command window and change to the directory where you extracted the contents of the Process Designer.zip file.

    If you are running Windows 7, Windows Vista, or Windows Server 2008, start your command prompt by right-clicking and selecting Run as administrator.

  5. Run one of the following commands to install Process Designer. If you are in the Administrators group on Windows, you can install using the admin command. If you are not an administrative user, or to install to your own user name without administrative privileges, install using the nonadmin command.

    Default location (C:\IBM\ProcessDesigner\v8.5)

    • installProcessDesigner_admin.bat
    • installProcessDesigner_nonadmin.bat

    Different location

    • installProcessDesigner_admin.bat installLocation
    • installProcessDesigner_nonadmin.bat installLocation

    If the location has spaces in the directory name, put the whole location in quotation marks.

    The following examples show how to install to a different location.

    • installProcessDesigner_admin.bat D:\IBM\PD
    • installProcessDesigner_admin.bat "D:\Process Designer\"

Installation messages are recorded in the file %TEMP%\IBMProcessDesignerInstall.log, where the %TEMP% variable is typically set to C:\Documents and Settings\current_user_name\Local Settings\Temp.




Related tasks:

Update the Process Designer

Process Designer window is blank


Recovering from an out of memory exception while installing Process Designer

On some systems, downloading Process Designer might fail because of insufficient memory.

If you encounter an out of memory exception after clicking Download Process Designer from the Process Center, follow these steps to resolve the problem.

  1. Restart the Process Center.

  2. In the Administrative console, set a web container custom property by selecting Servers > Server Types > WebSphere application servers > server_name > Web Container Settings > Web container > Custom Properties.
  3. Define the property com.ibm.ws.webcontainer.channelwritetype and set the value to sync.

    Save changes.

  4. Stop, then restart, the Process Center.
  5. Again, click Download Process Designer from the Process Center.

The download should now complete successfully. The sync setting results in lower peak memory usage in Process Center than the default value of async.



Install IBM Integration Designer

This installation information provides instructions for installing and uninstalling IBM Integration Designer and optional features.

Refer to the IBM Integration Designer release notes file for information about product limitations, known problems, and workarounds. Also, refer to the IBM Integration Designer support site for updated documentation and troubleshooting information.

IBM Installation Manager information center


Plan to install

Planning for IBM Integration Designer before introducing its software into your enterprise information system helps ensure the system you implement meets your needs. This section describes how to plan for IBM Integration Designer.



Test environment

You have the option to use either a local test environment or a remote one. Developers using systems that are constrained on resources (CPU, memory, disk space) should consider configuring a remote test environment and pointing their IBM Integration Designer at that remote environment for testing their processes and monitor models.

As an IBM Integration Designer developer, how you set up a remote environment depends on your target deployment environment.


IBM Business Monitor

The IBM Integration Designer for IBM Business Monitor option is removed from the installation program for IBM Integration Designer V8.5. This option is no longer available from the launchpad for Integration Designer.

Although you cannot install IBM Business Monitor from the Integration Designer launchpad, you can author the monitor models in Integration Designer V8.5 and deploy them to a remote Business Monitor V8.0.1 server.


Process Server

In an IBM Integration Designer unit test environment, the server can be installed locally or on a remote machine. When Process Server is installed locally, IBM Integration Designer finds it and displays it in the Servers view.

When Process Server is installed remotely, you can target it from IBM Integration Designer by creating a new server.

Beginning with IBM Integration Designer V8.5, all servers, except for the IBM Integration Designer unit test environment and BPM Express servers, are installed with a network deployment configuration. Testing on a network deployment environment is not supported with Process Server. Therefore, if Process Server is not already included in the Servers view of the IBM Integration Designer unit test environment, and you want to create a server to use for testing integration and mediation modules, make sure the server points to Process Server.

  1. In the Servers view, right-click and select New > Server.

  2. Select IBM > Process Server.

  3. Set the remote server host name and click Next.

  4. Set the profile name, connection, and security information, and click Finish.


Process Server via Process Center

If you have a IBM Integration Designer unit test environment, Process Server can be installed locally or on a remote machine, as described in the previous section. If you have only Process Center, you can switch to the Process Center perspective and are prompted for connection information to the Process Center. To target a remote server:

  1. In the Process Center, select Window > Preferences.

  2. Select Business Integration > Process Center.

  3. Set the Process Center URI, user name, and password.

  4. Click Test Connection. If everything is correct, click OK.

Learn about the Process Center by reading Process development with the Process Center. If you experience communication problems with the remote server, such as problems in publishing to the remote server or obtaining the status of the server, see Resolve communication problems with remote servers.


Install to a unique package group

You can install IBM Integration Designer and the test environment to a unique package group on the same system with an existing Rational Application Developer 8.0.x installation. 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.



Related tasks:

Resolve communication problems with remote servers


Security considerations

In IBM Integration Designer V8.5, 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 IBM Integration Designer V8.5.

Application security is required by IBM Business Process Manager and must not be turned off in the administrative console.

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

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

Information about changing the user ID and password, and about disabling or enabling server security, is found in the Security documentation in the IBM Integration Designer help: Help > Help Contents. The embedded assistance help opens. Navigate to IBM Business Process Manager, Version 8.0, All platforms > Authoring services in Integration Designer > Managing security in IBM Integration Designer.



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 a package group or do not meet version tolerance and other requirements. 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 IBM Integration Designer V8.5 to coexist with a Rational software product ( Rational Application Developer for WebSphere Software), the Rational software product must be at version 8.5.x or higher. When you have an earlier version of the Rational software product you must correct this incompatibility by updating the version to 8.5.x or higher, or choose a new package group. When to add a Rational software product to the same package group as IBM Integration Designer V8.5, install it directly at the required 8.5.x (or higher) level by searching for available updates during the Rational installation (using Check for Other Versions and Extensions), or by pointing to the 8.5.x update repository location along with the base Rational repository location.

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.


Coexisting installations of IBM Integration Designer

You can install IBM Integration Designer V8.5 onto a system with an existing installation of IBM Integration Designer V8.5, but the two cannot be part of the same package group.

Similarly, you can install IBM Integration Designer V8.5 onto a system with an earlier installation of IBM Integration Designer, but the two cannot be part of the same package group.



Non-administrative user considerations

If you are installing IBM Integration Designer as a non-administrative or non-root user, you must have the DB2 server installed before you begin the installation. Remember the database details so that you can enter them during the installation.

The considerations described in this topic apply to any install scenario where you choose to install using the Typical install option. Profiles are created automatically when you install using the Typical option.

To install as a non-administrative user, you have the following choices:

For additional information, see the following topics .



Prepare to install

There are a few tasks which should be completed before beginning the installation process. Previous versions of IBM Integration Designer cannot be upgraded to V8.5. Different versions of IBM Integration Designer can coexist on your workstation, but they must not be installed in the same directory.

Before you install BPM, complete these steps:

  1. Confirm that your system meets the hardware and software requirements described in System requirements for IBM Integration Designer.
  2. Read the section Plan to install and give particular attention to the topic Coexistence considerations.
  3. Prepare your operating system following the instructions.



Prepare Linux systems for installation

Before you can install IBM Integration Designer, you must prepare your Linux operating system.

Ensure that you have a supported version of Mozilla Firefox installed.

Complete the following steps on your Linux system before installing IBM Integration Designer:

  1. Because WebSphere Application Server is a prerequisite of IBM Integration Designer, complete all the required preparation steps in Prepare Linux systems for installation

  2. Increase the allowable stack size, number of open files, and number of processes by adding the following lines to the end of...

      /etc/security/limits.conf

    ...or changing the values if the lines already exist: 

    # - stack - max stack size (KB)
* soft stack 32768
* hard stack 32768
# - nofile - max number of open files * soft nofile 65536
* hard nofile 65536
# - nproc - max number of processes * soft nproc 16384
* hard nproc 16384
    Save and close the file, and log off and log in again. You can check the current maximum number of open files by using ulimit -n. The ulimit requirement is dynamically calculated at installation time and might need to be larger based on the options you select. For more information about this setting, run man limits.conf or see Prepare the operating system for product installation .
  3. Check for the existence of a file named...

      /etc/security/limits.d/90-nproc.conf

    ...which overrides the nproc value set in the limits.conf file. If the 90-nproc.conf file exists, edit it and set the nproc values specified in the previous step.

  4. Install the following packages for your operating system:

    Option Description
    Red Hat Enterprise Linux 5

    • libXp-1.0.0-8
    • rpm-build-4.4.2-37.el5

    You can also install a later release of any of these packages if there are new packages as errata. If you have additional packages that are specific to your hardware, install them.

    To use the default package manager on supported Linux distributions.

    • Red Hat Enterprise Linux 5:

        yum install libXp rpm-build

  5. Set the umask value to 077:

    • umask 077

    The value 077 is the most restrictive value that IBM Integration Designer will tolerate. You can optionally choose to set a less restrictive umask value for the following access levels:

    • 037 for read-only access for a group of human administrators and tools
    • 027 for read and write access for a group of human administrators and tools
    • 007 for read, write, and execute access for a group of human administrators and tools

  6. On Red Hat Enterprise Linux 5 systems, disable SELinux, or set it to a permissive mode.

  7. Restart the computer.

  8. Complete the steps in Tuning Linux systems.
  9. Ensure all servers involved are set to the same time. Use the same network time protocol for all servers on all cluster nodes, including application, support, and database clusters. A time mismatch will cause erratic behavior, including duplicate system tasks.

  10. If you are using DB2, make sure that all your DB2 parameters meet the DB2 naming rules.



Prepare Windows systems for installation

Before you can install IBM Integration Designer, you must prepare your Windows operating system.

If you are planning to use DB2 Express with your IBM Integration Designer installation, the user account must have administrative privileges (Administrator) on the machine where you will perform the installation. Because WebSphere Application Server is a prerequisite of the IBM Integration Designer test environment, complete all of the preparation tasks for WebSphere Application Server before installing IBM Integration Designer if you plan to use the test environment.

Complete the following steps on your Windows system before installing IBM Integration Designer:

  1. Complete the steps in the Prepare Windows systems for installation

  2. Complete the steps in Tuning Windows systems.
  3. Ensure all servers involved are set to the same time. Use the same network time protocol for all servers on all cluster nodes, including application, support, and database clusters. A time mismatch will cause erratic behavior, including duplicate system tasks.

  4. If you are installing on Windows 2008 R2 and you plan to install DB2 Express as part of the IBM Integration Designer installation, ensure you have compatible Microsoft Visual C++ redistributable packages. See Errors when running the db2start command .

  5. If you are using a Czech locale, change the system settings to prevent seeing corrupted characters in IBM Process Portal, and Process Designer. Change the Windows settings by completing the following steps:

    1. Click Regional and Language Options, and open the Administrative tab.

    2. In the Language for non-Unicode programs section, click Change system locale . . . to open the locale list.

    3. Select Czech from the list and click OK.

  6. If you are using DB2, make sure that all your DB2 parameters meet the DB2 naming rules.



Install from the product launchpad

The product launchpad provides you with a single location to perform an installation for IBM Integration Designer.

  1. Complete the preinstallation tasks described in Prepare to install, if you have not done so already.

  2. Verify the /home directory has 2.2GB of free space. This is required for DB2 installation.

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, install DB2 before you begin the product installation. The DB2 database must be locally installed.

If you are a nonadministrative or nonroot user, you must be authorized to create databases. Typical installation via the product launchpad validates this authority. If you are not authorized to create databases, perform the following step:

To install or run IBM Integration Designer on Windows 7, Windows Vista, or Windows Server 2008, elevate your Microsoft Windows user account privileges. To install as an administrative user, right-click launchpad.exe and select Run as administrator.

Use the product launchpad to start the typical installation of IBM Integration Designer in the following cases:

To start the launchpad program. You can run only one launchpad at a time.

  1. Insert the first IBM Integration Designer DVD into your DVD drive.

    Ensure that you have mounted the DVD drive. Alternatively, extract all the files from the downloadable images. All files should be extracted to the same location on your hard disk. Overwrite directories if prompted.

  2. If the auto-run function is enabled on your system, the IBM Integration Designer launchpad program automatically opens. If auto-run is not enabled on your system or you are not using a DVD:

    • Run launchpad.sh located in the root directory of the DVD or extracted files. If you are running it from a terminal window, ensure the terminal window's current directory is outside the mounted file system. For example, use your home directory and specify the path to launchpad.sh.
    • Run launchpad.exe, or launchpad64.exe for a 64-bit system, located in the root directory of the DVD or extracted files.

  3. Select the typical installation environment to install. Based on your selection, your next screen is configured to emphasize the features that you need. You can change the environment at a later time in IBM Integration Designer. See Typical installations and environments for more information.

  4. Click Next to continue.

  5. Set the location for the installation.

    The default installation path is:

    • C:\IBM\IID\v8.5
    • root: /opt/IBM/IID/v8.5
    • nonroot: user_home/IBM/IID/v8.5

  6. Select the features within IBM Integration Designer that you would like to install. See Available features for more information.

    The features are available for selection only for the IBM Integration Designer for BPM Advanced - Process Server and IBM Integration Designer installation options.

  7. Click Next to continue.

  8. Set the information for the Process Server test environment:

    Set the Process Server information only if you selected the IBM Integration Designer for BPM Advanced - Process Server installation option.

    • Hostname: Name of the machine.

    • Location: Click Browse to change the installation location.
    • The default installation path for the test environment is:

      • C:\IBM\IID\PS\v8.5
      • root: /opt/IBM/IID/PS/v8.5
      • nonroot: user_home/IBM/IID/PS/v8.5

    • Set the Username and Password for the cell administrative account.

      Primary WebSphere Application Server administrator. Users assigned to this role is not responsible for the administration of the IBM Integration Designer components. Provides access to all interfaces, enabling users to alter or delete all types of available library items and assets, including process applications and toolkits. Enables administration of Process Servers, Performance Data Warehouses, and internal users and groups. Users assigned to this role can deploy Process Applications on the Process Center server.

  9. Click Next to continue.

  10. Set the Username and Password for the DB2 database connectivity.

  11. Click Next to continue.

  12. On the Installation summary page, if you agree to the terms of the license agreements, select I have read and accepted the license agreement and notices.

  13. To change your choices, click Back. When satisfied, click Install Software to install the package. On the Installation information page, the product and its features that you chose to install are displayed along with their installation locations. The DB2 databases that you created prior to the installation are also displayed. A progress indicator shows the percentage of the installation completed.

    Tip: If you are installing from DVD and get an Eject Error message that prevents you from ejecting the first disk, it indicates that you are running launchpad.sh in a terminal window with a current directory inside the mounted file system. If you started launchpad.sh by double-clicking and selecting Run in Terminal, then you must close the terminal before you can eject the disk. If you started launchpad.sh in a terminal window, do the following steps to eject the disk:

    1. Press Ctrl+Z to pause the process.
    2. Type bg 1 to move the process to the background.
    3. Change the directory to one outside the mounted file system.
    4. Eject the disk.

    You can avoid getting the Eject Error message by ensuring the terminal window's current directory is outside the mounted file system ( the home directory), and specifying the absolute path to launchpad.sh when you run it.

You have installed a fully functional IBM Integration Designer with a Process Server test environment, if selected.



Related tasks:

Business integration capabilities

IBM Installation Manager information center


Typical installations and environments

You select a typical installation configuration from the launchpad when you install IBM Integration Designer. The preselected configuration you select determines the environment that will be enabled when IBM Integration Designer starts. You can change the configuration selections during installation or run Installation Manager at a later time to make changes. You can also change the environment later in IBM Integration Designer.


IBM Integration Designer for BPM Advanced - Process Server

This installation configuration includes an Process Server test environment, and supports IBM Business Monitor. The following components are selected for installation:


IBM Integration Designer for WebSphere DataPower

This installation configuration works directly with the WebSphere DataPower Appliance, and does not include a test environment. Only the Integration Designer package is selected for installation.


IBM Integration Designer

This installation configuration does not include a test environment. Only the Integration Designer package is selected for installation.



Available features

You can customize your software product by selecting the features of IBM Integration Designer to install.

When you install the IBM Integration Designer product using the launchpad, you can select which features within the product to install as per your requirements. A default set of features is selected for you (including any required features). The launchpad automatically enforces any dependencies between features and prevents you from clearing any required features.

Adapters can be individually selected. Only install the adapters that you will require.

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

The following table shows the features of IBM Integration Designer 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.

Features of IBM Integration Designer that you can choose to install.

Feature group Feature Description Selected by default
IBM Integration Designer   The core functionality of IBM Integration Designer. Provides tools in a comprehensive development environment to build integrated solutions. Yes (mandatory)
Tools for developing applications without a local server installation   Select this option if you do not have this server installed locally but want to develop applications for Process Server, V8.5, or WebSphere Enterprise Service Bus, V8.5, or connect to a remote V8.5 of these servers. No
Email, Flat File, FTP and JDBC IBM WebSphere Adapters   Send and receive email to and from an email server using WebSphere Adapter for Email. Read from, and write to, a file on a local file system using the WebSphere Adapter for Flat Files. Read from, and write to a file on remote system using the WebSphere Adapter for File Transfer Protocol (FTP). Create and access services with the database system using WebSphere Adapter for JDBC. Yes
Additional IBM WebSphere Adapters   Adapters access programs and data on Enterprise Information Systems (EISs). No
CICS adapter Create and access services to exchange information with COBOL, C, PL/I programs and data on Customer Information Control Systems (CICS) transaction systems. No
Domino adapter Create a service that exchanges information with an IBM Domino server. Create integrated processes, which can create and access Domino documents, without special coding. During outbound processing the adapter supports Create, Retrieve, Update, Delete, Exists and RetrieveAll operations. The adapter receives a request in the form of a business object from a service, it processes the request and sends the response back to the calling component, during inbound processing, the adapter polls the Domino server at intervals for Domino documents that are ready for processing. No
ECM Adapter Create and access content in an Enterprise content management system using WebSphere Adapter for Enterprise Content Management. No
IMS Adapter Create and access services to exchange information with COBOL, C, and PL/I programs and data on IBM Information Management System (IMS) transaction systems. No
iSeries Adapter Create and access services that use the program call markup language (PCML) standard to call an RPG, COBOL, and service programs on the target IBM i machine, and send or receive messages to an IBM i data queue. No
JD Edwards Adapter Create and access services with the JD Edwards EnterpriseOne Server using WebSphere Adapter for JD Edwards EnterpriseOne. No
Oracle Adapter Create and access services to exchange information with the Oracle E-Business Suite. No
PeopleSoft Adapter Create and access services to exchange information with WebSphere Adapter for PeopleSoft Enterprise. No
SAP Adapter Create and access services to exchange information with the SAP server. No
Siebel Adapter Create and access services to exchange information with the Siebel Business Application Server. No
WebSphere Adapter Toolkit Provides the development tools, libraries, and sample code to assist you in creating JCA resource adapters. No

Monitor Model editor

  Provides wizards and libraries to help you create monitor models. It will be installed in your IBM Integration Designer environment. Yes
Client development tools   Most applications require client interfaces through which customers or staff can enter data. This group of tools is provided to allow you to customized clients for applications. No
web development tools Provides tools for building Web 2.0 and Java EE web applications using JavaServer Faces (JSF), JavaServer Pages (JSP), servlets, and HTML. Also provides the Apache Struts framework for developing Java EE web applications. No
WebSphere Portal Server, version 6.1 The WebSphere Portal Server options provide development tools to create, customize, test, debug, and deploy portal applications. Select the "Tools for developing applications without a local server installation" option if you do not have the server installed locally but want to develop applications for WebSphere Portal Server. No
WebSphere Portal Server, version 6.1 on WAS, version 8.0 No
WebSphere Portal Server, version 7.0 No
Lifecycle integration clients   Provides an asset repository and provides integrations and client plug-ins for the IBM Rational Team Unifying Platform. No
Asset repository client The asset repository client is a centrally accessible location for storing and sharing business process management (BPM) artifacts. IBM Rational Asset Manager must be installed and configured on a server so the asset repository client can connect to it. No
Rational ClearCase SCM Adapter Provides the IBM Rational ClearCase SCM and ClearCase MVFS plug-ins, which enable versioning of software artifacts in ClearCase versioned object bases (VOBs) using snapshot views and dynamic views when ClearCase VOB and view servers are also installed. No
Additional development tools   Provides relational database tools to work with tables, views, and filters. With these tools, you can create physical database models by means of reverse engineering database tables or using DDL scripts. You can also use the tools to create SQL statements, DB2 routines (such as stored procedures and user-defined functions), and various types of files. Additionally provides a graphical editing environment that you can use to depict Java classes, enterprise beans and other code elements and artifacts. No



Related tasks:

Sharing assets

Use the "-clean" option when starting IBM Integration Designer


Install IBM Integration Designer silently

You can install the IBM Integration Designer product package in silent installation mode. When you install in silent mode, the user interface is not available. Only one IBM Installation Manager is required to install multiple instances of IBM Integration Designer.



Related tasks:

Configure the test environment profile using BPMConfig


Related reference:

System requirements for IBM Integration Designer


Install IBM Integration Designer silently using the command line

You can install IBM Integration Designer using the command line.

Before you install IBM Integration Designer, review the system requirements for the product.

Operating system and software prerequisite levels are particularly important. Although the installation process automatically checks for prerequisite operating system patches, review the system requirements if you have not already done so. The system requirements link lists all supported OSs and the operating system fixes and patches that install to have a compliant operating system. It also lists the required levels of all prerequisite software.

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, install DB2 before you begin the product installation. The DB2 database must be locally installed. If you do not have the prerequisite base products necessary for IBM Integration Designer installation, install them as part of the silent installation. The required base products are:

The silent installation performs the following tasks:

To silently install IBM Integration Designer:

  1. To generate encrypted passwords using IBM Installation Manager to securely connect to DB2.

    If you are running Windows 7, Windows Vista, or Windows Server 2008, start your command prompt by right-clicking and selecting Run as administrator.

      IM_location\eclipse\tools\imutilsc -silent -nosplash encryptString password_to_encrypt

      IM_location/eclipse/tools/imutilsc -silent -nosplash encryptString password_to_encrypt

  2. Read and accept the license terms before installing. Adding -acceptLicense to the command line means that you accept all licenses.

  3. Run the following command:

    If you are running Windows 7, Windows Vista, or Windows Server 2008, start your command prompt by right-clicking and selecting Run as administrator.

      extract_directory\disk1\IM_win32\tools\imcl install list_of_product_IDs -acceptLicense -installationDirectory location -repositories repository -showVerboseProgress -log logName.log

    If you are running on a 64-bit system and do not already have 32-bit Installation Manager installed, run the command from the extract_directory\IM_win64\tools directory.

      extract_directory/disk1/IM_linux/tools/imcl install list_of_product_IDs -acceptLicense -installationDirectory location -repositories repository -showVerboseProgress -log logName.log

    If you are running on a 64-bit system and do not already have 32-bit Installation Manager installed, run the command from the extract_directory/IM_linux64/tools directory. where:

    • list_of_product_IDs is a list of the IDs for the products you want to install, separated by spaces.

      Product IDs

      Product Product ID Feature Description
      IBM Integration Designer com.ibm.integration.designer.v85 Required: com.ibm.wid, com.ibm.rad.jre, com.ibm.wid.product, com.ibm.rad.jee5, com.ibm.rad.was80_devtools, com.ibm.rad.was85_devtools, com.ibm.rad.j2c, com.ibm.rad.birt, com.ibm.rad.transform_authoring, and com.ibm.rad.pde Required features
      Optional: com.ibm.wid.bpm.stubs Tools for developing applications without a local server installation
      Optional: com.ibm.wid.adapters.file E-mail, Flat File, FTP and JDBC IBM WebSphere Adapters
      Optional: com.ibm.wid.adapters.cics CICS adapter
      Optional: com.ibm.wid.adapters.domino Domino adapter
      Optional: com.ibm.wid.adapters.ecm ECM adapter
      Optional com.ibm.wid.adapters.ims IMS adapter
      Optional com.ibm.wid.adapters.ios iSeries adapter
      Optional com.ibm.wid.adapters.jde JD Edwards adapter
      Optional com.ibm.wid.adapters.oracleebs Oracle adapter
      Optional com.ibm.wid.adapters.peoplesoft PeopleSoft adapter
      Optional com.ibm.wid.adapters.sap SAP adapter
      Optional com.ibm.wid.adapters.siebel Siebel adapter
      Optional com.ibm.wid.adapters.wat WebSphere Adapter Toolkit
      Optional com.ibm.wid.adapters.wola WebSphere Optimized Local Adapter
      Optional com.ibm.wid.mme Monitor Model editor (Windows only)
      Optional com.ibm.rad.webtools_core Web development tools
      Optional com.ibm.rad.portal.v70.tools WebSphere Portal Server Beta development tools
      Optional com.ibm.ram.core.client Asset repository client
      Optional com.ibm.rad.clearcase Rational ClearCase SCM adapter
      Optional com.ibm.wid.dev_tools Additional development tools
      Optional com.ibm.wid.bpmps.user IBM Business Process Manager Advanced - Process Server environment
      Optional com.ibm.wid.bpmpc.user IBM Business Process Manager Advanced environment
      Optional com.ibm.wid.wesb.user WebSphere Enterprise Service Bus environment
      Optional com.ibm.wid.wbm.user IBM Business Monitor environment (Windows only)
      Optional com.ibm.wid.datapower.user WebSphere Datapower environment
      Installation Manager com.ibm.cic.agent agent_core Installation Manager core content
      agent_jre Installation Manager JRE

    • location is the path to the directory where you want to install BPMs.

    • repository is the path to the repository where you have extracted the files, one or more of the following directories: 
      extract_directory/disk1/IM_win32
extract_directory/disk1/IM_linux
extract_directory/disk1/diskTag.inf
      For more than one repository, separate the repository locations with commas.
    • logName is the name of the log file to record messages and results.

    Run this command installs the product with the default features. To install specific features or make other changes, see the reference link for the command-line arguments for imcl.

  4. If you also want to install the test environment, run the same command again with a different installation directory and the required product IDs and keys:

      extract_directory\disk1\IM_win32\tools\imcl install list_of_product_IDs -acceptLicense -testInstallationDirectory location -repositories repository -properties key=value,key=value -showVerboseProgress -log logName.log

    If you are running on a 64-bit system and do not already have 32-bit Installation Manager installed, run the command from the extract_directory\IM_win64\tools directory.

      extract_directory/disk1/IM_linux/tools/imcl install list_of_product_IDs -acceptLicense -testInstallationDirectory location -repositories repository -properties key=value,key=value -showVerboseProgress -log logName.log

    If you are running on a 64-bit system and do not already have 32-bit Installation Manager installed, run the command from the extract_directory/IM_linux64/tools directory. where:

    • list_of_product_IDs is a list of the IDs for the products you want to install, separated by spaces.

      Product IDs for test environment

      Product Product ID Feature Description
      IBM Integration Designer com.ibm.bpm.PS.v85 AdvancedProcessServer.NonProduction Test, staging, or development use

      Must specify this feature or bpmAdvPS.prod

      WebSphere Application Server Network Deployment com.ibm.websphere.ND.v80 core.feature Required WAS core content
      ejbdeploy pre-EJB 3.0 modules
      thinclient standalone thin clients and resource adapters
      embeddablecontainer embeddable EJB container
      samples sample applications feature
      com.ibm.sdk.6_32bit

      32-bit SDK

      Must specify this feature or com.ibm.sdk.6_64bit.

      com.ibm.sdk.6_64bit

      64-bit SDK

      Can only be selected on a 64-bit system

      Must specify this feature or com.ibm.sdk.6_32bit.

      Installation Manager com.ibm.cic.agent agent_core Installation Manager core content
      agent_jre Installation Manager JRE
      DB2 for Linux 32-bit com.ibm.ws.DB2EXP.linuxia32 N/A DB2 must match the system OS and bit specification
      DB2 for Linux 64-bit com.ibm.ws.DB2EXP.linuxia64 N/A DB2 must match the system OS and bit specification
      DB2 for Windows 32-bit com.ibm.ws.DB2EXP.winia32 N/A DB2 must match the system OS and bit specification
      DB2 for Windows 64-bit com.ibm.ws.DB2EXP.winia64 N/A DB2 must match the system OS and bit specification

    • location is the path to the directory where you want to install BPMs.

    • repository is the path to the repository where you have extracted the files, one of the following directories: 
      extract_directory/repository/repos_32bit
extract_directory/repository/repos_64bit
      For more than one repository, separate the repository locations with commas.

    • key=value is a list of the keys and values to pass to the installation, separated by commas. Do not put spaces between the commas.

      Keys for test environment

      Key Description
      user.select.64bit.image If you are installing on a 64-bit operating system, add the following line exactly:

        user.select.64bit.image,,com.ibm.websphere.ND.v80=true

      Default is false.

      user.db2.admin.username Windows only. User name with authority to access the DB2 database. The default value is bpmadmin.
      user.db2.admin.password Windows only. Password for the user name above. Choose a password that complies with the password policy of your system ( Windows 2008).
      user.db2.port Port for the DB2 database. The default value is 50000.
      user.db2.instance.username Linux only. DB2 instance user name.
      user.db2.instance.password Linux only. Password for the user name above.
      user.db2.fenced.username Linux only. Fenced user name.
      user.db2.fenced.password Linux only. Password for the user name above.
      user.db2.das.username Linux only. Administration server (DAS) user name.
      user.db2.das.password Linux only. Password for the user name above.

    • logName is the name of the log file to record messages and results.

    Run this command installs the test environment with the default features. To install specific features or make other changes, see the reference link for the command-line arguments for imcl.

Installation Manager installs the list of products and writes a log file to the directory that you specified.


After you have installed the product, create the deployment test environment and profile using the BPMconfig command.



Related tasks:

Configure the test environment profile using BPMConfig


Related reference:

System requirements for IBM Integration Designer

Command-line arguments for imcl


Install IBM Integration Designer silently using a response file

You can install the IBM Integration Designer product package in silent installation mode. When you install in silent mode, the user interface is not available. Instead, you run a command to use a response file that installs the product.

Before you install IBM Integration Designer, review the system requirements for the product.

Operating system and software prerequisite levels are particularly important. Although the installation process automatically checks for prerequisite operating system patches, review the system requirements if you have not already done so. The system requirements link lists all supported OSs and the operating system fixes and patches that install to have a compliant operating system. It also lists the required levels of all prerequisite software.

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, install DB2 before you begin the product installation. The DB2 database must be locally installed. If you do not have the prerequisite base products necessary for IBM Integration Designer installation, install them as part of the silent installation. The required base products are:

The silent installation performs the following tasks:

To silently install IBM Integration Designer:

  1. Read and accept the license terms before installing. Adding -acceptLicense to the command line means that you accept all licenses.

  2. Create the response file that will install the required base products and IBM Integration Designer. Copy a sample response file, suitable for your operating system and user access level, from one of the following directories:

    • To install both IBM Integration Designer and the test environment: extract_directory/responsefiles/iid_testenv/
    • To install IBM Integration Designer alone: extract_directory/responsefiles/iid/

    Alternatively, you can create a response file by recording your actions in Installation Manager. When you record a response file, the selections made in Installation Manager are stored in an XML file. When you run Installation Manager in silent mode, Installation Manager uses the data in the XML response file to perform the installation.

  3. The default values provided in the sample response files will perform a basic install, but you should review the file and its comments, and modify the parameters as needed for the environment.

    Verify the repository locations in your response file point to the correct location in the environment and that other parameter values are also appropriate.

  4. Run the following command:

    If you are running Windows 7, Windows Vista, or Windows Server 2008, start your command prompt by right-clicking and selecting Run as administrator.

    To install IBM Integration Designer and the test environment:

      extract_directory\IM_win32\installc.exe -acceptLicense input ..\responsefiles\response_file_name.xml -log silent.log

    If you are running on a 64-bit system and do not already have 32-bit Installation Manager installed, run the command from the extract_directory\IM64\tools directory.

      extract_directory/IM_linux/installc -acceptLicense input ../responsefiles/response_file_name.xml -log silent.log

    If you are running on a 64-bit system and do not already have 32-bit Installation Manager installed, run the command from the directory...

      extract_directory/IM64/tools

    To install IBM Integration Designer alone:

      extract_directory\IM_win32\installc -acceptLicense input ..\responsefiles\response_file_name.xml -log silent.log

      extract_directory/IM_linux/installc -acceptLicense input ../responsefiles/response_file_name.xml -log silent.log

Installation Manager installs any required prerequisites and IBM Integration Designer and writes a log file to the directory you specified.

When you install the IBM Integration Designer and the UTE on Linux platform under the /home or /opt directories you are likely to receive a warning output or log message indicating there has been an error during the installation of DB2 Express. The error message will read as follows:Warnings were encountered during installation of DB2 Express.See DB2 Express installation log file /opt/IBM/BPM8.0/logs/db2install.log for more information. This is an expected behavior on Linux platform, and does not indicate installation failure. Proceed with the rest of the installation to complete it.


After you have installed the product, create the deployment test environment and profile using the BPMconfig command.



Related tasks:

Install silently with Installation Manager

Recording a response file with Installation Manager

Configure the test environment profile using BPMConfig


Related reference:

System requirements for IBM Integration Designer


Configure the test environment profile using BPMConfig

You can use BPMConfig to create and configure the profile for the Process Server test environment using a properties file that contains all of the values required for the profile settings.

You must have installed IBM Integration Designer and the test environment silently using the command line or response file.

Ensure the DB2 command line environment can be successfully invoked.

If you are a nonadministrative or nonroot user, you must be authorized to create databases. If you are not authorized to create databases, perform the following step to acquire authorization:

When run with the -create -de options, BPMConfig performs the following tasks:

To create and configure the profile for the Process Server test environment:

  1. On the system where you want to create the test environment profile, locate the sample properties file Advanced-PS-Standalone-DB2.properties at the following path:

    extract_directory/launchpad/content/samples/config/iid

    extract_directory\launchpad\content\samples\config\iid

  2. Create a copy of the above sample properties file.

  3. Modify your version of the properties file so the values correspond to your own configuration. To create the test environment profile for IBM Integration Designer, clear out or update the default variable values assigned to the required properties.

    BPMConfig command properties that must be set.

    The following table lists the properties and the values that you must set:

    Configuration properties Values to set 
    bpm.de.psProcessCenterHostname
bpm.de.psProcessCenterPort
    		The Process Server test environment is an offline server configuration. Clear the default values @PS_PC_HOSTNAME@ and @PS_PC_PORT@ specified for the host name and port number. 
    bpm.de.authenticationAlias.1.name=DeAdminAlias
bpm.de.authenticationAlias.1.user
bpm.de.authenticationAlias.1.password
    		Retain the default value DeAdminAlias for authentication alias for the test environment administrator. See IBM Business Process Manager security roles for more information about the roles.

    If you change the value for bpm.de.authenticationAlias.1.alias from the default DeAdminAlias, update it everywhere that references that alias, for example bpm.de.roleMapping.#.alias

    Specify custom user name and password for the authentication alias for the test environment administrator. 

    bpm.de.authenticationAlias.2.name=ProcessCenterUserAlias
bpm.de.authenticationAlias.2.user
bpm.de.authenticationAlias.2.password
    		The Process Server test environment is an offline server configuration. Clear the default values specified for the user name and password for the ProcessCenterUserAlias authentication alias. 
    bpm.de.authenticationAlias.3.name=BPM_DB_ALIAS
bpm.de.authenticationAlias.3.user
bpm.de.authenticationAlias.3.password
    		Retain the default value BPM_DB_ALIAS for authentication alias for the database instance.

    Specify custom user name and password for the authentication alias for the database user. 

    bpm.cell.authenticationAlias.1.name=CellAdminAlias
bpm.cell.authenticationAlias.1.user
bpm.cell.authenticationAlias.1.password
    		Retain the default value CellAdminAlias for authentication alias for the cell. See IBM Business Process Manager security roles for more information about the roles.

    Specify custom user name and password for the authentication alias for the cell administrator. 

    bpm.de.node.1.hostname
bpm.de.node.1.installPath
bpm.de.node.1.profileName
    		Update the default value @INSTALL_HOSTNAME@ to specify the host name of the computer where the product is installed.

    Update the default value @INSTALL_PATH@ to specify the installation path of the test environment.

    Update the default value @SERVER_PROFILE_NAME@ for the profile name to qbpmps. 

    bpm.de.db.1.hostname
bpm.de.db.1.portNumber
bpm.de.db.1.schema
    		Update the default value @DB_HOSTNAME@ to specify the host name of the database.

    Update the default value @DB_PORTNUMBER@ to specify the port number of the DB2 service.

    Update the default value @DB_SCHEMA@ to specify the user name for the DB2 database in CAPITAL letters. 

    bpm.de.db.1.databaseName
bpm.de.db.2.databaseName
bpm.de.db.3.databaseName
    		Update the default value @CMN_DB_NAME@ for the Common database to QCMNDB.

    Update the default value @PS_DB_NAME@ for the Process database to QBPMDB.

    Update the default value @PDW_DB_NAME@ for the Performance Data Warehouse database to QPDWDB.

    For more information about BPMConfig properties, read the comments in the sample files, or see the sample property file descriptions in Sample configuration properties files for use using BPMConfig.

  4. Add the property bpm.de.createDatabase in the properties file and set its value set to true.

  5. Run BPMConfig passing it the name of the properties file you created. For example:

      BPM_home/bin/BPMConfig -create -de my_environment.properties

      BPM_home\bin\BPMConfig -create -de my_environment.properties


Create a copy of the updated properties file, rename this copied version to Standalone.properties, and place this file at the location <WTE_HOME>/properties/wte. This ensures the Server Reset feature in Integration Designer functions properly.

After creating test environment profile, you can start the test profile by running BPMconfig -start.



Related tasks:

Install IBM Integration Designer silently using a response file

Install IBM Integration Designer silently

Install IBM Integration Designer silently using the command line


Related reference:

BPMConfig command-line utility


Work with IBM Installation Manager

This section deals with some common tasks relating to IBM Installation Manager. See the Installation Manager information center.


IBM Installation Manager information center

Install Installation Manager on Windows

About this task

If you start the installation of BPM 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 Install from the product launchpad.) In other cases, you must manually start the installation of Installation Manager.

Procedure

To install Installation Manager manually:

  1. Run install.exe from the IM_win32 folder in the installation image.

    If you are running on a 64-bit system and do not already have 32-bit Installation Manager installed, run the command from the IM_win64 directory.

  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.

Install Installation Manager on Linux

About this task

If you start the installation of BPM 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 Install from the product launchpad.

Procedure

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.

    If you are running on a 64-bit system and do not already have 32-bit Installation Manager installed, run the command from the IM_linux64 directory.

  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. If you start the installation of BPM from the launchpad program, then the installation of IBM Installation Manager is performed automatically if it is not already installed on your workstation.

Start Installation Manager on Windows

About this task

If you start the installation of BPM 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 IBM Integration Designer packages. If you start Installation Manager directly, then you must set a repository preference and choose product packages manually. See Set repository preferences in Installation Manager.

Procedure

To start Installation Manager manually:

  1. Open the Start menu from the Taskbar.

  2. Select All Programs > IBM Installation Manager > IBM Installation Manager.

Start Installation Manager on Linux

About this task

If you start the installation of BPM 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 IBM Integration Designer packages. If you start Installation Manager directly, then you must set a repository preference and choose product packages manually. See Set repository preferences in Installation Manager.

Procedure

To start Installation Manager manually:

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

Uninstall Installation Manager on Windows

Procedure

To uninstall Installation Manager manually:

  1. Click Start > Settings > Control Panel, and then double-click Add or Remove Programs.

  2. Select the entry for IBM Installation Manager and click Remove

Uninstall Installation Manager on Linux

About this task

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

Procedure

To uninstall Installation Manager manually on Linux, use one of the following methods:


Update Installation Manager through a proxy server

About this task

Proxy servers enable connections to remote servers from behind a firewall. You can set preferences for proxy servers in Installation Manager or in a response file. After the proxy server is enabled, the proxy server is used for all server communications. For details on how to configure Installation Manager for a proxy server see Internet Preferences in the Installation Manager information center.


Overview

IBM Installation Manager is a program that helps you install the IBM Integration Designer 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 an IBM Integration Designer product package. Installation Manager also provides tools for managing licenses for the product packages that it installs. It provides tools for updating and modifying packages. You can also use Installation Manager to uninstall product packages.

Installation Manager comprises seven wizards that make it easy to maintain BPM packages through their lifecycles:


IBM Installation Manager information center


Silently installing and uninstalling Installation Manager

IBM Installation Manager can be silently installed and uninstalled.


IBM Installation Manager information center


Silently installing Installation Manager

About this task

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

About this task

To silently uninstall Installation Manager on Windows:

Procedure

  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

About this task

To silently uninstall Installation Manager on other platforms:

Procedure

  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


Package groups and the shared resources directory

When you install the IBM Integration Designer package using IBM Installation Manager, you must choose a shared resources directory (if IBM Integration Designer 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 IBM Integration Designer 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 IBM Integration Designer 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.

You can use the IBM Packaging Utility to:

For more information see The IBM Packaging Utility .

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 IBM Integration Designer package installed into that package group. Eclipse plug-ins in the product package that can potentially be used by other package groups are placed in the shared resources directory.


Shared resources directory

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

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


IBM Installation Manager information center


Set repository preferences in Installation Manager

If you start Installation Manager directly (for example from a repository located on a web server), you must specify the URL for the directory that contains the product package in Installation Manager before you can install BPM package.

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.

If not installing from DVD or a local installation image, 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. The repository location is typically image_directory/repository.config, where image_directory contains the extracted installation image of the product you want to install.

  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.


To have the Installation Manager to search the default repository locations for the installed packages, ensure the Search service repositories during installation and updates preference on the Repositories preference page is selected.


IBM Installation Manager information center


Start IBM Integration Designer

You can start IBM Integration Designer from the desktop environment or a command-line interface.


If you are installing IBM Integration Designer to work with the Process Center and the Process Center is not yet installed, cancel the window that prompts for the connection. Otherwise, enter the URI of the Process Center in the following format:

For example:

Enter the user ID and password. Click Connect.



Use the "-clean" option when starting IBM Integration Designer

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

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

  1. From a command line, change to the package group installation directory where you installed IBM Integration Designer.

  2. Run the command to start IBM Integration Designer with the -clean option.

    • wid.exe -clean
    • ./wid.bin -clean


This -clean option forces IBM Integration Designer to rebuild the Eclipse repository. This applies to anything that is installed into Eclipse by extracting 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 IBM Integration Designer using the -clean option after applying any Interim Fixes. This will ensure 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.



Install on Citrix Presentation Server

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

Follow these instructions to install IBM Integration Designer to run on Citrix Presentation Server.

Throughout this text, the terms "installer" and "product installer" refer to the user ID that installed IBM Integration Designer.

  1. When you install IBM Integration Designer on the server, ensure that you are logged on as a user with administrator access.

  2. After installing, ensure the installation directory is read-only. This is the product directory, not the shared install directory. This step will ensure the configuration information is written in the home directory. If this measure is not taken, all users will end up using the same location for their configuration area, which is not supported.

    Ensure that client users are granted write permission to the following directory, or the integrated test environment server status cannot be detected:install_root\runtimes\bi_version_stub\

  3. When launching IBM Integration Designer from a client, the workspace is created in a directory specified by the user.
  4. In order to use the servers in the test environment, a profile is required for each nonroot user. The product installer can grant write permission to the appropriate BPM files and directories to other nonroot users. The nonroot users can then create profiles. Alternatively, the product installer can create a group for users who are authorized to create profiles or give individual users the authority to create profiles. The following example task shows how to create a group that is authorized to create profiles.



Configure the Citrix Presentation Server

About this task

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

Procedure

  1. Log on to the IBM Integration Designer system as the product installer (the product installer can be a root/Administrator or nonroot user).

  2. Use operating system commands, do the following tasks:

    1. Create a group named "profilers", which will contain all users who can create profiles.
    2. Create a user named user1, who can create profiles.

    3. Add users product_installer and user1 to the profilers group.

  3. Log off and log back on as the installer to pick up the new group.
  4. As the product installer, use operating system tools to change directory and file permissions.

    1. The following example assumes the variable $WASHOME is the BPM root_installation_directoryopt/ibm/BPM/v8.5 

      export WASHOME=opt/ibm/BPM/v8.5
echo $WASHOME
echo "Performing chggrp/chmod per WAS directions..."
chgrp profilers $WASHOME/logs/manageprofiles
chmod g+wr  $WASHOME/logs/manageprofiles
chgrp profilers $WASHOME/properties
chmod g+wr  $WASHOME/properties
chgrp profilers $WASHOME/properties/fsdb
chmod g+wr  $WASHOME/properties/fsdb
chgrp profilers $WASHOME/properties/profileRegistry.xml
chmod g+wr  $WASHOME/properties/profileRegistry.xml
chgrp -R profilers $WASHOME/profileTemplates
    2. Issue the following additional command where profile_template_name is default, dmgr, or managed:

        chmod -R g+wr $WASHOME/profileTemplates/profile_template_name/documents

      The ownership of files is preserved when the files are copied to the profile directory during profile creation. You granted write permission to the profile directory so that files copied to the profile directory can be modified as part of the profile creation process. Files that are already in the profileTemplate directory structure before the start of profile creation are not modified during profile creation.

    3. Issue the following additional commands: 
      chgrp profilers $WASHOME/properties/Profiles.menu
chmod  g+wr $WASHOME/properties/Profiles.menu

    4. The following example assumes the variable $WASHOME is the BPM root installation directory C:\IBM\ProcServer\v8.5. Follow instructions in the Windows documentation to give the profilers group read and write permission to the following directories and their files: 

      @WASHOME\logs\manageprofiles
@WASHOME\properties
@WASHOME\properties\fsdb
@WASHOME\properties\profileRegistry.xml
      You might have to change the permissions on additional files if the non administrative user encounters permission errors. For example, if the product installer authorizes a non administrative user to delete a profile, then product installer might have to delete the following file:

      5. install_root/properties/profileRegistry.xml_LOCK

      6. install_root\properties\profileRegistry.xml_LOCK

      Give write access to the nonroot user for the file to authorize the user to delete the file. If the nonroot user still cannot delete the profile, then the product installer can delete the profile.

Results

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


Modify installations

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

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

  2. In the Modify Packages wizard, select the IBM Integration Designer 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 to install and clear the features to remove.

    1. To learn more about a feature, click the feature and review the brief description under Details.

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



Upgrading IBM Integration Designer

You can install upgrades to IBM Integration Designer when they are available.

For upgrading from V8.5 to V8.5.0.1, see Profile upgrade instructions for BPM Version 8.5.0 Fix Pack 1 (V8.5.0.1).

Visit the IBM Support website to check for available fix packs and interim fixes.



Install fix packs interactively

You can install fix packs for IBM Integration Designer interactively.

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.

During the update process the repository for the base version of the package is required. If you have deleted the files required for rollback in Installation Manager, then Installation Manager prompts for the original installation disk when you upgrade to a fix pack. If you installed the product from DVDs or other media, they must be available when use the update feature. See the Installation Manager information center for more information.

If you created profiles in an earlier version, those profiles are preserved and you do not need to re-create them. You cannot use this procedure to install updates on the underlying IBM DB2 Express or IBM Cognos BI. You must update these products following their normal update processes.

To find and install product package updates:

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

  2. Start Installation Manager. From the Start page of the Installation Manager, click Update.

    • You can also click Start > Programs > IBM > package group name > Update. For example, click Start > Programs > IBM > IBM Integration Designer > Update.

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

  4. If you do not have Internet access, download the interim fix or fix pack locally, extract it to its own directory, and add the new directory to Installation Manager.

    1. Start Installation Manager.

    2. From the Start page, click File > Preferences > Repositories.

    3. From the Repositories page, click Add Repository.

    4. In the Add Repository window, browse to the new directory you created for the interim fix or fix pack files.

    5. Select the repository.config file and click Open.

    6. From the Repositories page, click OK.

  5. In the Update Packages wizard, select the package group containing the product package you want to update 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 the software you are updating. A progress indicator shows the search is taking place.

  6. 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 the latest 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 is 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.

  7. Select the updates to install or click Select Recommended to restore the default selections, and click Next. Updates that have a dependency relationship are automatically selected and cleared together.

  8. On the Licenses page, read the license agreements for the selected updates. On the left side of the Licenses page, the list of licenses for the updates you selected is displayed; click each item to display the license agreement text. If you agree to the terms of all the license agreements, click I accept the terms of the license agreements. Then click Next.

  9. On the Summary page, review your choices before installing the updates.

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

  10. 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. Close the Installation Log window to continue.

  11. Click Finish to close the wizard.
  12. Close Installation Manager.


IBM Installation Manager information center


Rolling back fix packs

Use the Roll Back Packages wizard, you can remove a fix pack 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 use the rollback feature. Use the rollback feature if you have applied an update to a product package, and decide later to remove the update and revert to the earlier version of the product. When use the rollback feature, the Installation Manager uninstalls the updated resources, and reinstalls the resources from the previous version.

A rollback process to a stand-alone server can disable the WebSphere test environment. You must reset the test environment profile after you complete the rollback process. To reset a test environment profile, see Creating or resetting default server profiles.

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

To roll back an updated package:

  1. On the Start page of the Installation Manager, click Roll Back to start the Rollback wizard.

  2. From the Roll Back Packages list, select the package to roll back.

  3. Complete the wizard according to the on-screen instructions.


IBM Installation Manager information center


Install fix packs silently

You can install fix packs for IBM Integration Designer using the command line. You cannot use this procedure to install updates on the underlying IBM DB2 Express or IBM Cognos BI. You must update these products following their normal update processes.

To update IBM Integration Designer silently:

  1. Read and accept the license terms before updating. Adding -acceptLicense to the command line means that you accept all licenses.

  2. Run the following command:

    If you are running Windows 7, Windows Vista, or Windows Server 2008, start your command prompt by right-clicking and selecting Run as administrator.

      extract_directory\disk1\IM_win32\tools\imcl install com.ibm.websphere.integration.developer.v80 -acceptLicense -installationDirectory location -repositories repository -showVerboseProgress -log logName.log

      extract_directory/disk1/IM_linux/tools/imcl install com.ibm.websphere.integration.developer.v80 -acceptLicense -installationDirectory location -repositories repository -showVerboseProgress -log logName.log

    where:

    • location is the path to the directory where you want to update the products.

    • repository is the path to the repository where you have extracted the fix pack files. For more than one repository, separate the repository locations with commas.
    • logName is the name of the log file to record messages and results.

  3. If you also want to update the test environment, run the same command again with the correct installation directory and the required product IDs:

      extract_directory\disk1\IM_win32\tools\imcl install list_of_product_IDs -acceptLicense -testInstallationDirectory location -repositories repository -showVerboseProgress -log logName.log

      extract_directory/disk1/IM_linux/tools/imcl install list_of_product_IDs -acceptLicense -testInstallationDirectory location -repositories repository -showVerboseProgress -log logName.log

    where:

    • list_of_product_IDs is a list of the IDs for the products you want to update, separated by spaces.

      Product IDs for test environment

      Product Product ID
      BPM Advanced: Process Server com.ibm.bpm.PS.V80
      IBM Business Monitor com.ibm.websphere.MON.V80
      WebSphere Application Server Network Deployment com.ibm.websphere.ND.v80

    • location is the path to the directory where you want to update the products.

    • repository is the path to the repository where you have extracted the fix pack files. For more than one repository, separate the repository locations with commas.
    • logName is the name of the log file to record messages and results.

Installation Manager updates the list of products and writes a log file to the directory that you specified.


Example

The following example updates IBM Integration Designer on Windows.



Related reference:

Command-line arguments for imcl

IBM Installation Manager information center


Uninstall IBM Integration Designer

You can uninstall IBM Integration Designer interactively or silently.



Uninstall IBM Integration Designer

The Uninstall 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 used to install BPM packages. A package cannot be uninstalled when another package has a dependency on it, unless the dependent package is also selected to be uninstalled.

  1. Close the programs that you installed using Installation Manager.
  2. Stop all running servers.

  3. From the Start page of the Installation Manager, click Update. You can also click Start > Programs > IBM > package group name > Uninstall. For example, click Start > Programs > IBM > IBM Integration Designer > Uninstall.

  4. On the Uninstall Packages page, select IBM Integration Designer and associated packages to uninstall.

    Tip: If you started Installation Manager from the Start menu (Start > ... > Uninstall) in the previous step, your IBM Integration Designer edition is pre-selected for uninstallation on the Uninstall Packages page. If you no longer need to use DB2 Express , or intend to reinstall IBM Integration Designer, select the IBM DB2 Express option to uninstall DB2 Express.

    CAUTION:

    Only select the option to uninstall DB2 Express if you are sure that no other product is using DB2 Express. Selecting this option will delete all the DB2 Express database, and database assets even if other products, including products on remote systems, might use DB2 Express on this system.

  5. On the Summary page, review the list of packages that will be uninstalled, and then click Uninstall. After the uninstallation finishes, the Complete page opens.

  6. Click Finish to exit the wizard.

When IBM Integration Designer is uninstalled, all profiles that are augmented to IBM Integration Designer are removed, including any WebSphere Application Server profiles that are augmented to IBM Integration Designer.



Uninstall silently

You can uninstall the IBM Integration Designer product package in silent installation mode. When you uninstall in silent mode, the user interface is not available.


IBM Installation Manager information center


Uninstall silently using the command line

You can use the command-line mode of the Installation Manager to uninstall IBM Integration Designer.

Close all programs that you installed using the Installation Manager.

To uninstall, you must log in to the system using the same user account used to install.

To uninstall IBM Integration Designer using the command line:

  1. Open a command prompt, and change directories to the /eclipse/tools directory under Installation Manager.

    If you are running Windows 7, Windows Vista, or Windows Server 2008, start your command prompt by right-clicking and selecting Run as administrator.

  2. Make the appropriate replacements and run the following command:

      imcl uninstall list_of_product_IDs -installationDirectory installationDirectory -log logLocation

    1. Replace list_of_product_IDs with a list of the IDs for the products you want to uninstall, separated by spaces.

      Product IDs

      Product Product ID
      IBM Integration Designer com.ibm.integration.designer.v80
      Installation Manager com.ibm.cic.agent

    2. Replace installationDirectory with the location where you installed the product.
    3. Replace logLocation with the location and file name to log the information.

  3. If you also want to uninstall the test environment, make the appropriate replacements and run the same command again:

      imcl uninstall list_of_product_IDs -installationDirectory testInstallationDirectory -log logLocation

    1. Replace list_of_product_IDs with a list of the IDs for the products you want to uninstall, separated by spaces.

      The DB2 Express installation might be used by multiple products, including products on remote systems. If you uninstall DB2 Express, all DB2 Express database, and database assets are deleted.

      Product IDs for test environment

      Product Product ID
      BPM Advanced: Process Server com.ibm.bpm.PS.V80
      IBM Business Monitor com.ibm.websphere.MON.V80
      WebSphere Application Server Network Deployment com.ibm.websphere.ND.v80
      DB2 for Linux 32-bit com.ibm.ws.DB2EXP97.linuxia32
      DB2 for Linux 64-bit com.ibm.ws.DB2EXP97.linuxia64
      DB2 for Windows 32-bit com.ibm.ws.DB2EXP97.winia32
      DB2 for Windows 64-bit com.ibm.ws.DB2EXP97.winia64
      IBM Cognos BI for Windows x86 (32-bit) com.ibm.ws.cognos.v1011.winia32
      IBM Cognos BI for Windows x64 (64-bit) com.ibm.ws.cognos.v1011.winia64

    2. Replace installationDirectory with the location where you installed the product.
    3. Replace logLocation with the location and file name to log the information.

Installation Manager uninstalls the list of products and writes a log file to the directory that you specified.



Related reference:

Command-line arguments for imcl


Uninstall silently using a response file

You can create a response file, and then run a command to use that response file to uninstall IBM Integration Designer.

Close all programs that you installed using Installation Manager.

To uninstall, you must log in to the system using the same user account used to install.

To silently uninstall IBM Integration Designer:

  1. Create the response files that will uninstall the required base products and IBM Integration Designer. Copy one of the sample response files in the following directory to create your own response file:

    • To uninstall both IBM Integration Designer and the test environment: dvd_root/disk1/responsefiles/responsefile.uninstall.iid.testenv.xml
    • To uninstall IBM Integration Designer alone: dvd_root/disk1/responsefiles/responsefile.uninstall.iid.xml

  2. Modify the parameters as directed in the text of the response file templates to create your response files. You can also create response files by recording your actions in Installation Manager. When you record a response file, the selections made in Installation Manager are stored in an XML file. When you run Installation Manager in silent mode, Installation Manager uses the data in the XML response file to perform the installation.

  3. To uninstall both IBM Integration Designer and the test environment:

      IM_location\tools\imcl.exe input extract_location\disk1\responsefiles\responsefile.uninstall.iid.testenv.xml -log silentuninstall.log

      IM_location/tools/imcl input extract_location/disk1/responsefiles/responsefile.uninstall.iid.testenv.xml -log silentuninstall.log

    To uninstall IBM Integration Designer alone:

      IM_location\tools\imcl.exe input extract_location\disk1\responsefiles\responsefile.uninstall.iid.xml -log silentuninstall.log

      IM_location/tools/imcl input extract_location/disk1/responsefiles/responsefile.uninstall.iid.xml -log silentuninstall.log

Installation Manager uninstalls IBM Integration Designer and writes a log file to the directory that you specified.


IBM Installation Manager information center


Troubleshooting the installation process

There are a few problems you might encounter when installing or removing IBM Integration Designer.

The table provides a list of problems, descriptions and solutions.

Possible problems with installation.

Issue Solution
Exceptions thrown during installation of IBM Integration Designer. The Installation Manager log files contain the following error:

    java.io.Exception: CreateProcess: "C:\...\security.update.bat" error = 5

The error indicates file-access permission problems. This problem can be caused by anti-virus software interfering with the installation process.

Ensure that you have sufficient permissions to install on this system and disable anti-virus software while you install IBM Integration Designer.
The test server does not appear in the Servers view.

  1. Verify the profile was created. The default profiles directory is one of the following directories:

    • C:\IBM\IID\PS\v8.5\profiles
    • /opt/ibm/IID/PS/v8.5/profiles

  2. Open a command prompt and navigate to the directory where IBM Integration Designer is installed. Enter the following command:

    • wid.exe -clean
    • ./wid.bin -clean

  3. If the server still does not appear, create a new server following the instructions in Create servers in the test environment.

Reinstalling cannot create new profile.

If you try to reinstall to the same location, or if you try to reinstall after a failed uninstall, the installation might fail because a new profile cannot be created.

If databases were created for the test environment, the databases must be dropped before you can create a new profile.

If the databases are not automatically dropped during uninstall, you must drop them manually.

  • For the qesb profile, the default databases are ECMNDB and QECMNDB (one or both)

  • For the qbpmaps profile, the default databases are QBPMDB, QPDWDB, and QCMNDB

  • For the qmwas profile, the default databases are MONITOR and COGNOSCS

  • For the qmbpmaps profile, the default databases are QBPMDB, QPDWDB, QCMNDB, MONITOR, and COGNOSCS

  • For the qmesb profile, the default databases are ECMNDB, QECMNDB, MONITOR, and COGNOSCS



Install IBM Integration Designer after IBM Business Process Manager Advanced

After you have installed IBM Business Process Manager Advanced: Process Server or IBM Business Process Manager Advanced and have created a Process Server profile, you can install Integration Designer and use the Process Server test environment.

Select your scenario and follow the instructions.


IBM Business Process Manager Advanced: Process Server installed with default profile (Process Server) created

After you have installed IBM Business Process Manager Advanced: Process Server with a default Process Server profile:

  1. Install Integration Designer using the last option on the launchpad (IBM Integration Designer), because the BPM test environment is already installed.

  2. Start Integration Designer. The server instance is detected and you see a test server in the Servers view.


Multiple IBM Business Process Manager Advanced: Process Server installed with default profile (Process Server) created

After you have installed more than one copy of IBM Business Process Manager Advanced: Process Server with default Process Server profiles:

  1. Install Integration Designer using the last option on the launchpad (IBM Integration Designer), because the BPM test environment is already installed.

  2. Start Integration Designer. You are prompted to select the test environment you want to use.


IBM Business Process Manager Advanced installed with default profile (Process Server) created

After you have installed IBM Business Process Manager Advanced with a default Process Server profile:

  1. Install Integration Designer using the last option on the launchpad (IBM Integration Designer), because the BPM test environment is already installed.

  2. Start Integration Designer.
  3. Manually add the Process Server to Integration Designer using the instructions in Create servers for process applications.

Integration Designer does not automatically detect IBM Business Process Manager Advanced installations, even if the default Process Server profile is created.


IBM Business Process Manager Advanced installed with Process Server profile (but not the default) created

After you have installed IBM Business Process Manager Advanced: Process Server or IBM Business Process Manager Advanced and created a Process Server profile:

  1. Install Integration Designer using the last option on the launchpad (IBM Integration Designer), because the BPM test environment is already installed.

  2. Start Integration Designer.
  3. Manually add the Process Server to Integration Designer using the instructions in Create servers for process applications.



+

Search Tips   |   Advanced Search