UnRAID 6/Changing The Flash Device

From unRAID
Revision as of 19:30, 12 November 2018 by Jonp (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Replacing your Unraid USB Flash Device and Registration Key

There are two methods to use for swapping out your USB flash device. If you are using a PC or Mac, you should use the USB Flash Creator tool for the easiest and most streamlined experience. However in the event, this tool doesn't work for you, or you are using a Linux system, then please use the legacy method instead.

In either case, you will you will first need to have a full backup of your original Unraid OS USB flash boot device. (It is highly recommended that you always have an up to date backup of your Unraid USB flash device.)

  • This is done by going to the main tab in the Unraid webGui then clicking on 'Flash'.
  • From here you will see the option 'FLASH BACKUP', click this and a full zipped backup of your current flash drive will be downloaded to your Mac or PC.


Backup flash drive.png


Why replace your USB Flash boot device?

There are a number of different reasons for which you may wish to replace your USB flash device running Unraid OS:

  • Current device is failing
  • Current device has failed, is lost or broken
  • Current device physically too large
  • Current device too slow or not enough storage
  • Current device just getting old

Prior to replacing the current flash, it may be worthwhile to shut down your server, remove the flash, and insert it into a Windows or Mac computer. Using Windows scandisk or Disk Utilities in Mac, you should be able to try to "repair" the existing flash. If this operation works, you may want to consider continuing use of the flash. If you've done this before and are still having issues with your flash, then replacement is probably necessary.


Using the Flash Creator

  • Once you have a backup of your Unraid flash device, you will need to use the Unraid USB Flash Creator tool to restore your backup to the new USB flash device. This can be downloaded for Windows or MacOS from here .... Download USB Creator


Usbcreator.png


  • Obtain a new good quality USB flash device. This should be no less than 1 GB.
  • Plug it into your computer and then run the Unraid USB Creator software.
  • Select the version 'Local Zip' then browse to the location of the backup that you created earlier and open that.
  • Next, make sure that you select your new USB Flash device for the destination, then click 'Write' and your backup will be restored to the new USB flash device.


Selectversion.png


  • Shutdown the server. Remove the original USB flash device and replace it with the new one created above. Power on the server.
  • Once booted the array will not start and you will see the message 'Invalid, missing or expired registration Key' Click 'registration Key'


Invalidkey.png


  • Click on the option to 'REPLACE KEY' * Then enter the email address to which you would like to have the new key delivered to.
  • Click 'REPLACE KEY'


Replacekey.png


  • Once you have received the email, copy the key file URL, then paste it into the box and click 'INSTALL KEY
  • Finished! You have replaced the USB flash device and the registration key. You will see a screen showing the date this key was registered and the next date on which your registration key will be eligible to be replaced again. Click 'DONE'

Manual Method (Legacy)

Legacy method - Windows and MacOS

  • Obtain a new good quality USB flash drive. This should be no less than 1 GB and no more than 32 GB in size. Plug it into your computer
  • Format the USB flash device as FAT32 with MBR partition and label the drive UNRAID (in capitals)
  • Extract the contents of your Unraid USB device backup and then copy and paste them into the root of the USB flash device labeled UNRAID.
  • You will see 3 files called make_bootable, one for running on Windows, Mac, and Linux. Choose the one appropriate to your operating system.
  • make_bootable.bat is to be run on Windows as administrator. This will make the USB flash device bootable.
  • make_bootable_mac is to be run on MacOS. This will make the USB flash device bootable.
  • Shutdown the server. Remove the original USB flash device and replace it with the new one created above. Power on the server.
  • Once booted the array will not start and you will see the message 'Invalid, missing or expired registration Key' Click 'registration Key'


Invalidkey.png


  • Click on the option to 'REPLACE KEY' * Then enter the email address to which you would like to have the new key delivered to.
  • Click 'REPLACE KEY'


Replacekey.png


  • Once you have received the email, copy the key file URL, then paste it into the box and click 'INSTALL KEY
  • Finished! You have replaced the USB flash device and the registration key. You will see a screen showing the date this key was registered and the next date on which your registration key will be eligible to be replaced again. Click 'DONE'

Legacy method - Linux

  • Obtain a new good quality USB flash drive. This should be no less than 1 GB and no more than 32 GB in size. Plug it into your computer
  • Format the USB flash device as FAT32 with MBR partition and label the drive UNRAID (in capitals)
  • Extract the contents of the flash backup to a folder on your desktop or any location of your choice.
  • Copy contents of the folder and paste them into the root of the USB flash device labeled UNRAID.
  • Close the file browser window that has the USB flash device open in it.
  • Goto the folder from where you just copied the files which you just pasted to the USB flash device.
  • Open terminal and type
sudo bash
  • Now drag the file make_bootable_linux from that folder into the terminal window next to what you typed in the last step. Hit enter.
  • Enter sudo password
  • Follow the prompts
  • If the process should fail with the message
sudo: /tmp/UNRAID/syslinux/make_bootable_linux.sh: command not found
  • Run the script a second time and this time it will complete. This will make the USB flash device bootable

Example

Linuxinstall.png


  • Shutdown the server, remove the original USB flash device and replace it with the new one created above, then power on the server.
  • Once booted the array will not start and you will see the message 'Invalid, missing or expired registration Key' Click 'registration Key'


Invalidkey.png


  • Click on the option to 'REPLACE KEY' * Then enter the email address to which you would like to have the new key delivered to.
  • Click 'REPLACE KEY'


Replacekey.png


  • Once you have received the email, copy the key file URL, then paste it into the box and click 'INSTALL KEY
  • Finished! You have replaced the USB flash device and the registration key. You will see a screen showing the date this key was registered and the next date on which your registration key will be eligible to be replaced again. Click 'DONE'

Notes about replacing your registration key

You may replace your original registration key at any time. Having replaced your key once, you may next replace your key after a further period of 12 months. Should you need to replace it again within that 12 month period, then please send an email to support@lime-technology.com to discuss your options.