Restoring Untangle Firewall using cloud backup image and terminal

Here are the steps used to restore an Untangle cloud backup image to a local Untangle firewall appliance using the terminal only:

  1. Log in to the Untangle command center at https://www.untangle.com/cmd.
  2. Find your appliance and select it. In the cloud backups box, click on the MD5-hash URL.
  3. Copy the .tar.gz file that you just downloaded to a flash drive.
  4. Connect the flash drive to your Untangle box.
  5. Open up a Terminal session from the Untangle gui splash page and login with valid credentials.
  6. Type “sudo fdisk -l” (that is a lowercase L) and press enter. We are looking for your USB device which is probably “/dev/sdb”.
  7. Type “mount /dev/sdb1 /mnt” and press enter.
  8. Type “cd /mnt” and press enter.
  9. Type “ls” and make sure your tar.gz backup file is listed.
  10. Navigate to the Untangle scripts directory by typing “cd /usr/shaer/untangle/bin” and press enter.
  11. Type “./ut-restore.sh -i /mnt/[your_long_backup_filename].tar.gz“. Hint: type “/mnt/(the first few characters of your backup file then the TAB key on your keyboard to auto fill the file name)”. Press enter.
  12. Your will see the server stopping the untangle-vm then restarting the untangle-vm service. Opening up “Launch client” will show “Restore in progress. Do not reboot or power off the server!”.
  13. Wait a very….long….time for the restore to complete. If you have htop available you can type “htop” in the terminal window and press enter to see the system processes and load. (F10 to exit). This process lasted for about 30 minutes.
  14. At this point you should be back in business. Let me know how this turned out or feel free to ask any questions and suggest improvements.

Back story: I had inadvertently uploaded a bad certificate to the Untangle which killed any GUI access. I restarted the restore once I was confident the configuration settings were overwritten. Once I rebooted and was able to log into the web GUI, I restored a second time using the web GUI to ensure I had a smoother and complete restoration.

Leave a Reply

Your email address will not be published. Required fields are marked *