...
The export can contain your system's data, configurations, and runtime data. You can send this export data to another system, using the System Importer to import it and embed its contents locally.
| Info |
|---|
Example - How System Exporter can be used You can import a tested and exported ZIP or MZP file of configurations from a test system and use it safely in production. |
...
Configuration: Workflow configurations, Profiles, Workflow groups, Ultra formats, alarm detectors, etc.
Workflow packages: Workflow Packages are compiled versions of configuration, and are created in the Workflow Package mode in the System Exporter.
Execution Context Deployments: Created ECDs can be selected. See Execution Context Deployments (ECDs) (34.30).
When exporting External References profiles of type Properties Database or Kubernetes Properties the External Reference Values will also be exported. In System Importer it can be selected if they should be imported or not.
When exporting a Workflow Template with Dynamic Workflow Configuration enabled, the Dynamic Workflows will also be exported. You can specify in the System Importer if they should be imported or not. See Workflows(4.0)
This section describes the following:
| Table of Contents |
|---|
Export Types
There are two export types. They result in different behaviors when imported later. Select the one that suits your requirements:
Configuration: The configurations must be compatible with the software packages of the system to which you import the configurations This is normally not a problem as long as you are using the same release. The export will be downloaded as a ZIP file. See Configuration Export Type.
Workflow Package: Export in Workflow Packages(34.30) format. A Workflow Package is read-only and self-contained, with the same binaries as in the exporting system. A Workflow Package is not affected by, nor will it affect, any existing configurations when imported, since the used binaries are not replaced. When selecting Workflow Package Export Type, you compile a Workflow Package by selecting workflows in the Available Entries table. All dependent configurations will also be selected. See Workflow Package Export.
| Note |
|---|
Note! See File System (4.0) to learn how to configure a File System Profile , used when exporting to Git or AWS S3 Bucket. |
| Anchor | ||||
|---|---|---|---|---|
|
You can export a configuration to your local browser or remote with a File System Profile of type Git or AWS S3. Currently, Git is available in Desktop Online only.
...
When the Export Type is Configuration you can select data from the following types:
...
Option | Description |
|---|---|
Export | This will export the selected configuration(s). The behavior is different depending on your choice of Destination. Described in detail below. |
Refresh | Refreshes the list of shown configurations. |
Options | This will open the Options menu. Each available option can be toggled by the user. See more below. Configurations Export Type Options |
Expand all | Expands all folders in the Available entries section. |
Collapse all | Minimizes all folders in the Available entries section. |
| Anchor | ||||
|---|---|---|---|---|
|
Based on the chosen options in the export window, the running System system will execute the export operations differently.
...
Export Option | Description | ||
|---|---|---|---|
Abort on error | Select this option to abort the export process if an error occurs. If an error occurs and you do not select this option, the export will be completed, but the exported data might contain erroneous components.
| ||
Select Dependencies | Select this option to have dependencies follow along with the entries that you actively select. | ||
Encryption | Activates encryption on the chosen export. | ||
Exclude Runtime Data | When enabled it excludes locally stored runtime data from the export. The runtime data that can be included is, Aggregation Session Data and Archive data | ||
Export as XML | Exporting configuration objects with this option enabled will create compressed XML files instead of JSON. |
...
Exporting to Local Destination
Click When the Export button to start the export. When the export to Local Destination is complete, a dialog showing the exact time of the export appears, and the export is automatically downloaded and saved in your default download location.
...
...
Exporting to Remote Destination
When you click the Export button, the following dialog opens and you need to select a File System (4.0). You can select the File System Profile either as Git or AWS S3.
...
Option | Description |
|---|---|
Commit message | The message will be visible in the Git log. |
Repository/Branch | Read-Only Field, showing the Remote repository name and the branch selected in the profile. |
Select Target Folder | A table showing the folders in the current repository, see GIT Support |
New Folder Button | Create a new folder on the root level. |
New Folder Icon on each row  | Create a new folder under the selected row |
...
Option | Description |
|---|---|
File Name | The file name of the export. It will automatically become a Zip file. |
Select Target | A table showing the folders in AWS S3 Bucket. Select a folder to export to, when no folder or file is selected the export will be uploaded to Bucket the top level of the Bucket. |
| Anchor | ||||
|---|---|---|---|---|
|
...
When this type is selected, Workflow Packages(4.0) can be created and exported as a MZP file. A Workflow Package is read-only and self-contained, with the same binaries as in the exporting system. A Workflow Package is not affected by, nor will it affect, any existing configurations when imported, since the used binaries are not replaced. When the Export Type is Workflow Package you can select data from the following types:
Configuration: Workflow configurations, agent profiles, workflow groups, Ultra formats, or alarm detectors.
System: Other customized parts such as; Data Veracity, Event Category, Folder (structure), Pico Host, Ultra, User, or Workflow Alarm Value.
...
When one configuration is selected all dependent configurations will also be selected.
Export Option | Description |
|---|---|
Export | The behavior is different depending on your choice of Destination. Described in detail below. |
Refresh | Refreshes the list of shown configurations. |
Options | This option is not available in workflow package selection mode. |
Expand all | Expands all folders. |
Collapse all | Collapses all folders. |
...
Exporting to Local Destination
When the Export button is clicked new dialog box will be opened to you select to export to Local Destination, the following dialog box opens. In this dialog box, specify the Package name and Package version. The Output option can also be chosen – the file can either be downloaded to your browser as an MZP file or committed (inserted) to the system.
...
Workflow package export optionsSpecify the following information in the Workflow package export options:
Package name: The name of the workflow package.
Package version: The version of the workflow package.
Output option: Specify if you want to Download or Commit the output option of the workflow package. When you select the Commit option for output Select the Download option if you want to download the file to your browser as an MZP file or select the Commit option to create the Workflow package is created and then imported import into the current system.
...
Exporting to Remote Destination
When the Export button is clicked new dialog box will be opened to first choose a you select to export to Remote Destination, the following dialog box appears. Select the File System Profile of type AWS S3. When the profile is selected more fields will show.
...
Workflow package export options
Specify the following information in the Workflow package export options:
...
How To Perform an Export
| Note |
|---|
Note! Since no workflow state, i.e. File Sequence Number, is included in the exported data and only the initial value is exported, you need to take note of information such as file sequence numbers in Collector agents. |
Select Export Type, Configuration, or Workflow Package.
Select Destination, Local or Remote
In the System Exporter, select options according to your preferences in the Options dialog.
Expand the folders in Available Entries and select the checkboxes in the Include column for the entries you want to export.
Click on the Export button to start the export process or to fill in the information regarding the Remote destination or Workflow Package name.