Merge "Remove residual Lab & configuration DEA and DHA from the unprotected Fuel...
authorJonas Bjurel <jonas.bjurel@ericsson.com>
Mon, 30 May 2016 19:26:12 +0000 (19:26 +0000)
committerGerrit Code Review <gerrit@172.30.200.206>
Mon, 30 May 2016 19:26:12 +0000 (19:26 +0000)
build/Makefile
deploy/reap.py
docs/build-instruction.rst
docs/img/fuelconsole1.png [new file with mode: 0644]
docs/img/offloadingmodes.png [new file with mode: 0644]
docs/installation-instruction.rst
docs/release-notes.rst
prototypes/sfc_tacker/poc.tacker-up.sh

index ca704c0..7e4d5a0 100644 (file)
@@ -82,9 +82,8 @@ all:
        @make -C docker
        @lsb_release -a | grep Ubuntu > /dev/null 2>&1 || (echo 'Ubuntu is the only supported Linux distribution for this build system'; exit 1)
        @KERNEL_VER=$$(uname -r); \
-       KERNEL_VER="$${KERNEL_VER%.*-*}"; \
-       KERNEL_VER="$${KERNEL_VER//.}"; \
-        [ $$KERNEL_VER -ge 319 ] || (echo 'Kernel version must be 3.19 or newer'; exit 1)
+       KERNEL_ARRAY=($${KERNEL_VER//./ }); \
+       if [ $${KERNEL_ARRAY[0]} -lt 3  ] || [[ $${KERNEL_ARRAY[0]} -eq 3 && $${KERNEL_ARRAY[1]} -lt 19  ]] ; then (echo 'Kernel version must be 3.19 or newer'; exit 1) ; fi
        @docker/runcontext $(DOCKERIMG) wget -q www.google.com > /dev/null 2>&1 || (echo 'No docker network connectivity or name server - check your network- and docker settings'; exit 1)
        @docker/runcontext $(DOCKERIMG) $(MAKE) $(MAKEFLAGS) iso
 
index bf64d40..22a55e7 100755 (executable)
@@ -92,8 +92,10 @@ class Reap(object):
 
     def get_env(self):
         env_list = parse(exec_cmd('fuel env'))
-        if len(env_list) > 1:
-            err('Not exactly one environment')
+        if len(env_list) == 0:
+            err('No environment deployed')
+        elif len(env_list) > 1:
+            err('More than 1 environment deployed')
         self.env = env_list[0]
         self.env_id = self.env[E['id']]
 
index 2d66b7c..380d282 100644 (file)
@@ -102,20 +102,27 @@ Clone the OPNFV code Git repository with your SSH key
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Now it is time to clone the code repository:
 
-$ git clone ssh://<Linux foundation user>@gerrit.opnfv.org:29418/fuel
+.. code-block:: bash
+
+    $ git clone ssh://<Linux foundation user>@gerrit.opnfv.org:29418/fuel
 
 Now you should have the OPNFV fuel repository with the Fuel
 directories stored locally on your build host.
 
 Check out the Brahmaputra release:
-$ cd fuel
-$ git checkout brahmaputra.1.0
+
+.. code-block:: bash
+
+    $ cd fuel
+    $ git checkout brahmaputra.1.0
 
 Clone the OPNFV code Git repository without a SSH key
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 You can also opt to clone the code repository without a SSH key:
 
-$ git clone https://gerrit.opnfv.org:29418/gerrit/fuel
+.. code-block:: bash
+
+    $ git clone https://gerrit.opnfv.org/gerrit/fuel
 
 Make sure to checkout the release tag as described above.
 
diff --git a/docs/img/fuelconsole1.png b/docs/img/fuelconsole1.png
new file mode 100644 (file)
index 0000000..61703ca
Binary files /dev/null and b/docs/img/fuelconsole1.png differ
diff --git a/docs/img/offloadingmodes.png b/docs/img/offloadingmodes.png
new file mode 100644 (file)
index 0000000..5b3cb17
Binary files /dev/null and b/docs/img/offloadingmodes.png differ
index 787287a..d1036dd 100644 (file)
@@ -51,9 +51,9 @@ Building the ISO image
 Alternatively, you may build the Fuel .iso from source by cloning the
 opnfv/fuel git repository.  To retrieve the repository for the Brahmaputra release use the following command:
 
-$git clone https://<linux foundation uid>@gerrit.opnf.org/gerrit/fuel
+$ git clone https://gerrit.opnfv.org/gerrit/fuel
 
-Check-out the Brahmaputra release tag to set the branch to the
+Check-out the Brahmaputra release tag to set the HEAD to the
 baseline required to replicate the Brahmaputra release:
 
 $ git checkout brahmaputra.1.0
@@ -335,7 +335,7 @@ Create an OpenStack Environment
 
 #. Select "additional services" you wish to install.
 
-   - Check option "Install Celiometer (OpenStack Telemetry)" and press <Next>
+   - Check option "Install Ceilometer (OpenStack Telemetry)" and press <Next>
 
 #. Create the new environment.
 
@@ -534,6 +534,55 @@ that can be used for installation / deployment of openstack.
 
    - Click <Save Settings> at the bottom to Save your changes
 
+Target specific configuration
+-----------------------------
+
+#. Set up targets for provisioning with non-default "Offloading Modes"
+
+   Some target nodes may require additional configuration after they are
+   PXE booted (bootstrapped); the most frequent changes are in defaults
+   for ethernet devices' "Offloading Modes" settings (e.g. some targets'
+   ethernet drivers may strip VLAN traffic by default).
+
+   If your target ethernet drivers have wrong "Offloading Modes" defaults,
+   in "Configure interfaces" page (described above), expand affected
+   interface's "Offloading Modes" and [un]check the relevant settings
+   (see figure below):
+
+   .. figure:: img/offloadingmodes.png
+
+#. Set up targets for "Verify Networks" with non-default "Offloading Modes"
+
+   **NOTE**: Check *Reference 15* for an updated and comprehensive list of
+   known issues and/or limitations, including "Offloading Modes" not being
+   applied during "Verify Networks" step.
+
+   Setting custom "Offloading Modes" in Fuel GUI will only apply those settings
+   during provisiong and **not** during "Verify Networks", so if your targets
+   need this change, you have to apply "Offloading Modes" settings by hand
+   to bootstrapped nodes.
+
+   **E.g.**: Our driver has "rx-vlan-filter" default "on" (expected "off") on
+   the Openstack interface(s) "eth1", preventing VLAN traffic from passing
+   during "Verify Networks".
+
+   - From Fuel master console identify target nodes admin IPs (see figure below):
+
+     .. code-block:: bash
+
+         $ fuel nodes
+
+     .. figure:: img/fuelconsole1.png
+
+   - SSH into each of the target nodes and disable "rx-vlan-filter" on the
+     affected physical interface(s) allocated for OpenStack traffic (eth1):
+
+     .. code-block:: bash
+
+         $ ssh root@10.20.0.6 ethtool -K eth1 rx-vlan-filter off
+
+   - Repeat the step above for all affected nodes/interfaces in the POD.
+
 Verify Networks
 ---------------
 
@@ -583,7 +632,7 @@ References
 OPNFV
 -----
 
-1) `OPNFV Home Page <www.opnfv.org>`_
+1) `OPNFV Home Page <http://www.opnfv.org>`_
 
 2) `OPNFV documentation- and software downloads <https://www.opnfv.org/software/download>`_
 
