Administering Platform LSF - SAS

Creating Custom echkpnt and erestart for Application-level Checkpointing
Creating Custom echkpnt and erestart for
Application-level Checkpointing
Different applications may have different checkpointing implementations and
custom echkpnt and erestart programs.
You can write your own echkpnt and erestart programs to checkpoint your
specific applications and tell LSF which program to use for which application.
◆ “Writing custom echkpnt and erestart programs” on page 310
◆ “Configuring LSF to recognize the custom echkpnt and erestart” on
page 312
Writing custom echkpnt and erestart programs
Programming
language
Name
Location
Supported syntax
for echkpnt
You can write your own echkpnt and erestart interfaces in C or Fortran.
Assign the name echkpnt.method_name and erestart.method_name,
where method_name is the name that identifies this is the program for a
specific application.
For example, if your custom echkpnt is for my_app, you would have:
echkpnt.my_app, erestart.my_app.
Place echkpnt.method_name and erestart.method_name in
LSF_SERVERDIR. You can specify a different directory with
LSB_ECHKPNT_METHOD_DIR as an environment variable or in lsf.conf.
The method name (LSB_ECHKPNT_METHOD in lsf.conf or as an
environment variable) and location (LSB_ECHKPNT_METHOD_DIR)
combination must be unique in the cluster. For example, you may have two
echkpnt applications with the same name such as echkpnt.mymethod but
what differentiates them is the different directories defined with
LSB_ECHKPNT_METHOD_DIR.
The checkpoint method directory should be accessible by all users who need
to run the custom echkpnt and erestart programs.
Your echkpnt.method_name must recognize commands in the following
syntax as these are the options used by echkpnt to communicate with your
echkpnt.method_name:
echkpnt [-c] [-f] [-k | -s] [-d checkpoint_dir] [-x] process_group_ID
Supported syntax
for erestart
For more details on echkpnt syntax, see the echkpnt(8) man page.
Your erestart.method_name must recognize commands in the following
syntax as these are the options used by erestart to communicate with your
erestart.method_name .
erestart [-c] [-f] checkpoint_dir
For more details, see the erestart(8) man page.
310
Administering Platform LSF