Install from Binaries
As of right now, we only have binary support for 32-bit Debian and Ubuntu based distributions. If you have a distribution you want supported, or better yet, want to support a new distribution, please send us mail.
Install from Source
Install ant and java in order to build flowvisor:
Now build it:
(FlowVisor also works with openjdk, but you will have to adjust the commands accordingly)
If the build ends with BUILD SUCCESSFUL then install flowvisor (run as root if installing to /usr/local):
When prompted, set the prefix to
/usr/local and the user/group to the user/group you want the flowvisor to run as. Next, generate a default configuration file with:
Updating from Source
Now and then, fixes will be applied to the git repository, and we will want to install them. In order to get the latest and greatest, do the following:
If the build ends with BUILD SUCCESSFUL then install flowvisor again as above.
This version of flowvisor uses an XML configuration file. In our installation, this file lives in
/usr/local/etc/flowvisor/flowvisor-config.xml and should not be hand-edited.
The initial config file generated with the flowvisor package contains some sample slices and flow definitions. These must be removed before flowvisor can be used in our environment. In order to make the required changes, flowvisor must be running. Example invocation is:
Then, give the following commands (deleting slices implicitly deletes the rules associated with them):
You can now define a fall-back "production" slice that will catch all flows from all switches that are not handled by higher-priority flowspace definitions. Again, in the second window on the flowvisor machine, give the following commands:
Creating an Expedient-friendly mySSLKeyStore
The Expedient aggregate manager needs a correctly built mySSLKeyStore file in the flowvisor configuration directory. To build this file, do the following:
fvconfig generateCert will use the store password set in
/usr/local/etc/flowvisor/envs and the output of
hostname as the cert's common name. See
man fvconfig for more details.
These instructions were heavily based on instructions from Chris Tengi from Princeton. Thanks Chris!