Table of Contents

Data Aggregator Migrator

The Data Aggregator Migrator should be used after upgrading the Data Aggregator DxM from version 2.x.x to 3.x.x or higher. This one-time migration process is only necessary if the prior installation included configured GQI queries.

You can download the tool from DataMiner Dojo.

Tip

See also: Data Aggregator

Using the Data Aggregator Migrator

  1. Install the Data Aggregator Migrator on a DMA.

  2. After downloading the files, extract them to a local folder, and place them on the server hosting Data Aggregator.

  3. Use the migration tool with the following options:

    Option Description
    -i File location of appsettings.custom.json (typically C:\Program Files\Skyline Communications\DataMiner DataAggregator\appsettings.custom.json)
    -o Use when another URL is configured in appsettings.custom.json (e.g. https://10.10.15.32:22345)
    • If there is no specific URL configured in the appsettings.custom.json file, execute this command to perform the one-time migration:

      .\"DataMiner DataAggregator.Migrator.exe"  -i "C:\Program Files\Skyline Communications\DataMiner DataAggregator\appsettings.custom.json" 
      
    • If one or more specific URLs are configured in the appsettings.custom.json file, execute this command to perform the one-time migration:

      .\"DataMiner DataAggregator.Migrator.exe"  -i "C:\Program Files\Skyline Communications\DataMiner DataAggregator\appsettings.custom.json" -o "https://10.10.15.32:22345/api/" 
      
  4. Verify the migration was successful:

    • The configuration of the queries from appsettings.custom.json is migrated to the Helper.json file located at C:\Program Files\Skyline Communications\DataMiner DataAggregator\Data Sources.

    • The JSON files containing the queries have been moved to C:\Program Files\Skyline Communications\DataMiner DataAggregator\Data Sources\Scripted Connectors.