Migrate

Details on how you migrate Designer to another instance.

To occasionally migrate data from one instance to another, you can export the XML data from one instance and import it to another. This document explains how to migrate Designer's configuration as well as diagrams with meta-data to another instance.

Migrate Designer Configuration

It is possible to migrate data to a new instance via an XML export of your current setup. This method has the advantage that all fields and values are transferred exactly.

Your export must include these files:

Class Definitions <x_inpgh_des_class_definitions>
Class Fields <x_inpgh_des_class_fields>
Diagrams <x_inpgh_des_diagrams>
Filters <x_inpgh_des_filters>
Global Settings <x_inpgh_des_global_settings>
Indicators <x_inpgh_des_indicators>
Indicator Breakdown <x_inpgh_des_indicator_breakdown>
Relationship Definitions <x_inpgh_des_relationship_definitions>
Relationship Fields <x_inpgh_des_relationship_fields>
Shapes <x_inpgh_des_shapes>
Shape Libraries <x_inpgh_des_shape_libraries>
Templates <x_inpgh_des_templates>
Cross scope privileges <sys_scope_privilege>
Global Settings <x_inpgh_des_global_settings>

Designer is built on the following ServiceNow tables which must also be migrated if any changes to their configuration have been made:

Images <db_image>
Relationship Types <cmdb_rel_type>
Suggested Relationships <cmdb_rel_type_suggest>

Similarly, if you have changed Designer's configuration, you must migrate these changes via UpdatedSets:

  • Field extensions (captured via UpdateSet)
  • Dashboards
  • Reports
  • Workflows

Migrate Diagrams between instances

To export diagrams plus metadata from an existing instance:

1. Select all to launch the ServiceNow navigator.

  1. Type ‘x_inpgh_des_diagrams.list’ into the search field. No results will appear but press return on your keyboard.
504504
  1. Your browser will send you to the diagram list page. Select checkboxes beside the diagrams you wish to export or select the all checkbox to select all diagrams.
  2. Right-click on any of the column heading and scroll down the options list and select Export > XML.
10341034
  1. Your ServiceNow instance will prepare an XML file containing all your diagrams and their metadata. Once this file is ready select Download.

Your browser will now download the XML file.

Import XML to a new instance

Once you have an XML file with your diagrams. You can import it to an alternative ServiceNow instance as follows:

1. Select all to launch the ServiceNow navigator.

  1. Type ‘x_inpgh_des_diagrams.list’ into the search field. No results will appear but press return on your keyboard.
504504
  1. Your browser will send you to the diagram list page. Right-click any of the column headers and select Import XML from the dropdown menu.
10421042
  1. Your browser will send you to the Import XML page. Select Browse, locate the XML file you want to upload and select Upload.