Wiki

This will setup a basic functional assessment platform ala Sandbox prior to getting a BGS environment that we can use. As compared to Sandbox, the goal of this activity is rather to install the actual OPNFV components as listed for BGS, under a single node (e.g. a laptop with lots of memory) or multi-node environment.

Here is a graphic of the concept. This is very draft and leaves many things unclear partly because I'm not sure how to do them yet.

Following are notes on setting it up. This will be updated as bugs in the process are found.

Restart process for For sandbox based upon host OS: Unbuntu 14.04 Server LTS

• devstack/rejoin-stack.sh
• from Horizon, launch mininet-vm created earlier
• ssh to mininet VM and enter
  • sudo mn –controller=remote,ip=192.168.1.132
• back in ubuntu terminal
• cd distribution-karaf-0.2.1-Helium-SR1.1
• ./bin/karaf clean
• (currently here in the debug process) install enough ODL features to get ODL UX working (ports 8080 and 8181)
• feature:install odl-restconf odl-l2switch-switch odl-mdsal-apidocs odl-dlux-core

Restart process for sandbox based upon host OS: Unbuntu 14.04 Server LTS

1. Ensure you have enable virtualization support in your BIOS
2. Install Ubuntu. I selected options for SSH, LAMP, VM host.
   • Make sure you remember the mysql root password - you will need it below
3. install updates
   • sudo apt-get update
   • sudo apt-get upgrade
4. install ubuntu desktop: sudo apt-get install ubuntu-desktop
   • Qemu requires a window system… something lighter than desktop env wil
5. install Java 7
   • Note that apparently Java 8 is not compatible with Karaf
   • I used the notes from ubuntuhandbook
   • sudo add-apt-repository ppa:webupd8team/java
   • sudo apt-get update
   • sudo apt-get install oracle-java7-installer
   • sudo apt-get install oracle-java7-set-default
   • export JAVA_HOME=/usr/lib/jvm/java-7-oracle
   • sudo vi /etc/environment
     • (add a line: JAVA_HOME=/usr/lib/jvm/java-7-oracle)
6. install git: sudo apt-get install git -y
7. Install OpenStack (DevStack)
   • git clone https://git.openstack.org/openstack-dev/devstack
   • cd devstack
   • Create local.conf: cp samples/local.conf .
   • Add/replace these lines: vi local.conf
     • FLAT_INTERFACE=(your ethernet interface)
     • ADMIN_PASSWORD=(something you will remember - you will use this to login to the Horizon UI)
     • MYSQL_PASSWORD=(mysql root password)
     • RABBIT_PASSWORD=(something you will remember)
     • SERVICE_PASSWORD=(something you will remember)
   • Start the devstack install: ./stack.sh
   • If all goes well, you will get an output of key items at the end of the script
   • If you hit an error related to the mysql root password, you can reset it and try again
     • sudo mysql –defaults-file=/etc/mysql/debian.cnf
     • mysql> UPDATE mysql.user SET Password=PASSWORD('mysql root password') WHERE User='root';
     • mysql> FLUSH PRIVILEGES;
     • mysql> quit;
     • mysql -u root -p
   • At this point you should be able to login to Horizon at your installed server e.g. http://192.168.1.132/ using the account "admin" and the ADMIN_PASSWORD you set above.
8. install and configure mininet
   • download mininet vm: wget http://downloads.mininet.org/mininet-2.2.0-150106-ubuntu-14.04-server-amd64.zip -O mininet.zip
   • convert to QCOW2 format
   • unzip mininet.zip
   • qemu-img convert -O qcow2 mn-2.2.0-trusty64server-150106-01-30-00/mininet-vm-x86_64.vmdk mn-2.2.0-trusty64server-150106-01-30-00/mininet-vm-x86_64.qcow2
   • In Horizon, create image for mininet-vm
     • create from file in qcow2 format
     • min RAM = 1024
9. Install openvswitch: sudo apt-get install openvswitch-switch
10. Install OpenDaylight Controller (see Install Guide)
    • Get the ODL Helium distribution: curl https://nexus.opendaylight.org/content/repositories/public/org/opendaylight/integration/distribution-karaf/0.2.1-Helium-SR1.1/distribution-karaf-0.2.1-Helium-SR1.1.zip -o Helium-SR1.1.zip
    • unzip Helium-SR1.1.zip
    • cd distribution-karaf-0.2.1-Helium-SR1.1
    • ./bin/karaf
    • You should get the OpenDaylight prompt "opendaylight-user@root>"
    • verify it's working with: feature:list
    • install the ODL components
      • feature:install odl-base-all odl-aaa-authn odl-restconf odl-nsf-all odl-adsal-northbound odl-mdsal-apidocs odl-ovsdb-openstack odl-ovsdb-northbound odl-dlux-core
        • start with this minimal set of features per the video ¨ODL & OpenStack Discussion
        • will pull these additional features as I find they are essential
          • feature:install odl-mdsal-all odl-restconf-all odl-ovsdb-all odl-openflowplugin-flow-services-ui odl-sfc-all odl-groupbasedpolicy-ofoverlay odl-dlux-all odl-config-persister-all odl-aaa-all odl-ttp-all odl-openflowplugin-all odl-adsal-compatibility-all odl-tcpmd5-all odl-adsal-all odl-config-all odl-netconf-all odl-base-all odl-yangtools-all odl-integration-compatible-with-all odl-netconf-connector-all odl-akka-all odl-l2switch-switch odl-mdsal-apidocs odl-aaa-authn
          • (can't find a feature called ML2-plugin)
    • At this point you should be able to login to DLUX at your installed server e.g. http://192.168.1.132:8181/dlux/index.html using the account "admin" and the In Hidefault password "admin".
11. In Horizon, launch mininet-vm created earlier
12. ssh to mininet VM and enter
    • sudo mn –controller=remote,ip=192.168.1.132
13. Bring up a VM and validate basic functionality: this will be initially a manual sequence and eventually scripted using OpenStack APIs

Tried CentOS 7 but continually getting errors:

1. Install CentOS 7 "DVD ISO"
2. When installing, select the "Server with GUI" profile, leaving all options blank (it's unclear whether any are needed at this point)
3. As su, add your username to /etc/sudoers via "visudo"
4. Log out of root!
5. Install git: sudo yum install git
6. Download devstack: git clone https://git.openstack.org/openstack-dev/devstack
7. Create devstack/local.conf, adding/replacing these lines
   • FLAT_INTERFACE=(your ethernet interface)
   • ADMIN_PASSWORD=(random string)
   • MYSQL_PASSWORD=(random string)
   • RABBIT_PASSWORD=(random string)
   • SERVICE_PASSWORD=(random string)
8. Start the devstack install: cd devstack; ./stack.sh
9. A variety of errors received - no reason why, not time to debug