English

Migrating a Deploy instance to a new virtual machine

Contributors dmp-netapp

You can migrate an existing instance of the Deploy administration utility to a new virtual machine using the command line interface.

This procedure is based on creating a new virtual machine that uses the configuration data from the original virtual machine. The new and original virtual machines must run the same version and release of the Deploy utility. You cannot migrate to a different version and release of the Deploy utility.

Backing up the Deploy configuration data

You must create a backup of the Deploy configuration data as part of migrating the virtual machine. You should also create a backup after deploying an ONTAP Select cluster. The data is saved to a single encrypted file that you can download to your local workstation.

Before you begin

Make sure that Deploy is not performing any other tasks during the backup operation.

About this task

The backup file you create captures all the configuration data from the virtual machine. This data describes aspects of your deployment environment, including the ONTAP Select clusters.

Steps
  1. Sign in to the Deploy utility CLI using SSH with the administrator account.

  2. Create a backup of the Deploy configuration data, which is stored in an internal directory at the Deploy server:

    deploy backup create

  3. Provide a password for the backup when prompted.

    The backup file is encrypted based on the password.

  4. Display the available backups in the system:

    deploy backup show -detailed

  5. Select your backup file based on the date in the Created field and record the Download URL value.

    You can access the backup file through the URL.

  6. Using a web browser or utility such as Curl, download the backup file to your local workstation with the URL.

Installing a new instance of the Deploy virtual machine

You must create a new instance of the Deploy virtual machine which you can update with the configuration data from the original virtual machine.

Before you begin

You must be familiar with the procedures used to download and deploy the ONTAP Select Deploy virtual machine in a VMware environment.

About this task

This task is described at a high level.

Steps
  1. Create a new instance of the Deploy virtual machine:

    1. Download the virtual machine image.

    2. Deploy the virtual machine and configure the network interface.

    3. Access the Deploy utility using SSH.

Related information

Installing ONTAP Select Deploy

Restoring the Deploy configuration data to the new virtual machine

You must restore the configuration data from the original Deploy utility virtual machine to the new virtual machine. The data is in a single file that you must upload from your local workstation.

Before you begin

You must have the configuration data from a previous backup. The data is contained in a single file and must be available on your local workstation.

Steps
  1. In a command shell on your local workstation, use the sftp utility to upload the backup file to the Deploy virtual machine.

    Example

    sftp admin@10.234.81.101 (provide password when prompted)
    put deploy_backup_20190601162151.tar.gz
    exit
  2. Sign in to the Deploy utility CLI using SSH with the administrator account.

  3. Restore the configuration data.

    deploy backup restore -path PATHNAME -filename FILENAME

    Example

    deploy backup restore -path /home/admin -filename deploy_backup_20180601162151.tar.gz