Hitachi

JP1 Version 12 JP1/Navigation Platform Setup and Operations Guide


9.7 npdatarestore command (restore environment)

Description

This command restores environments for Navigation Platform using the data that was backed up by the npdatabackup command (back up environment). Execute this command while the system is stopped.

This command can be executed only in the execution environment and the editing environment. Do not execute this command in the development environment.

The Navigation Platform version used during restoration must be the same as the Navigation Platform version used during backup.

When this command is executed, existing data is deleted or overwritten and replaced with the data that was backed up by the npdatabackup command. For details about the data that is backed up by the npdatabackup command, see Table 9-3 Data that is backed up.

Data that is not restored by the npdatarestore command

The settings files for User Plugins and user authentication are not restored by this command because they need to be synchronized with other systems.

In addition, the files required by User Plugins that have been acquired separately and the data such as databases in the system that are linked with user programs cannot be restored by this command. If necessary, restore the data synchronously with the User Plugins.

Format

npdatarestoreΔbackup-data-storage-directory-path

We recommend that you use the backup directory specified during execution of the npdatabackup command as is as the backup data storage directory (restoration source directory).

You can specify for the directory an absolute path or a relative path. We recommend that you specify a path that is shorter than the Navigation Platform installation directory because if the specified path is too long, processing might fail.

Use backslashes (\) for the delimiters. If a path contains a single-byte space, enclose the entire path in double quotation marks ("). In addition to these symbols, the only other symbols permitted in directory paths are single-byte colons (:) and single-byte periods (.) that indicate relative paths.

Notes:

Return value

Return value

Description

0

Navigation Platform environment restoration processing was successful.

1

Navigation Platform environment restoration processing failed.

2

A lock error occurred on the command.

9

An execution permission error occurred.

Note:

The return value is undefined if the command is terminated by a cause beyond the command's control (such as when the command is terminated forcibly by pressing the Ctrl key and the C key at the same time).

Example

This example assumes that the restoration source directory is C:\temp\backupdata:

> Navigation-Platform-installation-directory\bin\npdatarestore C:\temp\backupdata