[ Platform Documentation ]

[ Title ]

[ Contents ]

[ Previous ]

[ Next ]

[ Index ]

---

Welcome

---

Contents

• About This Guide
• Learning About Platform Products
• Technical Support

[ Top ]

---

About This Guide

This guide introduces the basic concepts of the Platform LSF® software ("LSF") and describes how to use your LSF installation to run and monitor jobs.

Who should use this guide

This guide is intended for LSF users and administrators who want to understand the fundamentals of Platform LSF operation and use. This guide assumes that you have access to one or more Platform LSF products at your site.

Administrators and users who want more in-depth understanding of advanced details of LSF operation should read Administering Platform LSF.

How to find out more

To learn more about LSF:

• See Administering Platform LSF for detailed information about LSF configuration and tasks.
• See the Platform LSF Reference for information about LSF commands, files, and configuration parameters.
• See Learning About Platform Products for additional resources.

How this guide is organized

Chapter 1

About Platform LSF introduces the basic terms and concepts of LSF and summarizes the job life cycle.

Chapter 2

Working with Jobs discusses the commands for performing operations on jobs such as submitting jobs and specifying queues, hosts, job names, projects and user groups.

It also provides instructions for modifying jobs that have already been submitted, suspending and resuming jobs, moving jobs from one queue to another, sending signals to jobs, and forcing job execution.

You must have a working LSF cluster installed to use the commands described in this chapter.

Chapter 3

Viewing Information About Jobs discusses the commands for displaying information about clusters, resources, users, queues, jobs, and hosts.

You must have a working LSF cluster installed to use the commands described in this chapter.

Typographical conventions

Typeface	Meaning	Example
Courier	The names of on-screen computer output, commands, files, and directories	The lsid command
Bold Courier	What you type, exactly as shown	Type cd /bin
Italics	Book titles, new words or terms, or words to be emphasized Command-line place holders--replace with a real name or value	The queue specified by queue_name
Bold Sans Serif	Names of GUI elements that you manipulate	Click OK

Command notation

Notation	Meaning	Example
Quotes " or '	Must be entered exactly as shown	"job_ID[index_list]"
Commas ,	Must be entered exactly as shown	-C time0,time1
Ellipsis ...	The argument before the ellipsis can be repeated. Do not enter the ellipsis.	job_ID ...
lower case italics	The argument must be replaced with a real value you provide.	job_ID
OR bar |	You must enter one of the items separated by the bar. You cannot enter more than one item, Do not enter the bar.	[-h | -V]
Parenthesis (  )	Must be entered exactly as shown	-X "exception_cond([params])::acti on] ...
Option or variable in square brackets [  ]	The argument within the brackets is optional. Do not enter the brackets.	lsid [-h]
Shell prompts	C shell: % Bourne shell and Korn shell: $ root account: # Unless otherwise noted, the C shell prompt is used in all command examples	% cd /bin

[ Top ]

---

Learning About Platform Products

World Wide Web and FTP

The latest information about all supported releases of Platform LSF is available on the Platform Web site at www.platform.com. Look in the Online Support area for current README files, Release Notes, Upgrade Notices, Frequently Asked Questions (FAQs), Troubleshooting, and other helpful information.

The Platform FTP site (ftp.platform.com) also provides current README files, Release Notes, and Upgrade information for all supported releases of Platform LSF.

Visit the Platform User Forum at www.platformusers.net to discuss workload management and strategies pertaining to distributed and Grid Computing.

If you have problems accessing the Platform web site or the Platform FTP site, contact support@platform.com.

Platform training

Platform's Professional Services training courses can help you gain the skills necessary to effectively install, configure and manage your Platform products. Courses are available for both new and experienced users and administrators at our corporate headquarters and Platform locations worldwide.

Customized on-site course delivery is also available.

Find out more about Platform Training at www.platform.com/training, or contact Training@platform.com for details.

README files and release notes and UPGRADE

Before installing LSF, be sure to read the files named readme.html and release_notes.html. To upgrade to Version 6.0, follow the steps in upgrade.html.

You can also view these files from the Download area of the Platform Online Support Web page.

Platform documentation

Documentation for Platform products is available in HTML and PDF format on the Platform Web site at www.platform.com/services/support/docs_home.asp.

[ Top ]

---

Technical Support

Contact Platform Computing for technical support.

Email

support@platform.com

World Wide Web

www.platform.com

Phone

• North America: +1 905 948 4297
• Europe: +44 1256 370 530
• Asia: +86 10 6238 1125

Toll-free phone

1-877-444-4LSF (+1 877 444 4573)

Mail

Platform Support
Platform Computing Corporation
3760 14th Avenue
Markham, Ontario
Canada L3R 3T7

When contacting Platform Computing, please include the full name of your company.

We'd like to hear from you

If you find an error in any Platform documentation, or you have a suggestion for improving it, please let us know:

Email

doc@platform.com

Mail

Platform Information Development
Platform Computing Corporation
3760 14th Avenue
Markham, Ontario
Canada L3R 3T7

Be sure to tell us:

• The title of the manual you are commenting on
• The version of the product you are using
• The format of the manual (HTML or PDF)

Where to go next

Learn about basic LSF concepts, described in About Platform LSF.

[ Top ]

---

[ Platform Documentation ]

[ Title ]

[ Contents ]

[ Previous ]

[ Next ]

[ Index ]

---

Date Modified: November 21, 2003 Platform Computing: www.platform.com Platform Support: support@platform.com Platform Information Development: doc@platform.com Copyright © 1994-2003 Platform Computing Corporation. All rights reserved.