Changes between Version 24 and Version 25 of doc/install

Timestamp:

Sep 15, 2010 9:17:02 AM (15 years ago)

Author:

witha

Comment:

--

doc/install

@@ -110 +110 @@
   mbuild -h lcmuk 
 }}}
+
+=== Installation Verification ===
+
+As a last step, after the compilation has been finished, the PALM installation has to be verified. For this purpose a simple test run is carried out. This once again requires the '''mrun''' configuration file (described in [../chapter_3_2 chapter 3.2]), as well as the [../parameterfile parameter file] (described in [../chapter_4_4_1 chapter 4.4.1]). The parameter file must be copied from the PALM working copy by
+{{{
+  mkdir -p JOBS/example_cbl/INPUT
+  cp trunk/INSTALL/example_cbl_p3d JOBS/example_cbl/INPUT/example_cbl_p3d
+}}}
+The test run can now be started by executing the command
+{{{
+  mrun -d example_cbl -h lcsgih -K parallel -X 8 -T 8 -t 500 -q testq -r “d3# pr#”
+}}}
+This specific run will be carried out on 8 PEs and is allowed to use up to 500 seconds CPU time. After pressing <return>, the most important settings of the job are displayed at the terminal window and the user is prompted for o.k. ("{{{y}}}"). Next, a message of the queuing system like "''Request … Submitted to queue… by…''" should be displayed. Now the job is queued and either started immediately or at a later time, depending on the current workload of the remote host. Provided that it is executed immediately and that all things work as designed, the job protocol of this run will appear under the file name {{{~/job_queue/lcsgih_example}}} no more than a few minutes later. The content of this file should be carefully examined for any error messages.\\\\
+Beside the job protocol and according to the configuration file and arguments given for mrun options -d and -r,further files should be found in the directories
+~/palm/current_version/JOBS/example_cbl/MONITORING
+
+and
+
+    ~/palm/current_version/JOBS/example_cbl/OUTPUT
+
+Please compare the contents of file
+
+    ~/palm/current_version/JOBS/example_cbl/MONITORING/lcsgih_example_rc
+
+with those of the example result file which can be found under trunk/INSTALL/example_cbl_rc., e.g. by using the standard diff command:
+
+diff  JOBS/example_cbl/MONITORING/lcsgih_example_cbl_rc trunk/INSTALL/example_cbl_rc
+
+where it is assumed that your working directory is ~/palm/current_version.
+You should not find any difference between these two files, except of the run date and time displayed at the top of the file header. If the file contents are identical, the installation is successfully completed.