Define a Node Release Task
Updated: January 13, 2014
Applies To: Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2
A Node Release task runs a command or script on each node as it is released from the job. You can use a Node Release task to clean up or collect data from nodes as they are released from your job. For example, you can specify commands to perform the following tasks:
Move locally created data or log files to a shared resource.
Delete files or directories.
Return the node to its original state.
Start or stop services.
You can use the following procedure to create a Node Release task using HPC Job Manager.
To complete this procedure, you must have been added as a user on the cluster, or you must be a member of a domain group that has been added as a user on the cluster. For more information, contact your cluster administrator.
In HPC Job Manager, the option to add a task is available in the New Job, Modify Job, and Copy Job dialog boxes. As an example, the following procedure describes how to add a task in the New Job dialog box.
To add a Node Release task
In HPC Job Manager, in the Actions pane, click New Job.
In the left pane of the New Job dialog box, click Edit Tasks.
Point to the Add button, click the down arrow, and then click Node Release Task.
In the task dialog box, type a name for your task.
Specify a command for the task. For example, to delete all files from a folder, you can type the command like this:
In jobs that include sub-tasks, such as Node Release tasks, the job scheduler interprets the asterisk (*) as a placeholder for the sub-task ID. To run a command that uses an asterisk (*), include the caret (^) as an escape character.
Click OK to add the task to your job. The new task now appears in the list of tasks for your job.
You can define additional Task properties, such as the Execution Settings and Required Resources by selecting the task in the list and modifying the property values in the Task Properties pane.
The default maximum run time (in seconds) for Node Release tasks is defined by the cluster administrator with the Node Release Task Timeout cluster parameter.
If a job has a maximum run time and a Node Release task, the job scheduler cancels the other tasks in the job before the run time of the job expires (job run time minus Node Release task run time). This allows the Node Release task to run within the allocated time for the job.
Node Release tasks run when a job is canceled. Node Release tasks do not run when the job is force canceled or canceled by immediate preemption. To skip the Node Release task, see Force Cancel a Job or Task.
The following task properties do not apply to tasks which are started on a per-resource basis, and they cannot be set on Node Preparation, Node Release, or Service tasks:
Number of cores, sockets, nodes
Depends (task dependencies)
Parameter sweep settings
For information about basic terminology, opening HPC Job Manager, and connecting to a cluster, see Overview of HPC Job Manager.