forked from newfies-dialer/newfies-dialer-enterprise
-
Notifications
You must be signed in to change notification settings - Fork 0
/
troubleshooting.html
258 lines (247 loc) · 12.8 KB
/
troubleshooting.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Troubleshooting — Newfies-Dialer 3.0.4 documentation</title>
<link rel="stylesheet" href="_static/newfies-dialer.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '3.0.4',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="Newfies-Dialer 3.0.4 documentation" href="index.html" />
<link rel="next" title="Frequently Asked Questions" href="faq.html" />
<link rel="prev" title="SurveyTemplateSerializer" href="api-doc/survey_template_serializers.html" />
</head>
<body role="document">
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="faq.html" title="Frequently Asked Questions"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="api-doc/survey_template_serializers.html" title="SurveyTemplateSerializer"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">Newfies-Dialer 3.0.4 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="troubleshooting">
<span id="id1"></span><h1>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permalink to this headline">¶</a></h1>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#where-to-find-the-log-files" id="id4">Where to find the log files</a></li>
<li><a class="reference internal" href="#where-are-located-the-config-files" id="id5">Where are located the config files</a></li>
<li><a class="reference internal" href="#enable-the-debug" id="id6">Enable the debug</a></li>
<li><a class="reference internal" href="#how-to-run-a-quick-test-call" id="id7">How to run a quick test call</a></li>
<li><a class="reference internal" href="#run-in-debug-mode" id="id8">Run in debug mode</a></li>
<li><a class="reference internal" href="#celerymon" id="id9">Celerymon</a></li>
<li><a class="reference internal" href="#step-by-step-checklist" id="id10">Step By Step Checklist</a></li>
</ul>
</div>
<div class="section" id="where-to-find-the-log-files">
<span id="find-log-files"></span><h2><a class="toc-backref" href="#id4">Where to find the log files</a><a class="headerlink" href="#where-to-find-the-log-files" title="Permalink to this headline">¶</a></h2>
<p>All the logs are centralized into one single directory <strong>/var/log/newfies/</strong></p>
<p><strong>newfies-django-db.log</strong> : This contains all the Database queries performed by the UI</p>
<p><strong>newfies-django.log</strong> : All the logger events from Django</p>
<p><strong>err-apache-newfies.log</strong> : Any apache errors pertaining to Newfies-Dialer</p>
<p><strong>celery-newfies-node1.log</strong> : This contains celery activity</p>
<p><strong>newfieslua_logs_%%.log.log</strong> : This contains the phone system logs</p>
</div>
<div class="section" id="where-are-located-the-config-files">
<span id="config-files"></span><h2><a class="toc-backref" href="#id5">Where are located the config files</a><a class="headerlink" href="#where-are-located-the-config-files" title="Permalink to this headline">¶</a></h2>
<p>Newfies-Dialer configuration file is located by default at /usr/share/newfies-dialer/newfies_dialer/settings_local.py</p>
<p><cite>settings_local.py</cite> contains all the local changes specific to your installation, this file is inherited from /usr/share/newfies-dialer/newfies_dialer/settings.py, therefore you can copy settings to settings_local.py and overwrite the default configuration.</p>
</div>
<div class="section" id="enable-the-debug">
<span id="enable-debug"></span><h2><a class="toc-backref" href="#id6">Enable the debug</a><a class="headerlink" href="#enable-the-debug" title="Permalink to this headline">¶</a></h2>
<p>When you get a message “Server Error, You’ve encountered an error!”, you might want
to enable the debugger to get a full traceback of the error.</p>
<p>To enable the debugger, edit the file /usr/share/newfies-dialer/newfies_dialer/settings_local.py and set those settings as follow:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">DEBUG</span> <span class="o">=</span> <span class="bp">True</span>
<span class="n">TEMPLATE_DEBUG</span> <span class="o">=</span> <span class="n">DEBUG</span>
</pre></div>
</div>
<p>Note that you should be able to get the traceback in
<strong>/var/log/newfies/err-apache-newfies.log</strong></p>
</div>
<div class="section" id="how-to-run-a-quick-test-call">
<span id="run-quick-test-call"></span><h2><a class="toc-backref" href="#id7">How to run a quick test call</a><a class="headerlink" href="#how-to-run-a-quick-test-call" title="Permalink to this headline">¶</a></h2>
<p>Go on the admin panel and check if there is any call request that has been spooled.</p>
<blockquote>
<div><ul class="simple">
<li><a class="reference external" href="http:/">http:/</a>/<SERVER-IP>/admin/dialer_cdr/callrequest/</li>
</ul>
</div></blockquote>
<p>If there are no calls queued, this means that the campaign is not properly configured.</p>
<p>You should:</p>
<blockquote>
<div><ol class="arabic simple">
<li>Check if the campaign is started that the “Start time”, “Finish Time” and server time are correct.</li>
<li>Make sure that you configured a Dialer Setting for the user running the campaign, although there will be a warning for this on the Customer UI : <a class="reference external" href="http:/">http:/</a>/<SERVER-IP>/admin/dialer_settings/dialersetting/</li>
</ol>
</div></blockquote>
<p>If there is an existing Call Request, check the status, and check the Celery log stored in /var/log/newfies</p>
</div>
<div class="section" id="run-in-debug-mode">
<span id="run-debug-mode"></span><h2><a class="toc-backref" href="#id8">Run in debug mode</a><a class="headerlink" href="#run-in-debug-mode" title="Permalink to this headline">¶</a></h2>
<p>Make sure you stop the services first:</p>
<div class="highlight-python"><div class="highlight"><pre>$ /etc/init.d/newfies-celeryd stop
</pre></div>
</div>
<p>Then run in debug mode:</p>
<div class="highlight-python"><div class="highlight"><pre>$ workon newfies-dialer
$ cd /usr/share/newfies/
$ python manage.py celeryd -EB --loglevel=DEBUG
</pre></div>
</div>
</div>
<div class="section" id="celerymon">
<span id="id2"></span><h2><a class="toc-backref" href="#id9">Celerymon</a><a class="headerlink" href="#celerymon" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><a class="reference external" href="https://github.com/ask/celerymon">https://github.com/ask/celerymon</a></li>
</ul>
<p>Running the monitor :</p>
<dl class="docutils">
<dt>Start celery with the –events option on, so celery sends events for celerymon to capture::</dt>
<dd>$ workon newfies-dialer
$ cd /usr/share/newfies/
$ python manage.py celeryd -E</dd>
</dl>
<p>Run the monitor server:</p>
<div class="highlight-python"><div class="highlight"><pre>$ workon newfies-dialer
$ cd /usr/share/newfies/
$ python manage.py celerymon
</pre></div>
</div>
<p>However, in production you probably want to run the monitor in the background, as a daemon:</p>
<div class="highlight-python"><div class="highlight"><pre>$ workon newfies-dialer
$ cd /usr/share/newfies/
$ python manage.py celerymon --detach
</pre></div>
</div>
<p>For a complete listing of the command line arguments available, with a short
description, you can use the help command:</p>
<div class="highlight-python"><div class="highlight"><pre>$ workon newfies-dialer
$ cd /usr/share/newfies/
$ python manage.py help celerymon
</pre></div>
</div>
<p>Now you can visit the webserver celerymon starts by going to: <a class="reference external" href="http://localhost:8989">http://localhost:8989</a></p>
</div>
<div class="section" id="step-by-step-checklist">
<span id="id3"></span><h2><a class="toc-backref" href="#id10">Step By Step Checklist</a><a class="headerlink" href="#step-by-step-checklist" title="Permalink to this headline">¶</a></h2>
<p>The step by step checklist below should be used to validate that all components of the platform are running.</p>
<p>User interface :</p>
<blockquote>
<div><ul class="simple">
<li><ol class="first arabic">
<li>Dialer Gateway matching a configured trunk is set up in the UI</li>
</ol>
</li>
<li><ol class="first arabic" start="2">
<li>Dialer Settings configured and attached to the appropriate user</li>
</ol>
</li>
<li><ol class="first arabic" start="3">
<li>Phonebook Created with contacts attached to the phonebook</li>
</ol>
</li>
<li><ol class="first arabic" start="4">
<li>Configured voice application</li>
</ol>
</li>
<li><ol class="first arabic" start="5">
<li>Campaign created, and started, with a phone book attached, and the campaign schedule current</li>
</ol>
</li>
</ul>
</div></blockquote>
<p>Backend :</p>
<blockquote>
<div><ul class="simple">
<li><ol class="first arabic">
<li>Celery Monitor Running</li>
</ol>
</li>
<li><ol class="first arabic" start="2">
<li>Freeswitch running</li>
</ol>
</li>
</ul>
</div></blockquote>
<p>If there are still problems, then raise a support question on the mailing-list <a class="reference external" href="http://groups.google.com/group/newfies-dialer">http://groups.google.com/group/newfies-dialer</a> or our forum, <a class="reference external" href="http://forum.newfies-dialer.org/">http://forum.newfies-dialer.org/</a>, alternatively, contact <a class="reference external" href="mailto:newfies-dialer%40star2billing.com">newfies-dialer<span>@</span>star2billing<span>.</span>com</a> for commercial support.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper"><p class="logo"><a href="index.html">
<img class="logo" src="https://github.com/newfies-dialer/newfies-dialer/raw/develop/newfies/resources/images/newfies-dialer-180.png" alt="Logo"/>
</a></p>
<h4>Previous topic</h4>
<p class="topless"><a href="api-doc/survey_template_serializers.html"
title="previous chapter"><cite>SurveyTemplateSerializer</cite></a></p>
<h4>Next topic</h4>
<p class="topless"><a href="faq.html"
title="next chapter">Frequently Asked Questions</a></p>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="faq.html" title="Frequently Asked Questions"
>next</a> |</li>
<li class="right" >
<a href="api-doc/survey_template_serializers.html" title="SurveyTemplateSerializer"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">Newfies-Dialer 3.0.4 documentation</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2011-2015, Arezqui Belaid <info@star2billing.com>.
</div>
</body>
</html>