installp コマンド

目的

互換性のあるインストール・パッケージ内の使用可能なソフトウェア・プロダクトをインストールします。

構文

適用操作のみによるインストールまたは適用操作とコミット操作によるインストール

installp [ -R path ] [ -a | -a -c [ -N ] ] [ -eLogFile ] [ -V Number ] [ -dDevice ] [ -E ] [ -Y ] [ -b ] [ -S ] [ -B ] [ -D ] [ -I ] [ -p ] [ -Q ] [ -q ] [ -v ] [ -X ] [ -F | -g ] [ -O { [ r ] [ s ] [ u ] } ] [ -t SaveDirectory ] [ -w ] [ -zBlockSize ] { FilesetName [ Level ]... | -f ListFile | all }

適用済み更新パッケージのコミット

installp [ -R path ] -c [ -eLogFile ] [ -VNumber ] [ -b ] [ -g ] [ -p ] [ -v ] [ -X ] [ -O { [ r ] [ s ] [ u ] } ] [ -w ] { FilesetName [ Level ]... | -f ListFile | all }

適用済み更新パッケージのリジェクト

installp [ -R path ] -r [ -eLogFile ] [ -VNumber ] [ -b ] [ -g ] [ -p ] [ -v ] [ -X ] [ -O { [ r ] [ s ] [ u ] } ] [ -w ] { FilesetName [ Level ]... | -f ListFile }

インストール済みソフトウェアのアンインストール (除去)

installp [ -R path ] -u [ -eLogFile ] [ -VNumber ] [ -b ] [ -g ] [ -p ] [ -v ] [ -X ] [ -O { [ r ] [ s ] [ u ] } ] [ -w ] { FilesetName [ Level ]... | -f ListFile }

失敗したインストールのクリーンアップ

installp [ -R path ] -C [ -b ] [ -e LogFile ]

メディア上のすべてのインストール可能ソフトウェアのリスト

installp { -l | -L } [ -eLogFile ] [ -d Device ] [ -B ] [ -I ] [ -q ] [-E ] [ -zBlockSize ] [ -O { [ s ] [ u ] } ]

お客様から指摘され、ソフトウェアにより修正済みのすべての問題点のリストまたはすべての補足情報の表示

installp { -A| -i } [ -eLogFile ] [ -dDevice ] [ -B ] [ -I ] [ -q ] [ -z BlockSize ] [ -O { [ s ] [ u ] } ] { FilesetName [ Level ]... | -f ListFile | all }

適用済みだがコミットされていないインストール済みの更新パッケージのリスト

installp -s [ -e LogFile ] [ -O { [ r ] [ s ] [ u ] } ] [ -w ] { FilesetName [ Level ]... | -fListFile | all }

メディア上のプラットフォーム固有のインストール可能ソフトウェアのリスト

installp { -l | -L } { -M Platform } [ -eLogFile ] [ -d Device ] [ -B ] [ -I ] [ -q ] [ -z BlockSize ] [ -O { [ s ] [ u ] } ]

説明

installp コマンドは、ソフトウェアのインストールと更新を行います。

ファイルセットとは、インストール可能な最下位レベルの基本単位のことです。例えば、bos.net.tcp.client 4.1.0.0 は、1 つのファイルセットです。 ファイルセットの更新は、異なるモディフィケーション・レベルまたは異なる修正レベルのイメージです。例えば、bos.net.tcp.client 4.1.0.2 および bos.net.tcp.client 4.1.1.0 は、 どちらも bos.net.tcp.client 4.1.0.0 に対するファイルセット更新パッケージを表します。

基本レベル (ファイルセット) は、システムにインストールされると自動的にコミットされます。 ファイルセットは、状態 (コミット済み、破壊、適用済み更新パッケージによるコミット済み、コミット済み更新パッケージによるコミット済みなど) と無関係に除去できます。

ファイルセット更新パッケージがシステムに適用されると、その更新パッケージがインストールされます。そのソフトウェアの現行バージョンは、インストール時にディスク上の特殊な保存ディレクトリーに保存されます。 これにより、後で必要に応じてそのバージョンに戻ることができます。 新バージョンのソフトウェア・プロダクトがシステムに適用されると、そのバージョンがそのソフトウェアの現在アクティブなバージョンになります。

システムに適用済みの更新パッケージは、後でコミットすることも、拒否 することもできます。 installp -s コマンドを使用すると、コミットまたは拒否可能な適用済みの更新パッケージ内容のリストが得られます。

-u フラグの指定により基本レベルが除去されると、ソフトウェア・プロダクトの一部であるファイルおよびその更新内容は、システムから除去されます。 そのプロダクトに関するシステム構成情報のクリーンアップもほとんど実行されますが、プロダクトによっては完全にクリーンアップされないこともあります。

-r フラグの指定によりソフトウェア・プロダクトの更新が拒否されると、ソフトウェア・プロダクトの現行のバージョンは更新の直前のバージョンに変更されます。拒否された更新パッケージとその後適用されたすべての更新パッケージの保存ファイルは、システムから除去されます。

システムから除去対象のソフトウェア・プロダクトは、どのような状態でもかまいません。プロダクトの更新パッケージは、適用済み状態でもコミット済み状態でもかまいませんし、これらもまた除去されます。

以前に中断したインストールのために、ソフトウェアが適用済み状態またはコミット済み状態のままになっている場合は、-C フラグを指定してクリーンアップを実行しなければ、 それ以降のインストールをすることはできません。installp -C コマンドは、コマンド・ライン上のソフトウェア・プロダクト名を受け付け、エラーは戻しませんが、 -C フラグを指定すると、必ずすべてのプロダクトをクリーンアップしようとします。 不完全なインストール部分があると、前回完了したインストール部分を除去することによりクリーンアップしようとします。 また、ソフトウェア・プロダクトの以前のバージョンがある場合は、そのバージョンに戻ってそれを現在アクティブなバージョンにしようとします。 これが実行できない場合は、そのソフトウェア・プロダクトには broken というマークが付けられ、ユーザーがこれを使用しようとすると、予測不能な結果が発生することがあります。 したがって、ソフトウェア・プロダクトまたは更新パッケージが破壊した場合には、再度インストールすることをお勧めします。

-t フラグは、更新パッケージにより置き換えられるファイルを保持する保存ディレクトリーの代替位置を指定します。このオプションは、主に次の 2 つの場合に役立ちます。

• 置き換えるファイルを保存するためのローカル・ディスク・スペースは十分あるが、ルート・ファイルシステムおよび /usr ファイルシステムを無制限に拡張したくない場合。

  この場合、代替保存ディレクトリー用に別のファイルシステムを作成することを選択できます。 更新したシステムで満足し、適用済みのすべての更新パッケージをコミットしたときには、保存ファイルシステムを削除することにより、ディスク・スペースを取り戻すことができます。

• 置き換えるファイルを保存するためのローカル・ディスク・スペースが不十分だが、リモート・システムには十分なディスク・スペースがある。この場合、リモート・ファイルシステムからマウントしたディレクトリーを指定できます。

  リモート・ファイルシステムを使用する場合は、できるだけ早く 更新 パッケージをコミットしてください。 -ac フラグを指定して、適用およびコミット操作として インストール処理を開始する場合があります。 適用する際に不要な更新パッケージを拒否したい場合は、 新たにインストールした更新パッケージをできるだけ早く 検査してから、 それをコミットまたは拒否してください。

  代替保管ディレクトリーを使用するときは、以下の事項を考慮してください。

