YashanDB 部署报错：YAS-05721 节点名非法怎么办?

【报错信息】

YAS-05721: invalid input parameter, reason: node name invalid

【触发时机】

执行共享集群部署的 deploy 阶段时，系统检查节点名，发现当前机器 hostname 不符合规范，从而中止部署。

【问题原因】

YashanDB 默认将操作系统 hostname 作为节点名使用。但如果该名称不合法，例如只包含数字、过短或包含非法字符，就会导致部署失败。

【节点名合法性要求】

必须以字母开头;

仅支持字母、数字、下划线;

长度要求：单节点为 464 个字符，多实例部署为 363;

不能与其他节点名重复。

【解决方案】

方法一：部署时忽略当前 hostname

在执行 yasboot deploy 命令时，添加参数：

--ignore-hostname
系统将自动生成一个符合规范的节点名。

方法二：修改操作系统 hostname

①　修改 hostname：

hostnamectl set-hostname yashan_node01
②　登出并重新登录终端;

③　重新执行部署流程。

【建议总结】

优先推荐使用 --ignore-hostname 参数，部署更省事;

若有统一运维命名规范，也可直接修改系统 hostname;

多节点部署中应提前检查所有主机 hostname 合规性，避免冲突。