Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed
  • Documentation/html/Installation/local.html

    r903ed4f r73308e0  
    104104<li class="toctree-l4"><a class="reference internal" href="#testing-the-local-environment">Testing the local environment</a></li>
    105105<li class="toctree-l4"><a class="reference internal" href="#local-installation">Local installation</a></li>
    106 <li class="toctree-l4"><a class="reference internal" href="#local-system-installation">Local system installation</a></li>
    107106</ul>
    108107</li>
     
    396395<p>The Fortran program called <code class="docutils literal notranslate"><span class="pre">calc_etadot</span></code> will be compiled during the
    397396installation process. A suitable makefile (<code class="docutils literal notranslate"><span class="pre">makefile_local_gfortran</span></code>) for the compilation is set by default.
    398 This may be overwritten by the <code class="docutils literal notranslate"><span class="pre">MAKEFILE</span></code> parameter in <code class="docutils literal notranslate"><span class="pre">setup_local.sh</span></code>.</p>
    399 <p>However, you may have to adapt the makefile for your environment (the current default makefile works on Debian stretch and similar GNU/Linux distributions). If you use a new name for it, you will have to insert it into <code class="docutils literal notranslate"><span class="pre">setup_local.sh</span></code>
     397This may be overwritten by the <code class="docutils literal notranslate"><span class="pre">MAKEFILE</span></code> parameter in <code class="docutils literal notranslate"><span class="pre">setup.sh</span></code>.</p>
     398<p>However, you may have to adapt the makefile for your environment (the current default makefile works on Debian stretch and similar GNU/Linux distributions). If you use a new name for it, you will have to insert it into <code class="docutils literal notranslate"><span class="pre">setup.sh</span></code>
    400399For details on the makefile and how to adapt them, see <a class="reference internal" href="../Documentation/Input/fortran_makefile.html#ref-convert"><span class="std std-ref">Fortran Makefile</span></a>.</p>
    401 <p>In the root directory of <code class="docutils literal notranslate"><span class="pre">flex_extract</span></code>, open the <code class="docutils literal notranslate"><span class="pre">setup_local.sh</span></code> script
     400<p>In the root directory of <code class="docutils literal notranslate"><span class="pre">flex_extract</span></code>, open the <code class="docutils literal notranslate"><span class="pre">setup.sh</span></code> script
    402401with an editor and adapt the installation parameters in the section labelled with
    403402“AVAILABLE COMMANDLINE ARGUMENTS TO SET” as shown below:</p>
    404 <div class="literal-block-wrapper docutils container" id="setup-local-sh">
    405 <div class="code-block-caption"><span class="caption-text">‘Example settings for a local installation.’</span><a class="headerlink" href="#setup-local-sh" title="Permalink to this code">¶</a></div>
     403<div class="literal-block-wrapper docutils container" id="setup-sh">
     404<div class="code-block-caption"><span class="caption-text">‘Example settings for a local installation.’</span><a class="headerlink" href="#setup-sh" title="Permalink to this code">¶</a></div>
    406405<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>...
    407406<span class="c1"># -----------------------------------------------------------------</span>
     
    417416<span class="nv">DESTINATION</span><span class="o">=</span>None
    418417<span class="nv">INSTALLDIR</span><span class="o">=</span>None
    419 <span class="nv">SYSINSTALLDIR</span><span class="o">=</span>None
    420418<span class="nv">JOB_TEMPLATE</span><span class="o">=</span><span class="s1">&#39;&#39;</span>
    421419<span class="nv">CONTROLFILE</span><span class="o">=</span><span class="s1">&#39;CONTROL_EA5&#39;</span>
     
    425423</div>
    426424<p>Afterwards, type:</p>
    427 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ./setup_local.sh
     425<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ./setup.sh
    428426</pre></div>
    429427</div>
    430428<p>to start the installation. You should see the following standard output.</p>
    431 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># Output of setup_local.sh</span>
     429<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># Output of setup.sh</span>
    432430WARNING: installdir has not been specified
    433431flex_extract will be installed in here by compiling the Fortran <span class="nb">source</span> in &lt;path-to-flex_extract&gt;/flex_extract_v7.1/Source/Fortran
     
    448446</div>
    449447</div>
    450 <div class="section" id="local-system-installation">
    451 <h2>Local system installation<a class="headerlink" href="#local-system-installation" title="Permalink to this headline">¶</a></h2>
    452 <p>There is also the possibility to separate the software executables from the user application files. For doing so, the <code class="docutils literal notranslate"><span class="pre">TARGET</span></code> parameter can be set to “syslocal” and the additional parameter <code class="docutils literal notranslate"><span class="pre">SYSINSTALLDIR</span></code> in the <code class="docutils literal notranslate"><span class="pre">setup_local.sh</span></code> has to be specified. This new path will contain the Fortran and Python executables of <code class="docutils literal notranslate"><span class="pre">flex_extract</span></code>. If you chose to set a system path for this, please start the script as root.
    453 The user directory for <code class="docutils literal notranslate"><span class="pre">flex_extract</span></code>, which basically consists of everything except the <code class="docutils literal notranslate"><span class="pre">Source</span></code> directory, will be installed into <code class="docutils literal notranslate"><span class="pre">INSTALLDIR</span></code>.
    454 In this installation mode, an extra (hidden) <code class="docutils literal notranslate"><span class="pre">.setup.rc</span></code> file will be generated in the <code class="docutils literal notranslate"><span class="pre">Run</span></code> directory. It contains the necessary settings for running the local system mode.</p>
    455 <p>Despite the change in the <code class="docutils literal notranslate"><span class="pre">TARGET</span></code> parameter, the meaning of <code class="docutils literal notranslate"><span class="pre">INSTALLDIR</span></code> and the additional <code class="docutils literal notranslate"><span class="pre">SYSINSTALLDIR</span></code>, the steps for installation are the same as in the local installation mentioned above. For example, modify the <code class="docutils literal notranslate"><span class="pre">setup_local.sh</span></code> file as follows:</p>
    456 <div class="literal-block-wrapper docutils container" id="id1">
    457 <div class="code-block-caption"><span class="caption-text">‘Example settings for a local system installation.’</span><a class="headerlink" href="#id1" title="Permalink to this code">¶</a></div>
    458 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>...
    459 <span class="c1"># -----------------------------------------------------------------</span>
    460 <span class="c1"># AVAILABLE COMMANDLINE ARGUMENTS TO SET</span>
    461 <span class="c1">#</span>
    462 <span class="c1"># THE USER HAS TO SPECIFY THESE PARAMETER</span>
    463 <span class="c1">#</span>
    464 <span class="nv">TARGET</span><span class="o">=</span><span class="s1">&#39;syslocal&#39;</span>
    465 <span class="nv">MAKEFILE</span><span class="o">=</span>&lt;name_of_your_makefile&gt;
    466 <span class="nv">ECUID</span><span class="o">=</span>None
    467 <span class="nv">ECGID</span><span class="o">=</span>None
    468 <span class="nv">GATEWAY</span><span class="o">=</span>None
    469 <span class="nv">DESTINATION</span><span class="o">=</span>None
    470 <span class="nv">INSTALLDIR</span><span class="o">=</span><span class="nv">$HOME</span>
    471 <span class="nv">SYSINSTALLDIR</span><span class="o">=</span>/usr/bin/
    472 <span class="nv">JOB_TEMPLATE</span><span class="o">=</span><span class="s1">&#39;&#39;</span>
    473 <span class="nv">CONTROLFILE</span><span class="o">=</span><span class="s1">&#39;CONTROL_EA5&#39;</span>
    474 ...
    475 </pre></div>
    476 </div>
    477 </div>
    478 <p>Afterwards, type:</p>
    479 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ sudo ./setup_local.sh
    480 </pre></div>
    481 </div>
    482 <p>to start the installation. You should see the following standard output.</p>
    483 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>Flex_extract will be installed in &lt;<span class="nv">$HOME</span>&gt;
    484 Install flex_extract_v7.1.2 software as syslocal in directory /usr/bin/flex_extract_v7.1.2
    485 
    486 Using makefile: makefile_local_gfortran
    487 /usr/local/bin/gfortran   -O3 -march<span class="o">=</span>native -L/usr/local/lib64/ -leccodes_f90 -leccodes -lm -lemosR64 -I. -I/usr/local/include/ -fdefault-real-8 -fopenmp -fconvert<span class="o">=</span>big-endian   -c     ./rwgrib2.f90
    488 /usr/local/bin/gfortran   -O3 -march<span class="o">=</span>native -L/usr/local/lib64/ -leccodes_f90 -leccodes -lm -lemosR64 -I. -I/usr/local/include/ -fdefault-real-8 -fopenmp -fconvert<span class="o">=</span>big-endian   -c     ./phgrreal.f90
    489 /usr/local/bin/gfortran   -O3 -march<span class="o">=</span>native -L/usr/local/lib64/ -leccodes_f90 -leccodes -lm -lemosR64 -I. -I/usr/local/include/ -fdefault-real-8 -fopenmp -fconvert<span class="o">=</span>big-endian   -c     ./grphreal.f90
    490 /usr/local/bin/gfortran   -O3 -march<span class="o">=</span>native -L/usr/local/lib64/ -leccodes_f90 -leccodes -lm -lemosR64 -I. -I/usr/local/include/ -fdefault-real-8 -fopenmp -fconvert<span class="o">=</span>big-endian   -c     ./ftrafo.f90
    491 /usr/local/bin/gfortran   -O3 -march<span class="o">=</span>native -L/usr/local/lib64/ -leccodes_f90 -leccodes -lm -lemosR64 -I. -I/usr/local/include/ -fdefault-real-8 -fopenmp -fconvert<span class="o">=</span>big-endian   -c     ./calc_etadot.f90
    492 /usr/local/bin/gfortran   -O3 -march<span class="o">=</span>native -L/usr/local/lib64/ -leccodes_f90 -leccodes -lm -lemosR64 -I. -I/usr/local/include/ -fdefault-real-8 -fopenmp -fconvert<span class="o">=</span>big-endian   -c     ./posnam.f90
    493 /usr/local/bin/gfortran  rwgrib2.o calc_etadot.o ftrafo.o grphreal.o posnam.o phgrreal.o -o calc_etadot_fast.out  -O3 -march<span class="o">=</span>native -L/usr/local/lib64/ -leccodes_f90 -leccodes -lm -lemosR64 -fopenmp
    494 ln -sf calc_etadot_fast.out calc_etadot
    495 
    496 lrwxrwxrwx. <span class="m">1</span> &lt;username&gt; tmc <span class="m">20</span> <span class="m">27</span>. Okt <span class="m">23</span>:25 ./calc_etadot -&gt; calc_etadot_fast.out
    497 SUCCESS: INSTALLATION FINISHED!
    498 </pre></div>
    499 </div>
    500 <p>You can now change into the user directory specified in <code class="docutils literal notranslate"><span class="pre">INSTALLDIR</span></code> and find a <code class="docutils literal notranslate"><span class="pre">flex_extract_vX.X</span></code> directory there.</p>
    501 </div>
    502448</div>
    503449
Note: See TracChangeset for help on using the changeset viewer.
hosted by ZAMG