summaryrefslogtreecommitdiffstats
path: root/doc/book-enea-edge-automation-user-guide/doc/getting_started.xml
diff options
context:
space:
mode:
authormrpa <miruna.paun@enea.com>2021-04-26 19:12:29 +0200
committerMiruna Paun <mrpa@enea.se>2021-04-27 09:39:56 +0100
commit9322aa7dd4fc6d0a81bb1e443cca724dfb49a1b7 (patch)
treec8e2121528e34d38c207c52cc7594bbb79e4c4e2 /doc/book-enea-edge-automation-user-guide/doc/getting_started.xml
parent13dbb438ecad3d66173994a2f300497a6d9d15c0 (diff)
downloadnfv-access-documentation-9322aa7dd4fc6d0a81bb1e443cca724dfb49a1b7.tar.gz
Updated the Makefile to include the AF UG and OSR from the feature
branch and added in the two books wholly. Change-Id: Ia0d2d6892c063b9e52b9abfe484de0fbdab6b924 Signed-off-by: mrpa <miruna.paun@enea.com>
Diffstat (limited to 'doc/book-enea-edge-automation-user-guide/doc/getting_started.xml')
-rw-r--r--doc/book-enea-edge-automation-user-guide/doc/getting_started.xml278
1 files changed, 278 insertions, 0 deletions
diff --git a/doc/book-enea-edge-automation-user-guide/doc/getting_started.xml b/doc/book-enea-edge-automation-user-guide/doc/getting_started.xml
new file mode 100644
index 0000000..27979cc
--- /dev/null
+++ b/doc/book-enea-edge-automation-user-guide/doc/getting_started.xml
@@ -0,0 +1,278 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="getting_started">
3 <title>Getting Started with Enea Edge Automation</title>
4
5 <section id="envrion">
6 <title>Environment</title>
7
8 <para>There are two scenarios for a proper setup:</para>
9
10 <itemizedlist spacing="compact">
11 <listitem>
12 <para>Basic Setup</para>
13
14 <figure>
15 <title>Lab setup overview for Basic Setup</title>
16
17 <mediaobject>
18 <imageobject>
19 <imagedata align="center" contentwidth="600"
20 fileref="images/environment_basicsetup.png" />
21 </imageobject>
22 </mediaobject>
23 </figure>
24 </listitem>
25
26 <listitem>
27 <para>Chained VNFs Service</para>
28
29 <figure>
30 <title>Lab Setup Overview for Chained VNFs Service</title>
31
32 <mediaobject>
33 <imageobject>
34 <imagedata align="center" contentwidth="600"
35 fileref="images/ChainedVNFsService_setup.png" />
36 </imageobject>
37 </mediaobject>
38 </figure>
39 </listitem>
40 </itemizedlist>
41
42 <para>The following environment setup is needed for running the Enea Edge Automation
43 tests:</para>
44
45 <itemizedlist>
46 <listitem>
47 <para>Lab Network Requirements:</para>
48
49 <itemizedlist spacing="compact">
50 <listitem>
51 <para>DHCP enabled</para>
52 </listitem>
53
54 <listitem>
55 <para>Internet connectivity</para>
56 </listitem>
57 </itemizedlist>
58 </listitem>
59
60 <listitem>
61 <para>Enea Edge Management Host Requirements:</para>
62
63 <itemizedlist spacing="compact">
64 <listitem>
65 <para>CentOS 7 installed</para>
66 </listitem>
67
68 <listitem>
69 <para>A connection to the Lab Network</para>
70 </listitem>
71
72 <listitem>
73 <para>The Enea Edge Management application installed. For details, see <olink
74 targetdoc="book_enea_edge_getting_started"
75 targetptr="install_ucpe_mg">Installing the Enea Edge Management application in the
76 <xi:include href="../../s_docbuild/olinkdb/pardoc-names.xml"
77 xmlns:xi="http://www.w3.org/2001/XInclude"
78 xpointer="element(book_enea_edge_getting_started/1)" /></olink>
79 Manual.</para>
80 </listitem>
81 </itemizedlist>
82 </listitem>
83
84 <listitem>
85 <para>uCPE device Requirements for Basic Setup:</para>
86
87 <itemizedlist spacing="compact">
88 <listitem>
89 <para>Minimum of 4 Physical Network Devices</para>
90 </listitem>
91
92 <listitem>
93 <para>4GB RAM and 4 cores (Intel C3000 or Xeon D)</para>
94 </listitem>
95
96 <listitem>
97 <para>2 Physical connections to the Lab Network</para>
98 </listitem>
99
100 <listitem>
101 <para>Enea Edge Runtime installed. For more
102 details, see <olink
103 targetdoc="book_enea_edge_getting_started"
104 targetptr="prep_usb_ena">Preparing the USB stick for
105 installation of the Enea Edge Runtime in the
106 <xi:include href="../../s_docbuild/olinkdb/pardoc-names.xml"
107 xmlns:xi="http://www.w3.org/2001/XInclude"
108 xpointer="element(book_enea_edge_getting_started/1)" /></olink>
109 Manual.</para>
110 </listitem>
111 </itemizedlist>
112 </listitem>
113
114 <listitem>
115 <para>uCPE device 1 and 2 Requirements for Chained VNFs
116 Service:</para>
117
118 <itemizedlist spacing="compact">
119 <listitem>
120 <para>Minimum of 4 Physical Network Devices</para>
121 </listitem>
122
123 <listitem>
124 <para>16GB RAM and 8 cores (Intel C3000 or Xeon D)</para>
125 </listitem>
126
127 <listitem>
128 <para>2 Physical connections to the Lab Network</para>
129 </listitem>
130
131 <listitem>
132 <para>1 Physical connection back to back between both uCPE
133 devices</para>
134 </listitem>
135
136 <listitem>
137 <para>Enea Edge Runtime installed</para>
138 </listitem>
139 </itemizedlist>
140 </listitem>
141 </itemizedlist>
142 </section>
143
144 <section id="prerequisites">
145 <title>Prerequisites</title>
146
147 <para>For the installation of the Enea Edge Automation a CentOS 7 host
148 machine is needed with support for:</para>
149
150 <itemizedlist>
151 <listitem>
152 <para>Python 3.6.8</para>
153 </listitem>
154
155 <listitem>
156 <para>EPEL Repository</para>
157
158 <programlisting>sudo yum install epel-release</programlisting>
159 </listitem>
160
161 <listitem>
162 <para>PIP package manager</para>
163
164 <programlisting>sudo yum -y install python-pip</programlisting>
165 </listitem>
166
167 <listitem>
168 <para>Virtualenv tool</para>
169
170 <programlisting>sudo pip install virtualenv</programlisting>
171 </listitem>
172 </itemizedlist>
173
174 <note>
175 <para>It is recommended to install Enea Edge Automation and the Enea Edge Management application
176 on different machines.</para>
177 </note>
178 </section>
179
180 <section id="initial_setup">
181 <title>Installing the Enea Edge Automation</title>
182
183 <para id="install_procedure"><emphasis role="bold">Installing the
184 Enea Edge Automation</emphasis></para>
185
186 <orderedlist>
187 <listitem>
188 <para>Log into the host machine</para>
189 </listitem>
190
191 <listitem>
192 <para><programlisting>cd &lt;AF-installdir&gt;</programlisting></para>
193 </listitem>
194
195 <listitem>
196 <para>Extract the archive file</para>
197
198 <programlisting>unzip Enea_Edge_Automation_&lt;version&gt;-build&lt;build_number&gt;.zip</programlisting>
199 </listitem>
200
201 <listitem>
202 <para>Run the setup of virtual environment script:</para>
203
204 <programlisting>source setup_env.sh</programlisting>
205 </listitem>
206
207 <listitem>
208 <para>Configure the system. For more details, see <xref
209 linkend="AFTH_cofig" />.</para>
210 </listitem>
211 </orderedlist>
212
213 <note>
214 <para>The steps are executed only once, for the initial setup of the
215 environment.</para>
216 </note>
217
218 <para><emphasis role="bold">Setting up the enviroment for the Enea Edge Automation</emphasis></para>
219
220 <orderedlist>
221 <listitem>
222 <para>Activate the Python virtual enviroment</para>
223
224 <programlisting>source &lt;AF-installdir&gt;/testHarness-venv/bin/activate</programlisting>
225 </listitem>
226
227 <listitem>
228 <para>Optionally, check the History Information</para>
229
230 <programlisting>vi &lt;AF-installdir&gt;/CHANGELOG</programlisting>
231 </listitem>
232
233 <listitem>
234 <para>Close the Python virtual environment</para>
235
236 <programlisting>deactivate</programlisting>
237 </listitem>
238 </orderedlist>
239 </section>
240
241 <section id="upgrade_AF">
242 <title>Upgrading the Enea Edge Automation</title>
243
244 <para><emphasis role="bold">Upgrading the Enea Edge Automation</emphasis></para>
245
246 <orderedlist>
247 <listitem>
248 <para>Log into the host machine</para>
249 </listitem>
250
251 <listitem>
252 <para><programlisting>cd &lt;AF-installdir&gt;</programlisting></para>
253 </listitem>
254
255 <listitem>
256 <para>Back up the configuration files from
257 <literal>modules/enea/config</literal>.</para>
258 </listitem>
259
260 <listitem>
261 <para>Extract the archive file:</para>
262
263 <programlisting>unzip Enea_Edge_Automation_&lt;version&gt;-build&lt;build_number&gt;.zip</programlisting>
264 </listitem>
265
266 <listitem>
267 <para>Restore the configuration files from step 2 into
268 <literal>modules/enea/config </literal>.</para>
269 </listitem>
270
271 <listitem>
272 <para>Run the setup of virtual environment script:</para>
273
274 <programlisting>source setup_env.sh</programlisting>
275 </listitem>
276 </orderedlist>
277 </section>
278</chapter> \ No newline at end of file
generated by cgit v1.2.3-54-g00ecf (git 2.39.0) at 2024-07-03 17:15:51 +0000