Export and import views using the migration tool

The migration tool exports and imports Concert Operate views to back up view data or move views between environments.

Scope

The current scope includes the following capabilities:

  • Export Concert Operate views to JSON files.
  • Import Concert Operate views from JSON files that are saved by using the export tool.

Views

  • The tool exports and imports Concert Operate views by using dedicated utilities.

Configuration options

The tool provides built-in help for the export and import commands:


exportViews --help
importViews --help

Export and import functionality

The export and import commands back up and restore Concert Operate views or move them between environments.

Prerequisites

The API key user must have Manage all operational data permission.

Export views

Use the exportViews command to export views from Concert Operate to JSON files.

Example:
exportFilters -h <CPD_ROUTE_HOSTNAME> -p <ZEN_API_KEY> -o <output file>

This command exports supported views and saves them to the specified JSON output file.

Import views

Use the importViews command to import views from JSON files created by the export operation.

Example:
importFilters -h <CPD_ROUTE_HOSTNAME> -p <ZEN_API_KEY> -i <exported filters JSON file> -o <output directory>

This command reads the exported views JSON file and re-creates the views in the target environment. The tool writes results and summaries to the specified output directory.

Error handling and logging

The tool logs detailed status and error information during export and import operations to help diagnose failures.

Installation and deployment

Prerequisites

  • Docker or Podman

Installation

The migration tool is distributed as a Docker image and is available to entitled customers.

docker pull --platform linux/amd64 <LOCATION OF THE IMAGE IN REGISTRY>