9.7 npdatarestoreコマンド(環境復元)
機能
npdatabackupコマンド(環境退避)でバックアップしたデータを利用して,ナビゲーション プラットフォームの環境を復元(リストア)します。このコマンドはシステムが停止している状態で実行してください。
このコマンドは,実行環境および編集環境でだけ実行できます。開発環境では実行しないでください。
また,バックアップ時とリストア時のナビゲーション プラットフォームのバージョンは,同じである必要があります。
このコマンドを実行すると,既存のデータが削除または上書きされて,npdatabackupコマンドでバックアップしたデータに置き換わります。npdatabackupコマンドでバックアップされるデータについては,表9-3を参照してください。
- npdatarestoreコマンドで復元しないデータ
-
なお,ユーザプラグインおよびユーザ認証の設定ファイルは,ほかのシステムと同期して復元する必要があるため,このコマンドでは復元しません。
また,個別に取得した,ユーザプラグインが前提とするファイルや,データベースなどのユーザプログラムと連携するシステムのデータも,このコマンドでは復元できません。このデータは,必要に応じてユーザプラグインと同期して復元してください。
形式
npdatarestore△バックアップデータの格納ディレクトリのパス
npdatabackupコマンド実行時に指定したバックアップ先ディレクトリを,そのままバックアップデータの格納ディレクトリ(リストア元ディレクトリ)として使用することを推奨します。
ディレクトリは,絶対パス・相対パスのどちらでも指定できます。パスが長過ぎると処理に失敗することがあるため,パスの長さはナビゲーション プラットフォームのインストールディレクトリよりも短くなるように指定することを推奨します。
また,区切り文字には「\」を使用します。パスに半角スペースが含まれる場合は,パス全体を「"」で囲んでください。ディレクトリのパスで使用できる記号は,これら以外には半角のコロン(:)と相対パスを表す半角ピリオド(.)だけです。
注意事項
-
リストアする環境に必要な空き容量は,業務コンテンツの数および内容によって異なります。業務コンテンツで静的ファイルを使用している場合は,ナビゲーション プラットフォームインストールディレクトリ\PP\uCPSB\httpsd\htdocs以下の容量以上の空き容量を確保する必要があります。
-
リストア元ディレクトリのパスには,ネットワークドライブ以外を指定してください。
-
リストア元ディレクトリのパスに,ショートネームは使用できません。
-
リストア元に,npdatabackupコマンドで取得したデータ以外のデータが格納されたディレクトリを指定した場合は,エラーとなります。
-
バックアップ時とリストア時のナビゲーション プラットフォームのバージョン,リビジョン,および限定コードは,すべて同じである必要があります。
バックアップ時のバージョン情報については,バックアップ先ディレクトリ\HNP\sysconf\ucnpversion.propertiesで確認できます。
-
バックアップ時とリストア時のナビゲーション プラットフォームのインストールディレクトリは,同じである必要があります。
バックアップ時のインストールディレクトリは,バックアップ先ディレクトリ\installpath.txtで確認できます。
-
コマンドが正常終了した場合(戻り値が0の場合),ナビゲーション プラットフォームは自動的に起動するため,npstartコマンド(起動)を実行する必要はありません。
-
ナビゲーション プラットフォームのバージョンアップ後に,バージョンアップ前に取得したバックアップデータを復元する場合,バックアップ取得時と復元先のバージョンが異なるため,npdatarestoreコマンドは使用できません。この場合,「3.6.5 バージョンアップ手順」の説明を参照して,バックアップデータを復元してください。
-
このコマンドを実行するとナビゲーション プラットフォームが起動します。詳細については,「5.1.1 コマンドを実行してナビゲーション プラットフォーム(システム)を起動する」の注意事項を参照してください。
戻り値
戻り値 |
説明 |
---|---|
0 |
ナビゲーション プラットフォームの環境復元(リストア)に成功した。 |
1 |
ナビゲーション プラットフォームの環境復元(リストア)に失敗した。 |
2 |
コマンドの排他エラーが発生した。 |
9 |
実行権限のエラーが発生した。 |
使用例
リストア元ディレクトリが「C:\temp\backupdata」の場合の例です。
> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npdatarestore C:¥temp¥backupdata