Administer > Maintain NNMi > Export and Import Configuration Settings > Import Configuration Files to Restore Previous Settings

Import Configuration Files to Restore Previous Settings

If you have a set of export files, you can change the Configuration settings on your NNMi management server to match the settings in the exported files.

Note You can change the names of the exported files before importing. The import still works the same.

Caution Do not edit the exported file before importing.

To import a previous snapshot of your configuration settings:

  1. Import behavior is determined when you generate the Export files. Make sure your exported files were generated in a manner that meets your current needs. See Export/Import Behavior and Dependencies (consider printing that topic for reference).

    Caution The locale setting on the NNMi management server at the time of Export must match the locale setting on the NNMi management server at the time of Import. Otherwise, you risk losing data. Also, make sure that both NNMi management servers have the same NNMi version/patch number.

  2. A user name and password are required with the import command:

    If you do not want to enter an NNMi User Name attribute value and an NNMi Password attribute value at the command line, you can use the nnmsetcmduserpw.ovpl command to specify the valid user name and password (instead of -u and -p). The credentials set using the nnmsetcmduserpw.ovpl command are valid for command execution by the same user.

    -u <NNMiadminUserName> -p <NNMiadminPassword>

  3. Check whether the configuration settings you want to import have dependencies, see Export/Import Behavior and Dependencies.

    • If no dependencies, import only the configuration settings you are planning to change.
    • If yes, decide if you need a copy of the dependencies (only if you made changes to those configuration settings, as well). Then import all the required files.
  4. At the command line of the NNMi management server, type the command to import a file:

    nnmconfigimport.ovpl -f <filename>

    When importing multiple XML files at once using -f <directory>, the NNMi nnmconfigimport.ovpl command takes care of ordering issues.

    • To import all configuration settings, use the following command:

      nnmconfigimport.ovpl -f <directory>

      You can use -x <file_prefix> to specify a unique prefix for a set of files:

      nnmconfigimport.ovpl -f <directory> -x <file_prefix>

    • To import specific configuration settings from multiple configuration areas, create a directory that contains the set of files you want to import.

      At the command line of the NNMi management server, type the appropriate command to import files:

      nnmconfigimport.ovpl -f <directory>

      You can use -x <file_prefix> to specify a unique prefix for a set of files:

      nnmconfigimport.ovpl -f <directory> -x <filePrefix>

    • To replace all of the corresponding configuration settings with those that were exported use the nnmconfigimport.ovpl -sync option as shown in the following example syntax:

      nnmconfigimport.ovpl -sync -f <directory>

      When you use the nnmconfigimport.ovpl -sync option, NNMi does the following:

      • NNMi replaces all object instances with matching key identifiers (see Troubleshooting Imports of Configuration Files for information about key identifiers).
      • NNMi adds all object instances with key identifiers that do not exist in the NNMi database
      • NNMi deletes all existing object instances with key identifiers that do not match any in the exported file.
    • To import configuration settings that were created by specific authors (for Device Profiles, Incident or URL Actions), create a directory that contains the set of files you want to import.

      At the command line of the NNMi management server, type the appropriate command to import the files:

      nnmconfigimport.ovpl -f <file>

      nnmconfigimport.ovpl -f <directory>

      You can use -x <file_prefix> to provide a unique prefix for a set of exported files:

      nnmconfigimport.ovpl -f <directory> -x <filePrefix>

  5. If you encounter problems, see Troubleshooting Imports of Configuration Files.

  6. After completing the import, open NNMi and verify your configuration settings.