kopia lustrzana https://dev.funkwhale.audio/funkwhale/funkwhale
384 wiersze
18 KiB
Plaintext
384 wiersze
18 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2022, The Funkwhale Collective
|
|
# This file is distributed under the same license as the funkwhale package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: funkwhale 1.2.3\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
|
|
"PO-Revision-Date: 2022-07-03 21:06+0000\n"
|
|
"Last-Translator: Ciarán Ainsworth <sporiff@funkwhale.audio>\n"
|
|
"Language-Team: English (United Kingdom) <https://translate.funkwhale.audio/"
|
|
"projects/documentation/admin-troubleshooting/en_GB/>\n"
|
|
"Language: en_GB\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Plural-Forms: nplurals=2; plural=n != 1;\n"
|
|
"X-Generator: Weblate 4.13\n"
|
|
|
|
#: ../../admin/troubleshooting.rst:2
|
|
msgid "Troubleshooting"
|
|
msgstr "Troubleshooting"
|
|
|
|
#: ../../admin/troubleshooting.rst:4
|
|
msgid "Various errors and issues can arise on your Funkwhale instance, caused by configuration errors, deployment/environment specific issues, or bugs in the software itself."
|
|
msgstr ""
|
|
"Various errors and issues can arise on your Funkwhale instance, caused by "
|
|
"configuration errors, deployment/environment specific issues, or bugs in the "
|
|
"software itself."
|
|
|
|
#: ../../admin/troubleshooting.rst:7
|
|
msgid "On this document, you'll find:"
|
|
msgstr "On this document, you'll find:"
|
|
|
|
#: ../../admin/troubleshooting.rst:9
|
|
msgid "Tools and commands you can use to better understand the issues"
|
|
msgstr "Tools and commands you can use to better understand the issues"
|
|
|
|
#: ../../admin/troubleshooting.rst:10
|
|
msgid "A list of common pitfalls and errors and how to solve them"
|
|
msgstr "A list of common pitfalls and errors and how to solve them"
|
|
|
|
#: ../../admin/troubleshooting.rst:11
|
|
msgid "A collection of links and advice to get help from the community and report new issues"
|
|
msgstr ""
|
|
"A collection of links and advice to get help from the community and report "
|
|
"new issues"
|
|
|
|
#: ../../admin/troubleshooting.rst:14
|
|
msgid "Diagnose problems"
|
|
msgstr "Diagnose problems"
|
|
|
|
#: ../../admin/troubleshooting.rst:16
|
|
msgid "Funkwhale is made of several components, each one being a potential cause for failure. Having an even basic overview of Funkwhale's technical architecture can help you understand what is going on. You can refer to :doc:`the technical architecture <../developers/architecture>` for that."
|
|
msgstr ""
|
|
"Funkwhale is made of several components, each one being a potential cause "
|
|
"for failure. Having an even basic overview of Funkwhale's technical "
|
|
"architecture can help you understand what is going on. You can refer to "
|
|
":doc:`the technical architecture <../developers/architecture>` for that."
|
|
|
|
#: ../../admin/troubleshooting.rst:19
|
|
msgid "Problems usually fall into one of those categories:"
|
|
msgstr "Problems usually fall into one of those categories:"
|
|
|
|
#: ../../admin/troubleshooting.rst:21
|
|
msgid "**Frontend**: Funkwhale's interface is not loading, not behaving as expected, music is not playing"
|
|
msgstr ""
|
|
"**Frontend**: Funkwhale's interface is not loading, not behaving as "
|
|
"expected, music is not playing"
|
|
|
|
#: ../../admin/troubleshooting.rst:22
|
|
msgid "**API**: the interface do not display any data or show errors"
|
|
msgstr "**API**: the interface do not display any data or show errors"
|
|
|
|
#: ../../admin/troubleshooting.rst:23
|
|
msgid "**Import**: uploaded/imported tracks are not imported correctly or at all"
|
|
msgstr ""
|
|
"**Import**: uploaded/imported tracks are not imported correctly or at all"
|
|
|
|
#: ../../admin/troubleshooting.rst:24
|
|
msgid "**Federation**: you cannot contact other Funkwhale servers, access their library, play federated tracks"
|
|
msgstr ""
|
|
"**Federation**: you cannot contact other Funkwhale servers, access their "
|
|
"library, play federated tracks"
|
|
|
|
#: ../../admin/troubleshooting.rst:25
|
|
msgid "**Everything else**"
|
|
msgstr "**Everything else**"
|
|
|
|
#: ../../admin/troubleshooting.rst:27
|
|
msgid "Each category comes with its own set of diagnose tools and/or commands we will detail below. We'll also give you simple steps for each type of problem. Please try those to see if it fix your issues. If none of those works, please report your issue on our issue tracker."
|
|
msgstr ""
|
|
"Each category comes with its own set of diagnose tools and/or commands we "
|
|
"will detail below. We'll also give you simple steps for each type of "
|
|
"problem. Please try those to see if it fix your issues. If none of those "
|
|
"works, please report your issue on our issue tracker."
|
|
|
|
#: ../../admin/troubleshooting.rst:33
|
|
msgid "To get detailed log messages, set the environment variable ``LOGLEVEL=debug``. If you are using the docker setup you can configure this in the ``.env`` file."
|
|
msgstr ""
|
|
"To get detailed log messages, set the environment variable ``LOGLEVEL=debug``"
|
|
". If you are using the docker setup you can configure this in the ``.env`` "
|
|
"file."
|
|
|
|
#: ../../admin/troubleshooting.rst:37
|
|
msgid "Backend issues"
|
|
msgstr "Backend issues"
|
|
|
|
#: ../../admin/troubleshooting.rst:39
|
|
#: ../../admin/troubleshooting.rst:98
|
|
#: ../../admin/troubleshooting.rst:109
|
|
msgid "Diagnostic tools:"
|
|
msgstr "Diagnostic tools:"
|
|
|
|
#: ../../admin/troubleshooting.rst:42
|
|
msgid "Reverse proxy logs:"
|
|
msgstr "Reverse proxy logs:"
|
|
|
|
#: ../../admin/troubleshooting.rst:42
|
|
msgid "Apache logs should be available at :file:`/var/log/apache/access.log` and :file:`/var/log/apache/error.log`"
|
|
msgstr ""
|
|
"Apache logs should be available at :file:`/var/log/apache/access.log` and "
|
|
":file:`/var/log/apache/error.log`"
|
|
|
|
#: ../../admin/troubleshooting.rst:43
|
|
msgid "Nginx logs should be available at :file:`/var/log/nginx/access.log` and :file:`/var/log/nginx/error.log`"
|
|
msgstr ""
|
|
"Nginx logs should be available at :file:`/var/log/nginx/access.log` and "
|
|
":file:`/var/log/nginx/error.log`"
|
|
|
|
#: ../../admin/troubleshooting.rst:46
|
|
#: ../../admin/troubleshooting.rst:112
|
|
msgid "API logs:"
|
|
msgstr "API logs:"
|
|
|
|
#: ../../admin/troubleshooting.rst:45
|
|
#: ../../admin/troubleshooting.rst:112
|
|
msgid "Docker setup: ``docker-compose logs -f --tail=50 api`` (remove the ``--tail`` flag to get the full logs)"
|
|
msgstr ""
|
|
"Docker setup: ``docker-compose logs -f --tail=50 api`` (remove the ``--tail``"
|
|
" flag to get the full logs)"
|
|
|
|
#: ../../admin/troubleshooting.rst:46
|
|
#: ../../admin/troubleshooting.rst:113
|
|
msgid "Non-docker setup: ``journalctl -xn -u funkwhale-server``"
|
|
msgstr "Non-docker setup: ``journalctl -xn -u funkwhale-server``"
|
|
|
|
#: ../../admin/troubleshooting.rst:50
|
|
msgid "If you edit your .env file to test a new configuration, you have to restart your services to pick up the changes:"
|
|
msgstr ""
|
|
"If you edit your .env file to test a new configuration, you have to restart "
|
|
"your services to pick up the changes:"
|
|
|
|
#: ../../admin/troubleshooting.rst:52
|
|
msgid "Docker setup: ``docker-compose up -d``"
|
|
msgstr "Docker setup: ``docker-compose up -d``"
|
|
|
|
#: ../../admin/troubleshooting.rst:53
|
|
msgid "Non-docker setup: ``systemctl restart funkwhale.target``"
|
|
msgstr "Non-docker setup: ``systemctl restart funkwhale.target``"
|
|
|
|
#: ../../admin/troubleshooting.rst:56
|
|
#: ../../admin/troubleshooting.rst:119
|
|
msgid "Common problems"
|
|
msgstr "Common problems"
|
|
|
|
#: ../../admin/troubleshooting.rst:59
|
|
msgid "Instance works properly, but audio files are not served (404 error)"
|
|
msgstr "Instance works properly, but audio files are not served (404 error)"
|
|
|
|
#: ../../admin/troubleshooting.rst:61
|
|
msgid "If you're using docker, ensure the ``MEDIA_ROOT`` variable is commented in your env file"
|
|
msgstr ""
|
|
"If you're using docker, ensure the ``MEDIA_ROOT`` variable is commented in "
|
|
"your env file"
|
|
|
|
#: ../../admin/troubleshooting.rst:62
|
|
msgid "Ensure the ``_protected/media`` block points toward the path where media files are stored (``/srv/funkwhale/data/media``, by default)"
|
|
msgstr ""
|
|
"Ensure the ``_protected/media`` block points toward the path where media "
|
|
"files are stored (``/srv/funkwhale/data/media``, by default)"
|
|
|
|
#: ../../admin/troubleshooting.rst:63
|
|
msgid "If you're using in-place import, ensure :data:`MUSIC_DIRECTORY_PATH <config.settings.common.MUSIC_DIRECTORY_PATH>`, :data:`MUSIC_DIRECTORY_SERVE_PATH <config.settings.common.MUSIC_DIRECTORY_SERVE_PATH>` and :data:`REVERSE_PROXY_TYPE <config.settings.common.REVERSE_PROXY_TYPE>` are configured properly, and that the files are readable by the webserver"
|
|
msgstr ""
|
|
"If you're using in-place import, ensure :data:`MUSIC_DIRECTORY_PATH <config."
|
|
"settings.common.MUSIC_DIRECTORY_PATH>`, :data:`MUSIC_DIRECTORY_SERVE_PATH "
|
|
"<config.settings.common.MUSIC_DIRECTORY_SERVE_PATH>` and :data:`"
|
|
"REVERSE_PROXY_TYPE <config.settings.common.REVERSE_PROXY_TYPE>` are "
|
|
"configured properly, and that the files are readable by the webserver"
|
|
|
|
#: ../../admin/troubleshooting.rst:66
|
|
msgid "Weakref error when running ``python manage.py <command>``"
|
|
msgstr "Weakref error when running ``python manage.py <command>``"
|
|
|
|
#: ../../admin/troubleshooting.rst:68
|
|
msgid "On Python <3.6, you may see this kind of errors when running commands like ``python manage.py migrate``::"
|
|
msgstr ""
|
|
"On Python <3.6, you may see this kind of errors when running commands like ``"
|
|
"python manage.py migrate``::"
|
|
|
|
#: ../../admin/troubleshooting.rst:75
|
|
msgid "This is caused by a bug in Python (cf https://github.com/celery/celery/issues/3818), and is not affecting in any way the command you execute. You can safely ignore this error."
|
|
msgstr ""
|
|
"This is caused by a bug in Python (cf https://github.com/celery/celery/"
|
|
"issues/3818), and is not affecting in any way the command you execute. You "
|
|
"can safely ignore this error."
|
|
|
|
#: ../../admin/troubleshooting.rst:79
|
|
msgid "``Your models have changes that are not yet reflected in a migration`` warning"
|
|
msgstr ""
|
|
"``Your models have changes that are not yet reflected in a migration`` "
|
|
"warning"
|
|
|
|
#: ../../admin/troubleshooting.rst:81
|
|
msgid "When running ``python manage.py migrate`` (both in docker or non-docker), you may end-up with this::"
|
|
msgstr ""
|
|
"When running ``python manage.py migrate`` (both in docker or non-docker), "
|
|
"you may end-up with this::"
|
|
|
|
#: ../../admin/troubleshooting.rst:91
|
|
msgid "This warning can be safely ignored. You should not run the suggested ``manage.py makemigrations`` command."
|
|
msgstr ""
|
|
"This warning can be safely ignored. You should not run the suggested ``"
|
|
"manage.py makemigrations`` command."
|
|
|
|
#: ../../admin/troubleshooting.rst:94
|
|
msgid "File import issues"
|
|
msgstr "File import issues"
|
|
|
|
#: ../../admin/troubleshooting.rst:96
|
|
msgid "Unless you are using the CLI to import files, imports are send as tasks in a queue to a celery worker that will process them."
|
|
msgstr ""
|
|
"Unless you are using the CLI to import files, imports are send as tasks in a "
|
|
"queue to a celery worker that will process them."
|
|
|
|
#: ../../admin/troubleshooting.rst:102
|
|
#: ../../admin/troubleshooting.rst:116
|
|
msgid "Celery worker logs:"
|
|
msgstr "Celery worker logs:"
|
|
|
|
#: ../../admin/troubleshooting.rst:101
|
|
#: ../../admin/troubleshooting.rst:115
|
|
msgid "Docker setup: ``docker-compose logs -f --tail=50 celeryworker`` (remove the ``--tail`` flag to get the full logs)"
|
|
msgstr ""
|
|
"Docker setup: ``docker-compose logs -f --tail=50 celeryworker`` (remove the "
|
|
"``--tail`` flag to get the full logs)"
|
|
|
|
#: ../../admin/troubleshooting.rst:102
|
|
#: ../../admin/troubleshooting.rst:116
|
|
msgid "Non-docker setup: ``journalctl -xn -u funkwhale-worker``"
|
|
msgstr "Non-docker setup: ``journalctl -xn -u funkwhale-worker``"
|
|
|
|
#: ../../admin/troubleshooting.rst:105
|
|
msgid "Federation issues"
|
|
msgstr "Federation issues"
|
|
|
|
#: ../../admin/troubleshooting.rst:107
|
|
msgid "Received federations messages are sent to a dedicated task queue and processed asynchronously by a celery worker."
|
|
msgstr ""
|
|
"Received federations messages are sent to a dedicated task queue and "
|
|
"processed asynchronously by a celery worker."
|
|
|
|
#: ../../admin/troubleshooting.rst:122
|
|
msgid "I have no access to another instance library"
|
|
msgstr "I have no access to another instance library"
|
|
|
|
#: ../../admin/troubleshooting.rst:124
|
|
msgid "Check if it works with the demo library (library@demo.funkwhale.audio)"
|
|
msgstr "Check if it works with the demo library (library@demo.funkwhale.audio)"
|
|
|
|
#: ../../admin/troubleshooting.rst:125
|
|
msgid "Check if the remote library received your follow request and approved it"
|
|
msgstr ""
|
|
"Check if the remote library received your follow request and approved it"
|
|
|
|
#: ../../admin/troubleshooting.rst:126
|
|
msgid "Trigger a scan via the interface"
|
|
msgstr "Trigger a scan via the interface"
|
|
|
|
#: ../../admin/troubleshooting.rst:127
|
|
msgid "Have a look in the celery logs for potential errors during the scan"
|
|
msgstr "Have a look in the celery logs for potential errors during the scan"
|
|
|
|
#: ../../admin/troubleshooting.rst:130
|
|
msgid "Other problems"
|
|
msgstr "Other problems"
|
|
|
|
#: ../../admin/troubleshooting.rst:132
|
|
msgid "It's a bit hard to give targeted advice about problems that do not fit in the previous categories. However, we can recommend to:"
|
|
msgstr ""
|
|
"It's a bit hard to give targeted advice about problems that do not fit in "
|
|
"the previous categories. However, we can recommend to:"
|
|
|
|
#: ../../admin/troubleshooting.rst:134
|
|
msgid "Try to identify the scope of the issue and reproduce it reliably"
|
|
msgstr "Try to identify the scope of the issue and reproduce it reliably"
|
|
|
|
#: ../../admin/troubleshooting.rst:135
|
|
msgid "Ensure your instance is configured as detailed in the installation documentation, and if you did not use the default values, to check what you changed"
|
|
msgstr ""
|
|
"Ensure your instance is configured as detailed in the installation "
|
|
"documentation, and if you did not use the default values, to check what you "
|
|
"changed"
|
|
|
|
#: ../../admin/troubleshooting.rst:137
|
|
msgid "To read the .env file carefully, as most of the options are described in the comments"
|
|
msgstr ""
|
|
"To read the .env file carefully, as most of the options are described in the "
|
|
"comments"
|
|
|
|
#: ../../admin/troubleshooting.rst:141
|
|
msgid "Report an issue or get help"
|
|
msgstr "Report an issue or get help"
|
|
|
|
#: ../../admin/troubleshooting.rst:143
|
|
msgid "Well be more than happy to help you to debug installation and configuration issues. The main channel for receiving support about your Funkwhale installation is the `#funkwhale-troubleshooting:matrix.org <https://matrix.to/#/#funkwhale-troubleshooting:matrix.org>`_ Matrix channel."
|
|
msgstr ""
|
|
"We'll be more than happy to help you to debug installation and configuration "
|
|
"issues. The main channel for receiving support about your Funkwhale "
|
|
"installation is the `#funkwhale-troubleshooting:matrix.org <https://matrix."
|
|
"to/#/#funkwhale-troubleshooting:matrix.org>`_ Matrix channel."
|
|
|
|
#: ../../admin/troubleshooting.rst:146
|
|
msgid "Before asking for help, we'd really appreciate if you took the time to go through this document and try to diagnose the problem yourself. But if you don't find anything relevant or don't have the time, we'll be there for you!"
|
|
msgstr ""
|
|
"Before asking for help, we'd really appreciate if you took the time to go "
|
|
"through this document and try to diagnose the problem yourself. But if you "
|
|
"don't find anything relevant or don't have the time, we'll be there for you!"
|
|
|
|
#: ../../admin/troubleshooting.rst:149
|
|
msgid "Here are a few recommendations on how to structure and what to include in your help requests:"
|
|
msgstr ""
|
|
"Here are a few recommendations on how to structure and what to include in "
|
|
"your help requests:"
|
|
|
|
#: ../../admin/troubleshooting.rst:151
|
|
msgid "Give us as much context as possible about your installation (OS, version, Docker/non-docker, reverse-proxy type, relevant logs and errors, etc.)"
|
|
msgstr ""
|
|
"Give us as much context as possible about your installation (OS, version, "
|
|
"Docker/non-docker, reverse-proxy type, relevant logs and errors, etc.)"
|
|
|
|
#: ../../admin/troubleshooting.rst:152
|
|
msgid "Including screenshots or small gifs or videos can help us considerably when debugging front-end issues"
|
|
msgstr ""
|
|
"Including screenshots or small gifs or videos can help us considerably when "
|
|
"debugging front-end issues"
|
|
|
|
#: ../../admin/troubleshooting.rst:154
|
|
msgid "You can also open issues on our `issue tracker <https://dev.funkwhale.audio/funkwhale/funkwhale/issues>`_. Please have a quick look for similar issues before doing that, and use the issue tracker only to report bugs, suggest enhancements (both in the software and the documentation) or new features."
|
|
msgstr ""
|
|
"You can also open issues on our `issue tracker <https://dev.funkwhale.audio/"
|
|
"funkwhale/funkwhale/issues>`_. Please have a quick look for similar issues "
|
|
"before doing that, and use the issue tracker only to report bugs, suggest "
|
|
"enhancements (both in the software and the documentation) or new features."
|
|
|
|
#: ../../admin/troubleshooting.rst:159
|
|
msgid "If you ever need to share screenshots or urls with someone else, ensure those do not include your personal token. This token is binded to your account and can be used to connect and use your account."
|
|
msgstr ""
|
|
"If you ever need to share screenshots or urls with someone else, ensure "
|
|
"those do not include your personal token. This token is binded to your "
|
|
"account and can be used to connect and use your account."
|
|
|
|
#: ../../admin/troubleshooting.rst:162
|
|
msgid "Urls that includes your token looks like: ``https://your.instance/api/v1/uploads/42/serve/?jwt=yoursecrettoken``"
|
|
msgstr ""
|
|
"Urls that includes your token looks like: ``https://your.instance/api/v1/"
|
|
"uploads/42/serve/?jwt=yoursecrettoken``"
|
|
|
|
#: ../../admin/troubleshooting.rst:165
|
|
msgid "Improving this documentation"
|
|
msgstr "Improving this documentation"
|
|
|
|
#: ../../admin/troubleshooting.rst:167
|
|
msgid "If you feel like something should be improved in this document (and in the documentation in general), feel free to :doc:`contribute to the documentation <../documentation/creating>`. If you're not comfortable contributing or would like to ask somebody else to do it, feel free to :doc:`request a change in documentation <../documentation/identifying>`."
|
|
msgstr ""
|
|
"If you feel like something should be improved in this document (and in the "
|
|
"documentation in general), feel free to :doc:`contribute to the "
|
|
"documentation <../documentation/creating>`. If you're not comfortable "
|
|
"contributing or would like to ask somebody else to do it, feel free to :doc:`"
|
|
"request a change in documentation <../documentation/identifying>`."
|