Upgrade Instructions

From unRAID
Jump to: navigation, search

Deprecated! Obsolete!

The page you are on is an old one containing the instructions for upgrading to unRAID v5, not v6. Please click the following link instead.







Instructions for Upgrading to unRAID v5.0

Important:

  • Only upgrade a server that has all disks enabled with valid parity: no missing disk(s), no disabled disk, etc. Verify everything is working correctly with your current release before proceeding.
  • Backup the entire contents of your Flash device before upgrading. If something goes wrong or a major issue is uncovered in the release having to do with your hardware, this will make it easier for you to downgrade.
  • Record the model, serial number, and position of each of your hard disks. Perhaps the easiest way to do this is take a screen capture of the Disk Status or Main page.
  • Disable or un-install all non-stock unRAID add-ons. Only use add-ons that have been verified by the add-on author to work properly with unRAID OS version 5.

If you are currently running:

  • Any release before 4.7
  1. Upgrade your server to version 4.7 and verify your server boots properly into 4.7 and your configuration appears valid.
  2. Now follow instructions for upgrading from 4.7 in next section.
  • Version 4.7
  1. Prepare the flash: either shutdown your server and plug the flash into your PC or Stop the array and perform the following actions referencing the flash share on your network:
    • Copy the files bzimage and bzroot from the zip file to the root of your flash device, overwriting the same-named files already there.
    • If present, delete these files from the flash (sorry, you will have to re-enter all your users after booting this release):
      • config/passwd
      • config/shadow
      • config/smbpasswd
  2. Reboot your server. Once boot-up has completed, you should see "Stopped. Configuration valid." array status with all disks assigned correctly except for the Cache disk. If you previously had a Cache disk assigned, you will need to re-assign it manually and re-apply any unique configuration settings for it.
  3. Carefully examine the Identification strings for each disk. If you see "MBR: error", or "MBR: unknown" for any disk, do not Start the array; instead post your finding in the Forum announcement thread for this release. If everything looks ok, click Start to bring the array on-line. Note: there is a new configuration setting on the Disk Settings page called "Enable auto start". If you set this to "Yes", then upon next server boot, if the array is valid, then it will be automatically Started (this is the old behavior).
  4. Go to Utils/New Permissions and execute that utility to change file ownership and permission settings. This is necessary for proper operation of the 5.0 security model.
  5. Go to Users page and re-enter all of your users. If you plan on using SMB and/or AFP with either Secure or Private security mode, you must enter at least one user because the 'root' user name is no longer permitted for network share authentication.
  • Version 5.0-beta1 or 5.0-beta2
  1. Follow all steps above for upgrading from 4.7 with the exception of step 4 (because presumably you already did this). Yes, you have to re-enter your users again, this is necessary for proper operation of avahi (Zeroconf, a.k.a., Bonjour).
  • Version 5.0-beta3, 5.0-beta4, 5.0-beta5, 5.0-beta5a, 5.0-beta5b
  1. Prepare the flash: either shutdown your server and plug the flash into your PC or Stop the array and perform the following actions referencing the flash share on your network:
    • Copy the files bzimage and bzroot from the zip file to the root of your flash device, overwriting the same-named files already there.
    • Delete the file config/super.dat. You will need to re-assign all your hard drives.
  2. Reboot your server. Once boot-up has completed, you should see "Stopped. Configuration valid." array status with all disks assigned correctly except for the Cache disk. If you previously had a Cache disk assigned, you will need to re-assign it manually and re-apply any unique configuration settings for it.
  3. Carefully examine the Identification strings for each disk. If you see "MBR: error", or "MBR: unknown" for any disk, do not Start the array; instead post your finding in the Forum announcement thread for this release. If everything looks ok, click Start to bring the array on-line. Note: there is a new configuration setting on the Disk Settings page called "Enable auto start". If you set this to "Yes", then upon next server boot, if the array is valid, then it will be automatically Started (this is the old behavior).
  • Version 5.0-beta6
  1. Prepare the flash: either shutdown your server and plug the flash into your PC or Stop the array and perform the following actions referencing the flash share on your network:
    • Copy the files bzimage and bzroot from the zip file to the root of your flash device, overwriting the same-named files already there.
  2. Reboot your server. Once boot-up has completed, you should see "Stopped. Configuration valid." array status with all disks assigned correctly except for the Cache disk. If you previously had a Cache disk assigned, you will need to re-assign it manually and re-apply any unique configuration settings for it.
  3. Carefully examine the Identification strings for each disk. If you see "MBR: error", or "MBR: unknown" for any disk, do not Start the array; instead post your finding in the Forum announcement thread for this release. If everything looks ok, click Start to bring the array on-line. Note: there is a new configuration setting on the Disk Settings page called "Enable auto start". If you set this to "Yes", then upon next server boot, if the array is valid, then it will be automatically Started (this is the old behavior).
  • All previous 5.0-beta and 5.0-rc versions including 5.0-rc8a
  1. Prepare the flash: either shutdown your server and plug the flash into your PC or Stop the array and perform the following actions referencing the flash share on your network:
    • Copy the files bzimage and bzroot from the zip file to the root of your flash device, overwriting the same-named files already there.
  2. Reboot your server. Once boot-up has completed, you should see "Stopped. Configuration valid." array status with all disks assigned correctly.
  3. Click on each disk link on the Main page and examine the Partition format field. If you see "MBR: error", or "MBR: unknown" for any disk, do not Start the array; instead post your finding in the Forum announcement thread for this release. If everything looks ok, click Start to bring the array on-line.
  4. Go to Utils/New Permissions and execute that utility to change file ownership and permission settings. This is necessary for proper operation of the 5.0 security model.
  • 5.0-rc9 through 5.0-rc16c
  1. Prepare the flash: either shutdown your server and plug the flash into your PC or Stop the array and perform the following actions referencing the flash share on your network:
    • Copy the files bzimage, bzroot, and syslinux.cfg from the zip file to the root of your flash device, overwriting the same-named files already there.
  2. Reboot your server. Once boot-up has completed, you should see "Stopped. Configuration valid." array status with all disks assigned correctly. Some users have reported having to re-run 'make_bootable' script on the flash.

Installation on a New Flash Device

To make a bootable USB Flash device using Windows (XP/Vista/Win7), follow these steps:

  1. Plug your USB Flash device into your Windows PC.
  2. Open 'My Computer' (XP) or 'Computer' (Vista/Win7) and right-click your Flash device. Click 'Format...', set the volume label to UNRAID and then click 'Start'. Important: the volume label must be set exactly to UNRAID (all caps).
  3. Click on your Flash device (to open it) and drag then entire contents of the unRAID Server zip file to the Flash.
  4. For Windows XP, click on the file 'make_bootable'. A DOS window will open and run the 'syslinux' utility on the Flash. For Windows Vista or Windows 7, right-click on the file 'make_bootable' and select 'Run as administrator'.
  5. Once again, right-click your Flash device in 'My Computer' or 'Computer' and then click 'Eject'. Your Flash device is now ready to boot into unRAID Server OS.