Skip to content

macartur/kytos

 
 

Repository files navigation

Kytos SDN Platform

Experimental Tag Release License Build status Code coverage Code-quality score

Kytos SDN Platform is the fastest way to deploy an SDN Network. With this you can deploy a basic OpenFlow controller or your own controller. Kytos was designed to be easy to install, use, develop and share Network Apps (NApps). Kytos is incredibly powerful and easy, its modular design makes Kytos a lightweight SDN Platform.

Kytos is conceived to ease SDN controllers development and deployment. It was motivated by some gaps left by common SDN solutions. Moreover, it has strong tights with a community view, so it is centered on the development of applications by its users. Thus, our intention is not only to build a new SDN solution, but also to build a community of developers around it, creating new applications that benefit from the SDN paradigm.

The project was born in 2014 and has been under active development since 2016.

For more information about this project, please visit Kytos project website.

Quick Start

Try First

You may try kytos without installing it by running our docker image. Just install docker from your package provider and run:

$ sudo docker run -it --privileged kytos/tryfirst

Installing

We use Python 3.6, so you'll have to install it into your environment beforehand:

$ apt-get install python3.6

Then, the first step is to clone kytos repository:

$ git clone https://github.com/kytos/kytos.git

After cloning, the installation process is done by standard setuptools install procedure:

$ cd kytos
$ sudo python3.6 setup.py install

Configuring

After kytos installation, all config files will be located at /etc/kytos/.

Kytos also accepts a configuration file as argument to change its default behaviour. You can view and modify the main config file at /etc/kytos/kytos.conf, and the logging config file at /etc/kytos/logging.ini.

For more information about the config options please visit the Kytos's Administrator Guide.

How to use

Once Kytos is installed, you can run the controller using:

$ kytosd

Kytos runs as a daemon by default. To run it in foreground, add the -f option to the command line:

$ kytosd -f

You can use -h or --help for more information about options to the command line.

With the above commands your controller will be running and ready to be used. Please note that you have to run it as an user with permission to open sockets at ports 6633 and 8181.

The Web Admin User Interface

Kytos installs automatically a web interface for administration. When Kytos is running, the Web UI runs in your localhost and can be accessed via browser, in http://localhost:8181. Have fun (:

Get Help

You can find us on the #kytos IRC channel on freenode.net network.

We also have two mailing lists:

Submit an Issue

If you find a bug or a mistake in the documentation, you can help us by submitting an issue to our repo. Even better, you can submit a Pull Request to fix it. Before sharing a fix with the Kytos Community, please, check the :ref:`contributing-submission-guidelines` section.

Get Involved

We'd love for you to contribute to our source code and to make Kytos better than it is today!

This is one component of the Kytos project. For more information on how to get involved, please, visit the section :doc:`/developer/how_to_contribute` of the Kytos documentation. Our mailing lists are in :doc:`/home/get_help`.

Authors

For a complete list of authors, please see AUTHORS.rst.

Contributing

If you want to contribute to this project, please read Kytos Documentation website.

License

This software is under MIT-License. For more information please read LICENSE file.

What's Next

You are now ready to browse our guide for :doc:`administrators </admin/intro>` or :doc:`developers </developer/intro>`. Check out!

.prev-next-nav li:last-child { display: none; }