Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Download

    View file
    namehivemq-windows-service-022024.zip

  2. Unzip the downloaded file to the $HIVEMQ_HOME directory.

    • If you followed the abovementioned instructions, your $HIVEMQ_HOME directory is likely C:\hivemq\hivemq-windows-service-022024.

  3. If your $HIVEMQ_HOME directory is different, such as C:\hivemq\hivemq-4.2.25 or F:\HiveMQ, edit the wrapper’s configuration file as follows

    1. Locate the wrapper’s configuration file at conf/wrapper.conf. In our case its path C:\hivemq\hivemq-windows-service-022024\conf\wrapper.conf

    2. Find the line at the end of the file resembling:

      Code Block
      languagebash
      wrapper.java.additional.1 = -Dhivemq.home=C:\\hivemq
    3. Replace the existing text C:\\hivemq with your actual $HIVEMQ_HOME directory. For example, if it's F:\HiveMQ, update the line to:

      Code Block
      languagebash
      wrapper.java.additional.1 = -Dhivemq.home=F:\\HiveMQ
    4. save the file

  4. Once step 3 is complete, please proceed with the following steps:

    1. Remove the old (failing) HiveMQ service by

      1. Open services app with run(win+R)>services.msc

      2. Find the existing HiveMQ service

      3. Select the HiveMQ service and delete it

    2. Install the new service by running C:\hivemq\hivemq-windows-service-022024\bat\installService.bat (Run As Administrator might be necessary) under the newly unzipped service folder. This will install the new HiveMQ service.

    3. You can either restart the computer or Manually start the new HiveMQ service by going to run(win+R)>services.msc>HiveMQ service and starting it.

    4. Please monitor the HiveMQ service and look for any issues within the first 30 seconds.

    5. If the HiveMQ service runs without failing for more than 30 seconds, check the C:\hivemq\log\hivemq.log file for errors and ensure it contains "HiveMQ started in".

    6. Confirm that you can log in to the HiveMQ Control Center.

Info

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

🐛 Troubleshooting

\uD83E\uDD14 Problem

...