An important update failed! Error in java.net.BindException

Symptom

This error might happen on a new GpsGate installation. If you get this error on the Site Admin interface:

An important update failed!

Updating to the latest version of Updates.v5 or Core did not complete successfully. Please check your error logs for more information and contact GpsGate support if needed.

Error logs are usually located on your server in c:\GpsGateServer\ErrorLog.

Problem

If you open in c:\GpsGateServer\ErrorLog and open a JVM log, you'll see this kind of message:

[gpsgate-akka.actor.default-dispatcher-3] ERROR akka.actor.OneForOneStrategy - Bind failed because of java.net.BindException: Address already in use: bind
akka.stream.impl.io.ConnectionSourceStage$$anon$2$$anon$1: Bind failed because of java.net.BindException: Address already in use: bind
Caused by: java.net.BindException: Address already in use: bind

This means that the default Messages port 8090 is in use by another process.

Solution

1. Log in to your GpsGate Server installation.

2. Open C:\GpsGateServer\Franson NMEA Service\GpsGate.Service.exe.config file with Notepad or any other plain text editor of your choice.

3. Add a setting within the <appSettings> section called MessageStorePort and set it to a port that is not in use. Example:

<add key="MessageStorePort" value="12345" />

4. Save the file.

5. Restart Franson NMEA service and voila!