该文档描述了云迁移中心CMH的IDC采集功能的使用过程，通过这篇文档，将带您使用我们的工具idc-scanner，并且一步步完成IDC资源采集。

准备工作

重要

目前被调研机器仅支持类Unix 系统

运行环境准备

服务器选择

IDC资源采集工具（简称idc-scanner ）需要安装和运行在工具服务器上，工具服务器与其他被采集服务器需要 SSH 互通，最佳的工具服务器应该是传统运维系统中的跳板机。

规格系统

此外工具服务器需要至少 2C4G 的机器规格，操作系统要求为主流 Linux 发行版（CentOS 7最佳）。

软件依赖

如果您的工具服务器通过SSH 登录被采集服务器不是通过互信，而是需要输入密码，在运行idc-scanner 时需要额外安装 sshpass 包。

说明

sshpass 安装包建议使用yum 源下载，或者互联网下载。

yum安装

如果您的工具服务器上有配置yum，您可以使用 yum 安装：yum install sshpass

手工安装

如果您希望源码安装，您可以在官网下载sshpass发行版。下载后可以使用如下手工安装命令进行安装：

tar -zxvf sshpass-1.06.tar.gz
cd sshpass-1.06
./configure
make
make install

访问用户准备

idc-scanner 的物理机采集功能，仅需要在每一台被调研服务器上有一个登录用户即可，不需要对于某些文件进行额外授权。

安装文件下载

请选择合适的执行文件，下载后上传至跳板机，并解压。

解压命令：tar -zxvf idc-scanner.tar.gz

参数文件准备

在执行工具前，您需要事先准备好被采集服务器的IP列表，以及登录他们的用户名，密码，SSH联通端口。用如下格式写在工作目录下的list 文本文件中。

格式：

username1:password1:ip1:ssh_port
username2:password2:ip2:ssh_port
...

例如：

>> cat list
userA:XXXX:39.105.XXX.23:22
userA:XXXX:123.56.XXX.29:22
userA:XXXX:47.94.XXX.252:22

如果您的idc-scanner 安装环境与需要被采集的机器已经打通SSH 互信，可以不再填写密码，例如：

>> cat list
userA::39.105.XXX.23:9922
userA::123.56.XXX.29:9922
userA::47.94.XXX.252:9922

运行目录准备

您需要准备如下运行目录，output 目录用于保存输出文件，export 目录用于保存导出的原始机器信息数据。

|-idc-scanner/
             |-idc-scanner
             |-list
             |-output/
             |-export/
             

工具执行

在确认完环境和安装后，您可以执行idc-scanner 来进行idc资源采集。执行命令和运行结果如下：

您可以通过 -p 参数来设置性能与网络状态监控的总时长，通过 -i 来设置采集间隔，单位为秒。

#启动命令一：普通账号密码登录模式
./idc-scanner
#启动命令二：如果您已经打通了机器之间的ssh互信
./idc-scanner --sshkey
#启动命令三：设置状态监控采集总时长和采集间隔
./idc-scanner -p 3600 -i 30

#可选参数定义
# optional arguments:
#   -s, --sshkey       Use SSHKEY
#   -p, --period       Monitor period, range [60, 36000], default 600
#   -i, --interval     Monitor interval, range [30, 60], default 30

#控制台输出
Scanning and exporting ...
thread0 begin to export from39.xx.xx.23
thread1 begin to export from39.xx.xx.23
thread2 begin to export from39.xx.xx.23
...
thread9 begin to export from123.xx.xx.29
thread7 begin to export from123.xx.xx.29
thread8 begin to export from123.xx.xx.29
...
thread7 begin to export from47.xx.xx.252
thread1 begin to export from47.xx.xx.252
...
Scanning finished!
Parser finish machine:39.xx.xx.23
...
Start monitor ... period: 3600s, interval: 30s
monitoring... single round time 8.761 s, 1 / 121
monitoring... single round time 8.824 s, 2 / 121
...
monitoring... single round time 9.306 s, 120 / 121
monitoring... single round time 9.299 s, 121 / 121
Main finish and build output : output.tar.gz
Main finish and build export : export.tar.gz

本地分析

在您运行完成idc-scanner之后，您将在output 目录下得到如下文件。

topo.html           #网络拓扑 
index.html          #调研首页 
iconfont.css        #样式文件
iconfont.ttf        #样式文件    
10.xx.xx.106.html   #调研详情页         
10.xx.xx.139.html   #调研详情页         
10.xx.xx.101.html   #调研详情页         
10.xx.xx.108.html   #调研详情页         
machines.json       #序列化文件（待上传）    

您可以打开html 文件进行本地数据查看和分析。

上传分析

在确认本地数据无误后，您可以将对应的序列化文件上传到云迁移中心（CMH）的控制台中。

路径：控制台->评估->资源调研->离线采集->IDC采集->上传（传送门）

在完成导入后您可以在平台上查看导入任务，点击任ID务后可以在线查看导入的资源详情。确认无误后可以点击“资源确认”将资源导入到CMH的资源列表中。