swremove(1M)

ルート、ホスト、テンプレートのアクセス制御リスト (ACL) を設定し、コントローラーシステムからのルートアクセスを許可します。 許可するには、それぞれのリモートシステムで次のコマンドを実行します。

/usr/lib/sw/mx/setaccess controller

注記:

swinstall、swcopy および swremove は、リモート操作のための拡張 GUI インタフェースを用意してます。 コントローラーで .sdkey ファイルを作成して、リモート操作用の GUI インタフェースを使用可能にします。これには、次のコマンドを使用します。

touch /var/adm/sw/.sdkey

各 target_selection の解析時に実行されるスクリプトで、削除を正しく実行できるかどうかを チェックします。このチェックで問題が見つかった場合、ソフトウェア製品は削除されません。

ソフトウェアのファイルが削除される直前に実行されるスクリプトです。

ソフトウェアのファイルが削除された直後に実行されるスクリプトです。

各 target_selection の構成解除時に実行されるスクリプトで、そのソフトウェア対応のホスト構成を解除します (また、そのホスト対応のソフトウェア構成を解除します)。 preremove および postremove スクリプトは構成解除タスクに使用することを目的とはしていません。 これらのスクリプトは、インストール時に移動されたファイルを 元に戻すなどの単純なファイル管理を実行するために使用するものです。unconfigure スクリプトにより、swremove コマンドは、指定されたソフトウェアを削除する前に、そのソフトウェアが動作していたホストを構成解除することができます。

swremove コマンドは、GUI の表示形式を制御する標準 X ツールキットオプションの一部をサポートしています。サポートしているオプションは、-bg、
-background、-fg、-foreground、-display、-name、
-xrm および -synchronous です。これらのオプションの定義については、X(1) マンページを参照してください。

インストール済みソフトウェアではなく、デポを操作対象とします。

コマンドが代替ルートディレクトリで動作するようになります。代替ルートディレクトリは、
@ target_selections オプションで指定する必要があります。構成解除スクリプトは、削除するソフトウェアが代替ルートディレクトリにある場合、実行されません。 (代替ルート操作にはこのオプションは必須ではありませんが、旧製品との互換性のために維持されています。詳細については、sd(5) の『代替ルートディレクトリとデポディレクトリ\c』 の項を参照してください。)

コマンドを対話型モード (グラフィカルユーザーインタフェース) で実行します。 詳細については、前述の『対話型操作\c』 および『リモート操作\c』 の項を参照してください。

削除タスクをプレビューします。すなわち、セッションを解析フェーズだけ実行します。

標準出力 (stdout) への出力を冗長形式にします (swremove のログファイルは、このオプションの影響を受けません)。冗長出力はデフォルトの verbose=x で制御されます。

現在のオプションとオペランドを session_file に保存します。ファイル名には相対パスおよび絶対パスを指定することができます。セッションファイルのデフォルトのディレクトリは、$HOME/.sw/sessions/ です。-S オプションを使用して、セッションファイルを再び呼び出すことができます。

software_selections のリストを、コマンド行からではなく (あるいは コマンド行からだけでなく)、software_file から (も) 読み取ります。

前にスケジュールされたジョブを実行します。これは、デーモンがジョブを起動するときに使用する構文です。

指定された日付にジョブをスケジュールします。 ファイル /var/adm/sw/getdate.templ を編集して、日付形式を変更することができます。

session_file での定義に従って、前のセッションで保存された オプションとオペランドに基づいて swremove を実行します。 -C オプションを使用して、セッション情報をファイルに保存することができます。

target_selections のリストを、コマンド行からではなく (あるいは コマンド行からだけでなく)、target_file から (も) 読み取ります。

セッションの option の値として value を設定し、デフォルト値 (または -X オプションで指定された代替の option_file の中の値) を無効にします。複数の -x オプションを指定できます。

セッションのオプションと動作を option_file から読み取ります。

システム全体のデフォルト値

ユーザー固有のデフォルト値

