fail to parse configuaration file, check the file name or the content of config file.

该错误是配置文件“checkNodes.Config”格式错误，需要重新从配置规划工具中导出配置文件“checkNodes.Config”。

the ip of host XX is empty.

该错误是配置文件“checkNodes.Config”中没有配置XX的IP地址，需要在配置规划工具中更新后再导出配置文件。

cannot transfer the operation scripts to host XX.

该错误是无法向节点XX传送文件，请检查节点XX的是否可以连接，防火墙配置是否正确，密码是否正确。

the XX path value is empty.

该错误是配置文件“checkNodes.Config”中存在空路径，需要重新从配置规划工具中导出配置文件“checkNodes.Config”。

the partition size format of path XX is not correct, it should be integer or float number.

该错误是分区大小配置错误，请更正“checkNodes.Config”文件，或者重新从配置规划工具中导出配置文件“checkNodes.Config”。

the host name in config file is empty.

该错误是配置文件“checkNodes.Config”中没有配置主机名，请更正“checkNodes.Config”文件，或者重新从配置规划工具中导出配置文件“checkNodes.Config”。

check ntp server failed

该错误是NTP同步时间失败引起的，请按照以下方法处理。

• 检查Manager安装配置文件（配置规划工具生成的ini文件）中“ntp_server_ip”配置的NTP服务器IP地址与集群中节点IP地址是否相同（包括集群中所管理IP、业务IP、浮动IP）。
• 在当前节点执行ping ntp_server_ip命令，检查网络是否连通。
• 在当前节点执行以下命令，手动同步时间。

  sntp -S ${ntp_server_ip}

  说明：

  • 不同操作系统及不同NTP服务器版本下执行的命令不同，该操作命令以SUSE操作系统下4.2.8及以上版本NTP服务器为例。
  • 如果是RedHat、CentOS操作系统，请先检查ntp服务是否启动，如果已启动请手动停止ntp服务后再进行检查。

hostname 'XX' format error, correct format is '^[a-zA-Z0-9]([-a-zA-Z0-9]*[a-zA-Z0-9])*\$'.

该错误是节点上主机名格式错误，请在相应的节点上修改主机名。

the hostname XX in YY does not match ZZ

该错误是节点上使用hostname命令获取的主机名和系统配置文件的主机名不一致，请在相应的节点将其修改一致。

• 执行以下命令修改主机名，使节点主机名与规划的主机名保持一致：

  hostname 主机名

  例如，将主机名改为“Bigdata-OM-01”，请执行命令hostname Bigdata-OM-01。

• 修改主机名配置文件。
  • RedHat 6.x、CentOS 6.x下，执行vi /etc/sysconfig/network命令编辑文件，修改“HOSTNAME”值为“Bigdata-OM-01”，并保存退出。
  • RedHat 7.x、CentOS 7.x下，执行vi /etc/hostname命令编辑文件，修改文件内容为“Bigdata-OM-01”，并保存退出。
  • SUSE下，执行vi /etc/HOSTNAME命令编辑文件，修改文件内容为“Bigdata-OM-01”，并保存退出。

• The '/etc/hosts' file is configured incorrectly.
• '127.0.0.1 localhost' is not configured in '/etc/hosts'.
• 'xxip1 hostname1' is mistakenly configured as 'xxip2 hostname2' in '/etc/hosts'.

该错误是当前节点的/etc/hosts文件配置错误，需要按照如下要求配置：

• 必须配置127.0.0.1 localhost映射
• 每个主机名只能对应一条IP信息（业务平面）
• 每个IP信息只能对应一条主机名
• 必须有一条本机的主机名对应的IP信息
• 主机名和IP对应关系和《配置规划工具》中保持一致

如下例：

127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4 
  ::1         localhost localhost.localdomain localhost6 localhost6.localdomain6 

192.168.20.10 Bigdata-OM-01

user 'omm' already exist, please remove user first.

节点上已经存在omm用户，需要使用userdel手工删除该用户，否则集群安装会失败。

user id '2000' already exist, please remove user first.

已经存在用户id为2000的用户，需要使用userdel手工删除该用户，否则集群安装会失败。

