CHANGELOG.rst

Changelog

All notable changes to the kytos project will be documented in this file.

UNRELEASED - Under development

[2023.2.2] - 2024-12-03

Added

• Added option for links to get last TAG from interface.available_tags.
• Added option for links to try to avoid a TAG value from interface.available_tags.

[2023.2.1] - 2024-11-01

Fixed

• Order in interface.special_available_tags and interface.special_tags does not matter anymore when looking for used special tag.

[2023.2.0] - 2024-02-16

Added

• Added Interface.tag_ranges as dict[str, list[list[int]]] as replacement for vlan_pool settings.
• Added kytos/core.interface_tags event publication to notify any modification of Interface.tag_ranges or Interface.available_tags.
• Added TAGRange class which is used when a UNI has a tag as a list of ranges.
• Added KytosTagError exception that cover other exceptions KytosTagtypeNotSupported, KytosInvalidTagRanges, KytosSetTagRangeError, KytosTagsNotInTagRanges and KytosTagsAreNotAvailable all of which are related to TAGs.
• Added special_available_tags which stores "untagged" and "any" if they can be used from an Interface.
• Added maxsize_multiplier on event_buffer_conf, which will multiply the maxsize value of the queue. By default, all KytosEventBuffer who use a bounded queue will have maxsize_multiplier: 2. This default is reasonable to work out of the box with kytos-ng core NApps. But, if you have other NApps who tend to produce too many events you might want to either increase the size of the queue with and/or increase the number of max workers in the thread pool if the event handler is running on a thread pool. Typically, you'll want to first start adjusting the number of workers in the thread pool.
• Introduced a new meta on KytosBuffers, which is meant for general core control events.
• Added api threadpool. This is used by the ASGI server to handle requests to non async endpoints.
• Added in configuration option api_concurrency_limit, specifies the max number of concurrent API requests before rejecting the request.
• Added thread_pool_queue_monitors and event_buffer_monitors on kytos.conf. By default, it'll detect and log full queue usage over 5 secs on event thread pools and on kytos event buffers. These alerts are for providing basic visibility per second about queues usage, which these alerts you can try to understand if indeed you have way too many events or if you need to increase the number of thread pool workers depending on the scalability and workload you have.

Changed

