Update Reset Tool (CMUpdateReset.exe)

Share

Since SCCM CB 1706 there is a utility named "Configuration Manager Update Reset Tool", this tool is used to repair update download or replication problems from the console.

This command line tool will save you when an update is not yet installed, if it is failing, or when progress is blocked or it takes an excessive time.
Excessive time, means an unusually long time compared to a previous update, also control the logs: dmpdownloader.log, hman.log, distmgr.log, cmupdate.log

If you need the tool, you will find it in the folder cd.latest \ SMSSETUP \ TOOLS on the site server.

Table of contents

Prerequisites

The account that you use to run the tool requires the following permissions:

  • Authorizations in Litterature et Writing for the central administration site site database and for each primary site in the hierarchy. The tool does not interact with secondary sites.
  • Local Administrator on the top-level site of the hierarchy.
  • Local Administrator on the computer hosting the service connection point.

You must have the GUID of the update package to be reset. To get the GUID:

  1. In the console, go to Administration > Updates and maintenance.
  2. In the pane that appears, right-click the header of one of the columns (such as Condition : Good) and select Package GUID to add this column to the display.
  3. The column now displays the GUID of the update package.

Tool execution

The tool must be run on the top-level site of the hierarchy.

When you run the tool, use command line parameters to specify the following:

  • SQL Server server at the top-level site of the hierarchy.
  • Name of the site database on the top-level site.
  • GUID of the update package to reset.

Depending on the status of the update, the tool identifies the additional servers it needs to access.

If the update package is in a state post download, the tool does not clean the package. You can optionally force the deletion of a successfully downloaded update using the force deletion parameter (see command line parameters later in this topic).

Once the tool runs:

  • If a package was removed, restart the SMS_Executive service at the top-level site. Then check for updates so that you can re-download the package.
  • If a package was not removed, no action is necessary. The update resets and then restarts replication or installation.

Command line parameters:

ParameterDescription
-SMandatory 
Allows you to specify the fully qualified domain name of the SQL Server instance that hosts the site database for the top-level site in your hierarchy.
D -Mandatory 
Specify the database name for the top-level site.
-PMandatory 
Lets you specify the GUID of the update package to reset.
-IOptional 
Identifies the instance of SQL Server that hosts the site database.
-FDELETEOptional 
Enables you to force the removal of a downloaded update package successfully.

Examples:
In a typical scenario, you want to reset an update that has problems downloading. 

SQL Server: srv-sql.domain.com
SCCM site: CM_ABC
Package GUID: CBE93B81-EEF8-4A70-9CD8-5F877FF39ACA
Command to launch: CMUpdateReset.exe -S srv-sql.domain.com -D CM_ABC -P CBE93B81-EEF8-4A70-9CD8-5F877FF39ACA

In a more extreme scenario, you want to force the removal of the problematic update package.
CMUpdateReset.exe -FDELETE -S
srv-sql.domain.com -D CM_ABC -P CBE93B81-EEF8-4A70-9CD8-5F877FF39ACA

Source: Microsoft.com


Share

Steven Bart

Founder of StevenBart.com - Vevey, Switzerland. I have been in IT since 2001, I work as a Workplace Architect and mainly deal with the administration of MEMCM (SCCM), the mass deployment of workstations and applications. Learn more about me.

    Leave a comment

    Your email address will not be published. Required fields are marked with *