Content-type: text/html
Manpage of bchkpnt
bchkpnt
Section: User Commands (1)
Updated: SkyForm AIP Version 10.25.0 - April 2025
Index
Return to Main Contents
NAME
cchkpnt - checkpoints one or more checkpointable jobs
SYNOPSIS
cchkpnt [-f] [-k] [-p minutes | -p 0] [job_ID | "job_ID[index_list]"] ...
cchkpnt [-f] [-k] [-p minutes | -p 0] [-J job_name]
[-m host_name | -m host_group] [-q queue_name]
[-u "user_name" | -u all] [0]
cchkpnt [-h | -V]
DESCRIPTION
Checkpoints your running (RUN) or suspended (SSUSP, USUSP, and
PSUSP) checkpointable jobs. The cluster administrators and root can
checkpoint jobs submitted by other users.
By default, checkpoints one job, the most recently submitted job, or the
most recently submitted job that also satisfies other specified options
(-m, -q, -u and -J). Specify -0 (zero) to checkpoint multiple jobs.
Specify a job ID to checkpoint one specific job.
By default, jobs continue to execute after they have been
checkpointed.
To submit a checkpointable job, use csub -k or submit the job to a
checkpoint queue (checkpoint in cb.yaml(5)). Use crestart(1) to
start checkpointed jobs.
AIP invokes the echkpnt(8) executable found in CB_SERVERDIR to
perform the checkpoint.
OPTIONS
- 0
-
-
(Zero). Checkpoints multiple jobs. Checkpoints all the jobs that satisfy
other specified options (-m, -q, -u and -J).
- -f
-
-
Forces a job to be checkpointed even if non-checkpointable conditions
exist (these conditions are OS-specific).
- -k
-
-
Kills a job after it has been successfully checkpointed.
- -p minutes | -p 0
-
-
Enables periodic checkpointing and specifies the checkpoint period, or
modifies the checkpoint period of a checkpointed job. Specify -p 0
(zero) to disable periodic checkpointing.
-
Checkpointing is a resource-intensive operation. To allow your job to
make progress while still providing fault tolerance, specify a
checkpoint period of 30 minutes or longer.
- -J job_name
-
-
Only checkpoints jobs that have the specified job name.
- -m host_name | -m host_group
-
-
Only checkpoints jobs dispatched to the specified hosts.
- -q queue_name
-
-
Only checkpoints jobs dispatched from the specified queue.
- -u "user_name" | -u all
-
-
Only checkpoints jobs submitted by the specified users. The keyword
all specifies all users. Ignored if a job ID other than 0 (zero) is
specified.
- job_ID | "job_ID[index_list]"
-
-
Checkpoints only the specified jobs.
- -h
-
-
Prints command usage to stderr and exits.
- -V
-
-
Prints AIP release version to stderr and exits.
EXAMPLES
% cchkpnt 1234
Checkpoints the job with job ID 1234.
% cchkpnt -p 2.0 1234
Enables periodic checkpointing or changes the checkpoint period to
2.0 minutes (2 hours) for a job with job ID 1234.
% cchkpnt -m hostA -k -u all 0
When issued by root or an cluster administrator, will checkpoint and kill
all checkpointable jobs on hostA. This is useful when a host needs to
be shut down or rebooted.
SEE ALSO
csub(1), cmod(1), crestart(1), cjobs(1), cqueues(1),
chosts(1), cb.yaml(5), echkpnt(8),
erestart(8)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 18:57:47 GMT, April 23, 2025