Documentation: add troubleshooting section for hard shutdown

lebdron · lebdron · commit c5d8f4f1d237 · 2020-11-27T11:57:20.000+01:00
Signed-off-by: Andrei Lebedev &lt;lebdron@gmail.com&gt;
diff --git a/docs/source/maintenance/index.rst b/docs/source/maintenance/index.rst
@@ -11,3 +11,4 @@ Hardware requirements, deployment process in details, aspects related to securit
     restarting_node.rst
     sec-install.rst
     shepherd.rst
+    troubleshooting.rst
diff --git a/docs/source/maintenance/troubleshooting.rst b/docs/source/maintenance/troubleshooting.rst
@@ -0,0 +1,18 @@
+===============
+Troubleshooting
+===============
+
+Restore after hard shutdown
+---------------------------
+
+::
+
+	[2020-11-27 10:40:01.764013860][th:1][warning] Irohad/Storage/FlatFileBlockStorage Error while block deserialization: Unexpected end of string. Expected a value.
+
+	^
+
+::
+
+	[2020-11-25 10:36:19.993552669][C][Init]: Irohad startup failed: WSV state (height 4576773) is more recent than block storage (height 4576772).
+
+Such messages may appear if the node crashed while using file-based block store. Please copy the missing blocks from another node, in which case you can use ``--reuse_state`` flag for fast startup, or remove the blocks starting from the empty file and recreate WSV from existing blocks.
