Difference between revisions of "Mosquitto from Source"
Jump to navigation
Jump to search
| (26 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{{!}} class="wikitable" style="float: right; width: 322px;" border="2" | |||
{{!}}+ Proven on: | |||
{{!}}- <!-- Debian --> | |||
{{!}} style="text-align: center; width: 60px;" {{!}} [[File:Logo Debian.png{{!}}60px{{!}}link=https://www.debian.org/{{!}}center{{!}}middle{{!}}frameless]] | |||
{{!}} style="text-align: center; width: 40px;" {{!}} 12 (bookworm) | |||
{{!}} | |||
<br> | |||
{{!}}} | |||
== '''<span style="color: rgb(132, 63, 161);">The required tools:</span>''' == | |||
* <code>apt install git build-essential autoconf cmake</code> | |||
== '''<span style="color: rgb(132, 63, 161);">Get the source:</span>''' == | |||
* <code>git clone <nowiki>https://github.com/eclipse/mosquitto.git</nowiki></code> | |||
== '''<span style="color: rgb(132, 63, 161);">The prerequisites:</span>''' == | |||
'''< | * <code>apt install libc-ares-dev libwebsockets-dev libssl-dev xsltproc docbook-xsl libsystemd-dev libwrap0-dev openssl</code> | ||
* # '''cJSON''' | |||
** <code>git clone <nowiki>https://github.com/DaveGamble/cJSON</nowiki></code> | |||
** <code>cd cJSON</code> | |||
** <code>mkdir build</code> | |||
** <code>cd build</code> | |||
** <code>cmake ..</code> | |||
** <code>make</code> | |||
** <code>sudo make install</code> | |||
** <code>cd ../..</code> | |||
* # '''uthash / utlist''' | |||
** <code>git clone <nowiki>https://github.com/troydhanson/uthash</nowiki></code> | |||
** <code>cp uthash/src/* mosquitto/include</code> | |||
* # '''For testing''' | |||
** <code>apt install python3-psutil</code> | |||
** <code>git clone <nowiki>https://gitlab.com/cunity/cunit.git</nowiki></code> | |||
** <code>cd cunit</code> | |||
** <code>mkdir local-build</code> | |||
** <code>cd local-build</code> | |||
** <code>cmake ..</code> | |||
** <code>cmake --build .</code> | |||
** <code>sudo make install</code> | |||
** <code>cd ../..</code> | |||
== '''<span style="color: rgb(132, 63, 161);">Build it:</span>''' == | |||
* <code>cd mosquitto</code> | * <code>cd mosquitto</code> | ||
* <code>make</code> | * <code>make</code> | ||
== '''<span style="color: rgb(132, 63, 161);">Test it:</span>''' == | |||
* <code>make test</code> | |||
or | |||
* <code>make check</code> | * <code>make check</code> | ||
'''<span style="color: rgb(132, 63, 161);" >Install it:</span>''' | '''Note:''' There are a fairly large number of tests that bring this to a grinding halt unless you comment them out. MUCH more research is needed... | ||
24/1474 [[Mosquitto from Source Test Failures{{!}}tests]] fail... | |||
18 of those make the test procedure halt... | |||
== '''<span style="color: rgb(132, 63, 161);">Install it:</span>''' == | |||
* <code>adduser --system --group mosquitto</code> | |||
* <code>sudo make install</code> | * <code>sudo make install</code> | ||
<span style="color: rgb( | * <code>sudo cp /etc/mosquitto/mosquitto.conf.example /etc/mosquitto/mosquitto.conf</code> | ||
== '''<span style="color: rgb(132, 63, 161);">Enable it as a systemd service:</span>''' == | |||
* <code>sudo cp service/systemd/mosquitto.service.simple /etc/systemd/system/mosquitto.service</code> | |||
* <code>sudo vi /etc/systemd/system/mosquitto.service</code> | |||
Fix the location in line 8. | |||
The install step on Debian puts the executable in '''/usr/local/sbin''' not '''/usr/sbin''' | |||
* <code>sudo systemctl daemon-reload</code> | |||
* <code>sudo systemctl restart mosquitto.service</code> | |||
= '''<span style="color: rgb(186, 55, 42); text-decoration: underline;">To be done:</span>'''= | |||
== '''<span style="color: rgb(132, 63, 161);">Configure it:</span>''' == | |||
Default configuration works just fine like a default install from the repos... | |||
That said... | |||
* <code>sudo vi /etc/mosquitto/mosquitto.conf</code> | |||
For now, take a look at the huge selection of options in there. | |||
After making any changes: | |||
* <code>sudo service mosquitto restart</code> | |||
== '''<span style="color: rgb(132, 63, 161);">Use it:</span>''' == | |||
This is a very deep rabbit hole. | |||
* | = Resources = | ||
* [https://mosquitto.org/documentation/ Mosquitto Documentation] | |||
* [https://github.com/eclipse/mosquitto Mosquitto GitHub Repo] | |||
Latest revision as of 19:22, 3 March 2024
 |
12 (bookworm) |
|
The required tools:
apt install git build-essential autoconf cmake
Get the source:
git clone https://github.com/eclipse/mosquitto.git
The prerequisites:
apt install libc-ares-dev libwebsockets-dev libssl-dev xsltproc docbook-xsl libsystemd-dev libwrap0-dev openssl- # cJSON
git clone https://github.com/DaveGamble/cJSONcd cJSONmkdir buildcd buildcmake ..makesudo make installcd ../..
- # uthash / utlist
git clone https://github.com/troydhanson/uthashcp uthash/src/* mosquitto/include
- # For testing
apt install python3-psutilgit clone https://gitlab.com/cunity/cunit.gitcd cunitmkdir local-buildcd local-buildcmake ..cmake --build .sudo make installcd ../..
Build it:
cd mosquittomake
Test it:
make test
or
make check
Note: There are a fairly large number of tests that bring this to a grinding halt unless you comment them out. MUCH more research is needed...
24/1474 tests fail...
18 of those make the test procedure halt...
Install it:
adduser --system --group mosquitto
sudo make install
sudo cp /etc/mosquitto/mosquitto.conf.example /etc/mosquitto/mosquitto.conf
Enable it as a systemd service:
sudo cp service/systemd/mosquitto.service.simple /etc/systemd/system/mosquitto.service
sudo vi /etc/systemd/system/mosquitto.service
Fix the location in line 8.
The install step on Debian puts the executable in /usr/local/sbin not /usr/sbin
sudo systemctl daemon-reload
sudo systemctl restart mosquitto.service
To be done:
Configure it:
Default configuration works just fine like a default install from the repos...
That said...
sudo vi /etc/mosquitto/mosquitto.conf
For now, take a look at the huge selection of options in there.
After making any changes:
sudo service mosquitto restart
Use it:
This is a very deep rabbit hole.