emgr コマンド

オンライン編集

目的

暫定修正 マネージャーを開始します。このマネージャーは、システム暫定修正をインストール、除去、リスト、および検査します。

構文

emgr -l [ -L Label | -n interimfixNumber | -u VUID ] [-v{1|2|3|4} ] [ -X ] [-a path] 
emgr -e interimfixPackage | -f ListFile [-w Directory ] [ -b | -k | -I ] [ -p ] [ -q ] [ -m ] [ -o ] [ -X ] [-a path]
emgr -i interimfixPackage | -f ListFile [ -w Directory ] [ -C ] [ -p ] [ -q ] [ -X ] [ -a path ]
emgr -C -i interimfixPackage | -f ListFile [ -w Directory ] [ -p ] [ -q ] [ -X ] [ -a path ]
emgr -C -L Label [ -p ] [ -q ] [ -X ]
emgr -r -L Label | -n interimfixNumber | -u VUID | -f ListFile [-w Directory ] [-a path] [ -b | -k | -I ] [ -p ] [ -q ] [ -X ]
emgr -c [ -L Label | -n interimfixNumber | -u VUID | -f ListFile ] [ -w Directory ] [-a path] [-v{1|2|3} ] [ -X ]
emgr -M | -U [ -L Label | -n interimfixNumber | -u VUID | -f ListFile ] [ -w Directory ] [-a path] [ -X ]
emgr -R interimfixLabel [ -w Directory ] [-a path] [ -X ]
emgr -P [ Package ] [-a path] [ -X ]
emgr -d -e interimfixPackage | -f ListFile [-w Directory ] [-v{1|2|3} ]

説明

emgr（暫定修正マネージャ）コマンドは、システムの暫定修正をインストールし、管理するために使用することができます。 暫定修正マネージャは、「epkgコマンドで作成されたパッケージをインストールし、暫定修正情報を含むデータベースを管理します。 emgr コマンドは以下の操作を実行します。

  • 暫定修正 パッケージのインストール
  • 暫定修正 の削除
  • 暫定修正 リスト
  • 暫定修正 検査
  • 暫定修正 のマウント
  • 暫定修正 のアンマウント
  • パッケージのロックの表示
  • インストール済み 暫定修正 強制除去
注:
  • 暫定修正マネージャーによってロックされているファイルセットを (「installp、「install_all_updates、または smit 「update_allコマンドを使用して) 更新しようとすると、どのファイルセットがロックされているかを示すメッセージが表示される。 ファイルセットのインストールが阻害された理由を示す通知がないことがある。 lslpp コマンドは、EFIXLOCKED 状態にある、ロックされているすべてのファイルセットを表示します。
  • 暫定的な修正またはサービスの更新によって更新されたライブラリまたは実行可能プログラムであって、アクティブなプロセスで使用中のものは、そのプロセスが再起動されない限り、そのプロセスに反映されません。 たとえば、kshを変更するアップデートは、すでに実行されているkshプロセスに変更を反映させない。 同様に、「libc.aライブラリの更新は、すでに実行中のプロセスには反映されない。 さらに、ライブラリを使用しているプロセスで、ライブラリの更新後に同じライブラリの「dlopen操作を行った場合、再起動しないと不整合が発生する可能性がある。
Ifix の参照

暫定修正 を参照する方法は、以下のとおりです。

