Skip to main content


Installing IBM BPM v8.5.7 Standard on Ubuntu 14.04 (VirtualBox)

Following is a step-by-step process for installing IBM BPM v8.5.7 standard on Ubuntu 14.104:


  1. Install the latest VirtualBox software from Oracle – also download the Extension Pack.
  2. Download the software from the IBM Software Catalog
  3. Download the ISO file for Ubuntu 14.04 LTS – DESKTOP from Ubuntu
    1. **Note: You can download the Server version of Ubuntu 14.04 LTS, but you will either need to:
      1. Install a GUI desktop (Gnome or otherwise to perform the installation of BPM later
      2. Run the installation via command line instructions (not covered in this tutorial)
  4. Oracle Database Server (DB2 and Oracle are not natively supported in Ubuntu and quite frankly it’s a real headache to resolve the dependencies and get installed, instead we’re going to utilize a pre-built VM for this with Oracle 12c already installed) – Oracle

Pre-Installation Setup

  1. Using the VirtualBox and the Ubuntu 14.04 LTS ISO, create a Virtual Machine with at least 30GB of disk space and at least 4GB of memory.
  2. Create 2 Network Adapters
    1. NAT Adapter – this will allow for the Guest OS to have access to the internet
    2. Host-Only Network – used for Host-to-Guest communication
    3. In the Virtual Machine settings, under the Network section – create a Host-Only network
      1. Set the IP address to
      2. Disable the DHCP server
  3. In the Virtual Machine settings – create a Shared Folder linked to you DownloadDirector directory – typically located at C:\Users\\DownloadDirector
  4. Run the following command in Windows Command Prompt to enable symbolic links to the shared directory (you may need to change the working directory of your Windows command prompt to the VirtualBox installation folder – typically C:\Program Files\Oracle\VirtualBox
VBoxManage setextradata "BPM 8.5.7 (Ubuntu 14.04 LTS)" VBoxInternal2/SharedFoldersEnableSymlinksCreate/DownloadDirector 1
  1. Add the Port Forwarding Rules
    1. Create a BAT file with the following content
    2. Update the script such that the second line points to your Oracle VirtualBox installation directory
    3. Update the script such the machine name match the name you gave you VM instance
@echo off
cd "C:\Program Files\Oracle\VirtualBox"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - BOOTSTRAP_ADDRESS,tcp,,9810,,9810"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - SOAP_CONNECTOR_ADDRESS,tcp,,8880,,8880"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - ORB_LISTENER_ADDRESS,tcp,,9101,,9101"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - SAS_SSL_SERVERAUTH_LISTENER_ADDRESS,tcp,,9404,,9404"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS,tcp,,9405,,9405"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS,tcp,,9406,,9406"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - WC_adminhost,tcp,,9061,,9061"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - WC_adminhost,tcp,,9060,,9060"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - WC_defaulthost,tcp,,9080,,9080"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - DCS_UNICAST_ADDRESS,tcp,,9354,,9354"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - WC_adminhost_secure,tcp,,9044,,9044"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - WC_adminhost_secure,tcp,,9043,,9043"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - WC_defaulthost_secure,tcp,,9443,,9443"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - SIP_DEFAULTHOST,tcp,,5060,,5060"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - SIP_DEFAULTHOST_SECURE,tcp,,5061,,5061"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - OVERLAY_UDP_LISTENER_ADDRESS,tcp,,11007,,11007"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - OVERLAY_TCP_LISTENER_ADDRESS,tcp,,11008,,11008"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - IPC_CONNECTOR_ADDRESS,tcp,,9633,,9633"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - SIB_ENDPOINT_ADDRESS,tcp,,7276,,7276"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - SIB_ENDPOINT_SECURE_ADDRESS,tcp,,7286,,7286"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - SIB_MQ_ENDPOINT_ADDRESS,tcp,,5558,,5558"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - SIB_MQ_ENDPOINT_SECURE_ADDRESS,tcp,,5578,,5578"
VBoxManage modifyvm "BPM 8.5.7 (Ubuntu 14.04 LTS)" --natpf1 "BPM - SIB_MQ_ENDPOINT_SECURE_ADDRESS,tcp,,8879,,8879"
  1. Startup your virtual machine, open the terminal and run the following set of commands (these may need to modified depending on your installation and BPM software build
  2. Change the root password (necessary for BPM installation)
    1. sudo –i
    2. passwd
  3. Rollback the installed version of Firefox (BPM requires version < ~43)
    1. apt-get purge firefox
    2. apt-cache show firefox | grep Version
    3. apt-get install firefox=<result from previous call < ~43)
    4. apt-mark hold firefox
  4. Grant permission to the shared folder for your Linux user
    1. usermod -a -G vboxsf <username>
    2. Log out of you Ubuntu instance or re-login to pick up the new settings
  5. Setup the Host-Only network static IP address
    1. nano /etc/network/interfaces
    2. Add the following to the end of the file, save and reboot for settings to take effect
# new network
auto eth1
iface eth1 inet static
  1. Disable the Firewall
    1. sudo ufw disable
  2. Set the ulimit on your Linux by editing the /etc/security/limits.conf file, adding the following lines:
# - stack - maximum stack size (KB)
soft stack 32768
hard stack 32768
# - nofile - maximum number of open files
soft nofile 65536
hard nofile 65536
# - nproc - maximum number of processes
soft nproc 16384
hard nproc 16384
# - fsize - maximum file size
soft fsize 6291453
hard fsize 6291453
  1. Open the “Disks” utility and format the TemporaryStorage disk using the following settings:’”
  2. Mount the TemporaryStorage disk (using the Disks utility – this will mount the disk at the location /media/ubuntubpm/TemporaryStorage)
  3. Create a temporary directory for the installation extraction (i.e. – linuxInstall)
    1. mkdir /media/ubuntubpm/TemporaryStorage/linuxInstall
  4. Create a shell script file with the following contents – adjust for location/name of the folder created in the previous step
    1. *Note – the Network Folder created in Step #2 will be located at /media/sf_DownloadDirector
# Extract all BPM installation files
unzip ../ -d /media/ubuntubpm/TemporaryStorage/linuxInstall
tar -xvf ../tds63-linux-x86-64-base.tar -C /media/ubuntubpm/TemporaryStorage/linuxInstall
unzip ../ -d /media/ubuntubpm/TemporaryStorage/linuxInstalltar -zxvf ../DB2_10.5.0.3_limited_Lnx_x86-64.tar.gz -C /media/ubuntubpm/TemporaryStorage/linuxInstall
tar -zxvf ../DB2_AWSE_REST_Svr_11.1_Lnx_86-64.tar.gz -C /media/ubuntubpm/TemporaryStorage/linuxInstall
tar -zxvf ../DB2_NL_Pack_10.5.0.3_Linux_x86-64.tar.gz -C /media/ubuntubpm/TemporaryStorage/linuxInstall
tar -zxvf ../DB2_Svr_10.5.0.3_Linux_x86-64.tar.gz -C /media/ubuntubpm/TemporaryStorage/linuxInstall
unzip ../ -d /media/ubuntubpm/TemporaryStorage/linuxInstall
unzip ../ -d /media/ubuntubpm/TemporaryStorage/linuxInstalltar -zxvf ../BPM_PFS_V857_Linux_x86.tar.gz -C /media/ubuntubpm/TemporaryStorage/linuxInstallunzip ../ -d /media/ubuntubpm/TemporaryStorage/linuxInstall
tar -zxvf ../BPM_Std_V857_Linux_x86_1_of_3.tar.gz -C /media/ubuntubpm/TemporaryStorage/linuxInstall
tar -zxvf ../BPM_Std_V857_Linux_x86_2_of_3.tar.gz -C /media/ubuntubpm/TemporaryStorage/linuxInstall
tar -zxvf ../BPM_Std_V857_Linux_x86_3_of_3.tar.gz -C /media/ubuntubpm/TemporaryStorage/linuxInstall
  1. Execute the script
IBM / Red Hat - Unlock Potential App Modernization
Unlock Your Potential with Application Modernization

Application modernization is a growing area of focus for enterprises. If you’re considering this path to cloud adoption, this guide explores considerations for the best approach – cloud native or legacy migration – and more.

Get the Guide


Installation – Installation Manager (Optional – Not Required)

At the time of writing this guide, there were issues with directly installing BPM right off the bat where the GUI would run into issue down the road. Install the Installation Manager first and it will resolve these problems.

  1. Extract (this can be done directly on the Host OS, there are no linking dependencies for this installation file)
  2. Navigate to the directory and execute ./install
  3. Follow the GUI installation wizard prompts


Installation – BPM

  1. Run the installation (as root) via ./ and following the installation instructions
  2. Install Process Center
  3. Set the Process Center installation parameters
  4. Set the Database installation parameters
  5. Choose whether you want to download & install updates automatically during installation
  6. Run the installation
  7. Start the Deployment Environment

Post Setup – Automatically start BPM on boot

  1. Setup to allow ubuntubpm to sudo without password

    sudo visudo

    Add to the end of the file

    ubuntubpm ALL=(ALL) NOPASSWD: ALL

  2. Write a shell script

    nano /home/ubuntubpm/

    echo Auto-Starting BPM....
    if [ "$(whoami)" != "root" ]
    echo not root, switching to root...
    sudo su -s "$0"
    if [ "$(whoami)" == "root" ]
    echo ok, runnning as root...
    /opt/ibm/BPM/v8.5/profiles/DmgrProfile/bin/ -profileName DmgrProfile
    /opt/ibm/BPM/v8.5/profiles/Node1Profile/bin/ -profileName Node1Profile
    /opt/ibm/BPM/v8.5/bin/ -start -profile DmgrProfile -de ProcessCenter
    echo This window will close automatically in 30 seconds....
    sleep 30
  3. Make it executable – sudo chmod +x
  4. Open the “Startup Applications” preferences
  5. Add an entry for Auto-Starting BPM

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Dean Taylor, Technical Architect

More from this Author

Follow Us