bsubmit

An example command that submits jobs as another user.

Note that the bsubmit command is not included with LSF. To enable a job submission user to submit jobs as another job execution user, you download and deploy this example bsubmit command executable file, as it is a wrapper for the bsub command. To use the example bsubmit command, you build it from the source at: https://github.com/IBMSpectrumComputing/lsf-utils/tree/master/bsubmit.

Synopsis

bsubmit --user user_name command [arguments]

bsubmit [-h | -V]

Description

The bsubmit command is a wrapper for the bsub command that allows you, as the job submission user, to submit jobs as another job execution user. The bsubmit wrapper has the setuid bit enabled and is owned by root. This is useful if you want the job submission user to be a particular user, but to map the job execution user to other users.

To use this command, you must download and deploy the bsubmit executable file, which is a wrapper for the bsub command. For more details, refer to the following link: https://github.com/IBMSpectrumComputing/lsf-utils/tree/master/bsubmit

Using the bsubmit example, you can define the execution users to which you can map submission users, create a configuration file named lsf.usermapping in the $LSF_ENVDIR directory to define the user mapping policy for the bsubmit command. The lsf.usermapping allows you to map several job execution users and user groups to a single submission user or user group. This file must be owned by the LSF administrator, with file permissions set to read/write for the owner and read-only for all other users. For each row, specify the submission user or group to the left and a comma-separated list of execution users or groups on the right.

For example:

#Submission user or group    # Execution users or groups
userA                        userB,userC,userD
groupA                       groupB

This lsf.usermapping configuration file means that the userA user can submit jobs as userB, userC, or userD. Users in the groupA group can submit jobs as any user in the groupB user group.

To submit jobs as other users, use the bsubmit command. For example, run the following command if the job submission user userA is submitting a job as job execution user userC:

bsubmit --user userC myjob

Options

--user user_name: Required. Specifies the job execution user to which the job is mapped.
-h: Prints command usage to stderr and exits.
-V: Prints LSF release version to stderr and exits.