• Parametrized default maxTimeMS when creating an index via Mongo.boostrap_index via environment variable MONGO_IDX_TIMEOUTMS=30000. The retries parameters reuse the same environment variables MONGO_AUTO_RETRY_STOP_AFTER_ATTEMPT=3, MONGO_AUTO_RETRY_WAIT_RANDOM_MIN=0.1, MONGO_AUTO_RETRY_WAIT_RANDOM_MAX=1 that NApps controllers have been using.
• kytosd process will exit if a NApp raises an exception during its setup() execution.
• Change format for Interface.available_tags to dict[str, list[list[int]]]. Storing tag_types as keys and a list of ranges for available_tags as values.
• Interface.use_tags and Interface.make_tags_available are compatible with list of ranges.
• KytosEventBuffer`'s ``put method timeout now accepts a timeout argument. NApps who publish events during setup() should set timeout=1 without handling the exception, so if within 1 second the event can't be put in the queue, then the NApp will fail to start, which would imply that during initialization either the queue size is too small or the NApp is misbehaving sending too many events.

Fixed

• Avoid kytosd hanging its termination when handling SystemExit with SIGTERM
• Enabling an interface does not longer enables its switch

Deprecated

• Deleted vlan_pool from kytos.conf in favor of Interface.tag_ranges which updates from kytos/topology API endpoint, v3/interfaces/{intf_id}/tag_ranges.

General Information

• kytos.conf.template has changed you might want to regenerate kytos.conf if you want to set non default values

[2023.1.0] - 2023-06-05

Added

• Added status to as_dict() from entities Interface, Switch and Link.
• Added @validate_openapi decorator to validate OpenAPI routes
• Added avalidate_openapi_request(spec, request) to validate OpenAPI async routes
• htppx is now shipped as a dependency, NApps can also leverage it instead of requests
• Added kytos.core.rest_api module exposing utilities for requests handlers
• Added new kytos.conf option api_traceback_on_500, which is True by default to provide a complete traceback on API responses if an internal server error ever happens
• Added status_reason to Interface, Switch, and Link.
• Added register_status_reason_func to Interface, Switch, and Link.

Changed

• Changed UNI.is_valid to allow tags such as any and untagged
• Changed EntityStatus value from 1, 2 and 3 to UP, DISABLED and DOWN respectively.
• Replaced werkzeug/flask with starlette/uvicorn
• Updated logging.ini logger_api_server with level: INFO by default
• Updated APM to instrument starlette
• HTTP API exceptions responses no longer include the "name" key name in the response, only "code" and "description" still remain
• Development get_test_client now uses a htppx.AsyncClient instance
• Moved error_msg() to kytos.core.rest_api so it can be used in any NApp
• Link now includes its id on its string format representation to facilitate correlating events in the logs
• Link now have ordered endpoints. They are ordere by its id
• Updated status_api to include when the APIServer started and how much time has elapsed.
• Augmented listen_to decorator pool kwarg to support 'dynamic_single'. In this mode, each decorated handler will be associated with an exclusive ThreadPoolExecutor with a single worker, ensuring FIFO event processing, which can be suitable for non IO-bound handlers.

Fixed

• Unexposed jwt_secret on GET /api/kytos/core/config/ endpoint

[2022.3.1] 2023-02-17

Fixed

• handled PackException to avoid crashing msg_out_event_handler coroutine

[2022.3.0] 2022-12-15

Changed

• Upstream core dependencies have been upgraded: ipython==8.1.1, flask-socketio==5.2.0, flask_cors==3.0.10, flask[async]==2.1.3, janus==1.0.0, jinja2==3.1.2, watchdog==2.1.9, pyjwt==2.4.0, pylint==2.15.0
• Flask/Werkzeug 2.0.0+ now provide async support, so NApps can leverage asyncio and its ecosystem when applicable using the same rest decorator
• Replaced get_event_loop with get_running_loop when applicable to be compatible with python 3.9+ in the future
• NApps are unloaded in the reverse order that they are enabled to facilitate to shutdown gracefully.
• MongoClient now has an explicit write_concern majority
• Added dependencies dnspython==2.2.1, email-validator==1.3.0
• Auth storage has been migrated from the NApp storehouse to MongoDB with kytos/users.py collection
• status_funcs have been moved to GenericEntity sub classes to avoid potential conflicts with different entities

Fixed

• Log traceback error if NApps execute method doesn't handle an exception
• Stop APIServer instance after unloading NApps
• Log traceback error if the header from authorization was empty resulting in HTTP 500

[2022.2.2] - "kiko" - 2022-08-25

Fixed

• Added connection_timeout as a default on KytosConfig to support older configuration files

[2022.2.1] - "kiko" - 2022-08-19

Fixed

• Added sanity safe guard on Interface.make_tag_available method

[2022.2.0] - "kiko" - 2022-08-09

No major changes since the last pre-release.

[2022.2rc3] - "kiko" - 2022-08-05

Added

• Added configuration option connection_timeout = 130 for switch connection.

[2022.2rc2] - "kiko" - 2022-08-04

Added

• Added configuration option logger_decorators. Allows for decorating the Logger class with 0 or more decorators. Decorators are applied in order provided.
• Added kytos.core.logger_decorators.queue_decorator. This decorator adds an internal queue for handling log messages. This decorator is intended to reduce latency associated with logging calls by offloading required IO operations to a separate thread.
• Added kytos.core.logger_decorators.apm_decorator. This decorator instruments various logging methods in order to measure performance, and reports the results to the apm backend.

Changed

• Loggers are now by default decorated with kytos.core.logger_decorators.queue_decorator. Usage of this decorator has been observed to significantly reduce logging latency, with one scenario showing an improvement from 19.65ms average latency down to 0.55ms average latency.

[2022.2rc1] - "kiko" - 2022-07-25

Added

• Unhandled exception on a listen_to decorated function (running in a ThreadPool) is logged as error.

• New --database configuration option that supports mongodb

• MongoDB client for NApps, Mongo available on kytos.core.db module

• Added a wait mechanism during controller startup time to ensure the database is reachable if it's been configured

• pymongo and pydantic (for database models) are now core dependencies

• Added MongoDB environment variables MONGO_HOST_SEEDS, MONGO_USERNAME, MONGO_PASSWORD

• Added optional MongoDB environment MONGO_DBNAME, MONGO_MAX_POOLSIZE, MONGO_MIN_POOLSIZE, MONGO_TIMEOUTMS

• Added a docker-compose.yml file for local development to compose with MongoDB replica set cluster

• Added an in-memory dead letter structure for unhandled exceptions of KytosEvents indexed by their names

• Added core endpoints for the dead letter structure:

  GET /api/kytos/core/dead_letter/?event_name=<name>
  PATCH /api/kytos/core/dead_letter/ (requires request body)
  DELETE /api/kytos/core/dead_letter/ (requires request body)

• Added tenacity as a core dependency for retries.

• New --apm configuration option that supports elasticsearch APM (Application Performance Monitoring)

• kytosd Elastic APM integration provides instrumentation for MongoDB, Flask, requests and KytosEvent

• @begin_span decorator for on-demand APM custom functions/methods instrumentation

• Augmented docker-compose.yml to also spin up Elastsearch, Kibana and APM server with authentication

• Augmented docker-compose to also spin up Filebeat, integrating log file as input

• The listen_to decorator now supports a pool keyword argument to specify which thread pool the execution should be submitted

• New core kytos.core.retry module provides decorators for retries based on tenacity

• Added @alisten_to decorator for async methods. NApps can subscribe to events asynchronously with this decorator as needed.

• Unhandled exceptions on @listen_to and @alisten_to decorators now also include a traceback

• Added status_funcs on GenericEntity to allow NApps to register functions to compose status.

Changed

• Kytos controller can shutdown if the database is configured but not reachable during startup time.

• Augmented KytosEvent with internal attributes (id and reinjections), no breaking changes.

• KytosEvent now optionally supports a trace_parent argument for APM distributed tracing to also instrument and correlate KytosEvent.

• Added file formatter and file handler boilerplate on logging.ini.template to facilitate hooking the file handler on logger_root and logger_kytos as needed.

• Broke compatibility in the thread_pool_max_workers, it uses a dict now instead of a single integer. If you were using a single integer for a global pool, please migrate it to {"sb": 256, "db": 256, "app": x}, where x should be the value that you used to use or the default 512.

• The following pools are available by default to be used in the listen_to decorator with the pool option:

  sb: it's used automatically by kytos/of_core.* events, it's meant for southbound related messages
  app: it's meant for general NApps event, it's default pool if no other one has been specified
  db: it can be used by for higher priority db related tasks (need to be parametrized on decorator), it's also used automatically by kytos.storehouse.* events

• msg_out core queue now leverages a PriorityQueue instead of a FIFO Queue.

• msg_in core queue now leverages a PriorityQueue instead of a FIFO Queue.

• kytos.core.log now directly provides the appropriate logger to the NAPP, rather than a facade

• Flask will encode datetime objects format as %Y-%m-%dT%H:%M:%S str

Fixed

• Fixed file already exists error when creating config dirs, issue 222

[2022.1.1] - "jovelina" - 2022-02-01

Fixed

• Load NApps ordered by modification, allowing the administrator to set a desired order of loading.

[2022.1] - "jovelina" - 2022-01-21

Changed

• New README reflecting the change to Kytos NG.

[2022.1rc1] - "jovelina" - 2022-01-14

Added

• Support python 3.9.
• Method to create or update interface.

Changed

• Run tests using GitHub Actions.

Fixed

• Lock to avoid race conditions when selecting a tag.
• Lock to avoid race conditions when getting or creating a Switch.

[2021.1] - "final" - 2021-05-31

Added

• New blueprint: EP023 - Kytos Pathfinder Filter Paths by Metadata.

Changed

• Renamed shutdown REST endpoint to _shutdown and improved its description.
• Fixed Switch class docstrings.

Fixed

• Fixed RuntimeError when shutting down Kytos.

[2021.1rc1] - "final" release candidate 1 - 2021-04-30

Added

• New blueprint: EP022 - Kytos reports statistics.
• New method from_dict to instantiate Interface, UNI, Link and Switch classes from python dictionary.
• Log uncaught exceptions to console and/or log files.
• New log message when handling errors at superuser creation.
• Added file to provide support for Dependabot.
• [docs] New documentation for consistency system.

Fixed

• [tests] Fix PID value to fix errors in unit test execution (fix #1242).
• [tests] Fix pytest-runner error raised by Scrutinizer CI.
• [docs] Fixed warning in code-block section in auth documentation.

Security

• Updated dependencies.

[2020.2] - "itamar" stable release - 2020-12-30

No changes since rc1.

[2020.2rc1] - "itamar" release candidate 1 - 2020-12-23

Added

• Added event to notify when a NApp was loaded.
• [docs][ui] Added k-notification component and its event docs.
• [docs][ui] Added table that lists the Kytos standard colors.

Fixed

• [docs] Fixed the cells' order when the Blueprints table is generated.

Changed

• [docs] Updated k-context-panel and k-table images and usage examples.

[2020.2b3] - "itamar" beta3 - 2020-11-20

Added

• Added configuration field to change token expiration time in REST API authentication.
• [ui] New UI component: Notification.
• [ui] Added info-panel toggle button in tabs component.
• [ui] Added close button to info-panel component.
• [docs] Added a new "Blueprints" section to the Dev Guide.
• [docs] New section about implementation of compressed and expanded formats for toolbar components UI.

Changed

• Refactor method get_interface_by_port_no to work with both``v0x01`` and v0x04 port parameters.
• [ui][docs] Updated components' docs: accordion, tooltip and title.
• [ui][docs] Updated usage example for the event component
• [docs] Updated admin guide with parameter to create a superuser.
• Changed stability badge in PyPI from experimental to beta.

Fixed

• Fixed double loading of NApps when installing via kytos napps install
• Fixed daemon configuration that was being ignored
• [ui] Fixed overlay between tabs component and other components.

[2020.2b2] - "itamar" beta2 - 2020-10-23

Added

• Added authentication to REST methods based on configuration option
• Create config field on Interface
• Added new exception KytosLinkCreationError
• [docs] Created a template blueprint - EP000
• [docs] Added of_lldp's new REST Endpoints
• [docs] Added "Kytos UI Components" section to Dev Guide
• [docs] New note about the creation of UI folders
• [tests] Added pydocstyle as a required linter

Changed

• [docs] Updated old blueprints to include standard headers
• [docs] Moved section "Creating a NApp with UI" to the Web-UI documentation
• [docs] Use friendlier apt command instead of apt-get
• [docs] Updated Authentication documentation
• [docs] Updated tutorial "How protect a REST endpoint"
• [tests] Changed tests to use multiple-letter keys in mock link metadata

Removed

• Removed hard-coded python3.6 references
• [packaging] Remove the use of distutils from setup.py

Fixed

• Improved support for newer versions of Python
• Fixed exception when kytosd cannot update the web UI from GitHub
• Fixed parsing of vlan_pool configuration option
• [tests] Fixed test_logs for Python 3.8
• [tests] Fixed automated packaging tests under GitHub Actions

[2020.2b1] - "itamar" beta1 - 2020-09-08

Added

• Added Blueprints section to the "How to Contribute" guide.

Fixed

• Fixed bug when two NApps had methods with the same name decorated with the @rest decorator.
• Fixed authentication URLs in documentation.
• Fixed interface tests.

Changed

• Changed dev requirements to install run requirements.
• Changed Makefile to use python3 instead of python3.6.
• Updated .travis.yml to use newest pip dependency resolver for tests.
• Changed setup.py to alert when a test fails on Travis.

[2020.1] - "helena" stable - 2020-08-07

Added

• Improve unit tests coverage from 55% to 93%.
• Added new method to handle HTTPException - now it returns a JSON with an error code.
• Added tags decorator to run tests by type and size.
• Added instruction for opening issues with traffic files in Dev Guide.
• Added Pull Request Guidelines to the Developer Guide.

Fixed

• Fixed duplicated endpoint error in available_vlans method.
• Fixed error when creating an EVC without a Tag.
• Fixed packaging error by changing the six version.

Changed

• Updated setup.py to use native setuptools install.
• Make speed property checks compliant with OF1.3 spec.
• Updated controller mock method to accept loop parameter.
• Changed API server status HTTP code to 200.
• Updated documentation images, dates and links.

[2020.1rc1] - "helena" release candidate 1 - 2020-06-17

Added

• Added doc listing all the REST APIs available on Kytos Core + NApps

Fixed

• Fixed random error on concurrent tests, waiting for threads to finish before testing.

Changed

• Return the original HTTP error code when a NApp is not found in the NApp server
• Link.get_next_available_tag() now raises an exception (instead of returning False) when there is no available tag

[2020.1b3] - "helena" beta3 - 2020-05-19

Added

• Added a new kytos.lib.helpers module to be used by NApps as an utility for tests.
• [kytos/topology] Added persistence for switches and interfaces administrative status (enabled/disabled).
• [kytos/topology] Added REST APIs to enable/disable all interfaces from a switch.
• [kytos/topology] Added listeners for events from the Maintenance NApp.
• [kytos/of_core] Added tag decorators for small/medium/large tests.

Changed

• [packaging] Changed Makefile to clean old web-ui builds.

Fixed

• [kytos/topology] Avoid using flapping links: now a link is considered up only after a specific amount of time (default: 10 seconds).
• [kytos/topology] Fixed switches coordinates on the map.
• Fixed 22 linter issues raised after the pylint upgrade.

[2020.1b2] - "helena" beta2 - 2020-04-08

Added

• Added shorter README file to use on PyPI description.

Changed

• Upgraded versions for all dependencies
• kytosd now create configuration only in post-install - #1042

Fixed

• Fixed SandboxViolation when installing Kytos as a dependency from PyPI - #494
• Fixed install from wheel package format- #922
• Fixed "There is no config file." error when starting kytosd - #951

[2020.1b1] - "helena" beta1 - 2020-03-09

Added

• New unit tests for NApps:

  • kytos/kronos, coverage increased from 0% to 31%
  • kytos/mef_eline, coverage increased from 67% to 70%
  • kytos/of_core, coverage increased from 28% to 47%

• New blueprint: EP018 - Kytos testing pipeline and definitions.
• Added long description field for display in pypi.org.

Fixed

• Fixed Scrutinizer coverage error.

[2019.2] - "gil" stable - 2019-12-20

Changed

• Increased token expiration time in auth module.

[2019.2rc1] - "gil" release candidate 1 - 2019-12-13

Added

• New etcd backend for the Storehouse NApp (experimental)
• NApps Server now has e-mail verification and password reset for devs
• Added python-openflow unit test coverage section to Kytos Dev guide

Fixed

• Fixed duplicated logs (#993)
• Fixed exception handling during NApp setup which could cause locks on kytosd shutdown (#1000)

[2019.2b3] - "gil" beta3 - 2019-12-06

Added

• New Authentication module - REST endpoints can now be protected using the @authenticated decorator.
• New unitests to the Authentication module.
• New /metadata REST endpoint to access package metadata. kytos-utils now uses this to look for version mismatches.

Changed

• Blueprint EP018 - Updated endpoints to configure Authentication module.

Fixed

• Fix kytos installation without virtual env (eg.: sudo).

[2019.2b2] - "gil" beta2 - 2019-10-18

Added

• New blueprint: EP018 - API Authentication.
• New blueprint: EP019 - Improvements on Statistics Metrics Collections.
• New blueprint: EP020 - Data and Settings Persistence.

Changed

• Changed loggers to begin the hierarchy with "kytos."
• Modify the kytos developer mode to check the installation of configuration files.
• Blueprint EP016: Changed layout and improvement ideas.
• Blueprint EP017: More details on OpenFlow errors.

[2019.2b1] - "gil" beta1 - 2019-08-30

Added

• Interface objects have a new boolean lldp attribute (default True). Other applications can look at this attribute to determine the LLDP behavior.

Changed

• Improved installation of dependencies - pinned versions for dependencies in the production and developer install modes.

[2019.1] - "fafa" stable - 2019-07-12

• This is the stable "fafa" version, based on the last beta pre-releases. No changes since the last rc1.

[2019.1rc1] - "fafa" rc1 - 2019-07-05

Added

• Added Makefile for packaging and uploading to PyPI
• Added string representations to Switch and Interface
• New unit test for TCP server exceptions

Changed

• pytest is now the default tool for Kytos' unit tests
• Invalid command-line parameters emit warnings instead of halting kytosd start

Fixed

• Fixed traceback when a switch loses connectivity

[2019.1b3] - "fafa" beta3 - 2019-06-17

Added

• Added REST API endpoints to manage NApps from remote applications
• New kytos/kronos NApp was released. This NApp will be responsible for handling time series data, with initial support for InfluxDB (EXPERIMENTAL). For now on, visit kytos/kronos changelog for updates.

Changed

• kytos-utils is now decoupled from kytos core
• Changed default Openflow TCP port to 6653

Removed

• Removed diraol's watchdog fork dependency

Fixed

• Fixed kytos install from PyPI. Now dependencies are properly installed
• Fixed some grammar errors in documentation
• Fixed some linter issues

Security

• Changed some dependencies versions in order to fix security bugs

[2019.1b2] - "fafa" beta2 - 2019-05-03

Added

• Added MEF E-Line Link Up/Down definition blueprint
• Added documentation about using tox for unit tests

Fixed

• Fixed bug when starting kytosd in background (#893)
• Fixed method get_next_available_tag under concurrent scenarios
• Fixed warning when compiling documentation

[2019.1b1] - "fafa" beta1 - 2019-03-15

Added

• Added vlan_pool configuration on kytos.conf to support mef_eline. Now you can configure available vlans per interface
• Added documentation to describe how to create a Meta Napp
• Added documentation about Unit Tests

Changed

• Updated documentation to install python-openflow, kytos-utils and kytos in that order
• Updated documentation to use pip3 instead pip
• Link id is now based on endpoints hashes, instead of a random uuid. This fixes #875

Deprecated

Removed

• Removed circular dependency of kytos-utils
• Removed unnecessary comparison on interfaces if they are on the same switch

Fixed

• Fixed type declaration that broke sphinx-build
• Fixed some linter issues
• Fixed NApps settings reload. Now when you change a NApp settings the reload it will work

Security

• Updated pyyaml and requests requirements versions, in order to fix vulnerabilities

[2018.2] - "ernesto" stable - 2018-12-30

• This is the stable "ernesto" version, based on the last beta pre-releases. No changes since the last rc1.

[2018.2rc1] - "ernesto" rc1 - 2018-12-21

Added

• Support for meta-napps (EXPERIMENTAL)

[2018.2b3] - "ernesto" beta3 - 2018-12-14

Added

• Added support to reuse VLAN pool configurations on Interface
• Added support for serialization of Link instances

Changed

• Improved test coverage
• Blueprint EP015 (system tests) improved

[2018.2b2] - "ernesto" - 2018-10-15

Changed

• Improved test coverage

Fixed

• Removed warnings for invalid port speed (fix #754)
• Fixed port speed on web user interface
• Update console to support IPython 7

[2018.2b1] - "ernesto" - 2018-09-06

Added

• Added methods to list all NApp listeners.

Changed

• Blueprint EP12.rst updated in order to describe patch and delete operations.

Fixed

• Fixed compatibility of Python 3.7
• Fixed some linter issues.

[2018.1] - "dalva" - 2018-07-19

Fixed

• Fixed napps pre-installed with default value.

[2018.1b3] - "dalva" beta3 - 2018-06-15

Added

• Added reload/<username>/<napp_name> endpoint to reload the NApp code
• Added reload/all endpoint to update the NApp code of all NApps
• Kytos console display the kytos version.
• Added method __repr__ on Napp class.
• Added method __eq__ on UNI class.
• UNI and TAG has method as_dict and as_json.
• Added method get_metadata as_dict.
• Added method to return all available vlans.
• Added method to return a specific interface by id.
• Added pre-install napps method.
• Added a better introduction of dev and admin guides.
• Better handling of active/enabled in Switch/Interface/Links entities.

Changed

• Better handling of broken napps.
• Refactored load_napps method.
• Refactored get_time to return a datetime with UTC
• Migrated event handler threads to the main asyncio loop.
• Improve documentation to use kytos sphinx theme.

Fixed

• Some documentation docstrings.

[2018.1b2] - "dalva" beta2 - 2018-4-20

Added

• Added str and repr methods for KytosEvent and Connection classes to be easy to see logging and debugging information.
• Added web/update/<version>/ endpoint to update Kytos Web Interface with a specific version.
• Added asyncio support in tcp server and controller. API Server, ipython, event handlers and event notifications are still running on separate threads.

Changed

• Changed the components name provided by Kytos NApps to use the pattern: {username}-{nappname}-{component-section}-{filename}

Fixed

• Fixed some docstrings and comments

[2018.1b1] - "dalva" beta1 - 2018-3-09

Added

• Added some new blueprints (EP012, EP013 and EP014)
• Now, we have few Entities inside the core (Switch, Interface and Link)
• Each Entity has metadata attribute (a dict)
• Added link attribute to the Interface class
• GenericEntity itself was added in this version also
• Added 'active' and 'enable' flags to GenericEntity (EP013)
• Added 'enable'/'disable' methods to child GenericEntity classes (EP013).
• Define available_tags according to link's interfaces.
• Endpoint ('/ui/all') to display a json with all napps ui components.
• Endpoint ('/ui/<path:filename>') to get file with a specific napp component.
• Now, kytosd is a python module, to make it easy to run with asyncio on the future;
• This pre-release implements EP013 and EP014 as discussed on our last Kytos Dev Meeting.

Changed

• Moved Interface class to interface.py file
• Small refactor of Switch class.

Fixed

• Some bug fixes

[2017.2] - "chico" - 2017-12-21

Changed

• Web User Interface totally updated, with new design and functionality:
  • Visual elements reorganized for better experience.
  • Better information about switches and interfaces in the network.
  • Extending interface functionalities became easier.

[2017.2b2] - "chico" beta2 - 2017-12-01

Added

• @rest decorator can also be used before @classmethod or @staticmethod.
• Remove napp endpoints when a napp is disabled.
• TCP Server OpenFlow known ports.
• Config to allow other personalized protocol names on TCP Server.
• NNI and UNI attributes to Interface class.
• Interfaces to Switch json output.
• Statistics information for switch interfaces.
• Allow cross origin resource sharing (CORS).
• Now supports speed information from OF 1.3 switchs.
• Generate Events for reconnected switches.

Changed

• Dependency installation/update for devs: pip install -Ur requirements/dev.txt. To use cloned kytos repos as dependencies, reinstall those repos with pip install -e . in the end.
• Event name for a new switch. From kytos/core.switches.new to kytos/core.switch.new.

Removed

• Flow class from flow module. It was moved to kytos/of_core NApp.

Fixed

• Some bug fixes in tests.
• Several documentation fixes.
• Several bug fixes.
• Rest API prefix changed to "api/<username>/<nappname>".
• Now displays bandwidth values as bytes.
• Remove rest api endpoint when a NApp is disabled.
• Correctly update interface state and manage interfaces for switches.
• Some bug fixes.

[2017.2b1] - "chico" beta1 - 2017-09-19

Added

• @rest decorator for REST API methods. Examples:
  • @rest('flow/<flow_id>') (only GET HTTP method by default);
  • @rest('flows/', methods=['GET', 'POST']).
• Guide for developers in documentation.

Changed

• Whole documentation updated.
• API URLs renamed:
  • For NApps, the pattern is /api/<username>/<napp>/ + what is defined in @rest decorator;
  • Core endpoints starts with /api/kytos/core/. E.g. /kytos/config changed to /api/kytos/core/config.
• Improved load/unload of NApps.
• Requirements files updated and restructured.
• Yala substitutes Pylama as the main linter checker.

Deprecated

• Method register_rest_endpoint of Controller and APIServer in favor of @rest decorator.

Fixed

• Some bug fixes in tests.
• Several documentation fixes.
• Several bug fixes.

[2017.1] - "bethania" - 2017-07-06

Added

• NAppDirListener to manage (load/unload) NApps when they are enabled or disabled using kytos-utils.

Changed

• Improved connection management.
• Documentation updated and improved.
• Improved setup process.

Fixed

• Some bug fixes.

[2017.1b3] - "bethania" beta3 - 2017-06-16

Added

• Endpoint to display kytos configuration ('/kytos/config/').
• Setting to setup Kytos API Port on kytos.conf ('api_port' default to 8181).
• Documentation Blueprints tree.

Changed

• OpenFlow specific code moved to NApps: Kytos now acts as an all-purpose controller.
• Log manager refactored
• Improvements in the web interface style, layout and usability
• Setup process now requires pip
• Kytos documentation now shows a dropdown with each release documentation.

Fixed

• Web interface: - Fixed memory and CPU usage
• Now Kytos accepts to register different methods [POST, GET, etc] on the same endpoint.
• Now it's possible to start kytos in debug mode using kytosd -D.
• Removed documentation warnings.
• Several bug fixes

[2017.1b2] - "bethania" beta2 - 2017-05-05

Added

• Python bdist_wheel generation to make the install process via 'pip' easier and faster.
• Lockfile (PID-file) creation to prevent multiple instances running at the same time.
• Controller.restart method.
• kytos/tryfirst docker image was created and added to dockerhub.
• An improved console was added to execute python code when the controller is run in foreground.
• Continuous Integration with Code Quality Score and test coverage. (for the Python files in the project).
• Administration User Interface was moved to kytos, and it's accessible at port 8181 when kytos is running.
• Blueprints were moved to kytos/docs/blueprints folder.

Changed

• Updated requirements.txt.

• Improvements in TCP Server:

  • Now makes sure the switch is fully connected before accepting data.
  • Makes sure the switch is still connected before sending any data.
  • Uses sendall() to make sure data is being correctly sent.

• NApps module was refactored.
• Improved 'clean' option of setup.py.
• Improved tests and style checks for developers.
• Kytos setup process improved, reading necessary metadata before installing.
• Kytos core package was refactored.
• Documentation updates.
• NApp information is now obtained from kytos.json when loading a NApp.
• Improved log management.

Deprecated

• 'author' attribute, in the NApps context, was replaced by 'username' and will be removed in future releases.

Fixed

• Friendly messages are now displayed when some exceptions are raised.
• Kytos configuration is now loaded properly from kytos.conf
• Several adjustments and bug fixes.

[2017.1b1] - "bethania" beta1 - 2017-03-24

Added

• Data gathering from switches (i.e. interface speed)
• REST endpoints (i.e. REST API status)
• Sphinxs documentation

Changed

• Controller stop/start improvement
• Improved Controller's Rest API (using Flask)
• Connections, interfaces and switches management improvement
• Websocket to send logs to web interface
• Improved log management
• Corrections on setup and installation controller's code
• Improved NApps management - uninstall, disable and unload
• Improved controller's install and setup

[2016.1a1] - alpha1 - 2016-09-11

Added

• Bootstrapped initial architechture
• Kytos Events managing buffers and handlers
• NApp handling (load/unload/start/shutdown)
• TCPServer and TCPHandler
• Added basic config class