OS_install 命令

在线编辑

用途

对 OS_install 对象执行网络安装操作。

语法

传统用法：

OS_install[ -K keyfile_path_name]{ '-o Operation}[ -F][-a- attr=value... ] {ObjectName}

对于系统计划安装（系统计划模式）：

OS_install[ -K keyfile_path_name] '-i'sysplan{ '-x sysplan.xml}[ '-d' ] [ -F]

对于列示 OS_install 对象 (列示方式):

OS_install -l [ -v] [ -t object_type | object_name]

对于管理网络守护程序：

OS_install -S | -U

描述

OS_install 命令对 OS_install 对象执行网络安装操作。操作类型取决于 ObjectName 参数指定的对象的类型。 ObjectName 参数指向的对象可以是四种类型之一: Client， OS_Resource， Remote_Resource 或 Control_Host。命令操作涉及创建和管理 OS_install 对象，这些对象使网络安装能够在客户机系统上安装操作系统。

OS_install 也可以通过传递 -i sysplan 标志 (而不是指定操作) 以系统规划方式运行。此操作使您能够将多个 OS_install 操作组合到单个 XML 文档中。

涉及 Remote_Resource 对象的操作需要配置通过 ssh-keygen 命令生成的 SSH 密钥。需要 SSH 密钥，才能在本地平台和远程资源服务器上运行 ssh 命令。在 HMC 上，包含 SSH 密钥的文件 keyfile_path_name 的缺省名称为 /home/hscroot/ssh_keys。可使用 -K 选项来覆盖此文件名。在其他平台上，SSH 密钥文件没有缺省文件名。如果未在其他平台上指定 -K 选项，那么 SSH 密钥文件的标准路径名必须可供 OS_install 命令进程访问。

OS_install 的列表方式用于列出 OS_install 环境中对象的当前配置。

可以使用 S 和 U 选项启动和停止 HMC 或 IVM 网络守护程序，而无需修改 OS_install 对象。

标志

项	描述
-a 属性 = 值	将指定值分配给指定属性。操作列出了特定操作的必需属性和可选属性。
-d	在完成所有操作之后，删除在系统规划方式下创建的所有 OS_install 对象。
-F	授权在 OS_install 分配操作或系统规划安装期间重置现有远程服务器客户机系统对象 (如果需要)。
-i sysplan	指定系统计划模式。
-K keyfile_path_name	指定用于生成 SSH 密钥的文件的绝对路径名。
-l	缺省情况下，列示环境中的所有 OS_install 对象。
-o 操作	指定要对 OS_install 对象执行的操作。
-S	启动网络守护程序而不修改 OS_install 对象。
-t object_type \| object_name	将 -l 标志返回的列表缩小到仅类型为 object_type 的对象或 object_name指定的单个 OS_install 对象。
-U	停止网络守护程序而不修改 OS_install 对象。
-v	显示 -l 标志返回的列表。
-x sysplan.xml	指定包含系统计划的 XML 文件。

操作

操作	描述	必需属性	可选属性
define_client [-a attr=value...] {ClientObjectName}	定义新的客户机对象。	ip_addr 客户机的 IP 地址。 mac_addr 客户机系统的网络接口的 MAC 地址。 gateway 客户机系统的 IP 网关地址。 subnet_mask 客户机系统的 IP 子网掩码。 lpar 安装客户机的 LPAR 名称 (netboot 操作的必需属性)。 profile 要用于客户机的 LPAR 概要文件 (netboot 操作的必需属性)。 managed_system 包含 LPAR (netboot 操作的必需属性) 的受管系统的名称。 ctrl_host 此客户机的硬件控制主机对象的名称（netboot 操作的必需属性）。	adapter_speed 客户机系统的网络适配器的速度。 adapter_duplex 客户机系统的网络适配器的双工设置。 disk_location 要安装客户机的磁盘的位置。 vlan_tag 指定在进行网络安装期间用于标记以太网框架以进行虚拟网络通信的虚拟逻辑区域网 (VLAN) 标记。有效值为 0 - 4094。 vlan_pri 指定在进行网络安装期间用于标记以太网框架以进行虚拟网络通信的虚拟逻辑区域网 (VLAN) 标记。有效值为 0 - 7。
define_resource [-a attr=value...] {ResourceObjectName}	定义新的 OS_Resource 对象。	类型 AIX®或 VIOS。版本 (version) 操作系统版本。位置 OS_Resource 所在的绝对路径。源安装映像的数据源。	configfile 安装配置文件。
define_remote_resource [-a attr=value...] {ResourceObjectName}	定义新的 Remote_Resource 对象。	服务器远程资源服务器的主机名。类型 AIX 或 Linux®。 remote_identifier 远程资源服务器上的资源或资源集的名称。	communication_method 支持 SSH 通信方法。
define_ctrl_host [-a attr=value...] {ControlHostObjectName}	定义新的 Hardware Control_Host 对象。	communication_method 支持 SSH 通信方法。 hostname 控制主机的主机名 (如果在 HMC 控制主机上运行 OS_install ，那么可以指定主机名 localhost )。类型 hmc 或 ivm。	无。
allocate [-F] [-a attr=value...] {ClientObjectName}	将 OS_Resource 或 Remote_Resource 分配给客户机对象。这两个对象都必须存在于 OS_install 环境中。如果客户机对象具有已分配给它的 OS_Resource 或 Remote_Resource ，那么会发生错误。	os_resource 要分配给客户机对象的现有 OS_Resource 或 Remote_Resource 对象。 remote_resource 要分配给客户机对象的现有 Remote_Resource 对象。 install_resource 要分配给客户机对象的现有 OS_Resource 或 Remote_Resource 对象。	config_file 安装配置文件 (适用于 OS_Resource 对象)。
netboot {ClientObjectName}	指示客户机对象的硬件控制主机启动网络引导。	无。	无。
monitor_installation {ClientObjectName}	监视客户机对象的安装状态。	无。	无。
deallocate {ClientObjectName}	取消分配通过分配操作分配给客户机对象的 OS_Resource 或 Remote_Resource 。	无。	无。
remove {ObjectName}	从 OS_install 环境中除去对象。	无。	无。

退出状态

项	描述
0	命令成功完成。
>0	发生错误。

示例

要定义客户机对象，请输入类似以下命令的命令：

OS_install -o define_client -a ip_addr=128.0.64.117 -a mac_addr=ab:cc:de:10:23:45 -a \
gateway=128.0.64.1 -a subnet_mask=255.255.255.0 -a ctrl_host=myhmc -a lpar=AIX1 -a \
profile=AIX1 -a managed_system=myMngSys myclient01

上例中的客户机对象是受管系统中的一个逻辑分区。

要定义 OS_Resource 对象，请输入类似于以下内容的命令:

OS_install -o define_resource -a location=/images/AIX/53ML3 -a type=AIX -a version=53ML3 my53resource

要定义 Remote_Resource 对象 (使用 HMC 的 OS_install 缺省 SSH 密钥文件) ，请输入类似如下的命令:

OS_install -o define_remote_resource -a server=MyNimServer -a type=AIX
  -a remote_identifier=NimResGrp1 myRemoteResource

要定义 Remote_Resource 对象 (使用先前生成的位于 /home/hscroot/id_dsa 文件中的 ssh-keygen 键) ，请输入以下命令:

OS_install -K /home/hscroot/id_dsa -o define_remote_resource -a server=MyNimServer -a type=AIX -a 
remote_identifier=NimResGrp1 myRemoteResource

要将示例 2 中定义的 OS_Resource 对象分配给客户机对象，请输入类似于以下的命令:

OS_install -o allocate -a os_resource=my53resource myclient01

或

OS_install -o allocate -a install_resource=my53resource myclient01

要将示例 3 中定义的 Remote_Resource 对象分配给客户机对象并在现有客户机上授权重置，请输入类似如下的命令:

OS_install -o allocate -F -a remote_resource=myRemoteResource myclient01

或

OS_install -o allocate -F -a install_resource=myRemoteResource myclient01

如果要释放示例 5 中分配的 my53resource 客户机对象，请输入以下命令：
```
OS_install -o deallocate myclient01
```
要定义要为 Client 对象的 ctrl_host 属性指定的 Control_Host 对象，请输入类似如下的命令:
```
OS_install -o define_ctrl_host -a type=hmc -a hostname=hmc_hostname -a communication_method=ssh myhmc
```
尽管上述示例在第一个示例中共享 ctrl_host 属性的相同名称，但 define_client 操作允许为 ctrl_host 属性指定未定义的 Control_Host 对象。在这种情况下，客户机对象的控制主机必须是执行客户机的 netboot 操作的 HMC 或 IVM。
要执行 netboot 操作，请输入:
```
OS_install -o netboot myclient01
```

要查看 myclient01 安装，请输入：

OS_install -o monitor_installation myclient01

要除去 my53resource 对象的定义，请输入：
```
OS_install -o remove my53resource
```
要除去 myclient01 对象的定义，请输入：
```
OS_install -o remove myclient01
```
如果指定了 OS_Resource 对象，那么 remove 操作将除去该对象的 location 属性所指定的文件系统目录中存在的操作系统映像。

配置 SSH

通过输入以下命令，生成 SSH Rivest-Shamir-Adleman (RSA) 密钥并将这些密钥放入 HMC HOME 目录中的可访问 ssh_keys 文件：
```
 ssh-keygen -t rsa -f /home/hscroot/ssh_keys
```
在远程资源服务器上，将使用 ssh-keygen 命令生成的 /home/hscroot/ssh_keys.pub 文件的内容附加或复制到资源服务器的 .ssh/authorized_keys 文件。
如果使用 OS_install 命令在远程 HMC 控制主机的目标客户机上运行 netboot 操作，请通过在远程 HMC 上以 hscroot 用户身份输入以下命令，将使用 ssh-keygen 命令生成的 /home/hscroot/ssh_keys.pub 文件的内容附加到远程 HMC hscroot 用户的 .ssh/authorized_keys2 文件:
```
mkauthkeys -a '<content_of_ssh_keys.pub>'
```

位置

项	描述
/usr/sbin/OS_install
/opt/osinstall	包含 OS_install Perl 模块文件的目录。

文件

项	描述
/var/osinstall	包含 OS_install 环境的配置文件的目录。
/home/hscroot/ssh_keys	HMC 上 SSH 密钥的缺省文件名。