Ignore:
Timestamp:
Dec 19, 2019, 8:12:11 PM (4 years ago)
Author:
Anne Philipp <anne.philipp@…>
Branches:
master, ctbto, dev
Children:
e70c85f
Parents:
76c37a9
Message:

updated online docu

File:
1 edited

Legend:

Unmodified
Added
Removed

  • Documentation/html/_sources/Installation/remote.rst.txt

    r30f7911 rd720895  
    4242.. _ref-req-remote:
    4343 
    44 Remote environment requirements
    45 ===============================
     44Remote mode - dependencies
     45==========================
    4646
    47 The environment for ``flex_extract`` on ECMWF servers has to provide these
    48 software packages and libraries:
     47The following software is required, and already available at the ECMWF servers:
    4948   
    5049+---------------------------+-----------------+
    … …  
    6362==========================
    6463 
    65 The environment on the ECMWF server (such as *ecgate* or *cca*) is already
    66 prepared. ECMWF server provide all libraries via a module system which is
    67 going to be selected by ``flex_extract`` automatically.
     64ECMWF servers provide all libraries via a module system. Loading the required modules is already built into ``flex_extract`` and no user action is needed.
    6865
    6966
    … …  
    7370===================
    7471
    75 First, log in on one of the ECMWF Linux server, such as *ecgate* or *cca/ccb*.
     72First, log in on one of the ECMWF servers, such as *ecgate* or *cca/ccb*.
    7673Substitute *<ecuid>* with your ECMWF user name:
    7774
    … …  
    10198   ***************************************************************
    10299
    103    <ecuid>@131.130.157.5's password: ***
     100   <ecuid>@<ipname/address>'s password: ***
    104101   Select hostname (ecgate, cca, ccb) [ecgate]: ecgate
    105102
    106103   [<ecuid>@ecgb11 ~]$
    107104   
     105Substitute the *<localuser>* and *<localmachine.tld>* placeholders with your local user name and the IP name or address of your local machine.
     106Untar the file and change into the ``flex_extract`` root directory.
    108107   
    109 Then, copy the ``flex_extract`` tar ball (from section :ref:`ref-download`)
    110 to the ``$HOME`` directory of the ECMWF Linux server via ``scp``.
    111 Substitute the *<localuser>* and *<server.edu>* placeholders with your credentials.
    112 Untar the file and change into the ``flex_extract`` root directory.
    113 
    114108.. code-block:: bash
    115109
    116    scp <localuser>@<server.edu>:/path/to/tarfile/flex_extract_vX.X.tar.gz  $HOME/
     110   scp <localuser>@<localmachine.tld>:</path/to/tarfile/>flex_extract_vX.X.tar.gz  $HOME/
    117111   cd $HOME
    118112   tar xvf flex_extract_vX.X.tar.gz
    … …  
    120114   
    121115
    122 On these ECMWF servers, it is not necessary to prepare the environment or the
    123 ``Makefile`` for the Fortran program (``CONVERT2``) as described above.
    124 All third party libraries are available from a module system. The ``Makefile``
    125 is optimized for ECMWF servers and the compilation
    126 script ``compilejob.ksh``, which will be submitted by ``flex_extract`` to the
    127 batch job queue at ECMWF, does load all relevant modules from the ECMWF's module system.
    128 
    129 So there is just the need to execute the ``setup.sh`` script from the
    130 ``flex_extract`` root directory for installation.
     116   
     117Execute the ``setup.sh`` script from the ``flex_extract``'s root directory.
    131118Before executing it, it is necessary to adapt some parameters from ``setup.sh``
    132119described in :doc:`Documentation/Input/setup`.
    133120
    134 Open ``setup.sh`` with your editor and adapt the values: 
    135 
     121Open ``setup.sh`` with your preferred editor (e.g., ``nano'') and adapt the values: 
     122   
    136123+----------------------------------------------+----------------------------------------------+   
    137 |   Take this for target = **ectrans**         |  Take this for target = **cca**              |
     124|   Use this for target = **ectrans**          |   Use this for target = **cca**              |
    138125+----------------------------------------------+----------------------------------------------+
    139126| .. code-block:: bash                         | .. code-block:: bash                         |
    … …  
    158145
    159146:underline:`Please substitute the values of ECUID and ECGID
    160 with your own credentials and settings.`
     147with your own ones (look at any of your files with ``ls -l'' to see uid and gid).`
    161148
    162149.. note::
    163150
    164    If a local gateway server is available the transfer of files could be done
    165    via the ``ECaccess`` commands. Therefore a valid *GATEWAY* and *DESTINATION*
    166    have to be present and should be set in the ``setup.sh`` file.
    167 
     151   If a local gateway server is available, files can be transferred with ``ECaccess`` commands. In that case, a valid *GATEWAY* and *DESTINATION* have to be present in the ``setup.sh`` file (even if not used, the lines must not be deleted).
    168152
    169153Afterwards, type:
    … …  
    174158   ./setup.sh
    175159   
    176 to start the installation. You should see the following output at the command line.
     160to start the installation. You should see the following on standard output.
    177161   
    178162   
    … …  
    185169
    186170   
    187 The email content should look like this with a "SUCCESS" statement in the last line:
     171``Flex_extract`` uses the email address connectd to the user account on ECMWF servers. The email content should look like this with a "SUCCESS" statement in the last line:
    188172
    189173.. code-block:: bash
Note: See TracChangeset for help on using the changeset viewer.
hosted by ZAMG