Platform LSF Version 6.0 - Platform LSF Reference

[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]

brsvadd

adds an advance reservation

SYNOPSIS

brsvadd -n processors -m "host_name | host_group ..." [-R "res_req"] -u user_name | -g group_name | -s -b [[month:]day:]hour:minute -e [[month:]day:]hour:minute

brsvadd -n processors -m "host_name | host_group ..." [-R "res_req"] -u user_name | -g group_name | -s -t time_window

brsvadd -n processors -R "res_req" -u user_name | -g group_name | -s -b [[month:]day:]hour:minute -e [[month:]day:]hour:minute

brsvadd -n processors -R "res_req" -u user_name | -g group_name | -s -t time_window

brsvadd [-h | -V]

DESCRIPTION

By default, this command can only be used by LSF administrators or root.

Reserves processors in advance for a specified period of time for a user or user group, or for system maintenance purposes. Use -b and -e for one-time reservations, and -t for recurring reservations.

To allow users to create their own advance reservations without administrator intervention, configure advance reservation policies in the ResourceReservation section of lsb.resources.

Only administrators, root, or the users listed in the ResourceReservation section can add reservations for themselves or any other user or user group.

USER_ADVANCE_RESERVATION in lsb.params is obsolete. Use the ResourceReservation section configuration in lsb.resources to configure advance reservation policies for your cluster.

OPTIONS

-b [[[year:]month:]day:]hour:minute

Begin time for a one-time reservation. The day and time are in the form:

[[[year:]month:]day:]hour:minute

with the following ranges:

year: any year after 1900 (YYYY)
month: 1-12 (MM)
day of the month: 1-31 (dd)
hour: 0-23 (hh)
minute: 0-59 (mm)

You must specify at least hour:minute. Year, month, and day are optional. Three fields are assumed to be day:hour:minute, four fields are assumed to be month:day:hour:minute, and five fields are year:month:day:hour:minute.

If you do not specify a day, LSF assumes the current day. If you do not specify a month, LSF assumes the current month. If you specify a year, you must specify a month.

The time value for -b must use the same syntax as the time value for -e. It must be earlier than the time value for -e, and cannot be earlier than the current time.

-e [[[year:]month:]day:]hour:minute

End time for a one-time reservation. The day and time are in the form:

[[[year:]month:]day:]hour:minute

with the following ranges:

year: any year after 1900 (YYYY)
month: 1-12 (MM)
day of the month: 1-31 (dd)
hour: 0-23 (hh)
minute: 0-59 (mm)

You must specify at least hour:minute. Year, month, and day are optional. Three fields are assumed to be day:hour:minute, four fields are assumed to be month:day:hour:minute, and five fields are year:month:day:hour:minute.

If you do not specify a day, LSF assumes the current day. If you do not specify a month, LSF assumes the current month. If you specify a year, you must specify a month.

The time value for -e must use the same syntax as the time value for -b. It must be later than the time value for -b.

-g group_name

Creates a reservation for a user group.

The -g group_name options do not support the @cluster notation for advance reservations on remote clusters.

-m "host_name | host_group ..."

List of hosts for which processors specified with -n are reserved. At job submission, LSF considers the hosts in the specified order.

If you also specify a resource requirement string with the -R option, -m is optional.

The hosts can be local to the cluster or hosts leased from remote clusters.

-n processors

Number of processors to reserve. processors must be less than or equal to the actual number of CPUs for the hosts selected by -m or -R for the reservation.

-R "res_req"

Selects hosts for the reservation according to the specified resource requirements. Only hosts that satisfy the resource requirement expression are reserved. -R accepts any valid resource requirement string, but only the select string takes effect.

If you also specify a host list with the -m option, -R is optional.

For more information about resource requirements, see lsfintro(1).

The size of the resource requirement string is limited to 512 bytes.

-s

Creates a reservation for system use. LSF does not dispatch jobs to the specified hosts while the reservation is active.

-t time_window

Time window for a recurring reservation.

The day and time are in the form:

[day:]hour[:minute]

with the following ranges:

day of the week: 0-6
hour: 0-23
minute: 0-59

Specify a time window one of the following ways:

hour-hour
hour:minute-hour:minute
day:hour:minute-day:hour:minute

You must specify at least the hour. Day of the week and minute are optional. Both the start time and end time values must use the same syntax. If you do not specify a minute, LSF assumes the first minute of the hour (:00). If you do not specify a day, LSF assumes every day of the week. If you do specify the day, you must also specify the minute.

When the job starts running, the run limit of the reservation is set to the minimum of the job run limit (if specified), the queue run limit (if specified), or the duration of the time window.

LSF administrators can prevent running jobs from being killed when the reservation expires by changing the termination time of the job using the reservation (bmod -t) before the reservation window closes.

-u user_name

Creates a reservation for an individual user.

The -u user_name option does not support the @cluster notation for advance reservations on remote clusters.

-h

Prints command usage and exits.

-V

Prints LSF release version and exits.

EXAMPLES
The following command creates a one-time advance reservation for 1024 processors on host hostA for user user1 between 6:00 a.m. and 8:00 a.m. today:
% brsvadd -n 1024 -m hostA -u user1 -b 6:0 -e 8:0 Reservation "user1#0" is created

The hosts specified by -m can be local to the cluster or hosts leased from remote clusters.
The following command creates an advance reservation for 1024 processors on two hosts hostA and hostB for user group groupA every Wednesday from 12:00 midnight to 3:00 a.m.:
% brsvadd -n 2048 -m "hostA hostB" -g groupA -t "3:0:0- 3:3:0" Reservation "groupA#0" is created
SEE ALSO

brsvs(1), brsvdel(8), lsb.resources(5)

[ Top ]

[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]

Date Modified: February 24, 2004
Platform Computing: www.platform.com

Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Copyright © 1994-2004 Platform Computing Corporation. All rights reserved.