Step 6: Run a Test Job on the Cluster

Applies To: Windows HPC Server 2008

After you have finished deploying your cluster, you can run a simple test job to verify that your cluster is fully functional. The following checklist describes the steps involved in running a simple test job on your cluster.

Checklist: Run a test job on the HPC cluster

Task Description

6.1. Create a Job Template

Create a job template by running the Generate Job Template Wizard in HPC Cluster Manager.

6.2. Create and Submit a Job

Create and submit a basic job in HPC Cluster Manager.

6.3. Create and Submit a Job Using the Command-Line Interface (Optional)

Create and submit a basic job by using the HPC command-line tools.

6.4. Create and Submit a Job Using HPC PowerShell (Optional)

Create and submit a basic job by using the cmdlets in HPC PowerShell.

6.1. Create a job template

Job templates simplify the job management of your HPC cluster by helping you to limit the kinds of jobs that can be submitted to your cluster, what resources are assigned to jobs, and which users can submit jobs. HPC Cluster Manager includes the Generate Node Template Wizard to help you create basic job templates

To create a simple job template

  1. If HPC Cluster Manager is not already open on the head node, open it. Click Start, point to All Programs, click Microsoft HPC Pack, and then click HPC Cluster Manager.

  2. In Configuration, in the Navigation Pane, click Job Templates.

  3. In the Actions pane, click New. The Generate Node Template Wizard appears.

  4. On the Enter Template Name page, type Test Template for the name of the new job template, and optionally a description. Click Next to continue.

  5. On the Limit Run Time page, select the Run jobs no longer than check box, and then click Next without changing any settings. This will limit all jobs that are submitted using this template to run for no longer than one minute.

  6. On the Set Priorities page, click Next without changing any settings. This will run jobs that are submitted using this template with Normal priority.

  7. On the Set Project Names page, click Next without changing any settings. This will allow jobs from any project to be submitted using this template.

  8. On the Limit Node Groups page, click Next without changing any settings. This will allow jobs that are submitted using this template to run on any node group.

  9. On the Finish page, click Finish.

6.2. Create and submit a job

This section describes how to submit a job in HPC Cluster Manager that:

  • Displays a directory list of the files in the C:\Program Files folder of a compute node in your cluster.

  • Uses the job template that you created in the previous section, which limits to 1 minute the maximum duration of time that a job can run.

  • Runs at low priority.

To create and submit a job

  1. In Job Management, in the Actions pane, click New Job.

  2. In Job Details, specify the following job parameters:

    1. In the Job template list, click Test Template (the template that you created in section “6.1. Create a job template”).

    2. When you are prompted if you want to change the job template for the job, click Yes.

    3. In the Job name box, type Folder Contents.

    4. In the Priority list, click Lowest.

  3. To add a task, click Task List, and then specify the following task parameters:

    1. To add a new basic task to the job, click Add.

    2. In the Task name box, type a name for the new task.

    3. In the Command line box, type dir.

    4. In the Work directory box, type c:\Program Files.

    5. To add this task, click Save.

  4. To limit the job so that it only runs on a specific compute node in your HPC cluster, click Resource Selection, and then specify the following resource parameters:

    1. Select the Run this job only on nodes in the following list check box.

    2. Select the check box for one of the nodes in your HPC cluster.

  5. To submit the job, click Submit.

  6. If you are prompted to enter your credentials, type your user name and password, and then click OK.

  7. To view the progress and the results of the job that you submitted:

    1. In Job Management, in the Navigation Pane, click All Jobs.

    2. In the views pane, click the job that you submitted.

    3. When the state of the job is Finished, in the Details Pane, double-click the task that you created in step 3.

    4. In the Task Properties window, in the Results tab, the Output box will display the directory list of c:\Program Files for the compute node that you selected in step 4.

    5. If you want to copy the results to the clipboard, click Copy output to clipboard.

6.3. Create and submit a job using the command-line interface (optional)

You can create and submit a job similar to the job that you created and submitted in the previous section, using the command-line interface tools that are included with Windows HPC Server 2008.

To create and submit a job using the command-line interface

  1. Open a Command Prompt window. Click Start, point to All Programs, click Accessories, and then click Command Prompt.

  2. To create a new job, type the following command:

    job new /jobname:"Folder Contents" /priority:"Lowest" /RunTime:0:0:1 /requestednodes:”<ComputeNodeName>”

    Where <ComputeNodeName> is the name of a compute node in your HPC cluster.

  3. To add a task to the job, type the following command:

    job add <JobID> /workdir:"C:\Program Files" dir

    Where <JobID> is the identification number for the job, as displayed on the command-line interface after typing the command in step 2.

  4. To submit the job, type the following command:

    job submit /id:<JobID>

    Where <JobID> is the identification number for the job, as displayed on the command-line interface after typing the command in step 2.

  5. If you are prompted to enter your credentials, type your password, and then type ENTER.

6.4. Create and submit a job using HPC PowerShell (optional)

You can also create and submit the same job that you created and submitted in the previous section, using HPC PowerShell.

Note

For more information about HPC PowerShell, see Appendix 6: Using HPC PowerShell.

To create and submit a job using HPC PowerShell

  1. On the head node, click Start, point to All Programs, and then click Microsoft HPC Pack.

  2. Right-click HPC PowerShell, and then click Run as administrator.

  3. If you are prompted by Windows PowerShell if you want to run the ccppsh.format.ps1xml script, type A, and then press ENTER.

  4. To create a new job, type the following cmdlet:

    $j = New-HpcJob -Name "Folder Contents" -Priority Lowest -RunTime "0:0:1" -RequestedNodes “<ComputeNodeName>”

    Where <ComputeNodeName> is the name of a compute node in your HPC cluster.

  5. To add a task to the job, type the following cmdlet:

    $j | Add-HpcTask -WorkDir "C:\Program Files" -CommandLine "dir"

  6. To submit the job, type the following cmdlet:

    $j | Submit-HpcJob

  7. If you are prompted to enter your credentials, type your password, and then type ENTER.

    Note

    You can also type all three cmdlets in one line: New-HpcJob -Name "Folder Contents" -Priority Lowest -RunTime "0:0:1" -RequestedNodes “<ComputeNodeName>” | Add-HpcTask -WorkDir "C:\Program Files" -CommandLine "dir" | Submit-HpcJob Where <ComputeNodeName> is the name of a compute node in your HPC cluster.