Export and Import of Configuration Data 

Use

You can use the Export and Import functions to move individual configuration objects or larger parts of the configuration, including all referenced configuration data, between portals. For example, this allows you to transfer the configuration from a test system to a production system.

 

Features

Note the following special features after starting the export function:

●     The extended view of configuration objects is switched on.

●     Configuration objects that are otherwise hidden and used internally become visible.

●     You can browse the configuration hierarchy and display entries. You cannot edit configuration objects in this mode. You can only edit objects if you interrupt the export.

●     More functions, which you can normally launch by choosing Actions in the menu bar, are deactivated.

 

The name of the export package generated consists of the specified namespace and the name. The ending .configarchiv is assigned to the export package. It is compressed as a ZIP file and contains the configuration files in XML format.

 

Activities

Export

Starting the Export Function

To start the export function, choose Actions ® Export ® Start.

 

Putting Together the Export Package

In the configuration, navigate to the object that you want to export. Select the required instance and choose Export.

From the options, you can choose whether referenced configuration objects are to be exported as well. If you have activated this option, you can use another option to specify whether invalid references are also to be exported.

You can also put the export package together through the menu. Choose Actions ® Export ® Add. This allows you to choose not only individual instances, but also subareas of the configuration, for example, all repository managers.

 

In the menu, the following options are available:

●     Topic: Adds all instances of a configuration object to the export package.

●     Topic Area: Adds all configuration objects in the current area and their instances to the export package.

●     Topic Area and Related Areas: Adds all configuration objects in the current area and their instances to the export package. In addition, the system includes the configuration objects and their instances that are listed in Related Areas.

●     Complete Configuration: Adds the entire configuration to the export package.

 

Editing the Export Package

To edit an export package, choose Actions ® Export ® Edit Export Package. You can remove configuration objects by deselecting the checkbox in front of the object and choosing OK.

You can also start this function to check which entries the export package currently contains.

 

Interrupting and Continuing the Export

To interrupt an export and switch to the normal mode to edit the package, choose Actions ® Export ® Suspend.

To resume an interrupted export, choose Actions ® Export ® Resume.

 

Completing the Export

To complete the export, choose Actions ® Export ® Finalize Export.

The selected configuration objects are listed and, if necessary, the configuration objects that they reference.

Specify a name and namespace for the configuration archive to be exported.

Configuration Archive Name  = config-december-2005

Configuration Archive Namespace  = mycompanynamespace

 

Choose OK. Choose Download and save the configuration archive with the ending .configarchive. The export is completed.

 

Canceling the Export

To cancel an export, choose Actions ® Export ® Cancel.

 

Import

Starting the Import

To import a configuration archive, choose Actions ® Import.

Select for import the configuration archive with the ending .configarchive and choose Preview.

The system displays the objects that are added to the configuration, replaced in it, or deleted from it.

If the configuration archive is identical to the existing configuration, the system does not import the file.

To import the file, choose OK.

If errors occur during the import, you can display them. To do this, choose See Technical Details.

For the imported configuration data to take effect in the system, you must restart the portal.