lsf windows install

7/29/2019 Lsf Windows Install

1/17

Installing Platform LSF on Windows

Platform LSFVersion 7 Update 3

Release date: May 2008Last modified: April 28 2008


2/17

Copyright 1994-2008 Platform Computing Inc.

Although the information in this document has been carefully reviewed, Platform Computing Corporation (Platform) does notwarrant it to be free of errors or omissions. Platform reserves the right to make corrections, updates, revisions or changes to theinformation in this document.

UNLESS OTHERWISE EXPRESSLY STATED BY PLATFORM, THE PROGRAM DESCRIBED IN THIS DOCUMENT ISPROVIDED AS IS AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT

NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.IN NO EVENT WILL PLATFORM COMPUTING BE LIABLE TO ANYONE FOR SPECIAL, COLLATERAL, INCIDENTAL, ORCONSEQUENTIAL DAMAGES, INCLUDING WITHOUT LIMITATION ANY LOST PROFITS, DATA, OR SAVINGS, ARISINGOUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM.

Wed like to hearfrom you

You can help us make this document better by telling us what you think of the content, organization, and usefulness of the information.If you find an error, or just want to make a suggestion for improving this document, please address your comments [email protected].

Your comments should pertain only to Platform documentation. For product support, contact [email protected].

Documentredistribution andtranslation

This document is protected by copyright and you may not redistribute or translate it into another language, in part or in whole.

Internal

redistribution

You may only redistribute this document internally within your organization (for example, on an intranet) provided that you continue

to check the Platform Web site for updates and update your version of the documentation. You may not make it available to yourorganization over the Internet.

Trademarks LSF is a registered trademark of Platform Computing Corporation in the United States and in other jurisdictions.

ACCELERATING INTELLIGENCE, PLATFORM COMPUTING, PLATFORM SYMPHONY, PLATFORM JOBSCHEDULER,PLATFORM ENTERPRISE GRID ORCHESTRATOR, PLATFORM EGO, and the PLATFORM and PLATFORM LSF logos aretrademarks of Platform Computing Corporation in the United States and in other jurisdictions.

UNIX is a registered trademark of The Open Group in the United States and in other jurisdictions.

Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.

Microsoft is either a registered trademark or a trademark of Microsoft Corporation in the United States and/or other countries.

Windows is a registered trademark of Microsoft Corporation in the United States and other countries.

Intel, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States andother countries.

Other products or services mentioned in this document are identified by the trademarks or service marks of their respective owners.

Third-party licenseagreements

http://www.platform.com/Company/third.part.license.htm

Third-partycopyright notices

http://www.platform.com/Company/Third.Party.Copyright.htm


3/17

ContentsExample installation directory structures ............................................................................... 5EGO in the LSF cluster .......................................................................................................... 7Plan and prepare your systems for installation ..................................................................... 8Install a new Platform LSF cluster ......................................................................................... 9

Installation parameter quick reference ................................................................................ 10

Installation parameters .................................................................................................. 10

Installing Platform LSF on Windows 3


4/17

4 Installing Platform LSF on Windows


5/17

Example installation directory structures




6/17

Shared directoryThe shared directory is configured if you run egoconfig on a host after installation:




7/17

EGO in the LSF cluster

When EGO is enabled in the cluster, EGO may control services for components such as the Platform ManagementConsole (PMC) or LSF Reports (PERF). This is recommended. It allows failover among multiple management hosts,and allows EGO cluster commands to start, stop, and restart the services.

See the LSF administrator documentation for more detail about the benefits of enabling EGO and using EGO to controlthe services.

Installation choicesWhen you install the cluster and enable EGO, you can configure the following separately:

EGO control ofsbat chdandr es

EGO control of PMC (webgui )

EGO control of PERF services (pl c,j obdt ,pur ger , andderbydb)

For example, you could choose EGO control for PERF services, but not sbat chdandr es, and not PMC.

For PMC, if it is not controlled by EGO, you must specify the host to run PMC. Do not specify a PMC host when PMCis controlled by EGO. I f you do, the EGO failover feature cannot work because the PMC cannot start on any other host.

For PERF, if the services are not controlled by EGO, you must specify the host to run PERF services pl c,j obdt , andpur ger . Do not specify a PERF host when PERF services are controlled by EGO. If you do, the EGO failover featurecannot work because the services cannot start on any other host.

EGO in the LSF cluster



8/17

Plan and prepare your systems for

installation

MSI version 2.0 or later is required. Choose LSF hosts (master host, master candidates, database host, server hosts, and client-only hosts). If EGO does

not manage PMC or PERF, you must also choose PMC and PERF hosts, otherwise it is optional.

Choose an installation directory that is available on every host.

For failover purposes, create and share the shared directory (e.g., \\HostF\EGOshare). Ensure the shared directoryis accessible with the same path name from all master candidates.

On master candidates, free the web server ports 8080, 8005, and 8009; the service director port, 53; the web servicegateway port, 9090; and the database port, 1527.

