Changeset 47be2684 in flex_extract.git for Documentation/html/Installation/local.html
- Timestamp:
- Oct 28, 2020, 10:28:24 AM (4 years ago)
- Branches:
- ctbto, dev
- Children:
- 75db9b0
- Parents:
- 697b8d0
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
Documentation/html/Installation/local.html
r73308e0 r47be2684 104 104 <li class="toctree-l4"><a class="reference internal" href="#testing-the-local-environment">Testing the local environment</a></li> 105 105 <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> 106 107 </ul> 107 108 </li> … … 395 396 <p>The Fortran program called <code class="docutils literal notranslate"><span class="pre">calc_etadot</span></code> will be compiled during the 396 397 installation process. A suitable makefile (<code class="docutils literal notranslate"><span class="pre">makefile_local_gfortran</span></code>) for the compilation is set by default. 397 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 .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>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> 399 400 For 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> 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> script401 <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 401 402 with an editor and adapt the installation parameters in the section labelled with 402 403 “AVAILABLE COMMANDLINE ARGUMENTS TO SET” as shown below:</p> 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>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> 405 406 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>... 406 407 <span class="c1"># -----------------------------------------------------------------</span> … … 416 417 <span class="nv">DESTINATION</span><span class="o">=</span>None 417 418 <span class="nv">INSTALLDIR</span><span class="o">=</span>None 419 <span class="nv">SYSINSTALLDIR</span><span class="o">=</span>None 418 420 <span class="nv">JOB_TEMPLATE</span><span class="o">=</span><span class="s1">''</span> 419 421 <span class="nv">CONTROLFILE</span><span class="o">=</span><span class="s1">'CONTROL_EA5'</span> … … 423 425 </div> 424 426 <p>Afterwards, type:</p> 425 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ./setup .sh427 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ./setup_local.sh 426 428 </pre></div> 427 429 </div> 428 430 <p>to start the installation. You should see the following standard output.</p> 429 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># Output of setup .sh</span>431 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># Output of setup_local.sh</span> 430 432 WARNING: installdir has not been specified 431 433 flex_extract will be installed in here by compiling the Fortran <span class="nb">source</span> in <path-to-flex_extract>/flex_extract_v7.1/Source/Fortran … … 446 448 </div> 447 449 </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 seperate 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">'syslocal'</span> 465 <span class="nv">MAKEFILE</span><span class="o">=</span><name_of_your_makefile> 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">''</span> 473 <span class="nv">CONTROLFILE</span><span class="o">=</span><span class="s1">'CONTROL_EA5'</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 <<span class="nv">$HOME</span>> 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> <username> tmc <span class="m">20</span> <span class="m">27</span>. Okt <span class="m">23</span>:25 ./calc_etadot -> 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 flex_extract_vX.X directory there.</p> 501 </div> 448 502 </div> 449 503
Note: See TracChangeset
for help on using the changeset viewer.