Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

Dell EMC OpenManage Integration Version 2.0 with Microsoft Windows Admin Center User’s Guide

Troubleshooting

Upgrading

Extension installation failed

When you try to install OpenManage Integration snap-in during Azure Stack HCI cluster creation or update, the extension installation may fail.

Reason: An older version of the extension (OMIMSWAC 1.1.1 or earlier) may have already been installed.

Resolution:
  • Uninstall the older version, and then install the OpenManage Integration snap-in during Azure Stack HCI cluster creation or update. See Installing Dell EMC OpenManage Integration with Microsoft Windows Admin Center section in OMIMSWAC installation Guide.
  • To upgrade to OpenManage Integration snap-in from earlier versions, go to Extensions > Installed extensions tab. Select Dell EMC OpenManage Integration extension with the status "Update available (version)," and then click Update.

Licensing

Licensing status is Unknown or Non-licensed

If the license status is Unknown or Non-licensed, ensure that:
  • License is not expired.
  • Licenses are present on each target node.
  • Target node is not in the reboot state and is powered on.
  • Redfish is enabled.
  • Azure stack HCI license or PowerEdge server license is imported onto the respective hardware. Importing Azure stack HCI license to a PowerEdge server or PowerEdge server license to an Azure stack HCI server is not supported.
If the problem persists:
  1. Go to iDRAC.
  2. Ensure that Redfish service is enabled.
  3. Disable OS to iDRAC Pass-through and then enable it.

    For more information about enabling or disabling OS to iDRAC Pass-through, see iDRAC user guide.

Logs

Availability of OMIMSWAC extension logs

The OpenManage Integration with Microsoft Windows Admin Center (OMIMSWAC) extension logs of target nodes and cluster nodes are available at <Windows Directory>\Temp\OMIMSWAC on target nodes. The logs capture information when the OMIMSWAC functionalities are run and also provide debug information about any errors that occur while performing any OMIMSWAC operations. The logs of various OMIMSWAC functionalities can be easily accessed with the help of the following naming convention:
  • For hardware and health inventory: Inventory<ID*>
  • For update compliance: FirmwareCompliance<ID*>
  • For update notifications: Notification<ID*>

Availability of update operation logs

The application logs for the update compliance feature is available at the following path:
  • Gateway system: <Windows Directory>\ServiceProfiles\NetworkService\AppData\Local\Temp\generated\logs
  • Windows 10 gateway system: <Windows installed drive>\Users\<user_name>\AppData\Local\Temp\generated\logs
Online catalogs download status is captured in the application logs and can be referred to troubleshoot any download errors in the online catalogs.
When online catalog source is selected, and if DSU and IC are not configured in settings in advance, OMIMSWAC will download the catalog, DSU, and IC utilities in the following path:
  • Gateway system: <Windows Directory>\ServiceProfiles\NetworkService\AppData\Local\Temp\generated\Share\temp\<server/cluster_name>
  • Windows 10 gateway system: <Windows installed drive>\Users\<user_name>\AppData\Local\Temp\generated\Share\temp\<server/cluster_name>
Ensure that the downloaded catalog file, DSU and IC are not modified during compliance generation and update. The catalog file, DSU, and IC utilities are automatically removed after the compliance report is generated and updated.

Logs for pre-update script running on HCI clusters to put storage into maintenance mode are available at <Windows Directory>\Temp\precau.log on each node. And logs for post update script running on HCI clusters to restore storage from maintenance mode are available at <Windows Directory>\Temp\postcau.log on each node.

Availability of licensing logs

The license related logs are available at the following path and can be found by searching DellLicenseCollection in the Cleanup file.
  • Gateway system: <Windows Directory>\ServiceProfiles\NetworkService\AppData\Local\Temp\generated\logs\CleanupXXXXXXXXXXXXXX.log
  • Windows 10 gateway system: <Windows installed drive>\Users\<user_name>\AppData\Local\Temp\generated\logs\CleanupXXXXXXXXXXXXXX.log

Health, hardware, and iDRAC inventory

Unable to copy the required files to the target node to fetch inventory information.

Ensure that:
  • Target node is not in the reboot state and is powered on.
  • Firewall is not blocking communication through SMB port 445. For more information, see prepare your environment for Windows Admin Center.
  • The USB NIC adapter is not disabled on the target node operating system.

Unable to fetch the health and hardware inventory from iDRAC

