Question
What to have in mind when updating to xServer 2?
Answer
1. Update Java to Version 17
Before anything else, ensure that your system uses Java 17 (64-bit).
Java is not bundled with PTV xServer 2. You must install it separately.
Recommended Java Distributions:
Amazon Corretto
Free OpenJDK distribution with long-term support.Oracle Java
Trusted distribution, free updates until September 2024. After that, commercial users require a license.
Optional: Multiple JREs?
If you work with multiple Java environments, define the Java path using the wrapper.conf file:
#*****************************
# Default environment settings
#*****************************
set.default.XSERVER2_JAVA_HOME=%JAVA_HOME%
set.default.XSERVER2_LOG_DIRECTORY=./logs
2. Install Additional Geocoding Data (xLocate)
To use xLocate for geocoding:
Copy the
gdc/folder (provided with your map data) into the root of your map installation.In
xserver.conf, ensure thegeocodingDataPathcorrectly points to the folder.
Example:
<geocodingDataPath>./gdc</geocodingDataPath>
3. Configure the Required Services
Once xServer 2 and map data are installed:
Enable only the services you need (e.g., xRoute, xMap, xLocate, etc.).
Follow the detailed configuration guide here:
Services Configuration – PTV Dashboard
Additional hints
Summary Checklist
| Task | Status |
|---|---|
| Java 17 (64-bit) installed | ⬜ |
JAVA_HOME or wrapper.conf set |
⬜ |
gdc/ folder copied and geocodingDataPath configured |
⬜ |
| Desired xServer modules configured | ⬜ |