perf.conf

The perf.conf file controls the operation of PERF.

About perf.conf

perf.conf specifies the version and configuration of various PERF components and features. The perf.conf file also specifies the file path to PERF directories and the PERF license file.

The perf.conf file is used by Platform Analytics and applications built on top of it. For example, information in perf.conf is used by Platform Analytics daemons and commands to locate other configuration files, executables, and services. perf.conf is updated, if necessary, when you upgrade to a new version of Platform Analytics.

Changing perf.conf configuration

After making any changes to perf.conf, run the following commands to restart the PERF services and apply your changes:

perfadmin stop all

perfadmin start all

Location

The default location of perf.conf is in /conf. If necessary, this default location can be overridden by modifying the PERF_CONFDIR environment variable.

Format

Each entry in perf.conf has the following form:
NAME=VALUE

The equal sign = must follow each NAME and there should be no space beside the equal sign. Text starting with a pound sign (#) are comments and are ignored. Do not use #if as this is reserved syntax for time-based configuration.

DLP_ENABLED

Syntax

DLP_ENABLED=Y | N

Description

Enables data loss protection (DLP) for data loaders. If enabled, you can enable or disable data loss protection for specific data loaders in the Platform Analytics node by editing the specific data loader configuration file. If disabled, data loss protection is disabled in all data loaders in the Platform Analytics node and cannot be enabled in the specific data loader configuration file.

Default

Y (Enabled). In addition, all sampling data loaders have data loss protection enabled by default.

EGO_VERSION

Syntax

EGO_VERSION=version_number

Description

Specifies the version of EGO in the LSF cluster to which the Platform Analytics node belongs.

Example

EGO_VERSION=1.2

Default

By default, EGO_VERSION is set to the version of EGO in the LSF cluster to which the Platform Analytics node belongs.

LICENSE_FILE

Syntax

LICENSE_FILE="file_name ... | port_number@host_name[:port_number@host_name ...]"

Description

Specifies one or more demo or permanent license files used by Platform Analytics.

The value for LICENSE_FILE can be either of the following:
  • The full path name to the license file.

    • UNIX example:

      LICENSE_FILE=/usr/share/lsf/cluster1/conf/license.dat
    • Windows examples:

      LICENSE_FILE= C:\licenses\license.dat

      LICENSE_FILE=\\HostA\licenses\license.dat

  • For a permanent license, the name of the license server host and TCP port number used by the lmgrd daemon, in the format port@host_name. For example:

    LICENSE_FILE="1700@hostD"
  • For a license with redundant servers, use a comma to separate the port@host_names. The port number must be the same as that specified in the SERVER line of the license file. For example:

    UNIX:
    LICENSE_FILE="port@hostA:port@hostB:port@hostC"
    Windows:
    LICENSE_FILE="port@hostA;port@hostB;port@hostC"

Multiple license files should be quoted and must be separated by a pipe character (|).

Windows example:
LICENSE_FILE="C:\licenses\license1|C:\licenses\license2|D:\mydir\license3"

Multiple files may be kept in the same directory, but each one must reference a different license server. When checking out a license, Platform Analytics searches the servers in the order in which they are listed, so it checks the second server when there are no more licenses available from the first server.

If this parameter is not defined, Platform Analytics assumes the default location.

Default

By default, LICENSE_FILE is set as the file path to the license file that you specified during the initial Platform Analytics installation.

If you installed FLEXlm separately from Platform Analytics to manage other software licenses, the default FLEXlm installation puts the license file in the following location:
  • UNIX: /usr/share/flexlm/licenses/license.dat

  • Windows: C:\flexlm\license.dat

LICENSE_VERSION

Syntax

LICENSE_VERSION=version_number

Description

Specifies the version of the license module installed with Platform Analytics.

Example

LICENSE_VERSION=7.0

Default

Not defined.

LOADER_BATCH_SIZE

Syntax

LOADER_BATCH_SIZE=integer

Description

Specifies the number of SQL statements that can be submitted to the database at the same time.

Valid values

Any positive, non-zero integer.

Default

5000

LSF_ENVDIR

Syntax

LSF_ENVDIR=directory

Description

Specifies the LSF configuration directory, which is the directory containing the lsf.conf file.

Default

/etc

LSF_VERSION

Syntax

LSF_VERSION=version_number

Description

Specifies the version of LSF in the cluster to which the Platform Analytics node belongs.

Example

LSF_VERSION=7.0

Default

By default, LSF_VERSION is set to the version of LSF in the cluster to which the Platform Analytics node belongs.

PERF_CONFDIR

Syntax

PERF_CONFDIR=directory

Description

Specifies the configuration directory, which contains the configuration files for Platform Analytics node components.

Default

  • UNIX: ANALYTICS_TOP/conf

  • Windows: ANALYTICS_TOP\conf

where ANALYTICS_TOP is the top-level Platform Analytics node installation directory.

PERF_LOGDIR

Syntax

PERF_LOGDIR=directory

Description

Specifies the logging directory, which contains the log files for Platform Analytics node components.

Default

  • UNIX: ANALYTICS_TOP/log

  • Windows: ANALYTICS_TOP\log

where ANALYTICS_TOP is the top-level Platform Analytics node installation directory.

PERF_TOP

Syntax

PERF_TOP=directory

Description

Specifies the top-level PERF directory.

Default

  • UNIX: ANALYTICS_TOP

  • Windows: ANALYTICS_TOP

where ANALYTICS_TOP is the top-level Platform Analytics node installation directory.

PERF_VERSION

Syntax

PERF_VERSION=version_number

Description

Specifies the version of PERF installed with the Platform Analytics node.

Example

PERF_VERSION=1.2.3

Default

Not defined.

PERF_WORKDIR

Syntax

PERF_WORKDIR=directory

Description

Specifies the working directory.

Default

  • UNIX: ANALYTICS_TOP/work

  • Windows: ANALYTICS_TOP\work

where ANALYTICS_TOP is the top-level Platform Analytics node installation directory