Changes between Version 5 and Version 6 of Public/User_Guide/SIONlib

Timestamp:

Dec 3, 2019, 9:35:44 AM (4 years ago)

Author:

Benedikt Steinbusch

Comment:

update existing documentation to D6.3

Public/User_Guide/SIONlib

@@ -5 +5 @@
 == Modules ==
 
-Recent versions of SIONlib are available on the DEEP-EST SDV through the new software stack as modules:
+Recent versions of SIONlib are available on the DEEP-EST prototype through the new software stack as modules:
 
 {{{
-$ module load Intel ParaStationMPI SIONlib
+$ module spider SIONlib/1.7.6
 }}}
 
@@ -22 +22 @@
 The mechanism has been extended with a new MSA-aware algorithm for the selection of collector processes.
 The algorithm is portable and relies on platform specific plug-ins to identify processes which run on parts of the system that are well suited for the role of I/O collector.
-So far, a specific plug-in for the DEEP-EST SDV has been implemented as well as a test plug-in.
+So far, three plug-ins have been implemented:
+- a new generic plug-in -- `hostname-regex` -- which selects collectors tasks by matching the host name of the node they are running on against regular expressions that can be defined via environment variables,
+- an older plug-in -- `deep-est-std` -- that selects collector tasks using a similar mechanism, but with host names hard-coded to match cluster nodes of an earlier version of the DEEP-EST prototype,
+- a mock-up plug-in for testing purposes.
 In the future, further plug-ins for new systems of the MSA type can be added.
 
@@ -28 +31 @@
 
 {{{#!sh
-./configure --msa=deep-est-sdv # ... more configure arguments
+./configure --msa=hostname-regex # ... more configure arguments
 }}}
 
@@ -38 +41 @@
 {{{#!c
 sion_paropen_mpi("filename", "...,collmsa,...", ...);
+}}}
+
+Also, when the new `hostname-regex` collector selection plug-in is enabled, an environment variable `SION_MSA_COLLECTOR_HOSTNAME_REGEX` has to be defined to contain a POSIX basic regular expression to match against hostnames of nodes running candidates for the collector role (`SION_MSA_COLLECTOR_HOSTNAME_EREGEX` can be used alternatively, but should contain a POSIX extended regular expression).
+For example, to select nodes from the DAM as collectors, set:
+
+{{{#!sh
+export SION_MSA_COLLECTOR_HOSTNAME_EREGEX="dp-dam.*"
 }}}