the cpu cores number 'XX' does not match the config file YY.

节点上CPU核数和配置文件不一致，请检查节点CPU是否正确。

the cpu cores number XX format is not correct, it should be integer.

配置文件中CPU核数配置格式错误，请更正“checkNodes.Config”文件，或者重新从配置规划工具中导出配置文件“checkNodes.Config”。

real memory size XX does not match the config file XX.

节点实际内存和配置文件不一致。以下两种处理办法：

• 请检查节点内存大小，并更正“checkNodes.Config”文件，或者修改配置规划工具中的相关配置项，重新导出配置文件“checkNodes.Config”。
• 扩大节点内存，使实际内存大于配置文件中内存。

the memory size XX format is not correct, it should be integer or float number.

配置文件中内存配置格式错误，请更正“checkNodes.Config”文件，或者重新从配置规划工具中导出配置文件“checkNodes.Config”。

timezone check failed, current timezone is 'XX', configured timezone is 'YY'.

时区配置错误，请修改节点上时区配置。

• 执行以下命令修改时区（以北京时区为例）：
  • RedHat、CentOS下，执行ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
  • SUSE下，执行ln -sf /usr/share/zoneinfo/Asia/Beijing /etc/localtime
• #hwclock -w

real diskSize XX does not match the config file YY.

磁盘大小配置和配置文件中不一致。以下两种处理办法：

• 请检查磁盘大小，并更正“checkNodes.Config”文件，或者修改配置规划工具中的相关配置项，重新导出配置文件“checkNodes.Config”。
• 重新调整磁盘分区，使磁盘实际分区容量大于配置文件中磁盘容量。

the disk size XX format is not correct, it should be integer or float number.

配置文件中磁盘配置格式错误，请更正“checkNodes.Config”文件，或者重新从配置规划工具中导出配置文件“checkNodes.Config”。

partition XX is not mounted by uuid or by-id.

分区挂载方式不是UUID或by-id，请重新进行分区，并以UUID或by-id方式挂载。

partition 'XX' size '$partitionSize'(G) does not match the configured size 'YY'(G).

分区大小和配置文件中不一致，请重新进行分区后，再进行检查。

The OS version is not supported. Currently support XX

该错误是当前节点的操作系统版本不被支持，需要更换节点或者重新安装本软件支持的操作系统版本。

The Linux kernel version XX is not supported.

该错误是当前SUSE节点的linux内核版本号（3.0.101-0.40-default）不被支持，需要更换节点或者重新安装本软件支持的操作系统内核版本。

Stop other checks on host XX and restore os/kernel first.

该错误是指由于当前节点的os或kernel检查未通过，导致对该节点的其他检查停止。需要首先修复上述问题，再重新使用precheck进行检查。

SSH is not installed.

该错误是当前节点的ssh不可用，需要重新安装ssh。可以使用preinstall工具修复此问题。

Python is not installed.

该错误是当前节点的python不可用，需要重新安装python。可以使用preinstall工具修复此问题。

The python version is not supported, cur:XX, min:YY, max:ZZ.

该错误是当前节点的python版本号不支持，需要修改python版本。python版本号最低等于2.6.5， 最高不能超过2.7.0。

Failed to obtain the rpm package.

该错误是获取当前节点缺失的rpm包列表失败，可能的原因是操作系统原因，如节点磁盘空间满导致无法写入文件等。

Need to install : xx

该错误是当前节点缺失某些必须的rpm包，需要补齐这些rpm包。可以使用preinstall工具修复此问题。

Failed to find the expect command.

该错误是当前节点不能使用expect工具，需要安装相应的rpm包。可以使用preinstall工具修复此问题。

The host name cannot contain only digits.

该错误是节点上配置的主机名格式不正确，主机名不能全为数字。需要修改主机名。

'/etc/ntp.conf' is empty / dose not exist.

该错误是当前节点上“/etc/ntp.conf”文件不存在或者内容为空，请检查该文件的正确性。

Insufficient disk space in partition XX.

该错误是当前节点的XX分区磁盘剩余容量小于该分区总容量的20%，请清理分区空间，以保证分区剩余空间充足。

