Skip to content

Commit 9329b92

Browse files
committed
AB#7947: Collect data to analyze and troubleshoot SQL cluster (AG/FCI) related issues
# Pull request guidance Thank you for submitting your contribution to our support content! Our team works closely with subject matter experts in CSS and PMs in the product group to review all content requests to ensure technical accuracy and the best customer experience. This process can sometimes take one or more days, so we greatly appreciate your patience. We also need your help in order to process your request as soon as possible: - We won't act on your pull request (PR) until you type "**#sign-off**" in a new comment in your pull request (PR) to indicate that your changes are complete. - After you sign off in your PR, the article will be tech reviewed by the PM or SME if it has more than minor changes. Once the article is approved, it will undergo a final editing pass before being merged.
1 parent 7f6a8b7 commit 9329b92

File tree

3 files changed

+92
-4
lines changed

3 files changed

+92
-4
lines changed

support/windows-client/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1459,7 +1459,7 @@ items:
14591459
href: ./windows-tss/collect-data-analyze-troubleshoot-sys-management-components-scenarios.md
14601460
- name: Collect data to analyze and troubleshoot Hyper-V related issues
14611461
href: ./windows-tss/collect-data-analyze-troubleshoot-hyperv-scenarios.md
1462-
- name: Gather information for SQL cluster (AG/FCI) related issues
1463-
href: ./windows-tss/gather-information-using-tss-sql-cluster-ag-fci-issues.md
1462+
- name: Collect data to analyze and troubleshoot SQL cluster (AG/FCI) related issues
1463+
href: ./windows-tss/collect-data-analyze-troubleshoot-sql-cluster-ag-fci-scenarios.md
14641464
- name: Use the xray feature of TSS
14651465
href: ./windows-tss/use-the-xray-feature-of-tss-to-identify-known-issues.md
Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
---
2+
title: Collect data to analyze and troubleshoot SQL cluster (AG/FCI) scenario
3+
description: Learn how to gather information by using TSS for SQL cluster (AG/FCI) related issues.
4+
ms.date: 01/17/2025
5+
manager: dcscontentpm
6+
audience: itpro
7+
ms.topic: troubleshooting
8+
ms.reviewer: kaushika, warrenw
9+
ms.custom: sap:Support Tools\TSS SHA
10+
appliesto:
11+
- <a href=https://learn.microsoft.com/windows/release-health/supported-versions-windows-client target=_blank>Supported versions of Windows Client</a>
12+
- <a href=https://learn.microsoft.com/windows/release-health/windows-server-release-info target=_blank>Supported versions of Windows Server</a>
13+
---
14+
# Collect data to analyze and troubleshoot SQL cluster (AG/FCI) scenario
15+
16+
This article introduces how to gather information by using the TroubleShootingScript (TSS) toolset for SQL cluster (AG/FCI) related issues.
17+
18+
Before contacting Microsoft support, you can gather information about your issue.
19+
20+
## Prerequisites
21+
22+
Refer to [Introduction to TroubleShootingScript toolset (TSS)](introduction-to-troubleshootingscript-toolset-tss.md#prerequisites) for prerequisites for the toolset to run properly.
23+
24+
## Scenario: Virtualization and Hyper-V
25+
26+
### TSS cmdlet
27+
28+
```powershell
29+
.\TSS.ps1 -SDP SQLbase
30+
```
31+
32+
### TSS cmdlet description
33+
34+
1. Download [TSS](https://aka.ms/getTSS) and extract it in the *C:\\tss* folder.
35+
2. Open the *C:\\tss* folder from an elevated PowerShell command prompt.
36+
> [!NOTE]
37+
> Don't use the Windows PowerShell Integrated Scripting Environment (ISE).
38+
3. Run the following cmdlets:
39+
40+
```powershell
41+
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
42+
```
43+
44+
```powershell
45+
.\TSS.ps1 -SDP SQLbase
46+
```
47+
48+
4. Enter *A* for "Yes to All" for the execution policy change.
49+
50+
> [!NOTE]
51+
>
52+
> - The time to collect this script on a given system may vary. It depends on system speed, system size, the number of virtual machines, the amount of data in logs, and so on. Depending on these factors, the average collection time is between 30 and 90 minutes, or even longer, especially if no skip commands are used.
53+
> - The collection is stored in a compressed file in the *C:\\MS_DATA* folder. After a support case is created, this file can be uploaded to the secure workspace for analysis.
54+
55+
## Optional parameters
56+
57+
Some parameters are optional to perform a quicker and more streamlined collection, which may help the script finish successfully if a certain section stops responding.
58+
59+
- This cmdlet skips running the Best Practices Analyzer and makes the collection faster.
60+
61+
```powershell
62+
.\TSS.ps1 -SDP SQLbase -SkipSDPList skipBPA
63+
```
64+
65+
- This cmdlet skips some small collection items that may fail in a regular collection and makes the script more reliable.
66+
67+
```powershell
68+
.\TSS.ps1 -SDP SQLbase -SkipSDPList skipHang
69+
```
70+
71+
- This cmdlet skips some additional collection parameters that may not be needed.
72+
73+
```powershell
74+
.\TSS.ps1 -SDP SQLbase -SkipSDPList skipTS
75+
```
76+
77+
- This cmdlet skips testing Server Message Block (SMB) connectivity to any Cluster Shared Volumes (CSVs) in the failover cluster.
78+
79+
```powershell
80+
.\TSS.ps1 -SDP SQLbase -SkipSDPList skipCsvSMB
81+
```
82+
83+
> [!NOTE]
84+
> You can combine multiple skip parameters with comma-separated items, such as the following example:
85+
>
86+
> ```powershell
87+
> .\TSS.ps1 -SDP SQLbase -SkipSDPList skipBPA,skipHang,skipTS,skipCsvSMB
88+
> ```

support/windows-server/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3288,7 +3288,7 @@ items:
32883288
href: ../windows-client/windows-tss/collect-data-analyze-troubleshoot-sys-management-components-scenarios.md?context=/troubleshoot/windows-server/context/context
32893289
- name: Collect data to analyze and troubleshoot Hyper-V related issues
32903290
href: ../windows-client/windows-tss/collect-data-analyze-troubleshoot-hyperv-scenarios.md?context=/troubleshoot/windows-server/context/context
3291-
- name: Gather information for SQL cluster (AG/FCI) related issues
3292-
href: ../windows-client/windows-tss/gather-information-using-tss-sql-cluster-ag-fci-issues.md?context=/troubleshoot/windows-server/context/context
3291+
- name: Collect data to analyze and troubleshoot SQL cluster (AG/FCI) related issues
3292+
href: ../windows-client/windows-tss/collect-data-analyze-troubleshoot-sql-cluster-ag-fci-scenarios.md?context=/troubleshoot/windows-server/context/context
32933293
- name: Use the xray feature of TSS
32943294
href: ../windows-client/windows-tss/use-the-xray-feature-of-tss-to-identify-known-issues.md?context=/troubleshoot/windows-server/context/context

0 commit comments

Comments
 (0)