1. System requirements

OVX is a fairly heavy piece of software in its current implementation and these system requirements should not be taken too lightly – the number of slices, size of the flowspace, and number of datapaths present in your network all contribute to the scaling factors. Only the most trivial of environments can tolerate the minimum system requirements.

Recommended
4 Cores
4 GB java heap size

Minimum
2 Cores
1 GB java heap size

2. Binary installation

Under construction. Deb and rpm packages will be distributed soon.

3. Installation from source

You will need to install the following packages:
* Git,
* Oracle Java, version 7 (version 8 is unsupported for now),
* Apache Maven,
* Python, version 2.7 or higher, and
* MongoDB is optional, install if you want to use the OVX persistence features.

Then you can clone the OVX source

git clone https://github.com/OPENNETWORKINGLAB/OpenVirteX.git -b 0.0-MAINT

Normally you want to run the current stable branch 0.0-MAINT. If you are feeling adventurous or need some recently added features, replace 0.0-MAINT by 0.1-DEV in the previous command.

If you want to use OpenVirteX that supports OpenFlow 1.3, replace 0.0-MAINT into OpenFlow1.3 from the above command.

4. Running OVX

sh OpenVirteX/scripts/ovx.sh

4.1. Command line parameters

OVX supports the following command line parameters.

Name Alias Type Description Default
-p –of-port integer OpenFlow port 6633
-h –of-host string hostname 0.0.0.0
-dh –db-host string database host 127.0.0.1
-dp –db-port int database port 27017
–db-clear clear database
–stats-refresh integer physical statistics polling interval (in seconds) 30
–ct –client-threads integer number of threads to handle controller connections 32
–st –server-threads integer number of threads to handle switch connections 32
–ub –use-bddp use BDDP for network discovery (only use if you know what you are doing)