add check win processes

Signed-off-by: dw035535 <diane.wang@broadcom.com>

Author: Tomorrow9

windows/guest_customization/win_gosc_verify.yml

@@ -27,6 +27,8 @@
       include_tasks: check_runonce_command.yml
     - name: "Check timezone configured"
       include_tasks: check_timezone.yml
+    - name: "Check Windows readiness"
+      include_tasks: win_check_os_readiness.yml
     - name: "Get 'explorer.exe' process status"
       include_tasks: ../utils/win_get_explorer_process.yml
     - name: "Check 'explorer.exe' process status"

windows/utils/win_check_active_update.yml

@@ -0,0 +1,48 @@
+# Copyright 2025 VMware, Inc.
+# SPDX-License-Identifier: BSD-2-Clause
+---
+# Get these 2 processes' info to check if the Windows is actively installing or
+# configuring something.
+# "TiWorker.exe (Windows Modules Installer Worker)" is the primary process
+# responsible for installing updates and modifying system files.
+# "msiexec.exe" is the Windows Installer engine, if running as SYSTEM user (Session 0),
+# it means a background installation (like a driver or managed app) is happening.
+#
+- name: "Set facts of the commands for checking Windows status"
+  ansible.builtin.set_fact:
+    check_tiworker: "Get-Process TiWorker -ErrorAction SilentlyContinue | Format-List -Property *"
+    check_msiexec: "Get-Process msiexec -IncludeUserName -ErrorAction SilentlyContinue | Where-Object {$_.UserName -match 'SYSTEM'} | Format-List -Property *"
+
+- name: "Get 'TiWorker.exe' process info"
+  include_tasks: win_execute_cmd.yml
+  vars:
+    win_powershell_cmd: "{{ check_tiworker }}"
+    win_execute_cmd_ignore_error: true
+
+- name: "Save the result of getting 'TiWorker.exe' process info"
+  ansible.builtin.set_fact:
+    check_tiworker_result: "{{ win_powershell_cmd_output }}"
+
+- name: "Get 'msiexec.exe' process info"
+  include_tasks: win_execute_cmd.yml
+  vars:
+    win_powershell_cmd: "{{ check_msiexec }}"
+    win_execute_cmd_ignore_error: true
+
+- name: "Save the result of getting 'msiexec.exe' process info"
+  ansible.builtin.set_fact:
+    check_msiexec_result: "{{ win_powershell_cmd_output }}"
+
+- name: "Set fact of Windows is actively installing updates"
+  ansible.builtin.set_fact:
+    os_in_active_updates: true
+  when: >
+    (check_tiworker_result.rc is defined and check_tiworker_result.rc == 0) or
+    (check_msiexec_result.stdout is defined and check_msiexec_result.stdout | length != 0)
+
+- name: "Set fact of Windows is not actively installing updates"
+  ansible.builtin.set_fact:
+    os_in_active_updates: false
+  when:
+    - check_tiworker_result.rc is defined and check_tiworker_result.rc != 0
+    - check_msiexec_result.stdout is defined and check_msiexec_result.stdout | length == 0

windows/utils/win_check_os_readiness.yml

@@ -0,0 +1,45 @@
+# Copyright 2025 VMware, Inc.
+# SPDX-License-Identifier: BSD-2-Clause
+---
+# Check Windows system readiness after booting up 
+#
+- name: "Initialize the readiness of Windows"
+  ansible.builtin.set_fact:
+    os_in_active_updates: false
+
+- name: "Retry to check if Windows is actively installing updates"
+  include_tasks: win_check_active_update.yml
+  loop: "{{ range(1, 11) | list }}"
+  loop_control:
+    pause: 3
+    break_when:
+      - os_in_active_updates
+
+- name: "Debug message"
+  ansible.builtin.debug:
+    msg: "Not get the processes that can indicating the Windows is actively installing updates in 30s."
+  when: not os_in_active_updates
+
+- name: "Debug message"
+  ansible.builtin.debug:
+    msg: "Windows guest OS is actively installing updates or configuring something."
+  when: os_in_active_updates
+
+- name: "Wait for Windows updates installation completes"
+  when: os_in_active_updates
+  block:
+    - name: "Retry to check if Windows completes installing updates"
+      include_tasks: win_check_active_update.yml
+      loop: "{{ range(1, 201) | list }}"
+      loop_control:
+        pause: 3
+        break_when:
+          - not os_in_active_updates
+    - name: "Debug message"
+      ansible.builtin.debug:
+        msg: "Still can get the processes that indicating the Windows is actively installing updates in 600s."
+      when: os_in_active_updates
+    - name: "Debug message"
+      ansible.builtin.debug:
+        msg: "Windows guest OS completes the updates install."
+      when: not os_in_active_updates

windows/utils/win_get_explorer_process.yml

@@ -4,6 +4,9 @@
 # Description:
 #   Get process 'explorer.exe' in Windows guest OS to check
 # if there is black screen issue occurs.
+# Parameters:
+#   win_get_explorer_timeout: the retry time in seconds to get
+#     the status of process 'explorer.exe'.
 # Return:
 #   win_explorer_running: true or false. Whether the process
 #     'explorer.exe' is running in guest OS.
@@ -12,11 +15,17 @@
   ansible.builtin.set_fact:
     win_explorer_running: false
 
-- name: "Get the status of process 'explorer.exe'"
-  include_tasks: win_execute_cmd.yml
-  vars:
-    win_powershell_cmd: "Get-Process -Name explorer"
-    win_execute_cmd_ignore_error: true
+- name: "Wait for 'explorer.exe' process starting"
+  ansible.windows.win_shell: 'Get-Process -Name explorer'
+  delegate_to: "{{ vm_guest_ip }}"
+  register: get_service_status
+  delay: 5
+  retries: "{{ (win_get_explorer_timeout | default(300) / 5) | round | int }}"
+  until:
+    - get_service_status.rc is defined
+    - get_service_status.rc == 0
+  ignore_errors: true
+  ignore_unreachable: true
 
 - name: "Set fact of the status of process 'explorer.exe'"
   ansible.builtin.set_fact: