<div class="section" id="starting-the-suite">
<span id="starting-suite"></span><span id="index-0"></span>
<p>The <strong>ecf_start.sh</strong> script will automatically set up and start your <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-ecflow-server"><em class="xref std std-term">ecflow_server</em></a>.</p>
<p>If you started an ecFlow manually then your server will start in a <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-halted"><em class="xref std std-term">halted</em></a> state.</p>
<p>In this case you you will have to &#8220;restart&#8221; your server before you can use it.</p>
<p>In a <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-halted"><em class="xref std std-term">halted</em></a> state the server will not schedule any tasks.</p>
<div class="section" id="text">
<h2>Text<a class="headerlink" href="#text" title="Permalink to this headline">¶</a></h2>
<p>To check the status of the server, type the following at the unix prompt:</p>
<div class="highlight-python"><pre>&gt; ecflow_client --stats</pre>
</div>
<p>Examine the output. If the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-ecflow-server"><em class="xref std std-term">ecflow_server</em></a> is <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-halted"><em class="xref std std-term">halted</em></a> you would restart with:</p>
<div class="highlight-python"><pre>&gt; ecflow_client --restart</pre>
</div>
<p>Once the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-ecflow-server"><em class="xref std std-term">ecflow_server</em></a> is <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-running"><em class="xref std std-term">running</em></a> you have to start the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-suite"><em class="xref std std-term">suite</em></a> by typing:</p>
<div class="highlight-python"><pre>&gt; ecflow_client --begin test</pre>
</div>
</div>
<div class="section" id="python">
<h2>Python<a class="headerlink" href="#python" title="Permalink to this headline">¶</a></h2>
<div class="line-block">
<div class="line">Restarting and begin&#8217;ing the suite can also be done with the <a class="reference internal" href="/wiki/display/ECFLOW/ecFlow+Python+Api#client-server-python-api"><em>client server python API</em></a>.</div>
<div class="line">Modify your <tt class="file docutils literal"><span class="pre">client.py</span></tt> file and then run it.</div>
</div>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">If you had previously loaded the suite, then comment out the ci.load(..) statement</p>
</div>
<div class="highlight-python"><div class="highlight"><pre><span class="c">#!/usr/bin/env python2.7</span>
<span class="kn">import</span> <span class="nn">ecflow</span> 
   
<span class="k">try</span><span class="p">:</span>
    <span class="k">print</span> <span class="s">&quot;Loading definition in &#39;test.def&#39; into the server&quot;</span>
    <span class="n">ci</span> <span class="o">=</span> <span class="n">ecflow</span><span class="o">.</span><span class="n">Client</span><span class="p">();</span>   
    <span class="n">ci</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="s">&quot;test.def&quot;</span><span class="p">)</span>      
    
    <span class="k">print</span> <span class="s">&quot;Restarting the server. This starts job scheduling&quot;</span>
    <span class="n">ci</span><span class="o">.</span><span class="n">restart_server</span><span class="p">()</span>      
    
    <span class="k">print</span> <span class="s">&quot;Begin the suite named &#39;test&#39;&quot;</span>     
    <span class="n">ci</span><span class="o">.</span><span class="n">begin_suite</span><span class="p">(</span><span class="s">&quot;test&quot;</span><span class="p">)</span>   
    
<span class="k">except</span> <span class="ne">RuntimeError</span><span class="p">,</span> <span class="n">e</span><span class="p">:</span>
    <span class="k">print</span> <span class="s">&quot;Failed: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">);</span> 
</pre></div>
</div>
<p><strong>What to do:</strong></p>
<ol class="arabic simple">
<li>Restart the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-ecflow-server"><em class="xref std std-term">ecflow_server</em></a></li>
<li>Begin the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-suite"><em class="xref std std-term">suite</em></a></li>
</ol>
</div>
</div>