diff options
6 files changed, 21 insertions, 9 deletions
diff --git a/release-notes/asciidoc/Readme.adoc b/release-notes/asciidoc/Readme.adoc index d13917e88..064e0125f 100644 --- a/release-notes/asciidoc/Readme.adoc +++ b/release-notes/asciidoc/Readme.adoc @@ -1,3 +1,5 @@ = release-notes-aggregator -This module contains only release notes related documentation
\ No newline at end of file +This module contains only release notes related documentation. + +Full release notes can be found at link:release_notes.html[Release Notes] diff --git a/release-notes/src/main/asciidoc/devel_guide/devel_plugin_tutorial.adoc b/release-notes/src/main/asciidoc/devel_guide/devel_plugin_tutorial.adoc index 496ec55d1..1efa49f04 100644 --- a/release-notes/src/main/asciidoc/devel_guide/devel_plugin_tutorial.adoc +++ b/release-notes/src/main/asciidoc/devel_guide/devel_plugin_tutorial.adoc @@ -8,10 +8,12 @@ Since Honeycomb is a generic agent. Any plugin (translation code) can be injecte Honeycomb provides a maven archetype to generate a plugin skeleton. To use that archetype, run maven: +[subs="+attributes"] mvn -X archetype:generate -DarchetypeGroupId=io.fd.honeycomb.tools -DarchetypeArtifactId=honeycomb-plugin-archetype -DarchetypeVersion={project-version} Fill in the parameters e.g. +[subs="+attributes"] groupId: io.fd.honeycomb.tutorial artifactId: sample-plugin version: {project-version} @@ -202,7 +204,7 @@ A new maven module needs to be created. So in sample-plugin folder: Then create the pom: -[source,xml] +[source,xml,subs="+attributes"] ---- <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> @@ -330,8 +332,10 @@ tar.gz archive folder The distribution can be started by: +[subs="attributes"] sudo ./sample-distribution/target/sample-distribution-{project-version}-hc/sample-distribution-{project-version}/honeycomb -Note: honeycomb-start script is the background alternative + +NOTE: honeycomb-start script is the background alternative Honeycomb will display following message in the log: diff --git a/release-notes/src/main/asciidoc/devel_guide/devel_plugin_vpp_tutorial.adoc b/release-notes/src/main/asciidoc/devel_guide/devel_plugin_vpp_tutorial.adoc index 3f03c0b48..ee148e5e5 100644 --- a/release-notes/src/main/asciidoc/devel_guide/devel_plugin_vpp_tutorial.adoc +++ b/release-notes/src/main/asciidoc/devel_guide/devel_plugin_vpp_tutorial.adoc @@ -58,7 +58,7 @@ Now rebuild the *-api module. === JVpp dependency Another important thing that the plugin needs is dependency to VPP's JVpp (Java APIs). To do so, just update *-impl's pom.xml with: -[source,xml] +[source,xml,subs="+attributes"] ---- <!-- VPP's core Java APIs --> <dependency> @@ -70,7 +70,7 @@ Another important thing that the plugin needs is dependency to VPP's JVpp (Java Also add vpp-translate-utils dependency so that writing translation code is easier: -[source,xml] +[source,xml,subs="+attributes"] ---- <dependency> <groupId>io.fd.honeycomb.vpp</groupId> @@ -516,7 +516,8 @@ In order to add this new plugin into vpp-integration: * clone honeycomb codebase (since that's the home of vpp-integration distribution) * add a dependency for this sample plugin in vpp-integration distribution (honeycomb/vpp-integration/minimal-distribution/pom.xml): -[source,xml] + +[source,xml,subs="+attributes"] ---- <dependency> <groupId>io.fd.honeycomb.tutorial</groupId> @@ -524,6 +525,7 @@ In order to add this new plugin into vpp-integration: <version>{project-version}</version> </dependency> ---- + * modify Main of vpp-integration distribution to include sample-plugin (/home/mmarsale/Projects/honeycomb/vpp-integration/minimal-distribution/src/main/java/io/fd/honeycomb/vpp/integration/distro/Main.java): [source,java] ---- diff --git a/release-notes/src/main/asciidoc/install_guide/install_manual_build.adoc b/release-notes/src/main/asciidoc/install_guide/install_manual_build.adoc index 6fa4caa45..9248ddcfb 100644 --- a/release-notes/src/main/asciidoc/install_guide/install_manual_build.adoc +++ b/release-notes/src/main/asciidoc/install_guide/install_manual_build.adoc @@ -12,6 +12,7 @@ Building Honeycomb project requires: == Obtain the honeycomb source code TIP: Make sure you have https://wiki.fd.io/view/DEV/Setting_up_Gerrit[registered your ssh key with gerrit]. +[subs="+attributes"] git clone ssh://[username]@gerrit.fd.io:29418/honeycomb cd honeycomb git checkout {project-branch} @@ -42,6 +43,7 @@ Start VPP: Install JVpp into local maven repository to make Honeycomb pick up the same JVpp version +[subs="+attributes"] cd build-vpp-native/vpp-api/java/ mvn install:install-file -Dfile=jvpp-registry-{project-vpp-version}.jar -DgroupId=io.fd.vpp -DartifactId=jvpp-registry -Dversion={project-vpp-snapshot-version} -Dpackaging=jar mvn install:install-file -Dfile=jvpp-core-{project-vpp-version}.jar -DgroupId=io.fd.vpp -DartifactId=jvpp-core -Dversion={project-vpp-snapshot-version}-Dpackaging=jar @@ -172,7 +174,8 @@ cd honeycomb/ Now Honeycomb can be run with: - sudo sh vpp-integration/minimal-distribution/target/vpp-integration-distribution-1.16.9-SNAPSHOT-hc/vpp-integration-distribution-1.16.9-SNAPSHOT/honeycomb +[subs="+attributes"] + sudo sh vpp-integration/minimal-distribution/target/vpp-integration-distribution-{project-version}-hc/vpp-integration-distribution-{project-version}/honeycomb === Building packages After the code has been built, you can build an RPM or DEB package for honeycomb. diff --git a/release-notes/src/main/asciidoc/user_guide/user_guide.adoc b/release-notes/src/main/asciidoc/user_guide/user_guide.adoc index 494f2d241..7c7c4532d 100644 --- a/release-notes/src/main/asciidoc/user_guide/user_guide.adoc +++ b/release-notes/src/main/asciidoc/user_guide/user_guide.adoc @@ -15,7 +15,7 @@ Honeycomb's configuration files present within its distribution: * Honeycomb infra: ** {project-git-web}/infra/minimal-distribution/src/main/resources/honeycomb-minimal-resources/config/honeycomb.json?h={project-branch}[Honeycomb base configuration] * Honeycomb vpp plugins commons: -** {project-git-web}/vpp-common/minimal-distribution/src/main/resources/honeycomb-minimal-resources/config/jvpp.json?h={project-branch}[VPP plugins common configuration] +** {project-git-web}/vpp-common/vpp-common-integration/src/main/resources/honeycomb-minimal-resources/config/jvpp.json?h={project-branch}[VPP plugins common configuration] * V3PO plugin: ** {project-git-web}/v3po/v3po2vpp/src/main/resources/honeycomb-minimal-resources/config/v3po.json?h={project-branch}[V3PO plugin for Honeycomb configuration] * LISP plugin diff --git a/release-notes/src/main/asciidoc/user_guide/user_running_honeycomb.adoc b/release-notes/src/main/asciidoc/user_guide/user_running_honeycomb.adoc index 676bb1cdd..07b82a59f 100644 --- a/release-notes/src/main/asciidoc/user_guide/user_running_honeycomb.adoc +++ b/release-notes/src/main/asciidoc/user_guide/user_running_honeycomb.adoc @@ -5,6 +5,7 @@ link:release_notes.html[< Home] == Starting Honeycomb agent The zipped vpp-integration distribution can be started by invoking: +[subs="+attributes"] sudo ./vpp-integration-distribution-{project-version}/honeycomb This will start Honeycomb with all ODL dependencies and VPP translation code. It will automatically initialize vpp-jvpp to create interface between VPP and Honeycomb. @@ -98,7 +99,7 @@ A notification should appear in opened NETCONF session. ==== Testing over RESTCONF is easier, and common calls can be found in this postman collection: -*{project-git-web}/v3po/postman_rest_collection.json?h={project-branch}[V3PO postman collection][Honeycomb V3PO POSTMAN collection]* +* {project-git-web}/v3po/postman_rest_collection.json?h={project-branch}[V3PO postman collection][Honeycomb V3PO POSTMAN collection]* Each request in the collection contains equivalent VPP command (over CLI or VAT, whichever works) in the description. ==== |