Windows Service Fails to Start

\uD83E\uDD14 Problem

The Windows service fails to start following the instructions provided in this link or in the HiveMQ Documentation.

The solution involves utilizing the newer version of the Java wrapper, a tool specifically designed for running Java programs as Windows services.

Download
Unzip the downloaded file to the $HIVEMQ_HOME directory.
- If you followed the abovementioned instructions, your $HIVEMQ_HOME directory is likely C:\hivemq.
If your $HIVEMQ_HOME directory is different, such as C:\hivemq\hivemq-4.2.25 or F:\HiveMQ, edit the wrapper’s configuration file.
If your $HIVEMQ_HOME directory is not C:\hivemq, but, for example, C:\hivemq\hivemq-4.9.15, or F:\HiveMQ, then you need to edit the wrapper’s configuration file.
1. Locate the wrapper’s configuration file at conf/wrapper.conf.
2. Find the line at the end of the file resembling:
```
wrapper.java.additional.1 = -Dhivemq.home=C:\\hivemq
```
3. Update the C:\\hivemq according to your actual $HIVEMQ_HOME directory. For example, if it's F:\HiveMQ, update the line to:
```
wrapper.java.additional.1 = -Dhivemq.home=F:\\HiveMQ
```
Once the wrapper directory is within the $HIVEMQ_HOME directory and wrapper.conf matches the actual $HIVEMQ_HOME, proceed to the services.
1. Remove the old (failing) HiveMQ service.
2. Run bat\installService.bat (Run As Administrator might be necessary) under the newly unzipped service folder. This will install the new HiveMQ service.
3. Start the new HiveMQ service and monitor for any issues within the first 30 seconds.
4. If the HiveMQ service runs without failing for more than 30 seconds, check the hivemq.log file for errors and ensure it contains "HiveMQ started in".
5. Confirm that you can log in to the HiveMQ Control Center.

If you prefer building the wrapper on your own, for example, for a newer version, follow its author’s instructions provided in this video.