From ca496881cb1cc26764af8cd3a3083ee233786c6c Mon Sep 17 00:00:00 2001 From: Florin Dumitrascu Date: Wed, 11 May 2016 19:25:15 +0300 Subject: docs/installation-instruction.rst for AArch64 Signed-off-by: Florin Dumitrascu (cherry picked from commit 77e03df9034abd030b97270ea4dbdea1784bc9e2) Change-Id: Id6dfd7881a2aa4ac1abdef3fb1f61bf411b22c44 --- docs/img/fuelconsole1.png | Bin 0 -> 8269 bytes docs/img/fuelmenu2a.png | Bin 0 -> 11511 bytes docs/img/softiron1.png | Bin 0 -> 8447 bytes docs/installation-instruction.rst | 69 +++++++++++++++++++++++++------------- 4 files changed, 46 insertions(+), 23 deletions(-) create mode 100644 docs/img/fuelconsole1.png create mode 100644 docs/img/fuelmenu2a.png create mode 100644 docs/img/softiron1.png diff --git a/docs/img/fuelconsole1.png b/docs/img/fuelconsole1.png new file mode 100644 index 00000000..61703cab Binary files /dev/null and b/docs/img/fuelconsole1.png differ diff --git a/docs/img/fuelmenu2a.png b/docs/img/fuelmenu2a.png new file mode 100644 index 00000000..396c1237 Binary files /dev/null and b/docs/img/fuelmenu2a.png differ diff --git a/docs/img/softiron1.png b/docs/img/softiron1.png new file mode 100644 index 00000000..c420c412 Binary files /dev/null and b/docs/img/softiron1.png differ diff --git a/docs/installation-instruction.rst b/docs/installation-instruction.rst index 787287a9..aa4cbdb7 100644 --- a/docs/installation-instruction.rst +++ b/docs/installation-instruction.rst @@ -1,6 +1,6 @@ -======================================================================================================== -OPNFV Installation instruction for the Brahmaputra release of OPNFV when using Fuel as a deployment tool -======================================================================================================== +==================================================================================================================== +OPNFV Installation instruction for the AArch64 Brahmaputra 3.0 release of OPNFV when using Fuel as a deployment tool +==================================================================================================================== License ======= @@ -12,16 +12,16 @@ License. .. http://creativecommons.org/licenses/by/4.0 .. Abstract ======== -This document describes how to install the Brahmaputra release of -OPNFV when using Fuel as a deployment tool, covering it's usage, -limitations, dependencies and required system resources. +This document describes how to install the Brahmaputra 3.0 release of +OPNFV when using Fuel as a deployment tool, with an AArch64 (only) target node pool. Introduction ============ This document provides guidelines on how to install and -configure the Brahmaputra release of OPNFV when using Fuel as a -deployment tool, including required software and hardware configurations. +configure the Brahmaputra 3.0 release of OPNFV when using Fuel as a +deployment tool, with an AArch64 (only) target node pool, +including required software and hardware configurations. Although the available installation options give a high degree of freedom in how the system is set-up, including architecture, services @@ -35,7 +35,7 @@ networking and Unix/Linux administration. Preface ======= -Before starting the installation of the Brahmaputra release of +Before starting the installation of the AArch64 Brahmaputra 3.0 release of OPNFV, using Fuel as a deployment tool, some planning must be done. @@ -43,30 +43,31 @@ Retrieving the ISO image ------------------------ First of all, the Fuel deployment ISO image needs to be retrieved, the -Fuel .iso image of the Brahmaputra release can be found at *Reference: 2* +Fuel .iso image of the AArch64 Brahmaputra release can be found at *Reference: 2* 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: +Alternatively, you may build the .iso from source by cloning the +opnfv/armband git repository. To retrieve the repository for the AArch64 Brahmaputra 3.0 release use the following command: -$git clone https://@gerrit.opnf.org/gerrit/fuel +$git clone https://@gerrit.opnf.org/gerrit/armband -Check-out the Brahmaputra release tag to set the branch to the +Check-out the Brahmaputra stable branch to set the branch to the baseline required to replicate the Brahmaputra release: -$ git checkout brahmaputra.1.0 +$ git checkout stable/brahmaputra -Go to the fuel directory and build the .iso: +Go to the armband directory and build the .iso: -$ cd fuel/build; make all +$ cd armband; make release For more information on how to build, please see *Reference: 14* Other preparations ------------------ + Next, familiarize yourself with Fuel by reading the following documents: - Fuel planning guide, please see *Reference: 8* @@ -213,12 +214,15 @@ Install Fuel master .. figure:: img/fuelmenu1.png -#. In the "Network Setup" section - Configure DHCP/Static IP information for your FUEL node - For example, ETH0 is 10.20.0.2/24 for FUEL booting and ETH1 is DHCP in your corporate/lab network (see figure below). +#. In the "Network Setup" section - Configure DHCP/Static IP information for your FUEL node - For example, ETH0 is 10.20.0.2/24 for FUEL booting and ETH1 is DHCP/Static in your corporate/lab network (see figure below). - - Configure eth1 or other network interfaces here as well (if you have them present on your FUEL server). + - Configuration of ETH1 interface for connectivity into your corporate/lab network is mandatory. You need to have internet access over this interface. + Due to the architecture of ports.ubuntu.com mirror, currently Fuel cannot create a full local mirror of all required AArch64 packages. Internet access is needed to deploy with Fuel on AArch64 nodes. .. figure:: img/fuelmenu2.png + .. figure:: img/fuelmenu2a.png + #. In the "PXE Setup" section (see figure below) - Change the following fields to appropriate values (example below): - DHCP Pool Start 10.20.0.3 @@ -294,6 +298,25 @@ scheme so that the FUEL Master can pick them up for control. .. figure:: img/nodes.png +Target specific configuration +----------------------------- + +#. AMD Softiron + + For these targets, "rx-vlan-filter" offloading has to be turned off on the interface destined for OpenStack traffic (not the interface used for PXE boot). + For now this setting cannot be toggled from Fuel GUI, so it has to be done form the console. + + - From Fuel master console identify target nodes admin IPs (see figure below). + + .. figure:: img/fuelconsole1.png + + - SSH into each of the target nodes and disable rx-vlan-filter on the physical interface allocated for OpenStack traffic (see figure below). + + .. figure:: img/softiron1.png + + - Repeat the step above for all AMD Softiron nodes in the POD. + + Install additional Plugins/Features on the FUEL node ---------------------------------------------------- @@ -315,7 +338,7 @@ Create an OpenStack Environment .. figure:: img/newenv.png -#. Select "" and press +#. Select "" and press #. Select "compute virtulization method". @@ -618,8 +641,8 @@ Fuel Fuel in OPNFV ------------- -13) `OPNFV Installation instruction for the Brahmaputra release of OPNFV when using Fuel as a deployment tool `_ +13) `OPNFV Installation instruction for the AArch64 Brahmaputra release of OPNFV when using Fuel as a deployment tool `_ -14) `OPNFV Build instruction for the Brahmaputra release of OPNFV when using Fuel as a deployment tool `_ +14) `OPNFV Build instruction for the AArch64 Brahmaputra release of OPNFV when using Fuel as a deployment tool `_ -15) `OPNFV Release Note for the Brahmaputra release of OPNFV when using Fuel as a deployment tool `_ +15) `OPNFV Release Note for the AArch64 Brahmaputra release of OPNFV when using Fuel as a deployment tool `_ -- cgit 1.2.3-korg