安装ecflow
==========


  * 下载最新版本的 `ecflow <https://confluence.ecmwf.int/display/ECFLOW>`_, 并按说明安装
  
  * 更新环境变量，测试安装是否成功

    .. code:: bash

      # add the following two lines to .cshrc or .bashrc

      setenv PATH /glade/work/xinzhang/repository/ecflow/bin:$PATH
      setenv PYTHONPATH $PYTHONPATH:/glade/work/xinzhang/repository/ecflow/lib/python3.7/site-packages/ecflow
      setenv ECF_HOST localhost
      setenv ECF_PORT 3141

    .. code-block:: bash

      $ source ~/.cshrc
      $ which ecflow_client
      /glade/work/xinzhang/repository/ecflow/bin/ecflow_client

  * 启动 :code:`ecflow`

    .. code-block:: bash

      ecflow/bin> ecflow_start.sh -p 3141
      [03:54:46 14.4.2020] Request( --ping :xinzhang ), Failed to connect to cheyenne4:3141. After 2 attempts. Is the server running ?

      cheyenne4 cheyenne4 3141
      grep: /glade/u/home/xinzhang/.ecflow_ui/servers.txt: No such file or directory
      /glade/work/xinzhang/repository/ecflow/bin/ecflow_start.sh: line 165: /glade/u/home/xinzhang/.ecflow_ui/servers.txt: No such file or directory
      Tue Apr 14 03:54:46 UTC 2020

      User "5591" attempting to start ecf server on "cheyenne4" using ECF_PORT "3141" and with:
      ECF_HOME     : "/glade/u/home/xinzhang/ecflow_server"
      ECF_LOG      : "cheyenne4.3141.ecf.log"
      ECF_CHECK    : "cheyenne4.3141.check"
      ECF_CHECKOLD : "cheyenne4.3141.check.b"
      ECF_OUT      : "/dev/null"

      client version is Ecflow version(4.17.2) boost(1.53.0) compiler(gcc 9.2.0) protocol(TEXT_ARCHIVE) Compiled on Apr 13 2020 21:33:14
      Checking if the server is already running on cheyenne4 and port 3141
      [03:54:47 14.4.2020] Request( --ping :xinzhang ), Failed to connect to cheyenne4:3141. After 2 attempts. Is the server running ?


      Backing up check point and log files

      OK starting ecFlow server...

      Placing server into RESTART mode...

      To view server on ecflow_ui - goto Servers/Manage Servers... and enter
      Name        : <unique ecFlow server name>
      Host        : cheyenne4
      Port Number : 3141

  * 测试 :code:`ecflow server` 是否启动

    .. code-block:: bash

      $ ecflow_client --ping
      ping server(localhost:3141) succeeded in 00:00:00.001513  ~1 milliseconds