6.13 System Importer

System Importer enables you to import data to your system, either from a ZIP file, or from a specific directory. The import contains data about your system, its configurations, and run-time information.

System Importer imports data that has been exported by the System Exporter. Every time you import data, System Importer will save a backup file that contains all the imported data. This file is stored on the Platform computer, under $MZ_HOME/backup/yyyy_MM, by the name import_<date>_<filename>.zip.

The file exported by the System Exporter can contain data from the following folder types:

  • Configuration: Workflow configurations, agent profiles, Workflow groups, Ultra formats, or alarm detectors.

  • Run-Time: Data that is generated by the system during workflow run-time.

  • System: Other customized parts such as: ECS, Event Category, Folder (structure), Pico Host, Ultra, User, or Workflow Alarm Value.

Note!

Before using System Importer consider the following:

  • Historical data is not included in the export.

  • Imported Event Notifications will be disabled. You must enable these manually.


Note!

You can also export dynamic workflows and external references values, however you have to actively choose them. These are not imported by default.

Importing

To open the System Importer, click the Tools button in the upper left part of the Desktop window, and then select System Importer from the menu.

 

The System Importer


The Edit Menu

Abort On Error

Select this option to abort the import process if an error occurs. If an error occurs and you do not select this option, the import will be completed, but the imported data might contain erroneous components.

Note!

Invalid Ultra and APL definitions are considered erroneous, and result in aborting the import.

Import external reference database valuesSelect this option if you want to import external reference values.

Select Dependencies

Select this option to have dependencies follow along with the entries that you actively select.

Preserve Permissions

Select this option to preserve user permissions in the current system when importing a configuration. Clear this option to accept overwriting of user permissions in the current system.

Directory Input

Select this option to enable the import of unpacked data that have been exported to a directory. For further information, see Exporting, in 6.12 System Exporter. Clear this option to import a ZIP file.

Hold Execution

Select this option to prevent scheduled Workflow groups from being executed while importing configurations.

Restart

For information, see 2.2.33 systemimport in the Command Line Tool user's manual.

Stop and Restart

For information, see 2.2.33 systemimport in the Command Line Tool user's manual.

Stop Immediately and Restart

For information, see 2.2.33 systemimport in the Command Line Tool user's manual.

Wait for Completion and Restart

For information, see 2.2.33 systemimport in the Command Line Tool user's manual.

View Menu
View Log

Select this option open a log of the import process.

Import Log

Collapse All


Select this option to collapse the folders so only the folders are visible.

Expand All

Select this option to expand all of the folders to display the folders and all the configurations that they contain.
Buttons and Fields

Input Source

Click on the Browse button to select the path and enter the name of the file where the data that you want to import has been saved.

New Owner

Use this function in the case you need to reassign the ownership of the configurations to another user, during an import.

Available Entries

Contains a tree layout view of the data you can select to import.

Import

Click on this button to import the selections from the Input Source address to your system. The Import button will change into Abort, which enables you to cancel the Import process.

Note!

If the configuration directory structure is not identical to that of the exported material, the import will fail.


To Import Data:

  1. In the System Importer, select options according to your preferences in the Edit menu.
     

  2. Click on the Browse button to select the directory where the exported data is located.

    Hint!

    To configure what default directory you want to have when you click the Browse button, add the Desktop property mz.gui.systemimport.default.dir, and the value must be the full path to an existing directory, e g /home/mz.

    The Importer will also remember the last directory from which and import was made, and will open the file browser in this directory the next time you click on the Browse button. This directory will be kept in memory until the Desktop is closed.

  3. In the Available Entries field, expand the folders and select the check boxes for the entries you want to import in the Include column.
     

  4. Click on the Import button to start the import process.
     

  5. Update the dynamic configuration data in the collectors with the file sequence numbers, that you had noted down before performing the Export. For further information, see the section, To Export Data, in 6.12 System Exporter.
     

  6. Enable all the workflows that are configured with Scheduling.

  • Prior to importing Inter Workflow and Aggregation profiles, empty the Workflow data stream. Otherwise, these agent profiles will be overwritten by the profiles that are included in the imported bundle, and might not recognize or reprocess data.

  • Imported Workflow groups are disabled by default. You need to activate all the members, their respective sub-members, and the workflow group itself.

  • When you import a User it is disabled by default. A User with Administrator permissions must enable the user and revise which Access groups the user should be assigned to.

  • Imported Alarms are disabled by default. You enable an Alarm from the Alarm Detection.

  • Imported Event Notifications are disabled by default. You enable an Event notification from the Event Notification Configuration.