• installp コマンドを呼び出すときは、毎回同じ代替保存位置を使用することを強くお勧めします。
• 適用操作のときに代替保存ディレクトリーを使用する場合は、そのディレクトリーを格納しているファイルシステムがマウントされた状態であることを確認してください。 リブート時に必要なマウントが自動的に行われるようにすることをお勧めします。
• コミット操作時に代替保存ディレクトリーがなくなってしまった場合、コミット操作は行われますが、保存ディレクトリーを削除できないという警告が出ます。 この場合、そのディスク・スペースを取得するためには、使用しない保存ディレクトリーを削除してください。
• 拒否操作時に代替保存ディレクトリーがなくなってしまった場合は、保存済みのファイルがなくなってしまったので拒否操作は行われません。この場合はエラーが発生し、拒否操作はすべて取り消されます。保存ディレクトリーがなくなった理由が一時的な状態 (例えば、ネットワーク上のリモート・ディレクトリーにアクセスできないなど) によるものではない場合は、更新パッケージをコミットするか、 更新パッケージを無制限に適用済み状態にしておく以外に方法はありません。
• システムのバックアップをとる場合、ルート・ボリューム・グループに存在しない代替保存ディレクトリーをバックアップするようにしてください。
• インストール・プロセスによって、リモート保存ディレクトリーを使用するユーザーが保護され、2 つの異なるシステムで同じリモート・ディレクトリーが使用される可能性はなくなります。 ただし、ディレクトリー・パス名には、各ユーザーのシステムを簡単で固有に識別できる名前を使用してください。 例えば、パス名にそのシステムのホスト名を入れる方法があります。
• リモート保存ディレクトリーを使用してシステムの mksysb バックアップを作成し、元のシステムとは異なるシステム上に mksysb イメージを復元しないでください。 この場合、mksysb イメージを使用していくつかの同様なシステムをインストールすると、同じリモート保存ディレクトリーに複数の所有権が発生します。

installp -A コマンドを使用すると、プログラム診断依頼書 (APAR) 番号のリストと、指定されたソフトウェア・パッケージで修正済みの、お客様が報告したすべての問題点の要約が得られます。 installp -i コマンドを使用すると、指定されたソフトウェア・パッケージに入っているファイルの補足情報を表示できます。

指定されたインストール・メディア上のソフトウェア・プロダクトと更新パッケージのすべてをリストするには、installp -l コマンドを使用してください。 installp コマンドを -l フラグと共に指定したときの出力は、次のようになります。

# Fileset Name             Level                    I/U Q Content
#================================================================
  X11.adt.include          4.1.0.0                  I  N usr
#   AIX windows Application Development Toolkit Include F
   
  X11.adt.lib              4.1.0.0                  I  N usr
#   AIX windows Application Development Toolkit Libraries
#
  X11.adt.motif            4.1.0.0                  I  N usr
#    AIX windows Application Development Toolkit Motif
   
#
  X11.adt.bitmaps          4.1.0.0                  I  N usr
#    AIX windows Application Development Toolkit Bitmap Fi
   
#
  X11.adt.ext              4.1.0.0                  I  N usr
#    AIX windows Application Development Toolkit for X Ext
#
  X11.adt.imake            4.1.0.0                  I  N usr
#    AIX windows Application Development Toolkit imake
#
  X11.apps.rte             4.1.0.0                  I  N usr
#    AIX windows Runtime Configuration Applications
#
  X11.apps.msmit           4.1.0.0                  I  N usr
#    AIX windows msmit Application

フィールドの説明は次のとおりです。

installp -s コマンドの出力は、次のようになります。 この出力は、適用済みソフトウェア・ファイルセット更新パッケージと、コミットまたは拒否に使用できる更新パッケージのリストを得るために使用できます。

Installp Status
---------------
Name                       Part    Level                     State
--------------------------------------------------------------------
bos.net.tcp.client         USR     4.1.0.2                   APPLIED
bos.net.tcp.client         ROOT    4.1.0.2                   APPLIED
bos.rte.commands           USR     4.1.0.1                   APPLIED
bos.rte.misc_cmds          USR     4.1.0.1                   APPLIED
bos.rte.tty                USR     4.1.0.1                   APPLIED

フィールドの説明は次のとおりです。

インストール対象のソフトウェア・プロダクトおよび更新パッケージは、次のいずれかの方法で識別できます。

