Quick Migration

Edited on December 14, 2016

Migration steps for v3.x to v3.2

Migration protocol (without moving the data)

  • Shutdown your controller and agents
  • Make sure your mongoDB instance is running and open a mongo shell
  • Drop the controllerlogs collection from your mongoDB instance :
    • MongoDB shell version: 3.2.4
      connecting to: test
      MongoDB> use step
      switched to db step
      MongoDB> db.controllerlogs.drop()
      true
  • If you want to make sure you're benefiting from the latest index adjustements, also drop all of the indexes of the different collections
  • Copy or move the old data folders (and libraries if you've added custom libraries) to save them in a different folder
  • Decompress the zip files of the controller and agent on their respective machines
  • Replace the old controller and agent folders with the new ones
  • Reimport your data but make sure to keep the folder structure of the new version
  • Boot the new agent and controller, proceed to log in with admin // init credentials
  • If you're not interested in our demo examples, you can clean them up manually or removing them directly from the artefacts and functions collections of the mongoDB instance via the "Demo_" prefix in their names

Migration protocol (clean slate)

With this protocol, you will only keep your test artefacts (test plans and keywords) but you'll get rid of all of the past executions

  • Shutdown your controller and agents
  • Make sure your mongoDB instance is running and open a system terminal
  • Assuming the mongo binaries are in your PATH, use mongodump to dump your "functions" and "artefacts" collections :
    • D:\> mongodump --db step --collection functions
    • D:\> mongodump --db step --collection artefacts
  • Then remove all of the files from inside the data/mongodb folder of your controller
  • Copy or move the old data folders (which may contain your scripts or libraries) to save them in a different folder
  • Decompress the zip files of the controller and agent on their respective machines
  • Replace the old controller and agent folders with the new ones
  • Reimport your data but make sure to keep the folder structure of the new version
  • Boot the new agent and controller
  • Go back to your system terminal, make sure you're still in the same folder as before and reimport the data :
    • D:\> mongorestore
    • You should see a summary of the number of documents that have been restored in each collection
  • Proceed to log in with admin // init credentials
  • If you're not interested in our demo examples, you can clean them up manually or removing them directly from the artefacts and functions collections of the mongoDB instance via the "Demo_" prefix in their names