RobJ

FAQ for unRAID v6

Recommended Posts

This TOC is broken, at least for now. See the "repaired" TOC here:

Something seems to have broken the links that were imported from the old forum software. 

 

 

__________________________________________________________________________________________________________________

 

 

This thread is reserved for Frequently Asked Questions, concerning unRAID as a NAS, its setup, operation, management, and troubleshooting.  Please do not ask for support here, such requests and anything off-topic will be deleted or moved, probably to the FAQ feedback topic.  If you wish to comment on the current FAQ posts, or have suggestions or requests for the FAQ, please put them in the FAQ feedback topic.  Thank you!

 

Index to common questions

  Some are from the wiki FAQ, some from this thread, and some from the LimeTech web site.  There are many more questions with answers on the wiki FAQ.


Getting Started

General Questions

Cache Drive/Pool

Plugins

Maintenance and Troubleshooting


 

unRAID FAQ's and Guides -

* Guides and Videos - comprehensive collection of all unRAID guides (please let us know if you find one that's missing)

* FAQ for unRAID v6 on the forums, general NAS questions, not for Dockers or VM's

* FAQ for unRAID v6 on the unRAID wiki - it has a tremendous amount of information, questions and answers about unRAID.  It's being updated for v6, but much is still only for v4 and v5.

* Docker FAQ - concerning all things Docker, their setup, operation, management, and troubleshooting

* FAQ for binhex Docker containers - some of the questions and answers are of general interest, not just for binhex containers

* VM FAQ - a FAQ for VM's and all virtualization issues

 

Know of a question that ought to be here?  Please suggest it in the FAQ feedback topic.

 

-------------------------------------------------------

Suggested format for FAQ entries - clearly shape the issue as a question or as a statement of the problem to solve, then fully answer it below, including any appropriate links to related info or videos.  Optionally, set the subject heading to be appropriate, perhaps the question itself.

 

While a moderator could cut and paste a FAQ entry here, only another moderator could edit it.  It's best therefore if only knowledgeable and experienced users create the FAQ posts, so they can be the ones to edit it later, as needed.  Later, the author may want to add new info to the post, or add links to new and helpful info.  And the post may need to be modified if a new unRAID release changes the behavior being discussed.

 

Moderators:  please feel free to edit this post.

  • Upvote 1

Share this post


Link to post
Share on other sites

Why am I unable to install plugins?

 

With some user's network setup (ISP, router, etc) you may need to manually set static DNS addresses so that unRaid can communicate with the outside world.

 

Go to Settings, Network Settings and enter in the appropriate addresses (You can always use Google's DNS server addresses which are 8.8.8.8 and 8.8.4.4)

 

Untitled_zpsvtbagaw5.png

Edited by Squid

Share this post


Link to post
Share on other sites

What counts as a drive against my license storage device limit?

 

Everything that is handled by Linux as a storage device (basically everything except for your boot flash drive).  This includes DVD / Bluray drives, card readers, external hard drives and the like.

 

If you exceed your device limit (whether assigned to the array or not), you will either have to remove those devices from your service, or upgrade your license.

 

Note that the Pro versions of unRAID have no device limits and only limit the amount of devices able to be actually assigned to the array.

Share this post


Link to post
Share on other sites

Why is my cache disk(s) unassigned after a reboot?

 

Some users have this issue when using Chrome to add cache disk(s), single cache disk or one or more disks from a cache pool don't stay assigned after a reboot, use IE or Firefox for this operation, use it for the complete procedure, assign cache disk(s), start array, stop array and reboot, your assignments should stick now.

 

If using a different browser doesn't work, boot unRAID in safe mode, assign your cache devices, start array, stop array and reboot in normal mode, assignments should now stick.

 

 

Edited by johnnie.black
  • Upvote 1

Share this post


Link to post
Share on other sites

Why does the WebGUI crash when changing the number of array disk slots?

 

Like the issue above, this only affects some users when using Chrome, use a different browser for this operation.

Share this post


Link to post
Share on other sites

Why is the webGUI not displaying any of my shares, but I can see them over the network?

 

Some of the commercial / free adblockers for Windows / (Mac?) are incorrectly flagging your unRaid server's GUI as an advertisement.  In your adblocker's settings, there should be an option to "white-list" your server.

Share this post


Link to post
Share on other sites

What is the Local Master in SMB and does it involve the Internet?

 

 

I answered a query recently and complied a response which is referenced here:

 

The next post suggested that the information be added to the WIKI.  I could see it going into the Networking section (#10) but I am unsure the way to do this.  Do you want to be the one controlling this since you are revising the entire FAQ?  I would be happy to rework this post and make it a bit more general if that would help. 

Edited by Frank1940
updated link

Share this post


Link to post
Share on other sites

How do I know if I've configured my server properly?

 

You can install the Fix Common Problems plugin here: http://lime-technology.com/forum/index.php?topic=48972.0  The plugin is designed to scan and suggest solutions to many common issues and configuration mistakes.  While it can't catch everything, its a start.

Share this post


Link to post
Share on other sites

How do I add a disk to create a redundant cache pool?

 

This procedure assumes current cache disk filesystem is BTRFS, you can’t create a pool from an XFS or ReiserFS cache.

If current or intended profile is default raid1 use first method, if it's currently or you want to use a different profile use second method.

 

Method 1 (for default raid1 or all others profiles with v6.3.3 and above)

  • if new disk was ever used in a cache pool in the past, preclear it before adding to pool, if not cache can be corrupted
  • backup your cache in case something unexpected happens
  • change cache slots to 2
  • assign new disk to cache pool
  • start array - balance will begin, progress can be seen on WebGUI cache page “btrfs balance status”, e.g.:
Balance on '/mnt/cache' is running
4 out of about 17 chunks balanced (5 considered),  76% left
  • this can take some time depending on how much data is on the pool and how fast your devices are, don't stop the array until it's done!
  • when balance is done, "btrfs balance status" should show "No balance found on '/mnt/cache'", check also that "btrfs filesystem show" total devices are correct

 

Method 2 (other profiles) (only for v6.3.2 or below, for v6.3.3 and above use method1 only since profile is not changed)

If you are currently using a profile other than raid1 and want to keep using it and avoid the raid1 auto re-balance when using method 1 use this one instead:

 

1) replacement device should be wiped/precleared before starting.

 

On the steps below always double check you're using the correct device sd identifier, doing them on the wrong device can lead to data loss.

 

If you need to wipe the device first (all data will be deleted) use wipefs, run both, one after the other:

wipefs -a /dev/sdX1

wipefs -a /dev/sdX

replace X with actual device.

 

 

2) first you need to partition the new device, use the latest version of the unassigned devices plugin to partition and format the device, filesystem used for the format doesn't matter since it will be overwritten later, but you need to chose one as UD currently doesn't have an option to just partition the device. 

 

 

3) now to add the device (array needs to be started), type:

btrfs device add /dev/sdX1 /mnt/cache

replace X with actual device.

 

 

4) Stop array, assign new device to the cache pool, it will show a green dot, start array, now only thing left to do is to run a balance to redistribute data to include the new device:

btrfs balance start --bg --full-balance /mnt/cache

--bg (run in the background) is only available on v6.3.0-rc1 and above, for older releases omit that and use a second SSH session to monitor the progress.

This can take some time, watch progress by typing:

watch btrfs balance status /mnt/cache

When "No balance found on '/mnt/cache'" appears exit with Ctrl+c and type:

btrfs fi show /mnt/cache

Check that data is evenly distributed by all devices (there could be little differences), e.g:

Total devices 4 FS bytes used 17.41GiB
devid    1 size 29.82GiB used 5.00GiB path /dev/sdq1
devid    2 size 29.82GiB used 5.00GiB path /dev/sdr1
devid    3 size 29.82GiB used 6.03GiB path /dev/sds1
devid    4 size 29.82GiB used 6.03GiB path /dev/sdt1

All done!

Edited by johnnie.black

Share this post


Link to post
Share on other sites

How do I remove a cache pool disk?

 

NOTE: unRAID v6.4-rc8 and above have several cache pool config enhancements, I'll leave the procedure below until v6.4 goes stable but for anyone using it you just need to stop the array, unassign the cache device you want to remove and re-start the array, doing a backup before is always a good idea just in case.

 

Step 1: Start by backing up your cache in case something unexpected happens.

 

You can't remove a device from pool that is using the minimum number of devices for that profile without downconverting first, e.g., a raid10 pools need 4 devices minimum, so if you have one and you want to remove 1 or 2 devices you need to convert it to raid1 first, see this FAQ question on the existing profiles, minimum number of devices and how to convert to a different one.

 

Same situation if you have a two device raid1 pool, it needs to be converted to single profile to allow removal, this step is not needed if you want to remove a single device from a pool with 3 or more devices using the default RAID1 profile, in that case go to step 3.

 

Step 2: Use the console or SSH into your server and type:

btrfs balance start -f --bg -dconvert=single -mconvert=single /mnt/cache

--bg (run in the background) is only available on v6.3.0-rc1 and above, for older releases omit that and use a second SSH session to monitor the progress.

 

This can take some time, watch progress by typing:

watch btrfs balance status /mnt/cache

When "No balance found on '/mnt/cache'" appears exit with Ctrl+c and type:

btrfs filesystem df /mnt/cache

Check that single is the only profile used, e.g.,:

 

Quote

Data, single: total=13.00GiB, used=12.50GiB
System, single: total=32.00MiB, used=16.00KiB
Metadata, single: total=1.00GiB, used=11.94MiB
GlobalReserve, single: total=16.00MiB, used=0.00B

 

If there are other profiles run balance again.

 

Step 3: Use the console or SSH into your server and type:

btrfs device remove /dev/sdx1 /mnt/cache

(earlier btrfs tools may require "delete" instead of "remove")

 

Replace x with the actual device you want to remove (don't forget the partition number at the end, eg, /dev/sdf1 or /dev/nvme0n1p1), again this could take some time if there's data on the device that's being removed, if there's a lot of data you can watch progress on cache page "btrfs filesystem show:", look for the devid you're removing and its used space, remove operation will finish after all data is moved to other disk(s).

 

You can remove more than one device at the same time as long as there's enough free space and you don't go below the profile minimum required devices, e.g., to remove 2 devices from a 4 disk raid1 pool use:

btrfs device remove /dev/sdx1 /dev/sdy1 /mnt/cache

When done, stop array, there should be a blue square on the device(s) you want to remove, unassign it (you can rearrange remaining devices, e.g., if you removed cache1 you can reassign cache2 to the cache1 slot), re-start array and you're done.

Edited by johnnie.black

Share this post


Link to post
Share on other sites

How do I replace/upgrade a cache pool disk?

 

Although there shouldn't be any data loss during a disk replacement, something unexpected can happen, so backup your cache before starting.

 

Method 1 - This is the preferred method of replacing a pool disk, it lets you replace/upgrade a working device from any type of pool (single/raid0/1/5/6/10) and replace a missing/bad device from a redundant pool, it can also be much faster than the other methods because there's no need to balance the pool (especially for big pools with lots of data), you need an available SATA port if replacing an existing disk (some steps may not work on unRAID releases prior to v6.2):

 

This method can also be used to do an online replacement of a single btrfs formatted cache device or any unassigned btrfs device, you can keep all the dockers/VMs working during the replacement.

 

1) replacement device should be wiped/precleared before starting and needs to be the same size or larger than the old device.

 

On the steps below always double check you're using the correct device sd identifier, doing them on the wrong device can lead to data loss.

 

If you need to wipe the device first (all data will be deleted) use wipefs, run both, one after the other:

 

wipefs -a /dev/sdX1

wipefs -a /dev/sdX

replace X with actual device.

 

2) first you need to partition the new device, use the latest version of the unassigned devices plugin to partition and format the device, filesystem used for the format doesn't matter since it will be overwritten later, but you need to chose one as UD currently doesn't have an option to just partition the device.

 

3) now to start the replacement you need to find the devid of the device being replaced, so type:

btrfs fi show /mnt/cache
 

 

Use the sd identifier to find the devid, e.g., if you wanted to replace sdk it would be devid 2:

Quote
devid    1 size 29.82GiB used 928.00MiB path /dev/sdj1       

devid    2 size 29.82GiB used 928.00MiB path /dev/sdk1

devid    3 size 29.82GiB used 928.00MiB path /dev/sdl1

devid    4 size 29.82GiB used 928.00MiB path /dev/sdm1

 

if the device is missing it won't show up on btrfs fi show, in that case use instead:

btrfs device usage /mnt/cache
 

 

The missing device is the one with size 0, e.g.:

Quote

/dev/sdl1, ID: 4

  Device size:            29.82GiB

  Data,single:            1.00GiB

  Data,RAID10:          512.00MiB

  Metadata,RAID10:      256.00MiB

  System,RAID10:          16.00MiB

  Unallocated:            28.05GiB

 

/dev/sdm1, ID: 5

  Device size:              0.00B

  Data,RAID10:          512.00MiB

  Metadata,RAID10:      256.00MiB

  System,RAID10:          16.00MiB

  Unallocated:            29.05GiB

 

4) now you can start the actual replacement, use 4a to replace a good or missing device, use 4b to replace a known bad device from a redundant pool (e.g., a disk with pending sectors).

 

4a) if array was stopped start it and type:

 

btrfs replace start -f # /dev/sdX1 /mnt/cache
 

 

replace # with the devid of the device being replaced and X with the new device, don't forget the partition number in the end (/dev/sdX1 or /dev/nvme0n1p1), e.g., to replace devid 5 with sdm type:

 

Quote
btrfs replace start -f 5 /dev/sdm1 /mnt/cache

 

You can follow the replacement progress by typing:

 

btrfs replace status /mnt/cache
 

 

When finished you'll get something like this:

 

Started on 30.Dec 13:38:51, finished on 30.Dec 13:48:11, 0 write errs, 0 uncorr. read errs
 

 

4b) same as 4a but add -r to the command to copy the data using the pool redundancy and avoid the known bad device, see 4a instructions and add -r after start. e.g.:

 

btrfs replace start -f -r # /dev/sdX1 /mnt/cache
 

 

 

5) when it finishes, stop array, the old cache device will have a blue icon (unless it was missing or there's only one slot for cache devices), unassign it and assign the new device in its place, it will show a green icon.

 

6) start the array and the pool should mount normally using the new device, old device can be disconnect any time after this.

 

7) if the new device is larger and you want to use its full capacity (profile in use permitting) expand the filesystem by typing:

 

btrfs filesystem resize #:max /mnt/cache
 

 

replace # with the correct devid, e.g.:

 

btrfs filesystem resize 5:max /mnt/cache
 

 

 

 

Method 2 - If current pool is working correctly using default RAID1 profile and you have an extra port to connect the new device:

 

  • stop array
  • if needed add one more slot to the cache pool devices
  • add new device (if device was ever used in a cache pool in the past preclear it before adding to pool, if not cache can be corrupted)
  • start array
  • balance will begin, progress can be seen on WebGUI cache page “btrfs balance status”
  • when balance is done, "btrfs balance status" should show "No balance found on '/mnt/cache'", check also that "btrfs filesystem show" total devices are correct
  • see question above How do I remove a cache pool disk? to remove the old device, you only need to do step 3

 

Method 3 - If one disk from the current pool is bad/missing using default RAID1 profile or you don't have an extra port to connect the new device:

 

  • if enable disable array auto start
  • shutdown server
  • replace the cache device (old device has to be physically disconnected, or cleared, starting the array with a previously used pool device unassigned will result in unmountable cache)
  • power up, assign new cache device (if device was ever used in a cache pool in the past preclear it before adding to pool, if not cache can be corrupted)
  • start array, there will be read/write activity on the pool, WebGUI cache page "btrfs filesystem show" will show "***some devices missing", wait and after some time it will stop showing that and a balance will begin
  • this can take some time depending on how much data is on the pool and how fast your devices are, don't stop the array until it's done
  • when cache pool reads/writes stop and balance is done check that on the cache page "btrfs filesystem show" total devices are correct and it's not displaying "***some devices missing", e.g., this is how a 2 disk pool should look:

   

Quote
Label: none  uuid: 7ca5d0f3-d26c-41d5-889b-a198db6fa913

    Total devices 2 FS bytes used 14.62GiB

    devid    2 size 232.89GiB used 16.03GiB path /dev/sde1

    devid    4 size 232.89GiB used 16.03GiB path /dev/sdf1

 

 

 

 

 

Edited by johnnie.black

Share this post


Link to post
Share on other sites

I have two different size cache devices, why is the reported space incorrect?

 

BTRFS limitation when using different size devices, usable size in default 2 device pool RADI1 config is always equal to the smallest device.

 

Although free pool space is incorrectly reported the cache floor setting should still work normally (at least for unRAID v6.2 and above), i.e., set it according to the real usable space.

 

To see the usable space with 3 or more different size devices in any profile use the calculator below:

 

http://carfax.org.uk/btrfs-usage/

 

Share this post


Link to post
Share on other sites

Can I change my pool to RAID0 or other modes?

 

Yes, for now it can only be manually changed, new config will stick after a reboot, but note that changing the pool using the WebGUI, e.g., adding a device, will return cache pool to default RAID1 mode (note: starting with unRAID v6.3.3 cache pool profile in use will be maintained when a new device is added using the WebGUI, except when another device is added to a single device cache, in that case it will create a raid1 pool), you can add, replace or remove a device and maintain the profile in use following the appropriate procedure on the FAQ (remove only if it does not go below the minimum number of devices required for that specific profile).

 

These are the available modes (enter these commands on the cache page balance window e click balance):

 

Single: requires 1 device only, it's also the only way of using all space from different size devices, btrfs's way of doing a JBOD spanned volume, no performance gains vs single disk or RAID1

-dconvert=single -mconvert=raid1
 

 

RAID0: requires 2 device, best performance, no redundancy, if used with different size devices only 2 x capacity of smallest device will be available, even if reported space is larger.

-dconvert=raid0 -mconvert=raid1
RAID1: default, requires at least 2 devices, to use full capacity of a 2 device pool they all need to be the same size.

 

-dconvert=raid1 -mconvert=raid1

 

RAID10: requires at least 4 devices, to use full capacity of a 4 device pool they all need to be the same size.

-dconvert=raid10 -mconvert=raid10
 

 

RAID5/6 are still considered experimental and not ready for production servers.

 

RAID5: requires at least 3 devices.

-dconvert=raid5 -mconvert=raid1
 

 

RAID6: requires at least 4 devices.

-dconvert=raid6 -mconvert=raid1
 

 

Obs:

-d refers to the data, -m to the metadata, metadata should be left redundant, i.e., you can have a RAID0 pool with RAID1 metadata, metadata takes up very little space and the added protection can be valuable.

 

When changing pool mode confirm that when the balance is done data is all in the new selected mode, check "btrfs filesystem df"on the cache page, this is how a RAID10 pool should look like:

Quote

Data, RAID10: total=14.00GiB, used=9.85GiB

System, RAID10: total=224.00MiB, used=16.00KiB

Metadata, RAID10: total=2.19GiB, used=10.23MiB

GlobalReserve, single: total=16.00MiB, used=0.00B

 

If there is more than one data mode displayed, do the balance again with the mode you want, for some unRAID releases and the included btrfs-tools, eg, v6.1 and v6.2 it's normal needing to run the balance twice.

Edited by johnnie.black

Share this post


Link to post
Share on other sites

What is "Boot GUI mode", and how do I change to it?

 

Some users run unRAID as headless, and if you do, then this FAQ is not for you.  The Boot GUI is a GUI replacement for the text based terminal screen on the server console that we have always seen after boot, until now.  It provides the same unRAID screens on the server monitor that you normally get when you open your unRAID server from a browser on another desktop.

 

One important requirement - a mouse!  If you have never viewed a GUI on your server machine, then you may not have one attached, and any GUI requires a mouse.  Because support is built in, getting a mouse working should be easy, but may not be (and you may have to reboot).

 

To set the GUI mode, go to the Main screen and click on your unRAID flash disk (on the word 'Flash'), to open its settings page.  Go down to the Syslinux Configuration section.  This is a viewer and editor of your syslinux.cfg file, the file that controls the boot menu for your server.  After some preliminary general settings lines, you will see a series of sections that begin with label.  Each section controls a separate menu line on your boot menu.  In one of them is the line "menu default", which marks the menu item that will be performed if nothing is selected within the allotted time.

 

To change the default menu selection, simply move the "menu default" line into the section you want to be the default, then click Apply then Done.  Try it and see, you can always change it back.

 

One warning!  This uses Firefox as the browser to open the unRAID server management pages.  It's fine for that, but because it's a browser, it will be tempting to go on the Internet.  It is NOT configured to securely access the Internet!  Don't do it!  To be safe, use it only for managing your unRAID server.  (This author is not sure of the security implications and dangers here, and prefers to err on the side of safety.)

 

An example of a modified syslinux.cfg -

default /syslinux/menu.c32
menu title Lime Technology, Inc.
prompt 0
timeout 50
label unRAID OS
  kernel /bzimage
  append initrd=/bzroot vga=6
label unRAID OS GUI Mode
  menu default
  kernel /bzimage
  append initrd=/bzroot,/bzroot-gui vga=6
label unRAID OS Safe Mode (no plugins, no GUI)
  kernel /bzimage
  append initrd=/bzroot unraidsafemode vga=6
label Memtest86+
  kernel /memtest

Share this post


Link to post
Share on other sites

I have a new SAS drive.  How do I get unRAID to recognize and assign it?

Why can't unRAID find or add my SAS drive?

 

Assuming you are running unRAID 6.2, go to Settings -> Display Settings and change Display world-wide-name in device ID from Disabled to Automatic.  Click Apply then Done, and then go see if unRAID will let it be assigned!

Share this post


Link to post
Share on other sites

What are the current device limits for each license?

 

These are the current limits for unRAID v6.2 or above:

 

Basic - 6 total

Plus - 12 total

Pro - 30 array (28 data + 2 parity) + 24 cache pool + unlimited unassigned

Edited by johnnie.black

Share this post


Link to post
Share on other sites

I set a share to private, created a user set read/write permissions to that share.  But on my windows 7 PC when i try to navigate to that share it's saying I don't have access when i put the user name and password. Did I miss anything?

 

Here is a explanation of what is happening from LimeTech:

 

Edited by Frank1940
updated linnk

Share this post


Link to post
Share on other sites

I'm getting an error message " Failed to find user 'avahi' ".  What do I do?

Why after upgrading to a 6.2 version is my webGUI so slow?

Why is my webGUI taking so long between pages?

 

Symptoms:

- the error message "Failed to find user 'avahi'", usually in the syslog but may appear on the console too

- changing pages in the webGUI will take from 20 to 40 seconds per page

- some combination of the following sequence of lines appears over and over in the syslog:

Quote
Aug  5 13:52:02 DarkTower emhttp: shcmd (20782): /etc/rc.d/rc.avahidaemon start |& logger

Aug  5 13:52:02 DarkTower root: Starting Avahi mDNS/DNS-SD Daemon:  /usr/sbin/avahi-daemon -D

Aug  5 13:52:02 DarkTower avahi-daemon[20325]: Failed to find user 'avahi'.

Aug  5 13:52:22 DarkTower root: Timeout reached while wating for return value

Aug  5 13:52:22 DarkTower root: Could not receive return value from daemon process.

Aug  5 13:52:22 DarkTower emhttp: shcmd (20783): /etc/rc.d/rc.avahidnsconfd start |& logger

Aug  5 13:52:22 DarkTower root: Starting Avahi mDNS/DNS-SD DNS Server Configuration Daemon:  /usr/sbin/avahi-dnsconfd -D

Aug  5 13:52:22 DarkTower avahi-dnsconfd[20428]: connect(): No such file or directory

Aug  5 13:52:22 DarkTower avahi-dnsconfd[20428]: Failed to connect to the daemon. This probably means that you

Aug  5 13:52:22 DarkTower avahi-dnsconfd[20428]: didn't start avahi-daemon before avahi-dnsconfd.

 

For as yet unknown reasons, the internal 'avahi' user is missing from some users unRAID systems, and this avahi user has become more important for the proper functioning of the avahi daemons in 6.2 and later.  This missing user results in long timeouts while the avahi daemons try over and over to re-initialize.

 

The solution is to edit the passwd file on your boot flash disk ( /boot/config/passwd ), and add the following 2 lines to it:

avahi:x:61:214:Avahi Daemon User:/dev/null:/bin/false
avahi-autoipd:x:62:62:Avahi AutoIP Daemon User:/dev/null:/bin/false 
 

Then edit the shadow file on your boot flash disk ( /boot/config/shadow ), and add the following 2 lines to it:  (this may be needed for proper security)

avahi:!:14980:0:99999:7:::
avahi-autoipd:!:14980:0:99999:7::: 

 

You will need to use a Linux-aware editor to preserve correct Linux style line endings.  You can use the built-in mc or nano.  It's often easier to use copy and paste in Windows or Mac, just make sure you preserve the Linux style line endings.  You may have to reboot for it to take effect, or at least restart the array.  This post may be edited further as more info comes in.

Edited by RobJ
fix formatting for IPS
  • Upvote 1

Share this post


Link to post
Share on other sites

How do I replace/upgrade my single cache device? (unRAID v6.2 and above only)

 

This procedure assumes that there are at least some dockers and/or VMs related files on the cache disk, some of these steps are unnecessary if there aren't.

  • Stop all running Dockers/VMs
  • Settings -> VM Manager: disable VMs and click apply
  • Settings -> Docker: disable Docker and click apply
  • Click on Shares and change to "Yes" all cache shares with "Use cache disk:" set to "Only" or "Prefer"
  • Check that there's enough free space on the array and invoke the mover by clicking "Move Now" on the Main page
  • When the mover finishes check that your cache is empty (any files on the cache root will not be moved as they are not part of any share)
  • Stop array, replace cache device, assign it, start array and format new cache device (if needed), check that it's using the filesystem you want
  • Click on Shares and change to "Prefer" all shares that you want moved back to cache
  • On the Main page click "Move Now"
  • When the mover finishes re-enable Docker and VMs
     

 

 

Share this post


Link to post
Share on other sites

I have software that requires using port 80.  How do I change the HTTP port that unRAID uses?

 

First, be certain that's what you really want, as changing the unRAID port should normally be a last resort.  It's usually much better to change the port your app needs instead.  Docker container ports can usually be remapped.

 

Currently, the only way is to edit your go file, and start emhttp with a different port.  The go file is at /boot/config/go if you are editing it in a terminal, at \\tower\flash\config\go if you are editing it from Windows (change 'tower' as needed).

 

Find this line in the go file:

  /usr/local/sbin/emhttp &

And change it to:

  /usr/local/sbin/emhttp  -p  ##  &

Where ## is the new port number you want to use to reach your unRAID server webGUI.

 

Then reboot the server.

 

Don't forget that you will also need to change the location in your browser!

 

Example:  set emhttp port to 8080

  /usr/local/sbin/emhttp -p 8080 &

Reboot your unRAID server, then browse to it on the new port

  http://tower:8080

Share this post


Link to post
Share on other sites

Is there a way to create a Windows shortcut for shutting down the unRAID server?

 

On your Windows machine:

- Install PuTTY first, it includes plink.exe

- Create a batch file (store it anywhere you choose) containing the following line (replace password_here and server_IP_here):

    plink.exe  -ssh  -pw  password_here  root@server_IP_here  poweroff

    e.g. plink.exe -ssh -pw 123456 root@192.168.1.5 poweroff

    Note: with older versions of unRAID, use powerdown instead of poweroff

- Create a shortcut on your Windows desktop that points to that batch file

 

Clicking that shortcut should start the normal unRAID shutdown procedures.

Edited by RobJ
add poweroff

Share this post


Link to post
Share on other sites

What are the requirements for the second parity disk? (v6.2 and above only)

 

Same requirements as the other parity, the size of the parity2 disk must be equal to or larger than the largest data drive, parity1 size is irrelevant.

 

Share this post


Link to post
Share on other sites

I found a segfault error in my syslog.  How do I fix it?

My system is crashing randomly, and/or I'm seeing a little data corruption.  How do I fix it?

How do I test my RAM, my system memory?

 

* Segfaults - there are 2 primary reasons for segfaults - faulty memory chips and dependency issues.  See below for methods to test your RAM.  If your RAM is fine, then it's almost certainly a dependency issue - some software that you have added has a dependency that conflicts with either the core unRAID system or something else you have added.

 

* Random crashes and data corruption - while there could be a number of causes for both of these, one primary cause and the easiest to test and fix is faulty RAM.  Thoroughly test your memory using one or both of the following methods.

 

The 3 symptoms above are the most common symptoms of bad RAM chips, but there are others too such as kernel OOPS and kernel panics and other syslog errors resulting in a 'Call Trace'.  While there may be other causes for these, the first test you should always do (and the easiest!) is to thoroughly test your memory chips.  The following 2 methods will test your RAM for problems, and report any errors found.  IMPORTANT!  Not one error is acceptable!  If you run a Memtest for 12 hours and it only finds one problem, then you need to replace a RAM stick!  You absolutely HAVE to be able to trust your memory.  When you test memory, you expect 100% perfection, no matter how long you test!

 

Note: there are 2 different Memtest programs, Memtest86 and Memtest86+.  They look very much alike for good reason - they have the same base code!  When the original development stopped in 2002, for about 2 years, an open source group created Memtest86+ from the code, and continued updating it until stopping in 2013, with v5.01 being their last release.  The free open source Memtest86+ v5.01 is what is included with unRAID.  PassMark Software bought the rights to the original code in 2013, and has been updating it ever since, as MemTest86, currently at v7.2.  Many newer technologies and tests have been added, such as DDR4, extensive ECC testing, row hammer testing, and much more.  The newer features do require UEFI support, and if not found, an older version will be booted instead.  While it's now a commercial product, they have continued offering a free version, for personal use only, but it is not licensed for inclusion with the unRAID software distribution.

 

Note 2: both methods assume you can view what is on the console of the unRAID server.  That usually means an attached monitor and keyboard, but could also mean remote viewing through IPMI.  There is NO WAY to run a memory test on a headless server (unless you can use IPMI).  To run either method, you MUST find a way to view the console, and you need a keyboard to select the test.  The PassMark Memtest can also use a mouse, so an attached mouse will be very helpful in Method 2.

 

* Method 1 - using the built-in Memtest

  • You MUST be able to see the console and use a keyboard to select Memtest from the boot menu.
  • On booting your unRAID server, when the boot menu appears, select Memtest, and it will begin.  It will run continuously until you reboot.

* Method 2 - using the PassMark Memtest

  • You MUST be able to see the console and use a keyboard to select Memtest(?).  A mouse will also be very helpful, recommended.
  • (download from PassMark, create bootable USB drive, configure UEFI settings to boot UEFI, boot, after completion restore UEFI settings)
  • PassMark download
  • PassMark installation help
  • (work in progress)

 

Bad memory defects will fail the tests on the very first Memtest pass.  Once you see the first error, you can stop the test as there's no point in continuing.  Unfortunately, other memory defects are much harder to find, marginal cells that appear to work fine *most* of the time.  *Most* of the time is not good enough, they need to be perfect *all* of the time.  So you will need to let the tests run a long time, waiting for that marginal cell to fail.  Again, even one error means a bad memory stick.  How long is long enough?  I believe over night, or 12 hours is sufficient, but it's possible that in some circumstances, even longer may be needed.

 

If you do get an error, then you will want to isolate which stick is bad and which ones are fine.  That means alternately testing different combinations of sticks, or each stick individually.

 

This is a work in progress, but almost ready to put online!

  • Upvote 1

Share this post


Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now

Copyright © 2005-2017 Lime Technology, Inc. unRAID® is a registered trademark of Lime Technology, Inc.