To fetch the health and hardware inventory information from iDRAC, ensure that:
  • YX3X and YX2X models of PowerEdge servers are updated with latest iDRAC version of 2.60.60.60 or later.
  • YX4X models of PowerEdge Servers are updated with latest iDRAC version of 3.30.30.30 or later.
  • For management of PowerEdge servers, OMIMSWAC uses an internal operating system to iDRAC Pass-through interface. By default, iDRAC is reachable using the IP address 169.254.0.1/<Subnet> or 169.254.1.1/<Subnet>. However, if the host has another network interface in the same subnet (for example, when tool such as VMFleet is installed), OMIMSWAC might not be able to communicate to the iDRAC from the host operating system.

    To resolve the conflict, log in to iDRAC and change the USB NIC IP address under the operating system to iDRAC passthrough section. For more information about assigning this IP address, see the iDRAC documentation on the support site.

  • For management of Clusters, all the cluster nodes are reachable using IP address, Hostname, and Fully Qualified Domain Name (FQDN) before managing the cluster with OMIMSWAC.
  • If the Redfish service is disabled, enable the Redfish service by using iDRAC UI. For more information, see the iDRAC documentation on Dell EMC support site.
  • User slots are available on iDRAC to create new users.

Health and hardware inventory of YX2X, YX3X, and YX4X models of PowerEdge servers not displayed

  • Ensure that YX3X and YX2X models of PowerEdge servers are updated with latest iDRAC version of 2.60.60.60 or later.
  • Ensure that YX4X models of PowerEdge Servers are updated with latest iDRAC version of 3.30.30.30 or later.

Overall health status shows warning or critical while health status of node components shows healthy

The overall health status of PowerEdge servers, failover clusters, and HCI clusters might be displayed as critical or warning even if the components of the nodes displayed on the Windows Admin Center are healthy. Because the health status of physical disks that are attached to embedded SATA controller may be displayed as Unknown as iDRAC is unable to get the health information for these disks.

For more details on the components in critical health state, go to the respective iDRAC console.

Unable to create users on target iDRAC device

If the lockdown mode is enabled on YX4X model of PowerEdge Servers and above, inventory of health, hardware, and iDRAC fails with the error: “Unable to create users on target iDRAC device.”

Resolution: Disable the lockdown mode on the target node managed by Dell EMC OpenManage Integration.

Unable to initialize the OMIMSWAC extension.

Retrieving inventory from servers and cluster nodes may fail with the error: Unable to initialize the OMIMSWAC extension.

Resolution: Ensure the IPMI driver is installed, and the IPMI service is running on the target node. For more information on the requirement and solution, see Dell information center.

Blink and Unblink

Unable to complete or select the disks for the blink or unblink operations

  • Cause: The Redfish service is not enabled.

    Resolution: Enable the Redfish service by using iDRAC UI. For more information, see the iDRAC documentation on Dell EMC support site.

  • Cause: After the hardware inventory is loaded in OMIMSWAC, if the physical disk is removed then the blink and unblink operations fail with error: Blink may not be supported with <Disk_Name>.

    Resolution: Insert the physical disk and click Refresh to reload the inventory information in OMIMSWAC, and rerun the blink and unblink operations.

  • Cause: If the iDRAC firmware version is less than 3.30.30.30, the physical disks cannot be selected to blink or unblink.

    Resolution: Update the iDRAC firmware to the latest version and retry the blink and unblink operations.

  • Blink and unblink operations fail when a physical disk is attached to an embedded SATA controller and the health status is Unknown, indicating that blink or unblink operation may not be supported on the disk.

Cluster-Aware Updating

Job failed while downloading the required components for the update compliance operation

While downloading the DSU and IC tools, the update jobs may fail due to various reasons. Probable causes and solutions are given below:

  • Cause: While exporting the repository by using Dell EMC Repository Manager (DRM), the export job may complete with status as "Partially succeeded." In this case, one or more DUPs may be missing from the repository.

    Resolution: Retry exporting the repository in DRM and ensure that the job is successfully completed.

  • Cause: One or more components may not be downloaded when the 'update source' is selected as an online source.

    Resolution: Ensure that there is Internet connectivity and retry downloading the catalog from the online source. For more information, see Dell EMC Repository Manager user guide.

Unable to download the DUP(s)

  • Ensure to access the Windows Admin Center remotely using domain user credentials. Otherwise, use local administrator credentials to access the WAC locally. For more information, see Microsoft documents.

  • Check your Internet connection or proxy configuration.

