diff --git a/mkdocs/docs/advanced.md b/mkdocs/docs/advanced.md new file mode 100644 index 0000000..66e3157 --- /dev/null +++ b/mkdocs/docs/advanced.md @@ -0,0 +1,33 @@ +# Advanced Notes + +!!! note + As a general rule of thumb, make sure your backups are up to date before continuing with anything here. + +A loose collection of advanced debug info, may or may not apply to you, only use this when you know what you are doing. Some of that functionality might get implemented in the future in the regular UI. + +## Reactivate all Videos +As part of the metadata refresh task, Tube Archivist will mark videos as deactivated, if they are no longer available on YouTube. For some reasons, that might have deactivated videos that shouldn't have, for example if a video got reinstated after a copyright strike on YT. You can reactivate all videos in bulk, so the refresh task will check them again and deactivate the ones that are actually not available anymore. + +Run this curl command from within the TA container: + +```bash +curl -XPOST "$ES_URL/ta_video/_update_by_query?pretty" -u elastic:$ELASTIC_PASSWORD -H "Content-Type: application/json" -d ' +{ + "query": { + "term": { + "active": { + "value": false + } + } + }, + "script": { + "source": "ctx._source.active = true", + "lang": "painless" + } +}' +``` + +## Corrupted ES index reset +After a hard reset of your server or any other hardware failure you might experience data corruption. ES can be particularly unhappy about that, especially if the reset happens during actively writing to disk. It's very likely that only your `/indices` folder got corrupted, as that is where the regular read/writes happen. Luckily you have your [snapshots](settings.md#snapshots) set up. + +ES will not start, if the data is corrupted. So, stop all containers, delete everything *except* the `/snapshot` folder in the ES volume. After that, start everything back up. Tube Archivist will create a new blank index. All your snapshots should be available for restore on your settings page, you probably want to restore the most recent one. After restore, run a [filesystem rescan](settings.md#rescan-filesystem) for good measures. diff --git a/mkdocs/docs/stylesheets/style.css b/mkdocs/docs/stylesheets/style.css index 00d1ed1..e29af50 100644 --- a/mkdocs/docs/stylesheets/style.css +++ b/mkdocs/docs/stylesheets/style.css @@ -40,6 +40,10 @@ footer { border-color: var(--accent-font-light); } +.highlight .nv { + color: var(--highlight-error-light); +} + [data-md-color-scheme="tubearchivist"] { --md-default-bg-color: var(--main-bg); --md-default-fg-color: var(--main-font); @@ -60,6 +64,7 @@ footer { --md-code-hl-string-color: var(--accent-font-dark); --md-code-hl-number-color: var(--highlight-error-light); --md-code-hl-operator-color: var(--highlight-error); + --md-code-nv-color: var(--highlight-error); } :root { diff --git a/mkdocs/mkdocs.yml b/mkdocs/mkdocs.yml index dd64515..635c33e 100644 --- a/mkdocs/mkdocs.yml +++ b/mkdocs/mkdocs.yml @@ -12,6 +12,7 @@ nav: - 'Search': 'search.md' - 'Users': 'users.md' - 'Settings': 'settings.md' + - 'Advanced': 'advanced.md' - Installation: - 'Docker-Compose (default)': 'installation/docker-compose.md' - 'Unraid': 'installation/unraid.md'