From cc2499aa44849393c45da48ec71f810d858c95e7 Mon Sep 17 00:00:00 2001
From: Rebekk <50409660+Rebekk@users.noreply.github.com>
Date: Fri, 13 May 2022 15:11:31 +0800
Subject: [PATCH] Chronos: add chronos known issue (#4496)

* add chronos known issue

* modify doc

* modify chronos_known_issue

* modify chronos issue

* modify

* modify issue

* modify chronos_known_issus
---
 .../Chronos/Overview/chronos_known_issue.md   | 62 +++++++++++++++++++
 docs/readthedocs/source/index.rst             |  1 +
 2 files changed, 63 insertions(+)
 create mode 100644 docs/readthedocs/source/doc/Chronos/Overview/chronos_known_issue.md

diff --git a/docs/readthedocs/source/doc/Chronos/Overview/chronos_known_issue.md b/docs/readthedocs/source/doc/Chronos/Overview/chronos_known_issue.md
new file mode 100644
index 00000000..f00a4cc4
--- /dev/null
+++ b/docs/readthedocs/source/doc/Chronos/Overview/chronos_known_issue.md
@@ -0,0 +1,62 @@
+# Chronos Known Issue
+## **1. Issue 1**
+**Problem description**
+
+Numpy.ndarray size changed, may indicate binary incompatibility. Expected 88 from C header, got 80 from PyObject. 
+
+**Solution**
+* `pip install -y pycocotools`
+* `pip install pycocotools --no-cache-dir --no-binary :all:`
+* `conda install –c conda-forge pycocotools`
+
+---------------------------
+
+## **2. Issue 2**
+**Problem description**
+
+NotImplementedError: Cannot convert a symbolic Tensor (encoder_lstm_8/strided_slice:0) to a numpy array. 
+
+**Solution**
+
+* `pip install numpy==1.19.5`
+
+---------------------------
+
+## **3. Issue 3**
+
+**Problem description**
+
+StanModel object has no attribute 'fit_class', cause of pip, may be. 
+
+**Solution**
+
+* `pip uninstall pystan prophet –y`
+* `conda install –c conda-forge prophet=1.0.1`
+
+---------------------------
+
+## **4. Issue 4**
+**Problem description**
+
+Exception: No active RayContext. Please call init_orca_context to create a RayContext.
+> ray_ctx = RayContext.get()<br>
+> ray_ctx = RayContext.get(initialize=False)
+
+**Solution**
+
+* Make sure all operations are before `stop_orca_context`. 
+* No other `RayContext` exists before `init_orca_context`. 
+
+---------------------------
+
+## **5. Issue 5**
+**Problem description**
+
+ Sed: error while loading shared libraries: libunwind.so.8: cannot open shared object file: No such file or directory.
+> Only happens when you run `source bigdl-nano-init`. 
+
+**Solution**
+
+* `apt-get install libunwind8-dev` 
+
+---------------------------
diff --git a/docs/readthedocs/source/index.rst b/docs/readthedocs/source/index.rst
index d80c109b..5402b31a 100644
--- a/docs/readthedocs/source/index.rst
+++ b/docs/readthedocs/source/index.rst
@@ -67,6 +67,7 @@ BigDL Documentation
    doc/Chronos/Overview/chronos.md
    doc/Chronos/Overview/deep_dive.rst
    doc/Chronos/QuickStart/index.md
+   doc/Chronos/Overview/chronos_known_issue.md
 
 .. toctree::
    :maxdepth: 1