Wiki

Basic install guidelines: http://artifacts.opnfv.org/apex/docs/installation-instructions/baremetal.html

• Make sure you have good internet connectivity, as it's required for package install/updates etc.

• Install Centos 7 on the jumphost.
  • This procedure assumes you are installing the Centos 7 Minimal Server ISO
  • Pick a root password, and create a non-root user "opnfv"
  • Select hostname "jumphost"
  • If the jumphost is attached to a gateway with DHCP disabled (as described on the Academy main page, you will need to assign the static IP to the primary ethernet interface during Ubuntu install (since network autoconfig will fail). Use these values:
    • IP address: 192.168.10.2
    • Netmask: 255.255.255.0
    • Gateway 192.168.10.1
    • DNS: 8.8.8.8 8.8.4.4
• Give sudo access to the opnfv account

su
visudo
(add line)
opnfv   ALL=(ALL)       ALL

• Update the system and reboot.

sudo yum -y update

• If desired, install the GNOME desktop (recommended since you will likely be using the jumphost for other things…)

sudo yum -y groupinstall "GNOME Desktop"
sudo systemctl set-default graphical.target
sudo systemctl start graphical.target

• Install prerequisites

sudo yum -y groupinstall "Virtualization Host"
sudo service libvirtd start
sudo chkconfig libvirtd on

• install git and create git folder where you will clone repos as needed

sudo yum -y install git
mkdir ~/git
git clone https://gerrit.opnfv.org/gerrit/apex

• Download and save the latest RPMs on the OPNFV artifacts page
  • opnfv-apex-x.y-yyyymmdd.noarch.rpm
  • opnfv-apex-common-x.y-yyyymmdd.noarch.rpm
  • opnfv-apex-undercloud-x.y-yyyymmdd.noarch.rpm

• Install the RDO RPM then the Apex RPMs

sudo yum install -y https://www.rdoproject.org/repos/rdo-release.rpm
cd ~/Downloads
# ! the next command assumes only the Apex RPMs are in your download location... order does not matter
sudo yum install -y *.rpm

This section explains further the instructions at Creating a Node Inventory File.

• Based upon the examples in Apex repo folder ~/git/apex/config/inventory, create the inventory file ~/inventory.yaml

vi ~/inventory.yaml
nodes:
  node1:
    mac_address: "<controler mac>"
    cpus: 2
    memory: 16384
    disk: 1024
    arch: "x86_64"
    capabilities: "profile:control"
  node2:
    mac_address: "<compute mac>"
    cpus: 2
    memory: 16384
    disk: 1024
    arch: "x86_64"
    capabilities: "profile:compute"

This section explains further the instructions at Creating the Settings Files.

• Based upon the examples in Apex repo folder ~/git/apex/config/deploy, create the deploy settings file ~/deploy_settings.yaml
  • Note: the below assumes the IPMI settings should be deleted, but it's not clear yet how to enable wake-on-lan instead

vi ~/deploy_settings.yaml
global_params:
  ha_enabled: false

deploy_options:
  sdn_controller: opendaylight
  sdn_l3: false
  tacker: false
  congress: false
  sfc: false
 

• Enable wake-on-lan

cp /usr/bin/opnfv-deploy ~/opnfv-deploy
vi ~/opnfv-deploy
(change line as below and save)
          \"pm_type\": \"pxe_wol\",
sudo cp ~/opnfv-deploy /usr/bin/opnfv-deploy