ckpt_name

The name of the checkpointing environment in the format for ckpt_name in sge_types(5). To be used in the qsub(1) -ckpt switch or for the qconf(1) options mentioned above.

interface

The type of checkpointing to be used. Currently, the following types are valid:

hibernator

The Hibernator kernel level checkpointing is interfaced.

cpr

The SGI kernel level checkpointing is used.

transparent

Grid Engine assumes that the jobs submitted with reference to this checkpointing interface use a checkpointing library such as provided by the free package Condor.

userdefined

Grid Engine assumes that the jobs submitted with reference to this checkpointing interface perform their private checkpointing method.

application-level

Uses all of the interface commands configured in the checkpointing object like in the case of one of the kernel level checkpointing interfaces (cpr, etc.) except for the restart_command (see below), which is not used (even if it is configured) but the job script is invoked in case of a restart instead.

ckpt_command

A command-line type command string to be executed by Grid Engine in order to initiate a checkpoint. The following pseudo-variables are available to be substituted in the value:

$host

The name of the host on which the command is executed.

$ja_task_id

The array job task index (0 if not an array job).

$job_owner

The user name of the job owner.

$job_id

Grid Engine's unique job identification number.

$job_name

The name of the job.

$queue

The cluster queue name of the master queue instance, on which the command is started.

$job_pid

The process id of the job/task to checkpoint.

$ckpt_dir

See ckpt_dir below.

$ckpt_signal

See signal below.

$sge_cell

The SGE_CELL environment variable (useful for locating files).

$sge_root

The SGE_ROOT environment variable (useful for locating files).

migr_command

A command-line type command string to be executed by Grid Engine during a migration of a checkpointing job from one host to another. The same pseudo-variables are available as for ckpt_command. Note that the command is expected to create a checkpoint itself - the checkpointing command isn't called automatically on migration.

restart_command

A command-line type command string to be executed by Grid Engine when restarting a previously checkpointed application. The same pseudo-variables are available as for ckpt_command.

clean_command

A command-line type command string to be executed by Grid Engine in order to cleanup after a checkpointed application has finished. The same pseudo-variables are available as for ckpt_command.

ckpt_dir

A file system location to which checkpoints of potentially considerable size should be stored.

signal

A Unix signal to be sent to a job by Grid Engine to initiate checkpoint generation. The value for this field can either be a symbolic name from the list produced by the -l option of the kill(1) command or an integer number which must be a valid signal on the systems used for checkpointing.

when

The points of time when checkpoints are expected to be generated. Valid values for this parameter are composed from the letters s, m, x, r, and any combinations thereof without any separating character in between. The same letters are allowed for the -c option of the qsub(1) command which will overwrite the definitions in the checkpointing environment used. The meaning of the letters is as follows:

s

A job is checkpointed, aborted and, if possible, migrated if the corresponding sge_execd(8) is shut down on the job's host. This operation is handled by the specified migr_command.

m

checkpoints are generated periodically at the min_cpu_interval interval defined by the queue (see queue_conf(5)) in which a job executes.

x

A job is checkpointed, aborted and, if possible, migrated as soon as the job gets suspended (manually as well as automatically). This operation is handled by the specified migr_command.

r

A job will be rescheduled (not checkpointed) when the host on which the job currently runs goes into the "unknown" state and the time interval reschedule_unknown (see sge_conf(5)) defined in the global/local cluster configuration is exceeded.