LSF_ULDB_DOMAIN

Syntax

LSF_ULDB_DOMAIN="domain_name ..."

Description

LSF_ULDB_DOMAIN specifies the name of the LSF domain in the ULDB domain directive. A domain definition of name domain_name must be configured in the SGI IRIX jlimit.in input file.

Used with IRIX User Limits Database (ULDB). Configures LSF so that jobs submitted to a host with the IRIX job limits option installed are subject to the job limits configured in the IRIX User Limits Database (ULDB).

The ULDB contains job limit information that system administrators use to control access to a host on a per user basis. The job limits in the ULDB override the system default values for both job limits and process limits. When a ULDB domain is configured, the limits are enforced as IRIX job limits.

If the ULDB domain specified in LSF_ULDB_DOMAIN is not valid or does not exist, LSF uses the limits defined in the domain named batch. If the batch domain does not exist, then the system default limits are set.

When an LSF job is submitted, an IRIX job is created, and the job limits in the ULDB are applied.

Next, LSF resource usage limits are enforced for the IRIX job under which the LSF job is running. LSF limits override the corresponding IRIX job limits. The ULDB limits are used for any LSF limits that are not defined. If the job reaches the IRIX job limits, the action defined in the IRIX system is used.

IRIX job limits in the ULDB apply only to batch jobs.

See the IRIX resource administration documentation for information about configuring ULDB domains in the jlimit.in file.

LSF resource usage limits controlled by ULDB

  • PROCESSLIMIT:  Corresponds to IRIX JLIMIT_NUMPROC; fork() fails, but the existing processes continue to run

  • MEMLIMIT :  Corresponds to JLIMIT_RSS; Resident pages above the limit become prime swap candidates

  • DATALIMIT :  Corresponds to LIMIT_DATA; malloc() calls in the job fail with errno set to ENOMEM

  • CPULIMIT:  Corresponds to JLIMIT_CPU; IRIX sends SIGXCPU signal to job, then after the grace period expires, sends SIGINT, SIGTERM, and SIGKILL

  • FILELIMIT:  No corresponding IRIX limit; use process limit RLIMIT_FSIZE

  • STACKLIMIT :  No corresponding IRIX limit; use process limit RLIMIT_STACK

  • CORELIMIT:  No corresponding IRIX limit; use process limit RLIMIT_CORE

  • SWAPLIMIT:  Corresponds to JLIMIT_VMEM; use process limit RLIMIT_VMEM

Increase the default MEMLIMIT for ULDB

In some pre-defined LSF queues, such as normal, the default MEMLIMIT is set to 5000 (5 MB). However, if ULDB is enabled (LSF_ULDB_DOMAIN is defined) the MEMLIMIT should be set greater than 8000 in lsb.queues.

Default

Not defined