Changes between Version 16 and Version 17 of doc/install/advanced


Ignore:
Timestamp:
Sep 27, 2021 3:36:20 PM (4 years ago)
Author:
knoop
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • doc/install/advanced

    v16 v17  
    77'''Before you start, please check if you have fulfilled all [wiki:doc/install installation requirements!]'''
    88
    9 The [wiki:doc/install/automatic automatic installer] normally cares for steps 1-5 that are described below. Failure of the automatic installation process is usually caused by inconsistencies in your software environment (e.g. mismatches between your compiler, NetCDF- and MPI- libraries) which will also cause failure of the manual installation. Anyhow, at least parts of the installation steps may be required to be carried out manually. For example, if your system has a very strict firewall and does not allow downloads from our repository, you may carry out the download (second step below) on a different system and copy the {{trunk}}} folder to your target system, before carrying on with the [wiki:doc/install/automatic automatic installer].
    10 
    11 Installation and configuration for batch jobs cannot be done by the [wiki:doc/install/automatic automatic installer] and requires manual work in any case, as described further below.
     9The install script that comes with the PALM Model System normally cares for steps 1-5 that are described below. Failure of the installation process is usually caused by inconsistencies in your software environment (e.g. mismatches between your compiler, NetCDF- and MPI- libraries) which will also cause failure of the manual installation. Anyhow, at least parts of the installation steps may be required to be carried out manually.
     10
     11Installation and configuration for batch jobs cannot be done by the install script and requires manual work in any case, as described further below.
    1212
    1313== [=#package_installation]First step: Package installation ==
     
    2222The names of these directories can be freely selected by adjusting the [wiki:doc/app/palm_config configuration file], however new users should choose them as suggested, since many examples in this documentation as well as all example files are based on these settings. The directory {{{~/palm/current_version}}} on the local host will be called the working directory from now on.\\\\
    2323
    24 In the '''second step''' a working copy of the recent PALM revision, including the source code, scripts, helper routines, etc.  must be copied to the working directory by entering the following commands. Replace {{{<your username>}}} by the name that you have chosen in the [https://palm.muk.uni-hannover.de/trac/register register form].
    25 {{{
    26   cd ~/palm/current_version
    27   svn checkout --username <your username> https://palm.muk.uni-hannover.de/svn/palm/trunk trunk
    28 }}}
    29 You will then be prompted for your password that you have set in the register form too. After completion, a subdirectory {{{trunk}}} should appear in your working directory. It contains a number of further subfolders, which contain e.g. the PALM source code ({{{SOURCE}}}) and the scripts for running PALM ({{{SCRIPTS}}}). '''Please never touch any file in your working copy of PALM, unless you know what you are doing.''' In case of any problems with the {{{svn checkout}}} command, the most probable reason are firewall settings on your system. Please check or ask your system administrator, if https-ports are open. \\\\
    30 
    31 The above {{{svn checkout}}} command provides you the most recent revision (developer version) of PALM. In case that you like to use a fixed release, please enter
    32 {{{
    33   svn checkout --username <your username> https://palm.muk.uni-hannover.de/svn/palm/tags/release-<#> trunk
    34 }}}
    35 where {{{<#>}}} can be any of the available PALM releases, e.g. "''5.0''". See the [wiki:doc/tec/releasenotes release notes] for a list of available releases. New releases will be announced via the PALM mailing list.
     24In the '''second step''' a copy of a recent PALM version, including the source code, scripts, helper routines, etc.  must be copied to the working directory. First you need to choose [https://gitlab.palm-model.org/releases/palm_model_system/-/releases PALM Releases] and download it. Please unpack the content of the downloaded archive, so that the {{{packages}}} directory, the {{{README.md}}} file and the {{{install}}} script are located inside the directory {{{~/palm/current_version/palm_model_system/}}}. '''Please never touch any file in your working copy of PALM, unless you know what you are doing.''' \\\\
    3625
    3726