Due to a ransomware attack, the wiki was reverted to a July 2022 version. . We apologize for the lack of a more recent valid backup.
Prerequsite
Please prepare four VMs or host machines with the following specification.
| No | usage | CPU | Memory | Disk |
|---|---|---|---|---|
| 1 | Openstack Controller Node | 2 Core | 4 GB | 20 GB |
| 2 | Openstack Network Node | 2 Core | 4 GB | 20 GB |
| 3 | ONOS Controller | 2 Core | 4 GB | 20 GB |
| 4 | Compute Node | 1 Core | 2 GB | 20 GB |
| 5 | Compute Node | 1 Core | 2 GB | 20 GB |
Set up Control node
Install devstack on the Openstack Controller node
$ git clone git://github.com/openstack-dev/devstack.git
Creates local.conf file using the following options
[[local|localrc]] HOST_IP=1.1.1.1 SERVICE_HOST=1.1.1.1 RABBIT_HOST=1.1.1.1 DATABASE_HOST=1.1.1.1 Q_HOST=1.1.1.1 ADMIN_PASSWORD=nova DATABASE_PASSWORD=$ADMIN_PASSWORD RABBIT_PASSWORD=$ADMIN_PASSWORD SERVICE_PASSWORD=$ADMIN_PASSWORD SERVICE_TOKEN=$ADMIN_PASSWORD DATABASE_TYPE=mysql # Log SCREEN_LOGDIR=/opt/stack/logs/screen # Images IMAGE_URLS="http://download.cirros-cloud.net/0.3.4/cirros-0.3.4-x86_64-disk.img,http://jaist.dl.sourceforge.net/project/gns-3/Qemu%20Appliances/linux-tinycore-3.4.img" NOVA_VNC_ENABLED=true VNCSERVER_PROXYCLIENT_ADDRESS=$HOST_IP VNCSERVER_LISTEN=$HOST_IP NEUTRON_CREATE_INITIAL_NETWORKS=False Q_ML2_PLUGIN_MECHANISM_DRIVERS=onos_ml2 Q_PLUGIN_EXTRA_CONF_PATH=~/networking-onos/etc Q_PLUGIN_EXTRA_CONF_FILES=(conf_onos.ini) # Services enable_service q-svc disable_service n-net disable_service n-cpu disable_service tempest disable_service c-sch disable_service c-api disable_service c-vol
* The IP address 1.1.1.1 needs to be changed to your host IP address of Openstack controller.
* You can choose a different admin password if you want.
* If you installed the onos ml2 plugin in a different place, you need to change the Q_PLUGIN_EXTRA_CONF_PATH properly.Install onos ml2 plugin
$ git clone https://github.com/openstack/networking-onos.git $ cd networking-onos ~/networking-onos$ sudo python setup.py install
If you find the following error, please install python-setuptools using apt-get.
Traceback (most recent call last): File "setup.py", line 17, in <module> import setuptools ImportError: No module named setuptools$ sudo apt-get install python-setuptools
Why we need onos-networking plugin ?
onos-networking plugin just forwards (or calls) REST calls from nova to ONOS, and OpenstackSwitching app receives the API calls and returns OK. Main functions to implement the virtual networks are handled in OpenstackSwitching application.
Configure the onos ml2 plugin by editing the conf_onos.ini file in networking-onos/etc folder, which is just created
#Configuration options for ONOS driver [onos] # (StrOpt) ONOS ReST interface URL. This is a mandatory field. url_path = http://ONOS_HOST_IP:8181/onos/openstackswitching # (StrOpt) Username for authentication. This is a mandatory field. username = onos # (StrOpt) Password for authentication. This is a mandatory field. password = rocks
You need to set the proper IP address for ONOS controller in ONOS_HOST_IP
Set up devstack
~/devstack$ ./stack.sh
It would take quite long up to 1 hour depending on the network status and host performance. If it is setup correctly, you will see the following message.
======================== DevStack Components Timed ======================== apt-get-update - 6 secs pip_install - 31 secs apt-get - 3 secs This is your host IP address: 10.40.101.209 This is your host IPv6 address: ::1 Horizon is now available at http://10.40.101.209/dashboard Keystone is serving at http://10.40.101.209:5000/ The default users are: admin and demo The password: nova 2015-12-10 07:32:04.411 | stack.sh completed in 243 seconds.
Please check if you can log in to the Horizon dashboard with the url and login information as below.
Set up Network node
Install devstack on the Openstack Network node
$ git clone git://github.com/openstack-dev/devstack.git
Creates local.conf file using the following options
[[local|localrc]] HOST_IP=2.2.2.2 SERVICE_HOST=1.1.1.1 RABBIT_HOST=1.1.1.1 DATABASE_HOST=1.1.1.1 Q_HOST=2.2.2.2 ADMIN_PASSWORD=nova DATABASE_PASSWORD=$ADMIN_PASSWORD RABBIT_PASSWORD=$ADMIN_PASSWORD SERVICE_PASSWORD=$ADMIN_PASSWORD SERVICE_TOKEN=$ADMIN_PASSWORD DATABASE_TYPE=mysql # Log SCREEN_LOGDIR=/opt/stack/logs/screen # Images IMAGE_URLS="http://download.cirros-cloud.net/0.3.4/cirros-0.3.4-x86_64-disk.img" LIBVIRT_TYPE=qemu #vnc NOVA_VNC_ENABLED=True VNCSERVER_PROXYCLIENT_ADDRESS=$HOST_IP VNCSERVER_LISTEN=$HOST_IP # Services enabled_services q-l3
We need to specify the Network node IP address in HOST_IP and Q_HOST, and the Control node IP address in others. Also, we just need to enable L3 service. Later, when OpenstackRouter app is implemented, Network node itself will not be necessary.
Install devstack
~/devstack$ ./stack.sh
When it is installed successfully, you will see the message below.
======================== DevStack Components Timed ======================== apt-get-update - 6 secs pip_install - 30 secs apt-get - 3 secs This is your host IP address: 10.40.102.231 This is your host IPv6 address: ::1 Horizon is now available at http://10.40.101.209/dashboard Keystone is serving at http://10.40.101.209:5000/ The default users are: admin and demo The password: nova 2015-12-10 06:22:21.048 | stack.sh completed in 171 seconds.
Upgrade OVS to version 2.3.2
Unload existing openvswitch modules$ sudo rmmod openvswitch
Check if openvswitch modules are unloaded.
$ sudo lsmod
Uninstall openvswitch 2.0.2.
$ sudo apt-get remove openvswitch-common
Then, follow the steps "Install Openvswitch" steps below.
Set up Compute node
Install Openvswitch
Even though any version higher than 2.0 would work, but we have tested with 2.3.2.
$ wget http://openvswitch.org/releases/openvswitch-2.3.2.tar.gz $ tar xzvf openvswitch-2.3.2.tar.gz $ cd openvswitch-2.3.2/ ~/openvswitch-2.3.2$ ./configure ~/openvswitch-2.3.2$ make ~/openvswitch-2.3.2$ sudo make install ~/openvswitch-2.3.2$ sudo modprobe openvswitch
You can check if openvswitch is loaded properly
~/openvswitch-2.3.2$ sudo lsmod Module Size Used by openvswitch 71004 0 vxlan 37619 1 openvswitch ip_tunnel 23768 1 vxlan gre 13796 1 openvswitch libcrc32c 12644 1 openvswitch
Set up OVS
Please see the following link for detail, but here are the simple way to set up the OVS.
https://github.com/openvswitch/ovs/blob/master/INSTALL.md~/openvswitch-2.3.2$ mkdir -p /usr/local/etc/openvswitch ~/openvswitch-2.3.2$ sudo ovsdb-tool create /usr/local/etc/openvswitch/conf.db vswitchd/vswitch.ovsschema ~/openvswitch-2.3.2$ sudo ovsdb-server --remote=punix:/usr/local/var/run/openvswitch/db.sock \ --remote=db:Open_vSwitch,Open_vSwitch,manager_options \ --private-key=db:Open_vSwitch,SSL,private_key \ --certificate=db:Open_vSwitch,SSL,certificate \ --bootstrap-ca-cert=db:Open_vSwitch,SSL,ca_cert \ --pidfile --detach ~/openvswitch-2.3.2$ sudo ovs-vsctl --no-wait init ~/openvswitch-2.3.2$ sudo ovs-vswitchd --pidfile --detachYou can check if it is installed correctly
~/openvswitch-2.3.2$ sudo ovs-vsctl --version ovs-vsctl (Open vSwitch) 2.3.2 Compiled Dec 3 2015 14:49:51 DB Schema 7.6.2
Set manager as ptcp:6640 so that ONOS can detect the OVSDB
~/openvswitch-2.3.2$ sudo ovs-vsctl set-manager ptcp:6640
Install devstack on the Compute node
$ git clone git://github.com/openstack-dev/devstack.git
Please use the following local.conf for the compute nodes
[[local|localrc]] HOST_IP=2.2.2.2 SERVICE_HOST=1.1.1.1 RABBIT_HOST=1.1.1.1 DATABASE_HOST=1.1.1.1 Q_HOST=1.1.1.1 ADMIN_PASSWORD=nova DATABASE_PASSWORD=$ADMIN_PASSWORD RABBIT_PASSWORD=$ADMIN_PASSWORD SERVICE_PASSWORD=$ADMIN_PASSWORD SERVICE_TOKEN=$ADMIN_PASSWORD DATABASE_TYPE=mysql #Images IMAGE_URLS="http://download.cirros-cloud.net/0.3.4/cirros-0.3.4-x86_64-disk.img,http://jaist.dl.sourceforge.net/project/gns-3/Qemu%20Appliances/linux-tinycore-3.4.img" # Log NOVA_VNC_ENABLED=true VNCSERVER_PROXYCLIENT_ADDRESS=$HOST_IP VNCSERVER_LISTEN=$HOST_IP SCREEN_LOGDIR=/opt/stack/logs/screen LIBVIRT_TYPE=qemu # Services ENABLED_SERVICES=n-cpu,neutron
HOST_IP should be the IP address of the compute node host, and Controller node IP address needs to be set for other settings.
- Set up another compute node in the same way.
Set up ONOS node
We recommend to follow the link to set up the ONOS node and set up the ONOS development environment : ONOS from Scratch. However, you can also follow the following steps only to set up the ONOS node.
Log into your new VM as sdn and give the user passwordless sudo privileges. Run
sudo visudo, and add the following line to the end of the file:USER_ID ALL=(ALL) NOPASSWD:ALL
Install Java 8
$ sudo apt-get install software-properties-common -y $ sudo add-apt-repository ppa:webupd8team/java -y $ sudo apt-get update $ sudo apt-get install oracle-java8-installer oracle-java8-set-default -y
- Set up the public key login either using onos-push-keys or copying your public key of your development host to ONOS node