From 5077e0f620cb0d957b337f1d48387730ec51f2b7 Mon Sep 17 00:00:00 2001 From: Simon Date: Sat, 27 Apr 2024 13:59:27 +0200 Subject: [PATCH] better error clear wording --- mkdocs/docs/advanced.md | 30 ++++++++++++++++++++++-------- 1 file changed, 22 insertions(+), 8 deletions(-) diff --git a/mkdocs/docs/advanced.md b/mkdocs/docs/advanced.md index 984271c..8537a98 100644 --- a/mkdocs/docs/advanced.md +++ b/mkdocs/docs/advanced.md @@ -145,18 +145,32 @@ pip install \ This is obviously particularly likely to create problems. Also note that the `--version` command will only show the latest regular release, not a nightly version mentioned. ## Erase errors from download queue -Sometimes the download queue might have some videos that have errored due to rate limits or other issues during the download process. Videos that have errors won't be retried in a future download queue re-run unless you individually click "Download now" for each individual video or until the container is fully restarted. In order to bulk clear the errors from the download queue without restarting the container, you need to execute the following command from within the TA container: +Sometimes videos will fail to download. That can be because of expected errors: + +- A video is no longer available for download. + +That is not recoverable. + +Other kind of errors *are* recoverable, for example: + +- You got temporarily rate limited. +- Your internet connection dropped out. + +Failed downloads won't get retried again as they require your intervention. You can click on **Download Now** on a video in the queue to verify, if a video became available again. + +If you know that all errors are resolved you can bulk clear. Run this from within the TA container: + ???+ bug "Erase Errors" ```bash curl -X POST "$ES_URL/ta_download/_update_by_query?pretty" -u elastic:$ELASTIC_PASSWORD -H 'Content-Type: application/json' -d' { - "script": { - "source": "ctx._source.message = null", - "lang": "painless" - }, - "query": { - "match_all": {} - } + "script": { + "source": "ctx._source.message = null", + "lang": "painless" + }, + "query": { + "match_all": {} + } } ' ```