<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.php"><img src="/resources/docs/images/home.png" title="Home" alt="Home" border="0"></a>
<a href="14.0troubleshootingandsysmaintenance.php"><img src="/resources/docs/images/upArrow.png" title="Up" alt="Up" border="0"></a>
<a href="14.4eventmgmt.php"><img src="/resources/docs/images/prevArrow.png" title="Previous" alt="Previous" border="0"></a>
<a href="14.6troubleshootingsystemerrors.php"><img src="/resources/docs/images/nextArrow.png" title="Next" alt="Next" border="0"></a>
</div>

<h1>14.5 Issues with Client Commands</h1>


<p><b>Client Overview:</b>
<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.

<table class="note">
  <tbody>
    <tr>
      <td class="noteIMG"><img src="/resources/docs/images/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.</td>
    </tr>
  </tbody>
</table>


<p><b>Diagnosing Client Problems:</b>
<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><tt> showq -L9</tt>
<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> 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><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>(In another window)
<p><tt> showq</tt>
<p> The <b>maui.log</b> file should record the client
request and any reasons it was rejected.


<div class="navIcons bottomIcons">
<a href="index.php"><img src="/resources/docs/images/home.png" title="Home" alt="Home" border="0"></a>
<a href="14.0troubleshootingandsysmaintenance.php"><img src="/resources/docs/images/upArrow.png" title="Up" alt="Up" border="0"></a>
<a href="14.4eventmgmt.php"><img src="/resources/docs/images/prevArrow.png" title="Previous" alt="Previous" border="0"></a>
<a href="14.6troubleshootingsystemerrors.php"><img src="/resources/docs/images/nextArrow.png" title="Next" alt="Next" border="0"></a>
</div>

 </div>
 </div>
  </div>
  <div class="sub-content-btm"></div>
</div>
</div>