nimadm 命令

在线编辑

用途

nimadm (网络 Installation Manager 备用磁盘迁移) 命令是一个实用程序，允许系统管理员执行以下操作:
  • 将 rootvg 的副本创建到一个或多个可用磁盘，并同时将其迁移到 AIX®的新版本或发行版级别。
  • 使用 rootvg 的副本，创建新的 NIM mksysb 资源，该资源将迁移到 AIX的新版本或发行版级别。
  • 使用 NIM mksysb 资源，创建新的 NIM mksysb 资源，该资源将迁移到 AIX的新版本或发行版级别。
  • 使用 NIM mksysb 资源，复原到一个或多个可用磁盘，并同时迁移到 AIX的新版本或发行版级别。
nimadm 命令使用 NIM 资源执行这些功能。

语法

执行备用磁盘迁移
nimadm -l lpp_source -c NIMClient -s SPOT -d TargetDisks [ -a PreMigrationScript ] [ -b installp_bundle] [ -z PostMigrationScript] [ -e exclude_files] [ -i image_data ] [ -j VGname ] [ -m NFSMountOptions ] [ -o bosinst_data] [-P Phase] [ -j VGname ] [-Y ] [ -F ] [ -D ] [ -E ] [ -V ] [{ -B | -r }]
在客户机上清除备用磁盘迁移
nimadm -C -c NIMClient -s SPOT [ -F ] [ -D ] [ -E ]
唤醒卷组
nimadm -W -c NIMClient -s SPOT -d TargetDisks [-m NFSMountOptions ] [-z PostMigrationScript ] [ -F ] [ -D ] [ -E ]
放入休眠卷组
nimadm -S -c NIMClient -s SPOT [ -F ] [ -D ] [ -E ]
使备用磁盘迁移软件同步
nimadm -M -s SPOT -l lpp_source [ -d device ] [ -P ] [ -F ]
mksysb 到客户机迁移
nimadm -T NIMmksysb -c NIMClient -s SPOT -l lpp_source -d TargetDisks -j VGname -Y [ -a PreMigrationScript ] [ -b installpBundle ] [ -z PostMigrationScript ] [ -i ImageData ] [ -m NFSMountOptions ] [ -o bosinst_data ] [ -P Phase ] [ -F ] [ -A ] [ -D ] [ -E ] [ -V ] [ -B | -r ]
mksysb 到 mksysb 迁移
nimadm -T NIMmksysb -O mksysbfile -s SPOT -l lpp_source -j VGname -Y [ -N NIMmksysb ] [ -a PreMigrationScript ] [ -b installp_bundle ] [ -z PostMigrationScript ] [ -i image_data ] [ -m NFSMountOptions ] [ -o bosinst_data ] [ -P Phase ] [ -F ] [ -A ] [ -D ] [ -E ] [ -V ]
客户机到 mksysb 迁移
nimadm -c nim_client -O mksysbfile -s SPOT -l lpp_source -j VGname -Y [ -N NIMmksysb ] [ -a PreMigrationScript ] [ -b installp_bundle ] [ -z PostMigrationScript ] [ -i image_data ] [ -m NFSMountOptions ] [ -o bosinst_data ] [ -P Phase ] [ -e exclude_files] [ -F ] [ -A ] [ -D ] [ -E ] [ -V ]

描述

nimadm 命令是一个实用程序，允许系统管理员将 rootvg 副本创建到一个或多个可用磁盘，并同时将其迁移到 AIX的新版本或发行版级别。 nimadm 命令使用 NIM 资源执行该功能。

以下是与常规迁移相比使用 nimadm 命令的优点:
  1. 减少停机时间。 迁移是在系统已经启动和功能正常时执行的。 不需要从安装介质引导，大多数处理发生在 NIM 主控机上。
  2. nimadm 命令有助于在迁移失败时进行快速恢复。 由于 nimadm 命令使用 alt_disk_install 来创建 rootvg 的副本，因此将对副本 (altinst_rootvg) 执行所有更改。 如果存在严重的迁移安装故障，那么将清除失败的迁移，并且管理员无需执行任何进一步的操作。 如果 AIX的新 (已迁移) 级别存在问题，那么可以通过从原始磁盘引导来快速将系统返回到迁移前操作系统。
  3. nimadm 命令在可选 NIM 定制资源的帮助下允许在迁移过程中具有高度的灵活性和定制。 NIM 定制资源为 image_data， bosinst_data， exclude_files， pre-migration 脚本， installp_bundle和 post-migration 脚本。

