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>