14.11 dcmpkput.exe(パッケージのバックアップからの復元)
パッケージをバックアップから復元するdcmpkputコマンドについて説明します。なお、このコマンドでは、パラメタファイルを使用しません。
機能
バックアップファイルからパッケージを復元し、指定したキャビネットに保管します。
形式
dcmpkput.exe [/C キャビネット識別ID] /i 入力先ディレクトリ [/of 入力ファイル名] [/f]
引数
-
/C
バックアップから復元したパッケージを保管するキャビネットの識別IDを指定します。指定したキャビネットが存在しない場合は、自動的に作成されます。キャビネット識別IDを指定しない場合は、元のキャビネットに保管されます。
-
/i
dcmpkgetコマンドで指定した出力先ディレクトリのフルパスを指定します。入力先ディレクトリにネットワークドライブは指定できません。
-
/of
dcmpkgetコマンドで作成したバックアップファイル名を指定します。/ofにはワイルドカード(*)が使用できます。省略すると「dcmpkget」で始まるすべてのバックアップファイルを対象にします。
/iで指定したディレクトリに、複数のバックアップファイルが存在している場合、次のような指定方法で、ディレクトリ下のすべてのバックアップファイルを指定することもできます。
dcmpkput.exe /i C:\temp\pkg /of *
-
/f
指定したキャビネットに同じパッケージがあった場合に上書きします。この引数を指定しない場合は、上書きしないで、リターンコード5を返します。
リターンコード
dcmpkputコマンド実行時のリターンコードを次の表に示します。
コード |
意味 |
対処 |
---|---|---|
0 |
パッケージの復元が成功した。 |
なし。 |
1 |
dcmpkgetコマンドの結果出力ファイルをオープンできない、またはファイル形式に誤りがある。 |
結果出力ファイルのパス、またはファイル形式を確認してください。 |
2 |
コマンドの引数に不正な値が指定されている。 |
コマンドの引数の設定値を確認してください。 |
3 |
データベースの接続に失敗した。 |
配布管理システムのセットアップで、データベースの設定を確認してください。 |
4 |
指定したバックアップファイルが存在しない。 |
バックアップファイルのパスを確認してください。 |
5 |
|
|
12 |
そのほかのエラーが発生した。 |
イベントログを参照してください。 |
注意事項
-
複数のパッケージを指定してこのコマンドを実行したとき、途中でパッケージの復元に失敗すると、dcmpkputコマンドはパッケージの復元処理を中止します。その際、障害発生時のリターンコードを返します。
-
UNIX版パッケージのバックアップを復元する場合、復元先にはキャビネット種別がUNIX用の、既存のキャビネットを指定してください。キャビネット種別がWindows用のとき、およびキャビネットが存在しないときは復元できません。
実行例
dcmpkgetコマンドで取得したバックアップファイルからパッケージを復元する例を次に示します。
C:\Dmbat\backupに取得したすべてのバックアップファイルを、キャビネット識別ID「01」のキャビネットに復元する場合は、次のように指定します。
dcmpkput.exe /C 01 /i C:\Dmbat\backup /of *