Changes in Documentation/html/Installation/local.html [903ed4f:73308e0] in flex_extract.git
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
Documentation/html/Installation/local.html
r903ed4f r73308e0 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>107 106 </ul> 108 107 </li> … … 396 395 <p>The Fortran program called <code class="docutils literal notranslate"><span class="pre">calc_etadot</span></code> will be compiled during the 397 396 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. 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>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> 400 399 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> 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> script400 <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 402 401 with an editor and adapt the installation parameters in the section labelled with 403 402 “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> 406 405 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>... 407 406 <span class="c1"># -----------------------------------------------------------------</span> … … 417 416 <span class="nv">DESTINATION</span><span class="o">=</span>None 418 417 <span class="nv">INSTALLDIR</span><span class="o">=</span>None 419 <span class="nv">SYSINSTALLDIR</span><span class="o">=</span>None420 418 <span class="nv">JOB_TEMPLATE</span><span class="o">=</span><span class="s1">''</span> 421 419 <span class="nv">CONTROLFILE</span><span class="o">=</span><span class="s1">'CONTROL_EA5'</span> … … 425 423 </div> 426 424 <p>Afterwards, type:</p> 427 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ./setup _local.sh425 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ./setup.sh 428 426 </pre></div> 429 427 </div> 430 428 <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> 432 430 WARNING: installdir has not been specified 433 431 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 … … 448 446 </div> 449 447 </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">'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>None467 <span class="nv">ECGID</span><span class="o">=</span>None468 <span class="nv">GATEWAY</span><span class="o">=</span>None469 <span class="nv">DESTINATION</span><span class="o">=</span>None470 <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.sh480 </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.2485 486 Using makefile: makefile_local_gfortran487 /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.f90488 /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.f90489 /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.f90490 /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.f90491 /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.f90492 /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.f90493 /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 -fopenmp494 ln -sf calc_etadot_fast.out calc_etadot495 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.out497 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>502 448 </div> 503 449
Note: See TracChangeset
for help on using the changeset viewer.