condor_userprio

Manage user priorities

Synopsis

condor_userprio [-pool hostname] [-all] [-usage] [-setprio username value] [-setfactor username value] [-resetusage username] [-resetall] [-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 -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 privilages.

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 usernames on the command line, the name must include the uid domain (e.g. user@uid-domain - exactly the same way usernames 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).

Options

Supported options are as follows:

-pool hostname

Contact the specified hostname instead of the local central manager. This can be used to check other pools.

-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.

-setpfactor username value

Set the priority factor 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.

-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.

Author

Condor Team, University of Wisconsin-Madison

Copyright

Copyright © 1990-1998 Condor Team, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. No use of the Condor Software Program is authorized without the express consent of the Condor Team. For more information contact: Condor Team, Attention: Professor Miron Livny, 7367 Computer Sciences, 1210 W. Dayton St., Madison, WI 53706-1685, (608) 262-0856 or miron@cs.wisc.edu. U.S. Government Rights Restrictions: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of Commercial Computer Software-Restricted Rights at 48 CFR 52.227-19, as applicable, Condor Team, Attention: Professor Miron Livny, 7367 Computer Sciences, 1210 W. Dayton St., Madison, WI 53706-1685, (608) 262-0856 or miron@cs.wisc.edu.

See the Condor Version 6.1.2 Manual for additional notices.