ラベルによる参照
特定のシステムにインストールされる各暫定修正プログラムには、固有の暫定修正プログラムラベルがあります。 この中間修正ラベルは、すべての異なるデータベース・オブジェクトを結びつける一意のキーである。 中間修正をラベルで参照するには、「-Lフラグのパラメータとしてラベルを渡す。 たとえば、ラベル「ABC123」の中間フィックスに対してチェック・オペレーションを実行するには、次のように入力する：
emgr -cL ABC123
Ifix ID による参照
特定のシステムにインストールされている各 暫定修正 には、 暫定修正 ID があります。 暫定修正 ID は、単に 暫定修正 が 暫定修正 データベースにリストされている順序番号です。 このオプションは、中間フィックスのリストに基づいて中間フィックスの操作を行う場合に便利です。 emgrコマンドは、中間フィックスIDを中間フィックスラベルに変換してから、指定された操作を実行する。 IDで中間修正を参照するには、「-nフラグのパラメータとしてIDを渡す。
注: Ifix ID は、暫定修正が削除されて追加されるにつれて変更される可能性があります。 -lフラグを使用して、特定の暫定修正プログラムまたはすべての暫定修正プログラムをリストアップし、現在の暫定修正プログラムID番号を常に確認してください。
例えば、ID が 1 の最初の 暫定修正 に対して検査操作を実行するには、次のように入力します。
emgr -cn1
VUID による参照
暫定修正 パッケージはどのエンティティーによっても正式に追跡されないため、同じ 暫定修正 ラベルが複数の 暫定修正 パッケージに使用される可能性があります。 しかし、'emgrコマンドは、同じ暫定修正ラベルを持つ複数の暫定修正を同時にインストールすることを受け付けません。 VUID (仮想的に固有の ID) を使用して、同じ 暫定修正 ラベルを持つパッケージを区別することができます。 emgrコマンドは、指定された操作を実行する前に、VUIDを暫定的なフィックス・ラベルに変換する。 例えば、VUIDが'000775364C00020316020703に等しいインストール済みの暫定修正を一覧表示するには、次のように入力します：
emgr -l -u 000775364C00020316020703
注: VUID は、 暫定修正 のインストールおよび削除のプレビュー・フェーズで表示されます。 VUID は、-v フラグを使用して 詳細レベル 3 でリストする場合も表示されます。
Ifix ロギング

下記の操作は、emgr コマンド・ログ・ファイル /var/adm/ras/emgr.log に記録されます。

  • インストール
  • 除去
  • 検査
  • マウント
  • アンマウント
  • 強制除去
installp による暫定修正の自動削除の有効化

暫定修正は、APAR参照番号を含むAPAR参照ファイルを「epkgコマンドでパッケージ化することができる。 APAR参照番号により、'installpは中間修正を、その修正が出荷されたすべての技術レベルのAPARにマッピングすることができる。 installp、適用される技術レベル、サービスパック、またはPTFに暫定修正が含まれていると判断した場合、「installpアップデートを適用する前に暫定修正を自動的に削除する。

中間修正の自動削除が有効になっている場合、「emgrコマンドは中間修正のインストール中に次のようなメッセージを表示します：

ATTENTION: Interim fix is enabled for automatic removal by installp.
並行更新

emgrコマンドは、コンカレント・アップデートと呼ばれる新しい種類の暫定的な修正プログラムのインストールをサポートします。 この形式の暫定修正は、AIXカーネルまたはそのカーネル拡張の1つに修正を加えるもので、システム・メモリに直接適用できるため、システムを再起動する必要はない。 このようにシステム・メモリに直接パッチを当てることで、ディスク上にあるシステムの現在のカーネルを含むファイルを変更することなく、カーネルの変更を安全に評価・テストすることができる。 -Cフラグを使用して、同時更新によってもたらされた変更をディスクにコミットすることを選択しない限り、システムメモリに適用された同時更新は、システム再起動後も持続しません。 並行更新は、同じモジュールの別のパッチに直接適用することができます。 既存のパッチを除去する必要はありません。 ただし、ロードするモジュールのバージョンは 1 つのみでなければなりません。 また、REBOOT_REQUIRED 状態では暫定修正の並行更新操作 (メモリー内またはディスク上) は、システムがリブートするまで実行できません。

emgrコマンドは、NIMシン・サーバー（ディスクレスまたはデータレス・クライアント）のインメモリー同時更新をサポートする。 シンサーバーはオペレーティングシステムファイルを他のクライアントと共有しているため(/usrディレクトリは読み取り専用)、同時更新をディスクにコミットする(-Cフラグ)オプション'emgrはシンサーバーでは無効である。