ipmitool command check failed. Please perform the preinstall operation.

该错误是当前节点ipmitool命令检查失败，可以使用preinstall工具修复此问题。

iostat command check failed. Please perform the preinstall operation.

该错误是当前节点iostat命令检查失败，可以使用preinstall工具修复此问题。

• Need to install nss-softokn.x86_64 rpm package. Required version is xxx or later.
• Need to install nss-util.x86_64 rpm package. Required version is xxx or later.
• Need to upgrade nss-softokn.x86_64 version to xxx or later.
• Need to upgrade nss-util.x86_64 version to xxx or later.

• 该错误是当前节点缺失nss-softokn的rpm包，需要补齐该rpm包，且必须为3.14.3-22或以上版本。
• 该错误是当前节点缺失nss-util的rpm包，需要补齐该rpm包，且必须为3.16.2.3-2或以上版本。
• 该错误是当前节点的nss-softokn版本过低，需要升级。nss-softokn版本号最低等于3.14.3-22。具体升级方法，请联系操作系统服务供应商。
• 该错误是当前节点的nss-util版本过低，需要升级。nss-util版本号最低等于3.16.2.3-2。具体升级方法，请联系操作系统服务供应商。

'Defaults requiretty' is configured incorrectly in '/etc/sudoers' the file.

该错误是当前节点的“/etc/sudoers”文件中“Defaults requiretty”配置错误。

可使用vi /etc/sudoers命令编辑“/etc/sudoers”文件。删除“Defaults requiretty”选项。

The '/etc/cron.allow' or '/etc/cron.deny' file is configured incorrectly. User omm does not have the rights to use crontab.

该错误是当前节点的“/etc/cron.allow”或“/etc/cron.deny”文件配置错误，使omm用户没有“crontab”的运行权限。当两个文件均不存在时，只能使用root用户操作，请参考以下规则增加omm用户权限：

• 若只存在“/etc/cron.allow”文件，请将omm用户写入“/etc/cron.allow”文件；
• 若只存在“/etc/cron.deny”文件，请将omm用户从“/etc/cron.deny”文件中删除；
• 若“/etc/cron.allow”和“/etc/cron.deny”文件均存在，请将omm用户写入“/etc/cron.allow”文件。

The 'zone_reclaim_mode' is configured incorrectly.

该错误表示当前节点“zone_reclaim_mode”参数配置错误，可采用如下方法进行处理：

• 以root用户登录节点，执行以下命令：

  echo 0 > /proc/sys/vm/zone_reclaim_mode

• 执行vi /etc/sysctl.conf命令，按“Insert”编辑文件，在配置文件中增加配置行“vm.zone_reclaim_mode=0”，按“Esc”退出编辑，执行:wq保存退出。

The NTP version(${ntp_version}) has defects, which may cause an OMS installation failure.

通过操作系统补丁更新OS NTP版本，使之满足FusionInsight系统要求。具体版本请参考准备操作系统。

The NTP version(${ntp_version}) has defects, which may cause a time synchronization failure between the active OMS and other nodes. Install the system patch to upgrade the system version.

The /usr/sbin/slapd configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该检查只针对安装Redhat操作系统的节点，执行以下命令，确认问题节点上是否正确安装ldap服务端rpm包。

rpm -qa |grep openldap | grep server

• 如果查询不到结果，则表示未安装，可以使用preinstall工具进行修复。
• 如果可以查到结果，则安装异常，可以卸载后，重新安装对应rpm包。

The /etc/rsyslog.conf configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该检查只针对安装Redhat操作系统的节点，执行以下命令，确认问题节点上是否正确安装rsyslog。

rpm -qa |grep rsyslog

• 如果查询不到结果，则表示未安装，可以使用preinstall工具进行修复。
• 如果可以查到结果，则文件可能被误删，可以从其他相同版本操作系统的节点拷贝对应文件到“/etc”目录下。

The /sbin/rsyslogd configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该检查只针对安装Redhat操作系统的节点，执行以下命令，确认问题节点上是否正确安装rsyslog。

rpm -qa |grep rsyslog