本文档提供有关 nimadm 命令的信息。 有关 alt_disk_install， NIM ，迁移和其他相关安装问题的完整覆盖，请参阅 安装 AIX。

nimadm 本地磁盘高速缓存

本地磁盘高速缓存允许 NIM 主控机避免必须 NFS 写入客户机，这在 nimadm 操作由于 NFS 写瓶颈而未最佳执行时很有用。 如果使用 -j VGname 标志调用此函数，那么 nimadm 命令将在指定的卷组 (在 NIM 主控机上) 上创建文件系统。 此外， nimadm 命令使用流将所有数据从客户机高速缓存到这些文件系统。

以下是 nimadm 本地磁盘高速缓存功能的优点和缺点:
优点
  1. 提高了在相对较慢的网络上执行 nimadm 操作的性能。
  2. 提高了在 NFS 写操作中迂到瓶颈的 nimadm 操作的性能 (NFS 写操作成本高昂)。
  3. 降低了客户机上的 CPU 使用量。
  4. 不导出客户机文件系统。
缺点
  1. 高速缓存文件系统占用 NIM 主控机上的空间 (必须有足够的空间来托管客户机的 rootvg 文件系统和每个客户机的迁移空间)
  2. 增加了主控机上的 CPU 使用量。
  3. 在主节点上增加 I/O (为了实现最佳性能，请使用不包含操作中使用的 NIM 资源的卷组 (磁盘))。
如何执行磁盘高速缓存
  1. 确保您处于 NIM 主控机上的最新级别 bos.alt_disk_install.rte 。
  2. 将 -j VGName 标志添加到任何 nimadm 操作。 例如， nimadm -j rootvg 或 nimadm -j cachevg。
您可以将特定文件系统 (在迁移中不涉及这些文件系统) 排除在网络上进行高速缓存 (这些文件系统仍在本地复制到客户机上的 altinst_rootvg )。 要指定不通过网络进行高速缓存的文件系统列表，必须在用于迁移的 SPOT 资源所在的位置创建一个文件。 要获取 SPOT 路径的准确位置，请输入以下命令:
# lsnim -a location SpotName
该文件的名称必须采用以下格式:
Nim_Client.nimadm_cache.excl
注: 此文件适用于 Nim_Client中指定的 NIM 客户机。 完整路径必须采用以下格式:
Spot_Location/Nim_Client.nimadm_cache.excl
例如， /nim_resources/520spot/usr/myclient.nimadm_cache.excl。
要排除某个文件系统进行高速缓存，请在该文件中每行输入一个要排除的文件系统。 要排除文件系统，必须确保以下几点:
  1. 请不要排除参与迁移过程的任何文件系统。 换句话说，请不要排除其中包含已迁移的软件文件的文件系统。 排除此类文件可能会导致不可预测的结果。
  2. 请勿 (不能) 排除以下 AIX 文件系统: /， /usr， /var， /opt， /home和 /tmp。
以下四个阶段由带有磁盘高速缓存的 nimadm 命令更改 (所有其他阶段保持不变):
  • 阶段 2-NIM 主控机在指定的目标卷组 (在 NIM 主控机上) 中创建本地高速缓存文件系统。
  • 阶段 3-NIM 主控机使用客户机的数据填充高速缓存文件系统。
  • 阶段 9-NIM 主控机将所有迁移的数据写入客户机的备用 rootvg。
  • 阶段 10-NIM 主控机清除并除去本地高速缓存文件系统。
nimadm 需求
以下是 nimadm 需求:
  1. NIM 主控机必须在其 rootvg 和用于执行迁移的 SPOT 中安装相同级别的 bos.alt_disk_install.rte 。 （注：不必在客户机上安装 alt_disk_install 实用程序）。
  2. 所选 lpp_source NIM 资源和所选 SPOT NIM 资源必须与要迁移到的 AIX 级别匹配。
  3. NIM 主控机必须处于与其迁移到的级别相同的或更高的 AIX 级别。
  4. 客户机 (要迁移的系统) 必须位于 AIX 4.3.3 或更高版本。
  5. 客户机必须具有足够大的磁盘 (一个或多个磁盘) ，以克隆 rootvg 和额外的 500 兆 (大约) 可用空间用于迁移。 所需要的空间总量取决于原始系统配置和 nimadm 定制。
  6. 目标客户机必须是作为独立 NIM 客户机向主控机注册的客户机。 有关更多信息，请参阅 niminit 命令。 NIM 主控机必须能够使用 rshd 协议在客户机上执行远程命令。
  7. NIM 主控机必须能够使用 rshd 协议在客户机上执行远程命令。
  8. NIM 主控机和客户机两者都必须拥有最小 128 兆字节的 RAM。
  9. 在 NIM 主控机和客户机之间必须存在一个可信赖的网络，它能够快速传输大量的 NFS 流量。 NIM 主控机和客户机必须能够执行 NFS 安装和读/写操作。
  10. 客户机的硬件和软件必须支持要迁移到的 AIX 级别，并满足所有其他常规迁移需求。
  11. 在运行 nimadm 命令以克隆客户机系统的 rootvg 之前，必须停止所有应用程序和数据库服务器，例如 DB2 和 LDAP。 否则，nimadm 命令操作完成后，应用程序服务器和数据库服务器不会正常启动。
