There are multiple ways to easily deploy Skydive, in this section we are going
to explain the most common ways.
The easiest way is to download one of the statically binary of Skydive. There
are two kind of binary, one is built each time a feature of a bug fix is
, the others are provided for each
Since Skydive uses the same binary for all its component, one can use it as
agent, analyzer or client.
This mode start an analyzer and an agent at once.
Agent and Analyzer separately
You can use Vagrant to deploy a Skydive environment with one virtual machine
running both Skydive analyzer and Elasticsearch, and two virtual machines with the
Skydive agent. This Vagrantfile, hosted in contrib/vagrant of the Git
repository, makes use of the
libvirt Vagrant provider] and uses Fedora as the box image.
can also be used to automatically start an Elasticsearch container,
a Skydive analyzer container and a Skydive agent container. The service
definition is located in the contrib/docker folder of the Skydive sources.
Skydive provides a DevStack plugin that can be used in order to have
Skydive Agents/Analyzer set up with the proper probes
For a single node setup adding the following lines to your local.conf file
should be enough.
The plugin accepts the following parameters:
The classical two nodes deployment
Inside the devstack folder of the
there are two local.conf files that can be used in order to deployment two Devstack with Skydive.
The first file will install a full Devstack with Skydive analyzer and agent. The second
one will install a compute Devstack with only the skydive agent.
For Skydive to create a TOR object that links both Devstack, add the following
line to your local.conf file :
where devstack1 and devstack2 are the hostnames of the two nodes followed
by their respective public interface.
Skydive will be set with the probes for OpenvSwitch and Neutron. It will be set
to use Keystone as authentication mechanism, so the credentials will be the same
than the admin.
Client & WebUI
Skydive client can be used to interact with Skydive Analyzer and Agents.
Running it without any command will return all the commands available.
Specifying the subcommand will give the usage of the subcommand.
If an authentication mechanism is defined in the configuration file the username
and password parameter have to be used for each command. Environment variables
SKYDIVE_USERNAME and SKYDIVE_PASSWORD can be used as default value for the
username/password command line parameters.
Skydive uses the Gremlin traversal language as a topology request language.
Requests on the topology can be done as following :
Refer to the
Gremlin section for further
explanations about the syntax and the functions available.