Manage jobs and run work

General information

The Platform Console allows you to submit and monitor jobs, and provides access to job reports. You can choose to submit jobs directly from the Platform Console, or through a separate workload management application (for example, Platform Lava or Platform LSF). After logging on to the Platform Console, you can monitor the jobs you submitted through either the Console or a workload management application.

There are a number of standard interfaces in the Platform Console through which you can submit jobs. A generic interface is provided, along with several pre-configured and customizable interfaces (such as Fluent, LS-DYNA, ABAQUS, ANSYS, Nastran, and EnginFrame).

Generic job submission interface

The Generic interface allows you to submit LSF jobs via a web browser. The Generic interface cannot be customized.

Submit jobs by running a binary or script as a job command (for example, /bin/sleep 10). Use this interface to specify most bsub options including input, output, and error files, notification and queue details, processor and resource requirements, and host and job limits.

Other job submission interfaces

By default, the Platform Console provides some templates for several popular job submission interfaces. You can add new ones, and customize existing interfaces to suit your workload submission requirements. Included interfaces are briefly described here.

Fluent

This is an application-specific interface for job submission. Fluent must be installed to use this interface. The out-of-box interface can be customized.

Submit CAT, DAT, and journal files that reside locally or on a server, and provide parameters and job options that are specific to the Fluent application, such as time stamp and iteration number.

To integrate with the actual Fluent application, you must change the FLUENT_CMD to point to the application For example:

FLUENT_CMD="/pcc/app/fluent/Fluent.Inc/bin/fluent"
Find the script file here:
LSF_TOP/gui/lsf/7.0/batchgui/plugin/lsf/exec/fluent.cmd

LS-DYNA

This is an application-specific interface for job submission. LS-DYNA must be installed to use this interface. The out-of-box interface can be customized.

Submit d3dump files that reside locally or on a server, point to the input deck, and provide parameters and job options that are specific to the LS-DYNA application.

To integrate with the actual LS-DYNA application, you must change the DYNA_CMD to point to the application For example:

DYNA_CMD="$DYNA_TOP/binaries/ls_dyna/linux/$VERSION"

Find the script file here:
LSF_TOP/gui/lsf/7.0/batchgui/plugin/lsf/exec/lsdyna.cmd

ABAQUS

This is an application-specific interface for job submission. ABAQUS must be installed to use this interface. The out-of-box interface can be customized.

Submit INP, restart, and user files that reside locally or on a server, and provide parameters and job options that are specific to the ABAQUS application.

To integrate with the actual ABAQUS application, you must change the ABAQUS_CMD to point to the application For example:

ABAQUS_CMD="/pcc/app/abaqus/6.5.3/x86-64/Commands/abaqus"

Find the script file here:
LSF_TOP/gui/lsf/7.0/batchgui/plugin/lsf/exec/abaqus.cmd

ANSYS

This is an application-specific interface for job submission. ANSYS must be installed to use this interface. The out-of-box interface can be customized.

Submit computing (.db), load case, and TXT files that reside locally or on a server, and provide parameters that are specific to the ANSYS application, such as the parallel type and MPP solver.

To integrate with the actual ANSYS application, you must change the ANSYS_CMD to point to the application For example:

ANSYS_CMD="/pcc/app/ansys_inc/v110/ansys/bin/ansys110"

Find the script file here:
LSF_TOP/gui/lsf/7.0/batchgui/plugin/lsf/exec/ansys.cmd

Nastran

This is an application-specific interface for job submission. Nastran must be installed to use this interface. The out-of-box interface can be customized.

Point to an input deck and provide parameters that are specific to the Nastran application.

To integrate with the actual Nastran application, you must change the NASTRAN_CMD to point to the application For example:

NASTRAN_CMD="/pcc/app/msc/nastran/2005/bin/msc2005 nastran"

Find the script file here:
LSF_TOP/gui/lsf/7.0/batchgui/plugin/lsf/exec/nastran.cmd

EnginFrame

Through the Platform Console, you can submit and monitor workload using an external interface. EnginFrame must be installed to take advantage of this feature.

Open an EnginFrame job submission interface

To access an EnginFrame job submission interface from the Platform Console, you must provide its location.

  1. From the organizational tree, open Manage Workload > Submission.

    A list of standard interfaces displays in the tree.

  2. Click EnginFrame.
  3. Enter the location of the installed EnginFrame application.

    For example, http://host_name:port/enginframe.

  4. Click Enable.

Submit a job using an interface

This procedure uses the Generic interface as an example of how to submit a job through the Platform Console.

  1. From the organizational tree, open Manage Workload > Submission.

    A list of standard interfaces displays in the tree from which you can submit jobs using desired submission options.

  2. Click an interface (for example, Generic).
  3. From the job submission page, provide the required job details (for example, job name, optional commands, input file, host and job limits, etc.)
  4. Click Submit Job.

Manage a submitted job

Once a job is submitted, you can manage the job from the Platform Console. Management options include killing (stopping) jobs, suspending jobs, or resuming jobs.

  1. From the organizational tree, open the Manage Workload folder and click Batch Jobs.

    The Jobs page opens and lists all jobs active on the cluster.

  2. Select one or more jobs from the list, and then click Kill, Suspend, or Resume from the top of the page, as required.

View job details

You can view details about current and recent jobs in the cluster (by default, completed jobs are purged from the system after one hour).

  1. From the organizational tree, open Manage Workload > Batch Jobs.

    The Jobs page opens and lists all jobs active on the cluster.

  2. From the list, click a job ID.

    A page with additional details about the job displays.

View or customize LSF workload reports

The Reports function requires Platform LSF 7 installed in the cluster. Note that the primary install node must be an LSF node.

You can view standard and custom LSF workload data using the Platform Console, or customize LSF reports.

  1. From the organizational tree, open Manage Workload > Reports.
  2. For the database configuration parameters specified in LSF, see your Platform LSF installation documents for details.
  3. To view LSF reports:
    • Click Standard Reports to view standard reports.

    • Click Custom Reports to view existing custom reports.

  4. To customize LSF reports:
    1. Click Custom Reports.

      The Reports (List) page opens, listing any existing customized reports.

    2. Click the Global Actions drop-down list and select Create Custom Report.

    3. Enter the required fields, and then click Create.

      The new customized report type displays on the Reports (List) page.

To understand the LSF reporting interface, see Administering Platform LSF for details.