Unable to generate compliance report

  • Cause: When you connect to a target node or cluster using Single-Sign-on rather than 'Manage as' and generate compliance report using OMIMSWAC, the compliance generation may fail.

    Resolution: Before connecting to the target node or cluster, ensure that you select "Manage as" and provide appropriate Server Administrator or Cluster Administrator accounts.

  • Cause: When generating a compliance report, the compliance report generation may fail with the following error in the log:
    Starting a command on the remote server failed with the following error message : The WinRM client sent a request to the remote WS-Management service and was notified that the request size exceeded the configured MaxEnvelopeSize quota. For more information, see the about_Remote_Troubleshooting Help topic.
    Resolution: Ensure that:
    • Network connectivity between the gateway system and the target node is intact.
    • File copying works between the gateway system and the target node. To check this:
      1. Create a session based on target node credential by executing the following PowerShell command:

        $SecurePassword = convertto-securestring <password> -asplaintext -force

        $credential = New-Object System.Management.Automation.PSCredential -ArgumentList <userid>, $SecurePassword

        $session = New-PSSession -ComputerName <MN FQDN> -Credential $credential -ErrorAction SilentlyContinue

      2. Copy a test file to the failed target node assuming "Test.txt" is in C:\ drive

        Copy-Item -Path "C:\Test.txt" -Destination "C:\" -Recurse -Force -ToSession $session

    • If the problem persists after performing the above actions, try restarting the Windows Remote Management (WS-Management) service in the target node (file copy is failing) then re-run the compliance.
  • Cause: When generating a compliance report for a cluster, the compliance report generation may fail for cluster nodes.

    Resolution: Ensure that:

    • The cluster service is running on the cluster node by using the Get-ClusterService PowerShell command.
    • The cluster node is not rebooting or in the powered-off state.
    • When adding a cluster to the Windows Admin Center, ensure to use the cluster name in FQDN format.
  • Cause: When generating a compliance report using Windows 10 Microsoft Edge browser, the compliance report generation may fail with the following error: Unable to generate compliance report. The Manage As credentials have not been set or are not in domain\user format.
    Resolution: Do any of the followings:
    • Connect the target node with credentials using Fully Qualified Domain Name (For example, domain.lab\username) or Top Level Domain (For example, domain\username).
    • Clear the cache memory of the browser and rerun the compliance.
    • Ensure that the DNS is configured properly in the WAC installed system to connect to the target node with right credentials.
  • Cause: Compliance report generation may fail with the following error Unable to install Dell System Update(DSU) package for the server/cluster because DSU installation operation is already in progress for another server/cluster. This occurs because, a user may be trying to run compliance concurrently from two different instances/sessions. For example, one instance by clicking the pop-out button and another instance by using the browser from the same gateway at the same time. One of the instance/sessions that was triggered first proceeds for compliance/update; while another results in an error.

    Resolution: Run only one compliance/update for a target node/cluster at a time using one gateway instance.

Compliance report page on loading state for a long time

While generating a compliance report, the compliance report page may show up in the loading state even after the notification of successfully generated update compliance report.

In this case, go to any of the other tabs such as "Settngs", "Inventory", and so forth,, and then go back to the Update tab, where you will see the generated compliance report.

Job failed while updating the selected components

Sometimes, CAU or target node updates may fail due to various reasons. The causes and resolutions are given below:

  • Causes: If target nodes are not validated before triggering CAU, the CAU may fail.

    Resolution: For Cluster-Aware Updating, ensure to validate the cluster before triggering CAU. For more information about validating a cluster, see Microsoft document Validate Hardware for a cluster.

  • Causes: If Failover Clustering feature and Failover Clustering Tools are not installed on target nodes, the CAU may fail.

    Resolution: As OMIMSWAC uses the Microsoft Cluster-Aware Updating feature framework to perform cluster updates, before updating a cluster using OMIMSWAC, ensure that the Failover Clustering feature and Failover Clustering Tools are installed on all the target nodes. For more information, see CAU requirements and best practices in Microsoft documents.

    To check whether failover clustering tools are running on all the target nodes, from the PowerShell window on the target node, run the Get-CauClusterRole PowerShell command.

  • Cause: Compliance Inventory file is not available for some nodes or file copying from node to gateway is failed after compliance generation.

    Resolution: Rerun the compliance.

  • Cause: Due to Internet connectivity issue, the followings may fail:
    • Signature verification of DSU or IC
    • Downloading of online catalog
    • Downloading of DUP

    If any of the above fails, CAU or server update also fails.

    Resolution: Ensure that there is Internet connectivity and rerun compliance and update.

  • Cause: DSU installer is not cleared from a node because the installer file sometimes gets locked by the Windows Admin Center process (sme.exe).

    Resolution: Restart the Windows Admin Center service from Windows Services consoles.

  • Cause: CAU fails if any of the disks is not in healthy state.

    Resolution: Ensure both physical and virtual disks are in healthy state before triggering CAU. If any disk is in an unhealthy healthy state, see the Microsoft document to get it to a healthy state.

  • Cause: CAU fails if any of the cluster nodes is paused.

    Resolution: Resume cluster nodes (Failover roles) before triggering CAU.

  • Cause: CAU fails when Failover Clustering feature and Failover Clustering Tools are not installed on all the target nodes.

    Resolution: Ensure Failover Clustering feature and Failover Clustering Tools are installed on all the target nodes before performing CAU. For more information, see https://docs.microsoft.com/en-us/windows-server/failover-clustering/cluster-aware-updating-requirements.

