このセクションでは、複数のインストール関連のコマンドに共通するオプションについて説明します。メディエータの設定または設定解除、バリアントまたはファセットの変更、パッケージの修正、およびファイルを元に戻す操作は、パッケージのインストール、更新、またはアンインストールも伴うことがあります。
パッケージをインストール、更新、またはアンインストールした場合に、新しい BE またはバックアップ BE が自動的に作成されることがあります。BE に関するイメージポリシーの制約内で、下に示すオプションを使用して、新しい BE とバックアップ BE の作成を制御できます。新しい BE とバックアップ BE について、および BE に関するイメージポリシーの設定方法については、ブート環境ポリシーイメージのプロパティーを参照してください。
次の BE オプションを使用して、新しい BE またはバックアップ BE を作成するかどうかを強制したり、BE にカスタム名を指定したり、新しい BE をアクティブにしないように指定したりします。これらのオプションは、install、exact-install、uninstall、update、revert、set-mediator、unset-mediator、change-variant、および change-facet サブコマンドで使用できます。
BE が作成される場合に、それを次回ブート時にアクティブ BE として設定しません。
コマンド出力で、新しいブート環境が作成されたことを示すメッセージに注意してください。新しいブート環境を作成してアクティブにすると、--no-be-activate オプションを指定しない場合、その BE が次回のリブート時にデフォルトでブートされます。
pkg コマンドとは別にアクティブ BE を表示および変更するには、beadm(1M) コマンドを使用します。
バックアップ BE を作成しません。
新しい BE が作成されない場合に、バックアップ BE を作成します。このオプションを指定しないと、イメージポリシーに基づいてバックアップ BE が作成されます。バックアップ BE が自動的に作成される状況の説明については、ブート環境ポリシーイメージのプロパティーを参照してください。
バックアップ BE が作成される場合に、デフォルトの名前ではなく、name という名前を付けます。--backup-be-name を使用すると --require-backup-be が暗黙的に指定されます。
新しい BE を作成しません。新しい BE が必要な場合、インストール、更新、アンインストール、または元に戻す操作は実行されません。
新しい BE を作成します。このオプションを指定しないと、イメージポリシーに基づいて BE が作成されます。BE が自動的に作成される状況の説明については、ブート環境ポリシーイメージのプロパティーを参照してください。このオプションを --require-backup-be と組み合わせることはできません。
BE が作成される場合に、デフォルトの名前ではなく、name という名前を付けます。--be-name を使用すると --require-new-be が暗黙的に指定されます。このオプションを使用することは、操作を行うためのもっとも安全な方法です
非大域ゾーンの操作で説明されているように、大域ゾーンで実行されるパッケージのインストール、除去、および更新の一部のみが、非大域ゾーンに自動的に影響します。-r オプションは、大域ゾーンに入力した pkg 操作と同じ操作を非大域ゾーンで実行し、-r を使用しなかった場合に影響を及ぼすよりもさらに多くのパッケージに影響を及ぼすことになります。これらのオプションは、install、uninstall、update、change-variant、および change-facet サブコマンドで使用できます。
この操作を大域ゾーンで実行し、インストール済みの solaris ブランドのすべての非大域ゾーンでも実行します。非大域ゾーンに対する影響は、各非大域ゾーンにログインしてコマンドを直接実行することと似ています。
このオプションを指定せずに pkg コマンドを大域ゾーンで実行すると、非大域ゾーンの操作に記載されているように、非大域ゾーンは大域ゾーンとの互換性を維持するために必要な範囲で変更されます。このオプションを指定すると、pkg 操作は -z および -Z オプションによって制限される場合を除き、インストール済みのすべての非大域ゾーンに適用されます。-z オプションおよび -Z オプションによって除外されたゾーンは、大域ゾーンとの同期を維持するための更新が必要であれば、変更されることもあります。
指定された非大域ゾーンでのみこの操作を実行します。-z オプションは複数回指定できます。-z オプションは、-r オプションと同時に指定した場合のみ使用できます。-z オプションは -Z オプションと一緒に使用できません。
指定されたゾーンを除くすべての非大域ゾーンでこの操作を実行します。-Z オプションは複数回指定できます。-Z オプションは、-r オプションと同時に指定した場合のみ使用できます。-Z オプションは -z オプションと一緒に使用できません。
次のオプションは、大域ゾーンと同時に更新する非大域ゾーンの数を指定します。このオプションは、install、exact-install、uninstall、update、change-variant、および change-facet サブコマンドで使用できます。
n 個までのインストール済みの solaris ブランドの非大域ゾーンを大域ゾーンと並行して更新します。n が 0 または負の数値の場合、すべての非大域ゾーンが大域ゾーンと同時に更新されます。
環境変数 PKG_CONCURRENCY も値 n に設定できます。-C オプションは PKG_CONCURRENCY 設定をオーバーライドします。-C オプションが指定された場合、PKG_CONCURRENCY は無視されます。
パッケージがインストールまたは更新されるとき、指定されたサービスの再開またはリフレッシュなどの SMF サービスアクションがパッケージに指定されることがあります。多数のパッケージを操作している場合、すべてのサービスアクションが終了する前に pkg 操作が終了することがあります。このとき、関連付けられたサービスがまだ利用できないという理由で、新しくインストールされたソフトウェアを使用できない場合があります。
この問題を回避するには、次のいずれかのオプションを使用して、SMF アクチュエータを pkg コマンドと同期させて実行します。これらのオプションは、install、uninstall、update、change-variant、および change-facet サブコマンドで使用できます。
このオプションを指定した場合、pkg コマンドは、pkg が呼び出されたゾーン (大域ゾーンまたは非大域ゾーン) 内ですべての SMF アクチュエータが完了するまで返されません。
このオプションを指定した場合、pkg コマンドは、すべての SMF アクチュエータが完了するか、timeout 期間が終了するか、いずれか短い方が終了するまで返されません。指定された timeout (秒単位) までにアクチュエータが完了しない場合、pkg コマンドは動作を続行し、リターンコード 8 で終了します。
パッケージをインストールまたは更新する前に、ライセンスを受諾することが必要な場合があります。必要なライセンスを表示して受諾するには、次のオプションを使用します。これらのオプションは、install、exact-install、update、fix、change-variant、および change-facet サブコマンドで使用できます。
この操作の一環としてインストールまたは更新されるパッケージのすべてのライセンスを表示するには、--licenses オプションを使用します。この操作を続行するために受諾する必要があるライセンスだけでなく、すべてのパッケージのライセンスが表示されます。続行するために受諾する必要があるライセンスは、--licenses オプションを指定しなくても表示されます。ほかの操作を開始せずにパッケージのライセンスを表示するには、パッケージライセンスの表示に記載されているように pkg list コマンドを使用します。受諾する必要があるライセンスを一覧表示するには、ライセンス要件の表示に記載されているように pkg info コマンドを使用します。
更新またはインストールされるパッケージのライセンス条項に同意することを示す場合は、--accept オプションを使用します。このオプションを指定せず、パッケージのライセンスに同意が必要になった場合、必要なライセンスが表示されてインストール操作は失敗します。
デフォルトでは、パッケージをインストール、更新、またはアンインストールしたときに検索インデックスが更新されます。これらの操作が正しく終了したあとに検索インデックスを更新しない場合は、--no-index オプションを使用します。このオプションを指定すると、多数のパッケージをインストールする場合に、いくらか時間を節約できます。すべてのインストール、更新、およびアンインストール操作を完了したら、pkg refresh を使用して、使用可能なパッケージのリストと、指定された各パブリッシャーのパブリッシャーメタデータを更新できます。パブリッシャーを指定しない場合、すべてのパブリッシャーを対象にリフレッシュが実行されます。このオプションは、install、exact-install、uninstall、および update サブコマンドで使用できます。
--no-refresh オプションを指定した場合、使用可能なパッケージやその他のメタデータの最新のリストを取得するために、イメージのパブリッシャーのリポジトリに接続しません。このオプションは、install、exact-install、および update サブコマンドで使用できます。