Skip to main content
Version: 3.2

Elevate 2.5 to Elevate 3.2

Upgrade from a version 2.5 instance​

Consider how much customization has been done to the configuration. If only a small number of changes have been made to the existing json files, it will likely be easier to start fresh with a new default configuration, in which case, follow these steps:

  1. Install Elevate files.
  2. Perform the steps for installing a new instance.
  3. Remove the extra Elevate PI Collector service entry run sc delete FusionPICollector<instance>
  4. Remove the Tags Service entry: run sc delete FusionTagsService<instance>
  5. The queues folder has likely changed. The previous default was ProgramData\Uptake Queues and is now ProgramData\UptakeQueues. If any files are in a sub-folder of Uptake Queues, move them to an appropriate sub-folder of UptakeQueues.
  6. Remove old json and log files. (This is an optional clean-up task.)
  7. Remove old devices from the IoT hub. (This is an optional clean-up task.)

To keep/migrate all of the existing 2.5 configuration do the following:

  1. Open a command prompt as administrator and go to the Elevate\Configuration directory in Program Files.
  2. Run Configuration.Console.exe add -host <your IoT hub host name> -device ElevateControl
  3. Run Configuration.Console.exe migrate -upload
  4. Navigate to the storage account, configuration container, and edit the configuration.json blob:
  • For each queue in Queues, change ContentEncoding from "utf8" to "gzip" and ContentType from "application/gzip" to "application/json"
  • For each instance in ModelReaderInstances, change Modules.StateSets.Output.WriteTo from "statesets.csv" to "statesets.csv.gz"
  1. For PI, run Configuration.Console.exe install -user <service user> -password <service user password> -start -service ModelReader,TagsService,StoreAndForward,PICollector,PipesCollector,PIOutageHandler,EventFramesCollector,UploadService
  2. For Geo SCADA, run Configuration.Console.exe install -existing -start
  3. Remove extra Elevate PI Collector service entry run sc delete FusionPICollector<instance>
  4. Remove Tags Service entry run sc delete FusionTagsService<instance>
  5. Update IoT hub devices twin configuration:
  • Navigate to IoT Hub and open Devices.
  • For each time-series data device:
    • Click on the device and click Device Twin.
    • Look for the "tags" section. If it exists, edit it; otherwise, add it below "version"
    "version": 2,
    "tags": {
        "ElevateVersion": "3.2",
        "ElevateMachine": "elevatehostname",
        "ElevateDeviceType": "Data"
    },
  • For each event frames device:
    • Click the device and click Device Twin.
    • Look for the "tags" section. If it exists, edit it; otherwise, add it below "version"
    "tags": {
        "ElevateVersion": "3.2",
        "ElevateMachine": "elevatehostname",
        "ElevateDeviceType": "Events"
    },