Changes between Version 17 and Version 18 of doc/app/palm_wd

Timestamp:

Jul 13, 2015 7:12:26 AM (9 years ago)

Author:

maronga

Comment:

--

doc/app/palm_wd

@@ -5 +5 @@
 
 == Configuration of the watchdog
-The watchdog consists of two scripts, palm_wd (watchdog client to be run on the local host) and palm_wdd (server to be located on each remote host to be monitored). Before running the watchdog, both client and server require system-specific configuration:
+The watchdog consists of two scripts, palm_wd (watchdog client to be run on the local host) and palm_wdd (server to be located on each remote host to be monitored). Before running the watchdog, both client and server require system-specific configuration that have to been provided in configuration files {{{.wd.config}}} and {.wdd.config}}}:
 
-1. in palm_wd, create one item for each remote host in the following three lists hostname, username and description, e.g.
+1. Make a copy of {{{trunk/SCRIPTS/palm_wd_files/.wd.config.default}}}, rename it to .wd.config, and move it to your local palm directory (e.g. {{{~/palm/current_version/}}}, then edit the file (e.g. here for HLRN-III):
 {{{
-hostname     = ["hlogin.hlrn.de", "blogin.hlrn.de"]
-username     = ["nikname"       , "nikname"       ]
-description  = ["Hannover"      , "Berlin"        ]
+[Hannover]
+hostname=hlogin.hlrn.de
+username=<replace_by_your_remote_username>
+
+[Berlin]
+hostname=blogin.hlrn.de
+username=<replace_by_your_remote_username>
+
+[Settings]
+update_frequency=10
 }}}
-   here hostname is the IP of the remote host (assuming that a passwordless login via ssh-key is available), username is the user name on the remote host, and description is an arbritrary string to identify the host.
+For each remote host to be monitored, create a separate section with Description of your choice (here "Hannover" and "Berline"). hostname is the IP/name of the remote host (assuming that a passwordless login via ssh-key is available), username is the user name on the remote host. The automatical update frequency must be given in minutes.
 
-   Additionally, the update_frequency can be adjusted:
+2. palm_wdd requires system-specific configurations. Make a copy of {{{trunk/SCRIPTS/palm_wd_files/.wdd.config.default}}} for each host to be monitored, rename it to {{{.wdd.config}}}, and edit the files appropriately. For HLRN-III {{{.wdd.config}}} reads:
 {{{
-update_frequency = 600*1000
+[Settings]
+readqueue="showq | egrep"
+tmpdir="/gfs1/tmp/"
+canceljob="canceljob"
+checkjob="checkjob"
+realname_grep="AName"
+starttime="showstart"
+starttime_grep="start in"
 }}}
+As the queuing system on different computing systems may vary, it is not possible to provide detailed instructions how to set this configuration. In case you are struggling with the configuration, please feel free to create a [/newticket new ticket]
 
-2. in palm_wdd, system-specific configurations must be made. The default is configured to be used on the Cray-XC40 at HLRN-III and reads
-{{{
-cmd_readqueue      = "showq | egrep "
-cmd_tmpdir         = "/gfs1/tmp/"
-cmd_canceljob      = "canceljob"
-cmd_checkjob       = "checkjob"
-cmd_realname_grep  = "AName"
-cmd_starttime      = "showstart"
-cmd_starttime_grep = "start in"
-}}}
-   For other hosts, the parameters above must be adjusted appropriately.
-
-3. Copy palm_wdd into the $HOME directory of each of the remote hosts, i.e. for HLRN-III:
+3. Now copy palm_wdd and the configuration files into the $HOME directory of each of the remote hosts, i.e. for HLRN-III:
 {{{
 scp palm_wdd nikname@hlogin.hlrn.de:
+scp .wdd.config.hlrnIII nikname@hlogin.hlrn.de:.wdd.config
 scp palm_wdd nikname@blogin.hlrn.de:
-}}}
-
-4. Create database files for the watchdog in your working directory:
-{{{
-cp $PALM_BIN/palm_wd_files/.wd.olddata $HOME/palm/current_version
-cp $PALM_BIN/palm_wd_files/.wd.newdata $HOME/palm/current_version
+scp .wdd.config.hlrnIII nikname@blogin.hlrn.de:.wdd.config
 }}}
 
@@ -55 +54 @@
 
 == Documentation
-The watchdog is to large extent self-explanatory. The following features, however, require a short description.
+The watchdog is to large extent self-explanatory. The following features, however, might require a short description.
 
 === Progress bar