Merge pull request #107214 from mscurrell/batchsupportcaselearnings

Batchsupportcaselearnings

Author: GitHubber17

articles/batch/TOC.yml

@@ -51,6 +51,8 @@
     href: batch-api-basics.md
   - name: APIs and tools
     href: batch-apis-tools.md
+  - name: Detecting and handling Batch service errors
+    href: batch-retry-after-errors.md
   - name: Best practices
     href: best-practices.md
   - name: Quotas and limits
@@ -132,8 +134,6 @@
       href: batch-job-schedule.md
     - name: Check for job and task errors
       href: batch-job-task-error-checking.md
-    - name: Detecting and handling Batch service errors
-      href: batch-retry-after-errors.md   
   - name: Persist job and task output
     href: batch-task-output.md
     items:

articles/batch/batch-application-packages.md

@@ -86,13 +86,11 @@ The Batch service uses the associated Storage account to store your application
 
 We recommend that you create a Storage account *specifically* for use with your Batch account, and select it here. After you've created a Storage account, you can then link it to your Batch account by using the **Storage Account** window.
 
-> [!NOTE] 
-> Currently you can't use application packages with an Azure Storage account that is configured with [firewall rules](../storage/common/storage-network-security.md).
-> 
+> [!IMPORTANT] 
+> - Currently you can't use application packages with an Azure Storage account that is configured with [firewall rules](../storage/common/storage-network-security.md).
+> - An Azure Storage account with **Hierarchical namespace** set to **Enabled** can't be used for application packages.
 
 The Batch service uses Azure Storage to store your application packages as block blobs. You are [charged as normal][storage_pricing] for the block blob data, and the size of each package can't exceed the maximum block blob size. For more information, see [Azure Storage scalability and performance targets for storage accounts](../storage/blobs/scalability-targets.md). Be sure to consider the size and number of your application packages, and periodically remove deprecated packages to minimize costs.
-> 
-> 
 
 ### View current applications
 To view the applications in your Batch account, click the **Applications** menu item in the left menu while viewing your **Batch account**.

articles/batch/batch-automatic-scaling.md

@@ -124,7 +124,7 @@ You can get the value of these service-defined variables to make adjustments tha
 | $NetworkInBytes |The number of inbound bytes. |
 | $NetworkOutBytes |The number of outbound bytes. |
 | $SampleNodeCount |The count of compute nodes. |
-| $ActiveTasks |The number of tasks that are ready to execute but are not yet executing. The $ActiveTasks count includes all tasks that are in the active state and whose dependencies have been satisfied. Any tasks that are in the active state but whose dependencies have not been satisfied are excluded from the $ActiveTasks count.|
+| $ActiveTasks |The number of tasks that are ready to execute but are not yet executing. The $ActiveTasks count includes all tasks that are in the active state and whose dependencies have been satisfied. Any tasks that are in the active state but whose dependencies have not been satisfied are excluded from the $ActiveTasks count. For a multi-instance task, $ActiveTasks will include the number of instances set on the task.|
 | $RunningTasks |The number of tasks in a running state. |
 | $PendingTasks |The sum of $ActiveTasks and $RunningTasks. |
 | $SucceededTasks |The number of tasks that finished successfully. |

articles/batch/batch-job-task-error-checking.md

@@ -6,7 +6,7 @@ author: mscurrell
 
 ms.service: batch
 ms.topic: article
-ms.date: 12/01/2019
+ms.date: 03/10/2019
 ms.author: markscu
 ---
 
@@ -69,6 +69,17 @@ The impact of task failures on the job and any task dependencies must be conside
 - For dependencies, [DependencyAction](https://docs.microsoft.com/rest/api/batchservice/task/add#dependencyaction) controls whether the tasks dependent on the failed task are blocked or are run.
 - For the job, [JobAction](https://docs.microsoft.com/rest/api/batchservice/task/add#jobaction) controls whether the failed task leads to the job being disabled, terminated, or left unchanged.
 
+### Task command line failures
+
+When the task command line is run, output is written to `stderr.txt` and `stdout.txt`. In addition, the application may write to application-specific log files.
+
+If the pool node on which a task has run still exists, then the log files can be obtained and viewed. For example, the Azure portal lists and can view log files for a task or a pool node. Multiple APIs also allow task files to be listed and obtained, such as [Get From Task](https://docs.microsoft.com/rest/api/batchservice/file/getfromtask).
+
+Due to pools and pool nodes frequently being ephemeral, with nodes being continuously added and deleted, then it is recommended that log files are persisted. [Task output files](https://docs.microsoft.com/azure/batch/batch-task-output-files) are a convenient way to save log files to Azure Storage.
+
+### Output file failures
+On every file upload, Batch writes two log files to the compute node, `fileuploadout.txt` and `fileuploaderr.txt`. You can examine these log files to learn more about a specific failure. In cases where the file upload was never attempted, for example because the task itself couldn't run, then these log files will not exist.  
+
 ## Next steps
 
 Check that your application implements comprehensive error checking; it can be critical to promptly detect and diagnose issues.

includes/batch-virtual-network-ports.md

@@ -42,7 +42,10 @@ Additional VNet requirements differ, depending on whether the Batch pool is in t
 
 **Permissions** - Check whether your security policies or locks on the VNet's subscription or resource group restrict a user's permissions to manage the VNet.
 
-**Additional networking resources** - Batch automatically allocates additional networking resources in the resource group containing the VNet. For each 50 dedicated nodes (or each 20 low-priority nodes), Batch allocates: 1 network security group (NSG), 1 public IP address, and 1 load balancer. These resources are limited by the subscription's [resource quotas](../articles/azure-resource-manager/management/azure-subscription-service-limits.md). For large pools you may need to request a quota increase for one or more of these resources.
+**Additional networking resources** - Batch automatically allocates additional networking resources in the resource group containing the VNet.
+
+> [!IMPORTANT]
+>For each 50 dedicated nodes (or each 20 low-priority nodes), Batch allocates: one network security group (NSG), one public IP address, and one load balancer. These resources are limited by the subscription's [resource quotas](../articles/azure-resource-manager/management/azure-subscription-service-limits.md). For large pools, you might need to request a quota increase for one or more of these resources.
 
 #### Network security groups: Batch default