Review the installation parameter reference, make sure the connection ports and LSF sbatchd, res, and mbatchdports are available on all host.

Choose a primary LSF administrator (owns the LSF and EGO configuration files and log files; e.g., DOMAIN\lsfadmin). Create the primary LSF administrator account with these privileges on each host:

Act as part of the operating system

Debug programs

Replace a process level token

Log on as a service

Increase quotas

Note:

The account should belong to the Local Administrators group on each host.

Get the LSF distribution file. See the LSF Version 7 Release Notes for detailed steps for downloading.

Get an LSF license file (license.dat).

Note:

You must have a valid license file to install. If the installer cannot find the license,

it exits.

Plan and prepare your systems for installation



9/17

Install a new Platform LSF cluster

1. Install the master. Log on as lsfadmin to the master host (or use an installation account that belongs to the LocalAdministrators group) and run the installer (lsf7Update3_win.msi)

2. Install additional hosts.3. Run egoconfig mghost on each LSF management host (omit this step if your cluster has only one host). Specify the

shared directory and the name and password of the primary LSF admnistrator (egoconfig mghost shared_diruser_name password). For example:

egoconfig mghost \\HostF\EGOshare DOMAIN\lsfadmin mypasswd

4. To enable failover, define your master candidates (omit this step if your cluster has only one host). List in the desiredfailover order, starting with the master host (egoconfig masterlist host_name ...). For example:

egoconfig masterlist HostM,HostB,HostX

5. Log on to the master host as lsfadmin and run lsfstartup to start the cluster.

6. Run lspasswd as primary cluster administrator (lsfadmin) to set LSF Batch user password.

7. If PMC is not controlled by EGO, log onto the PMC host and run

pmcadmin start

Optional: enable Automatic Startup of the Windows service so that PMC can restart if the host restarts.

8. If PERF is not controlled by EGO, log onto the PERF host and run:

perfadmin start all

Optional: enable Automatic Startup of the Windows service so that PERF can restart if the host restarts.

9. If PERF is not controlled by EGO, and the Derby DB host is not the PERF host, log onto the Derby DB host andrun:

perfadmin start all

10.Test your cluster by running some basic LSF commands (e.g., lsid, lshosts, bhosts).

11.Test the Platform Management Console (PMC). Browse to the web server URL and log in to the PMC using theLSF administrator name and password.

The web server URL is:

http://host_name:8080/platform

The host name is the PMC host you specified.

If PMC is controlled by EGO and you did not specify the PMC host, log on as LSF administrator and run:

egosh client view GUIURL_1

The additional information shows the full URL including the host name and port.

Install a new Platform LSF cluster



10/17

Installation parameter quick reference

Use this reference to learn about the install parameters.

Installation parametersThe installation parameters are configured automatically by the interactive installer. The related interactive installwindow is shown for each parameter.

If you do not use the interactive installer, specify command-line installation options as needed. The syntax is shownfor each parameter.

For silent install with msiexec, the msiexec syntax is:

msiexec /i package_f i l e [ paramet er _val ue . . . ] /quiet

For example, to install a compute host and specify the installation directory:

msi exec / i \ \ host B\ downl oad\ l sf 7. 0. 3_wi n32. msi MASTERHOST=host M HOSTTYPE=comput e CLUSTERADMI N=l sf\ l sf admi n I NSTALLDI R=C: \ LSF / qui et

For silent uninstall, the msiexec syntax is:

msiexec /x package_f i l e /quiet

Parameter referenceThe installer may require the following parameters.

MASTERHOST (Master Host window)

DescriptionName of the cluster master host.

SyntaxMASTERHOST=host_name

e.g. MASTERHOST=HostM

DefaultNone - required variable

LICENSEFILE (License File window)

Description

Full path to the LSF license file (license.dat). You must have a valid license file to install LSF.

SyntaxLICENSEFILE="\path\license_file"

e.g. LICENSEFILE="C:\license.dat"

*master host only




11/17

DefaultNonerequired variable

HOSTTYPE (Install Type window)

DescriptionCompute host package or full package. Install the full package on master candidates. Installthe compute host package on regular LSF servers or LSF clients.

SyntaxHOSTTYPE=Compute| Management

e.g. HOSTTYPE=Compute

DefaultFull installation

*master host always gets full package

SERVICETYPE (SBD and RES Control window)

DescriptionSet the value to "EGO" if you want EGO Service Controller to start LSF res and sbatchd, andrestart if they fail.

SyntaxSERVICETYPE=EGO| LSF

e.g. SERVICETYPE=EGO

DefaultLSFres and sbatchd are managed as Windows services

CLUSTERNAME (Cluster Name window)

DescriptionName of the LSF cluster. Do not use the same name as any LSF host, user or user group.

SyntaxCLUSTERNAME=cluster_name

e.g. CLUSTERNAME=Research

DefaultCluster1




12/17

INSTALLDIR (Installation Directory window)

