deepblue/windows-itpro-docs
1
0
Fork 0
mirror of https://github.com/MicrosoftDocs/windows-itpro-docs.git synced 2025-06-22 05:43:41 +00:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

Adding instructions for generating diagnostic support bundle to troubleshooting page

Browse Source
This commit is contained in:
chrisjlin
2024-12-03 11:20:27 -08:00
parent 93735fb47f
commit 19446c58d6
1 changed files with 14 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
windows/deployment/do/mcc-ent-troubleshooting.md
View File

@ -130,20 +130,27 @@ You can also reboot the IoT Edge runtime using `sudo systemctl restart iotedge`.
## Generating cache node diagnostic support bundle ## Generating cache node diagnostic support bundle
You can generate a support bundle with detailed diagnostic information by running the `collectMccDiagnostics.sh` script found in the MCC diagnostics folder. You can generate a support bundle with detailed diagnostic information by running the `collectMccDiagnostics.sh` script included in the installation package.
For Windows host machines, you will need to do the following: For Windows host machines, you will need to do the following:
1. Launch a PowerShell process as the account specified as the runtime account during the Connected Cache install 1. Launch a PowerShell process as the account specified as the runtime account during the Connected Cache install
1. Run `wsl -d Ubuntu-22.04-Mcc-Base` to access the Linux distribution that hosts the Connected Cache container 1. Change directory to the "MccScripts" directory within the extracted installation package and verify the presence of `collectmccdiagnostics.sh`
1. Change directory to `path/to/collectMccDiagnostics.sh` 1. Run `wsl bash collectmccdiagnostics.sh` to generate the diagnostic support bundle
1. Run the script 1. Once the script has completed, note the console output describing the location of the diagnostic support bundle
1. Extract the generated support bundle from `path/to/support/bundle` to `path/to/windows/host`
For example, "Successfully zipped package, please send file created at /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz"
1. Run the `wsl cp` command to copy the support bundle from the location within the Ubuntu distribution to the Windows host OS
For example, `wsl cp /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz /mnt/c/mccwsl01/SupportBundles`
For Linux host machines, you will need to do the following: For Linux host machines, you will need to do the following:
1. Change directory to `path/to/collectMccDiagnostics.sh` 1. Change directory to the "MccScripts" directory within the extracted installation package and verify the presence of `collectmccdiagnostics.sh`
1. Run the script 1. Run `collectmccdiagnostics.sh` to generate the diagnostic support bundle
1. Once the script has completed, note the console output describing the location of the diagnostic support bundle
For example, "Successfully zipped package, please send file created at /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz"
## Troubleshooting cache node monitoring ## Troubleshooting cache node monitoring