• 如果查询不到结果，则表示未安装，可以使用preinstall工具进行修复。
• 如果可以查到结果，则安装异常，可以卸载后，重新安装对应rpm包。

The /usr/lib/openldap/slapd configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该检查只针对安装SUSE操作系统的节点，执行以下命令，确认问题节点上是否正确安装ldap服务端rpm包。

rpm -qa | grep openldap | grep -v client

• 如果查询不到结果，则表示未安装，可以使用preinstall工具进行修复。
• 如果可以查到结果，则安装异常，可以卸载后，重装对应rpm包。

The /etc/nscd.conf configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该检查只针对安装SUSE操作系统的节点，执行以下命令，确认问题节点上是否正确安装nscd。

rpm -qa | grep nscd

• 如果查询不到结果，则表示未安装，可以使用preinstall工具进行修复。
• 如果可以查到结果，则文件可能被误删，可以从其他相同版本操作系统的节点中拷贝对应文件到“/etc”目录下。

The /usr/sbin/nscd configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该检查只针对安装SUSE操作系统的节点，执行以下命令，确认问题节点上是否正确安装ldap。

rpm -qa | grep nscd

• 如果查询不到结果，则表示未安装，可以使用preinstall工具进行修复。
• 如果可以查到结果，则安装异常，可以卸载后，重装对应rpm包。

The configuration item pam_unix2_key cannot be found in /etc/pam.d/common-session.

Please update /etc/pam.d/common-session and ensure that the configuration item is correct.

该检查只针对安装SUSE操作系统的节点，该警告表示该节点上的PAM配置文件“common-session”中未配置“pam_unix2_key”配置项，请更新“common-session”配置，增加“pam_unix2_key”配置项。

执行vi /etc/pam.d/common-session命令，按“Insert”编辑文件，在配置文件中增加配置行“session required pam_unix2.so”，按“Esc”退出编辑，执行:wq保存退出。

以下为配置示例：

... 
session  optional   pam_mkhomedir.so 
session required        pam_limits.so 
session required        pam_unix2.so
session optional    pam_ldap.so 
session optional        pam_umask.so

The configuration item pam_limits_key cannot be found in /etc/pam.d/common-session.

Please update /etc/pam.d/common-session and ensure that the configuration item is correct.

该检查只针对安装SUSE操作系统的节点，该警告表示该节点上的PAM配置文件“common-session”中未配置“pam_limits_key”配置项，请更新“common-session”配置，增加“pam_limits_key”配置项。

执行vi /etc/pam.d/common-session命令，按“Insert”编辑文件，在配置文件中增加配置行“session required pam_limits.so”，按“Esc”退出编辑，执行:wq保存退出。

以下为配置示例：

... 
session  optional   pam_mkhomedir.so 
session required        pam_limits.so
session required        pam_unix2.so 
session optional    pam_ldap.so 
session optional        pam_umask.so

The configuration item pam_unix2_key cannot be found in /etc/pam.d/common-password.

Please update /etc/pam.d/common-password and ensure that the configuration item is correct.

该检查只针对安装SUSE操作系统的节点，该警告表示该节点上的PAM配置文件“common-password”中未配置“pam_unix2_key”配置项，请更新“common-password”配置，增加“pam_unix2_key”配置项。

执行vi /etc/pam.d/common-password命令，按“Insert”编辑文件，在配置文件中增加配置行“password sufficient pam_unix2.so use_authtok nullok”，按“Esc”退出编辑，执行:wq保存退出。

以下为配置示例：

... 
password    sufficient  pam_unix2.so  use_authtok nullok
password    required    pam_ldap.so try_first_pass use_authtok

password requisite pam_cracklib.so dcredit=0 lcredit=0 ucredit=0 ocredit=0 minlen=8 minclass=3
password required pam_unix.so md5 shadow remember=5 use_authtok 

The configuration item pam_unix2_key cannot be found in /etc/pam.d/common-auth.

Please update /etc/pam.d/common-auth and ensure that the configuration item is correct.

