Skip to content

Commit e06f3aa

Browse files
committed
comment addressed
1 parent f6828d6 commit e06f3aa

7 files changed

Lines changed: 16 additions & 12 deletions

support/azure/service-fabric/cluster/media/Health-check.png renamed to support/azure/service-fabric/cluster/media/cluster-health-check.png

File renamed without changes.

support/azure/service-fabric/cluster/media/Infrastructure-job-view.png renamed to support/azure/service-fabric/cluster/media/cluster-infrastructure-job-view.png

File renamed without changes.

support/azure/service-fabric/cluster/media/Infrastructure-service-health.png renamed to support/azure/service-fabric/cluster/media/cluster-infrastructure-service-health.png

File renamed without changes.

support/azure/service-fabric/cluster/media/Job-Throttling-status-for-IS.png renamed to support/azure/service-fabric/cluster/media/cluster-job-throttling-status.png

File renamed without changes.

support/azure/service-fabric/cluster/media/Repair-task-executing.png renamed to support/azure/service-fabric/cluster/media/cluster-repair-task-executing.png

File renamed without changes.

support/azure/service-fabric/cluster/media/RepairManager-Service-Health.png renamed to support/azure/service-fabric/cluster/media/cluster-repairmanager-service-health.png

File renamed without changes.

support/azure/service-fabric/cluster/Troubleshooting-guide-for-customers-to-investigate-and-analyse-using-Service-Fabric-Explorer-why-repair-jobs-are-not-being-approved.md renamed to support/azure/service-fabric/cluster/troubleshoot-service-fabric-repair-jobs.md

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,11 @@ ms.date: 01/20/2026
1313
# Troubleshooting guide for customers to investigate and analyse, using Service Fabric Explorer (SFX), why repair jobs are not being approved
1414

1515
## Repair Task overview in service fabric
16-
Any operation initiated from the Virtual Machine Scale Set (VMSS) that targets VMs is processed by Service Fabric (SF) as a repair task derived from the job it receives. The Infrastructure Service creates a repair task for each job and enriches it with details such as the update type, targeted update domain (UD), and document incarnation number. These jobs begin with UD0 and progress sequentially through UD1, UD2, and so on within the Service Fabric cluster. If an Update Domain walk is required, separate repair tasks are generated for each UD. For example, in a cluster with five UDs, five distinct repair tasks will be created. These tasks execute one after another, UD by UD, and their progress can be tracked in Service Fabric Explorer (SFX).
16+
Any operation initiated from the scale-set that targets VMs is processed by Service Fabric as a repair task derived from the job it receives. The Infrastructure Service creates a repair task for each job and adds details like the update type, targeted update domain (UD), and document incarnation number. These jobs begin with UD0 and progress sequentially through UD1, UD2, and so on within the Service Fabric cluster. If an Update Domain walk is required, separate repair tasks are generated for each UD. For example, in a cluster with five UDs, five distinct repair tasks will be created. These tasks execute one after another, UD by UD, and their progress can be tracked in Service Fabric Explorer (SFX).
1717

18-
RepairManager – Repair Manager (RM) defines and implements a safe workflow for performing repairs by coordinating between the Repair Requestor, Repair Executor, and itself to ensure safe and consistent repair actions.
18+
Repair Manager - defines and implements a safe workflow for performing repairs by coordinating between the Repair Requestor, Repair Executor, and itself to ensure safe and consistent repair actions.
1919

20-
Infrastructure Service – Infrastructure Service (IS) is responsible for managing and orchestrating infrastructure-level operations, such as updates and repairs, ensuring the health and stability of the Service Fabric cluster.
20+
Infrastructure Service – responsible for managing and orchestrating infrastructure-level operations, such as updates and repairs, ensuring the health and stability of the Service Fabric cluster.
2121

2222
### Repair Task vs. Repair Job
2323

@@ -47,11 +47,11 @@ In the Created state, the Repair Manager (RM) accepts and stores the repair requ
4747

