jssdbbackup.bat(データベースバックアップ)
機能
JP1/Service Supportのデータベースのバックアップを取得します。なお,案件保存DBを使用している場合,案件管理DBだけでなく案件保存DBのバックアップも取得します。
このコマンドは,スタートメニューの[プログラム]−[JP1_Service Support]−[JP1_SSコマンドプロンプト]から実行します。
形式
jssdbbackup.bat {-f バックアップファイル名 | -o バックアップファイル出力先フォルダ {-ALL | -mdb | -sdb} [-ow]} {-maint | -expand}
実行権限
Administrators権限
格納先フォルダ
JP1/SSパス\tools\
引数
-f バックアップファイル名
バックアップしたJP1/Service Supportのデータベースを出力するファイル名を絶対パスで指定します。案件管理DBだけでなく,案件保存DBもバックアップされます。バックアップファイルの出力先フォルダは,コマンド実行前に作成しておいてください。
バックアップファイル名を指定するときは,次のことに注意してください。
-
バックアップファイルの出力先には,必ずローカルドライブを指定してください。ネットワークドライブは指定できません。
-
UNCパスでは指定できません。
-
バックアップファイルのパスは,259バイト以内の絶対パスで指定してください。また,フォルダに出力するバックアップファイル名は,255バイト以内で指定してください。バックアップファイル名が全角文字を含む場合,全角文字は2バイトに換算されます。
-
バックアップファイル名にマルチバイト文字は指定できません。また,OSで指定できない文字列も指定できません。
-
出力先のフォルダに,指定したバックアップファイル名と同一名称のファイルがある場合,同一名称のファイルを上書きしてバックアップファイルを作成します。ファイルを上書きしたくない場合は,別のバックアップファイル名を指定してコマンドを実行してください。
-o バックアップファイル出力先フォルダ
バックアップしたJP1/Service Supportのデータベースの出力先フォルダ名を絶対パスで指定します。バックアップファイル出力先フォルダは,コマンド実行前に作成しておいてください。なお,jssdbbackup.batコマンドを実行すると,バックアップ取得時の状態を記録したファイル(dbpath.txt)が,バックアップ出力先フォルダに格納されます。dbpath.txtには,バックアップ取得時に指定したオプション情報,バックアップ取得時の案件管理DBのデータベースサイズ,および案件保存DBの拡張先フォルダ情報(-dbpathオプションを指定したjssdbstatchk.bat(データベース状態確認)コマンドを実行したときに出力される情報と同様)が出力されます。指定したバックアップ出力先フォルダは,次に示すフォルダ構成となります。
バックアップファイル出力先フォルダ名 ├ dbpath.txt バックアップファイル取得時のデータベースの状態を記録したファイル ├ mdb_オプション※ 案件管理DBのバックアップファイル出力先フォルダ └ sdb_オプション※ 案件保存DBのバックアップファイル出力先フォルダ
- 注※
-
maintまたはexpandのどちらかとなります。
バックアップファイル出力先フォルダ名を指定するときは,次のことに注意してください。
-
バックアップファイルの出力先には,必ずローカルドライブを指定してください。ネットワークドライブは指定できません。
-
UNCパスは指定できません。
-
バックアップファイル出力先フォルダのパスは,80バイト以内の絶対パスで指定してください。バックアップファイル出力先フォルダ名が全角文字を含む場合,全角文字は2バイトに換算されます。
-ALL
案件管理DBと案件保存DBの両方をバックアップしたい場合に指定します。
-mdb
案件管理DBだけをバックアップしたい場合に指定します。また,案件管理DBのバックアップ出力先フォルダだけでなく,案件保存DBのバックアップ出力先フォルダも作成されます。ただし,ファイルは作成されません。
-sdb
案件保存DBだけをバックアップしたい場合に指定します。また,案件保存DBのバックアップ出力先フォルダだけでなく,案件管理DBのバックアップ出力先フォルダも作成されます。ただし,ファイルは作成されません。
-maint
JP1/Service Supportのデータベースの障害復旧をするために,バックアップファイルを作成する場合に指定します。
-expand
JP1/Service Supportのデータベースを拡張または異なるサーバ間で移行するために,バックアップファイルを作成する場合に指定します。
-ow
-oオプションで指定したバックアップファイル出力先フォルダにすでにバックアップファイルが存在した場合,バックアップファイルを上書きするときに指定します。-oオプションで指定したバックアップファイル出力先フォルダにすでにバックアップファイルが存在した場合にこのオプションを省略してコマンドを実行すると,エラー終了します。
戻り値
戻り値 |
意味 |
---|---|
0 |
正常終了 |
1 |
異常終了 |
実行時の前提条件
-
コマンド実行時のサービスの状態については,「12. コマンド」の「コマンド実行時のサービスの状態」を参照してください。
-
jssdbbackup.batコマンドの実行中に,ほかのJP1/Service Supportのコマンドを実行しないでください。
-
jssdbbackup.batコマンドで-expandオプションを指定する場合,次の事項に注意してください。
-
-expandオプションを指定してバックアップを取得する前に,-maintオプションを指定してバックアップを取得してください。
-
同サイズのデータベースへリカバリーしようとすると,リカバリーに失敗するおそれがあります。同サイズのデータベースへのバックアップ・リカバリー時は-maintオプションを使用してください。
-
-
異なるバージョンの環境で取得したバックアップファイルはリカバリーできません。同じバージョンの環境でバックアップとリカバリーを実行してください。異なるバージョンの環境で取得したバックアップファイルを使って,jssdbrecoveryコマンドを実行し,JP1/Service Supportを運用し続けた場合,その間にデータベースに登録されたデータやデータベースの状態が異常となります。
注意事項
-
jssdbbackup.batコマンドを実行すると,システム内部で複数の子プロセスが起動します。[Ctrl]+[C]キーなどでコマンドの実行を打ち切った場合も,子プロセスは実行を継続します。このため,コマンドの実行中に[Ctrl]+[C]キーなどで実行を打ち切らないでください。もし実行を打ち切った場合は,maintオプション指定時は「pdcopy」というプロセスが実行していないこと,expandオプション指定時は「pdrorg」というプロセスが実行していないことを確認し,しばらく時間を置いてからJP1/Service Support - DB Serviceサービスを再起動してください。
-
jssdbbackup.batコマンドの実行時にKNAB26102-Eのエラーメッセージが出力された場合は,次の原因に該当するかどうかを調査し,該当する場合は対策を実施してからコマンドを再実行してください。
-
ファイル名を相対パスで指定している。
-
バックアップファイル名にフォルダを指定している。
-
UNCパス指定になっている。
-
絶対パスで指定したバックアップファイル名が,259バイトを超えている。
-
フォルダに出力するバックアップファイル名が255バイトを超えている。
-
ファイル名にマルチバイト文字を指定している,またはOSで指定できない文字列を指定している。
-
ファイルを出力するドライブの空き容量が足りない。
-
-
jssdbbackup.batコマンドの-maintオプションを指定した場合,次の事項に注意してください。
-
-fオプションで指定するバックアップファイル名に大文字が含まれていた場合,小文字に変換されたファイル名でバックアップファイルが作成されます。
-
-
案件管理DBを拡張する場合の手順は,「11.2.4 案件管理DBのサイズ拡張」を参照してください。
-
-expandオプションを指定してjssdbbackup.batコマンドを実行してバックアップファイルを取得する場合,データベースの再編成も同時に実行されます。そのため,バックアップファイルをjssdbrecovery.batコマンドを使用してリカバリーする場合,バックアップ前にデータベースで使用していた容量よりも多くの容量が必要となるときがあり,リカバリーに失敗するおそれがあります。この場合,次の手順を実行してください。
-
-maintオプションを指定して取得したバックアップファイルを,jssdbrecovery.batコマンドを使用してリカバリーする。
-
jssitemdeletionコマンドを実行し,不要な案件データを削除待ち状態にする。
-
jssdelrecコマンドを実行し,削除待ち状態のデータを削除する。
-
-expandオプションを指定してjssdbbackup.batコマンドを実行する。
-
4の手順で取得したバックアップファイルをリカバリーする。
-
-
-oオプションを指定してjssdbbackup.batコマンドを実行する場合,毎回別の出力先フォルダ(空のフォルダ)を用意してください。また,バックアップファイル出力先フォルダに格納されたフォルダやファイルの名称を変更しないでください。それらを変更すると,リカバリーに失敗するおそれがあります。
-
JP1/Service SupportサービスおよびJP1/Service Support-Web Serviceサービスの実行中に-sdbオプションを指定したjssdbbackup.batコマンドを実行する場合,次の事項に注意してください。
-
jssdbbackup.batコマンドの実行中に,サービスを起動したり停止したりしないでください。
-
jssdbbackup.batコマンドの実行中に,案件保存DBを更新する操作(jssitemstore(案件保存)コマンドおよびjssstoreitemdel.bat(保存案件一括削除)コマンドの実行)をしないでください。案件保存DBを更新するコマンドを実行した場合は,それらのコマンドがエラー終了します。
-
使用例
バックアップファイル(c:\backup\backup)を作成する場合の指定例を次に示します。
jssdbbackup.bat -f c:\backup\backup -maint