ナビゲーションリンクをスキップ | |
印刷ビューの終了 | |
マニュアルページセクション 1M: システム管理コマンド Oracle Solaris 11.1 Information Library (日本語) |
- ネットワーク上の自動インストールの管理
/usr/sbin/installadm [-h|--help]
installadm help [subcommand]
installadm create-service [-n|--service svcname] [-s|--source source] [-p|--publisher publisher=origin] [-a|--arch architecture] [-d|--imagepath imagepath] [-y|--noprompt] [-t|--aliasof aliasof] [-i|--ip-start start] [-c|--ip-count count] [-b|--boot-args property=value,...] [-B|--bootfile-server server]
installadm set-service -o|--option property=value svcname
installadm update-service [-p|--publisher publisher=origin] [-s|--source FMRI] svcname
installadm rename-service svcname newsvcname
installadm enable svcname
installadm disable svcname
installadm delete-service [-r|--autoremove] [-y|--noprompt] svcname
installadm list [-n|--service svcname] [-c|--client] [-m|--manifest] [-p|--profile]
installadm create-manifest -n|--service svcname -f|--file filename [-m|--manifest manifest] [-c|--criteria criteria=value|list|range... | -C|--criteria-file criteriafile] [-d|--default]
installadm update-manifest -n|--service svcname -f|--file filename [-m|--manifest manifest]
installadm delete-manifest -n|--service svcname -m|--manifest manifest
installadm create-profile -n|--service svcname -f|--file filename... [-p|--profile profile] [-c|--criteria criteria=value|list|range... | -C|--criteria-file criteriafile]
installadm update-profile -n|--service svcname -f|--file filename [-p|--profile profile]
installadm delete-profile -n|--service svcname -p|--profile profile...
installadm export -n|--service svcname -m|--manifest manifest... -p|--profile profile... [-o|--output pathname]
installadm validate -n|--service svcname -P|--profile-file filename... | -p|--profile profile...
installadm set-criteria -n|--service svcname -m|--manifest manifest -p|--profile profile... -c|--criteria criteria=value|list|range... | -C|--criteria-file criteriafile | -a|--append-criteria criteria=value|list|range...
installadm create-client -n|--service svcname [-b|--boot-args property=value,...] -e|--macaddr macaddr
installadm delete-client macaddr
自動インストーラ (AI) は、1 つ以上の SPARC および x86 システムにネットワーク経由で Oracle Solaris OS を自動インストールするために使用します。
ネットワーク経由で AI を使用するために必要なマシントポグラフィーは、インストールサーバー、DHCP サーバー (これはインストールサーバーと同じシステムでもよい)、およびインストールクライアントです。インストールサーバーでは、AI ブートイメージ (クライアントがネットワーク経由でブートするために提供される)、入力仕様 (AI マニフェストと派生したマニフェストスクリプトのいずれかがクライアント用に選択される)、およびサービス管理機能 (SMF) 構成プロファイル (このうちゼロ個以上がクライアント用に選択される) が含まれるようにインストールサービスが設定されます。
AI ブートイメージの内容は、パッケージ install-image/solaris-auto-install として公開され、create-service サブコマンドでインストールされます。 create-service サブコマンドを使用すると、AI ブートイメージを作成する AI ISO ファイルを受け入れて、展開することもできます。
インストールサービスはデフォルトの AI マニフェストを使用して作成されますが、create-manifest サブコマンドを使用して、カスタマイズされたマニフェストまたは派生したマニフェストスクリプト (今後は「スクリプト」と呼びます) をインストールサービスに追加できます。マニフェストおよび派生したマニフェストスクリプトの作成方法の詳細は、『Oracle Solaris 11.1 システムのインストール』を参照してください。create-manifest サブコマンドを使用して、インストールクライアント用に選択するマニフェストまたはスクリプトを決定する際に使用される条件を指定することもできます。すでにマニフェストまたはスクリプトに関連付けられている条件は、set-criteria サブコマンドを使用して変更できます。
マニフェストには、ターゲットデバイス、パーティション情報、パッケージの一覧、その他のパラメータなどの情報を含めることができます。スクリプトには、実行中の AI クライアントシステムを照会し、検索した情報に基づいてカスタムマニフェストを作成するコマンドが含まれています。スクリプトで AI が起動されると、AI はそのスクリプトを最初のタスクとして実行し、マニフェストを生成します。
クライアントがブートすると、クライアントのマシン条件に一致するマニフェストまたはスクリプトの検索が開始されます。一致するマニフェストまたはスクリプトが見つかると、一致するマニフェストファイルの仕様、または一致するスクリプトから派生したマニフェストファイルの仕様に従って、クライアントに Oracle Solaris リリースがインストールされます。各クライアントは、マニフェストまたはスクリプトを 1 つだけ使用できます。
各サービスには、デフォルトのマニフェストまたはスクリプトが 1 つ含まれています。このデフォルトは、インストールされるシステムに一致するマニフェストまたはスクリプトの条件がほかに存在しない場合に使用されます。任意のマニフェストまたはスクリプトをデフォルトとして指定できます。デフォルトのマニフェストまたはスクリプトに関連付けられた条件は非アクティブになり、マニフェストまたはスクリプトの選択時に考慮されません。あとで別のマニフェストまたはスクリプトをデフォルトにすると、前のデフォルトのマニフェストまたはスクリプトの条件がふたたびアクティブになります。条件が関連付けられていないマニフェストまたはスクリプトは、デフォルトのマニフェストまたはスクリプトとしてのみ使用できます。条件がないマニフェストまたはスクリプトは、別のマニフェストまたはスクリプトがデフォルトに指定されると非アクティブになります。
システム構成プロファイルは、インストールの仕様も含むという点で、マニフェストやスクリプトを補完するものです。プロファイルは、特にユーザー名、ユーザーパスワード、タイムゾーン、ホスト名、IP アドレスなどの構成情報を指定するために使用されます。プロファイルには、インストール時に、インストールされるクライアントに適した値に置き換えられる変数が含まれていることがあります。このように、単一のプロファイルファイルで、さまざまなクライアントにさまざまな構成パラメータを設定できます。「使用例」のセクションを参照してください。
システム構成プロファイルは smf(5) によって処理され、ドキュメント形式 service_bundle(4) に準拠しています。システム構成プロファイルの詳細は、sysconfig(1M) および『Oracle Solaris 11.1 システムのインストール』の第 11 章「クライアントシステムの構成」を参照してください。各クライアントは、任意の数のシステム構成プロファイルを使用できます。特定の SMF プロパティーは、クライアントシステムごとに 1 回しか指定できません。
特定のクライアントが特定のインストールサービスを使用する場合は、create-client サブコマンドを使用してクライアントをサービスに関連付けることができます。create-client を使用して既存のクライアントを変更することもできます。
installadm ユーティリティーを使用して次のタスクを実行できます。
インストールサービスおよび別名の設定
特定のインストールサービスのネットイメージを更新する
インストールイメージの設定
クライアントの設定または削除
マニフェストおよびスクリプトの追加、更新、または削除
マニフェストまたはスクリプトに対する条件の指定または変更
マニフェストおよびスクリプトのエクスポート
システム構成プロファイルの追加または削除
プロファイルの検証
プロファイルに対する条件の指定または変更
プロファイルのエクスポート
インストールサービスの有効化または無効化
インストールサービスの一覧表示
インストールサービスのクライアントの一覧表示
インストールサービスのマニフェストおよびスクリプトの一覧表示
インストールサービスのプロファイルの一覧表示
SMF サービス svc:/system/install/server:default の次のプロパティーは、インストールサーバーを構成する際に使用されます。
all_services/exclude_networks プロパティーの設定に応じて、許可または却下する CIDR 形式のネットワーク (たとえば、192.168.56.0/24) の一覧。
このネットワーク一覧を使用して、このインストールサーバーで処理されるクライアントを指定します。デフォルトでは、AI インストールサーバーがマルチホームになっている場合は、そのサーバーが接続されているすべてのネットワーク上のインストールクライアントを処理するよう構成されます。
ブール値。true の場合、このインストールサーバーによる処理対象から、all_services/networks プロパティーで指定されたネットワークを除外します。false の場合、all_services/networks プロパティーで指定されたネットワークを含めます。
AI インストールサービス Web サーバーをホストするポートを指定します。デフォルトでは、Web サーバーはポート 5555 でホストされます。
デフォルトとは異なるポート番号を使用する場合は、インストールサービスを作成する前に port プロパティーをカスタマイズしてください。
installadm create-service コマンドによって作成されるイメージのデフォルトの場所を指定します。イメージは、all_services/default_imagepath_basedir/ service_name にあります。このプロパティーのデフォルト値は /export/auto_install です。
ブール値。true の場合、クライアントとサービス構成がインストールサーバーで変更されるとローカル ISC DHCP 構成を自動的に更新します。false の場合、ISC DHCP 構成を自動的に維持しません。
installadm コマンドには、次のオプションがあります。
使用法のヘルプメッセージを表示します。
installadm コマンドには、次に示すサブコマンドがあります。後述の「使用例」のセクションを参照してください。
installadm ユーティリティーの構文を表示します。
指定されたサブコマンドの構文のみを表示します。
このサブコマンドは、指定された imagepath ディレクトリにネットワークブートイメージ (ネットイメージ) を設定し、ネットイメージからブートされたクライアントのインストール方法を指定するインストールサービスを作成します。
AI ブートイメージの内容は、パッケージ install-image/solaris-auto-install として公開されています。 -s オプションが指定されない場合は、そのパッケージのインスタンスが記載されているシステムのパブリッシャー設定一覧の 1 番目のパブリッシャーからパッケージがインストールされます。 -s オプションは、pkg の指定を完全な FMRI またはイメージ ISO ファイルの場所として受け入れます。ネットイメージは最終的に imagepath に配置されます。このネットイメージを使用してクライアントインストールを実行できます。
次の仕様に注意してください。
指定されたアーキテクチャーの最初のインストールサービスがインストールサーバー上で作成されると、そのサービスの別名 (default-i386 または default-sparc) が自動的に作成されます。このデフォルトサービスは、create-client サブコマンドを使用して明示的にインストールサーバーに追加されなかったアーキテクチャーのクライアントへのすべてのインストールで使用されます。default-arch サービスに別名が設定されたサービスを変更するには、set-service サブコマンドを使用します。default- arch サービスを更新するには、update-service サブコマンドを使用します。
default-arch の別名が新しいインストールサービスに変更されたときに、ローカル ISC DHCP 構成が見つかった場合は、このデフォルトの別名ブートファイルが、そのアーキテクチャーのデフォルトの DHCP サーバー全体のブートファイルとして設定されます。
クライアントがそのアーキテクチャーのデフォルト以外のインストールサービスを使用する場合は、create-client サブコマンドを使用してクライアント固有の構成を作成する必要があります。
-i オプションと -c オプションが使用され、DHCP サーバーがまだ構成されていない場合は、ISC DHCP サーバーが構成されます。
ISC DHCP サーバーがすでに構成されている場合は、その DHCP サーバーが更新されます。
-i および -c 引数が指定され、DHCP が構成されている場合でも、作成されるインストールサービスと IP 範囲との間に結合は存在しません。-i と -c が渡され、all_services/manage_dhcp の値が true の場合は、IP 範囲が設定され、必要に応じて新しい DHCP サーバーが作成され、その DHCP サーバーは使用するすべてのインストールサービスとすべてのクライアントのために実行された状態のままになります。DHCP サーバーに指定されたネットワーク情報には、作成されるサービスとの特定の関係はありません。
インストールサーバーが直接接続され、インストールサーバーがマルチホームになっているサブネット上に要求された IP 範囲が存在しない場合は、-B オプションを使用してブートファイルサーバーのアドレス (通常はこのシステム上の IP アドレス) を指定します。これは、インストールサーバー上で複数の IP アドレスが構成され、DHCP リレーが採用されている場合にのみ必要です。その他のすべての構成では、ソフトウェアでこれを自動的に決定できます。
省略可能: システムによって生成されたサービス名の代わりに、このインストールサービス名を使用します。svcname は、英数字、アンダースコア (_)、ハイフン (-) で構成できます。svcname の最初の文字をハイフンにすることはできません。svcname の長さは 63 文字を超えることはできません。
-n オプションが指定されなかった場合は、自動的にサービス名が生成されます。デフォルトの名前には、アーキテクチャーや OS バージョン情報が含まれます。
省略可能: ネットイメージのデータソースを指定します。これは次のいずれかです。
IPS AI ネットイメージパッケージの FMRI。これはデフォルトです。-s オプションが指定されていない場合、入手可能な最新バージョンの install-image/solaris-auto-install パッケージが使用されます。パッケージは、-p オプションで指定された発行元から、またはパッケージのインスタンスが記載されているインストールサーバーの発行元設定一覧の最初の発行元から取得します。
AI ISO イメージへのパス
オプション: サービスが IPS パッケージから作成されるときに限り適用されます。install-image/solaris-auto-install パッケージを取得する IPS パッケージリポジトリを指定します。たとえば、solaris=http://pkg.oracle.com/solaris/release/ です。
-p オプションが指定されなかった場合、使用される発行元は、パッケージのインスタンスが記載されているインストールサーバーの発行元設定一覧の最初の発行元です。
オプション: サービスが IPS パッケージから作成されるときに限り適用されます。このサービスとともにインストールするクライアントのアーキテクチャーを指定します。値は i386 または sparc のいずれかです。デフォルトは、インストールサーバーのアーキテクチャーです。
省略可能: ネットイメージを作成するパスを指定します。指定しない場合、イメージは、all_services/default_imagepath_basedir プロパティーの値で定義された場所にある svcname ディレクトリに作成されます。このプロパティーのデフォルト値については、「インストールサーバー構成のプロパティー」を参照してください。-y も指定したときを除き、確認プロンプトが表示されます。
省略可能: 確認プロンプトを非表示にして、指定されたオプションとデフォルト値を使用してサービスの作成を続行します (-d を参照)。
オプション: この新規サービスは、aliasof インストールサービスの代替名です。
省略可能: ローカル DHCP 構成に追加される範囲の開始 IP アドレスを指定します。IP アドレスの数は、-c オプションで指定されます。ローカルの ISC DHCP 構成が存在せず、all_services/manage_dhcp の値が true である場合は、ISC DHCP サーバーが起動されます。
オプション: DHCP 構成の IP アドレスの総数を count の値と同じに設定します。最初の IP アドレスは、-i オプションで指定される start の値です。
省略可能: x86 クライアント専用。サービスイメージ内のサービス固有のブート構成ファイルにプロパティー値を設定します。このオプションを使用して、このサービスに固有のブートプロパティーを設定します。このオプションには、コンマで区切られた複数の property= value ペアを指定できます。
省略可能: クライアントがブートファイルを要求するブートサーバーの IP アドレスを指定するために使用します。ほかの方法ではこの IP アドレスを決定できない場合にのみ必要です。
設定するプロパティーと値を指定します。
property=value は次のようになります:
aliasof=aliasof
svcname を aliasof インストールサービスの別名にします。
imagepath=newpath
既存のサービスの imagepath を再配置します。
default-manifest=manifest
指定されたサービスにすでに登録されている特定のマニフェストまたは派生したマニフェストスクリプトを、そのサービスのデフォルトのマニフェストまたはスクリプトに指定します。このサービスに登録されているマニフェストおよびスクリプトの一覧を表示するには、installadm list コマンドを使用します。
$ installadm list -n svcname -m
必須: プロパティーを設定するインストールサービスの名前を指定します。
svcname に関連付けられたイメージを更新します。svcname は、IPS AI ネットイメージパッケージを使用して作成されたサービスの別名です。更新されたイメージを使用して新規サービスが作成され、新規サービスに別名として svcname が設定されます。
svcname イメージを更新する IPS パッケージリポジトリ。値の例は solaris=http://pkg.oracle.com/solaris/release/ です。
-p オプションが指定されていない場合、svcname が別名であるサービスのイメージの作成に使用された発行元が使用されます。次の pkg publisher コマンドは、発行元 svcname を表示する方法を示します:
$ installadm list Service Name Alias Of Status Arch Image Path ------------ -------- ------ ---- ---------- default-i386 solaris11_1-i386 on i386 /export/auto_install/solaris11_1-i386 solaris11_1-i386 - on i386 /export/auto_install/solaris11_1-i386 $ pkg -R /export/auto_install/solaris11_1-i386 publisher PUBLISHER TYPE STATUS URI solaris origin online http://pkg.oracle.com/solaris/release/
更新用ネットイメージパッケージの FMRI。
-s オプションが指定されていない場合、入手可能な最新バージョンの install-image/solaris-auto-install パッケージが、-p オプションの記述子で指定された発行元から使用されます。
必須: 更新するインストールサービスの名前を指定します。これは、IPS ネットイメージパッケージを使用して作成されたサービスの別名である必要があります。
インストールサービス svcname の名前を newsvcname に変更します。newsvcname は、英数字、アンダースコア (_)、ハイフン (-) で構成できます。newsvcname の最初の文字をハイフンにすることはできません。newsvcname の長さは 63 文字を超えることはできません。
svcname インストールサービスを有効にします。
svcname インストールサービスを無効にします。
インストールサービスを削除します。
このインストールサービスのマニフェスト、プロファイル、クライアント構成ファイル、および Web サーバー構成を削除します。
サービスをインスタンス化するために使用されたイメージを削除します。
次の条件が存在する場合、このサービスに関連付けられたブートファイルは ISC DHCP 構成から削除されます:
このサービスはデフォルトの別名です。
ローカル ISC DHCP 構成が存在します。
all_services/manage_dhcp プロパティー値は true です。
指定された場合は、このサービスに割り当てられたクライアント、およびこのサービスに別名が設定されたサービスも削除されます。
確認プロンプトを非表示にして、サービスの削除を続行します。
必須: 削除するインストールサービス名を指定します。
サーバー上で有効になっているすべてのインストールサービスを一覧表示します。
省略可能: ローカルサーバー上の特定のインストールサービスに関する情報を一覧表示します。
-c オプションが指定された場合は、インストールサービスに関連付けられたクライアント情報を一覧表示します。
-m オプションを指定した場合、インストールサービスに関連付けられたマニフェストおよび派生したマニフェストスクリプトを表示します。
-p オプションが指定された場合は、インストールサービスに関連付けられたプロファイルを一覧表示します。
省略可能: ローカルサーバー上のインストールサービスのクライアントを一覧表示します。
オプション: 各マニフェストの条件を含む、ローカルサーバー上のインストールサービスに関連付けられたマニフェストおよび派生したマニフェストスクリプトを表示します。サービスのデフォルトマニフェストに関連付けられた条件には、無視のラベルが付けられます。アクティブでないマニフェストにはラベルが付けられます。アクティブでないマニフェストは、関連する条件を持たず、そのサービスのデフォルトマニフェストではありません。
-n が指定されていないときは、すべてのサービスのすべてのマニフェストとスクリプトを表示します。
-n が指定されているときは、特定のサービスのすべてのマニフェストとスクリプトを表示します。
オプション: 各プロファイルの条件を含む、ローカルサーバー上のインストールサービスに関連付けられたプロファイルを表示します。
-n が指定されていないときは、すべてのサービスのすべてのプロファイルを表示します。
-n が指定されているときは、特定のサービスのプロファイルを表示します。
特定のインストールサービスのマニフェストまたは派生したマニフェストスクリプトを作成します (したがって、サービスの作成とは別に、マニフェストまたはスクリプトをネットワーク上で使用可能にします)。デフォルト以外のマニフェストまたはスクリプトは、条件が関連付けられている場合にのみ使用できます (アクティブにできます)。条件は、コマンド行で (-c)、または条件 XML ファイルで (-C) 入力できます。-d オプションとともに指定された条件は、マニフェストまたはスクリプトがデフォルトとして指定されなくなるまで、一時的に無視されます。
マニフェストの名前は次の順序で決定されます。
-m オプションで指定された manifest 名 (存在する場合)。
ai_instance name 属性の値 (マニフェストに存在する場合)。
filename のベース名。
必須: このマニフェストまたはスクリプトが関連付けられるインストールサービスの名前を指定します。
必須: 追加するマニフェストまたは派生したマニフェストスクリプトのパス名を指定します。
オプション: マニフェストまたは派生したマニフェストスクリプトの AI インスタンス名を指定します。マニフェストの ai_instance 要素の name 属性を manifest に設定します。このマニフェストまたはスクリプトは、以降の installadm コマンドおよび installadm list 出力の manifest で参照されます。
省略可能: 追加されたマニフェストまたはスクリプトに関連付けられる条件を指定します。後述の「条件」のセクションを参照してください。デフォルトマニフェストを公開すると、条件は登録されますが、マニフェストまたはスクリプトがデフォルトに指定されなくなるまで非アクティブのままです。-c オプションは複数回指定できます。
省略可能: 追加されたマニフェストまたはスクリプトに関連付けられる条件を含む条件 XML ファイルのパス名を指定します。デフォルトのマニフェストまたはスクリプトを公開すると、条件は登録されますが、マニフェストまたはスクリプトがデフォルトに指定されなくなるまで非アクティブのままです。
省略可能: このマニフェストまたはスクリプトがサービスの新しいデフォルトのマニフェストまたはスクリプトであることを指定します。指定された条件は格納されますが、別のマニフェストまたはスクリプトがデフォルトにされるまでこれらの条件は無視されます。
特定のマニフェストまたは派生したマニフェストスクリプトを svcname インストールサービスから更新します。指定されたマニフェストまたはスクリプトを filename の内容で置き換えます。マニフェストまたはスクリプトの条件やデフォルトステータスは更新後もそのままです。
マニフェストの名前は次の順序で決定されます。
-m オプションで指定された manifest (存在する場合)。
ai_instance name 属性の値 (変更されたマニフェストに存在する場合、および既存のマニフェストの ai_instance name 値と一致する場合)。
filename のベース名 (既存のマニフェストの ai_instance name 属性値と一致する場合)、または installadm list で指定された名前 (既存のスクリプトの名前と一致する場合)。
必須: 更新するマニフェストまたはスクリプトのインストールサービスの名前を指定します。
必須: 置換用のマニフェストまたは派生したマニフェストスクリプトのパス名を指定します。
省略可能: 置換用のマニフェストまたはスクリプトの AI インスタンス名を指定します。
特定のインストールサービスで公開されたマニフェストまたは派生したマニフェストスクリプトを削除します。デフォルトのマニフェストまたはスクリプトは削除できません。
必須: 削除するマニフェストまたはスクリプトのインストールサービスの名前を指定します。
必須: -n オプションを付けた installadm list で出力されるマニフェストまたは派生したマニフェストスクリプトの AI インスタンス名を指定します。
特定のインストールサービスのプロファイルを作成します。必要に応じて、条件をコマンド行で入力する (-c) か、または条件 XML ファイルに入力する (-C) ことで、プロファイルに条件を関連付けることができます。条件なしで作成されたプロファイルは、サービスのすべてのクライアントに関連付けられます。
プロファイルの名前は次の順序で決定されます。
-p オプションで指定された profile (存在する場合)。
filename のベース名。
プロファイル名は AI サービスで一意である必要があります。複数の -f オプションを使用して同じ条件を持つ複数のプロファイルを作成すると、-p オプションは無効になり、プロファイルの名前はファイル名から派生します。
必須: 作成するプロファイルのインストールサービスの名前を指定します。
必須: プロファイルを追加するために使用するファイルのパス名を指定します。複数のプロファイルを指定できます。
省略可能: 作成するプロファイルの名前を指定します。1 つのプロファイルを作成する場合にのみ有効です。
省略可能: プロファイルに関連付ける条件を指定します。後述の「条件」のセクションを参照してください。複数の -c オプションを指定できます。
省略可能: 指定されたプロファイルに関連付けられる条件を含む条件 XML ファイルのパス名を指定します。
svcname インストールサービスから指定されたプロファイルを更新します。指定されたプロファイルを filename の内容で置き換えます。プロファイルの条件は更新後もそのままです。
更新するプロファイルは、次の順序で決定されます:
-p オプションで指定された profile (存在する場合)。
filename のベース名。
必須: 更新するプロファイルのインストールサービスの名前を指定します。
必須: プロファイルを追加するために使用するファイルのパス名を指定します。
オプション: 更新するプロファイルの名前を指定します。更新するプロファイルの名前が filename のベース名と異なる場合は、このオプションを使用します。
profile プロファイルを svcname インストールサービスから削除します。
必須: プロファイルが削除されるインストールサービスの名前を指定します。
必須: 削除するプロファイルの名前を指定します。複数の -p オプションを指定できます。
指定されたサービスに属する指定されたマニフェスト、派生したマニフェストスクリプト、およびプロファイルを表示 (エクスポート) します。少なくとも 1 つのマニフェスト、スクリプト、またはプロファイルを指定する必要があります。-o オプションでファイルまたはディレクトリにリダイレクトされないかぎり、stdout に表示されます。
必須: エクスポートするマニフェスト、スクリプト、またはプロファイルに関連付けられたインストールサービスを指定します。
エクスポートするマニフェストまたは派生したマニフェストスクリプトの AI インスタンス名を指定します。複数の -m オプションを指定できます。
エクスポートするプロファイルの名前を指定します。複数の -p オプションを指定できます。
省略可能: 出力をリダイレクトします。複数のマニフェスト、スクリプト、またはプロファイルがリクエストされる場合は、pathname がディレクトリである必要があります。1 つのマニフェスト、スクリプト、またはプロファイルのみが要求される場合は、pathname にファイルを指定できます。
指定されたプロファイルを検証します。validate サブコマンドは、データベース内のプロファイルを検証する (-p) か、またはデータベースへの入力前に開発中のプロファイルを検証する (-P) ために使用できます。
必須: プロファイルが関連付けられたサービスを指定します。
検証する外部プロファイルファイルを指定します。
検証するプロファイルの名前を指定します。
すでに公開されているマニフェスト、派生したマニフェストスクリプト、またはプロファイル (あるいはその両方) の条件を更新します。条件はコマンド行または条件 XML ファイルで指定できます。相互に排他的なオプション -a、-c、または -C のいずれかを使用して条件を指定する必要があります。
有効な条件については、create-manifest サブコマンドで説明しています。
必須: このマニフェスト、スクリプト、またはプロファイルに関連付けられたインストールサービスの名前を指定します。
マニフェストまたは派生したマニフェストスクリプトの AI インスタンス名を指定します。
プロファイルの名前を指定します。任意の数のプロファイルを指定できます。
マニフェスト、スクリプト、またはプロファイルに対する既存のすべての条件の代わりに使用する条件を指定します。後述の「条件」のセクションを参照してください。
マニフェスト、スクリプト、またはプロファイルに対する既存のすべての条件の代わりに使用する条件を含む条件 XML ファイルのパス名を指定します。
マニフェスト、スクリプト、またはプロファイルに対する既存の条件に追加する条件を指定します。後述の「条件」のセクションを参照してください。指定済みの criteria がすでに存在する場合は、その条件の value|list|range が指定された value|list|range で置換されます。
create-service サブコマンドで使用されるデフォルト設定とは異なるカスタムクライアント設定を指定するため、指定されたクライアントの省略可能な設定タスクを実行します。ユーザーは、クライアントにデフォルト以外のサービス名およびブート引数を指定できます。既存のクライアントを変更するために使用することもできます。
次の条件が存在する場合、クライアントは ISC DHCP 構成で構成されます:
クライアントが x86 システムです。
ローカル ISC DHCP 構成が存在します。
all_services/manage_dhcp プロパティー値は true です。
必須: クライアントインストール用のインストールサービスを指定します。
省略可能: x86 クライアント専用。/etc/netboot にあるクライアント固有のブート構成ファイルにプロパティー値を設定します。このオプションを使用して、このクライアントに固有のブートプロパティーを設定します。このオプションには、複数の property=value ペアを指定できます。
必須: クライアントの MAC アドレスを指定します。
create-client サブコマンドを使用して事前に設定された既存のクライアントの特定のサービス情報を削除します。
次の条件が存在する場合、クライアントは ISC DHCP 構成で未構成です:
クライアントが x86 システムです。
ローカル ISC DHCP 構成が存在します。
all_services/manage_dhcp プロパティー値は true です。
必須: 削除するクライアントの MAC アドレスを指定します。
マニフェスト、派生したマニフェストスクリプト、およびプロファイルを使用すると、特定の特性または条件に従って AI クライアントを異なる方法で構成できます。1 つのマニフェストまたはスクリプトのみを特定のクライアントに関連付けることができます。任意の数のプロファイルを特定のクライアントに関連付けることができます。
条件の値は、起動中の AI クライアントによって決定されます。
コマンド行で条件を指定する方法については、「使用例」のセクションを参照してください。条件ファイルの作成については、『Oracle Solaris 11.1 システムのインストール』を参照してください。
|
ipv4、mac、mem、および network の指定は、ハイフン (-) で区切られた範囲値で表現できます。範囲の一端に制限なしを指定するには、unbounded を使用します。
arch、cpu、hostname、platform、および zonename の指定は、スペースで区切られた値の引用符付きリストとして表現されます。
例 1 ISO ファイルから新しい x86 インストールサービスを設定する
インストールサーバーと x86 インストールサービスをはじめて設定します。DHCP サーバーを構成するため、このコマンドには開始 IP アドレスと IP アドレスの総数が含まれます。
$ pfexec installadm create-service -n sol-11_1-i386 \ -s /export/isos/sol-11_1-ai-x86.iso \ -i 172.0.0.10 -c 10 -d /export/images/sol-11_1-i386
AI ISO イメージは /export/isos/sol-11_1-ai-x86.iso にあります。このコマンドは、AI ISO イメージに基づいた /export/images/sol-11_1-i386 にあるネットイメージとインストールサービスを設定します。このネットイメージを使用してクライアントインストールを実行できます。
開始 IP アドレス 172.0.0.10 と 10 個の IP アドレスがローカル ISC DHCP 構成に追加されます。ローカル ISC DHCP 構成が存在しない場合は、ISC DHCP サーバーが起動されます。
これは最初に作成される x86 サービスであるため、default-i386 サービスが自動的に作成され、このサービスに別名が設定されます。別名 default-i386 は稼働しており、PXE 経由でブートされたクライアントは default-i386 サービスからブートおよびインストールします。
例 2 ISO ファイルから新しい SPARC インストールサービスを設定する
SPARC インストールサービスをはじめて設定します。
$ pfexec installadm create-service -n sol-11_1-sparc \ -s /export/isos/sol-11_1-ai-sparc.iso \ -d /export/images/sol-11_1-sparc
AI ISO イメージは /export/isos/sol-11_1-ai-sparc.iso にあります。このコマンドは、AI ISO イメージに基づいた /export/images/sol-11_1-sparc にあるネットイメージとインストールサービスを設定します。このネットイメージを使用してクライアントインストールを実行できます。
これは最初に作成される SPARC サービスであるため、default-sparc サービスが自動的に作成され、このサービスに別名が設定されます。別名 default-sparc は稼働しており、SPARC クライアントは default-sparc サービスからブートおよびインストールします。
例 3 パッケージリポジトリから x86 インストールサービスを設定する
ネットイメージ用のソースを指定しないと、IPS パッケージが使用されます。
$ pfexec installadm create-service -y
このコマンドは、x86 インストールサーバー上で、all_services/default_imagepath_basedir プロパティーの値で指定したイメージの場所のディレクトリに x86 ネットイメージとデフォルトの名前のインストールサービスを設定します。このプロパティーのデフォルト値については、「インストールサーバー構成のプロパティー」を参照してください。-y オプションは、デフォルトの場所を使用できることを確認します。アーキテクチャーが指定されていないため、作成されるサービスはインストールサーバーと同じアーキテクチャーのサービスです。このコマンドでは、インストールサーバーの pkg publisher 一覧にあるパッケージリポジトリに install-image/solaris-auto-install パッケージが含まれることが前提となっています。
このサーバーへの SPARC サービスの作成を指定するには、-a オプションを使用します。
solaris-auto-install パッケージの発行元を指定するには、-p オプションを使用します。たとえば、http://example.company.com:4281 にある ai-image 発行元を solaris-auto-install パッケージの発行元として指定するには、次のコマンドを使用します:
$ pfexec installadm create-service -y \ -p ai-image=http://example.company.com:4281
例 4 クライアントをインストールサービスに関連付ける
クライアントを特定のインストールサービスに関連付けるには、次のサンプルコマンドを使用します。インストールサービスはすでに存在している必要があります。
$ pfexec installadm create-client -b "console=ttya" \ -e 0:e0:81:5d:bf:e0 -n sol-11_1-i386
この例のコマンドは、MAC アドレスが 0:e0:81:5d:bf:e0 であるシステムのためにクライアント固有の設定を作成します。このクライアントは、事前に設定された sol-11_1-i386 という名前のインストールサービスと、そのサービスに関連付けられたネットイメージを使用します。このコマンドは、/etc/netboot にあるクライアント固有のブート構成ファイルにブートプロパティー console=ttya を設定します。
例 5 デフォルトサービスを変更せずに新しいインストールサービスを追加する
sol-11-sparc という名前の新しいサービスを追加するときに、既存のサービスを保持し、既存のデフォルトを変更しないようにするには、次のサンプルコマンドを使用します。
$ pfexec installadm create-service -n sol-11-sparc \ -s /export/isos/sol-11-1111-ai-sparc.iso \ -d /export/ai/sol-11-sparc
例 6 default-i386 サービスを更新する
入手可能な最新のイメージに関連付ける default-i386 別名サービスを更新するには、次のサンプルコマンドを使用します。installadm list コマンドは、コマンドの前および後のサービスを表示します。この例では、更新されたネットイメージパッケージが、default-i386 サービス別名の作成に最初に使用された発行元から使用可能であることを想定しています。
$ installadm list Service Name Alias Of Status Arch Image Path ------------ -------- ------ ---- ---------- default-i386 solaris11-i386 on i386 /export/images/solaris11-i386 solaris11-i386 - on i386 /export/images/solaris11-i386 $ pfexec installadm update-service default-i386 ... Creating new i386 service: solaris11_1-i386 Aliasing default-i386 to solaris11_1-i386 ... ... $ installadm list Service Name Alias Of Status Arch Image Path ------------ -------- ------ ---- ---------- default-i386 solaris11_1-i386 on i386 /export/images/solaris11_1-i386 solaris11-i386 - on i386 /export/images/solaris11-i386 solaris11_1-i386 - on i386 /export/images/solaris11_1-i386
例 7 新しいインストールサービスを追加して default-sparc サービスを更新する
my-sparc-service という名前の新しいサービスを追加するときに、既存のサービスを保持し、新しいサービスを SPARC クライアントのデフォルトにするには、次の 2 つのサンプルコマンドを使用します。
$ pfexec installadm create-service -n solaris11_1-sparc \ -s /export/isos/sol-11_1-ai-sparc.iso \ -d /export/ai/solaris11_1-sparc $ pfexec installadm set-service \ -o aliasof=solaris11_1-sparc default-sparc
例 8 カスタムのデフォルト AI マニフェストをインストールサービスに追加する
新しいマニフェストを sol-11_1-i386 インストールサービスに追加し、それをサービスのデフォルトマニフェストにするには、次のサンプルコマンドを使用します。マニフェストのデータは my_default.xml にあります。以降の installadm コマンドでは、このマニフェストが my_default として参照されます。
$ pfexec installadm create-manifest -d -f my_default.xml \ -m my_default -n sol-11_1-i386
例 9 派生したマニフェストスクリプトをインストールサービスに追加する
my_script という名前の派生したマニフェストスクリプトを solaris11_1-i386 という名前の既存のインストールサービスに追加するには、次のサンプルコマンドを使用します。スクリプトはマニフェストの追加と同じ方法で追加されます。
$ pfexec installadm create-manifest -f my_script.py \ -m my_script -n solaris11_1-i386
派生したマニフェストスクリプトの作成方法については、『Oracle Solaris 11.1 システムのインストール』を参照してください。
例 10 インストールサービスのデフォルト AI マニフェストを置換する
既存のインストールサービス sol-11_1-sparc のデフォルトマニフェストを、custom_manifest としてすでにサービスに追加されているカスタムマニフェストに置換するには、次のサンプルコマンドを使用します。このマニフェストは、create-manifest サブコマンドに -m custom_manifest を指定することによってサービスに追加されました。
$ pfexec installadm set-service \ -o default-manifest=custom_manifest sol-11_1-sparc
例 11 インストールサービスの一覧表示
ローカルサーバー上のインストールサービスを一覧表示するには、次のサンプルコマンドを使用します。
$ installadm list Service Name Alias Of Status Arch Image Path ------------ -------- ------ ---- ---------- default-i386 sol-11_1-i386 on i386 /export/images/sol-11_1-i386 default-sparc sol-11_1-sparc on sparc /export/images/sol-11_1-sparc sol-11_1-i386 - on i386 /export/images/sol-11_1-i386 sol-11_1-sparc - on sparc /export/images/sol-11_1-sparc
例 12 インストールサービスに関連付けられたクライアントを一覧表示する
ローカルサーバー上の特定のインストールサービスのクライアントを一覧表示するには、次のサンプルコマンドを使用します。
$ installadm list -c -n sol-11_1-i386 Service Name Client Address Arch Image Path ------------ -------------- ---- ---------- sol-11_1-i386 01:C2:52:E6:4B:E1 i386 /export/images/sol-11_1-i386
例 13 インストールサービスに関連付けられたマニフェストを一覧表示する
ローカルサーバー上の特定のインストールサービスに関連付けられたマニフェストおよび派生したマニフェストスクリプトを表示するには、次のサンプルコマンドを使用します。
$ installadm list -m -n sol-11_1-sparc Service/Manifest Name Status Criteria --------------------- ------ -------- sol-11_1-sparc mem mem = 4096 MB - unbounded custom_manifest Default (Ignored: mem = 2048 MB - 4095 MB) orig_default Inactive None
この例では、次の出力が表示されます。
条件付きのデフォルト以外のマニフェスト (mem)
無視される条件付きのデフォルトマニフェスト (custom_manifest)
条件がないために非アクティブとマークされているデフォルト以外のマニフェスト (orig_default)
例 14 プロファイルを一覧表示する
ローカルサービス上のすべてのインストールサービスのシステム構成プロファイルを一覧表示するには、次のサンプルコマンドを使用します。
$ installadm list -p Service/Profile Name Criteria -------------------- -------- sol-11_1-i386 sc_all-x86.xml None sol-11_1-sparc sc_all-sparc.xml None sc_network.xml network = 10.0.0.0 ipv4 = 10.0.2.100 - 10.0.2.199
例 15 名前なしのカスタム AI マニフェストをインストールサービスに追加する
MAC アドレスが aa:bb:cc:dd:ee:ff と等しいという条件で /export/my_manifest.xml のマニフェストを sol-11_1-i386 に追加するには、次のサンプルコマンドを使用します。
$ pfexec installadm create-manifest \ -f /export/my_manifest.xml -n sol-11_1-i386 \ -c mac="aa:bb:cc:dd:ee:ff"
この例では、マニフェストに名前属性が含まれないため、マニフェスト名はファイル名から取得されます。
$ installadm list -m -n sol-11_1-i386 Service/Manifest Name Status Criteria --------------------- ------ -------- sol-11_1-i386 my_manifest.xml mac = AA:BB:CC:DD:EE:FF orig_default Default None
例 16 カスタム名付きのカスタム AI マニフェストをインストールサービスに追加する
IPv4 範囲が 10.0.2.100 から 10.0.2.199 までという条件付きで /export/my_manifest.xml のマニフェストを sol-11_1-i386 に追加するには、次のサンプルコマンドを使用します。
$ pfexec installadm create-manifest \ -f /export/my_manifest.xml \ -n sol-11_1-i386 -m custom_name \ -c ipv4="10.0.2.100-10.0.2.199"
この例では、マニフェスト名は -m オプションから取得されます。
$ installadm list -m -n sol-11_1-i386 Service/Manifest Name Status Criteria --------------------- ------ -------- sol-11_1-i386 custom_name ipv4 = 10.0.2.100 - 10.0.2.199 orig_default Default None
例 17 マニフェストに指定された名前付きのカスタム AI マニフェストを追加する
メモリーが 2048M バイト以上あり、アーキテクチャーが i86pc であるという条件付きで /export/manifest3.xml のマニフェストを sol-11_1-i386 に追加するには、次のサンプルコマンドを使用します。
$ pfexec installadm create-manifest \ -f /export/manifest3.xml -n sol-11_1-i386 \ -c mem="2048-unbounded" -c arch=i86pc
この例では、次の部分的なマニフェストで示すように、マニフェスト名はマニフェストの ai_instance 要素の name 属性から取得されます。
<auto_install> <ai_instance name="my_name" /> </auto_install>
$ installadm list -m -n sol-11_1-i386 Service/Manifest Name Status Criteria --------------------- ------ -------- sol-11_1-i386 my_name arch = i86pc mem = 2048 MB - unbounded orig_default Default None
例 18 システム構成プロファイルをインストールサービスに追加する
ホスト名のいずれかが myhost1、host3、または host6 であるという条件付きで /export/profile4.xml のプロファイルを sol-11_1-i386 に追加するには、次のサンプルコマンドを使用します。
$ pfexec installadm create-profile \ -f /export/profile4.xml -n sol-11_1-i386 -p profile4 \ -c hostname="myhost1 host3 host6" $ installadm list -p -n sol-11_1-i386 Service/Profile Name Criteria -------------------- -------- sol-11_1-i386 profile4 hostname = myhost1 host3 host6
例 19 すべてのクライアント用のシステム構成プロファイルを追加する
条件を指定しなかった場合、そのプロファイルは指定されたインストールサービスを使用するすべてのクライアントによって使用されます。次の例では、作成されたプロファイルが sol-11_1-i386 サービスを使用するすべてのクライアントによって使用されます。
$ pfexec installadm create-profile -f /export/locale.xml \ -n sol-11_1-i386 $ installadm list -p -n sol-11_1-i386 Service/Profile Name Criteria -------------------- -------- sol-11_1-i386 profile4.xml hostname = myhost1 host3 host6 locale.xml
例 20 変数を含むシステム構成プロファイルを追加する
プロファイルは、クライアントのインストール時にカスタムクライアント構成情報と置き換えられる変数を使用できます。そのような変数を使用すると、さまざまなシステムでプロファイルファイルを再利用できます。
この例では、1 つのシステム構成プロファイルファイルを使用して、各インストールクライアントに固有のホスト名を割り当てます。hostname.xml ファイルには次の行が含まれます。
<propval name="nodename" value="{{AI_HOSTNAME}}"/>
インストール時に、{{AI_HOSTNAME}} はそのシステムの実際のホスト名に置き換えられます。たとえば、hostname.xml を使用して、ホスト名 myhost1 を持つクライアントを構成するときは、hostname.xml プロファイルには次の行が含まれています:
<propval name="nodename" value="myhost1"/>
プロファイルでの置換タグの使用の詳細は、『Oracle Solaris 11.1 システムのインストール』の「システム構成プロファイルテンプレートの使用」を参照してください。
例 21 条件を既存のマニフェストに追加する
メモリーが 4096M バイト以上あるという条件を sol-11_1-i386 の manifest2 の条件に追加するには、次のサンプルコマンドを使用します。
$ pfexec installadm set-criteria -m manifest2 \ -n sol-11_1-i386 -a mem="4096-unbounded"
例 22 既存のマニフェストに対する条件を置換する
sol-11_1-i386 の manifest2 の条件を /tmp/criteria.xml ファイルに指定された条件で置換するには、次のサンプルコマンドを使用します。
$ pfexec installadm set-criteria -m manifest2 \ -n sol-11_1-i386 -C /tmp/criteria.xml
条件 XML ファイルの内容については、『Oracle Solaris 11.1 システムのインストール』を参照してください。
例 23 開発中のプロファイルファイルを検証する
myprofdir/myprofile.xml および yourprofdir/yourprofile.xml ファイルに格納されたプロファイルを開発中に検証するには、次のサンプルコマンドを使用します。
$ pfexec installadm validate -P myprofdir/myprofile.xml \ -P yourprofdir/yourprofile.xml -n sol-11_1-i386
例 24 プロファイルの内容をエクスポートする
サービス sol-11_1-i386 のプロファイル myprofile.xml をエクスポートするには、次のサンプルコマンドを使用します。
$ installadm export -p myprofile -n sol-11_1-i386
例 25 既存の AI マニフェストの内容を置換する
spec というマニフェスト名 (または AI インスタンス名) を持つサービス sol-11_1-i386 のマニフェストを /home/admin/new_spec.xml ファイルのマニフェストの内容で更新するには、次のサンプルコマンドを使用します。
$ pfexec installadm update-manifest -n sol-11_1-i386 \ -f /home/admin/new_spec.xml -m spec
例 26 既存の AI マニフェストをエクスポートして更新する
サービス sol-11_1-i386 の spec という名前の既存のマニフェストのデータをエクスポートし、そのマニフェストを変更済みの内容で更新するには、次のサンプルコマンドを使用します。
$ pfexec installadm export -n sol-11_1-i386 -m spec \ -o /home/admin/spec.xml
/home/admin/spec.xml を変更します。
$ pfexec installadm update-manifest -n sol-11_1-i386 \ -f /home/admin/spec.xml -m spec
例 27 既存のプロファイルをエクスポートして更新する
サービス sol-11_1-i386 の prof1 という名前の既存のプロファイルのデータをエクスポートし、そのプロファイルを変更済みの内容で更新するには、次のサンプルコマンドを使用します。
$ pfexec installadm export -n sol-11_1-i386 -p prof1 \ -o /home/admin/prof1.xml
/home/admin/prof1.xml を変更します。
$ pfexec installadm update-profile -n sol-11_1-i386 \ -f /home/admin/prof1.xml -p prof1
次の終了ステータスが返されます。
コマンドが正常に処理されました。
エラーが発生した。
無効なコマンド行オプションが指定された。
サービスのバージョンは installadm ではサポートされません。
変更が行われませんでした - 何もしません。
次の属性については、attributes(5) を参照してください。
|
aimanifest(1M), sysconfig(1M), dhcp(5), smf(5), service_bundle(4), ai_manifest(4), environ(5)
『Oracle Solaris 11.1 システムのインストール』のパート III「インストールサーバーを使用したインストール」
『Oracle Solaris 10 JumpStart から Oracle Solaris 11.1 自動インストーラへの移行』