Name

nnmrestoreembdb.ovpl — restore a full backup of the NNMi embedded database

SYNOPSIS

nnmrestoreembdb.ovpl [-?|-h|-help] [-force] -source <backup file>

DESCRIPTION

Use the nnmrestoreembdb.ovpl script to restore a full backup of the NNMi embedded database. Create the backup file required for the restore using the nnmbackupembdb.ovpl script. Because query planning statistics are not backed up, these statistics are gathered as part of the restore procedure to ensure good database performance after a restore.

If you plan to use the nnmbackupembdb.ovpl script to create a backup of the NNMi embedded database, then use the nnmrestoreembdb.ovpl script to place embedded database records on a second NNMi management server, both NNMi management servers must have the same type of operating system and NNMi version and patch level.

Before running the nnmrestoreembdb.ovpl script, make sure the embedded database is empty. You can do this by running the nnmresetembdb.ovpl script. If you do not clear the embedded database, the restore procedure runs the nnmresetembdb.ovpl script for you and the restore fails if the nnmresetembdb.ovpl script fails.

Do not run this script while NNMi is running unless you specify the -force option. Only the nmsdbmgr process can (and must) be running when you run the nnmrestoreembdb.ovpl script. You must be logged in as as administrator on Windows systems or root on UNIX systems, to run this script.

Parameters

-source <backup file>

The file to use when restoring the backup. This file must be a file that was created using the nnmbackupembdb.ovpl script.

-force

If you provide this option, the script stops NNMi if it is currently running, then starts the nmsdbmgr process.

-?|-h|-help

Display script usage.

EXAMPLES

Use this script to run a full database recovery when a restore from backup becomes necessary.

You will see these messages:

# nnmrestoreembdb.ovpl -source /backups/nnmDb.dump

WARNING: Running this command while NNMi is running will cause sporadic
         failures in active sessions. Please ensure that only the nmsdbmgr
         process is running when executing this command (ovstart nmsdbmgr).
Are you sure you want to run a full database restore now? [n] y

Ok, performing full embedded database restore...
Statistics analysis completed successfully.

NNMi embedded database successfully restored from /backups/nnmDb.dump.
#
      

AUTHOR

nnmrestoreembdb.ovpl was developed by Hewlett Packard Enterprise.

FILES

nnmrestoreembdb.ovpl resides in the following directories:

  • Windows: %NNM_BIN%

  • UNIX: $NNM_BIN

SEE ALSO

ovstart(1M), ovstop(1M), ovstatus(1M), nmsdbmgr(1M), nnmbackupembdb.ovpl(1M).

Return to Reference Pages Index