Issue

The Semarchy xDI Runtime does not start successfully. Depending on the environment, one of the following symptoms may be observed:

• The Runtime service starts and stops immediately.
• The Runtime process terminates a few seconds after startup.
• No Runtime process remains active after startup.
• The Runtime appears to start but is not reachable from Designer or Analytics.

Cause

Multiple issues can prevent the Runtime from starting correctly, including:

• Invalid Runtime configuration
• Unsupported Java version
• Port conflicts
• Missing modules or JDBC drivers
• Insufficient permissions
• Invalid Runtime startup parameters
• Memory allocation issues

Solution

1. Start the Runtime from a command line instead of using a service manager.
2. Redirect the Runtime output to a log file.
3. Example on Windows:

startcommand.bat > runtime-start.log 2>&1

4. Example on Linux:

./startcommand.sh > runtime-start.log 2>&1

5. Review the generated log file for startup errors.
6. Check the Runtime logs located in the Runtime log directory.
7. Verify the Java version used by the Runtime.
8. Validate that all required modules and JDBC drivers are present.
9. Confirm that the configured ports are available and not already used by another process.

Additional Checks

• Verify the Runtime can resolve all referenced hosts and databases.
• Verify the Runtime service account has access to installation and working directories.
• Check antivirus or endpoint protection software for blocked processes.
• Validate Runtime memory settings if the process stops during initialization.