index 7d86edb..7339b59 100644 (file)
@@ -203,7 +203,7 @@ For more information on the OPNFV Brahmaputra release, please see:
 OPNFV
 -----
 
-1) `OPNFV Home Page <www.opnfv.org>`_
+1) `OPNFV Home Page <http://www.opnfv.org>`_
 
 2) `OPNFV documentation- and software downloads <https://www.opnfv.org/software/download>`_
 
index 4dbb372..be647b4 100755 (executable)
@@ -350,18 +350,6 @@ function populate_rc() {
     done
 }
 
-
-#Configure ODL so that it allows the coexistence between Netvirt and SFC
-function coexistence() {
-    curl -i -u admin:admin -H 'Content-type: application/json' -X PUT \
-    -d '{"netvirt-providers-config":{"table-offset":"1"}}' \
-    http://${mgmt_addr}:${odl_port}/restconf/config/netvirt-providers-config:netvirt-providers-config
-
-    curl -i -u admin:admin -H 'Content-type: application/json' -X PUT \
-    -d '{"sfc-of-renderer-config":{"sfc-of-table-offset":"150","sfc-of-app-egress-table-offset":"11"}}' \
-    http://${mgmt_addr}:${odl_port}/restconf/config/sfc-of-renderer:sfc-of-renderer-config
-}
-
 envSetup
 deployTackerClient
 deployJsonrpclib
@@ -371,7 +359,6 @@ deployTackerServer
 populate_client
 orchestarte
 populate_rc
-coexistence
 
 remove_repo "$MYREPO"
 remove_repo "$DEPREPO"