taskman
Checks out a license token and manages interactive UNIX applications.
Synopsis
taskman -R “rusage[token=number [:duration=minutes | hours h] [:token=number[:duration=minutes | hours h] [|| token=number[:duration=minutes | hours h] [:token=number [:duration=minutes | hours h]] ...] [-Lp project] [-N n_retries] [-v] commandDescription
Runs the interactive UNIX application on behalf of the user. When it starts, the task manager connects to LSF License Scheduler to request the application license tokens. When all the requested licenses are available, the task manager starts the application. While the application is running, the task manager monitors resource usage, CPU, and memory, and reports the usage to LSF License Scheduler. When the application ends, the task manager exits.
By default, a license is reserved for the duration of the task, so the application can check out the license at any time. Use the duration keyword to reallocate unused licenses if the application fails to check out the license before the reservation expires.
By default, the taskman command does not detect or use batch resources. To allow the taskman command to detect batch resources, set ENABLE_INTERACTIVE=y parameter in the lsf.licensescheduler file.
Options
- command
- Required. The command to start the job that requires the license.
- -v
- Verbose mode. Displays detailed messages about the status of configuration files.
- -N n_retries
- Specifies the maximum number of retry attempts that the taskman command makes to connect to the daemon. If this option is not specified, the taskman command retries indefinitely.
- -Lp project
- Optional. Specifies the interactive license project that is requesting tokens. The client must
be known to LSF License Scheduler.
License project limits do not apply to the taskman command jobs even with -Lp specified.
- -R rusage[token=number [:duration=minutes | hours h] [:token=number [:duration=minutes | hours h][|| token=number [:duration=minutes | hours h] [:token=number [:duration=minutes | hours h]]] ...]
- Required. Specifies the type and number of license tokens to request from LSF License Scheduler.
Optionally, specifies a time limit for the license reservation, expressed as an integer (the keyword
h following the number indicates hours instead of minutes). You can specify
multiple license types, with different duration values. Separate each requirement with a colon
(:) as a logical AND operator, and a double-pipe
(||) as a logical OR operator. Enclose the entire list in one set of
square brackets.Note: If you specify alternative or compound resource requirements, the taskman command accepts only the first resource requirement string and ignores the other resource requirement strings.For example,
- Alternative resource requirement
- taskman -R "{rusage[f2=2]}||{rusage[f2=1]}" myjob
- Compound resource requirement
- taskman -R "{rusage[f2=2]}+{rusage[f2=1]}" myjob
- -h
- Prints command usage to stderr and exits.
- -V
- Prints the LSF License Scheduler release version to stderr and exits.