TDengine Database 是一款客戶端-服務(wù)端模式產(chǎn)品，當(dāng)客戶端遇到鏈接故障，不能正常連接到服務(wù)端時(shí)，很多情況下是由于網(wǎng)絡(luò)問(wèn)題引起的，可以使用TDengine 客戶端程序taos內(nèi)嵌的網(wǎng)絡(luò)連通檢測(cè)工具來(lái)快速定位原因。

2021.08.27更新，新增網(wǎng)絡(luò)測(cè)速工具：https://tdengine.com/2021/08/27/2943.html

在使用taos內(nèi)嵌的網(wǎng)絡(luò)連通檢測(cè)工具前，請(qǐng)先按照下面的步驟進(jìn)行網(wǎng)絡(luò)狀況檢查：

1. 檢查網(wǎng)絡(luò)環(huán)境
   • 云服務(wù)器：檢查云服務(wù)器的安全組是否打開TCP/UDP 端口6030-6042的訪問(wèn)權(quán)限
   • 本地虛擬機(jī)：檢查網(wǎng)絡(luò)能否ping通，盡量避免使用localhost 作為hostname
   • 公司服務(wù)器：如果為NAT網(wǎng)絡(luò)環(huán)境，請(qǐng)務(wù)必檢查服務(wù)器能否將消息返回值客戶端
