12.2.10. Running Workbench Batch Jobs

The Workbench Batch application enables you to update a Workbench project or update design points.

When using this application you can select a Workbench project from your local system, the EKM server, or the EKM repository, and define the job's working directory and execution settings.

In this section:

12.2.10.1. Running a Workbench Project Update

The built-in Workbench Batch template enables you to start a batch job that will refresh the input data of a local or remote Workbench project and generate the required output data for all cells in the project. If a project contains multiple design points, this option updates only the current design point.

Note that you can also launch an update directly from a Workbench project in the EKM repository. See Starting a Batch Job from Repository Files.

To run a Workbench project update:

  1. Click the Applications icon   on the title bar, and then on the Applications panel click Workbench Batch.

  2. On the first screen of the job wizard, specify the tag to apply to the job (if desired), the job name, and the working directory. For details see Setting Up a Batch Job for details.

  3. Click Next, then select the Workbench project(s) to be uploaded to the working directory. See Setting Up a Batch Job for details.

  4. Click Next, then specify the job submission settings, ensuring that Update Project is selected as the action to be performed:

    Version

    Select the version of Workbench to be used for the update.

    The available versions in this drop-down are determined by the solverVersions setting in the ekm.xml file. For details see Specifying Remote Process Policies (<remoteProcess>) in the Administration Guide. Note that the Workbench Batch template supports job submission to version 17.0 or later.

    Queue

    Select the queue to which you want to submit the job.

    Workbench Project

    Click Browse to select an input file from the working directory.

    Action to be performed

    Select Update Project.

    Number of cores

    The number of central processing units to reserve on the server.

    Import files into repository after job completion

    If enabled, the Workbench project file (.wbpj) and its associated _files folder will be copied from the job's working directory to a repository folder after the job has been executed.

    Once enabled:

    1. Click Browse to select an Output folder for the files.

    2. If you would like to import specific files or file types into the repository, specify a comma-separated list of patterns in the File patterns box, as shown in the example below. Otherwise, if you specify no patterns, all files in the working directory will be imported.


    Note:  This option is not available if you are working in a job-only view.


  5. Click Finish to execute the job. The job view displays job details and enables you to monitor its progress. See Monitoring a Workbench Project Update.

12.2.10.2. Running a Design Point Update

The built-in Workbench Batch application enables you to start a batch job in which you can add new design points to a Workbench project in the EKM repository, on your local system, or on the EKM server.

Note that you can also launch a design point update directly from a Workbench project in the EKM repository. See Starting a Batch Job from Repository Files.

To start a design point run:

  1. Click the Applications icon   on the title bar, and then on the Applications panel click Workbench Batch.

  2. On the first screen of the job wizard, specify the tag to apply to the job (if desired), the job name, and the working directory. For details see Setting Up a Batch Job for details.

  3. Click Next, then select the Workbench project to be uploaded to the working directory. See Setting Up a Batch Job for details.

  4. Click Next, then specify the job submission settings, ensuring that Update Design Points is selected as the action to be performed:

    Version

    Select the version of Workbench to be used for the update.

    The available versions in this drop-down are determined by the solverVersions setting in the ekm.xml file. For details see Specifying Remote Process Policies (<remoteProcess>) in the Administration Guide. Note that the Workbench Batch template supports job submission to version 17.0 or later.

    Queue

    Select the queue to which you want to submit the job.

    Workbench Project

    Click Browse to select an input file from the working directory.

    Action to be performed

    Select Update Design Points, then edit the design point table:

    • To add a new design point to the table, click Add and then enter the desired parametric values into the cells. If there is anything that you would like to note about the design point, you can enter it in the Note cell.

    • To create a new design point by duplicating an existing one, click the one that you want to copy and then click Duplicate. When you duplicate a design point, all input parameter values and design point states, as well as the design point’s Update and Retain settings are copied. You can then modify any of the input parameter values as required.

    • To delete a newly added or duplicated design point, select it in the table and then click Delete.

      Note that you cannot edit or delete the Current design point (DP0), or any previously saved design point.

    • If a design point needs to be updated, the Update Required   icon is displayed in the design point's table row. To update a design point, enable its Update check box. When Workbench updates a design point, it takes the given set of input parameter values for the design point, and calculates output parameter values.

    • To retain a design point’s calculated data within the project, enable its Retain check box. Once data is retained for a design point other than Current, you can view its associated design in Workbench by activating it. Refer to Retaining and Exporting Design Points in the Workbench User’s Guide for details.

    Number of cores

    The number of central processing units to reserve on the server.

    Import files into repository after job completion

    If enabled, the Workbench project file (.wbpj) and its associated _files folder will be copied from the job's working directory to a repository folder after the job has been executed.

    Once enabled:

    1. Click Browse to select an Output folder for the files.

    2. If you would like to import specific files or file types into the repository, specify a comma-separated list of patterns in the File patterns box, as shown in the example below. Otherwise, if you specify no patterns, all files in the working directory will be imported.


    Note:  This option is not available if you are working in a job-only view.


  5. Click Finish to execute the job. The job view displays job details and enables you to monitor its progress. See Monitoring a Design Point Run.


Release 18.2 - © ANSYS, Inc. All rights reserved.