Overview

You are using a git-based source control repository like BitBucket and need the EGit plugin installed in the BPM Studio.  When you try to install the EGit 4.1.1 plugin that is compatible with the Eclipse 4.5.2 included with BPM Studio 2017 R1 or later, you get a handshake_failure error as shown below:

!ENTRY org.eclipse.equinox.p2.transport.ecf 2 0 2020-12-30 14:26:16.234 
!MESSAGE Connection to https://archive.eclipse.org/egit/updates-4.1.1/p2.index failed on Received fatal alert: handshake_failure. Retry attempt 0 started
!STACK 0
javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure

Prerequisites

• An installation of Aurea Process BPM Studio 2017 R1 or later

Solution

Diagnosis

The error Received fatal alert: handshake_failure indicates that BPM Studio is unable to download files from the EGit repository due to a TLS version incompatibility.  This issue is most likely due to the fact that JDK 1.7 is still being used (by default JDK 1.7 initiates TLS 1 handshakes).

Solution Steps

1. If not already installed, you will need to install JDK 1.8.0_191 or the latest version of Amazon Corretto JDK.  Ensure that this JDK is not installed in the Program Files directory like the following example:
   

   C:\Java\jdk1.8.0_191

2. Once the JDK is installed, stop BPM Studio if it is still running.
3. Right-click on the BPM Studio shortcut and change the version of the JDK used to launch BPM Studio by changing the JDK specified in the -vm parameter as shown below:
   
   Example:
   

   C:\Aurea\Process\BPMStudio2021\eclipse\eclipse.exe -vm  C:\Java\jdk1.8.0_191\bin\javaw.exe  -vmargs -Dfile.encoding=UTF-8 -Dstudio.home=C:\Aurea\Process\BPMStudio2021 -Xmx1024M    

4. Open the eclipse.ini file found in BPMSTUDIO_HOME\eclipse directory and change the JDK specified in the -vm parameter as shown below:
   
   Example:
   

   ...
   -showsplash
   com.aurea.tools.branding
   -vm 
   C:\Java\jdk1.8.0_191\bin\javaw.exe
   ...

5. Start BPM Studio and install the EGit Plugin using the instructions provided on the EGit 4.1.1 repository page.
   
   NOTE: As per the What version of Eclipse does EGit target section of the EGit FAQ page, version 4.1.1 targets Eclipse 4.5.2.

Testing

You are able to install EGit 4.1.1. plugin and can interact with your git repository using BPM Studio.