PTV Route Optimiser ST - PTV xServer1 Services (xLocate Service, xMap Service, xRoute Service, xTerritory Service, xDima Service) Do Not Start

Issue

The PTV xServer1 services (xLocate Service, xMap Service, xRoute Service, xTerritory Service, xDima Service) do not start on the back-end server, preventing PTV Route Optimiser ST / Smartour from functioning correctly.

Symptoms

• Windows message when manually starting the service:

  Windows could not start the [Service] on Local Computer. [...] service-specific error code1.

  

• Service status shows failure in Services.
• In the Event Viewer, event with Source: Service Control Manager, Event ID 7024 (or 7000/7009), with an error message such as “Incorrect function”.

Cause

A desynchronization between the Java environment variable for the service (e.g., XSERVER1_JAVA_HOME) and the actual version of the JDK installed on the server (e.g., Amazon Corretto). The variable may point to a path that no longer exists if the JDK was updated or replaced.

Diagnostic and Resolution Steps

1. Check the application logs Review the /logs folder of the affected service.

2. Check the Event Viewer Under Windows Logs > System, look for events related to the service (Source: Service Control Manager) and note the exact error message.

3. Verify the Java environment variable in System Settings > Environment Variables, locate the service-specific variable (XSERVER1_JAVA_HOME) and compare the path it points to with the actual JDK folder present on the server (e.g., C:\Program Files\Amazon Corretto\).

4. Correct the variable Modify the variable so that it points to the currently installed JDK path.

5. Restart the services Restart the affected services (xLocate Service, xMap Service, xRoute Service, xTerritory Service, xDima Service) and verify in Services that the status returns to Running, with no new errors in the Event Viewer.

Prevention

After any server update or modification (Windows Update, JDK update, migration, etc.), verify that the Java environment variables still correspond to the version of the JDK actually installed.