Configuring the lsf.shared resource section

About this task

Define configured resources in the Resource section of lsf.shared. There is no distinction between shared and non-shared resources. When optional attributes are not specified, the resource is treated as static and Boolean.

Procedure

  1. Specify a name and description for the resource, using the keywords RESOURCENAME and DESCRIPTION.
    Resource names are case sensitive and can be up to 39 characters in length, with the following restrictions:
    • Cannot begin with a number
    • Cannot contain the following special characters
      :  .  (  )  [  +  - *  /  !  &  | <  >  @  = ,
    • Cannot be any of the following reserved names:
      cpu cpuf io logins ls idle maxmem maxswp maxtmp type model 
      status it mem ncpus nprocs ncores nthreads
      define_ncpus_cores define_ncpus_procs define_ncpus_threads
      ndisks pg r15m r15s r1m swap swp tmp ut local
      dchost jobvm
    • Cannot begin with inf or nan (uppercase or lowercase). Use -R "defined(infxx)" or -R "defined(nanxx)"instead if required.
    • For Solaris machines, the keyword int is reserved and cannot be used.
  2. Optional. Specify optional attributes for the resource.
    1. Set the resource type (TYPE = Boolean | String | Numeric). Default is Boolean.
    2. For dynamic resources, set the update interval (INTERVAL, in seconds).
    3. For numeric resources, set so that a higher value indicates greater load (INCREASING = Y)
    4. For numeric shared resources, set so that LSF releases the resource when a job using the resource is suspended (RELEASE = Y).
    5. Set resources as consumable in the CONSUMABLE column.

      Static and dynamic numeric resources can be specified as consumable. A non-consumable resource should not be releasable and should be usable in order, select and same sections of a resource requirement string.

      Defaults for built-in indices:
      • The following are consumable: r15s, r1m, r15m, ut, pg, io, ls, it, tmp, swp, mem.
      • All other built-in static resources are not consumable. (For example, ncpus, ndisks, maxmem, maxswp, maxtmp, cpuf, type, model, status, rexpri, server, hname).
      Defaults for external shared resources:
      • All numeric resources are consumable.
      • String and boolean resources are not consumable.
      Note: Non-consumable resources are ignored in rusage sections. LSF rejects resource requirement strings where an rusage section contains a non-consumable resource.
    Begin Resource
    RESOURCENAME  TYPE    INTERVAL INCREASING CONSUMABLE DESCRIPTION  # Keywords
       patchrev   Numeric  ()        Y         ()         (Patch revision)
       specman    Numeric  ()        N         ()         (Specman)
       switch     Numeric  ()        Y         N          (Network Switch)
       rack       String   ()        ()        ()         (Server room rack)
       owner      String   ()        ()        ()         (Owner of the host)
       elimres    Numeric  10        Y         ()         (elim generated index)
    End Resource
  3. Run lsinfo -l to view consumable resources.
    lsinfo -l switch
    RESOURCE_NAME:  switch
    DESCRIPTION: Network Switch
    TYPE    ORDER   INTERVAL  BUILTIN  DYNAMIC  RELEASE CONSUMABLE
    Numeric   Inc          0       No       No      No         No
     
    lsinfo -l specman
    RESOURCE_NAME:  specman
    DESCRIPTION: Specman
    TYPE    ORDER   INTERVAL  BUILTIN  DYNAMIC  RELEASE CONSUMABLE
    Numeric   Dec          0       No       No      Yes        Yes

Resources required for JSDL

The following resources are pre-defined to support the submission of jobs using JSDL files.
Begin Resource
RESOURCENAME TYPE  INTERVAL INCREASING DESCRIPTION
osname       String   600   ()        (OperatingSystemName)
osver        String   600   ()        (OperatingSystemVersion)
cpuarch      String   600   ()        (CPUArchitectureName)
cpuspeed     Numeric  60    Y         (IndividualCPUSpeed)
bandwidth    Numeric  60    Y         (IndividualNetworkBandwidth)
End Resource