DescriptionFull path to the top-level LSF installation directory.

SyntaxINSTALLDIR=path

e.g. INSTALLDIR=C:\PlatformLSF7

DefaultC:\LSF_7.0

CLUSTERID (Cluster ID window)

DescriptionThis parameter is not required for normal installation of a new cluster. Specify the unique

Cluster ID of your cluster.

Cluster ID is used to identify different clusters when one host belongs to multiple clusters. Itis appended to Windows service names, for example, if your cluster ID is "service", the limservice serving your cluster is named "Platform LIM service" instead of "Platform LIM".

SyntaxCLUSTERID=cluster_id

e.g. CLUSTERID=research

Default

undefined

CLUSTERADMIN (Cluster Administrator window)

DescriptionCluster administrator (lsfadmin).

SyntaxCLUSTERADMIN=domain\user_name

or

CLUSTERADMIN=.\user_name

e.g. CLUSTERADMIN="DOMAIN\lsfadmin"

Defaultinstallation account is the default cluster administrator




13/17

ADMINPASSWD (Cluster Administrator window)

DescriptionActual password of the cluster administrator account (lsfadmin).

SyntaxADMINPASSWD="password"

e.g. ADMINPASSWD="mypasswd"

* master host only

DefaultNone - required

BASEPORT (LSF Ports window)

DescriptionBase connection port. LSF uses 4 consecutive ports starting from the base port, e.g., 7869-7872.

SyntaxBASEPORT=port_number

e.g. BASEPORT=7869

Default7869

* indicates ports 7869-7872

RESPORT (LSF Ports window)Description

LSF res port.

SyntaxRESPORT=port_number

e.g. RESPORT=6882

Default

6882

SBDPORT (LSF Ports window)

DescriptionLSF sbatchd port.




14/17

SyntaxSBDPORT=port_number

e.g. BASEPORT=6878

Default6878

MBDPORT (LSF Ports window)

DescriptionLSF mbatchd port.

SyntaxMBDPORT=port_number

e.g. MBDPORT=6881

Default6881

DBHOST (Derby DB Host window)

DescriptionReporting database host. Specify the name of a reliable master candidate host where the Derbydatabase for Reporting will be installed.

Syntax

DBHOST=host_namee.g. DBHOST=hostd

*master host only

Defaultmaster host is the default DB host

DYNAMICHOST (Dynamic Hosts window)

DescriptionSet the value to Yes to enable dynamic hosts in LSF. After installation, configure security for

dynamic hosts.

SyntaxDYNAMICHOST=Yes | No

e.g. DYNAMICHOST=Yes




15/17

DefaultNohosts cannot join the cluster dynamically

LSFHOSTTYPE (LSF Host Type window)

DescriptionLSF server host or LSF client host.

SyntaxLSFHOSTTYPE=Server | Client

e.g. LSFHOSTTYPE=Server

*no choice on the master host

DefaultServerLSF server host

STARTUP (Startup window)

DescriptionSet the value to "No" to disable automatic startup of LSF after installation.

SyntaxSTARTUP=Yes | No

e.g. STARTUP=Yes

*for master host or master candidates, specify No

DefaultYesstart LSF automaticallye

ENABLEEGO (Enable EGO window)

DescriptionSet the value to "Yes" if you want to enable advanced EGO features.

SyntaxENABLEEGO=Yes | No

e.g. ENABLEEGO=Yes

DefaultYesEnable advanced EGO features




16/17

SERVERHOSTS (Server Hosts window)

DescriptionDefine LSF server hosts that this host can contact.

SyntaxSERVERHOSTS=host_name ...

e.g. SERVERHOSTS=HostM HostW

DefaultNoneOptional on master host, required on slave for interactive installation

EGOPMCCONTROL (PMC Control window)

DescriptionSet the value to "Yes" if you want EGO Service Controller to start PMC, and restart if it fails.

SyntaxEGOPMCCONTROL=Yes | No

e.g. EGOPMCCONTROL=Yes

DefaultYesEnable EGO control for PMC

EGOPERFCONTROL (PERF Control window)

DescriptionSet the value to "Yes" if you want EGO Service Controller to start PERF, and restart if it fails.

SyntaxEGOPERFCONTROL=Yes | No

e.g. EGOPERFCONTROL=Yes

DefaultYesEnable EGO control for PERF

PERFHOST (PERF Control window)

DescriptionName of the PERF host.

SyntaxPERFHOST=host_name




17/17

e.g. PERFHOST=HostP

DefaultIf PERF is controlled by EGO, no default - PERF services may run on any management host.

If PERF is not controlled by EGO, no default - required variable.

PMCHOST (PMC Control window)

DescriptionName of the PMC host.

SyntaxPMCHOST=host_name

e.g. PMCHOST=HostW

DefaultIf PMC is controlled by EGO, no default - PMC services may run on any management host.

If PMC is not controlled by EGO, no default - required variable.


lsf windows install

Documents