System Importer enables you to import data to your system from a ZIP file. 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.

To open the System Importer, go to Manage → Tools & Monitoring and then select System Importer.

The System Importer

Available entries: Contains a tree layout view of the data you can select to import.
Logs: Contains a log of the import process

Importing

To import data/configurations using the System Importer:

Select the appropriate options according to your preferences by clicking the Options button.
Click the Select File... button to select the directory where the data to be imported is located. Alternatively, you can also drag and drop the file in the Drop file here area.
The System Exporter with Logs

Note!

See File System Profile to learn how to configure a File System Profile. Currently, System Importer only allows to use File System Profile using legacy desktop.

In the Available Entries field, expand the folders and select the check boxes for the entries you want to import. You can also use the Search field to find the appropriate entry to import.
Click on the Import button to start the import process. After the import is completed, the Available entries field is cleared of all directories and the selected file is also removed.
- You can perform an initial test import to check for any errors. To do this, click the Dry run button. This does not actually import the entry into Configurations. When the Dry Run is complete, the Available entries field is not cleared off and the selected file is not removed. You can proceed to click the Import button to import data.
  
  Dry run logs
- Upon clicking the Import Import button, it immediately changes into the Abort button, which enables you to cancel the Import process. After clicking abort, the file is removed and you will need to reimport the file to continue the import.
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 System Exporter.
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.

Options

Click the Options button to open the Options window. This window has multiple settings such as:

Import options
New owner
Workflow groups executions suppress option

The Options menu

Import options

Import options
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 Values	Select 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.
Import Configuration From Package	Select this option if you would like to import the Workflow Package (MZP) as a configuration instead of a Workflow Package.
New Owner: Use this drop-down menu to reassign the ownership of configurations to another user, during an import.
Workflow groups executions suppress option
No Suppress	Select this if you do not want to suppress the workflow group execution.
Hold Execution	Select this option to prevent scheduled Workflow groups from being executed while importing configurations.
Restart	For information, see systemimport in the Command Line Tool user's manual.
Stop and Restart	For information, see systemimport in the Command Line Tool user's manual.
Stop Immediately and Restart	For information, see systemimport in the Command Line Tool user's manual.
Wait for Completion and Restart	For information, see systemimport in the Command Line Tool user's manual.

Click the button to obtain these options for the folders available to import:

Other options

Other options
Expand All	Select this option to expand all of the folders to display the folders and all the configurations that they contain.
Collapse All	Select this option to collapse the folders so only the folders are visible.