diff options
9 files changed, 414 insertions, 39 deletions
diff --git a/doc/Makefile b/doc/Makefile index 5a4d2b0..a0956d4 100644 --- a/doc/Makefile +++ b/doc/Makefile | |||
| @@ -50,7 +50,7 @@ DOCBOOK_TO_BOOKDIR ?= yes | |||
| 50 | DOCBOOK_CLEANTMP ?= yes | 50 | DOCBOOK_CLEANTMP ?= yes |
| 51 | 51 | ||
| 52 | #Components (books) in this subsystem. Now use all books found here | 52 | #Components (books) in this subsystem. Now use all books found here |
| 53 | COMPONENTS := book-enea-nfv-access-auto-fw-th-open-source book-enea-nfv-access-auto-fw-th-user-guide book-enea-nfv-access-cmc-example-usecases book-enea-nfv-access-example-usecases book-enea-nfv-access-getting-started book-enea-nfv-access-platform-open-source book-enea-nfv-access-getting-started book-enea-nfv-access-ucpem-open-source book-enea-nfv-access-release-info book-enea-nfv-access-system-test-specification book-enea-nfv-access-evalkit | 53 | COMPONENTS := book-enea-nfv-access-auto-fw-th-open-source book-enea-nfv-access-auto-fw-th-user-guide book-enea-nfv-access-cmc-example-usecases book-enea-nfv-access-example-usecases book-enea-nfv-access-getting-started book-enea-nfv-access-platform-open-source book-enea-nfv-access-getting-started book-enea-nfv-access-ucpem-open-source book-enea-nfv-access-telemetry-open-source book-enea-nfv-access-release-info book-enea-nfv-access-system-test-specification book-enea-nfv-access-evalkit |
| 54 | 54 | ||
| 55 | 55 | ||
| 56 | # -------------------------------------------------------------- | 56 | # -------------------------------------------------------------- |
diff --git a/doc/book-enea-nfv-access-getting-started/doc/grafana.xml b/doc/book-enea-nfv-access-getting-started/doc/grafana.xml index 33468f6..0da3855 100644 --- a/doc/book-enea-nfv-access-getting-started/doc/grafana.xml +++ b/doc/book-enea-nfv-access-getting-started/doc/grafana.xml | |||
| @@ -7,51 +7,88 @@ | |||
| 7 | Grafana is a very lightweight server-side application, and most of the | 7 | Grafana is a very lightweight server-side application, and most of the |
| 8 | monitoring runs in a browser.</para> | 8 | monitoring runs in a browser.</para> |
| 9 | 9 | ||
| 10 | <section id="grafana_deployment"> | 10 | <section id="telemetry_deployment"> |
| 11 | <title>Deploying Grafana and InfluxDB</title> | 11 | <title>Deploying Grafana and InfluxDB</title> |
| 12 | 12 | ||
| 13 | <para>Grafana and InfluxDB can be deployed using images for Docker on linux. | 13 | <para>Grafana and InfluxDB can be deployed using images for Docker on linux. |
| 14 | These images are provided by Enea along with a deploy script and | 14 | These images are provided by Enea along with a deploy script and |
| 15 | predefined dashboards.</para> | 15 | predefined dashboards.</para> |
| 16 | |||
| 17 | <para>Prerequisites for deploying an image:</para> | ||
| 18 | |||
| 19 | <itemizedlist> | ||
| 20 | <listitem> | ||
| 21 | <para>CentOS 7 Linux.</para> | ||
| 22 | </listitem> | ||
| 23 | 16 | ||
| 24 | <listitem> | 17 | <para>The Grafana and InfluxDB images can be deployed on the same machine |
| 25 | <para>Docker for CentOS 7 installed on the machine and set to | 18 | or on separate machines.</para> |
| 26 | <literal>autostart</literal> as a service.</para> | 19 | |
| 27 | </listitem> | 20 | <section id="prereq_deploy"> |
| 21 | <title>Prerequisites for Deploying an Image</title> | ||
| 28 | 22 | ||
| 29 | <listitem> | 23 | <para>The following must be present in order to deploy an image:</para> |
| 30 | <para>Superuser rights on the CentOS 7 machine.</para> | ||
| 31 | </listitem> | ||
| 32 | </itemizedlist> | ||
| 33 | |||
| 34 | <para>To deploy Grafana and InfluxDB run the provided | ||
| 35 | <filename>grafana_deploy.sh</filename> script as a superuser and follow | ||
| 36 | the instructions on screen.</para> | ||
| 37 | |||
| 38 | <para>The Grafana and InfluxDB images can also be deployed on separate machines. | ||
| 39 | The script will prompt the user to select which image to setup on the local | ||
| 40 | machine.</para> | ||
| 41 | |||
| 42 | <para>The deploy script loads the InfluxDB and Grafana images to Docker, | ||
| 43 | sets up the collected username and password, and runs the associated | ||
| 44 | containers. If there are already instances of the InfluxDB and Grafana images | ||
| 45 | running on the server, the deploy script will prompt the user to replace them. | ||
| 46 | The containers are setup to auto-start when the Docker service starts.</para> | ||
| 47 | |||
| 48 | <note> | ||
| 49 | <para>Changing the collected username and password requires redeploying | ||
| 50 | the InfluxDB image.</para> | ||
| 51 | </note> | ||
| 52 | 24 | ||
| 53 | </section> | 25 | <itemizedlist> |
| 54 | 26 | <listitem> | |
| 27 | <para>CentOS 7 Linux.</para> | ||
| 28 | </listitem> | ||
| 29 | |||
| 30 | <listitem> | ||
| 31 | <para>Docker for CentOS 7 installed on the machine and set to | ||
| 32 | <literal>autostart</literal> as a service.</para> | ||
| 33 | </listitem> | ||
| 34 | |||
| 35 | <listitem> | ||
| 36 | <para>Superuser rights on the CentOS 7 machine.</para> | ||
| 37 | </listitem> | ||
| 38 | </itemizedlist> | ||
| 39 | </section> | ||
| 40 | |||
| 41 | <section id="deploy_steps"> | ||
| 42 | <title>Deploying Grafana and InfluxDB</title> | ||
| 43 | |||
| 44 | <para>On the CentOS 7 server open a terminal, log into a bash shell | ||
| 45 | with the root account and perform the following:</para> | ||
| 46 | |||
| 47 | <orderedlist> | ||
| 48 | <listitem> | ||
| 49 | <para>Extract | ||
| 50 | <filename>Enea_NFV_Access_Telemetry_Deploy_<version>-build<build_number>.tar.gz</filename>.</para> | ||
| 51 | |||
| 52 | <para>The directory in which the archive will be unpacked will be | ||
| 53 | denoted as: <literal><Telemetry-installdir></literal>.</para> | ||
| 54 | </listitem> | ||
| 55 | |||
| 56 | <listitem> | ||
| 57 | <para>Enter <literal><Telemetry-installdir></literal>.</para> | ||
| 58 | </listitem> | ||
| 59 | |||
| 60 | <listitem> | ||
| 61 | <para>Run the provided <filename>telemetry_deploy.sh</filename> script.</para> | ||
| 62 | </listitem> | ||
| 63 | |||
| 64 | <listitem> | ||
| 65 | <para>When prompted, select what images you want to deploy.</para> | ||
| 66 | |||
| 67 | <para>If an image is already deployed, you will be prompted to replace it.</para> | ||
| 68 | </listitem> | ||
| 69 | |||
| 70 | <listitem> | ||
| 71 | <para>During the InfluxDB deployment, you will be prompted to provide | ||
| 72 | a username and password. These must match the ones configured in the | ||
| 73 | Enea uCPE Manager for Telemetry. | ||
| 74 | </para> | ||
| 75 | |||
| 76 | <note> | ||
| 77 | <para>Changing the InfluxDB username and password requires redeploying | ||
| 78 | the InfluxDB image.</para> | ||
| 79 | </note> | ||
| 80 | </listitem> | ||
| 81 | |||
| 82 | <listitem> | ||
| 83 | <para>Verify the installation by running the command <literal>docker ps -a</literal>. | ||
| 84 | The Grafana and InfluxDB containers should be present and have | ||
| 85 | the status <literal>Up</literal>. | ||
| 86 | </para> | ||
| 87 | </listitem> | ||
| 88 | </orderedlist> | ||
| 89 | </section> | ||
| 90 | </section> | ||
| 91 | |||
| 55 | <section id="grafana_settings"> | 92 | <section id="grafana_settings"> |
| 56 | <title>Setting Grafana and InfluxDB parameters</title> | 93 | <title>Setting Grafana and InfluxDB parameters</title> |
| 57 | 94 | ||
diff --git a/doc/book-enea-nfv-access-release-info/doc/main_changes.xml b/doc/book-enea-nfv-access-release-info/doc/main_changes.xml index eb057df..8d3e56c 100644 --- a/doc/book-enea-nfv-access-release-info/doc/main_changes.xml +++ b/doc/book-enea-nfv-access-release-info/doc/main_changes.xml | |||
| @@ -145,7 +145,7 @@ | |||
| 145 | </listitem> | 145 | </listitem> |
| 146 | 146 | ||
| 147 | <listitem> | 147 | <listitem> |
| 148 | <para>Enea NFV Access Telemetry Deploy Open Source Report.</para> | 148 | <para>Enea NFV Access Telemetry Open Source Report.</para> |
| 149 | </listitem> | 149 | </listitem> |
| 150 | </itemizedlist> | 150 | </itemizedlist> |
| 151 | </section> | 151 | </section> |
diff --git a/doc/book-enea-nfv-access-telemetry-open-source/doc/README b/doc/book-enea-nfv-access-telemetry-open-source/doc/README new file mode 100644 index 0000000..1077acb --- /dev/null +++ b/doc/book-enea-nfv-access-telemetry-open-source/doc/README | |||
| @@ -0,0 +1,4 @@ | |||
| 1 | The licenses.xml in the git repository of Enea NFV Access Open Source Report | ||
| 2 | is the frozen version belonging to the last official release of Enea NFV Access. | ||
| 3 | The contents must be generated from the release script to obtain the latest | ||
| 4 | lists of packages and licenses. | ||
diff --git a/doc/book-enea-nfv-access-telemetry-open-source/doc/about.xml b/doc/book-enea-nfv-access-telemetry-open-source/doc/about.xml new file mode 100644 index 0000000..781b0bd --- /dev/null +++ b/doc/book-enea-nfv-access-telemetry-open-source/doc/about.xml | |||
| @@ -0,0 +1,12 @@ | |||
| 1 | <?xml version="1.0" encoding="ISO-8859-1"?> | ||
| 2 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | ||
| 3 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | ||
| 4 | <chapter id="telemetry-open-source-packages-and-licenses"> | ||
| 5 | <title>About this Report</title> | ||
| 6 | |||
| 7 | <para>This document contains the open source and license information | ||
| 8 | pertaining to telemetry packages provided with Enea NFV Access <xi:include | ||
| 9 | href="../../s_doceneacommon/doc/eltf_params_updated.xml" | ||
| 10 | xmlns:xi="http://www.w3.org/2001/XInclude" | ||
| 11 | xpointer="element(EneaLinux_REL_VER/1)" />.</para> | ||
| 12 | </chapter> \ No newline at end of file | ||
diff --git a/doc/book-enea-nfv-access-telemetry-open-source/doc/book.xml b/doc/book-enea-nfv-access-telemetry-open-source/doc/book.xml new file mode 100644 index 0000000..b005dae --- /dev/null +++ b/doc/book-enea-nfv-access-telemetry-open-source/doc/book.xml | |||
| @@ -0,0 +1,15 @@ | |||
| 1 | <?xml version="1.0" encoding="ISO-8859-1"?> | ||
| 2 | <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | ||
| 3 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ | ||
| 4 | <!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED"> | ||
| 5 | ]> | ||
| 6 | <book id="book_enea_nfv_access_telemetry_open_source"> | ||
| 7 | <title><trademark class="registered">Enea</trademark> NFV Access Telemetry Open Source Report</title> | ||
| 8 | <subtitle>Release Version | ||
| 9 | <xi:include href="../../s_doceneacommon/doc/eltf_params_updated.xml" xpointer="element(EneaLinux_REL_VER/1)" | ||
| 10 | xmlns:xi="http://www.w3.org/2001/XInclude" /></subtitle> | ||
| 11 | <!-- OLINKDBPATH_USED_BY_XMLMIND ../../s_docbuild/olinkdb --> | ||
| 12 | <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> | ||
| 13 | <xi:include href="about.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> | ||
| 14 | <xi:include href="licenses.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> | ||
| 15 | </book> | ||
diff --git a/doc/book-enea-nfv-access-telemetry-open-source/doc/licenses.xml b/doc/book-enea-nfv-access-telemetry-open-source/doc/licenses.xml new file mode 100644 index 0000000..3cffaae --- /dev/null +++ b/doc/book-enea-nfv-access-telemetry-open-source/doc/licenses.xml | |||
| @@ -0,0 +1,290 @@ | |||
| 1 | <?xml version="1.0" encoding="UTF-8"?> | ||
| 2 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | ||
| 3 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | ||
| 4 | <chapter id="telemetry_packages"> | ||
| 5 | <title>Packages and Licenses</title> | ||
| 6 | <section id="telemetry_licenses_packages"> | ||
| 7 | |||
| 8 | <title>Packages</title> | ||
| 9 | |||
| 10 | |||
| 11 | <!--This chapter contains a generated list of all packages that Enea Linux | ||
| 12 | supports, e.g. busybox, with a short explanatory blurb and links to package | ||
| 13 | specific documentation.--> | ||
| 14 | |||
| 15 | <informaltable> | ||
| 16 | <tgroup cols="4"> | ||
| 17 | <colspec colwidth="2*"/> | ||
| 18 | <colspec colwidth="1*"/> | ||
| 19 | <colspec colwidth="5*"/> | ||
| 20 | <colspec colwidth="2*"/> | ||
| 21 | |||
| 22 | |||
| 23 | <thead> | ||
| 24 | <row> | ||
| 25 | <entry align="center">Package Name</entry> | ||
| 26 | <entry align="center">Version</entry> | ||
| 27 | <entry align="center">Description</entry> | ||
| 28 | <entry align="center">License</entry> | ||
| 29 | |||
| 30 | </row> | ||
| 31 | </thead> | ||
| 32 | |||
| 33 | <tbody valign="top"> | ||
| 34 | |||
| 35 | <row> | ||
| 36 | <entry><ulink url="https://www.influxdata.com/products/influxdb/">InfluxDB</ulink></entry> | ||
| 37 | <entry>1.3.7</entry> | ||
| 38 | <entry>InfluxDB database for Telemetry</entry> | ||
| 39 | <entry><ulink url="https://github.com/influxdata/influxdb/blob/master/LICENSE">MIT License</ulink></entry> | ||
| 40 | </row> | ||
| 41 | |||
| 42 | <row> | ||
| 43 | <entry><ulink url="https://grafana.com/grafana/">Grafana</ulink></entry> | ||
| 44 | <entry>4.6.3</entry> | ||
| 45 | <entry>Analytics and interactive visualization web application</entry> | ||
| 46 | <entry><ulink url="https://github.com/grafana/grafana/blob/master/LICENSE">Apache License 2.0</ulink></entry> | ||
| 47 | </row> | ||
| 48 | |||
| 49 | </tbody> | ||
| 50 | </tgroup> | ||
| 51 | </informaltable> | ||
| 52 | </section> | ||
| 53 | |||
| 54 | <section id="telemetry_open_source_license"> | ||
| 55 | <title>Open Source Licenses</title> | ||
| 56 | |||
| 57 | <section id="telemetry_lic_0"> | ||
| 58 | <title>InfluxDB</title> | ||
| 59 | <para><programlisting> | ||
| 60 | MIT License | ||
| 61 | |||
| 62 | Copyright (c) 2018 InfluxData | ||
| 63 | |||
| 64 | Permission is hereby granted, free of charge, to any person obtaining a copy | ||
| 65 | of this software and associated documentation files (the "Software"), to deal | ||
| 66 | in the Software without restriction, including without limitation the rights | ||
| 67 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
| 68 | copies of the Software, and to permit persons to whom the Software is | ||
| 69 | furnished to do so, subject to the following conditions: | ||
| 70 | |||
| 71 | The above copyright notice and this permission notice shall be included in all | ||
| 72 | copies or substantial portions of the Software. | ||
| 73 | |||
| 74 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
| 75 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
| 76 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
| 77 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
| 78 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
| 79 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
| 80 | SOFTWARE. | ||
| 81 | </programlisting></para></section> | ||
| 82 | |||
| 83 | <section id="telemetry_lic_1"> | ||
| 84 | <title>Grafana</title> | ||
| 85 | <para><programlisting> | ||
| 86 | |||
| 87 | Apache License | ||
| 88 | Version 2.0, January 2004 | ||
| 89 | http://www.apache.org/licenses/ | ||
| 90 | |||
| 91 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION | ||
| 92 | |||
| 93 | 1. Definitions. | ||
| 94 | |||
| 95 | "License" shall mean the terms and conditions for use, reproduction, | ||
| 96 | and distribution as defined by Sections 1 through 9 of this document. | ||
| 97 | |||
| 98 | "Licensor" shall mean the copyright owner or entity authorized by | ||
| 99 | the copyright owner that is granting the License. | ||
| 100 | |||
| 101 | "Legal Entity" shall mean the union of the acting entity and all | ||
| 102 | other entities that control, are controlled by, or are under common | ||
| 103 | control with that entity. For the purposes of this definition, | ||
| 104 | "control" means (i) the power, direct or indirect, to cause the | ||
| 105 | direction or management of such entity, whether by contract or | ||
| 106 | otherwise, or (ii) ownership of fifty percent (50%) or more of the | ||
| 107 | outstanding shares, or (iii) beneficial ownership of such entity. | ||
| 108 | |||
| 109 | "You" (or "Your") shall mean an individual or Legal Entity | ||
| 110 | exercising permissions granted by this License. | ||
| 111 | |||
| 112 | "Source" form shall mean the preferred form for making modifications, | ||
| 113 | including but not limited to software source code, documentation | ||
| 114 | source, and configuration files. | ||
| 115 | |||
| 116 | "Object" form shall mean any form resulting from mechanical | ||
| 117 | transformation or translation of a Source form, including but | ||
| 118 | not limited to compiled object code, generated documentation, | ||
| 119 | and conversions to other media types. | ||
| 120 | |||
| 121 | "Work" shall mean the work of authorship, whether in Source or | ||
| 122 | Object form, made available under the License, as indicated by a | ||
| 123 | copyright notice that is included in or attached to the work | ||
| 124 | (an example is provided in the Appendix below). | ||
| 125 | |||
| 126 | "Derivative Works" shall mean any work, whether in Source or Object | ||
| 127 | form, that is based on (or derived from) the Work and for which the | ||
| 128 | editorial revisions, annotations, elaborations, or other modifications | ||
| 129 | represent, as a whole, an original work of authorship. For the purposes | ||
| 130 | of this License, Derivative Works shall not include works that remain | ||
| 131 | separable from, or merely link (or bind by name) to the interfaces of, | ||
| 132 | the Work and Derivative Works thereof. | ||
| 133 | |||
| 134 | "Contribution" shall mean any work of authorship, including | ||
| 135 | the original version of the Work and any modifications or additions | ||
| 136 | to that Work or Derivative Works thereof, that is intentionally | ||
| 137 | submitted to Licensor for inclusion in the Work by the copyright owner | ||
| 138 | or by an individual or Legal Entity authorized to submit on behalf of | ||
| 139 | the copyright owner. For the purposes of this definition, "submitted" | ||
| 140 | means any form of electronic, verbal, or written communication sent | ||
| 141 | to the Licensor or its representatives, including but not limited to | ||
| 142 | communication on electronic mailing lists, source code control systems, | ||
| 143 | and issue tracking systems that are managed by, or on behalf of, the | ||
| 144 | Licensor for the purpose of discussing and improving the Work, but | ||
| 145 | excluding communication that is conspicuously marked or otherwise | ||
| 146 | designated in writing by the copyright owner as "Not a Contribution." | ||
| 147 | |||
| 148 | "Contributor" shall mean Licensor and any individual or Legal Entity | ||
| 149 | on behalf of whom a Contribution has been received by Licensor and | ||
| 150 | subsequently incorporated within the Work. | ||
| 151 | |||
| 152 | 2. Grant of Copyright License. Subject to the terms and conditions of | ||
| 153 | this License, each Contributor hereby grants to You a perpetual, | ||
| 154 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable | ||
| 155 | copyright license to reproduce, prepare Derivative Works of, | ||
| 156 | publicly display, publicly perform, sublicense, and distribute the | ||
| 157 | Work and such Derivative Works in Source or Object form. | ||
| 158 | |||
| 159 | 3. Grant of Patent License. Subject to the terms and conditions of | ||
| 160 | this License, each Contributor hereby grants to You a perpetual, | ||
| 161 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable | ||
| 162 | (except as stated in this section) patent license to make, have made, | ||
| 163 | use, offer to sell, sell, import, and otherwise transfer the Work, | ||
| 164 | where such license applies only to those patent claims licensable | ||
| 165 | by such Contributor that are necessarily infringed by their | ||
| 166 | Contribution(s) alone or by combination of their Contribution(s) | ||
| 167 | with the Work to which such Contribution(s) was submitted. If You | ||
| 168 | institute patent litigation against any entity (including a | ||
| 169 | cross-claim or counterclaim in a lawsuit) alleging that the Work | ||
| 170 | or a Contribution incorporated within the Work constitutes direct | ||
| 171 | or contributory patent infringement, then any patent licenses | ||
| 172 | granted to You under this License for that Work shall terminate | ||
| 173 | as of the date such litigation is filed. | ||
| 174 | |||
| 175 | 4. Redistribution. You may reproduce and distribute copies of the | ||
| 176 | Work or Derivative Works thereof in any medium, with or without | ||
| 177 | modifications, and in Source or Object form, provided that You | ||
| 178 | meet the following conditions: | ||
| 179 | |||
| 180 | (a) You must give any other recipients of the Work or | ||
| 181 | Derivative Works a copy of this License; and | ||
| 182 | |||
| 183 | (b) You must cause any modified files to carry prominent notices | ||
| 184 | stating that You changed the files; and | ||
| 185 | |||
| 186 | (c) You must retain, in the Source form of any Derivative Works | ||
| 187 | that You distribute, all copyright, patent, trademark, and | ||
| 188 | attribution notices from the Source form of the Work, | ||
| 189 | excluding those notices that do not pertain to any part of | ||
| 190 | the Derivative Works; and | ||
| 191 | |||
| 192 | (d) If the Work includes a "NOTICE" text file as part of its | ||
| 193 | distribution, then any Derivative Works that You distribute must | ||
| 194 | include a readable copy of the attribution notices contained | ||
| 195 | within such NOTICE file, excluding those notices that do not | ||
| 196 | pertain to any part of the Derivative Works, in at least one | ||
| 197 | of the following places: within a NOTICE text file distributed | ||
| 198 | as part of the Derivative Works; within the Source form or | ||
| 199 | documentation, if provided along with the Derivative Works; or, | ||
| 200 | within a display generated by the Derivative Works, if and | ||
| 201 | wherever such third-party notices normally appear. The contents | ||
| 202 | of the NOTICE file are for informational purposes only and | ||
| 203 | do not modify the License. You may add Your own attribution | ||
| 204 | notices within Derivative Works that You distribute, alongside | ||
| 205 | or as an addendum to the NOTICE text from the Work, provided | ||
| 206 | that such additional attribution notices cannot be construed | ||
| 207 | as modifying the License. | ||
| 208 | |||
| 209 | You may add Your own copyright statement to Your modifications and | ||
| 210 | may provide additional or different license terms and conditions | ||
| 211 | for use, reproduction, or distribution of Your modifications, or | ||
| 212 | for any such Derivative Works as a whole, provided Your use, | ||
| 213 | reproduction, and distribution of the Work otherwise complies with | ||
| 214 | the conditions stated in this License. | ||
| 215 | |||
| 216 | 5. Submission of Contributions. Unless You explicitly state otherwise, | ||
| 217 | any Contribution intentionally submitted for inclusion in the Work | ||
| 218 | by You to the Licensor shall be under the terms and conditions of | ||
| 219 | this License, without any additional terms or conditions. | ||
| 220 | Notwithstanding the above, nothing herein shall supersede or modify | ||
| 221 | the terms of any separate license agreement you may have executed | ||
| 222 | with Licensor regarding such Contributions. | ||
| 223 | |||
| 224 | 6. Trademarks. This License does not grant permission to use the trade | ||
| 225 | names, trademarks, service marks, or product names of the Licensor, | ||
| 226 | except as required for reasonable and customary use in describing the | ||
| 227 | origin of the Work and reproducing the content of the NOTICE file. | ||
| 228 | |||
| 229 | 7. Disclaimer of Warranty. Unless required by applicable law or | ||
| 230 | agreed to in writing, Licensor provides the Work (and each | ||
| 231 | Contributor provides its Contributions) on an "AS IS" BASIS, | ||
| 232 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or | ||
| 233 | implied, including, without limitation, any warranties or conditions | ||
| 234 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A | ||
| 235 | PARTICULAR PURPOSE. You are solely responsible for determining the | ||
| 236 | appropriateness of using or redistributing the Work and assume any | ||
| 237 | risks associated with Your exercise of permissions under this License. | ||
| 238 | |||
| 239 | 8. Limitation of Liability. In no event and under no legal theory, | ||
| 240 | whether in tort (including negligence), contract, or otherwise, | ||
| 241 | unless required by applicable law (such as deliberate and grossly | ||
| 242 | negligent acts) or agreed to in writing, shall any Contributor be | ||
| 243 | liable to You for damages, including any direct, indirect, special, | ||
| 244 | incidental, or consequential damages of any character arising as a | ||
| 245 | result of this License or out of the use or inability to use the | ||
| 246 | Work (including but not limited to damages for loss of goodwill, | ||
| 247 | work stoppage, computer failure or malfunction, or any and all | ||
| 248 | other commercial damages or losses), even if such Contributor | ||
| 249 | has been advised of the possibility of such damages. | ||
| 250 | |||
| 251 | 9. Accepting Warranty or Additional Liability. While redistributing | ||
| 252 | the Work or Derivative Works thereof, You may choose to offer, | ||
| 253 | and charge a fee for, acceptance of support, warranty, indemnity, | ||
| 254 | or other liability obligations and/or rights consistent with this | ||
| 255 | License. However, in accepting such obligations, You may act only | ||
| 256 | on Your own behalf and on Your sole responsibility, not on behalf | ||
| 257 | of any other Contributor, and only if You agree to indemnify, | ||
| 258 | defend, and hold each Contributor harmless for any liability | ||
| 259 | incurred by, or claims asserted against, such Contributor by reason | ||
| 260 | of your accepting any such warranty or additional liability. | ||
| 261 | |||
| 262 | END OF TERMS AND CONDITIONS | ||
| 263 | |||
| 264 | APPENDIX: How to apply the Apache License to your work. | ||
| 265 | |||
| 266 | To apply the Apache License to your work, attach the following | ||
| 267 | boilerplate notice, with the fields enclosed by brackets "[]" | ||
| 268 | replaced with your own identifying information. (Don't include | ||
| 269 | the brackets!) The text should be enclosed in the appropriate | ||
| 270 | comment syntax for the file format. We also recommend that a | ||
| 271 | file or class name and description of purpose be included on the | ||
| 272 | same "printed page" as the copyright notice for easier | ||
| 273 | identification within third-party archives. | ||
| 274 | |||
| 275 | Copyright 2015 Grafana Labs | ||
| 276 | |||
| 277 | Licensed under the Apache License, Version 2.0 (the "License"); | ||
| 278 | you may not use this file except in compliance with the License. | ||
| 279 | You may obtain a copy of the License at | ||
| 280 | |||
| 281 | http://www.apache.org/licenses/LICENSE-2.0 | ||
| 282 | |||
| 283 | Unless required by applicable law or agreed to in writing, software | ||
| 284 | distributed under the License is distributed on an "AS IS" BASIS, | ||
| 285 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
| 286 | See the License for the specific language governing permissions and | ||
| 287 | limitations under the License. | ||
| 288 | </programlisting></para></section> | ||
| 289 | </section> | ||
| 290 | </chapter> | ||
diff --git a/doc/book-enea-nfv-access-telemetry-open-source/swcomp.mk b/doc/book-enea-nfv-access-telemetry-open-source/swcomp.mk new file mode 100644 index 0000000..0314da2 --- /dev/null +++ b/doc/book-enea-nfv-access-telemetry-open-source/swcomp.mk | |||
| @@ -0,0 +1,10 @@ | |||
| 1 | # Component build specification | ||
| 2 | |||
| 3 | # Version of THIS book | ||
| 4 | BOOK_VER ?= $(REL_VER)-dev | ||
| 5 | |||
| 6 | DOCBOOK_SRC := $(COMP)/swcomp.mk $(COMP)/doc/book.xml $(shell find $(COMP)/doc -type f \( -name "*.xml" -o -name "*.svg" -o -name "*.png" \) ! -name "book.xml" -print) | ||
| 7 | |||
| 8 | BOOKPACKAGES := book-enea-nfv-access-telemetry-open-source | ||
| 9 | BOOKDESC_$(BOOKPACKAGES) := "Enea NFV Access Telemetry Open Source Report" | ||
| 10 | BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS) | ||
diff --git a/doc/book-enea-nfv-access-ucpem-open-source/doc/licenses.xml b/doc/book-enea-nfv-access-ucpem-open-source/doc/licenses.xml index 7ec52f3..9d5b5ff 100644 --- a/doc/book-enea-nfv-access-ucpem-open-source/doc/licenses.xml +++ b/doc/book-enea-nfv-access-ucpem-open-source/doc/licenses.xml | |||
| @@ -95,6 +95,13 @@ | |||
| 95 | <entry>Logging libraries</entry> | 95 | <entry>Logging libraries</entry> |
| 96 | <entry><ulink url="http://www.apache.org/licenses/">Apache 2.0</ulink></entry> | 96 | <entry><ulink url="http://www.apache.org/licenses/">Apache 2.0</ulink></entry> |
| 97 | </row> | 97 | </row> |
| 98 | |||
| 99 | <row> | ||
| 100 | <entry><ulink url="https://commons.apache.org/proper/commons-codec/">Apache Commons Codec</ulink></entry> | ||
| 101 | <entry>1.9</entry> | ||
| 102 | <entry>MD5 libraries</entry> | ||
| 103 | <entry><ulink url="http://www.apache.org/licenses/">Apache 2.0</ulink></entry> | ||
| 104 | </row> | ||
| 98 | 105 | ||
| 99 | <row> | 106 | <row> |
| 100 | <entry><ulink url="http://www.small-icons.com/packs/24x24-free-application-icons.htm">Application Icons</ulink></entry> | 107 | <entry><ulink url="http://www.small-icons.com/packs/24x24-free-application-icons.htm">Application Icons</ulink></entry> |
