1---2name: azure-hpc-cache3description: Expert knowledge for Azure HPC Cache development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring HPC Cache namespaces, NFS/Blob targets, client access, data ingest scripts, or cache failover, and other Azure HPC Cache related development tasks. Not for Azure Managed Lustre (use azure-managed-lustre), Azure NetApp Files (use azure-netapp-files), Azure Batch (use azure-batch), Azure Virtual Machines (use azure-virtual-machines).4---5# Azure HPC Cache Skill67This skill provides expert guidance for Azure HPC Cache. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.89## How to Use This Skill1011> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file1213This skill requires **network access** to fetch documentation content:14- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch`. Returns Markdown.15- **Fallback**: Use `WebFetch`. Returns Markdown.1617## Category Index1819| Category | Lines | Description |20|----------|-------|-------------|21| Troubleshooting | L33-L38 | Diagnosing and resolving Azure HPC Cache issues with Blob storage firewalls and NFS storage targets, including connectivity, access, and configuration problems. |22| Best Practices | L39-L47 | Guidance on optimizing Azure HPC Cache: client load balancing, efficient data movement and manual copy to Blob targets, NFS-on-Blob considerations, and priming caches for better hit rates. |23| Decision Making | L48-L53 | Guidance on when Azure HPC Cache is appropriate, comparing usage models, workload patterns, performance needs, and deciding if/when to adopt it for your architecture. |24| Architecture & Design Patterns | L54-L59 | Designing Azure HPC Cache namespaces across multiple back-end storage systems, and planning regional redundancy, high availability, and failover strategies for cached workloads. |25| Limits & Quotas | L60-L64 | How to request and manage Azure HPC Cache quota increases, including limits on cache instances, capacities, and the support process for raising quotas. |26| Security | L65-L72 | Configuring HPC Cache security: client access policies, directory/AD integration and extended groups, customer-managed encryption keys, and overall cache security settings. |27| Configuration | L73-L86 | Configuring and operating Azure HPC Cache: CLI setup, networking/DNS/NTP, storage targets and namespaces, mounting NFS clients, lifecycle management, metrics, and environment prerequisites. |28| Integrations & Coding Patterns | L87-L94 | Scripts and patterns for ingesting data (msrsync, parallelcp), controlling write-back with flush_file.py, and integrating Azure HPC Cache with Azure NetApp Files. |29| Deployment | L95-L99 | Creating Azure HPC Cache instances via portal/CLI, and recreating or moving existing caches to a different region while preserving configuration and data paths |3031### Troubleshooting32| Topic | URL |33|-------|-----|34| Work around Blob firewall issues for HPC Cache targets | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-blob-firewall-fix |35| Troubleshoot NFS storage target issues in Azure HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/troubleshoot-nas |3637### Best Practices38| Topic | URL |39|-------|-----|40| Load balance client connections across Azure HPC Cache IPs | https://learn.microsoft.com/en-us/azure/hpc-cache/client-load-balancing |41| Optimize data movement to Azure HPC Cache Blob targets | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-ingest |42| Manually copy data into Azure HPC Cache Blob targets | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-ingest-manual |43| Apply NFS Blob storage considerations with Azure HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/nfs-blob-considerations |44| Prime Azure HPC Cache to improve cache hit rates | https://learn.microsoft.com/en-us/azure/hpc-cache/prime-cache |4546### Decision Making47| Topic | URL |48|-------|-----|49| Choose Azure HPC Cache usage models | https://learn.microsoft.com/en-us/azure/hpc-cache/cache-usage-models |50| Decide when Azure HPC Cache fits your workload | https://learn.microsoft.com/en-us/azure/hpc-cache/usage-scenarios |5152### Architecture & Design Patterns53| Topic | URL |54|-------|-----|55| Design Azure HPC Cache aggregated namespaces | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-namespace |56| Design regional redundancy and failover for Azure HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-region-recovery |5758### Limits & Quotas59| Topic | URL |60|-------|-----|61| Request Azure HPC Cache quota increases | https://learn.microsoft.com/en-us/azure/hpc-cache/increase-quota |6263### Security64| Topic | URL |65|-------|-----|66| Define client access policies for Azure HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/access-policies |67| Configure customer-managed encryption keys for Azure HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/customer-keys |68| Configure directory services and extended groups for HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/directory-services |69| Understand security configuration for Azure HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-security-info |7071### Configuration72| Topic | URL |73|-------|-----|74| Set up Azure HPC Cache namespace paths | https://learn.microsoft.com/en-us/azure/hpc-cache/add-namespace-paths |75| Prepare Azure CLI environment for managing HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/az-cli-prerequisites |76| Configure networking, NTP, DNS, and snapshots for HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/configuration |77| Configure storage targets for Azure HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-add-storage |78| Modify Azure HPC Cache storage target settings | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-edit-storage |79| Operate and update Azure HPC Cache instances | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-manage |80| Mount Azure HPC Cache on NFS clients | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-mount |81| Verify environment prerequisites for Azure HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-prerequisites |82| Manage Azure HPC Cache storage target lifecycle | https://learn.microsoft.com/en-us/azure/hpc-cache/manage-storage-targets |83| Monitor Azure HPC Cache metrics and reports | https://learn.microsoft.com/en-us/azure/hpc-cache/metrics |8485### Integrations & Coding Patterns86| Topic | URL |87|-------|-----|88| Use flush_file.py to control HPC Cache write-back | https://learn.microsoft.com/en-us/azure/hpc-cache/custom-flush-script |89| Ingest data to HPC Cache using msrsync | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-ingest-msrsync |90| Use parallelcp script to ingest data for HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-ingest-parallelcp |91| Integrate Azure HPC Cache with Azure NetApp Files | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-netapp |9293### Deployment94| Topic | URL |95|-------|-----|96| Create Azure HPC Cache instances via portal or CLI | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-create |97| Recreate or move Azure HPC Cache to another region | https://learn.microsoft.com/en-us/azure/hpc-cache/move-resource |
atc-net