Log files and error messages
The chapter gives you hints on what to do in case of certain problems during the installation.
All error messages are written to the Process Extractor log files.
The log files are located in <ARIS Process Mining installation>\logs directory.
Extractor.log contains the messages of Process Extractor.
ExtractorPerf.log contains the messages of performance measurements.
ExtractorCLI.log contains the messages of the CLI tool.
ExtractorCommunication.log contains the messages of the communication between Process Extractor and ARIS Process Mining.
ExtractorService.log contains the log messages of the Extractor service wrapper.
Possible errors during startup
ARIS Process Mining denied start of this extractor
ERROR||||0000000000|main|communication - ARIS Process Mining denied start of this extractor. An extractor with the same credentials is recognized as alive (Timeout after 120s).
This error occurs when you restart your extractor or when you try to connect another extractor with the same credentials that are used by an already connected extractor.
If the extractor looses the connection to ARIS Process Mining, ARIS Process Mining waits 120s for an extractor to reconnect to the previously used connection. After the 120s, ARIS Process Mining does no longer reserves the connection and it can be renewed by a starting extractor. That is, if you restart the extractor, you must wait 120s. If you want to use another extractor, you must shut down your existing one to be able to use the connection.
Note that when you restart an extractor, all tasks in processing for the connection in ARIS Process Mining to this extractor are set to failed.
ARIS Process Mining connection error
WARN ||||0000000000|main|communication - PROCESS_MINING_CONNECTION_ERROR: INFO ||||0000000000|main|communication - Please import valid ARIS Process Mining Configuration... ERROR||||0000000000|main|communication - 401 Unauthorized: [no body]
The error occurs when on extractor start up the ARIS Cloud authentication server (arisCloudUrl property in the ProcessMiningConfiguration.json file) is invalid or could not be reached. Check the value of the arisCloudUrl property in the ProcessMiningConfiguration.json file.
MCP authorization error
2021-01-28T08:36:41,996|WARN ||||0000000000|main|communication - MCP_AUTHORIZATION_ERROR: 2021-01-28T08:36:41,997|INFO ||||0000000000|main|communication - Please import valid ARIS Process Mining Configuration... 2021-01-28T08:36:42,005|ERROR||||0000000000|main|communication - 401 Unauthorized: [no body]
This error occurs when either the projectRoom or the clientCredentials are not recognized by the ARIS Cloud authentication server. Check the values of the projectRoom and the clientCredentials properties in the ProcessMiningConfiguration.json file.
Configuration file not correct
WARN ||||0000000000|main|communication - CONFIGURATION_FILE_NOT_CORRECT: conf\ProcessMiningConfiguration.json;arisCloudUrl: PM_CONFIG_MCP_URL_NOT_VALID INFO ||||0000000000|main|communication - Please import valid ARIS Process Mining Configuration...
The error occurs when mandatory entries in a configuration are missing or are maintained with incorrect values. The error message displays the name of the configuration file and the property that is causing the error.
In the example above, "conf\ProcessMiningConfiguration.json;arisCloudUrl: PM_CONFIG_MCP_URL_NOT_VALID" means that the arisCloudUrl property in the ProcessMiningConfiguration.json configuration file is invalid.