You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/batch/batch-automatic-scaling.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ You can enable automatic scaling when you create a pool, or apply it to an exist
22
22
23
23
## Autoscale formulas
24
24
25
-
An autoscale formula is a string value that you define that contains one or more statements. The autoscale formula is assigned to a pool's [autoScaleFormula](/rest/api/batchservice/enable-automatic-scaling-on-a-pool) element (Batch REST) or [CloudPool.AutoScaleFormula](/dotnet/api/microsoft.azure.batch.cloudpool.autoscaleformula) property (Batch .NET). The Batch service uses your formula to determine the target number of compute nodes in the pool for the next interval of processing. The formula string can't exceed 8 KB, can include up to 100 statements that are separated by semicolons, and can include line breaks and comments.
25
+
An autoscale formula is a string value that you define that contains one or more statements. The autoscale formula is assigned to a pool's [autoScaleFormula](/rest/api/batchservice/pools/enable-pool-auto-scale) element (Batch REST) or [CloudPool.AutoScaleFormula](/dotnet/api/microsoft.azure.batch.cloudpool.autoscaleformula) property (Batch .NET). The Batch service uses your formula to determine the target number of compute nodes in the pool for the next interval of processing. The formula string can't exceed 8 KB, can include up to 100 statements that are separated by semicolons, and can include line breaks and comments.
26
26
27
27
You can think of automatic scaling formulas as a Batch autoscale "language." Formula statements are free-formed expressions that can include both *service-defined variables*, which are defined by the Batch service, and *user-defined variables*. Formulas can perform various operations on these values by using built-in types, operators, and functions. For example, a statement might take the following form:
By default, the Batch service adjusts a pool's size according to its autoscale formula every 15 minutes. This interval is configurable by using the following pool properties:
The minimum interval is five minutes, and the maximum is 168 hours. If an interval outside this range is specified, the Batch service returns a Bad Request (400) error.
Copy file name to clipboardExpand all lines: articles/batch/batch-efficient-list-queries.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -142,13 +142,13 @@ Property names in filter, select, and expand strings must reflect their REST API
142
142
| .NET list methods | REST list requests |
143
143
| --- | --- |
144
144
|[CertificateOperations.ListCertificates](/dotnet/api/microsoft.azure.batch.certificateoperations)|[List the certificates in an account](/rest/api/batchmanagement/certificate/list-by-batch-account)|
145
-
|[CloudTask.ListNodeFiles](/dotnet/api/microsoft.azure.batch.cloudtask)|[List the files associated with a task](/rest/api/batchservice/file/listfromtask)|
146
-
|[JobOperations.ListJobPreparationAndReleaseTaskStatus](/dotnet/api/microsoft.azure.batch.joboperations)|[List the status of the job preparation and job release tasks for a job](/rest/api/batchservice/job/listpreparationandreleasetaskstatus)|
145
+
|[CloudTask.ListNodeFiles](/dotnet/api/microsoft.azure.batch.cloudtask)|[List the files associated with a task](/rest/api/batchservice/tasks/list-task-files)|
146
+
|[JobOperations.ListJobPreparationAndReleaseTaskStatus](/dotnet/api/microsoft.azure.batch.joboperations)|[List the status of the job preparation and job release tasks for a job](/rest/api/batchservice/jobs/list-job-preparation-and-release-task-status)|
147
147
|[JobOperations.ListJobs](/dotnet/api/microsoft.azure.batch.joboperations)|[List the jobs in an account](/rest/api/batchservice/jobs/list-jobs-from-schedule)|
148
-
|[JobOperations.ListNodeFiles](/dotnet/api/microsoft.azure.batch.joboperations)|[List the files on a node](/rest/api/batchservice/file/listfromcomputenode)|
148
+
|[JobOperations.ListNodeFiles](/dotnet/api/microsoft.azure.batch.joboperations)|[List the files on a node](/rest/api/batchservice/nodes/list-node-files)|
149
149
|[JobOperations.ListTasks](/dotnet/api/microsoft.azure.batch.joboperations)|[List the tasks associated with a job](/rest/api/batchservice/tasks/list-tasks)|
150
150
|[JobScheduleOperations.ListJobSchedules](/dotnet/api/microsoft.azure.batch.jobscheduleoperations)|[List the job schedules in an account](/rest/api/batchservice/jobschedule/list)|
151
-
|[JobScheduleOperations.ListJobs](/dotnet/api/microsoft.azure.batch.jobscheduleoperations)|[List the jobs associated with a job schedule](/rest/api/batchservice/job/listfromjobschedule)|
151
+
|[JobScheduleOperations.ListJobs](/dotnet/api/microsoft.azure.batch.jobscheduleoperations)|[List the jobs associated with a job schedule](/rest/api/batchservice/jobs/list-jobs-from-schedule)|
152
152
|[PoolOperations.ListComputeNodes](/dotnet/api/microsoft.azure.batch.pooloperations)|[List the compute nodes in a pool](/rest/api/batchservice/nodes/list-nodes)|
153
153
|[PoolOperations.ListPools](/dotnet/api/microsoft.azure.batch.pooloperations)|[List the pools in an account](/rest/api/batchservice/pools/list-pools)|
154
154
@@ -162,7 +162,7 @@ Property names in filter, select, and expand strings must reflect their REST API
162
162
|[Certificate](/dotnet/api/microsoft.azure.batch.certificate)|[Get information about a certificate](/rest/api/batchmanagement/certificate/get)|
163
163
|[CloudJob](/dotnet/api/microsoft.azure.batch.cloudjob)|[Get information about a job](/rest/api/batchservice/jobs/get-job)|
164
164
|[CloudJobSchedule](/dotnet/api/microsoft.azure.batch.cloudjobschedule)|[Get information about a job schedule](/rest/api/batchservice/jobs/get-job)|
165
-
|[ComputeNode](/dotnet/api/microsoft.azure.batch.computenode)|[Get information about a node](/rest/api/batchservice/computenode/get)|
165
+
|[ComputeNode](/dotnet/api/microsoft.azure.batch.computenode)|[Get information about a node](/rest/api/batchservice/nodes/get-node)|
166
166
|[CloudPool](/dotnet/api/microsoft.azure.batch.cloudpool)|[Get information about a pool](/rest/api/batchservice/pools/get-pool)|
167
167
|[CloudTask](/dotnet/api/microsoft.azure.batch.cloudtask)|[Get information about a task](/rest/api/batchservice/tasks/get-task)|
Copy file name to clipboardExpand all lines: articles/batch/batch-pool-node-error-checking.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -117,9 +117,9 @@ Even when Batch successfully allocates nodes in a pool, various issues can cause
117
117
118
118
You can specify an optional [start task](/rest/api/batchservice/tasks/create-task) for a pool. As with any task, the start task uses a command line and can download resource files from storage. The start task runs for each node when the node starts. The `waitForSuccess` property specifies whether Batch waits until the start task completes successfully before it schedules any tasks to a node. If you configure the node to wait for successful start task completion, but the start task fails, the node isn't usable but still incurs charges.
119
119
120
-
You can detect start task failures by using the [taskExecutionResult](/rest/api/batchservice/computenode/get#taskexecutionresult) and [taskFailureInformation](/rest/api/batchservice/computenode/get#taskfailureinformation) properties of the top-level [startTaskInformation](/rest/api/batchservice/computenode/get#starttaskinformation) node property.
120
+
You can detect start task failures by using the [taskExecutionResult](/rest/api/batchservice/nodes/get-node#batchtaskexecutionresult) and [taskFailureInformation](/rest/api/batchservice/nodes/get-node#batchtaskfailureinfo) properties of the top-level [startTaskInformation](/rest/api/batchservice/nodes/get-node#batchstarttaskinfo) node property.
121
121
122
-
A failed start task also causes Batch to set the [computeNodeState](/rest/api/batchservice/computenode/get#computenodestate) to `starttaskfailed`, if `waitForSuccess` was set to `true`.
122
+
A failed start task also causes Batch to set the [computeNodeState](/rest/api/batchservice/nodes/get-node#batchnodestate) to `starttaskfailed`, if `waitForSuccess` was set to `true`.
123
123
124
124
As with any task, there can be many causes for a start task failure. To troubleshoot, check the *stdout*, *stderr*, and any other task-specific log files.
125
125
@@ -129,21 +129,21 @@ Start tasks must be re-entrant, because the start task can run multiple times on
129
129
130
130
You can specify one or more application packages for a pool. Batch downloads the specified package files to each node and uncompresses the files after the node starts, but before it schedules tasks. It's common to use a start task command with application packages, for example to copy files to a different location or to run setup.
131
131
132
-
If an application package fails to download and uncompress, the [computeNodeError](/rest/api/batchservice/computenode/get#computenodeerror) property reports the failure, and sets the node state to `unusable`.
132
+
If an application package fails to download and uncompress, the [computeNodeError](/rest/api/batchservice/nodes/get-node#batchnodeerror) property reports the failure, and sets the node state to `unusable`.
133
133
134
134
### Container download failure
135
135
136
-
You can specify one or more container references on a pool. Batch downloads the specified containers to each node. If the container fails to download, the [computeNodeError](/rest/api/batchservice/computenode/get#computenodeerror) property reports the failure, and sets the node state to `unusable`.
136
+
You can specify one or more container references on a pool. Batch downloads the specified containers to each node. If the container fails to download, the [computeNodeError](/rest/api/batchservice/nodes/get-node#batchnodeerror) property reports the failure, and sets the node state to `unusable`.
137
137
138
138
### Node OS updates
139
139
140
140
For Windows pools, `enableAutomaticUpdates` is set to `true` by default. Although allowing automatic updates is recommended, updates can interrupt task progress, especially if the tasks are long-running. You can set this value to `false` if you need to ensure that an OS update doesn't happen unexpectedly.
141
141
142
142
### Node in unusable state
143
143
144
-
Batch might set the [computeNodeState](/rest/api/batchservice/computenode/get#computenodestate) to `unusable` for many reasons. You can't schedule tasks to an `unusable` node, but the node still incurs charges.
144
+
Batch might set the [computeNodeState](/rest/api/batchservice/nodes/get-node#batchnodestate) to `unusable` for many reasons. You can't schedule tasks to an `unusable` node, but the node still incurs charges.
145
145
146
-
If Batch can determine the cause, the [computeNodeError](/rest/api/batchservice/computenode/get#computenodeerror) property reports it. If a node is in an `unusable` state, but has no [computeNodeError](/rest/api/batchservice/computenode/get#computenodeerror), it means Batch is unable to communicate with the VM. In this case, Batch always tries to recover the VM. However, Batch doesn't automatically attempt to recover VMs that failed to install application packages or containers, even if their state is `unusable`.
146
+
If Batch can determine the cause, the [computeNodeError](/rest/api/batchservice/nodes/get-node#batchnodeerror) property reports it. If a node is in an `unusable` state, but has no [computeNodeError](/rest/api/batchservice/nodes/get-node#batchnodeerror), it means Batch is unable to communicate with the VM. In this case, Batch always tries to recover the VM. However, Batch doesn't automatically attempt to recover VMs that failed to install application packages or containers, even if their state is `unusable`.
147
147
148
148
Other reasons for `unusable` nodes might include the following causes:
149
149
@@ -180,13 +180,13 @@ When you add a pool in the Azure portal, you can display the full list of VM siz
180
180
181
181
You can specify a retention time for files written by each task. The retention time determines how long to keep the task files before automatically cleaning them up. You can reduce the retention time to lower storage requirements.
182
182
183
-
If the temporary or OS disk runs out of space, or is close to running out of space, the node moves to the `unusable`[computeNoteState](/rest/api/batchservice/computenode/get#computenodestate), and the node error says that the disk is full.
183
+
If the temporary or OS disk runs out of space, or is close to running out of space, the node moves to the `unusable`[computeNoteState](/rest/api/batchservice/nodes/get-node#computenodestate), and the node error says that the disk is full.
184
184
185
-
If you're not sure what's taking up space on the node, try remote connecting to the node and investigating manually. You can also use the [File - List From Compute Node](/rest/api/batchservice/file/listfromcomputenode) API to examine files, for example task outputs, in Batch managed folders. This API only lists files in the Batch managed directories. If your tasks created files elsewhere, this API doesn't show them.
185
+
If you're not sure what's taking up space on the node, try remote connecting to the node and investigating manually. You can also use the [File - List From Compute Node](/rest/api/batchservice/nodes/list-node-files) API to examine files, for example task outputs, in Batch managed folders. This API only lists files in the Batch managed directories. If your tasks created files elsewhere, this API doesn't show them.
186
186
187
187
After you make sure to retrieve any data you need from the node or upload it to a durable store, you can delete data as needed to free up space.
188
188
189
-
You can delete old completed jobs or tasks whose task data is still on the nodes. Look in the `recentTasks` collection in the [taskInformation](/rest/api/batchservice/computenode/get#taskinformation) on the node, or use the [File - List From Compute Node](/rest/api/batchservice/file/listfromcomputenode) API. Deleting a job deletes all the tasks in the job. Deleting the tasks in the job triggers deletion of data in the task directories on the nodes, and frees up space. Once you've freed up enough space, reboot the node. The node should move out of `unusable` state and into `idle` again.
189
+
You can delete old completed jobs or tasks whose task data is still on the nodes. Look in the `recentTasks` collection in the [taskInformation](/rest/api/batchservice/nodes/get-node#taskinformation) on the node, or use the [File - List From Compute Node](/rest/api/batchservice/nodes/list-node-files) API. Deleting a job deletes all the tasks in the job. Deleting the tasks in the job triggers deletion of data in the task directories on the nodes, and frees up space. Once you've freed up enough space, reboot the node. The node should move out of `unusable` state and into `idle` again.
190
190
191
191
To recover an unusable node in [VirtualMachineConfiguration](/rest/api/batchservice/pools/get-pool#add-a-virtualmachineconfiguration-pool-with-os-disk) pools, you can remove the node from the pool by using the [Pool - Remove Nodes](/rest/api/batchservice/pools/remove-nodes) API. Then you can grow the pool again to replace the bad node with a fresh one.
Copy file name to clipboardExpand all lines: articles/batch/virtual-file-mount.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -188,7 +188,7 @@ Optionally, you can also access the mount files by using the direct path. If you
188
188
189
189
## Troubleshoot mount issues
190
190
191
-
If a mount configuration fails, the compute node fails and the node state is set to **Unusable**. To diagnose a mount configuration failure, inspect the [ComputeNodeError](/rest/api/batchservice/computenode/get#computenodeerror) property for details on the error.
191
+
If a mount configuration fails, the compute node fails and the node state is set to **Unusable**. To diagnose a mount configuration failure, inspect the [ComputeNodeError](/rest/api/batchservice/nodes/get-node#batchnodeerror) property for details on the error.
192
192
193
193
To get log files for debugging, you can use the [OutputFiles](batch-task-output-files.md#specify-output-files-for-task-output) API to upload the *\*.log* files. The *\*.log* files contain information about the file system mount at the `AZ_BATCH_NODE_MOUNTS_DIR` location. Mount log files have the format: *\<type>-\<mountDirOrDrive>.log* for each mount. For example, a CIFS mount at a mount directory named *test* has a mount log file named: *cifs-test.log*.
0 commit comments