インストール済みのソフトウェアカタログの SD ログファイルとデフォルトの親ディレクトリの位置を指定します。標準の SD 操作でのデフォルト値は /var/adm/sw です。SD を非特権モードで操作する場合 (run_as_superuser デフォルトオプションを true に設定) は、次のようになります。

SD の非特権モードは、設計とパッケージ化が特別に行われるアプリケーションを管理するときにのみ使用するためのものです。 HP-UX オペレーティングシステムまたはそのパッチの管理には、このモードを使用できません。非特権の SD の詳細については、http://docs.hp.com/ja にある『 Software Distributor 管理者ガイド』 を参照してください。

installed_software_catalog および run_as_superuser オプションも併せて参照してください。

実行フェーズの終了後、または解析フェーズの異常終了後に、ターゲットエージェントを自動的に終了させます。 このオプションは、コントローラーが対話型ユーザーインタフェースを使用している場合、または -p (プレビュー) を使用している場合は、強制的に false に設定されます。これにより、ネットワークの信頼性とパフォーマンスが向上します。 デフォルトは true です (すなわち、上記の条件の場合、ターゲットエージェントは自動的に終了します) 。 false に設定すると、ターゲットエージェントは コントローラーがセッションを終了するまで終了しません。

ターゲットエージェントが指定された時間中アクティブでない場合に、そのターゲットエージェントを終了させます。 これは、RPC が消失したネットワーク接続を検知するのに 130 分間かかる場合があるので、 ターゲットエージェントがより速く消失したネットワーク接続を検知できるようにするために使用されます。 お薦めできる値は、使用環境で予測されるアクティブでない最長の期間です。 コマンド行の呼び出しの場合、10 分から 60 分の間の値が適切です。GUI が使用される場合には、60 分以上の値をお薦めします。 デフォルト値の 10000 は、7 日間よりもわずかに短い期間です。

「親が同じ」ファイルセットのない単一パッチファイルセットを使用できるようにします。デフォルト状態である false では、マルチファイルセットパッチから １ つのファイルセットを削除すると、ターゲットファイルセットの祖先のファイルセットに基づいて、 パッチに含まれる他のファイルセットが自動的に操作の対象になります (この動作は、ユーザーが直接選択したファイルセットおよび SD がソフトウェアの依存関係から自動選択したファイルセットに適用されます)。

true に設定すると、親が同じファイルセットを含めないで、１ つのパッチファイルセットを削除できます。 これにより、一部の構成要素であるファイルセットに「分割」したパッチをターゲットに含めることができます。 警告: パッチを分割すると、親が同じグループの １ つのファイルセットを削除しても、同時に削除すべき他のファイルセットが残ることがあります。

通常、true に設定します。カーネルファイルセットを削除する際、カーネルの再生成を行うかどうかを指定します。 カーネルの再生成が正しく行われた場合、システムは自動的に再ブートします。false に設定した場合、システムは現在のカーネルの実行を継続します。

auto_kernel_build オプションを true に設定した場合、autoreboot オプションも true に設定しなければなりません。auto_kernel_build オプションを false に設定した場合、autoreboot オプションの値は無視されます。

非対話型インタフェースからの再ブートを必要とするソフトウェアの削除を禁止します。true に設定された場合、このソフトウェアは削除することができ、ターゲットシステムは自動的に再ブートされます。

対話型セッションは、再ブートを必要とするソフトウェアを削除する際には必ず確認を要求します。

auto_kernel_build オプションが true に設定された場合、autoreboot オプションも true に設定しなければなりません。auto_kernel_build オプションが false に設定された場合、autoreboot オプションの値は無視されます。

このオプションは、ジョブの自動削除を制御します。ジョブが自動的に削除されると、ジョブ情報 (ジョブステータスや コントローラー/エージェントのログファイル) を swjob で照会することはできなくなります。

指定されたソフトウェアに依存するすべてのソフトウェアを自動的に選択します。値として true が設定され、削除対象として選択されたソフトウェアに 依存する他のソフトウェアがある場合は、swremove はその依存するソフトウェアも自動的に選択します。値として false が設定されている場合は、自動選択は行われず、依存条件は解決されません。