CredSSP Failure
Check the event viewer logs in the gateway system to ensure that CredSSP has not failed during Cluster-Aware Updating. If the CredSSP fails, following are the probable causes and solutions:
  • Cause: While updating a cluster, credential delegation using CredSSP may fail.

    Resolution: Reconnect the cluster using fully qualified domain name, and click Use this credential for all servers check box.

    For example, if the domain name is test.dev.com, use test.dev.com\administrator as the domain name, and then click Use this credential for all servers check box.

  • Cause: When using CredSSP authentication to run scripts on a remote machine, the update job may fail with an error.

    The issue is because CredSSP has been disabled in the gateway machine.

    Resolution: To resolve the issue, follow the steps below:
    1. From PowerShell window, run gpedit
    2. In the Group Policy Editor window, Computer Configurations > Administrative Templates > System > Credentials Delegation
    3. Select Allow delegating fresh credentials with NTLM-only server authentication and enable it.
    4. Run gpupdate /force in the PowerShell.
Dell Update Package failures
The Dell EMC Update Package (DUP) may fail to update components after you trigger an update. There are various reasons for the DUP to fail during the update. Look at the following possible solutions to resolve the issue:
  • In Windows Admin Center (WAC) installed machine, check the log files to get more information regarding DUP download failure and component mapping. The component mapping is provided to identify the component (selected for update) in the DUP catalog. The log files are at the following path.

    Gateway system:

    • Server update: <Windows Directory>\ServiceProfiles\NetworkService\AppData\Local\Temp\generated\logs\<PrepareUpdate XXXX>
    • CAU: <Windows Directory>\ServiceProfiles\NetworkService\AppData\Local\Temp\generated\logs\Update XXXX
    Windows 10 gateway system:
    • Server update: <Windows installed drive>\Users\<user_name>\AppData\Local\Temp\generated\logs\<PrepareUpdate XXXX>
    • CAU: <Windows installed drive>\Users\<user_name>\AppData\Local\Temp\generated\logs\Update XXXX
  • Sample log messages are given below:
    • DUP download failure error log

      28-Apr-2020 12:19:18 AM::: Error >>> Message : DUPs for some of the selected components are not present in DRM repository.

    • Component mapping log file

      ## Format: :>> Component Name -> Package Name

      :>> [0001] Broadcom NetXtreme Gigabit Ethernet -> Network_Firmware_RG25N_WN64_21.60.2_01.EXE

  • In the target node, refer component mapping and find the component related DUP log file and check the return code that is specified in <Windows Directory>\Dell\UpdatePackage\log\<Package Name>. See Dell EMC Update Package user guide for cause and possible resolution.

    A return code sample of a DUP failure scenario is given below:

    Exit code = 1 (Failure)

    2020-04-21 23:48:27

    Update Package finished. Exit code = 1

  • The DUP may fail when attempting to downgrade a driver component to a lower version. In this case, uninstall the driver from the operating system then rerun the component update from OMIMSWAC. For more information about how to uninstall drivers, see Microsoft document.
  • After cluster update, you may see components showing as non-compliant. This happens because of DUP failure.

    Resolution: In this case, check the cleanup logs having the DSU logs to see if there is any ERROR for those components. If there is any prerequisite that is required for the component before update, follow the prerequisite and then rerun the update.

