Virtual Appliance Migration

From Stratodesk Knowledge Base
Jump to: navigation, search

This article explains various aspects about VA migration.

Migrate the data from one VA into another VA instance

Your old instance must be up-to-date (1.0-554 at least). Do not migrate an old instance into a new one. Update the old one first, then migrate.

This section applies if you have two VA instances and you want to move data, configuration, images, etc from one instance over to the other one. Typically this happens if

  • you want to start with a new VA instance because the current one is too old (well, did you have a look at Updating the Virtual Appliance?)
  • you want to start with a fresh instance because the current one is somehow dysfunctional

Whatever the reasons are, migration to another VA instance is really simple:

  1. Log in to the old instance
  2. Ensure it is running up-to-date NTC and VA software, if necessary update both. Run at least VA software 1.0-554, as per Updating the Virtual Appliance.
  3. Click on the "Backup" main menu entry, then click on "Retrieve Backup". A file containing the backup data will be downloaded immediately to your desktop.
  4. Log in to the new instance, assuming it is a new, up-to-date appliance, also on the "Backup" main menu entry, but then click on "Restore prior backup". Upload the backup file there.
    • If this "fresh" instance contains any data you want to preserve, backup the new instance first, or else all data will be overwritten with the contents of the backup (of course).
  5. Our backup files do not contain actual client OS images to prevent excessive backup file size. Most likely you'll have had a few client OS images stored on the old VA. You need to upload them to new VA also. There a few possibilities, choose what is easier for you:
    • Get them from the old VA, e.g. by connecting to the "images" Windows file share that the VA offers. Download to your local machine, and then log in to the "images" Windows file share of the new instance, and upload them.
    • Download from Stratodesk and upload by clicking on "OS images" and subsequently "Upload OS image" in the new instance.
    • Or, if you like, copy them over via SSH login by executing these commands:
      • scp /opt/center/images/* newinstance:/opt/center/images
      • scp /var/www/pxe/* newinstance:/var/www/pxe
  6. Our advice is to shutdown the old VA instance now and assign its IP address to the new instance. If you must assign a new IP address, please read here: IP address change
  7. The backup contains the full NoTouch Center software. Thus, your new Virtual Appliance will now run on the same NoTouch Center version that you had in the old appliance. You may consider updating NoTouch Center.

Migrate the Virtual Appliance into another virtualization host

This section applies if you want to migrate the complete Virtual Appliance, as it is, from one virtualization host into another. This happens for example when

The good news is, there is nothing special about the Stratodesk Virtual Appliance. You can freely move it around, import/export, as you can do with any other virtual machine. Please refer

There are just some pieces of advice:

  • Before migrating, shut down the virtual appliance.
  • Should the Virtual Appliance become suspended, please reboot it afterwards.

A simple migration from one virtualized server to another usually does not trigger a change in IP address or host name. Should you have to change these, please refer to this article: IP address change