2. 確?？蛻舳伺c服務(wù)端版本號(hào)是完全一致
3. 在服務(wù)器，執(zhí)行 systemctl status taosd 檢查taosd運(yùn)行狀態(tài)。如果沒(méi)有運(yùn)行，啟動(dòng)taosd
4. 確認(rèn)客戶端連接時(shí)指定了正確的服務(wù)器FQDN (Fully Qualified Domain Name(可在服務(wù)器上執(zhí)行Linux命令hostname -f獲得）
5. ping服務(wù)器的FQDN，如果沒(méi)有反應(yīng)，請(qǐng)檢查你的網(wǎng)絡(luò)，DNS設(shè)置，或客戶端所在計(jì)算機(jī)的系統(tǒng)hosts文件。如果所在的網(wǎng)絡(luò)中沒(méi)有DNS，或DNS中沒(méi)有配置服務(wù)器的FQDN，必須在計(jì)算機(jī)系統(tǒng)的hosts文件中配置。比如服務(wù)端的hostname是 abc.fast.com，ip是192.168.1.131。對(duì)于Linux系統(tǒng)的客戶端，在/etc/hosts文件添加如下的一條記錄：192.168.1.131       abc.fast.com對(duì)于Windows系統(tǒng)的客戶端，在C:\Windows\System32\drivers\etc\hosts文件中添加如下一條記錄：192.168.1.131       abc.fast.com
6. 檢查防火墻設(shè)置，如果使能了防火墻，請(qǐng)確認(rèn)TCP/UDP 端口6030-6042 是打開的
7. 對(duì)于Linux上的JDBC（ODBC, Python, Go等接口類似）連接, 確保libtaos.so在目錄/usr/local/lib/taos里, 并且/usr/local/lib/taos在系統(tǒng)庫(kù)函數(shù)搜索路徑LD_LIBRARY_PATH里
8. 對(duì)于windows上的JDBC, ODBC, Python, Go等連接，確保driver/c/taos.dll在你的系統(tǒng)搜索目錄里 (建議taos.dll放在目錄 C:\Windows\System32)
9. 如果仍不能排除連接故障，請(qǐng)使用taos內(nèi)嵌的網(wǎng)絡(luò)連通檢測(cè)工具：驗(yàn)證服務(wù)器和客戶端之間指定的端口連接是否通暢（包括TCP和UDP）。

有兩種測(cè)試場(chǎng)景：一是環(huán)境中沒(méi)有在運(yùn)行的taosd服務(wù)，二是環(huán)境中已經(jīng)有在運(yùn)行的taosd服務(wù)。下面分別對(duì)這兩種情況的測(cè)試進(jìn)行描述。

一、環(huán)境中沒(méi)有運(yùn)行的taosd服務(wù)

taos 通過(guò)參數(shù) -n 來(lái)確定運(yùn)行服務(wù)端功能，還是客戶端功能。

-n server：表示運(yùn)行檢測(cè)服務(wù)端功能；

-n client：表示運(yùn)行檢測(cè)客戶端功能。

1）在服務(wù)器運(yùn)行taos內(nèi)嵌的網(wǎng)絡(luò)連通檢測(cè)的服務(wù)端功能，如：taos -n server -P 6030 -e 6042 -l 1000；

2）在客戶端運(yùn)行taos內(nèi)嵌的網(wǎng)絡(luò)連通檢測(cè)的客戶端功能，如：taos -n client -h host -P 6030 -e 6042 -l 1000；

該功能相關(guān)的5個(gè)參數(shù)說(shuō)明：

-n ：指示運(yùn)行網(wǎng)絡(luò)連通檢測(cè)的服務(wù)端功能，或客戶端功能，缺省值為空，表示不啟動(dòng)網(wǎng)絡(luò)連通檢測(cè)；

-h：指示服務(wù)端名稱，可以是ip地址或fqdn格式。如：192.168.1.160，或 192.168.1.160:6030，或 hostname1，或hostname1:6030。缺省值是127.0.0.1。

-P ：檢測(cè)的起始端口號(hào)，缺省值是6030；

-e：檢測(cè)的結(jié)束端口號(hào)，必須大于等于起始端口號(hào)，缺省值是6042；

-l：指定檢測(cè)端口連通的報(bào)文長(zhǎng)度，最大64000字節(jié)，缺省值是1000字節(jié)，測(cè)試時(shí)服務(wù)端和客戶端必須指定相同；

服務(wù)端設(shè)置的起始端口和結(jié)束端口號(hào)，必須包含客戶端設(shè)置的起始端口和結(jié)束端口號(hào)；對(duì)于起始端口號(hào)有三種設(shè)置方式：缺省值、-h指定、-P指定，優(yōu)先級(jí)是：-P指定 > -h指定 > 缺省值?？蛻舳诉\(yùn)行的輸出樣例：

ubuntu@u60 ~/taos/test$ ./taos -n client -h ubuntu-7060 -P 6030 -e 6042 -l 16000
host: ubuntu-7060	start port: 6030	end port: 6042	packet len: 16000

tcp port:6030 test ok.		udp port:6030 test ok.
tcp port:6031 test ok.		udp port:6031 test ok.
tcp port:6032 test ok.		udp port:6032 test ok.
tcp port:6033 test ok.		udp port:6033 test ok.
tcp port:6034 test ok.		udp port:6034 test ok.
tcp port:6035 test ok.		udp port:6035 test ok.
tcp port:6036 test ok.		udp port:6036 test ok.
tcp port:6037 test ok.		udp port:6037 test ok.
tcp port:6038 test ok.		udp port:6038 test ok.
tcp port:6039 test ok.		udp port:6039 test ok.
tcp port:6040 test ok.		udp port:6040 test ok.
tcp port:6041 test ok.		udp port:6041 test ok.
tcp port:6042 test ok.		udp port:6042 test ok.

如果某個(gè)端口不通，會(huì)輸出 port：xxxx test fail的信息。如:

ubuntu@u60 ~/taos/test$ ./taos -n client -h ubuntu-7060 -P 6030 -e 6042 -l 16000
host: ubuntu-7060	start port: 6030	end port: 6042	packet len: 16000

tcp port:6030 test ok.		udp port:6030 test ok.

connect() fail: Connection refused	tcp port:6031 test fail.
Read ack pkg len: -1, less than req pkg len: 16000 from udp port: 6031    udp port:6031 test fail.

tcp port:6032 test ok.		udp port:6032 test ok.
tcp port:6033 test ok.		udp port:6033 test ok.
tcp port:6034 test ok.		udp port:6034 test ok.
tcp port:6035 test ok.		udp port:6035 test ok.
tcp port:6036 test ok.		udp port:6036 test ok.
tcp port:6037 test ok.		udp port:6037 test ok.
tcp port:6038 test ok.		udp port:6038 test ok.
tcp port:6039 test ok.		udp port:6039 test ok.
tcp port:6040 test ok.		udp port:6040 test ok.
tcp port:6041 test ok.		udp port:6041 test ok.
tcp port:6042 test ok.		udp port:6042 test ok.

二、環(huán)境中有運(yùn)行的taosd服務(wù)

此時(shí)只需要在客戶端環(huán)境運(yùn)行 taos客戶端測(cè)試功能， 通過(guò)參數(shù) -n rpc：表示向正在運(yùn)行的taosd服務(wù)發(fā)起檢測(cè)。其他參數(shù)與上面完全相同?？蛻舳诉\(yùn)行的輸出樣例：

plum@plum-VirtualBox ~/git/v20 $ taos -n clients
host: 127.0.0.1	start port: 6030	end port: 6042	packet len: 1000

TCP port:6030 test OK		UDP port:6030 test OK

TCP port:6031 test fail.		udp port:6031 test fail.

TCP port:6032 test fail.		udp port:6032 test fail.

TCP port:6033 test fail.		udp port:6033 test fail.

TCP port:6034 test fail.		udp port:6034 test fail.

TCP port:6035 test OK		UDP port:6035 test OK

TCP port:6036 test fail.		udp port:6036 test fail.

TCP port:6037 test fail.		udp port:6037 test fail.

TCP port:6038 test fail.		udp port:6038 test fail.

TCP port:6039 test fail.		udp port:6039 test fail.

TCP port:6040 test fail.		udp port:6040 test fail.

TCP port:6041 test fail.		udp port:6041 test fail.

TCP port:6042 test fail.		udp port:6042 test fail.

表示此時(shí)taosd只監(jiān)聽了6030/6035端口，其他端口暫時(shí)沒(méi)有啟用。

6041是HTTP模塊使用的端口、6042是arbitrator使用的端口，此方法無(wú)法檢測(cè)這兩個(gè)端口。只能使用第一種方法進(jìn)行檢測(cè)。