Alternatively, you can also try the followings:
  • Reset and update the iDRAC to version 4.20.20.20 or higher and then rerun the update. For more information about how to Reset or update iDRAC, see iDRAC documentation.
  • Run the update manually in the target node by downloading from the path specified in <Windows Directory>\Dell\UpdatePackage\log\<Package Name> in the DUP log. Example for a network firmware is https://downloads.dell.com/FOLDER06091050M/1/Network_Firmware_TWFF6_WN64_16.26.60.00.EXE.
  • Ensure that the selected DUP is supported on the selected operating system and platform by searching the component name in the Dell Support site. Dell support site URL: https://www.dell.com/support/home/in/en/inbsd1/?app=products.

Full Stack Cluster-Aware Updating

Couldn't configure cluster aware updates

Cause: To perform full stack updates, in Windows Admin Center, when you select Updates from the Tools menu, an error might occur: Couldn't configure cluster aware updates. This error occurs because CAU clustered role could not be added to the cluster for update.

Resolution: As a workaround, you can add the cluster role manually using the following PowerShell command before triggering the full stack update: Add-CauClusterRole -StartDate "02-03-2021 3:00:00 AM" -DaysOfWeek Tuesday -WeeksOfMonth 3 -EnableFirewallRules -RequireAllNodesOnline -Force

For more information, see Configure the nodes for remote management in Microsoft documents.

Couldn't query readiness for cluster aware updates

Cause: To perform full stack updates, in Windows Admin Center, when you select Updates from the Tools menu, an error might occur: Couldn't query readiness for cluster aware updates. This error occurs because of CredSSP failure.

Resolution: As a workaround, see CredSSP failure to find the cause and solution.

For more information, see the Microsoft document.

Tests Summary page appears

While triggering full stack updates, Tests Summary page may appear.

Resolution: As a workaround, verify if pre-update or post-update script are part of the cluster role. If present, remove the scripts from the cluster node by running the following command in PowerShell: Set-CauClusterRole -PreUpdateScript $null -PostUpdateScript $null. For more information about prerequisites required for cluster update, see the Microsoft document.

Update status takes longer to refresh

During full stack cluster updates, the update status that is shown in the Updates page may take longer to refresh. In this case, it is recommended to stay on the Updates page and wait for the update to complete. The update status will automatically be displayed once the update is complete. For more information about Microsoft recommendations, see the Microsoft document.

Full stack update may fail with failover cluster tool extension 1.271.0 nupkg

During full stack cluster updates in Azure Stack HCI clusters, the update may fail with an exception Error: RemoteException: Exception calling "Add" with "2" argument(s): "Item has already been added. Key in dictionary: 'PreUpdateScript' Key being added: 'PreUpdateScript'". This issue occurs when Microsoft Failover Cluster Tool Extension 1.271.0 is installed. Due to this issue, both hardware and OS cluster-aware updates (Full stack update) cannot be performed together.

Resolution: Upgrade to the latest Microsoft Failover Cluster Tool Extension 1.280.0.nupkg available in the Microsoft feed to perform full stack cluster update.

Others

OpenManage Integration access denied

Cause: When you log in to Windows Admin Center (WAC) using gateway user credentials without admin privileges and try to launch OpenManage Integration from the WAC console, access denied error may appear.

Resolution: Before you launch Dell EMC OpenManage Integration extension in Windows Admin Center, ensure to log in to WAC as a gateway administrator.

Test-Cluster fails with network communication errors

Cause: With USB NIC enabled in iDRAC, if you run Test-Cluster command to verify the cluster creation readiness or cluster health, you may see an error in the validation report. The error states that the IPv4 addresses assigned to the host operating system USB NIC cannot be used to communicate with the other cluster networks. This error can be safely ignored.

Resolution: Disable the USB NIC (labeled as Ethernet by default) temporarily before running the Test-Cluster command.

USB NIC network shows as partitioned cluster network

Cause: When the USB NIC is enabled in iDRAC, cluster networks in the failover cluster manager show the networks that are associated with the USB NIC as partitioned. This issue occurs as cluster communications are enabled by default on all network adapters and USB NIC IPv4 addresses cannot be used to communicate externally, thus disrupting cluster communication on those NICs. This error can be safely ignored.

Resolution: Disable cluster communication with the networks associated with the USB NICs from the cluster manager.

Acceptance Failed to save: Dell EMC Software License Agreement and Customer Notice

Cause: Dell EMC Software License Agreement and Customer Notice acceptance may fail to save. This may happen when you launch multiple instances of the Dell EMC OpenManage Integration extension from the same gateway, and accept terms and conditions in one instance. In the remaining instances, if you attempt to accept the terms and conditions, you will encounter this error.

Resolution: Navigate away from the Dell EMC OpenManage Integration extension where this issue occurs, and then back in to resolve this issue.


Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\