如何彻底搞懂TDengine的fqdn概念?这一篇文章就够了

2022-03-22 00:00:00 客户端 参数 都是 节点 配置

小T导读:很多新用户在配置TDengine的时候,偶尔会因为没有配置好FQDN,导致出现“unable to resolve FQDN”问题。所以大家会因为这个问题向TDengine的研发团队求助。本文会讲解FQDN的相关设计和配置,希望能帮助用户避免类似问题。

关于TDengine的FQDN机制,很多用户都表示:为什么TDengine要使用它,直接用IP不好吗?

其实是这样,早在2.0之前的版本TDengine 确实是使用IP的。但是考虑到很多生产环境下IP都是会变动的,所以自2.0版本后,我们就引入了FQDN机制。

首先,为了避免混淆,我们要澄清两个概念,避免混淆,一个是TDengine的“fqdn参数”,一个是作为网络服务的FQDN概念本身。当作为一个概念的时候,FQDN又和域名、hostname这些概念有关,因此我们需要仔细理解。

所以,为了让大家理清这个逻辑,在文章中我们会用“fqdn参数”和“FQDN”来分别指代参数和FQDN概念本身。

FQDN的全称是Fully Qualified Domain Name。与域名相对,我们暂且翻译成全域名比较好理解一点。

FQDN分为两部分组成:

1.Hostname:主机名,一般来说Linux当中运行hostname命令就可以获取,例如TDengine1;

2.Domain:域名,如taosdata.com。

所以一个全域名可以简单理解为一个带着主机名的域名。

因此,上述情况下一个完整的FQDN就应该是TDengine1.taosdata.com。但是为了方便快速体验,TDengine在安装后会直接默认取本机的hostname——TDengine1作为fqdn参数的值。

概念和背景介绍完之后,接下来我们进入配置阶段:

首先我们要明确的一件事就是——只要你需要从客户端远程连接TDengine,那么服务端的fqdn参数强烈建议要手动配置而不是默认值。而且在配置的时候,不论是ip形式还是FQDN形式都是可以提供给客户端用于连接的,配置方式如下:

在修改fqdn参数之后,我们要在/etc/hosts文件中(或DNS服务)添加上TD1和对外的ip地址。

后,修改/var/lib/taos/dnode/dnodeEPs.json里面的fqdn信息,数据库服务就可以正常启动了。(如果初次安装数据库,服务仍未启动,则不会生成这些文件,可以忽略本步骤)

了解了服务端配置的正确配置方法后,接下来,我们才要开始分析客户端的连接问题。

其实,不论在服务端fqdn参数中指定的值是不是IP,客户端都是可以直接用IP来与服务端建立连接的。

如下图所示,分别是Linux和Windows客户端的连接界面:

所以,这套机制的核心不在于taos -h的参数是IP还是fqdn参数值。而是在于从服务端取回的fqdn参数值能否被解析成正确的IP,它才是关乎于你能否顺利操作数据的关键。

接下来,我要给大家举两个反例,也是大家经常遇到的两个场景。

已知,服务端的IP地址为192.168.56.161,fqdn参数设置为TD1。

出现场景1的原因是——在这个客户端的hosts文件(或者DNS服务)中,没有写TD1。上图中,客户端用taos -h 192.168.56.161连接到TDengine服务端,取回TD1作为通讯地址。当执行查询的时候,TDengine试图把TD1解析成ip却发现TD1并不在其中——这就是Unable to resolve FQDN。

场景2:

已知,服务端的IP地址为192.168.56.161,fqdn参数设置为TD1。

当查询数据的时候,TDengine试图把TD1在hosts文件(或DNS服务)中解析成IP。但是由于IP地址写错了。因此客户端解析出来的IP地址并不可用,从而无法建立连接——也就出现了“Unable to establish connection”的问题。

针对以上这两个常见问题,我们只要把服务端的fqdn参数值和IP,正确地写入到客户端的hosts(或DNS服务)文件中就好了。

那么,前面提到过的“如果需要客户端远程连接TDengine,我们就一定要手动修改服务端的fqdn参数值”又是为什么呢?

