ecFlow's documentation is now on readthedocs!

Please go to https://ecflow.readthedocs.io/en/latest/index.html

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 22 Next »

  • dependencies

    • python 2.7, Python 3.0 not tested.
      If you intend to use ecFlow Python api, You will need to install python.
      If python installed in non standard installation, you may need to
      customise $BOOST_ROOT/tools/build/v2/site-config.jam
      The python installation should include the development packages

    • Xlib for ecflowview

    ecfFlow consists of two tar files i.e. :

    • boost_1_47_0.tar.gz
    • ecflow_2_0_26.tar.gz

  • Create a directory for the build:

    > mkdir /tmp/ecflow_build

  • Copy the the two tar file into this directory, then change directory to /tmp/ecflow_build

  • Un-zip then un-tar the two file files:

    # gunzip boost_1_47_0.tar.gz
# gunzip ecflow_2_0_26.tar.gz
# tar -xf boost_1_47_0.tar
# tar -xf ecflow_2_0_26.tar

  • You should have two directories created:

    boost_1_47_0
ecflow_2_0_26

  • Create two environment variables. These are used by some of scripts:

    > export WK=/tmp/ecflow_build/ecflow_2_0_26
> export BOOST_ROOT=/tmp/ecflow_build/boost_1_47_0
  • For installation the following environment variables are required.
    ECFLOW_INSTALL_DIR         # Directory Location for client ,server and gui program's
ECFLOW_PYTHON_INSTALL_DIR  # Directory Location for ecflow python package

    The python installation can be customised, changing Pyext/jamfile.jam and site-config.jam

  • Boost uses bjam for build. ecFlow also uses bjam for build and installation
    bjam source is available in boost, hence we first need to build bjam itself
    > cd $BOOST_ROOT
> ./bootstrap.sh

    Now make sure bjam is accessible from $PATH

  • Ecflow uses some of compiled libraries in boost. The following script
    will build the required lib’s, in both debug and release forms
    and will configure boost build according to your platform
    > cd $BOOST_ROOT
> $WK/build/boost_1_47_fix.sh
> $WK/build/boost_build.sh

  • We now need to build ecFlow. Currently ecflowview is only built if the and environment variable of name ARCH is set to linux:

    > cd $WK
> bjam variant=release
    If you have a multi-core machine, you can speed up the build using:
    the -j<n> option. Where ‘n’ is an integer, of the number of cores.
    bjam variant=release -j4
  • Once ecFlow is built it can be installed.
    bjam variant=release install

    This will create directories:

    <ECFLOW_INSTALL_DIR>/bin
<ECFLOW_INSTALL_DIR>/lib
<ECFLOW_INSTALL_DIR>/doc
<ECFLOW_PYTHON_INSTALL_DIR>

    Depending on your umask setting you may need to call chmod 755 on the executables

  • To use the ecFlow Python Api, you need to add/change
    PYTHONPATH and LD_LIBRARY_PATH
    export PYTHONPATH=$PYTHONPATH:$ECFLOW_PYTHON_INSTALL_DIR
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ECFLOW_PYTHON_INSTALL_DIR
  • No labels