この値が true に設定されている場合、is_sticky 属性が true に設定されているバンドルは、その最後の内容が削除された時点で自動的に削除されます。false に設定されている場合、スティッキーバンドルは自動的には削除されません。

SD コマンドがターゲットデポまたはルートへの書き込み時に圧縮された INDEX と INFO カタログを作成するかどうかを決定します。デフォルトの false では圧縮ファイルを作成しません。true に設定すると、SD は INDEX と INFO ファイル、およびそれぞれを圧縮したファイルの両方を作成します。圧縮ファイルは、INDEX.gz、INFO.gz という名前で圧縮されてないファイルと同じディレクトリに作成されます。

圧縮ファイルにより低速ネットワークで性能が改善します。ただし、インストール済み製品データベースのディスクスペースの使用量とデポカタログのスペースの使用量は、それぞれ増加します。HP-UX 11.01 以降では次の場合に、SD コントローラとターゲットエージェントが自動的にソースエージェントから圧縮された INDEX と INFO ファイルをロードします。

INDEX.gz または INFO.gz のアクセス中、転送中、あるいは解凍中に何らかの問題が発生すると、ソースエージェントは圧縮されてない INDEX や INFO ファイルを使用します。

選択対象を決定するためにコントローラーがアクセスするデポの位置を指定します。 このオプションを設定すると、コントローラーとターゲット間のネットワーク通信量を減少させることができます。 この位置を指定するには、次のように、ターゲットセレクション構文を使用します。

このオプションは、ターゲットがどのソースを使用するかについては影響しないので、対話型ユーザーインタフェースで使用する場合には無効です。

ターゲットデポのデフォルト位置を定義します。

software_selections によって指定されているすべての依存条件が、target_selections で解決されていなければならないことを指定します。swremove は、選択されたファイルセットに依存するソフトウェアがあり (すなわち、他のソフトウェアがそのファイルセットに依存しており)、 しかも そのソフトウェアが選択されていない場合は、選択されたファイルセットを削除しません。しかし、このオプションを false に設定した場合は、依存条件のチェックは行われますが、その条件の解決は保証されません。

スクリプトで発生したエラーの処理を制御します。true に設定したときにスクリプトからエラーが戻されると、swremove は中断し、実行が失敗したことを示すエラーメッセージが表示されます。false に設定すると、スクリプトで発生したエラーは警告として扱われ、swremove は処理を続行します。警告メッセージが表示され、コマンドの処理続行を示します。 メッセージには、エラーが発生したフェーズ (configure/unconfigure、checkremove、preremove/postremove など) が含まれます。

このオプションは、SD-OV ライセンスがディスクレスサーバーのシステム上で有効でない場合、対話型ユーザーインタフェースだけに適用されます。 このオプションを使用すると、ディスクレスサーバーでは通常 swremove がマルチターゲットモードで実行する場合でも、swremove はシングルターゲットモードで実行します。

インストール済み製品データベース (IPD) が保存されているディレクトリパスを定義します。 この情報は、インストール済みのソフトウェアについて説明しています。このオプションを絶対パスに設定すると、IPD の位置を定義できます。 このオプションに相対パスを指定すると、SD コントローラーは admin_directory オプションで指定されている値に相対パスを追加して、IPD のパスを決定します。代替ルートの場合には、このパスが代替ルートの位置を示す相対パスになります。 このオプションは、ソフトウェアのインストール場所には何ら影響を及ぼしません。

このオプションでは、個々のアプリケーションまたはアプリケーショングループで異なる IPD を使用することで、 複数のユーザーまたは複数のプロセスで複数のソフトウェアアプリケーションを同時にインストールおよび削除できるようになります。

注意: 特定のアプリケーションを管理するには、特定の installed_software_catalog を使用してください。SD では、いくつもの IPD で同じアプリケーションの記述をいくつも扱うことができません。

