機能説明
管理対象サーバに適用されているパッチの情報を登録・削除・一覧表示します。
情報収集元が、手動登録のパッチを適用済パッチとして管理コンソールで表示します。
記述形式
【Windows】
swcfmg_patch_applied.exe { -add -file "適用済パッチ情報ファイルのパス" [-e "文字コード"] | |
【Linux】
swcfmg_patch_applied { -add -file "適用済パッチ情報ファイルのパス" [-e "文字コード"] | |
オプション
指定された適用済パッチ情報ファイルに記載された内容に従って、適用済パッチ情報を登録します。
適用済パッチ情報ファイルはCSV形式です。適用済パッチ情報ファイルの詳細については、「6.4.2 適用済パッチ情報ファイル」を参照してください。
指定された適用済パッチ情報ファイルに記載された内容の、適用済パッチ情報を削除します。
適用済パッチ情報ファイルはCSV形式です。適用済パッチ情報ファイルの詳細については、「6.4.2 適用済パッチ情報ファイル」を参照してください。
本コマンドで登録された適用済パッチ情報を実態レコード情報ファイルの形式で出力します。このファイルはCSV形式です。ファイルの詳細は、「6.2.3 収集情報CSVファイル」を参照してください。-file “出力ファイルパス”が省略された場合、情報はコマンドの標準出力に出力されます。指定したファイルが存在しない場合はファイルを新規作成し、存在する場合は既存のファイルへ上書きします。エラーのため、ファイル出力できなかった場合、新規作成時は、新たなファイルは作成しません。既存ファイルへの上書きの場合は、既存ファイルを保証します。
出力先のファイルを指定します。
本オプションが省略された場合、情報はコマンドの標準出力に出力されます。
指定したファイルが存在しない場合はファイルを新規作成し、存在する場合は既存のファイルへ上書きします。
エラーのため、ファイル出力できなかった場合、新規作成時は、新たなファイルは作成しません。既存ファイルへの上書きの場合は、既存ファイルを保証します。
出力ファイルの詳細については、ファイルリファレンスの「6.4.2 適用済パッチ情報ファイル」を参照してください。
情報収集元が手動登録のパッチの適用済パッチだけでなく、すべての情報収集元のパッチの適用済パッチ情報をすべて出力します。
ファイルの文字コードを指定します。
以下の文字コードが指定できます。半角英大文字で指定します。
【Windows】
SJIS
【Linux】
UTF-8
EUC
本オプションを省略した場合、本コマンドの実行環境の文字コードで動作します。
復帰値
復帰値 | 意味 |
|---|---|
0 | 正常終了しました。 |
10 | パラメーター異常です。 |
20 | 指定された入出力ファイルパスのエラーです。 |
30 | 指定された文字コードに誤りがあります。 |
40 | 適用済パッチ情報ファイルの読み込みに失敗しました。 |
50 | 適用済パッチ情報ファイルの記述に誤りがあります。 |
100 | Systemwalker Software Configuration Manager は起動していません。 |
101 | 同時実行できないコマンドが実行されています。 |
102 | コマンド実行権限がありません。 |
110 | 書き込みエラーです。 |
200 | セットアップされていません。 |
255 | システムエラーです。 |
コマンド格納場所
管理サーバ
【Windows】
[Systemwalker Software Configuration Managerインストールディレクトリ]\SWCFMGM\bin
【Linux】
/opt/FJSVcfmgm/bin
実行に必要な権限
【Windows】
管理サーバで実行可能です。
【Linux】
管理サーバで実行可能です。
注意事項
Systemwalker Software Configuration Managerで提供するコマンドは、同時に実行する事はできません。コマンド実行中に他のコマンドを実行すると、排他エラーとなります。
Systemwalker Software Configuration Managerが起動した状態で本コマンドを実行してください。
適用済パッチ情報ファイルに記載されているサーバIDまたはIPアドレスのサーバが管理対象サーバとしてSystemwalker Software Configuration Managerに登録されていない場合は、エラーとなります。
適用済パッチ情報ファイルに記載されているソフトウェアIDのソフトウェア情報がSystemwalker Software Configuration Managerに登録されていない場合は、エラーとなります。
インストール先が設定されているインストール済ソフトウェアに対する適用済パッチを登録する場合、software-idにソフトウェアIDとインストール先を";"(セミコロン)区切りで指定してください。
情報収集元が手動登録以外の適用済パッチ情報を登録しソフトウェアパッチ情報のディスカバリを行った場合、本コマンドで登録した適用済パッチ情報がディスカバリで収集できなかった際に該当の適用済パッチ情報は削除されます。
適用済パッチ情報ファイルに、すでに登録済のサーバIDまたはIPアドレスとソフトウェアIDとパッチIDの組み合わせが存在する場合、エラーとなります。
本コマンドに指定した文字コードと、適用済パッチ情報ファイルに指定した文字コードが異なっていた場合の動作は保証しません。文字コードを一致させるようにしてください。
管理対象サーバに対する適用済パッチ情報を誤って設定した場合や、該当サーバからパッチを削除した場合、本コマンドを使用して適用済パッチ情報を削除してください。
適用済パッチ情報ファイルに記載されているサーバIDまたはIPアドレスのサーバが管理対象サーバとしてSystemwalker Software Configuration Managerに登録されていない場合は、エラーとなります。
適用済パッチ情報ファイルに記載されているソフトウェアIDのソフトウェア情報がSystemwalker Software Configuration Managerに登録されていない場合は、エラーとなります。
インストール先が設定されているインストール済ソフトウェアに対する適用済パッチ情報を削除する場合、software-idにソフトウェアIDとインストール先を";"(セミコロン)区切りで指定してください。
情報収集元が手動登録以外の適用済パッチ情報を削除しソフトウェアパッチ情報のディスカバリを行った場合、本コマンドで削除した適用済パッチ情報がディスカバリで収集できた際に該当の適用済パッチ情報は再登録されます。
適用済パッチ情報ファイルで指定されたサーバIDまたはIPアドレスとソフトウェアIDとパッチIDの組み合わせで、適用済パッチ情報が登録されていない場合、エラーとなります。
本コマンドに指定した文字コードと、適用済パッチ情報ファイルに指定した文字コードが異なっていた場合の動作は保証しません。文字コードは一致させるようにしてください。
適用済パッチ情報が登録されていない場合は、ヘッダ情報だけを出力します。
#server,software-id,patch-id
適用済パッチ情報ファイルに誤りがある場合は、適用済パッチ情報の登録・削除を中止します。トレースログに以下のようなエラーメッセージを出力します。
ファイルの記述に誤りがあります。[行番号:n][原因:原因][原因]には、以下のいずれかが出力されます。
メッセージ | 意味 |
|---|---|
Number of elements. | 該当行の要素の数を見直してください。 |
The specified elements are invalid.(patch-id) | 該当行のパッチは、該当行のソフトウェアに適用できません。 |
Mandatory elements are not specified. | 該当行の必須項目を入力してください。 |
The same server, software id, and patch id are specified in another line. | 該当行までに、同じサーバ、ソフトウェアIDとパッチIDの組み合わせが記載されています。 |
The specified server does not exist. | 該当行の“server”に相当するサーバが存在しません。存在するサーバのサーバIDまたはIPアドレスを指定してください。 |
The specified patch does not exist. | 該当行の“patch-id”に相当するパッチ情報が存在しません。存在するパッチIDを指定してください。 |
The applied patch has already been registered. | 該当行の適用済パッチ情報は、すでに登録されています。 |
The specified applied patch does not exist. | 該当行のサーバIDまたはIPアドレス、ソフトウェアIDとパッチIDの組み合わせでは適用済パッチ情報として登録されていません。 |
使用例
登録
【Windows】
swcfmg_patch_applied.exe -add -file C:\work\appliedpatchinfo.csv
【Linux】
swcfmg_patch_applied -add -file /tmp/appliedpatchinfo.csv
削除
【Windows】
swcfmg_patch_applied.exe -delete -file C:\work\appliedpatchinfo.csv
【Linux】
swcfmg_patch_applied -file /tmp/appliedpatchinfo.csv
一覧表示
【Windows】
swcfmg_patch_applied.exe -list -file C:\work\appliedpatchinfo.csv
【Linux】
swcfmg_patch_applied -add -list -file /tmp/appliedpatchinfo.csv