是这样的:因为TDengine会默认读取本机的hostname作为fqdn参数的值,所以很多新安装的数据库服务的fqdn参数都是“localhost”,或是“ubuntu”之类的名字。这时候如果你的客户端hostname恰好也是localhost或者ubuntu,解析后,客户端就会直接连到127.0.0.1(自己)——unable to establish connection发生了。

这个问题是新用户遇到频率超高的典型问题,所以好的办法还是自己写一个新的fqdn值。

上述只是针对单节点数据库的连接情况,在集群中情况稍有不同,但原理始终一致。

如下图所示:A, B, C三台机器上分别部署TDengine形成集群。每个节点都是通过自身的hosts(DNS服务)文件解析FQDN后,寻址到IP后通过网络层互相通讯。

比如:当TD-A节点发送消息给TD-B的时候,需要在TD-A自身,找到TD-B对应的IP。因此我们需要在节点A的hosts(DNS服务)中添加节点B。

同理,当TD-B节点在主动给TD-A发送消息时,也需要在TD-B自身当中,找到TD-A对应的IP。因此我们需要在节点B的hosts(DNS服务)中添加节点A。

TD-C同上。

因此,如果节点之间互相通讯时出现Unable to resolved FQDN,一定是某一方的hosts文件(DNS服务)里,找不到对应的FQDN。

接下来我们加入客户端:

(这里我们要提一下TDengine的架构,其实在每一个安装包中都是自带客户端的,所以上面提到的情况中客户端已经在参与了,本段提及的客户端特指客户端与服务端分离的情况)

客户端和集群之间的通讯,通常是我们出错的重灾区。因为TDengine点对点的设计,容易让用户忽略掉除连接目标以外的集群服务器的网络问题。

一个正常的客户端远程连接集群的架构图应该如下图所示——TD-A,TD-B,TD-C都需要存在于客户端的hosts(DNS服务)当中。

在以上整个使用FQDN的链路当中,有任何1个不通都会出问题,但是这类错误通常都具有隐蔽性:我们知道TDengine是一款分布式的大数据处理引擎,所以它的数据不只存在于一个节点上,也不是只有一份。这时候如果你的客户端没有完全添加所有的fqdn到hosts(DNS服务)中,就可能会出现下面这种现象:

前几天你搭建了集群,show dnodes看到节点都是ready,随便查询了几张表都OK,写入几个表也没问题——测试过了,万事大吉。

但是未来的某一天,你突然发现在写入某张表的时候TDengine报错了,但是写入一些其他表就没问题——这是怎么回事呢?难道是bug?

并不是那样。

首先,集群中的数据库一般都是多副本的,这意味着一个虚拟数据节点(vnode)有多个副本,以Master-slave形式存在。而TDengine的查询操作可以在任意(Master或者Slave)节点进行,但是写入操作只能在 Master 节点上进行。所以,如果当你写入的那个表的Master节点恰巧就在你无法通过fqdn连接到的节点上时,这个写入操作就会报错。

事实上,集群连接的报错逻辑和单机版是类似的:如果客户端服务器没有在hosts(DNS服务)文件中配置正确的FQDN名字,就会报——unable to resolve FQDN。如果配置了FQDN名字但是ip配错了,就会报——unable to establish connection或者database not ready。

所以,这部分问题一般都是配置疏漏导致,官方文档原文如下:

“客户端也需要配置,确保它可以正确解析每个节点的fqdn配置,不管是通过DNS服务,还是 hosts 文件。”

因此,简单的确认配置方法就是去查看所有节点的hosts(DNS服务)内容,看看他们关于集群节点的配置信息是否一模一样就可以了。

能看到这里并仔细思考过的读者们,我相信你一定已经扫清了关于FQDN的障碍了。而且,因为一些特定场景下出现的FQDN问题会结合着TDengine的典型的产品特性,所以借助这个问题你可以更加深入地理解TDengine的体系架构,为自己未来的使用做好更多的铺垫。

后偷偷告诉大家,未来TDengine会在错误提示方面做出更多优化——以FQDN为例,将会告诉大家是从哪个节点到哪个节点 "unable to resolve FQDN",这样我们在遇到相关问题后,处理起来就会更加得心应手了。

来源 https://zhuanlan.zhihu.com/p/394254303

相关文章