G.3 适用于 Linux 的 Migrate 代理实用程序

在安装或使用 Migrate 代理之前，请确保您的系统符合Migrate 代理实用程序的要求。

G.3.1 在源 Linux 工作负载上下载并安装 Migrate 代理

在安装适用于 Linux 的 Migrate 代理实用程序之前，请确保源计算机已安装 GNU C Library (glibc) 2.11.3 或更高版本。

请务必下载适合源 Linux 计算机体系结构的应用程序。文件名区分大小写。

64 位： MigrateAgent-x86_64.tar.gz
32 位： MigrateAgent-x86.tar.gz

要在源工作负载中下载并安装适用于 Linux 的 Migrate 代理实用程序，请执行以下操作：

以 root 用户身份登录源 Linux 工作负载。
使用以下方法之一获取 MigrateAgent-arch.tar.gz 文件。

请将 arch 替换为合适的体系结构（x86_64 或 x86）。
- 从 Web 界面下载压缩文件：
  1. 在 Web 浏览器中，起动 PlateSpin Migrate Web 界面并登录。
    
    https://<Your_PlateSpin_Server >/Migrate
    
    请将 Your_PlateSpin_Server 替换为您 PlateSpin Migrate 服务器的 DNS 名称或 IP 地址。
  2. 单击下载选项卡。
  3. 单击相应 Linux 平台（x86_64 或 x86）的 Migrate 代理应用程序链接，然后保存 MigrateAgent-arch.tar.gz 文件。
  -或-
- 使用 wget 命令从 PlateSpin 服务器复制该文件。
  
  注：如果 PlateSpin 服务器主机上的操作系统仅接受 TLS 1.2 连接，请在源 Linux 工作负载上使用 wget 1.16.1 或更高版本。
  1. 起动终端，然后输入
    wget --no-check-certificate --http-user=<username> --http-password=<password> https://<Your_PlateSpin_Server>/Migrate/Downloads/MigrateAgent-<arch>.tar.gpz
    
    请将 Your_PlateSpin_Server 替换为您 PlateSpin Migrate 服务器的 DNS 名称或 IP 地址。请将 arch 替换为 x86_64 或 x86。
在存档管理器中打开 MigrateAgent-arch.tar.gz 文件，然后将 MigrateAgent 目录及其内容提取到根目录 (/)。

或者，在外壳提示符中输入
```
tar xvf MigrateAgent-<arch>.tar.gz
```
请将 arch 替换为 x86_64 或 x86。
将目录切换到 /MigrateAgent 目录，然后列出其内容。在终端中输入：
```
cd MigrateAgent
ls
```
该目录包含 commands 文件和 MigrateAgent 脚本文件。
输入以下命令查看命令帮助：
```
./MigrateAgent -h
```

G.3.2 适用于 Linux 的 Migrate 代理命令

运行 Migrate 代理实用程序所用的语法为：

./MigrateAgent [Command] [-h]

表 G-2 描述了 Linux 上 MigrateAgent.cli.exe 命令可用的选项和自变量。

表 G-2 适用于 Linux 的 Migrate 代理实用程序的命令选项和自变量

用法	描述
命令
register <服务器> <用户> [[-p 口令] \| [-pf <口令文件路径>]] 对于服务器，请指定 PlateSpin Migrate 服务器的 DNS 名称或 IP 地址。对于用户，请指定有权添加工作负载的管理员级用户的有效 PlateSpin 服务器用户名。对于口令，请执行以下其中一种操作：使用 -p 选项，并在命令中键入指定 PlateSpin 用户名的口令。 -p mypassword 使用 -pf 选项指定包含所指定 PlateSpin 用户名的口令的文件路径。 -pf /tmp/jsmith-password-file.txt 不在命令中指定口令。系统将提示您在命令行中输入口令。示例： ./MigrateAgent register 10.10.10.101 jsmith -p jspwd	将此计算机注册为指定服务器上的工作负载。此命令还会检查指定的 PlateSpin 服务器中是否有驱动程序升级。可让您添加无法发现的工作负载。注册的工作负载与发现的工作负载存在以下方面的差异：注册的源工作负载不会储存源身份凭证。您必须使用 Migrate 代理在注册的源工作负载中安装、升级和去除 Linux blkwatch 驱动程序。在删除所注册源工作负载的合同后，必须手动从工作负载上去除 OFX 控制器。请参见部分 42.2.2, 清理 Linux 工作负载。
status [<服务器>] 对于服务器，请指定 PlateSpin Migrate 服务器的 DNS 名称或 IP 地址。	显示 PlateSpin 控制器和驱动程序的安装状态。如果您指定了 PlateSpin 服务器，该命令会检查服务器中是否有驱动程序升级。
driver-install [<服务器>] 对于服务器，请指定 PlateSpin Migrate 服务器的 DNS 名称或 IP 地址。	安装相应的 PlateSpin blkwatch 驱动程序。如果您指定了 PlateSpin 服务器，该命令会检查服务器中是否有驱动程序升级。
driver-upgrade [<服务器>] 对于服务器，请指定 PlateSpin Migrate 服务器的 DNS 名称或 IP 地址。	升级已安装的 PlateSpin blkwatch 驱动程序。如果您指定了 PlateSpin 服务器，该命令会检查服务器中是否有驱动程序升级。
driver-uninstall	从源 Linux 工作负载中卸装已安装的 PlateSpin blkwatch 驱动程序。
configure <服务器> <新服务器> 对于服务器，请指定 PlateSpin Migrate 服务器的 DNS 名称或 IP 地址。对于新服务器，请指定 PlateSpin Migrate 服务器的新 DNS 名称或 IP 地址。示例： ./MigrateAgent configure 10.10.10.10 10.10.20.20	停止 OFX 控制器 (ofxcontroller) 服务、用新地址修改 OFX 控制器配置文件，然后重启动该服务。如果您修改了 PlateSpin 服务器的公用 IP 地址，则必须在为该服务器配置的每个源工作负载上都运行此命令。
命令选项
服务器	指定 PlateSpin Migrate 服务器的 DNS 名称或 IP 地址。当您调用 status、driver-install 或 driver-upgrade 选项时，从指定的服务器下载 blkwatch 驱动程序。
user	指定有权添加工作负载的管理员级用户的 PlateSpin 服务器用户名。
选项
-h、--help	显示命令的用法和选项。
-p、--password -p <用户口令>	指定 PlateSpin 服务器用户名的口令。如果您未在命令行中包含口令，脚本会提示您输入口令。当您键入口令时，口令会模糊化，且不会显示在进程列表中。请不要将此选项与 passwordfile 选项结合使用。
-pf、--passwordfile -pf <口令文件路径>	指定包含所指定 PlateSpin 服务器用户名的口令的文件路径。请不要将此选项与 password 选项结合使用。
日志记录
logging.json	包含有关记录 Migrate 代理实用程序操作的 JSON 格式日志记录配置设置。要查看日志记录设置，请使用 cat 命令： cat MigrateAgent/logging.json 可在文本编辑器中编辑该文件。可通过将 "level:" 值从 "DEBUG" 更改为 "INFO" 或 "ERROR" 来设置日志记录级别。例如： "level": "DEBUG" 或者 "level": "INFO" 或者 "level": "ERROR" 记录的讯息默认会写入 MigrateAgent 目录中的 MigrateAgent.log 文件。可在 logging.json 文件中修改日志文件名设置。
MigrateAgent.log	包含针对 MigrateAgent 命令记录的讯息。要查看该日志，请使用 cat 命令。 cat MigrateAgent.log