注：シンサーバーの共有オペレーティングシステムファイルをディスクにパッチする必要がある場合、シンサーバーにサービスを提供するNIMマスター上のSPOTリソースに暫定的な修正が適用される可能性がある。 SPOTへの中間修正のインストールについては、『インストール・ガイド』の「SPOTリソースへの中間修正のインストール」セクション、またはNIMマスターの「/usr/lpp/bos.sysmgt/nim/READMEファイル（NIM IFIX/EMGRセクション）を参照してください。

/usrファイルシステムはシンサーバーでは読み取り専用なので、'emgrデータベースはシンサーバーの'/var/emgrdataディレクトリに配置される。

bosbootやファイルシステム拡張など、特定の「emgr操作はシンサーバー環境ではサポートできない。 その結果、次の「emgrフラグは、シンサーバー環境ではサポートされない： 「-C、「-e、「-I、「-k、「–X。 また、「–bフラグは、再起動を必要とする暫定的な修正のためにbosbootプロセスをスキップするもので、シンサーバーではbosboot操作がサポートされていないため、該当する場合は常に使用される。

フラグ

項目 説明
-a パス インストールのための代替ディレクトリー・パスを指定します。
注：'-aフラグは、'emgrコマンドの '-eフラグと '-aフラグが、'中間修正 のインストール時に使用された場合にのみ、'中間修正削除時に機能する。 -eおよび '-aフラグを使用して暫定修正をインストールしなかった 場合、'emgrコマンドは代替ディレクトリパスから暫定修正を完全には 削除しない。
回避策として、以下のコマンドを使用して、代替ディレクトリーにインストールされている 暫定修正 を削除します。
chroot /alt_inst /usr/sbin/emgr -r -L efix_label
-b emgrコマンドは、再起動を必要とする暫定的な修正について、通常のAIX'bosbootプロセスをスキップする。
-c 検査操作を指定します。 emgrコマンドに対して、指定された '中間修正または暫定的なフィックスに対するチェック操作を実行するよう指示する。
-C 同時更新を含む暫定的な修正をディスクにコミットする。 このオプションは、'-iオプションとともに使うか、'-iオプションで暫定的な修正を施した後に使う。 これにより、並行更新がシステムのリブート後にも持続します。

同時アップデートがコミットされた後、削除されると、そのモジュールに対する他のパッチが存在するかどうかに関係なく、モジュールは元のパッチ未適用の状態に戻される。 モジュールの既存のパッチはコミットの実行時にすべて除去されます。
-d 目次およびトポロジーを表示します。 このオプションは、'-vフラグとともに冗長性出力を表示するのに便利である。
-e interimfixPackage 暫定修正 パッケージ・ファイルのパスを指定し、 暫定修正 パッケージをインストールします。 中間修正パッケージファイルは「epkgコマンドで作成され、16ビットの圧縮拡張子「.Z」で終わっていなければならない。
-f ListFile 以下のリストのいずれかを含むファイルを指定する：
  • インストール操作に関するパッケージのロケーションのリスト (1 行に 1 つずつ)
  • 除去、マウント、アンマウント、および検査操作の 暫定修正 ラベルのリスト (1 行に 1 つ)
emgr コマンドは、ブランク行または最初の非空白文字が # 文字の行をすべて無視します。
-i interimfixPackage 同時更新を含む暫定修正パッケージファイルのパスを指定し、同時更新をシステムメモリに適用します。 この更新は、-C フラグを使用しない限り、システムのリブート後は持続しません。

