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:

Downloads

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 192.168.56.1
      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

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

6. 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
7. Change the root password (necessary for BPM installation)
   1. sudo –i
   2. passwd
8. 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
9. 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
10. 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

11. Disable the Firewall
    1. sudo ufw disable
12. Set the ulimit on your Linux by editing the /etc/security/limits.conf file, adding the following lines:

13. Open the “Disks” utility and format the TemporaryStorage disk using the following settings:’”
    
14. Mount the TemporaryStorage disk (using the Disks utility – this will mount the disk at the location /media/ubuntubpm/TemporaryStorage)
    
15. Create a temporary directory for the installation extraction (i.e. – linuxInstall)
    1. mkdir /media/ubuntubpm/TemporaryStorage/linuxInstall
16. 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

17. Execute the script

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 installer.lnx.gtk.x86_64_1.8.5.zip (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 ./launchPad.sh 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/autoStartBPM.sh

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