3. Preparation

Before starting the installation of the <scenario> scenario some preparation must be done. You may choose to install the <scenario> scenario using an ISO image, or executing the installation from a prepared jumphost.

3.1. Preparing your jumphost to install by script

To deploy the <scenario> scenario from a script you will need to prepare the jumphost with a compatible operating system. Prepare your jumphost running CentOS 7 with libvirt running on it. You may then install the RDO Release RPM:

sudo yum install -y https://www.rdoproject.org/repos/rdo-release.rpm opnfv-apex-{version}.rpm

The RDO Project release repository is needed to install OpenVSwitch, which is a dependency of opnfv-apex. If you do not have external connectivity to use this repository you need to download the OpenVSwitch RPM from the RDO Project repositories and install it with the opnfv-apex RPM.

3.2. Preparing your jumphost using an ISO image

An alternative to preparing your own jumphost id to use a <scenario> ISO image as a boot image. Download or build the ISO image according to the following instructions.

3.2.1. Retrieving the ISO image

If you choose to install the <scenario> scenario from an ISO image you must first retrieve the <template-containing>.iso image of the Colorado release. This can be found can be found at <hyperlink required>.

3.2.2. Building the ISO image

Alternatively, you may choose to build the Fuel .iso from source by cloning the opnfv/fuel git repository. To retrieve the repository for the Colorado release use the following command:

$ git clone https://gerrit.opnfv.org/gerrit/fuel

Check-out the Colorado release tag to set the HEAD to the baseline required to replicate the Colorado release:

$ git checkout colorado.1.0

Go to the fuel directory and build the .iso:

$ cd fuel/build; make all

For more information on how to build, please see Reference: 14

3.2.3. Booting from the ISO image

Mount the <scenario> ISO file/media as a boot device on the jump host server. If all your hardware preparation is complete at this time you should reboot the jumphost to establish the deployment server.

3.3. Additional preparations

Additionally, familiarize yourself with Fuel by reading the following documents:

  • Fuel planning guide, please see Reference: 8
  • Fuel user guide, please see Reference: 9
  • Fuel operations guide, please see Reference: 10
  • Fuel Plugin Developers Guide, please see Reference: 11

Prior to installation, a number of deployment specific parameters must be collected, those are:

  1. Provider sub-net and gateway information
  2. Provider VLAN information
  3. Provider DNS addresses
  4. Provider NTP addresses
  5. Network overlay you plan to deploy (VLAN, VXLAN, FLAT)
  6. How many nodes and what roles you want to deploy (Controllers, Storage, Computes)
  7. Monitoring options you want to deploy (Ceilometer, Syslog, etc.).
  8. Other options not covered in the document are available in the links above

This information will be needed for the configuration procedures provided in this document.