Installing multiple versions of the IBM BPM Process Designer on the same machine

Follow

Introduction
This article describes how you can install multiple versions of the IBM BPM Process Designer on a single computer.  

Note that if you want to connect to multiple Process Centers that are the same version you can simply edit the -Dcom.ibm.bpm.processcenter.url= value in the Process Designer eclipse.ini file to point to the appropriate Process Center. For instructions on how to create a shortcut to easily launch the Process Designer pointing to a different Process Center of the same version, see this article: https://support.bp-3.com/hc/en-us/articles/215836978.

Problem Statement
There are times where you may need multiple versions of the Process Designer installed on your system.  The current way that Process Designer is distributed does allow multiple versions to be installed using the default install method, as it assumes you will only ever interact with a single Process Center and that you should keep the Process Designer version in lock step with that Process Center Version.

Solution
When you download a Process Designer zip file from a given Process Center it is actually an Installation Manager package that is set to execute in a specific way in Installation Manager.  It is possible to extract the repository from this zip file and then run Installation Manager directly to install a given version of Process Designer in parallel with other.

Assumptions
These installation steps assume that you have already installed one version of the Process Designer using the standard installation.  If you have not done this, download the Process Designer zip file from the Process Center (https://ProcessCenterHost:port/ProcessCenter) "Download Process Designer" link, and install the Process Designer by running installProcessDesigner_admin.bat (or installProcessDeisgner_nonadmin.bat) located inside the zip file.

Instructions

Update Install Manager
First, you need to make sure you are running the most up-to-date version of Installation Manager.  Otherwise you can wind up with problems when trying to follow this procedure.

  1. Start the IBM Installation Manager on the system where you want Process Designer installed.
    (Start->All Programs->IBM Installation Manager->IBM Installation Manager)
  2. From the File menu select Preferences
  3. Click on the Updates option.
  4. Check the check box for Search for Installation Manger Updates
  5. Click OK
  6. Click the Install icon on the main screen.  If an installation manager update exists you will be prompted to install it before going to the installation screen.
  7. You should now have an updated Installation Manager.  If your Installation Manager was updated you will probably be prompted to relaunch.  Go ahead and do this if prompted.  You will need to use Installation Manager again in the steps below, so return to the main Installation Manager screen.


Add Process Designer Repository into Installation Manager
Next you need to add the Process Designer repository into the Installation Manager.

  1. Using a browser, navigate to the IBM BPM Process Center that you will be connecting to with the Process Designer (https://ProcessCenterHost:port/ProcessCenter).
  2. Login to the Process Center.
  3. Download the Process Designer by clicking the "Download Process Designer" link.
  4. Go to where you downloaded the Process Designer file on your file system and unzip the file (IBM Process Designer.zip). We will refer to the folder where you extracted the zip as {IBM_Process_Designer_Unzipped} for later reference.
    You will see several directories inside this folder:
    • etc (new in 8.5.0.1)
    • IM (this is the Install Manager)
    • IM64 (this is the Install Manger 64-bit - only found in newer Process Designers)
    • IMPD## (this is the Process Designer Install Manager files - where ## is the version of the Process Designer.  For BPM 8.0.1.0 this folder would be named IMPD80.)
  5. Open IBM Installation Manager.
  6. From the File menu, select Preferences.
  7. Select Repositories from the list of preferences (this should be selected by default)
  8. Click the Add Repository... button
  9. Click Browse and navigate to {IBM_Process_Designer_Unzipped}.
  10. Browse to the IMPD## folder
  11. Select the repository.config file
  12. Click Open (if you double clicked the file you won't need to do this)
  13. Click OK to exit the Add Repository dialog.  
    You should now see repository.config file for the Process Designer in the list of repositories.
  14. (Optional) If the downloaded Process Designer file also contains fixes, you will need to add these repositories as well. These will be located under {IBM_Process_Designer_Unzipped}/IMPD##/update/ in the fixesfixpacks, or refreshpacks sub directories.
  15. Click OK to exit the Preferences dialog.
    This will return you to the main screen of the Installation Manager.

Install the Process Designer

  1. In the main Install Manager window, click the Install button.  
    This will display a list of the packages that are available to install.
  2. Select the Process Designer version that you trying to install from the list.
  3. Click the Next > button.
  4. Verify that the Create a new package group radio button is selected (this should be the default)
  5. (Optional) If fixes are included in the Process Designer file, you may need to uncheck "Show recommended only" on the Install Packages screen to install all components.
  6. Select the directory where you want to install the Process Designer. We will call this {Process_Designer_install_dir} for later reference.
    Note that you should select a directory that does not already exist.
  7. Click the Next > button. 
    This will take you to the "Features" screen.
  8. Click the Next > button. (The defaults on this "Features" screen should be fine.)
  9. Review the Summary and click the Install button.
  10. Your Process Designer should install and you will be shown a verification screen when the install is complete.  Click the Finish button.

Manually copy files to complete the install
Because the we installed the Process Designer directly from Installation Manager, there are a couple files that you will need to copy manually to complete your install.

  1. Open your unzipped IBM Process Designer folder, {IBM_Process_Designer_Unzipped}.
  2. Copy or move the {IBM_Process_Designer_Unzipped}/eclipse.ini file into {Process_Designer_install_dir}.
    You will want to replace the eclipse.ini that exists in that location.
    You need to do this because the eclipse.ini file that is installed by default will point to http://localhost:9080 instead of your actual Process Center location. 
  3. For BPM 8.5.0.1 (and later), copy or move the {IBM_Process_Designer_Unzipped}/etc/trust.p12 file into your {Process_Designer_install_dir}/etc/.
    You will want to replace the trust.p12 file that exists in that location. 
    If you don't do this, you will receive a SSL Signer prompt the first time you log in which allows you to add the server keys to the Process Designer key store. We have experienced some issues when using this approach, so we recommend directly copying trust.p12 file. 

You should now have the new Process Designer in your Start menu. Run the Process Designer and validate that you can connect to the Process Center.

Optional Items
The start menu items for created for this can be confusing as you wind up with names like "IBM Process Designer_1" and "IBM Process Designer 8.0".  If you right click these items on the start menu and select "Open" you should be able to over-ride these names to have more obvious naming such as "IBM Process Designer 8.0.1.1".

Instructions to point a single Process Designer install to multiple Process Center environments of the same IBM BPM version can be found here: https://support.bp-3.com/hc/en-us/articles/215836978.

Conclusion
You should now have multiple Process Designers available within a single Windows install.  Note that if you use the wrong version of the Process Designer to connect to a Process Center this can cause errors to be thrown and possible corruption of your BPM solution.  If you get errors when logging in verify that you are using the correct version of Process Designer.

Have more questions? Submit a request

Comments

  • Avatar
    Scott Francis

    This is great content, looking forward to more like it!

  • Avatar
    Theodore Lano

    This was extremely helpful - thanks for keeping up-to-date!

Powered by Zendesk