Name
condor_userprio - Manage user priorities
Synopsis
condor_userprio [ -pool centralmanagerhostname[:portnumber] ] [ -all ]
[ -usage ] [ -setprio username value ] [ -setfactor username value ] [
-setaccum username value ] [ -setbegin username value ] [ -setlast
username value ] [ -resetusage username ] [ -resetall ] [ -delete
username ] [ -getreslist username ] [ -allusers ] [ -activefrom month
day year ] [ -l ]
Description
condor_userprio with no arguments, lists the active users (see below)
along with their priorities, in increasing priority order. The -all
option can be used to display more detailed information about each
user, which includes the following columns:
Effective Priority
The effective priority value of the user, which is used to calculate
the user’s share when allocating resources. A lower value means a
higher priority, and the minimum value (highest priority) is 0.5.
The effective priority is calculated by multiplying the real
priority by the priority factor.
Real Priority
The value of the real priority of the user. This value follows the
user’s resource usage.
Priority Factor
The system administrator can set this value for each user, thus
controlling a user’s effective priority relative to other users.
This can be used to create different classes of users.
Res Used
The number of resources currently used (e.g. the number of running
jobs for that user).
Accumulated Usage
The accumulated number of resource-hours used by the user since the
usage start time.
Usage Start Time
The time since when usage has been recorded for the user. This time
is set when a user job runs for the first time. It is reset to the
present time when the usage for the user is reset (with the
-resetusage or -resetall options).
Last Usage Time
The most recent time a resource usage has been recorded for the
user.
The -usage option displays the username, accumulated usage, usage start
time and last usage time for each user, sorted on accumulated usage.
The -setprio, -setfactor options are used to change a user’s real
priority and priority factor. The -setaccum option sets a user’s
accumulated usage. The -setbegin, -setlast options are used to change a
user’s begin usage time and last usage time. The -setaccum option sets
a user’s accumulated usage. The -resetusage and -resetall options are
used to reset the accumulated usage for users. The usage start time is
set to the current time when the accumulated usage is reset. These
options require administrator privileges.
By default only users for whom usage was recorded in the last 24 hours
or whose priority is greater than the minimum are listed. The
-activefrom and -allusers options can be used to display users who had
some usage since a specified date, or ever. The summary line for last
usage time will show this date.
The -getreslist option is used to display the resources currently used
by a user. The output includes the start time (the time the resource
was allocated to the user), and the match time (how long has the
resource been allocated to the user).
Note that when specifying user names on the command line, the name must
include the UID domain (e.g. user@uid-domain - exactly the same way
user names are listed by the userprio command).
The -pool option can be used to contact a different central-manager
instead of the local one (the default).
For security purposes (authentication and authorization), this command
requires an administrator’s level of access. See section on page for
further explanation.
Options
-pool centralmanagerhostname[:portnumber]
Contact specified centralmanagerhostname with an optional port
number instead of the local central manager. This can be used to
check other pools. NOTE: The host name (and optionally port)
specified refer to the host name (and port) of the condor_negotiator
to query for user priorities. This is slightly different than most
Condor tools that support -pool, which expect the host name (and
optionally port) of the condor_collector , instead.
-all
Display detailed information about each user.
-usage
Display usage information for each user.
-setprio username value
Set the real priority of the specified user to the specified value.
-setfactor username value
Set the priority factor of the specified user to the specified
value.
-setaccum username value
Set the accumulated usage of the specified user to the specified
floating point value.
-setbegin username value
Set the begin usage time of the specified user to the specified
value.
-setlast username value
Set the last usage time of the specified user to the specified
value.
-resetusage username
Reset the accumulated usage of the specified user to zero.
-resetall
Reset the accumulated usage of all the users to zero.
-delete username
Remove the specified username from Condor’s accounting.
-getreslist username
Display all the resources currently allocated to the specified user.
-allusers
Display information for all the users who have some recorded
accumulated usage.
-activefrom month day year
Display information for users who have some recorded accumulated
usage since the specified date.
-l
Show the class-ad which was received from the central-manager in
long format.
Exit Status
condor_userprio will exit with a status value of 0 (zero) upon success,
and it will exit with the value 1 (one) upon failure.
Author
Condor Team, University of Wisconsin-Madison
Copyright
Copyright (C) 1990-2009 Condor Team, Computer Sciences Department,
University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
Licensed under the Apache License, Version 2.0.
See the Condor Version 7.2.4 Manual or
http://www.condorproject.org/licensefor additional notices. condor-
admin@cs.wisc.edu
date just-man-pages/condor_userprio(1)