IMPORTQUOTA(8)

NAME
importquota - change running parameters for customs

SYNOPSIS
importquota [-check check-interval ] [-localjobs available ] [-idle min-idle ] [-idlecrit criteria ] [-load min-load-average ] [-swap min-pct ] [-proc min-procs ] [-cpu max-cputime ] [-memory max-memory-use ] [-nice nice-level ] [-npri priority ] [-evict eviction-delay ] [-access user-access-level ] [-jobs max-jobs ] [-default ] [-q[uiet] ] [-h[elp] ]

DESCRIPTION

Importquota is used to modify the criteria customs(8) uses to determine the local machine's availability as a compute server for other machines, as well as the base interval at which the machine's availability is determined.

The criteria and their flags are:

-jobs max-jobs
    There may be at most max-jobs running on behalf of other systems.

-swap min-pct
    At least min-pct percent of the machine's swap space must be free.

-proc min-procs
    At least min-procs free slots for additional processes must be available.

-load max-load
    The one-minute load average for the machine may not exceed max-load.

-idle min-idle
    Logins on the machine must have been idle for at least min-idle seconds (the argument may be given as min:sec for convenience).

-idlecrit criteria
    Selects the criteria (terminal devices) used to determine idle times. The argument is a sum of small integers denoting a combination of criteria, explained further in customs(8).

-localjobs allowed
    If allowed is non-zero even local clients can start jobs through the customs daemon.

Additionally, the following flags control accessibility and resource limits for imported jobs.

-cpu max-cputime
    Sets the maximum amount of CPU time allowed for an imported job (given as min:sec).

-memory max-memory-use
    Sets the maximum amount of real memory allowed to the imported job (specified in Kbytes).

-nice nice-level
    Sets a minimum nice value greater that 0 (i.e., lower priority) for imported jobs to execute at.

-npri priority
    Sets a non-degrading priority for imported jobs. (This feature is specific to SGI systems.)

-evict eviction-delay
    Sets a time after which imported processes are terminated if a machine ceases to be idle.

-access user-access-level
    Changes the level of user access checking performed by the local customs daemon, as explained in customs(8).

There are limits to these various parameters, to insure that the machine will be available some of the time. If an invalid parameter is given, none of the other parameters will be set. You will be told the valid range for the offending parameter(s). The one exception to these ranges is a value of 0 (e.g. "-swap 0"). If any parameter is set to 0, that parameter is ignored as an availability criterion or access restriction until it is reset to a non-zero value.

Importquota will print out the current criteria when it is done, even if no parameters are altered. Thus just typing "importquota" will give you the current criteria for your machine. Certain criteria may no be available on certain platforms, in which case they will be ignored and not be printed.

Customs may also be told to check the machine's availability at a different interval by means of the -check flag. The interval serves two purposes:

-   It serves to track the state of the machine -- the longer the interval, the less responsive customs will be to changes in the machine state.

-   It gives a definite time within which the master agent will hear from the machine if that machine is still up. If no message is received within the given interval (which may be different for each machine), the master considers the machine down and will not attempt to allocate it until another message is received from it.

The default check interval is 10 seconds, but 30 is probably more reasonable, as machines also return their availability each time they are allocated by the master agent, allowing a faster reaction to machine-state changes than might be implied by the check interval. The shortest allowed check interval is 5 seconds.

The -default flag can be used to set -check and all availability parameters to their default values.

-q or -quiet suppresses the printing of the current availability criteria on the standard output.

-h or -help prints a summary of options and changes nothing.

SEE ALSO
customs(8), cctrl(8), reginfo(1), pmake(1), logd(8), export(1)

AUTHOR
Adam de Boor, adam@bsw.uu.net (...!uunet!bsw!adam).
Bugfixes and enhancements by Andreas Stolcke (stolcke@icsi.berkeley.edu).