Squid

[Plugin] CA Fix Common Problems

917 posts in this topic Last Reply

Recommended Posts

This plugin is designed to find and offer up suggestions to a multitude of configuration errors, outright problems, etc for numerous aspects of your unRaid server.

 

To install this plugin, just head over to the Apps tab and search for Fix Common Problems.

 

 

After installation, you will see a lifesaver within Settings / User Utilities which will launch a manual scan (and give you the option to set the background scan settings)

 

For every error or warning that this plugin finds, a suggested course of action will also be displayed.  Additionally, should you seek additional help for any error / warning, the errors are all logged into your syslog so that persons helping can easily find the issue when you post your diagnostics.

 

Scans can be scheduled to run automatically in the background (you have the option of hourly, daily, weekly, and monthly).

 

Additionally, if the background scans find an issue they will send out a notification (depending upon your notification settings in this plugin)

 

The current list of tested items will be maintained in the second post of this thread.

 

Any support for problems this plugin finds, should be posted in the General v6 section of these forums.  Problems relating to false positives, suggestions for more checks, why I made the decisions I did, wording mistakes in suggestions, etc. should be posted here.

 

As usual for anything written by me, updates are frequent as new ideas pop into my head.  Highly recommended to turn on auto-updates for this plugin.

 

Additionally, a special "Troubleshooting Mode" is available to assist with problems involving random crashes / shutdowns / lockups / etc

 

A video with a basic run through of FCP can be found here: (at about 18:25)

 

Edited by Squid
  • Upvote 7

Share this post


Link to post

Generating Errors

 

  • Plugin Update Check not enabled
  • This plugin (fix common problems) not set to autoupdate
  • Similar named shares differing by case (MyShare, myshare)
  • Powerdown not installed
  • Server unable to communicate to outside world
  • Unable to write to array disks or cache drive
  • Unable to write to flash drive
  • Unable to write to docker image
  • Any disk disabled
  • Any disk missing
  • Any read error on a disk
  • Any file system error on a disk
  • This plugin (fix.common.errors.plg) not up to date (displayed only if not set to auto update)
  • Any 32 bit package found within /boot/extra or /boot/package
  • /var/log more than 80% full (warning at 50%)
  • docker image file more than 90% full (warning at 80%)
  • rootfs more than 90% full (warning at 75%)
  • Any share having the same disk set in both included and excluded disks
  • Global share settings having the same disk set in both included and excluded disks
  • Any array or cache drive not formatted as reiserFS, XFS, or btrFS
  • Flash drive not formatted as FAT32
  • Any blacklisted plugin installed
  • Any docker container with the container port changed from the template author's default value
  • Adblocker enabled (and server is not whitelisted)
  • Illegal characters in share names
  • Array not started
  • Any docker container running in a network mode other than the template author's default value
  • HPA found on the parity drive
  • An illegal suffix on the cache floor settings
  • Cache floor settings > cache disk size
  • Unclean shutdown / reboot detected
  • Hack attempts on your server
  • Plugins known to CA that are incompatible with your version of unRaid
  • Cache Only shares, but not cache drive set
  • User shares named the same as a disk share
  • Out of memory (OOM) errors
  • Any Call Trace found

 

Generating Warnings

 

  • Implied Array Only share having files on cache drive
  • Cache Only share having files on array
  • Array Only share having files on cache drive
  • CA not set to auto update itself
  • Dynamix WebUI not set to autoupdate
  • CA not installed
  • Default docker appdata location set to be /mnt/user/... (this is a 6.2 thing only)
  • Default docker appdata location not a cache only share (if cache present, and 6.2 only)
  • Any SSD part of the array
  • Any installed plugin not up to date (if its not set to auto update)
  • Any docker application with an update available
  • Any docker application with its /config volume mounting set to be /mnt/user/appdata/...
  • /var/log more than 50% full (error at 80%)
  • docker image file more than 80% full (error at 90%)
  • rootfs more than 75% full (error at 90%)
  • date and time on server differ by more than 5 minutes from the actual date and time
  • scheduled parity checks disabled
  • Any share having both included and excluded disks set
  • Global share settings having both included and excluded disks set
  • FTP server enabled.
  • No destination set for Warning and Alert level notifications ( Browser / Email / Agents)
  • If email set for any alert level, check for server address and recipient in smtp settings)
  • Any plugin not known to CA (plugin is more than likely 6.0 compatible only and will only mess up your system)
  • Flash drive getting to be 90% full
  • Cache drive free space less than cache floor setting
  • User share permissions not set to LT standard of 0777
  • Docker application webUI changed from template author's default
  • Extra Parameters for docker App set via Repository instead of Extra Parameters (old style)
  • Files / Folders contained within /mnt that is not normally there
  • Exhaustion of inotify watches
  • IRQ:xx Nobody cared messages
  • SSD Cache drive formatted as ReiserFS (does not support Trim)
  • SSD Cache drive installed, but Dynamix SSD Trim plugin not installed

 

Other Warnings:

 

  • HPA found on any disk other than parity (IMHO not a real issue unless its on the parity drive)
  • No CPU Throttling Driver Installed

 

Extended Tests:

 

  • Check every file / folder for permission issues
  • Check every file / folder for invalid characters
  • Check for duplicated files
  • Check for folders with same name but different case

 

Edited by Squid
  • Upvote 1

Share this post


Link to post

Yes, BRiT this post is reserved

 

Share this post


Link to post

There may be a false positive reported with regards to auto update of Dynamix webUI and Community Applications, and this plugin.

 

If you have not made any changes to CA's auto update settings, a false positive will be reported for these warnings.  Just go to Autoupdate Settings (Community Applications Settings) and make a change, any change and apply.  From here on in those warnings will be legitimate.  I have to update CA in the next day or so to fix this one time false positive

 

Share this post


Link to post

I agree this sort of thing should be flagged because most of the time it is a problem, and as long as nothing happens automatically we'll be fine.  Although if there was a way to mark a specific share to be ignored, that would be cool too :)

What I'll do is switch it over to being a warning, as its not exactly a major error, and the system is still functional with it like that.

Thought even more about it, and what I'm going to do is completely remove the options to have this plugin move the data around for you to/from the cache, and instead point them to dolphin / krusader / mc.  I'll just leave the suggestion to fix the settings however.

 

Makes my job a ton easier, and takes me off the hook if anything unexpected should happen during the move.

 

Ahhhh ...

 

You just tossed the holy grail back in the cave!  Here I thought we were on a course to a tool that could find all problems, then fix them too!  Like the Elysium movie medical machine.  ;)

Share this post


Link to post

I agree this sort of thing should be flagged because most of the time it is a problem, and as long as nothing happens automatically we'll be fine.  Although if there was a way to mark a specific share to be ignored, that would be cool too :)

What I'll do is switch it over to being a warning, as its not exactly a major error, and the system is still functional with it like that.

Thought even more about it, and what I'm going to do is completely remove the options to have this plugin move the data around for you to/from the cache, and instead point them to dolphin / krusader / mc.  I'll just leave the suggestion to fix the settings however.

 

Makes my job a ton easier, and takes me off the hook if anything unexpected should happen during the move.

 

Ahhhh ...

 

You just tossed the holy grail back in the cave!  Here I thought we were on a course to a tool that could find all problems, then fix them too!  Like the Elysium movie medical machine.  ;)

Yeah, and if I start automatically fixing issues (even if having to punch a button to do it) then I wind up taking all responsibility for everything.  Its one thing for CA to backup appdata, its another thing for me to start moving somebody's family pictures off of the cache drive onto the array.

 

Not saying that it won't happen with certain of the found problems, but lets take this one step at a time.  Besides a some of the potential fixes require stopping / starting of the array to change certain settings, etc.

 

EDIT:  after 5 minutes of thought, now I'm starting to feel guilty about it and will begin adding FIX ME buttons for some of the simple fixes that don't require actual decisions to be made by the user.

Share this post


Link to post

Yeah, I'd be leery too.  There's no way I'd do it in less than a multi-step process - double check the destination is valid and has space, copy the files, verify the copies are perfect, then and then only delete the originals.  And I'd probably tell the user to try it first with test files, to make sure it's configured and working right.

Share this post


Link to post

Yeah, I'd be leery too.  There's no way I'd do it in less than a multi-step process - double check the destination is valid and has space, copy the files, verify the copies are perfect, then and then only delete the originals.  And I'd probably tell the user to try it first with test files, to make sure it's configured and working right.

But, like my edit above implies, its nothing for me to say delete 32 bit packages it finds, or delete the user list from FTP settings, or set autoupdate settings.  Simple config changes.  Most items however require a decision to be made, and even then it *would* be possible to come up with a script, but realistically am I going to invest a ton of time creating a script to walk through the process, getting input from the user that may only get used once?  And then hoping that it actually works under all the variables present in a server...

 

I think that the suggested fixes (and the buttons to actually take you to the correct page in the webUI) will suffice for those items.

Share this post


Link to post

Updated:

 

Errors now logged into syslog.  Fix RobJ's unique setup of no user shares and no docker returning errors

 

Just ran the new version, looks great!

 

My personal opinion, I think that the auto-update for this plugin (Fix Common Problems) should be a Warning not an Error, but it's not a big deal.

Share this post


Link to post

Updated:

 

Errors now logged into syslog.  Fix RobJ's unique setup of no user shares and no docker returning errors

 

Just ran the new version, looks great!

 

My personal opinion, I think that the auto-update for this plugin (Fix Common Problems) should be a Warning not an Error, but it's not a big deal.

Of the autoupdates, its the only one that generates an error instead of a warning so that people turn it on to keep the thing updated with new problems / suggestions.  Its a choice I made...  If everyone complains I'll demote it.

Share this post


Link to post

Strange thing... plugin told me, FTP-Server is running - but it is dissabled - lel  :D

Share this post


Link to post

Check for updates as that check changed a couple times yesterday.  It now checks to see if there are any entries in the authorized users.  There is a big with the ftp server where if it's disabled it's going to re enable it in the next boot.

 

But it's a warning anyways just to drive home the point about opening up the server to the internet. 

 

If there is no users listed then post back here

 

Sent from my LG-D852 using Tapatalk

 

http://lime-technology.com/forum/index.php?topic=48975.0

http://lime-technology.com/forum/index.php?topic=48931.msg469644#msg469644

 

EDIT: Now that I'm thinking about it, I can add another check to see if its actually disabled when there are valid users present.  Will update it tonight.

Share this post


Link to post

Getting this:

 

2 drive cache pool btrfs formatted

 

Disk cache2 is formatted as The only supported file systems are ReiserFS, btrFS, XFS. This error should only happen if you are setting up a new array and the disk already has data on it. Prior to with a fix, you should seek assistance in the forums as the disk may simply be unmountable. Whatever you do, do not hit the format button on the unRaid main screen as you will then lose data

 

Myk

Share this post


Link to post

Getting this:

 

2 drive cache pool btrfs formatted

 

Disk cache2 is formatted as The only supported file systems are ReiserFS, btrFS, XFS. This error should only happen if you are setting up a new array and the disk already has data on it. Prior to with a fix, you should seek assistance in the forums as the disk may simply be unmountable. Whatever you do, do not hit the format button on the unRaid main screen as you will then lose data

 

Myk

Can you give me your diagnostics.  I wasn't 100% sure how it was going to respond to a cache pool

 

Sent from my LG-D852 using Tapatalk

 

 

Share this post


Link to post

Will do as soon as I get home

 

Sent from my SM-G920V using Tapatalk

 

 

Share this post


Link to post

Will do as soon as I get home

 

Sent from my SM-G920V using Tapatalk

Thanks.  I spent a day trying to go through a ton of diagnostics online but obviously missed that one

 

Sent from my LG-D852 using Tapatalk

 

 

Share this post


Link to post

johnnie, are you able to test this on the cache drive?  Remove any cache drive, install UD so that the ntfs drivers are guaranteed to be there, and set up a cache drive with an NTFS formatted drive.  This works on my simulated disks.ini file, but I've looked around here, and believe it or not I can't find a hard drive that I don't currently have in use somewhere.

 

It works.

 

Disk cache is formatted as fuseblk	The only supported file systems are ReiserFS, btrFS, XFS. This error should only happen if you are setting up a new array and the disk already has data on it. Prior to with a fix, you should seek assistance in the forums as the disk may simply be unmountable. Whatever you do, do not hit the format button on the unRaid main screen as you will then lose data

Share this post


Link to post

Thank you; it works perfectly. I prompted me to fix a handful of minor things...

Share this post


Link to post

Updated to 2016.05.09

 

- Fix false positive on valid file system checks when cache pool present

- Enhanced detection on FTP server running

- Add Notification Checks

  (No destination (browser, email, agents) set for warnings or alerts

  (If email is selected on any type of alert, check for recipient address and server address within smtp settings)

 

Share this post


Link to post

Now checks for blacklisted plugins installed

 

Checks for unknown plugins installed (unknown as in not known to CA) - This will get rid of users still having S.N.A.P installed, old 6.0 only plugins, etc

 

Further enhancements to the FTP detection, along with a comment that if it is disabled, but users are defined, then its going to wind up getting enabled when you reboot

 

Share this post


Link to post

Now checks for blacklisted plugins installed

 

Checks for unknown plugins installed (unknown as in not known to CA) - This will get rid of users still having S.N.A.P installed, old 6.0 only plugins, etc

 

Further enhancements to the FTP detection, along with a comment that if it is disabled, but users are defined, then its going to wind up getting enabled when you reboot

 

Very nice!

 

I'd like to request another feature - can we have an option to disable any checks that cause disks to spin up?  I like that this can run on a regular basis, but I'd rather not spin my drives up unnecessarily.  Thanks!

Share this post


Link to post

Now checks for blacklisted plugins installed

 

Checks for unknown plugins installed (unknown as in not known to CA) - This will get rid of users still having S.N.A.P installed, old 6.0 only plugins, etc

 

Further enhancements to the FTP detection, along with a comment that if it is disabled, but users are defined, then its going to wind up getting enabled when you reboot

 

Very nice!

 

I'd like to request another feature - can we have an option to disable any checks that cause disks to spin up?  I like that this can run on a regular basis, but I'd rather not spin my drives up unnecessarily.  Thanks!

I'll add it, but TBH I don't really see the point in skipping what is arguably the most important test there - can unRaid actually store a file within every drive.  To my mind, this is no different than spinning up the disks for a monthly parity check, except that this actually does a basic test on the file system. 

 

Depending upon how another program is deciding to write the file, you may not even know that a write failed....  But, to each his own.

 

EDIT: As a meet half way type thing, what I'll do is instead of skipping the tests that can potentially spin up a drive is only run the test on the drive is unRaid thinks its spun up if you select that option.

Share this post


Link to post

I've added verbiage and pointers to 'Fix Common Problems' to Need help? Read me first!, Troubleshooting, and How-To's, and you've added it to the forum FAQ.  Can you or anyone else think of any where else it should go?

With tonight's / tomorrows update I'll add it to the docker FAQ as its going to do some tests that CHBMB is bugging me to add for installed apps

Share this post


Link to post

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-2018 Lime Technology, Inc.
unRAID® is a registered trademark of Lime Technology, Inc.