diff options
-rw-r--r-- | build/Makefile | 5 | ||||
-rwxr-xr-x | deploy/reap.py | 6 | ||||
-rw-r--r-- | docs/build-instruction.rst | 15 | ||||
-rw-r--r-- | docs/img/fuelconsole1.png | bin | 0 -> 8269 bytes | |||
-rw-r--r-- | docs/img/offloadingmodes.png | bin | 0 -> 23017 bytes | |||
-rw-r--r-- | docs/installation-instruction.rst | 57 | ||||
-rw-r--r-- | docs/release-notes.rst | 2 | ||||
-rwxr-xr-x | prototypes/sfc_tacker/poc.tacker-up.sh | 13 |
8 files changed, 71 insertions, 27 deletions
diff --git a/build/Makefile b/build/Makefile index ca704c0c0..7e4d5a09d 100644 --- a/build/Makefile +++ b/build/Makefile @@ -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 diff --git a/deploy/reap.py b/deploy/reap.py index bf64d405a..22a55e75a 100755 --- a/deploy/reap.py +++ b/deploy/reap.py @@ -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']] diff --git a/docs/build-instruction.rst b/docs/build-instruction.rst index 2d66b7c00..380d28241 100644 --- a/docs/build-instruction.rst +++ b/docs/build-instruction.rst @@ -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 Binary files differnew file mode 100644 index 000000000..61703cab1 --- /dev/null +++ b/docs/img/fuelconsole1.png diff --git a/docs/img/offloadingmodes.png b/docs/img/offloadingmodes.png Binary files differnew file mode 100644 index 000000000..5b3cb17bc --- /dev/null +++ b/docs/img/offloadingmodes.png diff --git a/docs/installation-instruction.rst b/docs/installation-instruction.rst index 787287a9b..d1036dd9e 100644 --- a/docs/installation-instruction.rst +++ b/docs/installation-instruction.rst @@ -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>`_ diff --git a/docs/release-notes.rst b/docs/release-notes.rst index 7d86edbf7..7339b596b 100644 --- a/docs/release-notes.rst +++ b/docs/release-notes.rst @@ -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>`_ diff --git a/prototypes/sfc_tacker/poc.tacker-up.sh b/prototypes/sfc_tacker/poc.tacker-up.sh index 4dbb37240..be647b409 100755 --- a/prototypes/sfc_tacker/poc.tacker-up.sh +++ b/prototypes/sfc_tacker/poc.tacker-up.sh @@ -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" |