4.10 dcminst.exe(ジョブの作成,実行)
(1) 機能
次に示す,リモートインストール関連のジョブを作成,実行します。
- パッケージのインストール
- 中継システムまでのパッケージ転送(JP1/NETM/DM Managerだけ)
- 中継システムのパッケージ一括削除(JP1/NETM/DM Managerだけ)
- クライアントユーザによるインストール
JP1/NETM/DM Client(中継システム)では,「パッケージのインストール」ジョブと「クライアントユーザによるインストール」ジョブだけが作成,実行できます。
なお,JP1/NETM/DM Client(中継システム)では,一つ下の階層までしかジョブを実行できません。
(2) 形式
dcminst.exe [処理キー] [/f] [/s]
/i パラメタファイル1 [パラメタファイル2]
/o 結果出力ファイル名
[/LC {ON|OFF}]
(3) 引数
- 処理キー
実行するジョブの種類を指定するキーです。コマンド名の直後に,次に示す四つの処理キーのうち一つを指定してください。省略した場合は,「NETM_INSTALL」が仮定されます。
- NETM_INSTALL
「パッケージのインストール」ジョブを実行します。パラメタファイル(またはコマンドの引数)で,インストールするパッケージおよびあて先を指定してください。
JP1/NETM/DM ManagerおよびJP1/NETM/DM Client(中継システム)で指定できます。
- NETM_STORE
「中継システムまでのパッケージ転送」ジョブを実行します。パラメタファイル(またはコマンドの引数)で,パッケージおよびあて先(中継システムのクライアント機能)を指定してください。
JP1/NETM/DM Managerでだけ指定できます。JP1/NETM/DM Client(中継システム)で指定するとエラーになります。
- NETM_DELETE
「中継システム上のパッケージ一括削除」ジョブを実行します。パラメタファイル(またはコマンドの引数)で,あて先(中継システムのクライアント機能)を指定してください。
JP1/NETM/DM Managerでだけ指定できます。JP1/NETM/DM Client(中継システム)で指定するとエラーになります。
- NETM_USERINST
「クライアントユーザによるインストール」ジョブを実行します。パラメタファイル(またはコマンドの引数)で,インストールするパッケージおよびあて先を指定してください。
JP1/NETM/DM ManagerおよびJP1/NETM/DM Client(中継システム)で指定できます。
- /f
インストール対象として指定したパッケージがあて先のクライアントにインストール済みの場合に,上書きしてインストールします。この引数を指定しない場合は,インストール済みのパッケージは上書きしないで正常終了します。
処理キーが「NETM_DELETE」の場合は,指定しても無視されます。
- /s
ジョブを作成後,実行しないで保存します。
この引数を指定してコマンドを実行したときの結果出力ファイルには,ジョブ番号が出力されません。
- /i
使用するパラメタファイルのフルパスを,一つまたは二つ指定します。二つ指定する場合は間をスペースで区切ってください。三つ以上指定するとコマンドは失敗します。
パラメタファイルを二つ指定すると,JP1/NETM/DMは,それぞれのパラメタファイルの内容を連結して解釈します。あて先とパッケージとを別のパラメタファイルに定義しておくと,パッケージだけを変更して同じクライアントに再配布したり,同じパッケージを別のあて先に配布したりできて便利です。この場合,dcmpackコマンドの結果出力ファイルを,パッケージの属性を指定したパラメタファイルとして使用できます。
- /o
結果出力ファイルのフルパスを指定してください。コマンドが正常終了すると,指定した結果出力ファイルに次の項目が出力されます。結果出力ファイルがすでに存在する場合は上書きされます。
ジョブ番号(jobnoの値)は,開始されたジョブを識別する番号です。このジョブを削除したり,実行状況を確認したりする場合は,jobnoの値をパラメタファイルに記述してください。なお,コマンドの引数に/sを指定した場合,ジョブ番号は出力されません。
/sを指定した場合の結果出力ファイルは,そのままdcmjexeコマンドおよびdcmrmgenコマンドのパラメタファイルとして使用できます。また,/sを指定しなかった場合の結果出力ファイルは,dcmjbrmコマンド,dcmrtryコマンド,dcmstatコマンド,およびdcmstswコマンドのパラメタファイルとして使用できます。
- /LC
タスクスケジューラやJP1/AJSを使用してコマンドをバックグラウンドサービスとして実行している場合にWindowsをログオフしても,コマンド処理を継続するかどうかを「ON」または「OFF」で指定します。
- ON
Windowsをログオフしても,コマンド処理を継続します。
- OFF
Windowsをログオフすると,コマンド処理を強制終了します。
この引数は,次に示すOSでコマンドをサービスから実行した場合に,有効となります。
- Windows NT 4.0
- Windows 2000
- Windows XP
- Windows Server 2003(Windows Server 2003 (IPF)を除く)
コマンドプロンプトからコマンドを実行する場合は,フォアグラウンドプログラムとして実行されるため,「/LC ON」を指定しないでください。
Windowsをログオフしてもコマンド処理を継続するかどうかは,レジストリでも設定できます。レジストリでの設定については,次の個所を参照してください。
- JP1/NETM/DM Managerで実行する場合
マニュアル「構築ガイド」の「4.6 レジストリの設定(JP1/NETM/DM Manager)」
- JP1/NETM/DM Client(中継システム)で実行する場合
マニュアル「構築ガイド」の「5.4 レジストリの設定(JP1/NETM/DM Client(中継システム))」
なお,/LCでの指定と,レジストリでの設定の組み合わせで,動作が異なります。詳細については,「4.28 レジストリ設定とログオフオプションによるログオフ時のコマンドの動作」を参照してください。
(4) パラメタファイルの指定内容とコマンド引数との対応
このコマンドで使用するパラメタファイルの内容は,コマンドの引数で指定することもできます。パラメタファイルの指定内容と,コマンドの引数との対応を次の表に示します。
表4-11 パラメタファイルとコマンドの引数の対応(dcminstコマンド)
パラメタファイルの指定内容 | 内容 | 指定の有無 | コマンドの引数 |
---|
タグ | パラメタ |
---|
JOB_DESTINATION | directory_com | ディレクトリ情報(コンピュータの階層) | ◎※1※2 | /dc 値 |
directory_group | ディレクトリ情報(グループの階層) | ○※1※2 | /dg 値 |
directory_ou | ディレクトリ情報(組織単位(OU)の階層) | ○※1※2 | /do 値 |
group | あて先グループ名 | ◎※1 | /g 値 |
host_name | ホスト名 | ◎※1 | /h 値 |
lower_clients | すべてのあて先指定の有無 | ○※1※3 | - |
JOB_DESTINATION_ID | destination_id | ID名 | ◎※1 | /X 値 |
PACKAGING_INFORMATION※4 | package_name | パッケージ名 | ◎ | /p 値 |
package_id | パッケージ識別ID | ◎ | /I 値 |
version_revision | バージョン/リビジョン | ◎ | /v 値 |
generation | 世代番号 | ◎ | /G 値 |
cabinet_name | キャビネット名 | ◎ | /c 値 |
cabinet_id | キャビネット識別ID | ◎ | /C 値 |
package_code | コード種別 | ○ | /KWまたは/KP |
JOB_ATTRIBUTE | job_generator | ジョブ名称 | ○※5 | /j 値 |
jobno | ジョブ番号 | × | - |
job_folder | ジョブ格納フォルダパス | ○ | /l 値 |
unsuspended | 中断中の配布の有無 | ○※6 | /uns 値 |
JOB_SCHEDULE | job_entry_date | ジョブの登録日時 | ○ | /jst 値 |
job_execution_date | ジョブの実行日時 | ○ | /jsx 値 |
job_expiration_date | ジョブの実行期限 | ○ | /jsp 値 |
JOB_SPLIT_DELIVERY※6 | split_size | 分割サイズ | ○ | /sds 値 |
wait_time | 転送休止時間 | ○ | /sdt 値 |
JOB_CLIENT_CONTROL | client_wake_up | クライアントの起動の有無 | ○ | /WWU |
client_shutdown | クライアントのシャットダウンの有無 | ○ | /WUS |
- (凡例)
- ◎:必ず指定する ○:省略できる ×:不要(指定しても無視される)
- -:コマンドの引数では指定できない
- 注※1
- JOB_DESTINATIONとJOB_DESTINATION_IDは同時に指定できません。また,/g,/h,/dc,/dg,および/doは/Xと同時に指定できません。必ずどちらかだけを指定してください。
- なお,処理キーが「NETM_STORE」または「NETM_DELETE」の場合,IDは指定できません。
- 注※2
- groupおよびhost_name(/gおよび/h)と,directory_comおよびdirectory_ou(/dcおよび/do)は同時に指定できません。ただし,groupおよびhost_name(/gおよび/h)は同時に指定してもかまいません。また,directory_com,directory_group,およびdirectory_ou(/dc,/dg,および/do)は,組み合わせに関係なく同時に指定してもかまいません。
- なお,directory_com,directory_group,およびdirectory_ou(/dc,/dg,および/do)と同時にlower_clientsを指定しても,すべてのあて先指定は無視されます。
- 注※3
- JP1/NETM/DM Client(中継システム)の場合は指定できません。
- 注※4
- このコマンドでは,PACKAGING_INFORMATIONタグのパラメタに予約語を使用できません。
- 注※5
- job_generator(または/j)の指定を省略した場合,ジョブ名称として「処理キー+ジョブの実行日時」が自動的に設定されます。このため,同じ処理キーのコマンドを同時に複数実行すると,ジョブ名称が重複しジョブが正しく実行されないことがあります。同じ処理キーのコマンドを同時に複数実行する場合は,job_generator(または/j)で,異なるジョブ名称を指定することをお勧めします。
- 注※6
- JOB_ATTRIBUTEのunsuspendedおよびJOB_SPLIT_DELIVERYは同時に指定できません。
(5) パラメタファイルを使用しない場合のコマンド形式
パラメタファイルを使用しないで引数だけで指定する場合の,コマンドの形式を次に示します。
dcminst.exe [処理キー] [/f] [/s]
{[/g あて先グループ名] [/h ホスト名]|
[/dc コンピュータの階層] [/dg グループの階層]
[/do 組織単位(OU)の階層]|
/X ID名}
/p パッケージ名 /I パッケージ識別ID
/v バージョン・リビジョン /G 世代番号
/c キャビネット名 /C キャビネット識別ID
[{/KW|/KP}]
[/j ジョブ名称] [/l ジョブ格納フォルダパス]
[/uns 中断中の配布の有無]
[/jst ジョブの登録日時] [/jsx ジョブの実行日時]
[/jsp ジョブの実行期限]
[/sds 分割サイズ] [/sdt 転送休止時間]
[/WWU クライアントの起動の有無]
[/WUS クライアントのシャットダウンの有無]
/o 結果出力ファイル名
[/LC {ON|OFF}]
(6) リターンコード
dcminstコマンド実行時のリターンコードを次の表に示します。
コード | 意味 | 対処 |
---|
0 | 配布管理システムがジョブを開始した。 | なし。 |
1 | パラメタファイルをオープンできない,またはファイル形式に誤りがある。 | パラメタファイルの指定または記述形式を確認してください。 |
2 | コマンドの引数またはパラメタファイルに不正な値が指定されている。 | コマンドの引数またはパラメタファイルの設定値を確認してください。 |
3 | 配布管理システムへの接続でエラーが発生した。 | 配布管理システムのバージョンを確認してください。 |
4 | 結果出力ファイルをオープンできない。 | 結果出力ファイルの指定を確認してください。 |
5 | クライアント,配布管理システム間の通信に失敗した。 | 配布管理システムのセットアップで,通信環境の設定を確認してください。 |
12 | そのほかのエラーが発生した。 | イベントログを参照してください。 |
また,JP1/Baseと連携してJP1/NETM/DMのユーザを管理している場合は,「1.3.3 コマンドを実行するための設定」も合わせて参照してください。
(7) 注意事項
- あて先およびパッケージの指定数について
- パラメタファイルで指定する場合,dcminstコマンド1回の実行につき,あて先は200個まで指定できます。また,パッケージは100個まで指定できます。
- あて先およびパッケージをコマンドの引数で指定する場合は,それぞれ1個しか指定できません。ただし,あて先の場合,/gおよび/hは値を「;」で区切ることで,200個まで指定できます。
- パラメタファイルでパッケージを複数指定している場合でも,同じ項目をコマンドの引数で指定すると,すべて無効となります。
- /fの指定について
- 引数に/fを指定すると,すでに同じパッケージがあて先に配布されているかいないかに関係なく,パッケージが送信されます。不要なネットワークトラフィックの増加を避けるには,配布済みのパッケージを上書きする必要がある場合だけ,/fを使用してください。
- 引数に/fを指定すると,バージョンが同じでも内容が異なるソフトウェアを上書きインストールできるため,JP1/NETM/DMのインストールパッケージ情報のバージョン管理ができなくなります。
- JOB_ATTRIBUTEタグのjob_generatorパラメタに指定したジョブ名が既存のジョブ名として存在する場合について
既存のジョブ定義を基にジョブが作成されます。
- クライアントの起動の指定について
ホスト識別子を使用している環境で,クライアントの起動の有無を指定する場合は,ジョブのあて先に,あて先グループ名またはIDを指定してください。ホスト名を指定すると,クライアントの起動の指定は無視されます。中継システムの場合,クライアントの起動の指定は無条件に無視されます。
- ジョブ格納フォルダパスの指定について
ジョブ格納フォルダパスに[ジョブ定義]ウィンドウで定義されていないフォルダを指定してコマンドを実行した場合,指定されたフォルダが作成されます。作成されたジョブ格納フォルダは,実行後も削除されないで残ります。使用しない場合は,ジョブが完了したら削除してください。
(8) 実行例
JP1/NETM/DM Client(クライアント)が稼働するホストdmp491およびdmp492に,Finance Data 2003 5という名称でパッケージングしたソフトウェアを配布する例を次に示します。
(a) パラメタファイルの作成
ホストとパッケージの属性をパラメタファイルに次のように記述し,パラメタファイルを任意の名称で保存します。
** dcminst Parameter File Sample
JOB_DESTINATION{
host_name=dmp491;dmp492
}
PACKAGING_INFORMATION
{
package_name=Finance Data 2003 5
package_id=FD200305
version_revision=000001
generation=0000
cabinet_name=FCAB01
cabinet_id=F1
package_code=P
}
(b) コマンドの実行
作成したパラメタファイルをC:¥Dmbat¥dcminst.txtに保存し,結果出力ファイルをC:¥Dmbat¥out.txtに取得する場合は,次のように指定します。
dcminst.exe /i C:¥Dmbat¥dcminst.txt /o C:¥Dmbat¥out.txt /j 上書きインストール /f
(c) 結果出力ファイルの確認
コマンドが正常終了すると,ジョブのジョブ名称,ジョブ番号,ジョブ格納フォルダパスが,C:¥Dmbat¥out.txtに次のように出力されます。
JOB_ATTRIBUTE{
job_generator= NETM_INSTALL_2003_12_11_13_34_36
jobno= JB03121113315383
job_folder= ¥
}