Page History

<div class="section" id="install">
<span id="index-0"></span><span id="id1"></span>
<ul>
<li><p class="first">dependencies</p>
<blockquote>
<div><ul>
<li><div class="first line-block">
<div class="line">python, 2.1-2.7,  Python 3.0 not tested.</div>
<div class="line">If you intend to use ecFlow Python api, You will need to install python.</div>
<div class="line">If python installed in non standard installation, you may need to</div>
<div class="line">customise $BOOST_ROOT/tools/build/v2/site-config.jam</div>
</div>
</li>
<li><p class="first">Xlib for <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-ecflowview"><em class="xref std std-term">ecflowview</em></a></p>
</li>
</ul>
<p>ecfFlow consists of two tar files:</p>
<ul class="simple">
<li><tt class="file docutils literal"><span class="pre">boost_1_45_0.tar.gz</span></tt></li>
<li><tt class="file docutils literal"><span class="pre">ecflow_1_9_0.tar.gz</span></tt></li>
</ul>
</div></blockquote>
</li>
<li><p class="first">Create a directory for the build:</p>
<div class="highlight-python"><pre>&gt; mkdir /tmp/ecflow_build</pre>
</div>
</li>
<li><p class="first">Copy the the two tar file into this directory, then change directory to <tt class="file docutils literal"><span class="pre">/tmp/ecflow_build</span></tt></p>
</li>
<li><p class="first">Un-zip then un-tar the two file files:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="c"># gunzip boost_1_45_0.tar.gz</span>
<span class="c"># gunzip ecflow_1_9_0.tar.gz</span>
<span class="c"># tar -xf boost_1_45_0.tar</span>
<span class="c"># tar -xf ecflow_1_9_0.tar</span>
</pre></div>
</div>
</li>
<li><p class="first">You should have two directories created:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">boost_1_45_0</span>
<span class="n">ecflow_1_9_0</span>
</pre></div>
</div>
</li>
<li><p class="first">Create two environment variables. These are used by some of scripts:</p>
<div class="highlight-python"><pre>&gt; export WK=/tmp/ecflow_build/ecflow_1_9_0
&gt; export BOOST_ROOT=/tmp/ecflow_build/boost_1_45_0</pre>
</div>
</li>
<li><div class="first line-block">
<div class="line">Boost uses bjam for build.  ecFlow use bjam for build and installation</div>
<div class="line">bjam source is available in boost, hence we first need to build bjam itself</div>
</div>
<div class="highlight-python"><pre>&gt; cd $BOOST_ROOT
&gt; ./bootstrap.sh</pre>
</div>
<p>Now make sure bjam is accessible from $PATH</p>
</li>
<li><div class="first line-block">
<div class="line">Ecflow uses some of compiled libraries in boost. The following script</div>
<div class="line">will build the required lib&#8217;s, in both debug and release forms</div>
<div class="line">and will configure boost build according to your platform</div>
</div>
<div class="highlight-python"><pre>&gt; cd $BOOST_ROOT
&gt; $WK/build/build_boost.sh</pre>
</div>
</li>
<li><p class="first">We now need to build ecFlow:</p>
<div class="highlight-python"><pre>&gt; cd $WK
&gt; bjam variant=release</pre>
</div>
<div class="line-block">
<div class="line">If you have a multi-core machine, you can speed up the build using:</div>
<div class="line">the -j&lt;n&gt; option. Where &#8216;n&#8217; is an integer, of the number of cores.</div>
</div>
<div class="highlight-python"><pre>bjam variant=release -j4</pre>
</div>
</li>
<li><div class="first line-block">
<div class="line">Once ecFlow is built it can be installed.</div>
<div class="line">This requires the specification of a environment variables</div>
</div>
<div class="highlight-python"><div class="highlight"><pre><span class="n">ECFLOW_INSTALL_DIR</span>          <span class="c"># Directory Location for client ,server and gui program&#39;s</span>
</pre></div>
</div>
<p>Once these variable have been defined installation is done by calling:</p>
<div class="highlight-python"><pre>bjam variant=release install</pre>
</div>
<p>This will create directories:</p>
<div class="highlight-python"><pre>&lt;ECFLOW_INSTALL_DIR&gt;/bin
&lt;ECFLOW_INSTALL_DIR&gt;/lib
&lt;ECFLOW_INSTALL_DIR&gt;/doc</pre>
</div>
<p>Depending on your umask setting you may need to call chmod 755 on the executables</p>
</li>
<li><div class="first line-block">
<div class="line">To use the <a class="reference internal" href="/wiki/display/ECFLOW/ecFlow+Python+Api#python-api"><em>ecFlow Python Api</em></a>, you need to add/change</div>
<div class="line">PYTHONPATH and LD_LIBRARY_PATH</div>
</div>
<div class="highlight-python"><pre>export PYTHONPATH=$PYTHONPATH:$ECFLOW_INSTALL_DIR/lib
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ECFLOW_INSTALL_DIR/lib</pre>
</div>
</li>
</ul>
</div>