• キーワード all で識別します。このキーワードは指定したインストール・メディアに格納されているすべてのソフトウェアがインストールの対象であることを表します。
• インストール対象のソフトウェアを示すソフトウェア・プロダクトの名前を示します (各ソフトウェア名の後にはオプションでレベルが付きます)。
• -f フラグを、フラグの後にファイル名を付けて指定することにより識別します。 このファイルの各行は、ソフトウェア・プロダクト名の後にオプションでレベルが付くエントリーか、または先頭に # があり無視されるコメント行です。
  注: installp プログラムはファイルを復元する前に、sysck コマンドを使用してファイルを検査します。 sysck コマンドはファイル名に使用されている特殊文字 (~、`、'、¥、"、$、^、&、( )、|、{}、[]、<>、および ?) を認識しません。ファイル名にこれらの特殊文字が使用されている場合、インストールは失敗します。

FilesetName パラメーターは、 ソフトウェア・プロダクト全体を指定するときにも、ソフトウェア・パッケージに入っている個別にインストール可能なファイルセットを指定するときにも使用できます。 例えば、bos.net はソフトウェア・パッケージ名で、そのソフトウェア・パッケージ内に入っている個別にインストール可能なファイルセットは、 bos.net.ncs.client、bos.net.nfs.client、および bos.net.tcp.client です。 FilesetName パラメーターに bos.net を指定すると、リストされているインストール可能なファイルセットがすべてインストールされます。 FilesetName パラメーターに bos.net.tcp.client を指定すると、そのファイルセットだけがインストールされます。

Level パラメーターは、インストールするソフトウェア・プロダクトまたは更新パッケージのレベルを表します。 Level パラメーターの形式は vv.rr.mmmm.ffff で、表す内容は次のとおりです。

インストール・パッケージだけが入っているインストール・メディアからインストール・パッケージをインストールする場合は、レベルを指定する必要はありません。 多くの場合、同じインストール・メディアにレベルの異なる複数のソフトウェア・プロダクトのインストール・パッケージが入っていることはありません。ただし、そのような場合は、FilesetName と共に Level を指定しないと、 installp コマンドは指定されたソフトウェア・プロダクトの最新のソフトウェア・プロダクト・レベルをインストールします。更新パッケージだけが入っているインストール・パッケージまたはインストール・パッケージと更新パッケージの両方が入っているインストール・メディアをインストールする場合は、 Level を指定しないと、指定した FilesetName 用のインストール・メディア上にある、適用可能な更新パッケージがすべてインストールされます。 インストール・パッケージと更新パッケージの両方が入っているインストール・メディアの場合は、 -I フラグか -B フラグを指定することによって、それぞれインストール・パッケージだけか更新パッケージだけをインストールするように要求できます。 インストール・メディアに入っている特定のソフトウェア・プロダクトの一部だけをインストールしたい場合は、 インストールしたい更新パッケージごとに FilesetName と Level の両方を指定しなければなりません。

以下の例を使用して、/usr/sys/inst.images ディレクトリー内に入っている TCP/IP ソフトウェア・プロダクトとその更新パッケージの 1 つをインストールできます。

installp -a -d/usr/sys/inst.images bos.net.tcp.client 4.1.0.0
bos.net.tcp.client 4.1.0.2

installp コマンド出力の最後には、インストールを試みた各ソフトウェア・プロダクトの状態をリストした要約報告があります。一例として、上記の installp コマンドの要約報告を次に示します。

Installp Summary
----------------
Name                    Level        Part        Event        Result
--------------------------------------------------------------------
bos.net.tcp.client      4.1.0.0      USR        APPLY        SUCCESS
bos.net.tcp.client      4.1.0.0      ROOT       APPLY        SUCCESS
bos.net.tcp.client      4.1.0.2      USR        APPLY        SUCCESS

要約報告の値

要約報告は、プロダクト・オプションの名前とプロダクトの一部とを識別します。その他に、要求されたアクション (イベント) とそのアクションの結果が表示されます。

イベント値

要約報告の Event カラムでは、installp コマンドにより要求されたアクションが識別されます。このカラムには次の値が表示されます。

結果の値

要約報告の Result カラムには、要求されたアクションが installp コマンドによって実行された結果が入ります。このフィールドは次の値をとります。

フラグ

package:fileset:v.r.m.f:PTF:type:state:supersede:¥
sup_ptf:sup_state:latest_sup:quiesce:Descr:¥
netls_vendor_id:netls_prod_id:netls_prod_ver:relocatable:build date 

終了状況

installp コマンド出力の最後には、インストールを試みた各ソフトウェア・プロダクトの状態をリストした要約報告があります。インストールできなかったか、インストールに失敗したソフトウェア・プロダクトについては、 インストール処理中に installp コマンドが絶えず表示している詳細情報で原因を突き止めることができます。

セキュリティー

特権制御: このコマンドを実行できるのは、root ユーザーだけです。

監査イベント:

例

1. インストール・カートリッジ・テープに入っているソフトウェア・プロダクトとインストール可能なオプションをすべてリストするには、次のように入力します。

   
   installp -L -d /dev/rmt0.1

2. インストール・テープのソフトウェア・プロダクトで修正されているお客様から報告された問題をすべてリストするには、次のように入力します。

   
   installp -A -d /dev/rmt0.1 all

3. bos.net ソフトウェア・パッケージ (/usr/sys/inst.images ディレクトリー内のパッケージ) 内のすべてのファイルセットをインストール (自動コミット) し、 必要な場合にファイルシステムを拡張するには、次のように入力します。

   
   installp -aX -d/usr/sys/inst.images bos.net

4. 既にシステムにインストールされている NFS ソフトウェア・プロダクト・オプションを同レベルで (テープから) 再インストールしてコミットするには、次のように入力します。

   installp -acF -d/dev/rmt0.1 bos.net.nfs.client 4.1.0.0

5. TCP/IP ソフトウェア・プロダクトのディスケットに含まれる、特定の更新をインストール (適用のみ) するには、次のように入力します。

   installp -a bos.net.tcp.client 4.1.0.2 bos.net.tcp.server 4.1.0.1

6. bos.net.tcp.server というファイルセットを除去するには、次のように入力します。

   installp -u bos.net.tcp.server

7. リモート・ファイルシステム上の代替保存ディレクトリーを BOSNET TCP/IP の更新パッケージ用に -t/temp_space により指定するには、次の例を参照してください。 保存ディレクトリーは /temp_space/My_Hostname/usr/lpp/bos.net/bos.net.nfs.client/4.1.1.0.save になります。

   mount Server_Name:/Save_Area /temp_space
      
   installp -a -t /temp_space/My_Hostname  ¥ 
   bosnet.nfs.client 4.1.1.0

8. installp コマンドのすべての出力をログ・ファイルに取り出すには、script コマンドを次の例のように使用します。 出力は、現行ディレクトリーの typescript ファイルに書き込まれます。

   script
   installp ...
   <Ctrl>d

   または

   installp ... 2>&1 | tee /tmp/inst.out

   第 2 の例では、出力は画面に書き込まれ、コピーが保存されます。
9. installp コマンドを使用して CD から bos.net.tcp.client ファイルセットのインストールをプレビューするには、次のように入力します。

    installp -pacgXd /dev/cd0 bos.net.tcp.client

10. /usr/sys/inst.images というファイルに格納されている TCP/IP ソフトウェア・プロダクトおよびその更新パッケージのいずれかをインストールするには、installp コマンドを以下の例のように使用します。

    installp コマンドの出力の最後には、インストールを試みた各ソフトウェア・プロダクトの状態をリストした要約報告があります。 一例として、上記の installp コマンドの要約報告を次に示します。

    Installp Summary
    ----------------
    Name                 Level        Part       Event        Result
    -----------------------------------------------------------------
    bos.net.tcp.client   4.1.0.0      USR        APPLY        SUCCESS
    bos.net.tcp.client   4.1.0.0      ROOT       APPLY        SUCCESS
    bos.net.tcp.client   4.1.0.2      USR        APPLY        SUCCESS

    注: この要約も、次に installp コマンドが呼び出されるまで /var/adm/sw/installp.summary というファイルに保存されます。 /usr/include ディレクトリー内の inuerr.h というヘッダー・ファイルには、 installp.summary ファイル内のレコードを構成するフィールドが説明されています。
11. /usr/sys/inst.images にあるソフトウェア・プロダクトのうち、 POWER プロセッサー・ベース マシンにインストール可能なソフトウェア・プロダクトのリストを取得するには、以下のように入力します。

    installp -l -MR -d /usr/sys/inst.images

12. CD にあるファイルセットのうち、現在システムにインストールされているファイルセットのすべてを更新するには、以下のように入力します。

    lslpp -lc | awk -F ":" '{print $2}' | tail -n +2 > /tmp/lslpp
    installp -agXd /dev/cd0 -e /tmp/install.log -f /tmp/lslpp

    ここで、-e は、出力を /tmp/install.log ファイルに記録します。

ファイル