Fuel Build and Install instructions
How to setup and use the OPNFV/BGS/FUEL build system. This is a work in progress, find the latest revision in genesis DOC/README.build and README.install
1. Build system requirements
1.1 Host HW/VM requirements
- A x86_64 host (real iron or VM) with Ubuntu 12.04/14.04 LTS installed
- 100 GB storage
- 8 GB RAM
1.2 Host SW dependencies
On the host, the following packages must be installed:
- docker - see https://docs.docker.com/installation/ubuntulinux/ for installation notes for 12.04 and 14.04
- git (simply available through apt-get install git)
2 Setting up the Docker build container
When having installed Docker, add yourself to the docker group:
Also make sure to define relevant dns servers part of the global dns chain in
in your /etc/default/docker(.io) config file, eg.
Then restart docker with "service docker(.io) restart".:
Note: Ubuntu Trusty comes with a docker.io package
3. Setting up OPNFV Gerrit in order to being able to clone the code
Start by creating a SSH key, if you don't already have one, create one with
Add your generated public key in OPNFV Gerrit -https:_gerrit.opnfv.org/
Select "SSH Public Keys" to the left and then "Add Key" and paste your public key in.
4. Clone the OPNFV code git repository
So now we're coming to the fun part! Let's clone the code repository:
Change the directory to "build"
5. Set up (build) your build environment
_YOU DO NOT NEED TO SET UP YOUR BUILD ENVIRONMENT, THE TOP MAKE ALL TARGET WILL DO THAT FOR YOU IF NOT ALREADY DONE,
THE BELOW ACTIONS IN THIS SECTION ARE NOT NEEDED!
Note and TODO:
The build system will for now partly run as sudo as that is needed for the debootstrap procedure to create the root file
system for the Ubuntu 12.04 Docker image - BUT NOTE, NONE OF THE MAKEFILES OR SCRIPTS SHALL BE EXECUTED WITH SUDO/ROOT PRIVILEDGES!
(TODO: Change the scripts so that no root priviledges will be needed)
With your ordinary user-, run the following commands from your git root:
make (and you will be prompted for your password by sudo)
6. Build your fuel .iso image
That's it, time to build!
- If not allready existing, initialize the docker build environment
- If not already done, build fuel from upstream
- Build the defined derivate of fuel (as defined by the structure of this framework)
If the build is successful, you will find the generated ISO file in the release subdirectory!
If error "debconf: unable to initialize frontend: Dialog" is generated, add following envvar in docker/ubuntu-builder/Dockerfile:
Now the tricky part - to deploy. This is under development and will be scripted in more detail.
7. Install Fuel Server
1. Mount the built .iso file (release/opnfv-<version>.iso) as a bootdevice to the fuel server.
2. Reboot the fuel server.
3. Change the grub boot params
4 Wait until screen Fuel setup . is shown.
5. Select PXE Setup and change the following fields to appropriate values (example below):
6. Select DNS & Hostname and change the following fields to appropriate values:
7. Select Time Sync and change the following fields to appropriate values:
8. Start the installation.
10. Enable PXE Booting and put it first in the bios boot order menu.
11. Reboot the controller- and compute blades.
12. Connect to Fuel wit a browser towards port 8000
13. Create and name a new OpenStack environment, to be installed.
14. Select Icehouse on Ubuntu . in field OpenStack Release.
15. Select deployment mode.
16. Select compute node mode.
17. Select network mode.
18. Select Storage Backends.
19. Select additional services.
20. Create the new environment.
21. Wait for availability nodes.
22. Open the created environment.
23. Open the networks tab.
24. Update the public configuration.
25. Update the management configuration.
26. Update the storage configuration.
27. Update the Neutron L2 configuration.
28. Update the Neutron L3 configuration.
29. Save Settings.
30. Click "verify network" to check the network set-up
31. Update storage configuration.
32. Open the nodes tab.
33. Assign roles.
34. Configure interfaces.
35. Run the pre-deploy script.
36. Run the pre-deployment script (/opt/opnfv/pre-deploy.sh <id>)
37. Deploy the environment.
38 Verify the OpenStack Environment