Differences

This shows you the differences between two versions of the page.

--- cluster:190 [2020/01/16 18:46] – [DMTCP] hmeij07
+++ cluster:190 [2020/09/28 11:38] (current) – hmeij07
@@ Line 7: / Line 7: @@
   * DMTCP (Distributed MultiThreaded Checkpointing)
-DMTCP Checkpoint/Restart allows one to transparently checkpoint to disk
+DMTCP Checkpoint/Restart allows one to transparently checkpoint to disk a distributed computation.  It works under Linux, with no modifications to the Linux kernel nor to the application binaries.  It can be used by
-a distributed computation.  It works under Linux, with no modifications
+unprivileged users (no root privilege needed).  One can later restart from a checkpoint, or even migrate the processes by moving the checkpoint files to another host prior to restarting.
-to the Linux kernel nor to the application binaries.  It can be used by
-unprivileged users (no root privilege needed).  One can later restart
-from a checkpoint, or even migrate the processes by moving the checkpoint
-files to another host prior to restarting.
-This is a replacement for THE BLCR methods we used to use.
+This is a replacement for THE BLCR methods we used [[cluster:147|BLCR Checkpoint in OL3 -serial]] or [[cluster:148|BLCR Checkpoint in OL3 - parallel]] ... BLCR is not being developed anymore. Today's brief power outage removed the BLCR kernel module HPCC wide. So learn DMTCP. I have not provided wrappers but you can follow the same logic as we used with BLCR.
+Write your checkpoint files in ''/sanscratch/checkpoints/JOBPID'' so it does not add into your quota.  The scheduler will not create this directory for you, you must do this in your submit job.  Directories will automatically be delete if 120 days old.
 <code>
@@ Line 20: / Line 18: @@
 # sample steps to put in your scripts
-# make a directory (done by scheduler)
+# make a directory (first one done by scheduler, second one done by your script)
-mkdir -p /sanscratch/111 /snascratch/checkpoints/111
+mkdir -p /sanscratch/111 /sanscratch/checkpoints/111
 cd /sanscratch/111
+# invoke sample rpogram which generates one line of output
 time ./a.out
@@ Line 36: / Line 36: @@
 [hmeij@cottontail2 111]$ cat fid.txt
 .999578495067887       7.978578277139264E-005
+# for example, with 24 hours checkpoint interval
+# launch new coordinator on random port, log port, 24 hour checkpoints
+# make sure you create destination dir for checkpoints
+dmtcp_launch --new-coordinator \
+  --coord-port 0 --port-file port.txt --interval 86400 \
+  --ckptdir /sanscratch/checkpoints/111 \
+  time ./a.out
-# run command below with interval 36000 (10 mins)
+# run command above  with interval 300 (every 5 mins)
 [hmeij@cottontail2 111]$ ps
   PID TTY          TIME CMD
@@ Line 47: / Line 57: @@
 # the coordinator to which application process was attached
-S hmeij    20008     1  0  80   0 -  4665 ep_pol 07:46 pts/1    00:00:00 /usr/bin/dmtcp_coordinator --quiet --exit-on-last --daemon
+S hmeij    20008     1  0  80   0 -  4665 ep_pol 07:46 pts/1    00:00:00 \\
+/usr/bin/dmtcp_coordinator --quiet --exit-on-last --daemon
 # the random port (in case somebody else is also checkpointing on this host
 [hmeij@cottontail2 111]$ cat port.txt
-real    64m2.706s
+# 5 mins checkpoints, little impact
-user    64m2.032s
+[hmeij@cottontail2 111]$ sleep 6m; ll /sanscratch/checkpoints/111/
-sys     0m0.026s
+total 2960
+-rw------- 1 hmeij its 3011726 Jan 16 13:53 ckpt_a.out_24945f6ae3823bbf-40000-fb2d136b9b544.dmtcp\\
+-rwxr--r-- 1 hmeij its   12440 Jan 16 13:53 dmtcp_restart_script_24945f6ae3823bbf-40000-fb2d11ea62fa0.sh\\
+lrwxrwxrwx 1 hmeij its      60 Jan 16 13:53 dmtcp_restart_script.sh -> dmtcp_restart_script_24945f6ae3823bbf-40000-fb2d11ea62fa0.sh\\
+[hmeij@cottontail2 111]$
+real    63m57.287s
+user    63m54.703s
+sys     0m0.444s
-# launch new coordinator on random port, log port, 24 hour checkpoints
+# lets try a termination of processes and restart
-# make sure you create destination dir for checkpoints
+[hmeij@cottontail2 111]$ time dmtcp_launch \\
+--new-coordinator --coord-port 0 --port-file port.txt \\
+-i 300 --ckptdir /sanscratch/checkpoints/111  ./a.out &
+[1] 29201
-dmtcp_launch --new-coordinator \
+[hmeij@cottontail2 111]$ ps
-  --coord-port 0 --port-file port.txt --interval 86400 \
+  PID TTY          TIME CMD
-  --ckptdir /sanscratch/checkpoints/111 \
+pts/1    00:00:00 bash
-  time ./a.out
+pts/1    00:00:00 bash
+pts/1    00:00:01 a.out
+pts/1    00:00:00 dmtcp_coordinat
+pts/1    00:00:00 ps
+# terminate half way through
+[hmeij@cottontail2 111]$ sleep 32m; kill -9 29202 29210
+# restart from checkpoints directory (or copy files into desired location)
+cd /sanscratch/checkpoints/111
+./dmtcp_restart_script.sh
+# ps
+S hmeij    20891 20890  -bash
+R hmeij    31136 20891 [DMTCP:a.out]
+S hmeij    31201     1  /usr/bin/dmtcp_coordinator --quiet --exit-on-last --daemon
+# You must make sure the old directory and file exists, otherwise
+[40000] ERROR at fileconnection.cpp:737 in refill;
+REASON='JASSERT(jalib::Filesystem::FileExists(_path)) failed'
+     _path = /sanscratch/111/fid.txt
+Message: File not found.
+a.out (40000): Terminating...
+# that is because at checkpoint time that file was opened by a.out
+# The process will pick up from last checkpoint
+# and write output to original work directory
 </code>
 ==== Quick-Start Guide ====