lim

Load information daemon or service, monitoring host load.

Synopsis

lim [-d conf_dir] [-c license_file] [-debug_level]
lim -C
lim -t
lim -h
lim -V

Description

There is one lim daemon/service on every host in the cluster. Of these, one lim from the master list is elected master lim for the cluster. The master lim receives load information from the other lim daemons, and provides services to all host.

The lim does the following for the host on which it runs:
  • Starts pem on that host

  • Provides system configuration information to vemkd

  • Monitors load and provides load information statistics to vemkd and users

The master lim starts vemkd and pem on the master host.

The non-master lim daemons monitor the status of the master lim and elect a new master (from the master list) if the current master lim becomes unavailable.

Collectively, the lims in the cluster coordinate the collection and transmission of load information. Load information is collected in the form of load indices.

CAUTION:

Never start the daemon manually without options: specify the -V option to check the version, the -d option to start the daemon in debug mode, or the -C option to validate its configuration files.

Options

-d conf_dir

Starts the daemon, reading from the EGO configuration file ego.conf in the specified directory, rather than from the directory set via the EGO_CONFDIR environment variable.

Use this option when starting the daemon in debug mode.

CAUTION:

Never start the daemon manually unless directed to do so by Platform Technical Support.

-c license _file

Specifies an alternative location to look for the license file rather than the default directory or the directory specified by the EGO_LICENSE_FILE environment parameter in ego.conf.

Specify the full path to the license file including the file name.

CAUTION:

Never start the daemon manually unless directed to do so by Platform Technical Support.

-debug_level

Starts the lim in debug mode. When running in debug mode, the lim uses a hard-coded port number rather than the one registered in system services.

Specify one of the following values:
-1

Starts the lim in the background, with no associated control terminal.

-2

Starts the lim in the foreground, displaying the log messages to the terminal.

CAUTION:

Never start the daemon manually unless directed to do so by Platform Technical Support.

-t

Displays host information, such as host type, host architecture, number of physical processors, number of cores per physical processor, number of threads per core, and license requirements.

Note:

When running Linux kernel version 2.4, you must run lim -t as root to ensure consistent output with other clustered application management commands (for example, output from running Platform LSF command lshosts).

-h

Outputs command usage and exits.

-V

Outputs product version and exits.

Files

ego.conf

The lim reads the configuration file ego.conf to retrieve configuration information. ego.conf is a generic configuration file shared by all daemons/services and clients. It contains configuration information and other information that dictates the behavior of the software.

Some of the parameters lim retrieves from ego.conf are as follows:

EGO_LIM_PORT

The TCP port the lim uses to serve all applications.

EGO_SERVERDIR

The directory used for reconfiguring the lim—where the lim binary is stored.

EGO_LOGDIR

The directory used for message logs.

EGO_LOG_MASK

The log level used to determine the amount of detail logged.

EGO_DEBUG_LIM

The log class setting for the lim.

EGO_LICENSE_FILE

The full path to and name of the EGO license file.

EGO_DEFINE_NCPUS
Defines whether ncpus is to be defined as procs, cores, or threads. This parameter overrides LSF_ENABLE_DUALCORE. If EGO_ENABLE_DUALCORE is set, EGO_DEFINE_NCPUS settings take precedent.
  • procs (if ncpus defined as procs, then ncpus = nprocs)cores (if ncpus defined as cores, then ncpus = nprocs x ncores)

  • threads (if ncpus defined as threads, then ncpus = nprocs x ncores x nthreads)

Note:

When EGO_DEFINE_NCPUS is set, run queue-length values (r1* values returned by lsload) are automatically normalized based on the set value.

If EGO_DEFINE_NCPUS is not defined, but EGO_ENABLE_DUALCORE is set, the lim reports the number of cores. If both EGO_DEFINE_NCPUS and LSF_ENABLE_DUALCORE are set, then the EGO parameter takes precedence.

EGO_ENABLE_DUALCORE

Defines if the hosts have dual cores or not. Is overridden by EGO_DEFINE_NCPUS, if set.

Note:

If EGO_DEFINE_NCPUS is not defined, but EGO_ENABLE_DUALCORE is set, the lim reports the number of cores. If both EGO_DEFINE_NCPUS and LSF_ENABLE_DUALCORE are set, then the EGO parameter takes precedence.

Customization

You can customize the lim by changing configuration files in EGO_CONFDIR directory. Configure ego.cluster.<cluster_name> to define various cluster properties such as the resources on individual hosts, the load threshold values for a host, and so on. Configure ego.shared to define host models read by the lim, or the CPU factor of individual hosts.