4848
* Claimed
4949

50-
Once the task is Claimed, the Repair Executor (RE) has taken ownership but has not yet specified the repair's impact. The requestor still retains the ability to cancel the task at this stage. Repair executor has ownership in this state.
50+
Once the task is Claimed, the Repair Executor (RE) has taken ownership but hasn't specified the repair's impact. The requestor still retains the ability to cancel the task at this stage. Repair executor has ownership in this state.
5151

5252
* Preparing
5353

54-
In the Preparing state, the Repair Executor specifies the impact, and the Repair Manager prepares the environment, such as deactivating nodes. If the task is cancelled now, it skips execution and moves directly to restoring. Operator also have the option to force approval, bypassing certain safety checks. Repair Manager has ownership in this state.
54+
In the Preparing state, the Repair Executor specifies the impact, and the Repair Manager prepares the environment, such as deactivating nodes. If the task is cancelled now, it skips execution and moves directly to restoring. Operator also has the option to force approval, bypassing certain safety checks. Repair Manager has ownership in this state.
5555

5656
* Approved
5757

@@ -73,8 +73,12 @@ Finally, in the Completed state, the task is finished, and no further state chan
7373

7474
### Infrastructure Jobs view
7575

76-
To view jobs that have been submitted to Service Fabric for approval, navigate to the Infrastructure Jobs tab under cluster view. Each entry includes a Job ID, which remains consistent across Service Fabric as well as outside service fabric. The Acknowledgement Status indicates whether the job has been approved by Service Fabric: • WaitingForAcknowledgement means the job is still pending approval. • Acknowledged confirms that the job has been approved by Service Fabric. This view represents perspective of the job. Jobs will only appear here when they are present in the received document. In addition to the Job ID and Acknowledgement Status, the Impact Types section displays the nature of the job’s impact. The Current Repair Task section shows which repair task is actively running for the job approval on the Service Fabric side. By selecting All Repair Tasks, you can view the status of every repair task associated with the current job.
76+
To view jobs that have been submitted to Service Fabric for approval, navigate to the **Infrastructure Jobs** tab under cluster view. Each entry includes a **Job ID**, which remains consistent across Service Fabric and outside service fabric. The **Acknowledgement Status** indicates whether the job has been approved by Service Fabric:
7777

78+
- **WaitingForAcknowledgement** means the job is still pending approval.
79+
- **Acknowledged** confirms that the job has been approved by Service Fabric.
80+
81+
This view represents perspective of the job. Jobs will only appear here when they are present in the received document. In addition to the **Job ID** and **Acknowledgement Status**, the **Impact Types** section displays the nature of the job’s impact. The **Current Repair Task** section shows which repair task is actively running for the job approval on the Service Fabric side. By selecting **All Repair Tasks**, you can view the status of every repair task associated with the current job.
7882

7983
<center>
8084
![Infrastructure Job view][Image1]
@@ -141,12 +145,12 @@ To check if any job is being throttled for a specific Infrastructure Service, se
141145
</center>
142146

143147

144-
[Image1]:./media/Infrastructure-job-view.png
148+
[Image1]:./media/cluster-infrastructure-job-view.png
145149
[Image2]:./media/repair-task-view.png
146-
[Image3]:./media/Health-check.png
150+
[Image3]:./media/cluster-health-check.png
147151
[Image4]:./media/safety-check-view.png
148-
[Image5]:./media/Repair-task-executing.png
152+
[Image5]:./media/cluster-repair-task-executing.png
149153
[Image6]:./media/completed-repair-task-view.png
150-
[Image7]:./media/Infrastructure-service-health.png
151-
[Image8]:./media/RepairManager-Service-Health.png
152-
[Image9]:./media/Job-Throttling-status-for-IS.png
154+
[Image7]:./media/cluster-infrastructure-service-health.png
155+
[Image8]:./media/cluster-repairmanager-service-health.png
156+
[Image9]:./media/cluster-job-throttling-status.png

0 commit comments

Comments
 (0)