From 8e5a870c4accd972f6b9808c804bf334f35426aa Mon Sep 17 00:00:00 2001 From: Justin-chi Date: Wed, 2 Mar 2016 17:49:33 +0800 Subject: Add FAQ file for Compass4nfv Add Faq for B-release Change-Id: I6ae7335219b21c0f57090f26a4f6f6aa96121d6a Signed-off-by: Justin-chi (cherry picked from commit 9b3a59957b52a74d5d4bb70b8ef4205764077d24) --- docs/FAQ/faq.rst | 119 +++++++++++++++++++++++++++++++++++++++++++++++++++++ docs/FAQ/index.rst | 2 + 2 files changed, 121 insertions(+) create mode 100644 docs/FAQ/faq.rst diff --git a/docs/FAQ/faq.rst b/docs/FAQ/faq.rst new file mode 100644 index 00000000..5d5629df --- /dev/null +++ b/docs/FAQ/faq.rst @@ -0,0 +1,119 @@ +.. 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 `_ + +`COMPASS Home Page `_ + +What's the additional setting in switch if use the default network configuration +================================================================================ + +Here is the Compass4nfv default network configration file: +compass4nfv/deploy/conf/network_cfg.yaml + +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/network_cfg.yaml", defined as below: + +.. code-block:: yaml + + public_vip: + ip: 192.168.50.240 + +How to access BM 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 BM 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 BM node as default. Please source it first if you want to use +OpenStack CLI. + +References +========== +For more information on the Compass4nfv FAQ, please visit + +`COMPASS FAQ WIKI Page `_ + diff --git a/docs/FAQ/index.rst b/docs/FAQ/index.rst index f12a327f..d152895a 100644 --- a/docs/FAQ/index.rst +++ b/docs/FAQ/index.rst @@ -10,3 +10,5 @@ Contents: .. toctree:: :numbered: :maxdepth: 4 + + faq.rst -- cgit 1.2.3-korg