記錄一次過程（1）：Building Mosquitto from the git repository

Mosquitto

Mosquittto是針對MQTT 3.1版本和3.1.1版本的一個開源實現的服務器。它包含C和C++的客戶端庫，以及用於publish/subscribe的實用程序:mosquitto_pub/mosquitto_sub。

Mosquitto項目對於如何Building from source描述並不足夠清晰，但其實步驟也還算簡單。

步驟

1.cmake

使用命令cmake -DWITH_TLS_PSK=OFF -DWITH_TLS=OFF獲得

-- Configuring done
-- Generating done

這兩行中間有warning，因爲我只是須要搭建一個簡單的環境作簡單地測試，就沒有管warning。

2.make

使用命令make獲得

[100%] Linking C executable mosquitto
[100%] Built target mosquitto

3.sudo make install

使用命令sudo make install報錯。報錯信息以下：

Install the project...
-- Install configuration: ""
-- Up-to-date: /usr/local/etc/mosquitto/mosquitto.conf
-- Up-to-date: /usr/local/etc/mosquitto/aclfile.example
-- Up-to-date: /usr/local/etc/mosquitto/pskfile.example
-- Up-to-date: /usr/local/etc/mosquitto/pwfile.example
-- Up-to-date: /usr/local/lib/pkgconfig/libmosquitto.pc
-- Up-to-date: /usr/local/lib/pkgconfig/libmosquittopp.pc
-- Installing: /usr/local/lib/libmosquitto.1.5.5.dylib
-- Up-to-date: /usr/local/lib/libmosquitto.1.dylib
-- Up-to-date: /usr/local/lib/libmosquitto.dylib
-- Up-to-date: /usr/local/include/mosquitto.h
-- Installing: /usr/local/lib/libmosquittopp.1.5.5.dylib
-- Up-to-date: /usr/local/lib/libmosquittopp.1.dylib
-- Up-to-date: /usr/local/lib/libmosquittopp.dylib
-- Up-to-date: /usr/local/include/mosquittopp.h
-- Installing: /usr/local/bin/mosquitto_pub
-- Installing: /usr/local/bin/mosquitto_sub
-- Installing: /usr/local/sbin/mosquitto
-- Up-to-date: /usr/local/include/mosquitto_broker.h
-- Up-to-date: /usr/local/include/mosquitto_plugin.h
CMake Error at man/cmake_install.cmake:36 (file):
file INSTALL cannot find
"/Users/xxxx/Desktop/iMac-mosquitto/mosquitto-master/man/mosquitto_passwd.1".
Call Stack (most recent call first):
cmake_install.cmake:57 (include)
make: * [install] Error 1

報錯以後首先檢查報錯信息，google以後仍然有解決方面的困難。這時咱們注意到上面加粗的三行，切換到安裝目錄 /usr/local/include/ 後運行命令 mosquitto發現能夠運行，可是在安裝目錄外就不能夠運行。

這時候咱們的下一步就是配置環境變量，從而使mosquitto的運行不受當前目錄的限制。

4.添加環境變量

環境變量的做用是：能夠在操做系統的各個目錄下，都能訪問到須要的工具目錄內的內容。
我參考的是Mac OS X 系統的環境變量配置
分別將/usr/local/bin/以及/usr/local/sbin/加入環境變量以後(我將路徑加入了用戶級的~/.bash_profile)，就能夠運行mosquitto了。
可是還有一個煩人的小問題，就是Mac每次都要執行source ~/.bash_profile，配置的環境變量才生效。解決方法是：

在~/.zshrc文件最後，增長一行：
source ~/.bash_profile

5.運行測試

先開一個terminal，輸入命令mosquitto。
打開第二個terminal，輸入命令mosquitto_sub -h localhost -t test。
打開第三個terminal，輸入命令mosquitto_pub -h localhost -t test -m "hello world"。
發如今第二個terminal上出現了hello world字符串，即成功。

6.思考幾個問題，後續解決。

直接用cmake .是會因爲OpenSSL的路徑問題報錯的，OpenSSL是幹什麼用的？

我沒有去解決OpenSSL的路徑問題，而是忽略了它，關閉了TLS直接cmake的。TLS又是什麼？起到了什麼做用？

程序運行起來通過了哪些步驟？

一個大型項目是如何安裝運行起來的？

爲何安裝mosquitto的步驟是cmake->make->sudo make install?