Changes between Version 93 and Version 94 of doc/install

Timestamp:

Sep 4, 2018 8:09:25 AM (6 years ago)

Author:

raasch

Comment:

--

doc/install

@@ -10 +10 @@
 [[TracNav(doc/install/toc)]]
 
-This page describes the installation of PALM on a Linux system. In this installation description we differentiate heavily between two perspectives on a computer. The first is the local computer (or local host), which is the computer that you are currently sitting at or are logged in via your terminal (ssh). The second is the remote computer (or remote host), which is any computer with a batch system, that you have ssh access to, but are not logged in at the moment. A typical remote computer is your favorite high performance computing (HPC) facility aka supercomputer. This perspective includes, that your remote (super)computer immediately becomes your local computer as soon as you log into it via ssh.\\\\
-There are three methods to install and run PALM (before you start, please read the [#requirements software requirements]):
+This page gives a brief overview of available installation methods of PALM on a Linux system. Here we differentiate between two perspectives on a computer. The first is the local computer (or local host), which is the computer that you are currently sitting at or are logged in via your terminal (ssh). The second is the remote computer (or remote host), which is any computer with a batch system, that you have {{{ssh}}} access to, but are not logged in at the moment. A typical remote computer is your favorite high performance computing (HPC) facility aka supercomputer. This perspective includes, that your remote (super)computer immediately becomes your local computer as soon as you log into it via {{{ssh}}}.\\\\
+
+There are three methods to install and run PALM on Linux/UNIX systems (before you start, please read the [#requirements software requirements]):
 
  - [wiki:doc/install/automatic An automatic installer].
- - [wiki:doc/install/simple A simple manual installation method].
- - [wiki:doc/install/advanced An advanced manual installation method].
+ - [wiki:doc/install/advanced A full manual installation].
+ - [wiki:doc/install/simple A reduced manual installation method for benchmarks].
 
-With the '''automatic installer''' and the '''simple installation method''', you can just run PALM interactively on the local computer. They do not allow to setup the creation of batch jobs and restart runs on any remote computer. This method is only recommended for users who like to do a quick test of PALM.\\
+'''We recommend to start with a local installation''' using the [wiki:doc/install/automatic automatic installer], and then extend this installation to a full installation by following instructions given in the [wiki:doc/install/advanced full manual installation] section.
 
-The '''advanced method''' gives full access to all PALM features. It should be chosen to setup PALMs ability to run in batch mode on a local or remote computer (see [#requirements software requirements]). Here it is possible to submit a job on the local host while instructing PALM to execute the job on your desired remote host. The PALM output is then automatically transferred back to the local computer. This method can of course also be used to work with PALM in interactive mode on the local computer. The installation process for the '''advanced method requires''' a valid account on the local and on the remote host as well.\\
 
-The examples given in this chapter refer to an installation of PALM on an IMUK Linux workstation (local host) and for the '''advanced method''', the Cray XC30/40 system of HLRN (remote host).\\
+
+With the '''automatic installer''' and the '''reduced manual installation method''', you can just run PALM interactively on the local computer. They do not allow to setup the creation of batch jobs and restart runs on any local or remote computers. Therefore, these methods are only suitable / recommended for users who like to do a quick test of PALM. However, as pointed out before, you can / should  use the '''automatic installer''' as a basis for a complete manual installation.\\
+
+The '''manual installation''' gives full access to all PALM features. It should be chosen to setup PALMs ability to run in batch mode on a local or remote computer (see [#requirements software requirements]). It allows to submit a job on the local host while instructing {{{palmrun}}} to execute the job on your desired remote host. The PALM output is then automatically transferred back to the local computer. The '''manual installation''' can of course also be used to work with PALM in interactive mode on the local computer. The installation process for the '''manual installation''' may require a valid account on the remote host as well.\\
+
+The examples given in this chapter refer to a local installation of PALM on an IMUK Linux workstation (local host) and for running batch jobs on the Cray XC40 system of HLRN (remote host).\\
 
 '''In case of problems with the installation, please check the [wiki:Help/FAQ#installation FAQ Installation Questions] first.'''\\ \\
@@ -40 +45 @@
  4. The Message Passing Interface (MPI), at least on the remote host, if the parallel version of PALM shall be used.
  5. On the local host, the revision control system '''Subversion''', which is already part of most Linux distributions. The user needs a combination of username and password to access the PALM repository. For getting a permit please create an account using the [[//trac/register|register form]]. \\
-The [wiki:doc/install/advanced advanced method] additionally requires:
- 6. A job queuing system on the local or remote host. Currently, PALM can handle !LoadLeveler (IBM-AIX) and NQS/PBS (Linux-Clusters, NEC-SX).
- 7. SSH/SCP-connectivity to and from the remote host must not be blocked by a firewall and needs to password-less using an SSH-key.
+Using PALM in batch mode additionally requires:
+ 6. A job queuing system on the local or remote host.
+ 7. SSH/SCP-connectivity to and from the remote host must not be blocked by a firewall and needs to be password-less using an SSH-key.