diff --git a/documentation20/webdocs/markdowndocs/faq-ch.md b/documentation20/webdocs/markdowndocs/faq-ch.md index 2b51458f27594af84ba360a323ac77f214eeb583..266aea4c5116d613631a3236a70607c4801c3aff 100644 --- a/documentation20/webdocs/markdowndocs/faq-ch.md +++ b/documentation20/webdocs/markdowndocs/faq-ch.md @@ -24,21 +24,71 @@ 客户端遇到链接故障,请按照下面的步骤进行检查: 1. 检查网络环境 - * 云服务器:检查云服务器的安全组是否打开TCP/UDP 端口6030-6039的访问权限 + * 云服务器:检查云服务器的安全组是否打开TCP/UDP 端口6030-6042的访问权限 * 本地虚拟机:检查网络能否ping通,尽量避免使用`localhost` 作为hostname * 公司服务器:如果为NAT网络环境,请务必检查服务器能否将消息返回值客户端 + 2. 确保客户端与服务端版本号是完全一致的,开源社区版和企业版也不能混用 + 3. 在服务器,执行 `systemctl status taosd` 检查*taosd*运行状态。如果没有运行,启动*taosd* + 4. 确认客户端连接时指定了正确的服务器FQDN (Fully Qualified Domain Name(可在服务器上执行Linux命令hostname -f获得) + 5. ping服务器FQDN,如果没有反应,请检查你的网络,DNS设置,或客户端所在计算机的系统hosts文件 -6. 检查防火墙设置,确认TCP/UDP 端口6030-6039 是打开的 + +6. 检查防火墙设置,确认TCP/UDP 端口6030-6042 是打开的 + 7. 对于Linux上的JDBC(ODBC, Python, Go等接口类似)连接, 确保*libtaos.so*在目录*/usr/local/lib/taos*里, 并且*/usr/local/lib/taos*在系统库函数搜索路径*LD_LIBRARY_PATH*里 + 8. 对于windows上的JDBC, ODBC, Python, Go等连接,确保*driver/c/taos.dll*在你的系统搜索目录里 (建议*taos.dll*放在目录 *C:\Windows\System32*) + 9. 如果仍不能排除连接故障,请使用命令行工具nc来分别判断指定端口的TCP和UDP连接是否通畅 检查UDP端口连接是否工作:`nc -vuz {hostIP} {port} ` 检查服务器侧TCP端口连接是否工作:`nc -l {port}` 检查客户端侧TCP端口链接是否工作:`nc {hostIP} {port}` + +10. 可以使用taos程序内嵌的网络连通检测功能:验证服务器和客户端之间指定的端口连接是否通畅(包括TCP和UDP)。 + + taos通过参数 -n 来确定运行服务端功能,还是客户端功能。-n server:表示运行检测服务端功能;-n client:表示运行检测客户端功能。 + + 1)首先在服务器上停止taosd服务; + + 2)在服务器上运行taos内嵌的网络连通检测的服务端功能:taos -n server -P 6030 -e 6042 -l 1000; + + 3)在客户端运行taos内嵌的网络连通检测的客户端功能:taos -n client -h host -P 6030 -e 6042 -l 1000; + + -n :指示运行网络连通检测的服务端功能,或客户端功能,缺省值为空,表示不启动网络连通检测; + + -h:指示服务端名称,可以是ip地址或fqdn格式。如:192.168.1.160,或 192.168.1.160:6030,或 hostname1,或hostname1:6030。缺省值是127.0.01。 + + -P :检测的起始端口号,缺省值是6030; + + -e:检测的结束端口号,必须大于等于起始端口号,缺省值是6042; + + -l:指定检测端口连通的报文长度,最大64000字节,缺省值是1000字节; + + 服务端设置的起始端口和结束端口号,必须包含客户端设置的起始端口和结束端口号; + + 对于客户端,起始端口号的有三种方式:缺省值、-h指定、-P指定,优先级是:-P指定 > -h指定 > 缺省值。 + + 客户端运行的输出样例: + + `sum@sum-virtualBox /home/sum $ taos -n client -h ubuntu-vbox6 + host: ubuntu-vbox6 start port: 6030 end port: 6042 packet len: 1000 + 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.` ## 6. 遇到错误“Unexpected generic error in RPC”, 我怎么办? 产生这个错误,是由于客户端或数据节点无法解析FQDN(Fully Qualified Domain Name)导致。对于TAOS Shell或客户端应用,请做如下检查: