Mirrors/Sonarr
1
0
Fork 0
mirror of https://github.com/Sonarr/Sonarr.git synced 2024-11-25 04:02:48 +01:00
Code Issues Releases Wiki Activity

Port Health Checks wiki info from Sonarr with amends

James White 2017-08-12 01:18:41 +01:00
parent 117ad1f771
commit b912b9a74b
1 changed files with 30 additions and 53 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

83
Health-Checks.md

@ -1,11 +1,11 @@
This page contains a list of health checks errors.
These health checks are periodically performed performed by Sonarr and on certain events. The resulting warnings and errors are listed here to give advice on how to resolve them.
These health checks are periodically performed performed by Radarr and on certain events. The resulting warnings and errors are listed here to give advice on how to resolve them.
### System warnings ###
#### Mono version is less than 3.10, upgrade for improved stability ####
Sonarr is written in .Net and requires Mono to run. Versions of 3.10 and above resolved various stability issues we experienced in the past and is considered the minimum supported version.
Radarr is written in .Net and requires Mono to run. Versions of 3.10 and above resolved various stability issues we experienced in the past and is considered the minimum supported version.
Mono version 4.x and higher are also available and provides a better experience on certain platforms.
#### New update is available ####
@ -19,41 +19,41 @@ _(This warning will not appear if your current version is less than 14 days old)
#### Cannot install update because startup folder is not writable by the user ####
This means Sonarr will be unable to update itself. You'll have to update Sonarr manually or set the permissions on Sonarr's Startup directory (the installation directory) to allow Sonarr to update itself.
This means Radarr will be unable to update itself. You'll have to update Radarr manually or set the permissions on Radarr's Startup directory (the installation directory) to allow Radarr to update itself.
#### Updating will not be possible to prevent deleting AppData on Update ####
Sonarr detected that AppData folder for your Operating System is located inside the directory that contains the Sonarr binaries. Normally it would be ```C:\ProgramData``` for Windows and, ```~/.config``` for linux.
Radarr detected that AppData folder for your Operating System is located inside the directory that contains the Radarr binaries. Normally it would be ```C:\ProgramData``` for Windows and, ```~/.config``` for linux.
Please look at System -> Info to see the current AppData & Startup directories.
This means Sonarr will be unable to update itself without risking data-loss.
This means Radarr will be unable to update itself without risking data-loss.
If you're on linux, you'll probably have to change the home directory for the user that is running Sonarr and copy the current contents of the ```~/.config/Sonarr``` directory to preserve your database.
If you're on linux, you'll probably have to change the home directory for the user that is running Radarr and copy the current contents of the ```~/.config/Radarr``` directory to preserve your database.
### Download Clients ###
#### No download client is available ####
A properly configured and enabled download client is required for Sonarr to be able to download media.
Since Sonarr supports different download clients, you should determine which best matches your requirements.
If you already have a download client installed, you should configure Sonarr to use it and create a category. See Settings -> Download Client.
A properly configured and enabled download client is required for Radarr to be able to download media.
Since Radarr supports different download clients, you should determine which best matches your requirements.
If you already have a download client installed, you should configure Radarr to use it and create a category. See Settings -> Download Client.
#### Unable to communicate with download client ####
Sonarr was unable to communicate with the configured download client. Please verify if the download client is operational and double check the url. This could also indicate an authentication error.
Radarr was unable to communicate with the configured download client. Please verify if the download client is operational and double check the url. This could also indicate an authentication error.
#### Download clients are unavailable due to failure ####
One or more of your download clients is not responding to requests made by Sonarr. Therefore Sonarr has decided to temporarily stop querying the download client on it's normal 1 minute cycle, which is normally used to track active downloads and import finished ones.
However, Sonarr will continue to attempt to send downloads to the client, but will in all likeliness fail.
One or more of your download clients is not responding to requests made by Radarr. Therefore Radarr has decided to temporarily stop querying the download client on it's normal 1 minute cycle, which is normally used to track active downloads and import finished ones.
However, Radarr will continue to attempt to send downloads to the client, but will in all likeliness fail.
You should inspect System->Logs to see what the reason is for the failures.
If you no longer use this download client, disable it in Sonarr to prevent the errors.
If you no longer use this download client, disable it in Radarr to prevent the errors.
#### Enable Completed Download Handling or configure Drone Factory ####
Sonarr requires Completed Download Handling or a properly configured Drone Factory to be able to import files that were downloaded by the download client. It is recommended to enable Completed Download Handling.
Radarr requires Completed Download Handling or a properly configured Drone Factory to be able to import files that were downloaded by the download client. It is recommended to enable Completed Download Handling.
_(Completed Download Handling is enabled by default for new users.)_
@ -61,30 +61,25 @@ _(Completed Download Handling is enabled by default for new users.)_
#### Drone Factory folder does not exist ####
If you configure Sonarr to use a Drone Factory the specified folder must exist. Please ensure that it indeed exists, or disable the Drone Factory.
If you configure Radarr to use a Drone Factory the specified folder must exist. Please ensure that it indeed exists, or disable the Drone Factory.
_(You might want to consider using Completed Download Handling since it provides better compatibility for the unpacking and post-processing logic of various download clients.)_
#### Unable to write to Drone Factory folder ####
You configured Sonarr to use a Drone Factory, however Sonarr was unable to creates a test file, this indicates permission issues.
Please verify that the user Sonarr runs under has the appropriate permissions.
You configured Radarr to use a Drone Factory, however Radarr was unable to creates a test file, this indicates permission issues.
Please verify that the user Radarr runs under has the appropriate permissions.
#### Drone Factory is deprecated ####
**Please don't panic.**
The Drone Factory is unreliable in various situations and has been replaced by Completed Download Handling and external API calls over a year ago. This functionality will be removed in a future major version of Sonarr and should no longer be used.
The Drone Factory is unreliable in various situations and has been replaced by Completed Download Handling and external API calls over a year ago. This functionality will be removed in a future major version of Radarr and should no longer be used.
_Please note that the Drone Factory periodic scan functionality will not be removed via an automatic update, but rolled into an future backward-incompatible v3 major release which in most cases will require manual installation._
In most cases Completed Download Handling should work properly, more information [here](https://github.com/Sonarr/Sonarr/wiki/Completed-Download-Handling).
For occasional manual downloads use Wanted->Manual Import. It'll allow you to select a directory and optionally review the parsing results before actually importing. Useful for the occasional manual download that isn't handled automatically.
If the download client is on a remote machine, consider using remote mounts in combination with Settings->Download Clients->Remote Path Mapping to make Sonarr aware of the mount. Alternatives are available.
For custom external imports such as after transcoding, custom transfer/btsync/lftp/etc, use the API to signal Sonarr to scan a specific directory using the [DownloadedEpisodesScan](https://github.com/Sonarr/Sonarr/wiki/Command#downloadedepisodesscan) command.
If you require advice for your particular workflow, please contact us on the forums at https://forums.sonarr.tv.
If the download client is on a remote machine, consider using remote mounts in combination with Settings->Download Clients->Remote Path Mapping to make Radarr aware of the mount. Alternatives are available.
Please disable the Drone Factory:
@ -94,8 +89,6 @@ Please disable the Drone Factory:
- Make sure the Drone Factory Interval field is set to 0
- Save settings
Please see [Completed Download Handling](https://github.com/Sonarr/Sonarr/wiki/Completed-Download-Handling) for more information.
### Completed/Failed Download Handling ###
#### Completed Download Handling is disabled ####
@ -103,27 +96,27 @@ Please see [Completed Download Handling](https://github.com/Sonarr/Sonarr/wiki/C
_(This warning is only generated for existing users before when the Completed Download Handling feature was implemented. This feature is disabled by default to ensure the system continued to operate as expected for current configurations.)_
It's recommended to switch to Completed Download Handling since it provides better compatibility for the unpacking and post-processing logic of various download clients.
With it, Sonarr will only import a download once the download client reports it as ready.
With it, Radarr will only import a download once the download client reports it as ready.
If you don't wish to enable Completed Download Handling at all and wants to remove the warning. You can enable and then disable Completed Download Handling. This obviously isn't recommended.
If you wish to enable Completed Download Handling you should verify the following:
* **Warning**: Completed Download Handling only works properly if the download client and Sonarr are on the same machine since it gets the path to be imported directly from the download client.
* If you added a post-processing script to Sabnzbd/NzbGet to notify Sonarr that it should scan the Drone Factory. You _SHOULD_ disable this script to prevent conflicts.
* **Warning**: Completed Download Handling only works properly if the download client and Radarr are on the same machine since it gets the path to be imported directly from the download client.
* If you added a post-processing script to Sabnzbd/NzbGet to notify Radarr that it should scan the Drone Factory. You _SHOULD_ disable this script to prevent conflicts.
* Completed Download Handling and the Drone Factory cannot be configured for the same directory. If Completed Download Handling detects a download resides in the Drone Factory it will be ignored. (again to prevent conflicts)
You should reconfigure Sonarr to use a different Drone Factory Folder or disable it altogether.
You should reconfigure Radarr to use a different Drone Factory Folder or disable it altogether.
Alternatively you can change the output folder for the Category, as long as that output folder is not a subdirectory of the Drone Factory Folder.
Both Completed Download Handling and the Drone Factory logic generates Import Events in history while importing files. However, only Completed Download Handling associates this Import event with a Download Client history item.
If Completed Download Handling was enabled recently, your download client may still contain history items that were already imported but do not have a history event with the same unique id.
Sonarr attempts to resolve this issue automatically, occassionally Sonarr may be unable to make that association and cause a 'Completed' download to be listed in the History -> Queue table forever.
Radarr attempts to resolve this issue automatically, occassionally Radarr may be unable to make that association and cause a 'Completed' download to be listed in the History -> Queue table forever.
The easiest way to resolve this is to clear your Download Client history, or only those individual items. Alternatively you can rename the category.
#### Download Client has history items in Drone Factory conflicting with Completed Download Handling ####
The Download Client put finished downloads inside the Drone Factory even though Completed Download Handling is configured.
This could potentially cause both Completed Download Handling and the Drone Factory logic to import the same download simultaneously.
To avoid conflicts Sonarr will ignore those downloads during it's Completed Download Handling logic, leaving it to be handled by the Drone Factory.
To avoid conflicts Radarr will ignore those downloads during it's Completed Download Handling logic, leaving it to be handled by the Drone Factory.
This is a suboptimal situation since this effectively disabled Completed Download Handling.
Resolution: Configure the Drone Factory to use a different folder.
@ -134,35 +127,19 @@ _**TODO: Reword**_
#### No indexers are enabled ####
Sonarr requires indexers to be able to discover new releases.
Radarr requires indexers to be able to discover new releases.
Please read the wiki on instructions how to add indexers.
#### Enabled indexers do not support searching ####
None of the indexers you have enabled support searching. This means Sonarr will only be able to find new releases via the RSS feeds. But searching for episodes (either Automatic Search or Manual Search) will never return any results.
None of the indexers you have enabled support searching. This means Radarr will only be able to find new releases via the RSS feeds. But searching for movies (either Automatic Search or Manual Search) will never return any results.
Obviously, the only way to remedy it is to add another indexer.
#### Indexers are unavailable due to failures ####
Errors occurs while Sonarr tried to use one of your indexers. To limit retries, Sonarr will not use the indexer for an increasing amount of time (up to 24h).
This mechanism is triggered if Sonarr was unable to get a response from the indexer (could be dns, connection, authentication or indexer issue), or unable to fetch the nzb/torrent file from the indexer. Please inspect the logs to determine what kind of error causes the problem.
Errors occurs while Radarr tried to use one of your indexers. To limit retries, Radarr will not use the indexer for an increasing amount of time (up to 24h).
This mechanism is triggered if Radarr was unable to get a response from the indexer (could be dns, connection, authentication or indexer issue), or unable to fetch the nzb/torrent file from the indexer. Please inspect the logs to determine what kind of error causes the problem.
You can prevent the warning by disabling the affected indexer.
Run the Test on the indexer to force Sonarr to recheck the indexer, please note that the Health Check warning will not always disappear immediately.
### Series Folders ###
#### Missing root folder ####
_**TODO**_
This message may appear if a previous root folder is no longer used. To remove old root folders:
1. Begin adding a new Series by searching for a name, but do not submit
2. In the 'Path' dropdown, select 'Add a different path'
3. Click the cross at the end of a row to remove the unused path
Note - if the folder has been removed from the operating system, you will need to recreate the folder in the operating system, and restart Sonarr, or else you will not be able to select it from the dropdown box. After that you can remove the path from the operating system.
The message will continue to appear until all series have their root folder updated to the new root folder. To change the root folder for other series, visit the series editor.
Run the Test on the indexer to force Radarr to recheck the indexer, please note that the Health Check warning will not always disappear immediately.