forked from jbarber/maui-admin-guide
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy path14.5troubleshootingclients.html
78 lines (56 loc) · 4.54 KB
/
14.5troubleshootingclients.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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy for Linux (vers 25 March 2009), see www.w3.org">
<title></title>
</head>
<body>
<div class="sright">
<div class="sub-content-head">
Maui Scheduler
</div>
<div id="sub-content-rpt" class="sub-content-rpt">
<div class="tab-container docs" id="tab-container">
<div class="topNav">
<div class="docsSearch"></div>
<div class="navIcons topIcons">
<a href="index.html"><img src="home.png" title="Home" alt="Home" border="0"></a> <a href="14.0troubleshootingandsysmaintenance.html"><img src="upArrow.png" title="Up" alt="Up" border="0"></a> <a href="14.4eventmgmt.html"><img src="prevArrow.png" title="Previous" alt="Previous" border="0"></a> <a href="14.6troubleshootingsystemerrors.html"><img src="nextArrow.png" title="Next" alt="Next" border="0"></a>
</div>
<h1>14.5 Issues with Client Commands</h1>
<p><b>Client Overview:</b></p>
<p>Maui clients are implemented as symbolic links to the executable <b>maui_client</b>. When a maui client command is run, the client executable determines the name under which it is run and behaves accordingly. At the time Maui was configured, a <i>home directory</i> was specified. The Maui client will attempt to open the config file <b>maui.cfg</b> in this home directory on the node where the client command is executed. This means that the home directory specified at configure time must be available on all hosts where the maui client commands will be executed. This also means that a <b>maui.cfg</b> file must be available in this directory. When the clients open this file, they will try to load the <b>MAUISERVER</b> and <b>MAUIPORT</b> parameters to determine how to contact the Maui server.</p>
<table class="note">
<tbody>
<tr>
<td class="noteIMG"><img src="note.png" title="Note" alt="Note"></td>
<td class="noteDetail">
The home directory value specified at configure time can be overridden by creating an <b>/etc/maui.cfg</b> file or by setting the '<b>MAUIHOMEDIR</b>' environment variable.
<p>Once the client has determined where the Maui server is located, it creates a message, adds an encrypted checksum, and sends the message to the server. Note that the Maui client and Maui server must use the same secret checksum seed for this to work. When the Maui server receives the client request and verifies the checksum, it processes the command and returns a reply.</p>
</td>
</tr>
</tbody>
</table>
<p><b>Diagnosing Client Problems:</b></p>
<p>The easiest way to determine where client failures are occurring is to utilize built in maui logging. On the client side, use the '<b>-L</b>' flag. For example,</p>
<p><tt>showq -L9</tt></p>
<p><b>NOTE</b>: Maui 3.0.6 and earlier specified the desired client side logging level using the '<b>-D</b>' flag (i.e., <tt>showq -D 9</tt>)<br></p>
<p>This will dump out a plethora of information about loading the configfile, connecting to the maui server, sending a request, and receiving a response. Wading through this information almost always will reveal the source of the problem. If it does not, the next step is to look at the maui server side logs. The easiest way to do this is to use the following steps:</p>
<p><tt>schedctl -s</tt><br>
(stop Maui scheduling so that the only activity is handling maui client requests)<br>
<tt>changeparam LOGLEVEL 7</tt><br>
(set the logging level to 'very verbose')<br>
<tt>tail -f log/maui.log | more</tt><br>
(tail the maui.log activity)</p>
<p>(In another window)</p>
<p><tt>showq</tt></p>
<p>The <b>maui.log</b> file should record the client request and any reasons it was rejected.</p>
<div class="navIcons bottomIcons">
<a href="index.html"><img src="home.png" title="Home" alt="Home" border="0"></a> <a href="14.0troubleshootingandsysmaintenance.html"><img src="upArrow.png" title="Up" alt="Up" border="0"></a> <a href="14.4eventmgmt.html"><img src="prevArrow.png" title="Previous" alt="Previous" border="0"></a> <a href="14.6troubleshootingsystemerrors.html"><img src="nextArrow.png" title="Next" alt="Next" border="0"></a>
</div>
</div>
</div>
</div>
<div class="sub-content-btm"></div>
</div>
</body>
</html>