SD の非特権モードを制御する admin_directory および run_as_superuser オプションも参照してください (このモードは、設計とパッケージ化が特別に行われるアプリケーションを管理するときにのみ使用するためのものです。 HP-UX オペレーティングシステムまたはそのパッチの管理には、このモードを使用できません。非特権の SD の詳細については、http://docs.hp.com/ja にある『 Software Distributor 管理者ガイド』 を参照してください)。

ジョブのタイトルを指定する ASCII 文字列です。これは swjob の起動時にジョブ ID とともに表示されるので、ジョブを識別するための追加の情報として参照できます。

SD のログファイルメッセージの前に識別番号を付けます。

ログファイルに書き込む詳細情報の量を管理します。 true に設定すると、このオプションは、詳細のタスク情報 (指定されたオプション、進行中のステートメント、およびほかの要約情報など) をログファイルに追加します。 この情報は、ログ情報とともに、loglevel オプションにより制御されます。

詳細については、loglevel オプションおよび sd(5) マンページを参照してください。

swremove コマンドのデフォルトのコマンドログファイルです。

コマンドのログファイルとターゲットエージェント、およびソースエージェントのログファイルに記録するイベントのログレベルを制御します。この情報は logdetail オプションを追加することにより、更に細かく設定できます。

詳細は logdetail オプションと sd(5) マンページを参照してください。

デフォルトの場合、swremove コマンドは、解析フェーズの開始時に /etc/fstab ファイルに記述されているすべてのファイルシステムを自動的にマウントしようと します。これにより、処理を進める前に、 リストされているすべての ファイルシステムが必ずマウントされるようになります。この操作方針により、 削除対象のファイルがまだマウントされていないファイルシステム上にあった場合でも、そのファイルを削除することが可能になります。

このオプションが false に設定されている場合、マウント操作は実行されず、現在のマウントのチェックも実行されません。

コントローラーの対話型ユーザーインタフェースで使用する ポーリング間隔を定義します。 これは、実行中のタスクに関するステータス情報を得るために 各ターゲットエージェントに対してポーリングを行う頻度を指定します。 広域ネットワークにまたがって動作している場合は、ポーリング間隔を大きくすることによってネットワークのオーバーヘッドを減らすことができます。

最後のプロダクト/バンドルが削除された時点でデポを削除するかどうかを制御します。 デポが削除されても、デフォルトではデポの swagent.log もディレクトリ構造も削除されません。swagent.log やディレクトリ構造を削除する必要がある時は、remove_empty_depot_directory オプションに true を設定しなければなりません。 既存のデポの ACL を後でそのデポを再使用するときのために残しておきたい場合は、このオプションを false に設定すると便利です。

デポを削除するときに、デポの swagent.log ファイルやディレクトリも削除するかどうかを制御します。 このオプションに true、remove_empty_depot オプションに true を設定し、デポから最後のプロダクト/バンドルが削除されていると、swagent.log とディレクトリも削除されます。

デーモンが従い、他のコマンドがデーモンと接続するために使用するプロトコルのシーケンスおよびエンドポイントを定義します。 あるプロトコルシーケンスで接続に失敗した場合、次のプロトコルシーケンスが試されます。 SD はほとんどのプラットフォームで tcp (ncacn_ip_tcp:[2121]) と udp (ncadg_ip_udp:[2121]) の両方のプロトコルシーケンスをサポートします。

詳細については、man 5 sd と入力して sd(5) マンページを参照してください。

通信のタイムアウトの相対的な長さです。これは 0 〜 9 の 範囲の値で、DCE RPC によって解釈されます。値が大きいほど 時間は長くなります。 大きい値が必要になるのは、低速なネットワークや利用度の高いネットワークの場合です。小さい値を指定すると、停止中のホストや swagentd を実行していないホストに対する接続試行をより速く検知することが 可能になります。各値が表す秒数は、それぞれ １ つ前の値が表す 秒数の約 ２ 倍になります。5 という値は ncadg_ip_udp プロトコルシーケンスでは約 30 秒に相当します。このオプションは ncacn_ip_tcp プロトコルシーケンスが使用されている場合は特に影響を与えないことがあります。

SD の非特権モードを制御します。実行ユーザーがスーパーユーザーの場合には、このオプションは無視されます (true とみなします)。

デフォルト値の true に設定すると、SD の操作は通常どおりに実行されます。 つまり、操作のパーミッションはローカルのスーパーユーザーに与えられるか、SD ACL によって設定されます (ACL の詳細については、swacl(1M) を参照してください)。

false に設定すると、実行ユーザーがローカルユーザーでかつスーパーユーザーではない\c ときに、非特権モードで実行されます。

SD の非特権モードは、設計とパッケージ化が特別に行われるアプリケーションを管理するときにのみ使用するためのものです。 HP-UX オペレーティングシステムまたはそのパッチの管理には、このモードを使用できません。非特権の SD の詳細については、http://docs.hp.com/ja にある『 Software Distributor 管理者ガイド』 を参照してください。

また、admin_directory オプションおよび installed_software_catalog オプションを参照してください。

デフォルトの software_selections を定義します。このオプションにデフォルト値はありません。複数のソフトウェアセレクションがある場合は、空白で区切って指定しなければなりません。

コントローラーの対話型ユーザーインタフェースで使用するソフトウェアビューを指定します。この値として指定できるのは、products、all_bundles またはバンドルカテゴリタグ (そのカテゴリの バンドルのみを表示するように指定) です。

デフォルトの target_selections を定義します。このオプションにデフォルト値はありません (上記の select_local を参照)。複数のターゲットセレクションがある場合は、空白で区切って指定しなければなりません。

代替ルートディレクトリのデフォルト位置を定義します。

標準出力 (stdout) の冗長性を制御します。次のような値があります。

リモート (NFS) ファイルシステムからのファイルの削除を抑止します。 false が設定された場合、リモートファイルシステム上のファイルは、削除対象から除外されます。

このオプションが true に設定され、しかもスーパーユーザーがリモートファイルシステムへの書き込みパーミッションを持っている場合は、リモートファイルは 操作から除外されず、削除が行われます。

システム全体のデフォルトのホストリスト

ユーザー固有のデフォルトのホストリスト

メッセージの表示で使用する言語を決定します。LANG が指定されていないか、空白の文字列が設定されている場合、デフォルトの値 C を使用します。詳細については、man 5 sd を入力して lang(5) を参照してください。

注意: SD エージェントおよびデーモン ログメッセージで表示される言語は、システム設定変数スクリプト /etc/rc.config.d/LANG で設定されます。例えば、エージェントおよびデーモン ログメッセージを日本語で表示するには、/etc/rc.config.d/LANG を LANG=ja_JP.SJIS または LANG=ja_JP.eucJP に設定します。

LANG 環境変数または LC_ で始まる環境変数の設定値で指示されているロケールカテゴリのすべての値よりも優先して使用するロケールを決定します。

テキストデータのバイトシーケンスを文字としてどのように解釈するかを決定します (例えば、ベンダー定義の属性の値が単一バイト文字とマルチバイト文字のどちらであるかなど)。

メッセージを書き込む際の言語を決定します。

swlist で表示される日付のフォーマット create_date と mod_date) を決定します。 日付と時刻を stdout、stderr および logging に出力する際にすべてのユーティリティで使用されます。

