How to migrate database between multiple SMA servers (4287917)

It may become necessary to move the current KACE SMA database and files to a different appliance.  Some example scenarios include:

• Migrating from a Trial appliance to a new appliance.
• Migrating from an old KACE appliance to a new/replacement appliance.

Steps for Migration:

1. Obtain your full license key from Settings | Appliance Updates and save in a place which will be accessible during migration
   1. In a non ORG-Enabled box, this is done from AdminUI
   2. In an ORG-Enabled box, this is done from SystemUI
2. Obtain nececssary documentation for the new SMA
   1. Virtual Environments
      1. Recommended Virtual Appliance Configuration for Scalability (4211368)
      2. How to: Configure initial network settings manually (4368148)
      3. KACE Systems Management Appliance Common Documents Technical Specifications for Virtual Appliances
   2. Hyper-V
      1. Hyper-V Best practices for KACE Appliances
      2. KACE Systems Management Appliance Hyper-V Setup Guide
   3. VMWare
      1. KACE Systems Management Appliance VMware Setup Guide
   4. Azure
      1. KACE Systems Management Appliance Azure Setup Guide
   5. Nutanix
      1. KACE Systems Management Appliance Nutanix Setup Guide
3. Create a new SMA
   1. The version of the new SMA must match the version of the current SMA backups exactly
      1. Upgrade the current SMA to match the version of the new SMA
      2. If the above is not possible and the version of the SMA which matches your backups is not available on the Downloads site or in Azure, contact Technical Support
4. Disable SSO on the Current (OLD) SMA
5. Prepare the team for downtime
   1. The next step involves obtaining backups from the current (OLD) SMA
   2. The team should be ready and not in the SMA creating new tasks, as the changes could be missed in the backup
6. Create and Offboard the backups from the current SMA in binary mode
   1. About appliance backups (4299192)
   2. Offboard Backup Transfer (4218794)
   3. How to manage backup files via FTP (4298838)
7. Turn off the current (old) SMA
   1. If possible, do not delete or remove the old box until the process is complete and verified

Note: The next step is going to cause a reboot of the NEW box

 

CRITICAL: Restoring backups from the OLD box into the NEW box will cause the IP and Hostname of the OLD environment to be duplicated in the NEW environment. Please check with your networking team to ensure the NIC is disabled or that the network is segmented properly and they are prepared prior to these changes taking place.

6. Upload the backups from the OLD environment into the NEW SMA
   1. How to manage backup files via FTP (4298838)
7. Once both files are associated click Restore.  Note The amount of time for restore to complete is dependent on the size of the backup files, the new SMA will be unavailable until it is complete.
8. Once the restore completes, the K1 will reboot. Upon reboot the SMA should be in the state of when the backup files were created. This includes the same authentication settings, network settings, etc.