该检查只针对安装SUSE操作系统的节点，该警告表示该节点上的PAM配置文件“common-auth”中未配置“pam_unix2_key”配置项，请更新“common-auth”配置，增加“pam_unix2_key”配置项。

执行vi /etc/pam.d/common-auth命令，按“Insert”编辑文件，在配置文件中增加配置行“auth sufficient pam_unix2.so”，按“Esc”退出编辑，执行:wq保存退出。

以下为配置示例：

... 
auth    required        pam_env.so 
auth    sufficient      pam_unix2.so
auth    required      pam_ldap.so use_first_pass

The configuration item pam_unix2_key cannot be found in /etc/pam.d/common-account.

Please update /etc/pam.d/common-account and ensure that the configuration item is correct.

该检查只针对安装SUSE操作系统的节点，该警告表示该节点上的PAM配置文件“common-account”中未配置“pam_unix2_key”配置项，请更新“common-account”配置，增加“pam_unix2_key”配置项。

执行vi /etc/pam.d/common-account命令，按“Insert”编辑文件，在配置文件中增加配置行“account required pam_unix2.so”，按“Esc”退出编辑，执行:wq保存退出。

以下为配置示例：

... 
account required        pam_unix2.so
account sufficient  pam_localuser.so 
account required    pam_ldap.so use_first_pass

The /etc/sysctl.conf configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该警告表示系统中缺失sysctl.conf文件，请从其他相同版本操作系统的节点中拷贝该文件到“/etc”目录下。

The /sbin/sysctl configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该警告表示sysctl命令不存在，可能是操作系统被损坏导致，请重新安装操作系统。

Failed to restart the sysctl service.

Please check whether any invalid configuration item exists in /etc/sysctl.conf.

确认问题节点上sysctl.conf是否存在无效的配置项，可以使用root用户登录问题节点，执行/sbin/sysctl -p命令来查看错误提示，进而进行修复。

The /usr/bin/openssl configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该警告表示openssl命令不存在，执行以下命令，确认问题节点上是否正确安装openssl。

rpm -qa | grep openssl

• 如果查询不到结果，则表示未安装，可以使用preinstall工具进行修复。
• 如果可以查到结果，则安装异常，可以卸载后，重新安装对应rpm包。

The openssl version is weakly secure, it cannot support TLSv1.1, TLSv1.2.

Upgrading openssl to version: 1.0.1 or higher is recommended strongly.

Proceeding with the installation indicates that you accepted the security risks.

升级系统openssl版本。

The /etc/openldap/ldap.conf configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该警告表示系统中缺失“ldap.conf”文件。请从其他相同版本操作系统的节点中拷贝该文件到“/etc/openldap”目录下。

The /usr/bin/ldapsearch configuration file cannot be found.

Please restore the file and ensure that the file is correct.

该警告表示节点上不存在ldapsearch命令，执行以下命令，确认问题节点上是否安装ldap客户端的rpm包。

rpm -qa | grep openldap | grep client

• 如果查询不到结果，则表示未安装，可以使用preinstall工具进行修复。
• 如果可以查到结果，则安装异常，可以卸载后，重装对应rpm包。

The NTP service is not available.

该警告表示当前节点NTP服务不可用，请检查NTP服务是否安装或开启，如未安装可以使用preinstall工具修复，如未开启请开启NTP服务。

OMS install file does not exist, so ntp server will not be verified.

该警告表示当前节点不存在Manager安装配置文件（配置规划工具生成的ini文件），无法验证ntp server。请按照以下方法处理。

• 在Manager安装配置文件所在目录，例如“/opt/FusionInsight_SetupTool/install_oms”，查看配置规划工具生成的“HostIP.ini”文件是否存在。

  是，执行3。

  否，执行2。

• 请参考生成配置文件利用配置规划工具自动上传或手动将Manager安装配置文件上传到对应目录下。
• 进入脚本工具所在目录，重新执行precheck任务，例如：

  cd /opt/FusionInsight_SetupTool

  ./setuptool.sh precheck precheck/checkNodes.Config -i install_oms/192.168.1.1.ini

The swap partition is enabled

该警告是节点swap分区处于打开状态，会影响集群性能。请关闭swap分区。