日付と時刻を表示する際に使用するタイムゾーンを決定します。

インストール製品データベース (IPD) へのパスを、環境変数 SW_ROOT_DIRECTORY で設定されているパスの相対パスで保持します。IPD のパスは、installed_software_catalog のデフォルトオプションを使用して指定できます。

実行中のスクリプトの現在のディレクトリが一時カタログディレクトリであるか、インストール製品データベース (IPD) 内のディレクトリであるかを定義します。 この変数はスクリプトに対し、ソフトウェアの他の制御スクリプト (サブスクリプトなど) がどこにあるかを指示します。

実行中の control_file のタグ名を保持します。ソフトウェアをパッケージ化する際には、デポにある制御ファイルの物理名とパスを定義できます。 そのため、control_file をタグとは別の名前で定義でき、１ つの同じファイルを指すのに複数の制御ファイル定義を使用することができます。control_file は SW_CONTROL_TAG 変数を照会して実行中のタグを判断できます。

デフォルトの製品ディレクトリから変更された、製品の位置を定義します。 SW_ROOT_DIRECTORY と組み合わせて使用すると、この変数はスクリプトに製品ファイルがどこにあるかを通知します。

制御スクリプトで使用できる最小限のコマンドセットを定義する PATH 変数です (例えば /sbin:/usr/bin)。

