summaryrefslogtreecommitdiffstats
path: root/docs/setupservicevm/scenario-3-3-ipv6-configguide-os-compute.rst
diff options
context:
space:
mode:
authorBin Hu <bh526r@att.com>2016-01-06 15:54:57 -0800
committerBin Hu <bh526r@att.com>2016-01-06 15:54:57 -0800
commitc1f22085089d9be36b51ddc44179da48d52739f1 (patch)
treea2a046b9b1848cd998a7f48bc6a50c779131e269 /docs/setupservicevm/scenario-3-3-ipv6-configguide-os-compute.rst
parentc1762113c12b971753c35ce99f05d3d48dfa9eee (diff)
JIRA:IPVSIX-29
Change-Id: Ic4471d17588c43ded7a79d297580c8aae74e868d Signed-off-by: Bin Hu <bh526r@att.com>
Diffstat (limited to 'docs/setupservicevm/scenario-3-3-ipv6-configguide-os-compute.rst')
-rw-r--r--docs/setupservicevm/scenario-3-3-ipv6-configguide-os-compute.rst102
1 files changed, 102 insertions, 0 deletions
diff --git a/docs/setupservicevm/scenario-3-3-ipv6-configguide-os-compute.rst b/docs/setupservicevm/scenario-3-3-ipv6-configguide-os-compute.rst
new file mode 100644
index 0000000..a27ae4c
--- /dev/null
+++ b/docs/setupservicevm/scenario-3-3-ipv6-configguide-os-compute.rst
@@ -0,0 +1,102 @@
+=================================
+Setting Up OpenStack Compute Node
+=================================
+
+Please **note** that the instructions shown here are using ``devstack`` installer. If you are an experienced user
+and installs OpenStack in a different way, you can skip this step and follow the instructions of the method you
+are using to install OpenStack.
+
+For exemplary purpose, we assume:
+
+* The hostname of OpenStack Compute Node is ``opnfv-os-compute``, and the host IP address is ``192.168.0.20``
+* Ubuntu 14.04 or Fedora 21 is installed
+* We use ``opnfv`` as username to login.
+* We use ``devstack`` to install OpenStack Kilo. Please note that although the instructions are based on
+ OpenStack Kilo, they can be applied to Liberty in the same way.
+
+**OS-M-0**: Login to OpenStack Compute Node with username ``opnfv``
+
+**OS-M-1**: Update the packages and install git
+
+For **Ubuntu**:
+
+.. code-block:: bash
+
+ sudo apt-get update -y
+ sudo apt-get install -y git
+
+For **Fedora**:
+
+.. code-block:: bash
+
+ sudo yum update -y
+ sudo yum install -y git
+
+**OS-M-2**: Clone the following GitHub repository to get the configuration and metadata files
+
+.. code-block:: bash
+
+ git clone https://github.com/sridhargaddam/opnfv_os_ipv6_poc.git /opt/stack/opnfv_os_ipv6_poc
+
+**OS-M-3**: Download devstack and switch to stable/kilo branch
+
+.. code-block:: bash
+
+ git clone https://github.com/openstack-dev/devstack.git -b stable/kilo
+
+**OS-M-4**: Start a new terminal, and change directory to where OpenStack is installed.
+
+.. code-block:: bash
+
+ cd ~/devstack
+
+**OS-M-5**: Create a ``local.conf`` file from the GitHub repo we cloned at **OS-M-2**.
+
+.. code-block:: bash
+
+ cp /opt/stack/opnfv_os_ipv6_poc/scenario2/local.conf.odl.compute ~/devstack/local.conf
+
+Please Note:
+
+* Note 1: you need to change the IP address of ``SERVICE_HOST`` to point to your actual IP address
+ of OpenStack Controller.
+* Note 2: you need to change the IP address of ``ODL_MGR_IP`` to point to your actual IP address
+ of Open Daylight Controller.
+
+**OS-M-6**: Initiate Openstack setup by invoking ``stack.sh``
+
+.. code-block:: bash
+
+ ./stack.sh
+
+**OS-M-7**: Assuming that all goes well, you should see the following output.
+
+.. code-block:: bash
+
+ This is your host IP address: 192.168.0.20
+ This is your host IPv6 address: ::1
+
+Please **note** that The IP addresses above are exemplary purpose. It will show you the actual IP address of your host.
+
+You can set ``OFFLINE=True`` and ``RECLONE=no`` in ``local.conf`` to lock the codebase. Devstack uses these
+configuration parameters to determine if it has to run with the existing codebase or update to the latest copy.
+
+**OS-M-8**: Source the credentials.
+
+.. code-block:: bash
+
+ opnfv@opnfv-os-compute:~/devstack$ source openrc admin demo
+
+**OS-M-9**: You can verify that OpenStack is set up correctly by showing hypervisor list
+
+.. code-block:: bash
+
+ opnfv@opnfv-os-compute:~/devstack$ nova hypervisor-list
+ +----+------------------------------------+---------+------------+
+ | ID | Hypervisor hostname | State | Status |
+ +----+------------------------------------+---------+------------+
+ | 1 | opnfv-os-controller | up | enabled |
+ | 2 | opnfv-os-compute | up | enabled |
+ +----+------------------------------------+---------+------------+
+
+Now you can start to set up the service VM as an IPv6 vRouter in the environment of OpenStack and Open Daylight.