table of contents
condor_userprio(1) | General Commands Manual | condor_userprio(1) |
Name¶
condor_userprio Manage - user prioritiesSynopsis¶
condor_userprio [-pool centralmanagerhostname[:portnumber]] [Edit option] [Display options]Description¶
condor_userprio either modifies priority-related information or displays priority-related information. Displayed information comes from the accountant log, where the condor_negotiatordaemon stores historical usage information in the file at $(SPOOL) /Accountantnew.log . Which fields are displayed changes based on command line arguments. condor_userprio with no arguments, lists the active users along with their priorities, in increasing priority order. The -alloption can be used to display more detailed information about each user, resulting in a rather wide display, and 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.
- The value of the real priority of the user. This value follows the user's resource usage.
- 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.
- The number of resources currently used.
- The accumulated number of resource-hours used by the user since the 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.
- The most recent time a resource usage has been recorded for the user.
Options¶
-pool centralmanagerhostname[:portnumber]- Contact the specified centralmanagerhostnamewith an optional port number, instead of the local central manager. This can be used to check other pools. NOTE: The host name (and optional port) specified refer to the host name (and port) of the condor_negotiatorto query for user priorities. This is slightly different than most HTCondor tools that support a -pooloption, and instead expect the host name (and port) of the condor_collector.
- (Edit option) Remove the specified usernamefrom HTCondor's accounting.
- (Edit option) Reset the accumulated usage of all the users to zero.
- (Edit option) Reset the accumulated usage of the user specified by usernameto zero.
- (Edit option) Set the accumulated usage of the user specified by usernameto the specified floating point value.
- (Edit option) Set the begin usage time of the user specified by usernameto the specified value.
- (Edit option) Set the priority factor of the user specified by usernameto the specified value.
- (Edit option) Set the last usage time of the user specified by usernameto the specified value.
- (Edit option) Set the real priority of the user specified by usernameto the specified value.
- (Display option) Display information for users who have some recorded accumulated usage since the specified date.
- (Display option) Display all available fields about each group or user.
- (Display option) Display information for all the users who have some recorded accumulated usage.
- (Display option) Display information such that users within hierarchical groups are notlisted with their group.
- (Display option) Display all the resources currently allocated to the user specified by username.
- (Display option) Display submitter information with accounting group entries at the top of the list, and in breadth-first order within the group hierarchy tree.
- (Display option) For hierarchical groups, the display shows sums as computed for groups, and these sums include sub groups.
- (Display option) Display information such that users within hierarchical groups are listed with their group.
- (Display option) A verbose output which displays entire ClassAds.
- (Display option) Display fields considered to be the most useful. This is the default set of fields displayed.
- (Display option) Display fields with user priority information.
- (Display option) Display fields relevant to hierarchical group quotas.
- (Display option) Display usage information for each group or user.
Examples¶
Example 1Since the output varies due to command line arguments, here is an example of the default output for a pool that does not use Hierarchical Group Quotas. This default output is the same as given with the -mostDisplay option. Last Priority Update: 1/19 13:14Effective Priority Res Total Usage Time Since
User Name Quota Surplus Priority Factor In Use (wghted-hrs) Last Usage
johnsm@crane.cs.wisc.edu 0.50 1.00 0 6.62 9+19:42
John.Smith@crane.cs.wisc.edu 0.50 1.00 0 0.02 9+03:52
Sedge@crane.cs.wisc.edu 0.50 1.00 0 0.05 13+03:03
Duck@crane.cs.wisc.edu 0.50 1.00 0 0.02 31+00:28
other@crane.cs.wisc.edu 0.50 1.00 0 0.04 16+03:42
goose@crane.cs.wisc.edu 0.50 1.00 0 0.02 13+02:57
johnsm@crane.cs.wisc.edu 0.50 1.00 0 0.13 9+03:08
Half@crane.cs.wisc.edu 0.50 1.00 0 0.02 31+00:02
John.Smith@crane.cs.wisc.edu 0.50 1.00 0 0.05 9+03:07
other@crane.cs.wisc.edu 0.50 1.00 0 0.01 28+19:34
Exit Status¶
condor_userpriowill exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure.Author¶
Center for High Throughput Computing, University of Wisconsin-MadisonCopyright¶
Copyright (C) 1990-2014 Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.January 2015 |