This is a public repository for all of Azure Local Troubleshooting guides (TSGs), known issues and reporting feedback - this repo is intended to provide a central location for community driven supportability content. This is the material that is referenced by Customer Support Services when a ticket is created, by Azure Local engineering responding to an incident, and by users when self discovering resolutions to active system issues.
Azure Stack HCI is now part of Azure Local. Learn more.
Troubleshooting guides (TSGs) are grouped by categories and stored in relevantly named subdirectories. Each directory contains a README that lists the guides. The following are the categories of guides that are stored in relevantly named directories:
- Deployment - Prerequisites, AD, Software Download, OS install, Registration, Arc extensions and Deployment (Portal & ARM templates).
- Update - Health Check, Sideloading, Update method (Azure Update Manager & PowerShell).
- Upgrade - Upgrade from version 22H2 to 23H2.
- Solution Extension - Solution extension.
- LCM - Lifecycle Manager.
- Infra Lifecycle Operations - Add Server, Repair Server, Storage.
- Arc VMs - VM lifecycle management, licensing, extensions, networking and storage.
- Security - WDAC, BitLocker, Secret Rotation, Syslog, Defender for Cloud.
- Networking - Proxy and Arc Gateway.
- Monitoring - Insights, Metric and Alerts.
- Azure Virtual Desktop - Azure Virtual Desktop.
- Azure Kubernetes - Deployment, Networking, Update.
IMPORTANT: An inability to meet the below requirements for bug reports are subject to being closed by maintainers and routed to official Azure support channels to provide the proper support experience to resolve user issues.
Bug reports filed on this repository should follow the default issue template that is shown when opening a new issue. Please do not share any personal data. The template contains the following fields:
- Bug Description
- Repro Steps
- Expected Behavior
- Environment
- Azure Local build (release version)
- 1-node vs. multi-nodes, etc.
- Production vs. Non-production
- Region
- Screenshots (do not share personal data)
- Correlation ID (from log collection)
At a bare minimum, issues reported on this repository must:
- Be reproducible outside of the current system
- This means that if you file an issue that would require direct access to your system and/or Azure resources you will be redirected to open an Azure support ticket. Microsoft employees may not ask for personal / subscription information on Github.
- For example, if your issue is related to custom scenarios such as custom network devices, configuration, authentication issues related to your Azure subscription, etc.
- Contain the following information:
- A good title: Clear, relevant and descriptive - so that a general idea of the problem can be grasped immediately
- Description: Before you go into the detail of steps to replicate the issue, you need a brief description.
- Assume that whomever is reading the report is unfamiliar with the issue/system in question
- Clear, concise steps to replicate the issue outside of your specific system.
- These should let anyone clearly see what you did to see the problem, and also allow them to recreate it easily themselves. This section should also include results - both expected and the actual - along with relevant URLs.
- Be sure to include any supporting information you might have that could aid the developers.
- This includes YAML files/deployments, scripts to reproduce, exact commands used, screenshots, etc.
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
Microsoft and any contributors grant you a license to the Microsoft documentation and other content in this repository under the Creative Commons Attribution 4.0 International Public License, see the LICENSE file, and grant you a license to any code in the repository under the MIT License, see the LICENSE-CODE file.
Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.
Privacy information can be found at https://privacy.microsoft.com/en-us/
Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel or otherwise.