Egnyte Help Desk

Storage Sync 11.0 Migration Guide

Storage Sync 11.0 needs to be deployed as a new Virtual Machine since we have re-architected the solution on a 64-bit OS with the latest CentOS 7.1 package. This implies you cannot perform an in-place upgrade of Storage Sync software from version 10.3 to version 11.0.

What gets Migrated

  • Previously Synced Data
  • Sync Configuration Settings
  • User Mappings
  • Synced Folders Settings

What does NOT get Migrated

  • System and Network Settings [Hostname and IP address]
  • Cloud Admin Account Settings
  • AD / Egnyte Authentication
  • Software Update Policy
  • Local device user credentials

There are two ways to migrate data from the existing Storage Sync version 10.3 to 11.0:

Attaching the Existing Data Disk

Use this method if you do not have sufficient storage in the ESX data-store to duplicate the Storage Sync dataset.

VM to VM Data Copy

Use this method if you have sufficient storage to duplicate the dataset. This eliminates business down time and builds data redundancy. You can delete the 10.3 VM after the migration has completed and the new 11.0 VM is functional.

The 10.3 VM has data disk(s) assigned to it that contains synced data as well as Storage Sync configuration data. This procedure involves moving (or cloning) the data disk(s) from the 10.3 Storage Sync VM and attaching the virtual disk(s) to the 11.x Storage Sync VM.
  1. If the existing Storage Sync is not on version 10.3, update the device to version 10.3.
  2. Complete a final sync on the 10.3 VM.
  3. Deploy a new 11.0 Storage Sync VMDO NOT add a 2nd Virtual Disk !! Leave the VM powered off.
  4. Power down the 10.3 Storage Sync VM.
  5. Remove the data disk from the 10.3 Storage Sync VM.

     In the vSphere client, click on the 10.3 VM and click Edit Settings. Verify that the correct 10.3 VM is selected.  Find and select Hard Disk 2, the Storage Sync data disk. Ignore Hard Disk 1 as this is the system disk. Click Remove once the appropriated devices(s) have been selected.

6. Move the virtual disk(s) from 10.3 to the 11.0 folder in the ESX Datastore Browse UI

Click on the ESX Server located in the top left corner of the vSphere Client, and select the “Configuration” tab.  Then access the Storage hardware, right click the appropriate datastore and select “Browse Datastore”



Locate the 10.3 VM folder in the datastore.  In this example, the 10.3 VM folder is called Hari1033 – the file(s) that need to be moved to the new location are the virtual disk files that we’ve removed in Step 5.  In the example, the virtual disk file is called Hari1033_1.vmdk.  Right click on the file(s) and select “Move to…”



Select the target location, first by selecting the datastore and the folder that contains the 11.0 VM, in the example Hari-11-650M is the target folder.  Click on “Move” to place the vmdk file(s) to the new destination.



 7. Attach the data disk(s) from 10.3 to the 11.0 Storage Sync VM

On the 11.0 VM, click on “Edit Settings” and then “Add

Select Hard disk, and “Use and existing virtual disk – Reuse a previously configured virtual disk

Click “Browse…” and select the appropriate datastore; locate the 11.0 VM folder that the virtual disks now reside.  Select the _1.vmdk and take the default SCSI settings.  Click “Finish” to complete the disk add.  Add additional data disks as required.

 

8. Start the 11.0 VM

  • If DHCP is enabled, open a web browser and navigate to the IP address and port listed on the console i.e. http://Storage-Sync-IP-Adress:8806
  • If DHCP is not enabled, login to the console and set the network settings including static IP via the egnyteservice config menu.
    1. Login to the VM with egnyteservice and its credentials egnyteelc
    2. Access the menu by entering the config command - i.e. > sudo config_network

9. Complete the install process

10. If Egnyte Authentication method was selected in the 10.3 VM, users will need to update their device passwords

