Add Troubleshooting section to documentation (#212)

pimcore · Jun 8, 2022 · 615a95c · 615a95c
1 parent 765af38
commit 615a95c
Show file tree

Hide file tree

Showing 3 changed files with 16 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -44,3 +44,4 @@ sources and applying the data to Pimcore data objects based on a configured mapp
 - [Import Execution Details](./doc/04_Import_Execution_Details.md)
 - [Import Progress and Logging](./doc/05_Import_Progress_and_Logging.md)
 - [Extending](./doc/06_Extending/README.md)
+- [Troubleshooting/FAQ](./doc/06_Troubleshooting_FAQ.md) 
diff --git a/doc/06_Troubleshooting_FAQ.md b/doc/06_Troubleshooting_FAQ.md
@@ -0,0 +1,15 @@
+# Troubleshooting / FAQ
+
+### 1) Status in the Execution isn´t progressing
+
+Please be aware that you either need to activate the symfony messenger based or the command based processing for the queue.
+See [Import Execution Details](04_Import_Execution_Details.md) for details.
+
+![Execution Status](./img/faq_execution_status.png)
+
+### 2) "ERROR: The command is already running." while running the process queue command
+
+Sometimes it can happen that one of the worker processes terminates unexpectedly. If you try to run the process queue command again,
+you may get a "The command is already running." error message.
+If that is the case, please check the "lock_keys" table. The key column contains the (SHA256) hashed representation of the command (e.g. datahub:data-importer:process-queue-sequential).
+Delete the corresponding key and try to run the command again.
diff --git a/doc/img/faq_execution_status.png b/doc/img/faq_execution_status.png