diff options
author | stci <Stefan.Chiripuci@enea.com> | 2021-02-23 15:20:42 +0200 |
---|---|---|
committer | Miruna Paun <mrpa@enea.se> | 2021-02-24 11:53:04 +0100 |
commit | 334b8d1409ae039363038382423e01779e292484 (patch) | |
tree | 302455e6778b5a84fda8bb3bb40fe694385aeead | |
parent | 35b8406aa5eed1d598db530d9826475a63939fa1 (diff) | |
download | nfv-access-documentation-334b8d1409ae039363038382423e01779e292484.tar.gz |
Documentation for containerized grafana script update.
uCPE Manager Open Source Report for uCPEM and Grafana/Tools package.
Change-Id: Id5faf45c4934fc2b84bf9269195cf6da2e43b27d
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> |