Page History

<div class="section" id="starting-the-suite">
<span id="starting-suite"></span><span id="index-0"></span>
<p>The <strong>ecf_start</strong> script will automatically set up and start your <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-ecf-server"><em class="xref std std-term">ecf_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>
<p>To check the status of the server, type the following at the unix prompt:</p>
<div class="highlight-python"><pre>&gt; ecf_client --stats</pre>
</div>
<p>Examine the output. If the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-ecf-server"><em class="xref std std-term">ecf_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; ecf_client --restart</pre>
</div>
<p>Once the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-ecf-server"><em class="xref std std-term">ecf_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; ecf_client --begin test</pre>
</div>
<p>Restarting and begin&#8217;ing the suite can also be done with the <a class="reference internal" href="/wiki/display/ECFLOW/ecFlow+Python+Api#python-api"><em>ecFlow Python Api</em></a></p>
<div class="highlight-python"><div class="highlight"><pre><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="c"># Uses localhost:3141 by default</span>
<span class="k">try</span><span class="p">:</span>
   <span class="n">ci</span><span class="o">.</span><span class="n">restart_server</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="n">defs</span><span class="p">)</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>What to do:</p>
<ol class="arabic simple">
<li>Restart the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-ecf-server"><em class="xref std std-term">ecf_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>