Dependencies

Setting up the build environment

• ecfFlow consists of two tar files i.e.:  
  

  • boost_1_53_0.tar.gz

  • ecFlow-4.7.0-Source.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:

  tar -zxf boost_1_53_0.tar.gz tar -zxf ecFlow-4.7.0-Source.tar.gz

• You should have two directories created:

  boost_1_53_0 ecFlow-4.7.0-Source

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

   

  export WK=/tmp/ecflow_build/ecFlow-4.7.0-Source export BOOST_ROOT=/tmp/ecflow_build/boost_1_53_0

Build boost

• Boost uses bjam for building the boost libs.

  bjam source is available in boost, hence we first need to build bjam itself:

   

  cd $BOOST_ROOT ./bootstrap.sh

• For python3

  ./bootstrap.sh --with-python=/path/to/python3

  You may need to update $BOOST_ROOT/project-config.jam, with path to executable and path to include files. Note: remember to preserve the spaces, as they are significant. i.e.

  # using python # : # version # : # cmd-or-prefix # : # includes # : # libraries # : # condition # ; using python : 3.5 : python3 : /usr/local/apps/python3/3.5.1-01/include/python3.5m ;

• IF you do not require the ecflow python api, you can avoid building boost python libs by setting.

 export ECF_NO_PYTHON=1

Build

cmake

As configure, CMake  will run some tests on the customer's system to find out if required third-party software libraries are available and notes their locations (paths). Based on this information it will produces the Makefiles needed to compile and install ecflow

CMake is a cross-platform free software program for managing the build process of software using a compiler-independent method.

Generating the Makefiles with CMake

After changing into the build ecflow directory, the user  has to run CMake with his/her own options. The command gives feedback on what requirements are fulfilled and what software is still required. Table below gives an overview of the different options of configure.  The default (without any options) will  install in /usr/local/.

The  C++  compilers are chosen by CMake. (This can be overwritten by setting the environment variables CXX on the command line before you call cmake, to the preferred compiler).

Further the variable CMAKE_CXX_FLAGS can be used to set compiler flags for optimisation or debugging. 

cd $WK
mkdir build; cd build;

# Go with defaults, this should build with CMAKE_BUILD_TYPE=Release
cmake .. 

# build release with debug info  
# cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo

# Override install prefix, build the most optimised executables 
# cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local/apps/ecflow -DCMAKE_BUILD_TYPE=Release  

# do not build the gui.
# cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local/apps/ecflow -DCMAKE_BUILD_TYPE=Release -DENABLE_GUI=OFF

# If you do not need the python api, use:
# cmake .. -DENABLE_PYTHON=OFF

# Use -j option to speed up compilation. Determine number of cpu's
CPUS=$(lscpu -p | grep -v '#' | wc -l)
make -j${CPUS}
make check
make install

cd $WK
rm -rf build
mkdir build; cd build
cmake ..      # or use whatever cmake configuration you used before

To use the ecFlow Python Api , you need to add/change PYTHONPATH . 

export PYTHONPATH=$PYTHONPATH:<prefix>/4.7.0/lib/python2.7/site-packages/ecflow
# If you used the default's then <prefix>=/usr/local
# otherwise you should use whatever you entered for -DCMAKE_INSTALL_PREFIX, hence in the examples above we would have:
export PYTHONPATH=$PYTHONPATH:/usr/local/apps/ecflow/4.7.0/lib/python2.7/site-packages/ecflow 

cd $WK/build  # change to the build directory
cmake -DCMAKE_INSTALL_PREFIX=/tmp/avi/custom/ecflow/4.7.0 -DCOMPONENT=python -P cmake_install.cmake -- make install  # install python module under /tmp/avi/custom/ecflow/4.7.0

ecflow_ui: Make a list servers accessible to all users

The GUI used by ecflow is called ecflow_ui.  This is used to interact and visualize the ecflow servers.

You can make the list of servers available for your users by:

• creating a file called servers

• The format of the servers file is very easy:

  <server_name> <machine_name> <port>

  An example might be:

  server machineX 3141 projectX machineabc 4141 exp1 machineabc 4141 mars bigmac 11031

• Copy this file to CMAKE_INSTALL_PREFIX/share/ecflow/.   This makes the list of servers accessible to all users of ecflow_ui

  cp servers /tmp/avi/custom/ecflow/4.7.0/share/ecflow/.