セッションが実行するルートディレクトリ "/" あるいは代替ルートディレクトリを定義します。 この変数は、製品がインストールされるルートディレクトリを制御スクリプトに通知します。 スクリプトは、製品のインストールされたファイルの位置を決定するために、このディレクトリを SW_LOCATION の接頭辞として使用しなければなりません。 構成スクリプトは、SW_ROOT_DIRECTORY が / の場合にだけ実行されます。

特定のコマンド (ソフトウェアおよびターゲットのセレクションを含む) の各オプションの値を含むファイルのパス名を定義します。 これによりスクリプトは、他の環境変数によって明示的には渡されなかったコマンドオプションおよび値を取り出すことができます。 例えば、SW_SESSIONS_OPTIONS で指定されたファイルを request スクリプトから使用できるようにした場合、targets オプションには、コマンドで指定したすべてのターゲットについて software_collection_specs のリストが含まれます。 SW_SESSIONS_OPTIONS で指定されたファイルを他のスクリプトから使用できるようにした場合、targets オプションには、スクリプトが実行されるターゲットについて software_collection_spec が １ つ含まれます。

この変数は、現在の製品もしくはファイルセットの完全修飾ソフトウェア仕様です。このソフトウェア仕様によって製品もしくはファイルセットが一意に識別されます。

この変数は、UNIX95 変数に基づいた処理ではなく、「従来の」 swremove コマンドによる処理を強制する値が設定された状態で、UNIX95 変数とともにエクスポートされます。 HP-UX 10.30 以降では、この変数は "1" に設定されています。

現在インストールまたは削除対象となっているセッションに対して、カーネル生成がスケジュールされているかどうかを示します。 TRUE は、カーネルファイルセットがカーネル生成をスケジュールし、/stand/system への変更が必要であることを示します。ヌル値は、カーネル生成がスケジュールされていないため、/stand/system への変更も必要でないことを示します。

この変数の値は、常に SW_SESSION_IS_REBOOT の値と等しくなっています。

削除を選択したファイルセットが再ブートをスケジュールしているかどうかを示します。 HP-UX カーネルファイルセットはすべて再ブートファイルセットでもあるため、この変数の値は、常に SW_SESSION_IS_KERNEL の値と等しくなります。

この変数に 1 を設定すると、オペレーティングシステムのアップデート時に SD コマンドが実行されます。この変数は update-ux コマンドによって設定されます。

この変数は、UNIX95 変数に基づいた処理ではなく、「従来の」 swremove コマンドによる処理を強制する値が設定された状態で、PRE_U95 変数とともにエクスポートされます。 HP-UX 10.30 以降のリリースでは、この変数はクリアされます。

非対話型の swremove セッションは、標準出力と標準エラーへのすべてのメッセージをログファイル /var/adm/sw/swremove.log に記録します。対話型の swremove セッションも同様のメッセージを記録します (logfile オプションを変更すれば別のログファイルを指定できます)。

swagent プロセスは、実際の削除操作を各 target_selection で実行します。インストール済みソフトウェアの削除の場合、swagent はルートディレクトリ (例えば、/ または代替ルートディレクトリ) の下にあるファイル var/adm/sw/swagent.log にメッセージを記録します。配布可能ソフトウェア (デポ内のソフトウェア) の削除の場合、swagent はデポディレクトリ (例えば、/var/spool/sw) の下にあるファイル swagent.log にメッセージを記録します。