Troubleshooting Process Mining

The following article covers frequent troubleshooting topics related to Process Mining. Process Mining transforms event logs into a process map capable of providing insights to better monitor and improve processes.  

Please visit the Introduction to Process Mining article for more information.

Process Mining starts but asks for a valid license

After running Process Mining, a License dialog appears stating, "In order to use Decisions Proces Mining, a valid license is required"; there are 3 possible options:

• The option "Operating along Decisions Server" was not selected during the installation.
• The decisions_baseurl is wrong.
• The Password for processmining@miningagents.internal is wrong.

Decisions Integration Not Enabled

To check if the integration with Decisions Server is enabled, click on "Settings" and be sure that "Enable Decisions Integration" is checked.

Restart Process Mining after the changes have been made.

Decisions BaseURL wrong

Download the log files to check if the Decisions BaseURL is wrong. The log files can be downloaded by clicking on the "Cog" icon on the top right corner and then clicking on "Download Error Logs".

The download zip file will contain 4 log files. Open the file named "sout-...". If the file contains the message "Decisions Server not reachable," it means that the decisions_baseurl is wrong. Please double-check that the URL is correct, that the protocol is included in the URL (e.g., HTTP or HTTPS), and finally that the protocol is correct; if the Decisions server is using an SSL certificate, the protocol must be HTTPS.

Edit the decisions_baseurl by clicking on "Settings" and then on the "Edit" button next to "Enable Decisions Integration," or edit the "application.property" file located in the "$ProcessMiningInstallationFolder$/ipa" folder if this is a local installation, or by editing the environment file if running via Docker.

Restart Process Mining after the changes have been made.

Incorrect Password for the processmining@miningagents.internal account

To check if the Password for the processmining@miningagents.internal account is wrong, download the log files. The log files can be downloaded by clicking on the "Cog" icon on the top right corner and then clicking on "Download Error Logs".

The download zip file will contain 4 log files. Open the file named "sout-...". If the file contains the message "Decisions Process Mining User not configured correctly, " the Password for the processmining@miningagents.internal account is wrong.

Edit the Password by clicking on "Settings" and then on the "Edit" button next to "Enable Decisions Integration".

Alternatively, edit the "application.property" file located in the "$ProcessMiningInstallationFolder$/ipa" folder if this is a local installation; in this case, the following property needs to be added:

decisions.password={processmining_account_password}

If running via Docker by editing the environment file. Reset the password of processmining@miningagents.internal directly within the Decisions Server. 

Restart Process Mining after the changes have been made.

Process Mining is not starting

If process mining is not starting, shut down process mining and add the following option to the "application.property" file. The "application.property" file is located in the "$ProcessMiningInstallationFolder$/ipa" folder if this is a local installation.

decisions.verbose=true

Once the new option has been added, restart process mining.