Docs update for E release

JIRA: -

Update the structure of docs directory.
Update the docs for E release.
Add some new docs for E release.

Change-Id: Ib4b6aced3d6ac88404d8518b5461e20d26e017e1
Signed-off-by: Yifei Xue <xueyifei@huawei.com>

2 files changed, 146 insertions, 0 deletions

diff --git a/docs/release/userguide/FAQ/faq.rst b/docs/release/userguide/FAQ/faq.rst
new file mode 100644
index 00000000..177ff0bb
--- /dev/null
+++ b/docs/release/userguide/FAQ/faq.rst
@@ -0,0 +1,129 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Weidong Shao (HUAWEI) and Justin Chi (HUAWEI)
+
+
+What is Compass4nfv
+===================
+
+Compass4nfv is an installer project based on open source project Compass,
+which provides automated deployment and management of OpenStack and other distributed systems.
+It can be considered as what the LiveCD to a single box for a pool of servers – bootstrapping
+the server pool.
+
+see more information, please visit
+
+`OPNFV Compass4nfv project page <https://wiki.opnfv.org/compass4nfv>`_
+
+`COMPASS Home Page <http://www.syscompass.org/>`_
+
+What's the additional setting in switch if use the default network configuration
+================================================================================
+
+Here is the Compass4nfv default network configration file:
+compass4nfv/deploy/conf/hardware_environment/huawei-pod1/network.yml
+OR
+compass4nfv_FAQ/deploy/conf/vm_environment/huawei-virtual1/network.yml
+
+It uses a VLAN network for mgmt and storage networks that are share one NIC(eth1) as a
+default network configuration. So you need add an additional tagged VLAN (101) and VLAN (102) on
+eth1's switch for access.
+
+How to deal with installation failure caused by setting pxe and reset nodes failed
+==================================================================================
+
+At first, please make sure that deployed nodes' ipmi network can access from Jumphost and
+IPMI user/pass is correct.
+
+Compass4nfv supports IPMI 1.0 or IPMI 2.0 to control your nodes, so you can set it according your IPMI
+version in dha.yml.
+
+.. code-block:: yaml
+
+    ipmiVer: '2.0'
+
+How to deal with installation failure caused by "The Server quit without updating PID file"
+===========================================================================================
+
+If you see "The Server quit without updating PID file" in installation print log, it is caused by
+mgmt network can't access from each deployed nodes, so you need to check your switch setting whether
+an additional tagged VLAN is added if uses default network configuration.
+
+How to set OpenStack Dashboard login user and password
+======================================================
+
+It uses admin/console as the default user/pass for OpenStack Dashboard, and you can set it in below file:
+compass4nfv/deploy/conf/base.conf
+
+How to visit OpenStack Dashboard
+================================
+
+You can visit OpenStack Dashboard by URL: http://{puclib_vip}/horizon
+
+The public virtual IP is configured in "compass4nfv/deploy/conf/hardware_environment/huawei-pod1/network.yml"
+or "compass4nfv_FAQ/deploy/conf/vm_environment/huawei-virtual1/network.yml", defined as below:
+
+.. code-block:: yaml
+
+    public_vip:
+      ip: 192.168.50.240
+
+How to access controller nodes after deployment
+===============================================
+
+1. First you should login Compass VM via ssh command on Jumphost by default user/pass root/root.
+The default login IP of Compass VM is configured in "compass4nfv/deploy/conf/base.conf", defined as below:
+
+.. code-block:: bash
+
+    export MGMT_IP=${MGMT_IP:-192.168.200.2}
+
+2. Then you can login the controller nodes (host1-3) by default user/pass root/root via the install
+network IPs which are configured in "compass4nfv/deploy/conf/base.conf", defined as below:
+
+.. code-block:: bash
+
+    export MANAGEMENT_IP_START=${MANAGEMENT_IP_START:-'10.1.0.50'}
+
+
+.. code-block:: console
+
+
+                                              +-------------+
+                                              |             |
+                                   +----------+    host1    |
+                                   |          |             |
+                                   |          +-------------+
+                                   |
+         +---------+               |          +-------------+
+         |         |      install  |          |             |
+         | Compass +---------------+----------+    host2    |
+         |         |      network  |          |             |
+         +---+VM+--+               |          +-------------+
+    +--------------------+         |
+    |                    |         |          +-------------+
+    |      Jumphost      |         |          |             |
+    |                    |         +----------+    host3    |
+    +--------------------+                    |             |
+                                              +-------------+
+
+
+Where is OpenStack RC file
+==========================
+
+It is located /opt/admin-openrc.sh in each controller node as default. Please source it first if you
+want to use OpenStack CLI.
+
+How to recovery network connection after Jumphost reboot
+========================================================
+
+.. code-block:: bash
+
+    source deploy/network.sh && save_network_info
+
+References
+==========
+For more information on the Compass4nfv FAQ, please visit
+
+`COMPASS FAQ WIKI Page <https://wiki.opnfv.org/compass4nfv_faq>`_
+
diff --git a/docs/release/userguide/FAQ/index.rst b/docs/release/userguide/FAQ/index.rst
new file mode 100644
index 00000000..a843a213
--- /dev/null
+++ b/docs/release/userguide/FAQ/index.rst
@@ -0,0 +1,17 @@
+.. _compass4nfv-FAQ:
+
+.. This work is licensed under a Creative Commons Attribution 4.0 International Licence.
+.. http://creativecommons.org/licenses/by/4.0
+
+======================================
+Compass4nfv Frequently Asked Questions
+======================================
+
+.. toctree::
+   :numbered:
+   :maxdepth: 4
+
+   how-to-build-customized-iso.rst
+   how-to-deploy-while-jumphost-cannot-access-internet.rst
+   how-to-deploy-without-internet-access.rst
+   faq.rst