• 执行以下命令，查询当前系统中的Swap分区。

  swapon -s

• 执行以下命令，关闭查询到的Swap分区。

  swapoff swap分区

  例如：

  swapoff /dev/dm-1

• 打开配置文件“/etc/fstab”，找到对应的信息，并把相关信息注释掉，如下：

  #/dev/mapper/vg_r160-lv_swap swap swap nosuid 0 0

the partition 'XX' does not exist.

分区不存在，请先创建分区，或更正“checkNodes.Config”文件。

The available space of the '/var/log' partition is xxx (GB), which is smaller than the size 130 (GB) of logs to be retained for seven days

该警告是当前节点的“/var/log”分区容量小，不能满足存储7天日志的要求。

可增加日志磁盘容量，使可用容量大于130GB。

receive-hashing feature is off. If you install Redis at this node, please run 'ethtool -K eth1 rxhash on' to enable.

执行以下命令，打开网卡的receive-hashing功能(假定业务IP配置在网卡eth1)：

ethtool -K eth1 rxhash on

执行结果若提示"Cannot set device flag settings: Operation not supported"，则表示网卡不支持receive-hashing功能，可忽略该WARNING。

GLIBCXX_3.4.11 was not found, this would cause Impala service unvailable, if you select to install impala components in cluster installation

执行以下命令，查询当前系统中是否有GLIBC3.4.11。

strings /usr/lib64/libstdc++.so.6 | grep GLIBC | grep GLIBCXX_3.4.11

如果没有输出，则说明GLIBC版本不满足，需要安装或升级gcc为4.4.7及以上版本。

timezone is not configured, skip check.

时区未配置，执行date命令检查时间设置。

• 执行以下命令修改时区（以北京时区为例）：
  • RedHat、CentOS下，执行ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
  • SUSE下，执行ln -sf /usr/share/zoneinfo/Asia/Beijing /etc/localtime
• #hwclock -w

partition XX size is not configured, skip check

XX分区的大小未配置；更正“checkNodes.Config”文件。

The available space of the /var/log partition is XX (GB). You are advised to allocate a partition with at least 130(GB) for the log directory

日志目录所在分区可用空间小于130G，重新进行分区后，再进行检查。

Nic XX is not configured, speed is Unknown

网卡XX带宽未配置；配置网卡带宽（以eth1为例）。

执行以下命令，修改网卡eth1配置文件.

vi /etc/sysconfig/network-scripts/ifcfg-eth1

Nic XX invalid config, speed is ${speed}

网卡XX带宽配置有误；修改网卡带宽配置。

Nic '${nic}' speed configured '${result}Mb/s', speed is not enough

网卡XX带宽配置低于建议值100Mb/s；修改网卡带宽配置。

If nameserver is configured improperly, the network speed is slowed down, which affects the subsequent installation or operations. Check whether the item is correctly configured.

“/etc/resolv.conf”文件中配置了DNS，如果该DNS配置有误，可能会导致安装过程中下载包慢等问题；检查“/etc/resolv.conf”文件中DNS配置的正确性。

The kernel total amount of shared memory pages is too small. The recommended minimum value is ${shmall_suggest}.

该警告表示可用共享内存的总数量小于推荐值。需修改kernel.shmall值（单位：page），其值乘以PAGESIZE 必须大于物理内存的一半。

执行以下命令，编辑sysctl.conf文件，修改“kernel.shmall”值。

vi /etc/sysctl.conf

kernel.shmall=1048576 

The kernel shared memory is too small. The recommended minimum value is XX.

该警告是节点上配置的kernel共享内存值小于建议的物理内存的一半，需要修改kernel.shmmax的值。

SHMMAX为最大共享内存段尺寸（单位：字节），建议取值为物理内存大小的一半。SHMALL为可用共享内存的总数量（单位：page），取值与SHMMAX相同（换算成相同单位）。

执行以下命令打开“sysctl.conf”文件：

vi /etc/sysctl.conf

按“Insert”键开始编辑，修改以下参数（假设该节点物理内存为8GB）：

kernel.shmmax=4294967296 
kernel.shmall=1048576