Release notes for honeycomb for VPP 1.17.01. Based on VPP 17.01 and honeycomb 1.17.01.

1. Release plan

2. Features

Adding to the list of existing features: 1701 feature list:

2.2. Removed features

2.3. Modified features

  • ACL management improvements:

  • Previous ACL implementation that used classifier has been disabled in favor of implementation based on acl plugin (which provides also stateful acls)

2.4. Deprecated features

  • ACL management in terms of ietf-acl model based on vpp classifier

3. Backlog

Process of spiting honeycomb project into generic (honeycomb) and vpp related (hc2vpp) parts was done during 1.17.01 release. Issues for both projects were tracked in the same jira.

4. Install guide

Installing binaries:

4.1. Manual build

4.2. Distribution notes

Honeycomb is packaged as a static set of jars, that are loaded by Honeycomb Main class, where pre-configured plugins are then started.

4.3. Footprint

Minimal footprint for Honeycomb infrastructure (without any plugins) at rest below 100Mb. For Honeycomb distribution with VPP related plugins, minimal footprint was observed below 150Mb. The footprint varies depending on:

  • VM load. Under heavier load, JVM tends to release some unused memory used during Honeycomb initialization.

  • Northbound interface configuration (4 interfaces started by default: Restconf HTTP, HTTPS, Netconf TCP, SSH). Minimal footprint can be achieved by using only a single interface.

  • JVM configuration. Even lower footprint numbers can be achieved by using aggressive JVM memory options: -client -Xms20m -Xmx32m -XX:MetaspaceSize=5m -XX:MaxMetaspaceSize=32m -XX:MaxMetaspaceExpansion=1m -Xss512k -XX:+UseSerialGC -Djava.compiler=NONE -Xverify:none -noverify

  • Amount of data stored by Honeycomb.

5. User guide

5.1. Running Honeycomb

5.2. Troubleshooting

5.3. Honeycomb and ODL

5.4. Configuration files

Honeycomb’s configuration files present within its distribution:

5.5. YANG models

5.6. POSTMAN collections

6. Devel guide

Hc2vpp plugin development guide.

6.1. Tutorials

6.2. Samples