emgr コマンド
目的
暫定修正 マネージャーを開始します。このマネージャーは、システム暫定修正をインストール、除去、リスト、および検査します。
構文
emgr -l [ -L ラベル | -n interimfixNumber | -u VUID ] [-v{1|2|3}] [ -X ] [-a path]
Emgr -e (E) interimfixPackage | 「-f」 ListFile [-W (C) ディレクトリー ] [ -b (B) | -K (K) | -I (I) ] [ --p ] [ -Q (Q) ] [ -m (M) ] [ -o (O) ] [ -X (X) ] [-a パス]
emgr -i interimfixPackage | -f ListFile [ -w Directory ] [ -C ] [ -p ] [ -q ] [ -X ] [ -a path
Emgr -C (C) I interimfixPackage | 「-f」 ListFile [ -W (C) ディレクトリー ] [ --p ] [ -Q (Q) ] [ -X (X) ] [ アザ パス ]
emgr -C -L ラベル [ -p ] [ -q ] [ -X ]
emgr -r -L Label | -n interimfixNumber | -u VUID | -f ListFile [-w Directory ] [-a path] [ -b | -k | -I ] [ -p ] [ -q ] [ -X ]
Emgr - [ -L (L) 表示名 | 「-n」 interimfixNumber | -u (U) VUID | 「-f」 ListFile ] [ -W (C) ディレクトリー ] [-a パス] [-V (R){1|2|3} ] [ -X (X) ]
emgr -M | -U [ -L Label | -n interimfixNumber | -u VUID | -f ListFile ] [ -w Directory ] [-a パス] [ -X ]
emgr -R interimfixLabel [ -w Directory ] [-a path] [ -X ]
emgr -P [ パッケージ ] [-a path] [ -X ]
emgr -d -e interimfixPackage | -f ListFile [-w Directory ] [-v{1|2|3}]
説明
マネージャー (暫定修正 マネージャー) コマンドを使用して、システム暫定修正をインストールおよび管理することができます。 暫定修正 マネージャーは、 Epkg コマンドを使用して作成されたパッケージをインストールし、 暫定修正 情報を含むデータベースを保守します。 emgr コマンドは以下の操作を実行します。
- 暫定修正 パッケージのインストール
- 暫定修正 の削除
- 暫定修正 リスト
- 暫定修正 検査
- 暫定修正 のマウント
- 暫定修正 のアンマウント
- パッケージのロックの表示
- インストール済み 暫定修正 強制除去
- 暫定修正 マネージャーによってロックされているファイルセットを ( installp、 install_all_updates、または smit update_all コマンドを使用して) 更新しようとすると、どのファイルセットがロックされているかを示す通知が表示されます。 場合によっては、ファイルセットがインストールされなかった理由を示す通知がありません。 lslpp コマンドは、EFIXLOCKED 状態にある、ロックされているすべてのファイルセットを表示します。
- アクティブなプロセスで使用されている暫定修正またはサービス更新で更新されたライブラリーまたは実行可能プログラムは、再始動しないとそのプロセスには反映されません。 例えば、ksh を変更する更新では、既に実行されている ksh プロセスにはその変更が反映されません。 同様に、libc.a ライブラリーへの更新は、既に実行されているプロセスには反映されません。 また、ライブラリーの更新後にそのライブラリーと同一ライブラリーの dlopen 操作を使用するプロセスでは、再始動しないと不整合が発生する可能性があります。
Ifix の参照
暫定修正 を参照する方法は、以下のとおりです。
- ラベルによる参照
- 特定のシステムにインストールされている各 暫定修正 には、固有の 暫定修正 ラベルが付けられます。 これは、
すべての異なるデータベース・オブジェクトをバインドする固有なキーです。 ラベルによって 暫定修正 を参照するには、そのラベルをパラメーターとして -L (L) フラグに渡します。 例えば、ラベル ABC123の 暫定修正 に対して検査操作を実行するには、次のように入力します。
emgr -cL ABC123
- Ifix ID による参照
- 特定のシステムにインストールされている各 暫定修正 には、 暫定修正 ID があります。 暫定修正 ID は、単に 暫定修正 が 暫定修正 データベースにリストされている順序番号です。 暫定修正 リストに基づいて暫定修正の操作を実行する場合は、このオプションを使用すると便利な場合があります。 マネージャー コマンドは、指定された操作を実行する前に、 暫定修正 ID を 暫定修正 ラベルに変換します。 暫定修正 を ID で参照するには、その ID をパラメーターとして N フラグに渡します。注: Ifix ID は、暫定修正が削除されて追加されるにつれて変更される可能性があります。 特定の 暫定修正 またはすべての暫定修正をリストするには、常に - フラグを使用して現在の 暫定修正 ID 番号を確認してください。例えば、ID が 1 の最初の 暫定修正 に対して検査操作を実行するには、次のように入力します。
emgr -cn1
- VUID による参照
- 暫定修正 パッケージはどのエンティティーによっても正式に追跡されないため、同じ 暫定修正 ラベルが複数の 暫定修正 パッケージに使用される可能性があります。 ただし、 マネージャー コマンドは、同じ 暫定修正 ラベルを持つ複数の 暫定修正 のインストールを同時に受け入れることはできません。 VUID (仮想的に固有の ID) を使用して、同じ 暫定修正 ラベルを持つパッケージを区別することができます。 マネージャー コマンドは、指定された操作を実行する前に、VUID を 暫定修正 ラベルに変換します。 例えば、VUID が 000775364C00020316020703であるインストール済み 暫定修正 をリストするには、次のように入力します。
emgr -l -u 000775364C00020316020703
注: VUID は、 暫定修正 のインストールおよび削除のプレビュー・フェーズで表示されます。 VUID は、-v フラグを使用して 詳細レベル 3 でリストする場合も表示されます。
Ifix ロギング
下記の操作は、emgr コマンド・ログ・ファイル /var/adm/ras/emgr.log に記録されます。
- インストール
- 除去
- 検査
- マウント
- アンマウント
- 強制除去
installp による暫定修正の自動除去
暫定修正は epkg コマンドで圧縮することができ、そこには APAR 参照番号を含む APAR 参照ファイルを入れることができます。 APAR 参照番号を使用することにより、修正が出荷されたすべてのテクノロジー・レベルについて、installp は暫定修正から APAR にマップし直すことができます。 適用されるテクノロジー・レベル、Service Pack、あるいは PTF にこの暫定修正が含まれていると installp が判断した場合には、installp は更新を適用するまえにこの暫定修正を自動的に除去します。
暫定修正が自動除去の対象となった場合、emgr コマンドはこの暫定修正のインストール時に以下のメッセージを表示します。
ATTENTION: Interim fix is enabled for automatic removal by installp.
並行更新
マネージャー コマンドは、並行更新と呼ばれる新しい種類の 暫定修正 のインストールをサポートします。 この形式の 暫定修正 には、 AIX® カーネル、またはそのカーネル・エクステンションの 1 つに対する変更が含まれています。これは、システム・メモリーに直接適用することができ、システムをリブートする必要はありません。 このようにシステム・メモリーに直接パッチを適用することで、ディスク上のシステムの現行カーネルを含むファイルを変更せずに、カーネルの変更を安全に評価してテストすることができます。 システム・メモリーに適用された並行更新は、システムをリブートすると持続しません。ただし、-C フラグを使用してディスクに対する並行更新による変更をコミットする場合を除きます。 並行更新は、同じモジュールの別のパッチに直接適用することができます。 既存のパッチを除去する必要はありません。 ただし、ロードするモジュールのバージョンは 1 つのみでなければなりません。 また、REBOOT_REQUIRED 状態では暫定修正の並行更新操作 (メモリー内またはディスク上) は、システムがリブートするまで実行できません。
emgr コマンドは、NIM シン・サーバー (ディスクレス・クライアントまたはデータレス・クライアント) での メモリー内並行更新の適用をサポートしています。 シン・サーバーは他のクライアントとオペレーティング・システム・ファイルを共有するため (/usr ディレクトリーは読み取り専用)、ディスクへの並行更新をコミットする マネージャー オプション (-C フラグ) はシン・サーバーでは無効です。
シン・サーバーでは /usr ファイルシステムが読み取り専用であるため、emgr データベースは /var/emgrdata ディレクトリーに配置されることになります。
ある種の emgr 操作 (bosboot およびファイルシステム拡張など) は、シン・サーバー環境では サポートできません。 その結果、-C、-e、-I、-k、 および –X の各 emgr フラグは、シン・サーバー環境では サポートされません。 また、シン・サーバーの場合は bosboot 操作をサポートできないため、 –b フラグ (リブートを必要とする暫定修正に対応した bosboot プロセスをスキップ) は、 利用可能なときはいつも使用されることになります。
フラグ
項目 | 説明 |
---|---|
-a 値 パス | インストールのための代替ディレクトリー・パスを指定します。 注: -a 値 フラグは、 暫定修正のインストール時に マネージャー コマンドの -e (E) フラグと -a 値 フラグが使用された場合にのみ、 暫定修正 の削除時に機能します。 暫定修正 が -e (E) フラグおよび -a 値 フラグを使用してインストールされていない場合、 マネージャー コマンドは代替ディレクトリー・パスから暫定修正を完全には削除しません。
回避策として、以下のコマンドを使用して、代替ディレクトリーにインストールされている 暫定修正 を削除します。
|
-b | マネージャー コマンドが、リブートが必要な暫定修正の通常の AIX ボスブート プロセスをスキップするようにします。 |
-c | 検査操作を指定します。 指定された 暫定修正 またはインテリム・フィックスに対して検査操作を実行するように マネージャー コマンドに指示します。 |
-C | ディスクに対する並行更新を含む 暫定修正 をコミットします。 このオプションは、 I オプションと一緒に使用する必要があります。また、 I オプションを指定して 暫定修正 を適用した後に使用することもできます。 これにより、並行更新がシステムのリブート後にも持続します。 並行更新がコミットされると、モジュールに他のパッチがあるかどうかにかかわらず、除去することでモジュールがパッチを適用していない元の状態に復元されます。 モジュールの既存のパッチはコミットの実行時にすべて除去されます。 |
-d | 目次およびトポロジーを表示します。 このオプションは、詳細出力を表示する際に -v フラグと一緒に使用すると便利です。 |
-e interimfixPackage | 暫定修正 パッケージ・ファイルのパスを指定し、 暫定修正 パッケージをインストールします。 暫定修正 パッケージ・ファイルは、 Epkg コマンドを使用して作成する必要があり、末尾は 16 ビット圧縮拡張子 .Z (自動車)でなければなりません。 |
-f ListFile | 以下のいずれかを含むファイルを指定します。
|
-i interimfixPackage | 並行更新を含む 暫定修正 パッケージ・ファイルのパスを指定し、その並行更新をシステム・メモリーに適用します。 この更新は、-C フラグを使用しない限り、システムのリブート後は持続しません。 -i フラグを使用して、並行更新を同じモジュールの別の更新に適用することもできます。 このような並行更新を「フォローオン」(後続の並行更新) と呼びます。 |
-I | ボスブート コマンドの -I (I) フラグを使用して、 AIX ボスブート の低レベル・デバッガーを実行します。 |
-k | ボスブート コマンドの -D フラグを使用して、 AIX ボスブート 中に低レベル・デバッガーをロードします。 |
-l | 指定された 暫定修正 またはインテリム・フィックスに対してリスト操作を実行するように マネージャー コマンドに指示します。 |
-L ラベル | 暫定修正 ラベルによってこの操作の 暫定修正 を選択します。 |
-m | emgr コマンドがマウント・インストールを実行するようにします。 暫定修正 がマウント・インストールされている場合、 暫定修正 ファイルはターゲット・ファイルにマウントされます。 |
-M | -m (M) フラグを使用してマウント・インストールされた 暫定修正 または暫定修正をマウントするように マネージャー コマンドに指示します。 -M (M) フラグを使用すると、 -m (M) フラグを使用してインストールされ、 -U (U) フラグによって、またはその他の何らかの方法 (システムのリブートなど) でアンマウントされた 暫定修正 をマウントすることができます。 |
-n interimfixID | 暫定修正 ID を指定して、この操作の 暫定修正 を選択します。 |
-o | 暫定修正 インストール済み環境が既存のパッケージを上書きできることを指定します。 |
-p | emgr コマンドがインストールまたは除去のプレビューを実行するようにします。 プレビューはすべての検査操作で実行されますが、変更は行われません。 |
-P [ パッケージ ] | パッケージ・ビュー操作を指定します。これにより、 暫定修正 マネージャーによってロックされているすべてのパッケージ、そのインストーラー、およびロック・ラベルが表示されます。 |
-q | エラーおよび重大な警告以外のすべての出力を抑止します。 |
-r | 指定された 暫定修正 または暫定修正に対して除去操作を実行するように マネージャー コマンドに指示します。 アクティブなパッチを除去すると、モジュールに既存のパッチがある場合はそのパッチが復元されます。 既存のパッチがない場合は、モジュールがパッチを適用していない元の状態に復元されます。 |
-R ラベル | emgr コマンドが強制除去操作を実行するようにします。 このオプションは、 暫定修正 ラベルに関連した 暫定修正 データ・ロックおよびパッケージ・ロックを、実際に 暫定修正 ファイルを除去したり、除去スクリプトを実行したり、またはブート処理を実行したりすることなく除去します。 このオプションは、一度に 1 つの 暫定修正 に対してのみ使用できます。 暫定修正 ラベルは、ターゲット 暫定修正を識別するために必要です。 注意:
|
-u VUID | VUIDを指定して、この操作の 暫定修正 を選択します。 |
-U | -m (M) フラグを使用してマウント・インストールされた 暫定修正 または暫定修正をアンマウントするように マネージャー コマンドに指示します。 |
-v{1|2|3} | リスト操作の詳細レベルまたは検査操作の検査レベルを指定します。 有効なレベルは 1、2、および 3 です。 |
-w ディレクトリー | emgr コマンドがデフォルトの /tmp ディレクトリーの代わりに指定の作業ディレクトリーを使用するようにします。 |
-X | 要求された emgr
操作を実行するのに十分なスペースがないファイルシステムの拡張を試みます。 このオプションは、 暫定修正 パッケージおよび マネージャー コマンドによって提供される使用可能なスペースおよびサイズの見積もりに基づいてファイル・システムを拡張します。 注:
|
終了状況
- 0
- すべての emgr コマンド操作が正常に完了しました。
- >0
- エラーが発生しました。
セキュリティー
aix.system.install 権限を持つシステム管理者またはユーザーは、マルチレベル・セキュア (MLS) システムで emgr コマンドを実行できます。 Ifix データ、保存ファイル、および一時ファイルは、root ユーザーのみがアクセス可能です。
emgr コマンドは、システムから、サポートされる MD5 生成コマンドを探します。 見つかると、emgr コマンドは MD5 チェックサムをユーザーに表示します。 ユーザーは、この MD5 合計を、保護されたソースとクロスチェックすることができます。 MD5 生成コマンドが見つからない場合は、emgr コマンドはその後の 処置をとりません。
ユーザーは、EMGR_MD5_CMD シェル変数をエクスポートすることによって MD5 コマンドへのパスを強制的に設定できます。 この変数には、MD5 生成コマンドへの絶対パスが入っている必要があります。
- この機能は、 暫定修正 管理の元のリリースではサポートされていません。 bos.rte.install を最新レベルに更新することによって、ユーザーが最新レベルの 暫定修正 管理に更新することをお勧めします。
Trusted Execution (TE) ポリシーが
TSD_LOCK
ポリシーまたはTSD_FILE_LOCK
ポリシーと一緒にオンになっていると、emgr コマンドは失敗します。 インストールを続行するには、TSD_LOCK
ポリシーまたはTSD_FILE_LOCK
ポリシーをオフにしてください。 emgr コマンドは、TSD_LOCK
ポリシーまたはTSD_FILE_LOCK
ポリシー以外の TE ポリシーを使用して正常に実行されます。また、TE ポリシーがオンになっていると、サポートされる emgr コマンドのインスタンスは 1 つだけです。
例
- games.020303.epkg.Zと呼ばれる 暫定修正 パッケージのインストールをプレビューするには、次のように入力します。
emgr -p -e games.020303.epkg.Z
- games.020303.epkg.Z と呼ばれる 暫定修正 パッケージをインストールし、追加スペースが必要な場合にファイルシステムを自動的に拡張するには、次のように入力します。
emgr -X -e games.020303.epkg.Z
- システム上のすべての暫定修正をリストするには、次のように入力します。
emgr -l
- 暫定修正 ラベル ・ゲームのレベル 3 のリストを作成するには、次のように入力します。
emgr -lv3 -L games
- ラベルが 「ゲーム」の 暫定修正 を削除するには、次のように入力します。
emgr -r -L games
- ファイル /tmp/myfixes内の 暫定修正 ラベルの除去をプレビューするには、次のように入力します。
emgr -rp -f /tmp/myfixes
- 検査レベル 2 ですべての暫定修正を検査するには、次のように入力します。
emgr -cv2
- 暫定修正 ID 番号 3 を検査レベル 1 (デフォルトの検査レベル) で検査するには、次のように入力します。
emgr -c -n3
- VUID が 000775364C00020316020703 で検証レベルが 3 の 暫定修正 を確認するには、次のように入力します。
emgr -u 000775364C00020316020703 -c -v3
- ロックされているすべてのパッケージとその 暫定修正 ラベルをリストするには、次のように入力します。
emgr -P
- installp パッケージ bos.rte.lvmをロックしたすべての 暫定修正 ラベルをリストするには、次のように入力します。
emgr -P bos.rte.lvm
- games.020303.epkg.Z という 暫定修正 パッケージをマウント・インストールし、 AIX bosbootを抑止するには、次のように入力します。
emgr -e games.020303.epkg.Z -mb
- -m オプションを使用してシステムにマウント・インストールされたすべての 暫定修正 ファイルをマウントするには、次のように入力します。
emgr -M
- 暫定修正 ラベル ゲームに関連付けられているすべての 暫定修正 ファイルをアンマウントするには、次のように入力します。
emgr -U -L games
- システム・メモリーに対する並行更新を含む kernelmod.031007.epkg.Z という 暫定修正 パッケージを適用するには、次のように入力します。
emgr -i kernelmod.031007.epkg.Z
- 暫定修正 ラベル kernelmod に関連付けられた並行更新をディスクにコミットするには、次のように入力します。
emgr -C -L kernelmod
- システム・メモリーに対する並行更新を含む kernelmod2.031007.epkg.Z という 暫定修正 パッケージを適用し、ディスクに対する並行更新をコミットするには、次のように入力します。
emgr -i kernelmod2.031007.epkg.Z -C
- 暫定修正 パッケージ test.102403.epkg.Zのレベル 3 の冗長出力を表示するには、次のように入力します。
emgr -v3 -d test.102403.epkg.Z
ファイル
項目 | 説明 |
---|---|
/usr/sbin/emgr | emgr コマンドが入っています。 |
/usr/emgrdata/DBS/ifix.db | 暫定修正 ヘッダー・データベースが入っています。 |
/usr/emgrdata/DBS/files.db | 暫定修正 ファイル・データベースが入っています。 |
/usr/emgrdata/DBS/pkglck.db | パッケージ・ロック・データベースが入っています。 |
/usr/emgrdata/DBS/prereq.db | 前提条件データベースが入っています。 |
/usr/emgrdata/DBS/e2eprereq.db | 暫定修正 前提条件データベースが含まれています。 |
/usr/emgrdata/DBS/aparref.db | APAR 参照ファイル・データベースが入っています。 |