summaryrefslogtreecommitdiffstats
path: root/doc/book-enea-nfv-access-getting-started/doc/troubleshooting.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/book-enea-nfv-access-getting-started/doc/troubleshooting.xml')
-rw-r--r--doc/book-enea-nfv-access-getting-started/doc/troubleshooting.xml225
1 files changed, 0 insertions, 225 deletions
diff --git a/doc/book-enea-nfv-access-getting-started/doc/troubleshooting.xml b/doc/book-enea-nfv-access-getting-started/doc/troubleshooting.xml
deleted file mode 100644
index e176cec..0000000
--- a/doc/book-enea-nfv-access-getting-started/doc/troubleshooting.xml
+++ /dev/null
@@ -1,225 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="troubleshooting">
3 <title>Troubleshooting and Recovery</title>
4
5 <para>The following is a small list of possible Enea NFV Access problems,
6 and their solutions. <emphasis role="bold">In all scenarios collect the logs
7 if possible for debugging.</emphasis> More information on log collecting can
8 be found in <olink targetdoc="book_enea_nfv_access_getting_started"
9 targetptr="log_collector">Using the Log Collector in the <xi:include
10 href="../../s_docbuild/olinkdb/pardoc-names.xml"
11 xmlns:xi="http://www.w3.org/2001/XInclude"
12 xpointer="element(book_enea_nfv_access_getting_started/1)" /></olink>
13 Manual.</para>
14
15 <para>If you encounter other issues or can't get Enea NFV Access to work
16 successfully after consulting the information below, please use the <olink
17 targetdoc="book_enea_nfv_access_release_info"
18 targetptr="contacting_enea_support">Enea Support team Form, available in the
19 <xi:include href="../../s_docbuild/olinkdb/pardoc-names.xml"
20 xmlns:xi="http://www.w3.org/2001/XInclude"
21 xpointer="element(book_enea_nfv_access_release_info/1)" /></olink> Manual
22 downloaded with your release.</para>
23
24 <table>
25 <title>Troubleshooting and Recovery</title>
26
27 <tgroup cols="2">
28 <colspec align="left" />
29
30 <thead>
31 <row>
32 <entry align="center">Enea NFV Access Problem</entry>
33
34 <entry align="center">Solution</entry>
35 </row>
36 </thead>
37
38 <tbody>
39 <row>
40 <entry>A uCPE device fails to connect to the Enea uCPE Manager after
41 installation.</entry>
42
43 <entry>If the uCPE device is not able to connect to the Enea uCPE
44 Manager after an installation, the Web-installer application is
45 started automatically on the uCPE device to change the configuration
46 via a web browser. Please see <olink
47 targetdoc="book_enea_nfv_access_getting_started"
48 targetptr="boot_device_add_map">Booting the uCPE device and adding
49 it to the Map in the <xi:include
50 href="../../s_docbuild/olinkdb/pardoc-names.xml"
51 xmlns:xi="http://www.w3.org/2001/XInclude"
52 xpointer="element(book_enea_nfv_access_getting_started/1)" /></olink>
53 Manual.</entry>
54 </row>
55
56 <row>
57 <entry>The uCPE Device cannot boot after an upgrade.</entry>
58
59 <entry><orderedlist>
60 <listitem>
61 <para>Perform a hardware reboot of the uCPE Device and select
62 the previous Enea NFV Access image from the GRUB menu. This
63 action assumes physical access to the uCPE device.</para>
64 </listitem>
65
66 <listitem>
67 <para>Reinitiate the Upgrade procedure according to the steps
68 in section <olink
69 targetdoc="book_enea_nfv_access_getting_started"
70 targetptr="upgrade_devices">uCPE device upgrades in the
71 <xi:include href="../../s_docbuild/olinkdb/pardoc-names.xml"
72 xmlns:xi="http://www.w3.org/2001/XInclude"
73 xpointer="element(book_enea_nfv_access_getting_started/1)" /></olink>
74 Manual.</para>
75 </listitem>
76 </orderedlist></entry>
77 </row>
78
79 <row>
80 <entry>After a failed uCPE device upgrade the previous Enea NFV
81 Access image (from the GRUB menu) does not boot.</entry>
82
83 <entry>Reinstall Enea NFV Access on the uCPE device and redeploy the
84 initial configuration and virtualized services, by following the
85 steps in <olink targetdoc="book_enea_nfv_access_getting_started"
86 targetptr="install_ena_device">Installing Enea NFV Access - uCPE
87 Device installation in the <xi:include
88 href="../../s_docbuild/olinkdb/pardoc-names.xml"
89 xmlns:xi="http://www.w3.org/2001/XInclude"
90 xpointer="element(book_enea_nfv_access_getting_started/1)" /></olink>
91 Manual.</entry>
92 </row>
93
94 <row>
95 <entry>The Enea uCPE Manager upgrade fails and a working snapshot is
96 available.</entry>
97
98 <entry>If a working snapshot obtained during a previous Upgrade or
99 Uninstall is available
100 (<filename>ucpemanager-Backup-YYYYddMMHHmm.tar.gz</filename>):
101 <orderedlist>
102 <listitem>
103 <para>Cleanup the current upgrade attempt with:</para>
104
105 <programlisting>./cleanup.sh /opt/ems</programlisting>
106 </listitem>
107
108 <listitem>
109 <para>Restore the previous installation as described in <olink
110 targetdoc="book_enea_nfv_access_getting_started"
111 targetptr="restore_prev_ucpe_install">Restoring a previous
112 uCPE Manager installation in the <xi:include
113 href="../../s_docbuild/olinkdb/pardoc-names.xml"
114 xmlns:xi="http://www.w3.org/2001/XInclude"
115 xpointer="element(book_enea_nfv_access_getting_started/1)" /></olink>
116 Manual.</para>
117 </listitem>
118 </orderedlist></entry>
119 </row>
120
121 <row>
122 <entry>The Enea uCPE Manager upgrade fails and no working snapshot
123 is available, but a System Back-up file exists.</entry>
124
125 <entry><orderedlist>
126 <listitem>
127 <para>Cleanup the current upgrade attempt with:</para>
128
129 <programlisting>./cleanup.sh /opt/ems</programlisting>
130 </listitem>
131
132 <listitem>
133 <para>Perform an installation with the restore option of a
134 previous Enea uCPE Manager configuration as described in
135 <olink targetdoc="book_enea_nfv_access_getting_started"
136 targetptr="install_ucpemg_from_backup">Installation of the
137 uCPE Manager using a System Back-up in the <xi:include
138 href="../../s_docbuild/olinkdb/pardoc-names.xml"
139 xmlns:xi="http://www.w3.org/2001/XInclude"
140 xpointer="element(book_enea_nfv_access_getting_started/1)" /></olink>
141 Manual.</para>
142 </listitem>
143 </orderedlist></entry>
144 </row>
145
146 <row>
147 <entry>The uCPE device is booted, the ssh connection is available
148 but the device is not connected to the Enea uCPE Manager.</entry>
149
150 <entry><orderedlist>
151 <listitem>
152 <para>Perform a hardware reboot on the uCPE device to
153 reinitiate the connection mechanism.</para>
154 </listitem>
155
156 <listitem>
157 <para>Use the <literal>Reconnect</literal> button from the
158 Enea uCPE Manager's GUI.</para>
159 </listitem>
160
161 <listitem>
162 <para>Connect to uCPE Device console and run the factory reset
163 script:</para>
164
165 <programlisting>/usr/local/odm/bin/factory_reset.sh</programlisting>
166 </listitem>
167
168 <listitem>
169 <para>If the above actions do not work, reinstall and
170 reconfigure the device using the steps provided in <olink
171 targetdoc="book_enea_nfv_access_getting_started"
172 targetptr="install_ena_device">Installing Enea NFV Access -
173 uCPE Device installation in the <xi:include
174 href="../../s_docbuild/olinkdb/pardoc-names.xml"
175 xmlns:xi="http://www.w3.org/2001/XInclude"
176 xpointer="element(book_enea_nfv_access_getting_started/1)" /></olink>
177 Manual.</para>
178 </listitem>
179 </orderedlist></entry>
180 </row>
181
182 <row>
183 <entry>The SSH connection to the device cannot be
184 established.</entry>
185
186 <entry>Perform a hardware reboot on the uCPE device. If the problem
187 is not fixed, reinstall and reconfigure the device using the steps
188 provided in <olink targetdoc="book_enea_nfv_access_getting_started"
189 targetptr="install_ena_device">Installing Enea NFV Access - uCPE
190 Device installation in the <xi:include
191 href="../../s_docbuild/olinkdb/pardoc-names.xml"
192 xmlns:xi="http://www.w3.org/2001/XInclude"
193 xpointer="element(book_enea_nfv_access_getting_started/1)" /></olink>
194 Manual.</entry>
195 </row>
196
197 <row>
198 <entry>The VNF Service is not working as expected after
199 reconfiguration (e.g. a VNF chain is malfunctioning).</entry>
200
201 <entry><orderedlist>
202 <listitem>
203 <para>Undo all flows and/or configuration changes in order to
204 move the system to a previously working configuration.</para>
205 </listitem>
206
207 <listitem>
208 <para>Reboot the device using <literal>Operations</literal>
209 -&gt; <literal>Reboot</literal> menu options from within the
210 Enea uCPE Manager.</para>
211 </listitem>
212
213 <listitem>
214 <para>If the above actions do not work, redeploy all services.
215 This is done by cleaning up the existing configuration using:
216 <literal>Operations</literal> -&gt; <literal>Factory
217 Reset</literal> for a specific device and redeploying the VNF
218 services.</para>
219 </listitem>
220 </orderedlist></entry>
221 </row>
222 </tbody>
223 </tgroup>
224 </table>
225</chapter> \ No newline at end of file
generated by cgit v1.2.3-54-g00ecf (git 2.39.0) at 2025-07-09 10:48:30 +0000