Release Notes for Platform LSF Platform LSF Version 7 Update 3 Release date: May 2008 Last modified: May 29, 2008
Contents Release Notes for Platform LSF ............................................................................................ 3 Upgrade and Compatibility Notes ................................................................................... 3 What’s Changed in Platform LSF Version 7 Update 3 .................................................... 5 Known Issues ................................................................................................................
Release Notes for Platform LSF Release Notes for Platform LSF Release date: May 2008 Last modified: May 16, 2008 Comments to: doc@platform.com Support: support@platform.
Release Notes for Platform LSF Migrate your existing LSF 7 cluster to Update 3 on UNIX and Linux Follow the steps in Migrating to Platform LSF Version 7 Update 3 on UNIX and Linux (lsf_migrate_unix.pdf) to migrate an existing LSF 7 cluster: • • Migrate an existing LSF Version 7 cluster to LSF 7 Update 3 on UNIX and Linux Migrate an existing LSF 7 Update 1 cluster to LSF 7 Update 3 on UNIX and Linux Note: DO NOT use these steps to migrate an existing LSF 7 Update 2 cluster to LSF 7 Update 3.
Release Notes for Platform LSF New and changed LSF APIs See the LSF API Reference for more information. The lsb_modreservation() API has been added for LSF Version 7 Update 3 to modify advance reservations.
Release Notes for Platform LSF Each Session Scheduler job is dynamically scheduled in a similar manner to a parallel job. Each instance of the ssched command then manages its own workload within its assigned allocation. Work is submitted as a task array or a task definition file. See Installing and Running Platform LSF Session Scheduler for more information. Automatic job group cleanup When an implicitly created job group becomes empty, it can be automatically deleted by LSF.
Release Notes for Platform LSF • • • • • Modify the host or hostgroup list (add or remove hosts or hostgroups) Modify the user or user group Add hosts by resource requirement (-R) Modify the reservation type (open or closed) Disable the specified occurrences of a recurring reservation Use brsvmod to shift, extend or reduce the time window horizontally; grow or shrink the size vertically. Specify successful application exit values.
Release Notes for Platform LSF To to limit the number of times a failed job is requeued, set MAX_JOB_REQUEUE cluster wide (lsb.params), in the queue definition (lsb.queues), or in an application profile (lsb.applications). Specify an integer greater than zero (0). MAX_JOB_REQUEUE in lsb.applications overrides lsb.queues, and lsb.queues overrides lsb.params configuration.
Release Notes for Platform LSF Checkpointing MultiCluster jobs To enable checkpointing of MultiCluster jobs, define a checkpoint directory in both the sendjobs and receive-jobs queues (CHKPNT in lsb.queues), or in an application profile (CHKPNT_DIR, CHKPNT_PERIOD, CHKPNT_INITPERIOD, CHKPNT_METHOD in lsb.applications) of both submission cluster and execution cluster. LSF uses the directory specified in the execution cluster. Checkpointing is not supported if a job runs on a leased host.
Release Notes for Platform LSF Index Measures Units Determined by ncores number of cores per physical processor cores LIM nthreads number of threads per processor core threads LIM How environment variables determine elim hosts If you use the default keyword for any external resource in lsf.cluster.cluster_name, all elim executables in LSF_SERVERDIR run on all hosts in the cluster.
Release Notes for Platform LSF job_ID Argument in square brackets [ ] The argument surrounded by square brackets is optional. Do not enter the brackets. user list [-l] Argument in brace brackets { } One of the arguments surrounded by brace brackets is required. You cannot use both options together. Do not enter the brackets. user list {-s | -n processors} OR bars | OR bars separate items in a list. You can only enter one of the items in the list. Do not enter the bar.
Release Notes for Platform LSF command -h | -V command The command can be issued without any options, usually to open a command shell. From within this command shell, subcommands can be issued without prefacing them with the command, until such time as the command shell is closed. The command can also be issued with subcommands and options in a single string, to open the command shell, perform the action, and close the command shell in a single command string.
Release Notes for Platform LSF • • • to all jobs running on the host. Job-level command line migration threshold overrides threshold configuration in application profile and queue. Application profile configuration overrides queue level configuration. NO_PREEMPT_FINISH_TIME=minutes | percentage—Prevents preemption of jobs that will finish within the specified number of minutes or the specified percentage of the estimated run time or run limit.
Release Notes for Platform LSF number of minutes or longer should not be preempted, where minutes is wall-clock time, not normalized time. Percentage must be greater than 0 or less than 100% (between 1% and 99%). lsb.queues • CHKPNT=chkpnt_dir [chkpnt_period]—If checkpoint-related configuration is specified in both the queue and an application profile, the application profile setting overrides queue level configuration.
Release Notes for Platform LSF • • • is programmed to report values more frequently than every 5 seconds, set the ELIM_POLL_INTERVAL so that it samples information at a corresponding rate. LSF_ELIM_BLOCKTIME=seconds—in Parameters section. UNIX only; used when the external load indices feature is enabled. Maximum amount of time the master external load information manager (MELIM) waits for a complete load update string from an elim executable.
Release Notes for Platform LSF CONSUMABLE in Resource section—Explicitly controls if a resource is consumable. Applies to static or dynamic numeric resources. Static and dynamic numeric resources can be specified as consumable. CONSUMABLE is optional. The defaults for the consumable attribute are: • Built-in indicies: • The following are consumable: r15s, r1m, r15m, ut, pg, io, ls, it, tmp, swp, mem. All other built-in static resources are not consumable. (e.g.
Release Notes for Platform LSF perfadmin Starts or stops the PERF services, or shows status to administer the LSF Reports (PERF) services. Run the command on the PERF host to control the following PERF services: loader controller (plc), job data transformer (jobdt), and data purger (purger). Run the command on the Derby database host to control the Derby database service (derbydb). If PERF services are controlled by EGO, let the EGO service controller start and stop the PERF services.
Release Notes for Platform LSF badmin -c class_name adds LC_ADVRSV class to log advance reservation modifications with brsvmod. bapp -l Displays new application profile configuration parameters for checkpoint-related settings: • CHKPNT_DIR—The checkpoint directory, if automatic checkpointing is enabled for the application profile. CHKPNT_INITPERIOD—The initial checkpoint period in minutes. The periodic checkpoint does not happen until the initial period has elapsed.
Release Notes for Platform LSF • -N reservation_name specifies a user-defined advance reservation name unique in an LSF cluster. The name is a string of letters, numeric characters, underscores, and dashes beginning with a letter. The maximum length of the name is 39 characters. brsvs -z all | "host_name" shows a planner with only the weekly items that have reservation configurations displayed. Empty lines are omitted. bsub -R res_req displays hosts with the specified resource requirements.
Release Notes for Platform LSF be dispatched to hosts on which the job has previously exited with an exclusive exit code. lshosts • ncpus diaplays the number of processors on the host. If LSF_ENABLE_DUALCORE=Y in lsf.conf for multi-core CPU hosts, displays the number of cores instead of physical CPUs. If EGO is enabled in the LSF cluster and EGO_DEFINE_NCPUS is specified in lsf.conf or ego.
Release Notes for Platform LSF runtimeEstimation (%d) Estimated run time for the job requeueEValues (%s) Job exit values for automatic job requeue Bugs fixed since November 2007 Bugs fixed in the May 2008 update (LSF 7 Update 3) since the November 2007 update (LSF 7 Update 2) are listed in the document Fixed Bugs for Platform LSF 7 Update 3.
Release Notes for Platform LSF The PMC can only run on the following platforms: LINUX86, X86_64, NTX86, NTX64. If your LSF cluster includes other platforms, the administrator must manually modify eservice/esc/conf/service/gui_service.xml by changing: select(!NTIA64) to select('LINUX86'||'X86_64'||'NTX86'||'NTX64') You must restart EGO to make the change take effect.
Release Notes for Platform LSF 6. Set file transfer mode to binary: ftp> binary 7. For LSF on UNIX and Linux, get the installation distribution file. ftp> get platform_lsf_update3/lsf7Update3_lsfinstall.tar.Z Tip: Before installing LSF on your UNIX and Linux hosts, you must uncompress and extract lsf7Update3_lsfinstall.tar.Z to the same directory where you download the LSF product distribution tar files. 8.
Release Notes for Platform LSF Note: To take advantage of the Platform LSF reporting feature, you must download and install the Platform Management Console. The reporting feature is only supported on the same platforms as the Platform Management Console: 32-bit and 64-bit x86 Windows and Linux operating systems. 12. Exit FTP. ftp> quit Download LSF from my.platform.com You must provide your Customer Support Number and register a user name and password on my.platform.com to download LSF.
Release Notes for Platform LSF See Installing Platform LSF on UNIX and Linux for new cluster installation steps. See the Platform LSF Command Reference for detailed information about lsfinstall and its options. Important: DO NOT use the UNIX and Linux upgrade steps to migrate an existing LSF 7 cluster or LSF 7 Update 1 cluster to LSF 7 Update 3.
Release Notes for Platform LSF World Wide Web and FTP Information about Platform LSF Version 7 is available in the LSF area of the Platform FTP site (ftp.platform.com/distrib/7.0/). The latest information about all supported releases of Platform LSF is available on the Platform Web site at www.platform.com. If you have problems accessing the Platform web site or the Platform FTP site, send email to support@platform.com. my.platform.com my.platform.
Release Notes for Platform LSF Email support@platform.com World Wide Web www.platform.com Mail Platform Support Platform Computing Inc. 3760 14th Avenue Markham, Ontario Canada L3R 3T7 When contacting Platform, please include the full name of your company. See the Platform Web site at www.platform.com/company/contact-us for other contact information.
Release Notes for Platform LSF 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, OR CONSEQUENTIAL DAMAGES, INCLUDING WITHOUT LIMITATION ANY LOST PROFITS, DATA, OR SAVINGS, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM.
