cluster子命令

命令功能

远端采集集群并回传报告。

• 若采集的服务器数量过多，可能导致带宽使用率升高。
• 要求工具所在服务器和待采集服务器均支持SSH连接。

命令格式

1

./kspect cluster [-h] -i INPUT [--diff_base DIFF_BASE]

参数说明

使用示例

1. 解压并进入工具目录。

   1 2	tar -zxvf /home/devkit-kspect-x.x.x-Linux-aarch64.tar.gz cd /home/devkit-kspect-x.x.x-Linux-aarch64

   

   • 使用示例时请将“/home/devkit-kspect-x.x.x-Linux-aarch64”替换为工具实际所在路径。
   • 为确保SSH连接稳定，建议在执行采集前，确认本机（运行kspect的主机）的SSH客户端配置兼容。若您的系统为较新的Linux发行版（如RHEL/CentOS 8/9、Ubuntu 22.04以上），可能存在配置冲突导致采集失败。详情请参见采集报错“Match all无其他混合条件”的解决方法进行处理。
2. 使用Excel编辑“/home/devkit-kspect-x.x.x-Linux-aarch64/documents”目录下的server_config.xlsx服务器配置模板文件，如图1所示。
   图1 server_config.xlsx模板
   

   表2 服务器配置文件Excel参数

   参数	参数说明
   服务器别名	可选参数，待采集服务器别名。
   IP地址	必选参数，待采集服务器的IP地址。
   端口	可选参数，待采集服务器的端口号，缺省时默认为22。
   用户名	必选参数，待采集服务器的操作系统用户。
   认证方式	必选参数，登录服务器的方式，可选： password：密码方式，需填写“密码”参数。 private_key：私钥方式，需填写“私钥路径”和“私钥密码”参数（可选）。
   密码	可选参数，对应用户的密码，仅在认证方式选择为password时必填。
   私钥路径	可选参数，仅在认证方式选择为private_key私钥方式时必填。
   私钥密码	可选参数，仅在认证方式选择为private_key私钥方式且私钥文件有密码时必填，无密码时选填。
   BMC采集方式	可选参数，采集BMC的方式： password：使用BMC账号密码登录，需填写BMC IP、BMC用户名、BMC密码。 In-band：需远程节点支持带内采集，否则会自动跳过。 缺省：不采集BMC。
   BMC IP	可选参数，BMC的IP地址，仅在BMC采集方式选择为password时必填。
   BMC用户名	可选参数，BMC的用户名，仅在BMC采集方式选择为password时必填。
   BMC密码	可选参数，BMC的密码，仅在BMC采集方式选择为password时必填。

3. 进行服务器集群采集。

   1	./kspect cluster -i /home/server_config.xlsx

   

   • 使用示例时请将“/home/server_config.xlsx”替换为Excel文件实际存放路径，支持绝对路径或相对路径。
   • 若出现服务器集群采集失败的情况，请参见高并发采集时部分连接失败的解决方法进行处理。

   返回信息如下：

   采集结束后，是否清理服务器配置文件中的密码信息？(Y/N) [默认: N]: n
   以下服务器开始采集数据：xxx.xxx.xxx.xxx:22(server_3)
   
   xxx.xxx.xxx.xxx:22(server_3)采集成功。
   归档文件/home/devkit-kspect-x.x.x-Linux-aarch64/output/kspect-report-xxxxxxxx-xxxxxx-xxx.xxx.xxx.xxx-22.tar.gz已成功生成。
   
   采集完成: 成功 1/1 个服务器。
   [WARNING] 服务器配置文件 /home/devkit-kspect-x.x.x-Linux-aarch64/documents/server_config.xlsx 中包含明文密码，请务必妥善保管或在使用后及时清理。