Learn more about Platform products at http://www.platform.com

[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]


install.config

Contents

[ Top ]

About install.config

The install.config file contains options for Platform LSF installation and configuration. Use lsfinstall -f install.config to install LSF using the options specified in install.config.

Template location

A template install.config is included in the LSF installation script tar file lsf6.0_lsfinstall.tar.Z and is located in the lsf6.0_lsfinstall directory created when you uncompress and extract installation script tar file. Edit the file and uncomment the options you want in the template file. Replace the example values with your own settings to specify the options for your new LSF installation.

The sample values in the install.config template file are examples only. They are not default installation values.

After LSF installation, the install.config containing the options you specified is located in LSF_TOP/6.0/install/.

Format

Each entry in install.config has the form: 

NAME="STRING1 STRING2 ..."

The equal sign = must follow each NAME even if no value follows and there should be no spaces around the equal sign.

A value that contains multiple strings separated by spaces must be enclosed in quotation marks.

[ Top ]

Parameters

LSF_ADD_SERVERS

Syntax

LSF_ADD_SERVERS="host_name [ host_name...]"

Description

Lists the hosts in the cluster to be set up as LSF server hosts. The first host in the list becomes the LSF master host in lsf.cluster.cluster_name.

Valid Values

Any valid LSF host name

Example 

LSF_ADD_SERVERS="hosta hostb hostc hostd"

hosta is the LSF master host.

Default

The local host where lsfinstall is running

See Also

LSF_ADD_CLIENTS

LSF_ADD_CLIENTS

Syntax

LSF_ADD_CLIENTS="host_name [ host_name...]"

Description

Lists the hosts in the cluster to be set up as LSF client-only hosts.

Valid Values

Any valid LSF host name

Example 

LSF_ADD_CLIENTS="hoste hostf"

Default

None

See Also

LSF_ADD_SERVERS

LSF_ADMINS

Syntax

LSF_ADMINS="user_name [ user_name ... ]"

Description

Lists the LSF administrators. The first user account name in the list is the primary LSF administrator in lsf.cluster.cluster_name.

The LSF administrator accounts must exist on all hosts in the LSF cluster before installing LSF

The primary LSF administrator account is typically named lsfadmin. It owns the LSF configuration files and log files for job events. It also has permission to reconfigure LSF and to control batch jobs submitted by other users. It typically does not have authority to start LSF daemons. Unless an lsf.sudoers file exists to grant LSF administrators permission, only root has permission to start LSF daemons.

CAUTION

You should not configure the root account as the primary LSF administrator.

Valid Values

User accounts for LSF administrators must exist on all hosts in the LSF cluster before running lsfinstall.

Example 

LSF_ADMINS="lsfadmin user1 user2"

Default

None--required variable

LSF_CLUSTER_NAME

Syntax

LSF_CLUSTER_NAME="cluster_name"

Description

Defines the name of the LSF cluster. Do not use an LSF host name.

Valid Values

Any alphanumeric string containing no more than 39 characters. The name cannot contain white spaces.

Recommended Value

You should not use a valid host name as the cluster name, but the same general principles apply to naming your cluster as naming hosts.

Example 

LSF_CLUSTER_NAME="cluster1"

Default

None--required variable

LSF_LICENSE

Syntax

LSF_LICENSE="/path/license_file"

Description

Full path to the name of the LSF license file. You must have a valid license file to install LSF.

If you do not specify LSF_LICENSE, or lsfinstall cannot find a valid license file in the default location, lsfinstall exits.

Recommended Value

/path/license.dat

Example 

LSF_LICENSE="/usr/share/lsf_distrib/liscense.dat"

Default

/current_directory/license.dat

LSF_MASTER_LIST

Syntax

LSF_MASTER_LIST="host_name [ host_name ...]"

Description

Optional. Defines a list of hosts that are candidates to become the master host for the cluster. Listed hosts must be defined as servers in LSF_ADD_SERVERS.

Required for dynamic host configuration. To dynamically add or remove hosts, you must specify a list of candidate master hosts. If you do not need to add or remove hosts dynamically, you can leave this parameter undefined during new installation or upgrade.

Specify a list of host names two ways:

Master candidate hosts should share LSF configuration and binaries.

Valid Values

Any valid LSF host name

Examples

Default

None--optional variable

LSF_QUIET_INST

Syntax

LSF_QUIET_INST="y /n"

Description

Do not display lsfinstall messages.

Example 

LSF_QUIET_INST="y"

Default

Display all messages. (LSF_QUIET_INST="n")

LSF_TARDIR

Syntax

LSF_TARDIR="/path"

Description

Full path to the directory containing the LSF distribution tar files.

Example 

LSF_TARDIR="/usr/share/lsf_distrib"

Default

The parent directory of the current working directory where lsfinstall is running (../current_directory)

LSF_TOP

Syntax

LSF_TOP="/path"

Description

Top-level LSF installation directory.

Valid Values

Must be an absolute path to a shared directory that is accessible to all LSF hosts. Cannot be the root directory (/).

Recommended Value

The file system containing LSF_TOP must have enough disk space for all host types (approximately 300 MB per host type).

Example 

LSF_TOP="/usr/share/lsf"

Default

None--required variable

SEE ALSO

lsfinstall(8), lsf.cluster(5), lsf.sudoers(5), slave.config(5)

[ Top ]

[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]

      Date Modified: February 24, 2004
Platform Computing: www.platform.com

Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Copyright © 1994-2004 Platform Computing Corporation. All rights reserved.