VirtualBox安装Vertica时主机名解析多IP致安装失败排查

问题场景 #

• 运行环境：Virtual Box 虚拟机，安装配置2块网卡的Linux Mint系统
• 触发操作：执行以下命令部署Vertica数据库：

echo "NETWORKING=yes" >> /etc/sysconfig/network
export SHORT_HOSTNAME=$(hostname -s)
expect install_image/vertica.expect

• 返回报错信息：

Mapping hostnames in --hosts (-s) to addresses...
    hplaptop resolved to multiple (2) addresses: (IPv4...) 10.0.2.15, 192.11.12.102 (IPv6...) <none>
    Error: Unable to resolve 'hplaptop'
Installation FAILED with errors.

报错根因：主机名hplaptop同时映射到两块网卡对应的2个IPv4地址，Vertica安装阶段的主机名校验逻辑要求单主机名必须对应唯一通信IP，多IP映射会直接中断解析流程导致安装失败。

可落地解决方案 #

• 方案1：修正hosts文件固定唯一IP映射
  编辑/etc/hosts配置文件，删除所有hplaptop对应的多余映射，仅保留Vertica集群通信使用的静态IP（推荐绑定Host-Only网卡的固定IP 192.11.12.102，不要绑定NAT网卡动态分配的10.0.2.15），配置参考：

  127.0.0.1   localhost
  192.11.12.102   hplaptop
  

  配置完成后执行ping $(hostname -s)校验，确认返回结果只有绑定的单个IP即可重新执行安装命令。
• 方案2：安装时显式指定通信IP跳过自动解析
  执行安装脚本时直接传入指定IP参数，绕过自动主机名解析逻辑，命令参考：

  expect install_image/vertica.expect --hosts 192.11.12.102
  

• 方案3：安装阶段临时禁用非必要网卡
  安装执行前先通过ip link set <NAT网卡名> down命令关停NAT模式对应的10.0.2.15网卡，仅保留业务通信网卡，等安装流程全部完成后再重新启用关停的网卡即可。

注意：Vertica集群节点的主机名必须长期绑定固定静态IP，禁止配置多IP映射或使用动态分配IP，否则后续集群节点间通信也会出现异常。

内容的提问来源于stack exchange，提问作者Alexei