Job migration commands

Commands for submission

Job migration applies to checkpointable or rerunnable jobs submitted with a migration threshold, or that have already started and are either running or suspended.

Command	Description
bsub -mig `migration_threshold`	Submits the job with the specified migration threshold for checkpointable or rerunnable jobs. Enables automatic job migration and specifies the migration threshold, in minutes. A value of 0 (zero) specifies that a suspended job should be migrated immediately. Command-level job migration threshold overrides application profile and queue-level settings. Where a host migration threshold is also specified, and is lower than the job value, the host value is used.

Command

Description

bsub -mig migration_threshold

Submits the job with the specified migration threshold for checkpointable or rerunnable jobs. Enables automatic job migration and specifies the migration threshold, in minutes. A value of 0 (zero) specifies that a suspended job should be migrated immediately.
Command-level job migration threshold overrides application profile and queue-level settings.
Where a host migration threshold is also specified, and is lower than the job value, the host value is used.

Commands to monitor

Command	Description
bhist -l	Displays the actions that LSF took on a completed job, including migration to another host
bjobs -l	Displays information about pending, running, and suspended jobs

Commands to control

Command	Description
bmig	Migrates one or more running jobs from one host to another. The jobs must be checkpointable or rerunnable Checkpoints, kills, and restarts one or more checkpointable jobs—bmig combines the functionality of the bchkpnt and brestart commands into a single command Migrates the job on demand even if you have configured queue-level or host-level migration thresholds When absolute job priority scheduling (APS) is configured in the queue, LSF schedules migrated jobs before pending jobs—for migrated jobs, LSF maintains the existing job priority
bmod -mig `migration_threshold` \| -mign	Modifies or cancels the migration threshold specified at job submission for checkpointable or rerunnable jobs. Enables or disables automatic job migration and specifies the migration threshold, in minutes. A value of 0 (zero) specifies that a suspended job should be migrated immediately. Command-level job migration threshold overrides application profile and queue-level settings. Where a host migration threshold is also specified, and is lower than the job value, the host value is used.

Command

Description

bmig

Migrates one or more running jobs from one host to another. The jobs must be checkpointable or rerunnable
Checkpoints, kills, and restarts one or more checkpointable jobs—bmig combines the functionality of the bchkpnt and brestart commands into a single command
Migrates the job on demand even if you have configured queue-level or host-level migration thresholds
When absolute job priority scheduling (APS) is configured in the queue, LSF schedules migrated jobs before pending jobs—for migrated jobs, LSF maintains the existing job priority

bmod -mig migration_threshold | -mign

Modifies or cancels the migration threshold specified at job submission for checkpointable or rerunnable jobs. Enables or disables automatic job migration and specifies the migration threshold, in minutes. A value of 0 (zero) specifies that a suspended job should be migrated immediately.
Command-level job migration threshold overrides application profile and queue-level settings.
Where a host migration threshold is also specified, and is lower than the job value, the host value is used.

Commands to display configuration

Command	Description
bhosts -l	Displays information about hosts configured in lsb.hosts, including the values defined for migration thresholds in minutes
bqueues -l	Displays information about queues configured in lsb.queues, including the values defined for migration thresholds Note: The bqueues command displays the migration threshold in seconds—the lsb.queues MIG parameter defines the migration threshold in minutes.
badmin showconf	Displays all configured parameters and their values set in lsf.conf or ego.conf that affect mbatchd and sbatchd. Use a text editor to view other parameters in the lsf.conf or ego.conf configuration files. In a MultiCluster environment, displays the parameters of daemons on the local cluster.