Skip to content
Permalink
Browse files

Fix #315 - Add Troubleshooting guide

  • Loading branch information...
barbeau committed Mar 9, 2018
1 parent b120683 commit 3978916a0c9a2102978b5c05a408f10fb7dc18c1
Showing with 23 additions and 0 deletions.
  1. +4 −0 README.md
  2. +19 −0 TROUBLESHOOTING.md
@@ -109,6 +109,10 @@ Note that the validator also has a [batch processing mode](gtfs-realtime-validat

Want to run this in [Docker](https://www.docker.com/)? Check out [gtfs-realtime-validator-docker](https://github.com/scrudden/gtfs-realtime-validator-docker).

## Troubleshooting

Having problems? Check out our [Troubleshooting guide](TROUBLESHOOTING.md).

## CUTR Release Process

**Snapshots**
@@ -0,0 +1,19 @@
# Troubleshooting

Things not going well? See if your problem is one that we've encountered before.

### Java 9 compatibility - `NoClassDefFoundError: javax/xml/bind/JAXBException` when running project

*Symptom* - I try to run the application using Java 9, but I get an error message (e.g., `NoClassDefFoundError`) about missing modules

*Solution* - Java 9 changes to a modular architecture, which means that you need to tell Java to load certain modules required by the project.

Try including the `java.xml.bind` module with the `--add-modules` parameter:

`java -Djsee.enableSNIExtension=false --add-modules java.xml.bind -jar gtfs-realtime-validator-webapp/target/gtfs-realtime-validator-webapp-1.0.0-SNAPSHOT.jar`

### SSL handshake still fails after following [prerequisites](https://github.com/CUTR-at-USF/gtfs-realtime-validator#prerequisites-1)

*Symptom* - I use `java -Djsee.enableSNIExtension=false ...` as instructed to run the app when retrieving GTFS or GTFS-realtime feeds from HTTPS URLs over SSL, but it fails with an error like `javax.net.ssl.SSLHandshakeException: java.security.cert.CertificateException: No subject alternative DNS name matching www.donneesquebec.ca found.`

*Solution* - The underlying problem is probably with the server certificate configuration where the GTFS or GTFS-realtime data is hosted. You can try to change the parameter to `-Djsse.enableSNIExtension=true` instead, which has helped [in the past](https://github.com/CUTR-at-USF/gtfs-realtime-validator/pull/310) for Linux deployments.

0 comments on commit 3978916

Please sign in to comment.
You can’t perform that action at this time.