注: 如果无法满足需求 1-10 ，那么必须执行常规迁移。 如果您不能满足第 11 项要求，那么将无法进行迁移。
注意: 在执行 nimadm 迁移之前，您必须同意要安装的软件的所有软件许可协议。 通过将 -Y 标志指定为 nimadm 命令的自变量，或者将 ADM_ACCEPT_LICENSE 环境变量设置为 yes，可以同意要安装的软件的所有软件许可协议。
nimadm 限制
以下限制适用于 nimadm 命令：
  1. 如果在客户机的 rootvg 中打开了可信计算库 (TCB) ，那么必须将其禁用 (永久) ，使用磁盘高速缓存选项 (-j) 或执行常规迁移。 存在此局限性，这是因为 TCB 必须访问文件元数据，而通过网络文件系统 (NFS) 无法访问文件元数据。
  2. nimadm 命令使用的所有 NIM 资源都必须是 NIM 主控机的本地资源。
  3. 虽然在迁移期间几乎不会干扰客户机的活动 rootvg 卷组，但由于与克隆 alt_disk_install 命令相关联的磁盘 I/O ， biod 活动和 CPU 使用率增加，客户机可能会迂到性能轻微下降的情况。
  4. 您可能需要调整 NFS 以优化 nimadm 性能。
  5. NIM 客户机上 nimadm 的保留目录名为 /ALT_MIG_SPOT， /ALT_MIG_EXCL， /ALT_MIG_IMAGES和 /ALT_MIG_IMD。 如果使用了这些名称，那么 nimadm 命令将失败。
