12.3.2 dbrestore.bat(データベースのリストア)
(1) 機能
JP1/DH - Serverが使用するデータベースのバックアップからリストアを行います。本コマンドは,JP1/DH Webアプリケーションサーバ(CosminexusのJ2EEサーバ)を停止させてから実行してください。
(2) 実行者
ビルトインAdministratorユーザまたはAdministrators権限を持つ管理者ユーザが,コマンドプロンプトから実行します。※
- 注※
-
コマンドは直接実行せず,コマンドプロンプトから実行してください。
(3) 形式
dbrestore.bat DBパスワード リストア元フォルダ [リストアファイル]
(4) 引数
- DBパスワード
-
データベースのパスワードを指定します。
- リストア元フォルダ
-
データベースのバックアップファイルを格納しているフォルダを絶対パスで指定します。
絶対パスの長さは200バイト以下になるように指定してください。
- リストアファイル名(省略可)
-
データベースにリストアするバックアップファイルの名称を指定します。
省略した場合は「dbbackup.dump」を参照します。
(5) 実行結果
指定したバックアップファイルの情報がデータベースにリストアされます。
(6) リターンコード
リターンコード |
意味 |
事象発生後の動作 |
発生条件 |
---|---|---|---|
0 |
正常 |
− |
リストアが正常に行われた |
4 |
警告 |
コマンドの処理を中断 |
|
8 |
エラー |
コマンドの処理を中断 |
リストアに失敗した |
16 |
警告 |
コマンドの処理を中断 |
JP1/DH Webアプリケーションサーバ(CosminexusのJ2EEサーバ)の停止確認応答で,コマンドの実行を中止した |
(7) 出力メッセージ(出力先:stdout)
項番 |
メッセージ |
リターンコード |
事象発生後の動作 |
オペレータの取るべき処置 |
発生条件 |
---|---|---|---|---|---|
1 |
リストアを開始します。 |
- |
コマンドの実行を開始 |
なし |
コマンドを実行した場合 |
2 |
リストアが正常に終了しました。何かキーを押してください。 |
0 |
コマンドの実行を終了 |
なし |
リストアが正常に行われた場合 |
3 |
引数にDBのパスワードを指定してください。何かキーを押した後、再度実行してください。 |
4 |
コマンドの実行を終了 |
引数にデータベースパスワードを指定して再実行する |
引数にデータベースのパスワードを指定せずに,コマンドを実行した場合 |
4 |
引数にリストア元フォルダを指定してください。 |
4 |
コマンドの実行を終了 |
引数にリストア元フォルダを指定してコマンドを再実行する |
引数を指定せずにコマンドを実行した場合 |
5 |
指定したフォルダが存在しません。何かキーを押した後、再度実行してください。 |
8 |
コマンドの実行を終了 |
リストア元フォルダが正しいかどうか確認する |
引数に不正なフォルダを指定した場合 |
6 |
指定したフォルダに ******* が存在しません。 |
8 |
コマンドの実行を終了 |
リストア元フォルダおよびリストアファイル名が正しいかどうか確認する |
引数に不正なフォルダおよびリストアファイル名を指定した場合 |
7 |
リストアが正常に終了しませんでした。何かキーを押した後、再度実行してください。※ |
8 |
コマンドの実行を終了 |
出力されたエラーメッセージを確認してエラーの原因を取り除いてから再実行する |
リストアに失敗した場合 |
8 |
CosminexusのJ2EEサーバが停止している事を確認してから、続行してください。続行しますか? (y/n) |
- |
ユーザの応答待ち |
実行を継続する場合は「y」,実行を中止する場合は「n」を選択する |
コマンドを実行した場合 |
9 |
コマンドの実行を中止しました。何かキーを押してください。 |
16 |
コマンドの実行を終了 |
項番8で「n」を選択した場合は確認事項に同意して実行する |
項番8で「n」を選択した場合 |
注※ データベース内でエラーが発生した場合は,データベースが出力するエラーメッセージの後に本メッセージが出力されます。
(8) 注意事項
コマンドは直接実行せず,コマンドプロンプトから実行してください。
OSのUAC(User Account Control)を有効にしている場合は,次に示すどれかの方法でコマンドを実行してください。
-
ビルトインAdministratorユーザでログインしてコマンドプロンプトを起動し,コマンドを実行する
-
Administrators権限を持つユーザでログインしてコマンドプロンプトを「管理者として実行」し,コマンドを実行する
-
JP1/DH - Serverのインストール時に作成される権限昇格済みのコマンドプロンプトのショートカットからコマンドを実行する※
- 注※
-
Windows Server 2012,Windows Server 2012 R2またはWindows Server 2016の場合に,このコマンドプロンプトを使用するときは,Microsoft .NET Framework 3.5のインストールが必要です。Microsoft .NET Framework 3.5のインストールについては,「付録D .NET Framework 3.5のインストール」を参照してください。
同一マシン上での複数同時実行はサポートしていません。