---

Note - This feature may or may not be available on your system, depending on your licensing agreement.

---

This chapter explains the following topics:

• Database Requirements
• Main Console GUI
• Topology Export Utility
• Topology Import Utility
• Import/Export CLI Interface
• Import/Export File Contents

  The Topology Import/Export Utilities enable Sun Management Center users to import or export the topology database from or to an ASCII file. The import utility is used to read data from a file and update the topology database and the data of the topology agent object. The export utility reverses this operation.

The Topology Import/Export Utility is used to:

• Dump the topology data as backup regularly.
• Transfer data between different topology servers.
• Restore the data from backup if the topology data is damaged.
• Convert the data into the another file format and load it into another management system in a third party management platform.

This utility can be invoked from the Sun Management Center console main window and the CLI. Users must specify the objects (the complete topology data and specified domains) to be imported or exported. The tool supports several methods of data handling, including overwrite and append.

• The import/export utility supports domain level operation. You can specify one domain to export or the whole topology hierarchy.
• The import utility allows you to retain backup data.
• You can import objects of any domain to one domain.
• The export utility allows you to back up the existing data.
• You can export data in incremental mode.

Database Requirements

The Topology Import/Export Utility communicates with the Sun Management Center server via client APIs. The operation on XML format file is based on xml.jar (Java X project). FIGURE 21-1 shows the import/export software structure.

FIGURE  21-1 Software Structure

For export, two modes are provided: Append and Overwrite. In Overwrite mode, the dumped data will overwrite the file whether or not the file already exists. In Append mode, the dumped data is added to the end of the file.

For import, two modes are provided to process the domain information contained in the dumped file. The first mode is to ignore the domain information; all objects are created in the specified or home domain. The second mode is to import domain information together with all other objects. In this case, new domains can be created and all nondomain objects are created in the corresponding domain.

Main Console GUI

The Main Console GUI has an individual menu item in the Tools menu for each operation: Topology Import and Topology Export. The export operation is only available when the current topology hierarchy contains data. Thus, the Topology Export item is gray (inactive) when the topology hierarchy is empty.

FIGURE  21-2 Tools Menu on the Sun Management Center Main Console

Topology Export Utility

You can start the Topology Export Utility from the main console window or the CLI, which is described in the "Import/Export CLI Interface".

To Start the Export Utility

Select Tools Topology Export from the Main Console GUI.