nimadm使用的 NIM 资源:
SPOT 资源 标志) (-s
所有的 nimadm 操作（迁移、清除、唤醒、休眠）都需要 NIM spot 资源。 客户机使用的所有 nimadm 和 alt_disk_install 实用程序都安装在此资源中。 无需在客户机上安装 nimadm 软件。 必须使用 NIM cust 操作将下列文件集安装到 SPOT 中：
  • 必需- bos.alt_disk_install.rte (必须与 NIM 主控机级别匹配)。
  • 可选消息目录- bos.msg.$LANG.alt_disk_install.rte
lpp_source 资源 标志) (-l
此 NIM 资源是用于迁移系统的安装映像的源。 它对于 nimadm 迁移操作是必需的。 lpp_source 必须包含系统迁移到的级别的所有系统映像 (请检查 lsnim -l lpp_source 输出中的 lpp_source images 属性)。 它还必须包含需要迁移的任何可选 installp 映像。
pre-migration
此脚本资源在 NIM 主控机上运行，但在安装在主控机上的客户机 alt_inst 文件系统的环境中运行 (此操作是使用 chroot 命令完成的)。 该脚本在迁移开始前运行。
post-migration
这种脚本资源与 pre-migration 脚本类似，但在迁移完成后执行。
image_data
指定传递到 alt_disk_install 的 image_data 资源 (作为 -i 标志的自变量)。 NIM 在调用 alt_disk_install之前在客户机上分配并安装此资源。
exclude_files
指定传递到 alt_disk_install 的 exclude_files 资源 (作为 -e 标志的自变量)。 NIM 在调用 alt_disk_install之前在客户机上分配并安装此资源。
installp_bundle
此 NIM 资源指定 nimadm 命令在迁移完成后安装的任何其他软件。
bosinst_data
此 NIM 资源指定 nimadm 命令可能使用的各种安装设置。
nimadm 迁移过程
nimadm 命令执行迁移分为 12 个阶段。 可通过使用 -P 标志来逐一执行每个阶段。 必须按顺序运行 nimadm 阶段。 以下是 nimadm 阶段:
  1. 主节点向客户机发出 alt_disk_install 命令，该客户机将 rootvg 卷组的副本复制到目标磁盘 (巧合的是，此操作是 alt_disk_install 进程的阶段 1)。 在这个阶段创建了 altinst_rootvg（备用 rootvg）。 如果指定了目标 mksysb ，那么将使用 mksysb 在 NIM 主控机上使用本地磁盘高速缓存来创建 rootvg 卷组。
  2. 主控机运行远程客户机命令来将所有 /alt_inst 文件系统导出到主控机。 文件系统作为对主控机拥有 root 访问权的读/写被导出。 如果指定了目标 mksysb，那么会根据来自 mksysb 的映像数据创建高速缓存文件系统。
  3. 主 NFS 安装在阶段 2 中导出的文件系统。 如果指定了目标 mksysb ，那么将在阶段 2 中创建的高速缓存文件系统中复原 mksysb 归档。
  4. 如果指定了 pre-migration 脚本资源，那么将在此期间执行该脚本。
  5. 保存系统配置文件。 计算初始迁移空间并且进行适当的文件系统扩展。 将复原 bos 并合并设备数据库 (类似于常规迁移)。 会执行迁移合并方法并且进行一些其他处理。
  6. 通过使用 installp 来迁移系统的文件集。 在此阶段中，会安装任何必需 RPM 映像。
  7. 如果指定了 post-migration 脚本资源，那么将在此期间执行该脚本。
  8. 执行 bosboot 命令以创建写入客户机引导逻辑卷 (hd5) 的客户机引导映像。
  9. 除去第三阶段中在主控机上进行的安装。
  10. 除去第二阶段中创建的客户机导出。
  11. 再次调用 alt_disk_install（这是 alt_disk_install 过程的第三阶段）来进行最终调整，并且使 altinst_rootvg 进入休眠状态。 引导列表设置为目标磁盘 (除非使用 -B 标志)。 如果指定了输出 mksysb，那么高速缓存会归档到 mksysb 文件中并成为 NIM mksysb 资源。
  12. 执行清除来结束迁移。 如果指定了 -r 标志，那么将重新引导客户机。
注: nimadm 命令支持同时迁移多个客户机。
nimadm 清除操作

此操作 (用 -C 标志指示) 旨在在由于某种原因未执行清除本身的失败迁移后进行清除。 它也可用于为执行一次新的迁移而清除以前的迁移。

nimadm 唤醒和睡眠

迁移完成后，可以使用 nimadm 命令来 "唤醒" 已迁移的 altinst_rootvg 或原始 rootvg (如果从已迁移的磁盘引导)。 nimadm 唤醒操作（-W 标志）执行 alt_disk_install 唤醒，NFS 导出 /alt_inst 文件系统，并将它们安装到 NIM 主控机上。 nimadm 休眠功能（-S 标志）通过在客户机上卸装 NIM 主控机上的安装，取消导出 /alt_inst 文件系统以及执行 alt_disk_install 休眠功能来撤销唤醒。

标志

表 1. 标志
项 描述
-a PreMigrationScript 指定 pre-migration NIM 脚本资源。
-b installp_bundle 指定 installp_bundle NIM 资源。
-B 指定在 nimadm 迁移后未运行引导列表。 如果设置此标志，那么 -r 标志不可用。
-c ClientDisks 指定作为此 nimadm 操作目标的 NIM 定义的客户机。 此标志对于所有 nimadm 操作是必需的标志。
-C 执行 nimadm 清除。
-d TargetDisks 指定用于创建 altinst_rootvg (迁移的卷组) 的客户机目标磁盘。
-D 将 nimadm 命令设置为调试方式。 此函数必须仅用于调试 nimadm 相关问题，并且缺省情况下未设置此函数。
-e exclude_files 指定 exclude_files NIM 资源。 在第一阶段期间 alt_disk_install 命令使用此资源。
-E 如果发生严重迁移错误，那么进入 nimadm 调试器。
-F 强制客户机解锁。 通常情况下，nimadm 命令锁定某一客户机以执行各种操作。 当客户机被锁定时，其他 nimadm 或 NIM 操作均不能执行。 此标志必须仅在客户机未正确锁定的异常情况下使用。 如果由于某些原因， nimadm 命令在失败后无法调用清除，那么客户机将被错误地锁定。
-i image_data 指定 image_data NIM 资源。 从第一阶段到第十一阶段，alt_disk_install 命令使用该资源。
-j VG名称 在指定的卷组 (在 NIM 主控机上) 上创建文件系统，并使用流将所有数据从客户机高速缓存到这些文件系统。
-l lpp_source 指定 lpp_source NIM 资源用于 nimadm 操作。 此标志对于迁移操作是必需的标志。
-m NFSMountOptions 指定传递到安装主服务器上的客户机资源的 mount 命令的参数。 该标志用于调节与 nimadm 相关的 NFS 性能。
-M 验证 NIM 主控机， SPOT ， lpp_source 和可选设备上的 alt_disk_install 软件 (bos.alt_disk_install) 的级别是否同步 (匹配)。 如果没有匹配项，那么 nimadm 命令将安装在 lpp_source 或可选设备中找到的最高级别。
-N NIMmksysb 指定要新创建的唯一 NIM mksysb 资源。 如果指定了 -N 标志，那么必须指定 -O 标志。
-o bosinst_data 指定 bosinst_data NIM 资源。
-O mksysbfile 指定已迁移的 mksysb 的文件路径名。 如果指定了 -O 标志，那么必须指定 -j 标志以及 -c 或 -T 标志。
-P 阶段 在 nimadm 命令调用过程中执行的阶段。 如果有多个阶段，那么这些阶段必须用双引号或逗号括起的空格分隔。 第一到第十二阶段都是有效阶段。
-r 指定完成 nimadm 迁移之后必须重新引导客户机。
-s 点 指定要用于此 nimadm 操作的 SPOT NIM 资源。 此标志对于所有 nimadm 操作是必需的标志。
-S 执行 nimadm sleep 函数。 必须执行此函数才能结束 nimadm wake-up。
-T NIMmksysb 指定要迁移的现有 NIM mksysb 资源。 如果指定了 -T 标志，那么必须指定 -j 标志以及 -O 或 -c 标志。
-V 打开详细输出。
-W 执行 nimadm wake-up 函数。
-Y 同意要安装的软件所需的软件许可协议。
-z PostMigrationScript 指定 post-migration NIM 脚本资源。

退出状态

重大安全事件数量
已成功完成所有与 nimadm 命令相关的操作。
> 0
发生错误。

安全性

访问控制
您必须具有 root 用户权限才能运行 nimadm 命令。
RBAC 用户
RBAC 用户和可信 AIX 用户注意: 此命令可以执行特权操作。 只有特权用户才能执行特权限定的操作。 有关权限和特权的更多信息，请参阅 安全性中的 "特权命令数据库"。 要获取与此命令相关联的特权和权限的列表，请参阅 lssecattr 命令或 getcmdattr 子命令。

示例

  1. 要执行 nimadm 迁移到目标 NIM 客户机 aix1 ，请使用 NIM SPOT 资源 spot1， NIM lpp_source 资源 lpp1和目标磁盘 hdisk1 和 hdisk2。 -Y 标志同意要安装的软件的所有必需软件许可协议，请输入以下命令:
    nimadm -c aix1 -s spot1 -l lpp1 -d "hdisk1 hdisk2" -Y
  2. 要执行与 hdisk2的先前示例中相同的操作，并且还要运行 pre-migration 脚本 nimscript1 和 post-migration 脚本 nimscript2，请输入以下命令:
    nimadm -c aix1 -s spot1 -a nimscrip1 -z nimscript2 -l lpp1 -d hdisk1 -Y
  3. 要使用 NIM SPOT resource spot1在客户机 aix1 上执行 nimadm 清除，请输入以下命令:
    nimadm -C -c aix1 -s spot1
  4. 要创建文件名为 nim1的客户机的已迁移新 mksysb 资源，请输入以下命令:
    nimadm -c aix1 -s spot1 -l lpp1 -O /export/mksysb/mksysb1 -j vg00 -Y -N nim1
  5. 要从现有 NIM mksysb 资源创建文件名为 nim3 的新迁移的 mksysb 资源，请输入以下命令:
    nimadm -s spot1 -l lpp1 -j vg00 -Y -T nim2 -O /export/mksysb/m2 -N nim3
  6. 要迁移现有 NIM 资源并将其放在客户机上，请输入以下命令:
    nimadm -c aix1 -s spot1 -l lpp1 -d hdisk1 -j vg00 -T nim2 -Y
    注: 不会对 nim2 NIM mksysb 资源进行任何更改。

文件

项 描述
/usr/sbin/nimadm 包含 nimadm 命令。