OS_install コマンド

オンライン編集

目的

OS_install オブジェクトに対してネットワーク・インストール操作を実行します。

構文

伝統的な使用法:

OS_install [ -K キーファイルパス名]{ -o オペレーション } [ -F] [-a- attr=value... ] {オブジェクト名}

システム・プラン・インストール用 (System Plan モード):

OS_install [ -K キーファイルパス名] -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の 4 つのタイプのいずれかです。コマンド操作には、ネットワーク・インストールでクライアント・システムにオペレーション・システムをインストールできるようにする 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 オプションを指定しない場合は、 OS_install コマンド・プロセスが SSH 鍵ファイルの標準パス名にアクセスできなければなりません。

OS_install のリスト・モードは、 OS_install 環境内のオブジェクトの現行構成をリストするために使用されます。

HMC または IVM ネットワーク・デーモンは、 OS_install オブジェクトを変更せずに、 S および U オプションを使用して開始および停止することができます。

フラグ

項目	説明
-a attr=value	指定された属性に指定された値を割り当てます。操作は、特定の操作の必須属性とオプション属性をリストしています。
-d	すべての操作が完了した後、システム・プラン・モードで作成されたすべての OS_install オブジェクトを削除します。
-F	OS_install 割り振り操作またはシステム・プランのインストール時に、必要に応じて既存のリモート・サーバー・クライアント・システム・オブジェクトのリセットを許可します。
-i sysplan	System Plan モードを指定します。
-K 鍵ファイル・パス名	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...] {クライアント・オブジェクト名}	新しいクライアント・オブジェクトを定義します。	ip_addr クライアントの IP アドレス。 mac_addr クライアント・システムのネットワーク・インターフェースの MAC アドレス。ゲートウェイクライアント・システムの IP ゲートウェイ・アドレス。 subnet_mask クライアント・システムの IP サブネット・マスク。 lpar クライアントをインストールするための LPAR 名 (netboot 操作の必須属性)。プロファイルクライアントに使用する LPAR プロファイル (netboot 操作には必須属性)。 managed_system LPAR を含む管理対象システムの名前 (netboot 操作の必須属性)。 ctrl_host このクライアントの Hardware Control Host オブジェクトの名前 (netboot 操作に必須の属性)。	adapter_speed クライアント・システムのネットワーク・アダプターの速度。 adapter_duplex クライアント・システムのネットワーク・アダプターの二重設定。 disk_location クライアントをインストールするためのディスクの場所。 vlan_tag 仮想ネットワーク通信用のネットワーク・インストール中にイーサネット・フレームのタグ付けに使用する、仮想論理エリア・ネットワーク (VLAN) を指定します。有効な値は 0 から 4094 です。 vlan_pri 仮想ネットワーク通信用のネットワーク・インストール中にイーサネット・フレームのタグ付けに使用する、仮想論理エリア・ネットワーク (VLAN) を指定します。有効な値は 0 から 7 です。
define_resource [-a attr=value...] {リソース・オブジェクト名}	新規 OS_Resource オブジェクトを定義します。	タイプ AIX®またはVIOS。バージョン OS バージョン。ロケーション OS_Resource が存在する場所の絶対パス。ソースインストール・イメージのソース。	configfile インストール構成ファイル。
define_remote_resource [-a attr=value...] {リソース・オブジェクト名}	新規 Remote_Resource オブジェクトを定義します。	サーバーリモート・リソース・サーバーのホスト名。タイプ AIX または Linux®。 remote_identifier リモート・リソース・サーバー上のリソースまたはリソース・セットの名前。	communication_method SSH 通信方式をサポートします。
define_ctrl_host [-a attr=value...] {制御ホスト・オブジェクト名}	新しい Hardware Control_Host オブジェクトを定義します。	communication_method SSH 通信方式をサポートします。 hostname 制御ホストのホスト名 ( OS_install が HMC 制御ホストで実行されている場合は、ホスト名 localhost を指定できます)。タイプ hmc または ivm。	ありません。
allocate [-F] [-a attr=value...] {クライアント・オブジェクト名}	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 {クライアント・オブジェクト名}	クライアント・オブジェクトのハードウェア制御ホストに対して、ネットワーク・ブートを開始するよう指示します。	ありません。	ありません。
monitor_installation {クライアント・オブジェクト名}	クライアント・オブジェクトのインストール状況をモニターします。	ありません。	ありません。
deallocate {クライアント・オブジェクト名}	割り振り操作によってクライアント・オブジェクトに割り振られた OS_Resource または Remote_Resource を割り振り解除します。	ありません。	ありません。
remove {オブジェクト名}	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 属性で指定されたファイル・システム・ディレクトリーに存在する OS イメージを除去します。

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 コントロール・ホストのターゲット・クライアントでネット・ブート操作を実行する場合は、リモート 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 キー用のデフォルトのファイル名。