-i フラグを使用して、並行更新を同じモジュールの別の更新に適用することもできます。 このような並行更新を「フォローオン」(後続の並行更新) と呼びます。
-I bosbootコマンドの '-Iフラグを使用して、AIX'bosboot用の低レベルデバッガを実行する。
-k bosbootコマンドの '-Dフラグを使用して、AIXの'bosboot中に低レベルデバッガをロードする。
-l emgrコマンドに、指定された '中間修正または中間フィックスに対してリスト操作を実行するよう指示する。
-L ラベル 暫定修正 ラベルによってこの操作の 暫定修正 を選択します。
-m emgr コマンドがマウント・インストールを実行するようにします。 中間修正がマウント・インストールされると、中間修正ファイルはターゲット・ファイルの上にマウントされます。
-M emgrコマンドに、'-mフラグを使ってマウントインストールされた暫定フィックスまたは暫定フィックスをマウントするように指示する。 -Mフラグは、「-mフラグを使用してインストールされ、 「-Uフラグによってアンマウントされるか、システムをリブート するなどの他の手段によってアンマウントされた暫定修正をマウントする ために使用できる。
-n interimfixID 暫定修正 ID を指定して、この操作の 暫定修正 を選択します。
-o 暫定修正 インストール済み環境が既存のパッケージを上書きできることを指定します。
-p emgr コマンドがインストールまたは除去のプレビューを実行するようにします。 プレビューはすべての検査操作で実行されますが、変更は行われません。
-P[パッケージ] パッケージ・ビュー操作を指定します。これにより、 暫定修正 マネージャーによってロックされているすべてのパッケージ、そのインストーラー、およびロック・ラベルが表示されます。
-q エラーおよび重大な警告以外のすべての出力を抑止します。
-r emgrコマンドに、指定された暫定フィックスまたは暫定フィックスの削除を指示する。

アクティブなパッチを除去すると、モジュールに既存のパッチがある場合はそのパッチが復元されます。 事前にパッチが存在しない場合、モジュールは元のパッチ未適用の状態に戻される。
-R ラベル emgr コマンドが強制除去操作を実行するようにします。 This option removes 中間修正 data and package locks associated with the 中間修正 label without removing 中間修正 files, running any remove scripts, or boot processing. このオプションは、一度に1つの中間修正にのみ使用できる。 中間フィックスのラベルは、対象となる中間フィックスを識別するために必要です。
注意:
  • この中間固定除去の方法は、緊急処置と見なされなければならない。 この方法ではターゲット・システムに不整合が発生する可能性があるため、強制削除の方法は、他のすべての中間修正の削除方法が失敗した場合にのみ使用する必要があります。
  • インストールされている暫定修正を削除するには、標準の削除プロセス (-rフラグ) を使用します。 緊急時の手順では、-R フラグを使用してラベルを強制除去することができます。 -R フラグでは、ラベルを除去するために -F フラグが必要です。 -Fフラグと「-Rフラグ（たとえば「emgr -FR ifix_label）を同時に指定した場合、強制削除オプションは中間修正ファイル、保存データ、削除スクリプトの実行を一切削除しません。 このオプションは、標準の除去プロセスが実行できない場合にのみ使用してください。
-u VUID VUIDを指定して、この操作の 暫定修正 を選択します。
-U emgrコマンドに、'-mフラグを使ってマウントインストールされている暫定フィックスまたは暫定フィックスをアンマウントするように指示する。
--v{1|2|3} -v{1|2|3} フラグは、リスト操作の詳細レベル、または検査操作の検査レベルを指定します。 -v4 フラグは、リスト操作のコロン区切りの出力を表示します。 -vフラグの有効レベルは1、2、3、4であり、「-v4フラグは「-lフラグでのみサポートされる。
-w ディレクトリ emgr コマンドがデフォルトの /tmp ディレクトリーの代わりに指定の作業ディレクトリーを使用するようにします。
-X 要求された emgr 操作を実行するのに十分なスペースがないファイルシステムの拡張を試みます。 このオプションは、暫定修正パッケージと'emgrコマンドによって提供される利用可能なスペースとサイズの見積もりに基づいて、ファイルシステムを拡張する。
注:
  1. -X フラグが使用される場合でも、 インストール時に使用可能なディスク・スペースが使い果たされる可能性があります。 インストール時に他のファイルが同じファイルシステム内で作成または拡張されている場合は、 この可能性が高くなります。
  2. リモート・ファイルシステムは、 emgr コマンドを使用して拡張することはできません。

