Manually created topology backup

This page describes the process of exporting and importing manual topology data, i.e. components and relations that are not synchronized via StackPacks.

Requirements

Export manually created topology

To export all manually created components and relations to a file manual_topo.stj using the StackState CLI:

  1. Create the export file:

    sts graph list --manual --ids Component Relation \
    | xargs \
    sts graph export --ids \
    > manual_topo.stj
  2. Check the generated file manual_topo.stj to make sure it contains a correct export of all your topology.

Breakdown of the export command used in the example above:

  • sts graph list --manual --ids Component Relation lists all ids of manually created components and relations.

  • | xargs connects the graph list and graph export commands.

  • sts graph export --ids exports all graph nodes by ids.

  • > manual_topo.stj dumps the results in the file manual_topo.stj.

Import manually created topology

Manually created relations to synchronized components may fail on import if these synchronized components do not exist anymore.

To import topology and relation data from a file manual_topo.stj using the StackState CLI:

sts graph import < manual_topo.stj