.
 
 
The VM to VM Data Disk Copy involves deploying a new VM and provisioning new data disks. This process copies the data from the original Storage Sync 10.3 device to the 11.0 Storage Sync VM.
  1. If the existing Storage Sync is not on version 10.3, update the device to version 10.3.
  2. Deploy a new 11.0 Storage Sync VM.
  3. Login to the 11.0 Storage Sync VM on the console with the egnyteservice credentials.
  4. Download the rsync_data_migration.sh script
  5. Use winscp or a similar application to copy the script to the Storage Sync /home/egnyteservice folder with the following credentials: egnyteservice / egnyteelc
  6. Run the migration script as follows:
    a. Change permissions on the script

    > chmod +x rsync_data_migration.sh

    b. Start the script
    > ./rsync_data_migration.sh [IP-address-of-10.3-Storage-Sync]

    c. When prompted enter root credentials for the 10.3 Storage Sync
    Logging can be found in /home/egnyteservice/migration.log

  7. Complete the install process via the Storage Sync UI. 
  8. If Egnyte Authentication method was selected in the 10.3 VM, users will need to update their device passwords.

The 10.3 VM has data disk(s) assigned to it that contains synced data as well as Storage Sync configuration data. This procedure involves moving (or cloning) the data disk(s) from the 10.3 Storage Sync VM and attaching the virtual disk(s) to the 11.x Storage Sync VM.
  1. If the existing Storage Sync is not on version 10.3, update the device to version 10.3.
  2. Complete a final sync on the 10.3 VM.
  3. Deploy a new 11.0 Storage Sync VMDO NOT add a 2nd Virtual Disk !! Leave the VM powered off.
  4. Power down the 10.3 Storage Sync device.
  5. Remove the data disk(s) from 10.3 Storage Sync VM

    In Hyper-V Manager, click on the 10.3 VM and then select “Settings…”. Verify that the correct 10.3 VM is selected and that the correct Hard Drive is selected – in this case the SCSI Hard Drive called “10-3-hyperv-data1.vhdx” is the data disk to be removed.  Ignore the “system.vhd” Hard Drive.  Click on Remove, once the appropriate device(s) have been selected.



    Confirm the disk has been removed from the Hyper-V VM.

  6. Move the virtual disk(s) from the 10.3 to the 11.0 folder on the Hyper-V Manager Host.

    Use Windows Explorer to move the location of the data disk(s) to the new virtual disk location for the Storage Sync 11.0 VM.

  7. Attach the data disk to 11.0 Storage Sync device
    In Hyper-V Manager, select the 11.0 Storage Sync VM and click on “Settings…

    Add Hardware and SCSI Controller should be highlighted if they have not been added yet.  Click “Add”.



    Select “Browse…” to add the data disk from the 10.3 Storage Sync VM



    Confirm that the original data disk has been added to Storage Sync 11.0



    Repeat the add process for any additional data disks.

  8. Start the 11.0 VM
    1. If DHCP is enabled, open a web browser and navigate to the IP address and port listed on the console i.e. http://Storage-Sync-IP-Adress:8806
    2. If DHCP is not enabled, login to the console and set the network settings including static IP via the egnyteservice config menu.
      1. Login to the VM with egnyteservice and its credentials egnyteelc
      2. Access the menu by entering the config command - i.e. > sudo config_network
  9. Complete the install process 
  10. If Egnyte Authentication method was selected in the 10.3 VM, users will need to update their device passwords.
The VM to VM Data Disk Copy involves deploying a new VM and provisioning new data disks. This process copies the data from the original Storage Sync 10.3 device to the 11.0 Storage Sync VM.
  1. If the existing Storage Sync is not on version 10.3, update the device to version 10.3.
  2. Deploy a new 11.0 Storage Sync VM.
  3. Login to the 11.0 Storage Sync VM on the console with the egnyteservice credentials.
  4. Run the migration script as follows: 
    Download the rsync_data_migration.sh script
    Use winscp or a similar application to copy the script to the Storage Sync /tmp folder.
    > cd /tmp
    > ./rsync_data_migration.sh [IP-address-of-10.3-Storage-Sync] 

  5. Complete the install process via the Storage Sync UI. 
  6. If Egnyte Authentication method was selected in the 10.3 VM, users will need to update their device passwords.
Egnyte Community

Egnyte Community

Want to connect with other Egnyte users and our Egnyte team? Share ideas and ask questions in our Community.