終了状況

0
すべての emgr コマンド操作が正常に完了しました。
>0
エラーが発生しました。

セキュリティー

aix.system.install 権限を持つシステム管理者またはユーザーは、マルチレベル・セキュア (MLS) システムで emgr コマンドを実行できます。 Ifix データ、保存ファイル、および一時ファイルは、root ユーザーのみがアクセス可能です。

権限 aix.system.install.list を持つ非rootユーザーは、現在 efixesインストールされているパッケージを一覧表示するコマンド emgr を実行できます。 非rootユーザーが認証 aix.system.install を持っている場合、インストールや削除を行うことができます efixes。

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 つだけです。

例

  1. games.020303.epkg.Z」という中間修正パッケージのインストールをプレビューするには、以下のコマンドを入力する：
    emgr -p -e games.020303.epkg.Z
  2. games.020303.epkg.Z」と呼ばれる暫定修正パッケージをインストールし、追加のスペースが必要な場合にファイルシステムを自動的に拡張するには、以下のコマンドを入力する：
    emgr -X -e games.020303.epkg.Z
  3. システム上のすべての暫定修正をリストするには、次のコマンドを入力します。
    emgr -l
  4. システム上のすべての暫定修正をコロンで区切ってリストするには、次のコマンドを入力します。
    emgr -l -v4
  5. ラベル「games」を持つ中間修正のレベル3リストを作成するには、以下のコマンドを 入力します：
    emgr -lv3 -L games
  6. ラベル「games」の暫定修正を削除するには、以下のコマンドを入力する：
    emgr -r -L games
  7. ファイル「/tmp/myfixes」の暫定修正ラベルの削除をプレビューするには、以下のコマンドを入力する：
    emgr -rp -f /tmp/myfixes
  8. すべての暫定修正を検査レベル 2 で検査するには、次のコマンドを入力します。
    emgr -cv2
  9. 暫定修正 ID 番号 3 を検査レベル 1 (デフォルトの検査レベル) で検査するには、次のコマンドを入力します。
    emgr -c -n3
  10. VUIDが「000775364C00020316020703」で検証レベルが3の暫定修正をチェックするには、次のコマンドを入力する：
    emgr -u 000775364C00020316020703 -c -v3
  11. ロックされているすべてのパッケージとその 暫定修正 ラベルをリストするには、次のコマンドを入力します。
    emgr -P
  12. installpパッケージ「bos.rte.lvmロックしたすべての中間修正ラベルをリストアップするには、次のコマンドを入力します：
    emgr -P bos.rte.lvm
  13. games.020303.epkg.Z」という中間修正パッケージをマウント・インストールし、AIXの「bosboot抑制するには、以下のコマンドを入力します：
    emgr -e games.020303.epkg.Z -mb
  14. -mオプションを使ってシステムにマウントインストールされているすべての中間修正ファイルをマウントするには、以下のコマンドを入力する：
    emgr -M
  15. 暫定修正ラベル「games」に関連付けられたすべての暫定修正ファイルをアンマウントするには、次のコマンドを入力します：
    emgr -U -L games
  16. kernelmod.031007.epkg.Z」と呼ばれる暫定的な修正パッケージと同時更新をシステムメモリに適用するには、次のコマンドを入力します：
    emgr -i kernelmod.031007.epkg.Z
  17. 暫定修正ラベル「kernelmod」に関連する同時アップデートをディスクにコミットするには、次のコマンドを入力します：
    emgr -C -L kernelmod
  18. kernelmod2.031007.epkg.Z名前の暫定修正パッケージをシステムメモリに同時更新を適用し、同時更新をディスクにコミットするには、次のコマンドを入力します：
    emgr -i kernelmod2.031007.epkg.Z -C
  19. 暫定修正パッケージ「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 参照ファイル・データベースが入っています。