Changes in the installed status of available updates that are reported by the SMS 2003 Inventory Tool for Hardware Update are not reported in status messages (886658)


The information in this article applies to:

  • Microsoft Systems Management Server 2003 SP1

SYMPTOMS

When you use the Microsoft Systems Management Server (SMS) 2003 Inventory Tool for Hardware Update, some status messages for the updates are not reported to the SMS site server. You might experience this symptom if an update's installation status changes. For example, the symptom may occur when the installation status changes from "Installed" to "Applicable" or from "Applicable" to "Installed."

CAUSE

This problem occurs because the status messages contain extended properties that are not in the SMS_UnknownStatusMessage class. The updates scan tool uses the SMS_UnknownStatusMessage class. The SMS_UnknownStatusMessage class does not contain two new attributes that are reported for hardware updates. The two new attributes are UpdateID and ProductID. When a status message is generated that contains attributes that are not in the SMS_UnknownStatusMessage class, SMS does not deliver the status message.

RESOLUTION

Service pack information

To resolve this problem, obtain the latest service pack for Systems Management Server 2003. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

885643 How To obtain the latest Systems Management Server 2003 service pack

Hotfix information

A supported hotfix is now available from Microsoft. This hotfix is included with the SMS 2003 Inventory Tool for Hardware Update. For more information about the SMS 2003 Inventory Tool for Hardware Update, visit the following Microsoft Web site:

http://go.microsoft.com/fwlink/?linkid=36605&clcid=0x409

Notes
  • You do not have to install the SMS 2003 Inventory Tool for Hardware Update to obtain this hotfix. However, you must extract the files to extract this hotfix. After you extract the files, this hotfix is located in the SMSITDU2003_ENU\HOTFIXES\KB886658 folder.
  • We recommend that you apply the following SMS 2003 Advanced Client update to all SMS 2003 Advanced Clients in your hierarchy:

    Sms2003ac-sp1-kb886658-x86-enu.msp

Prerequisites

You must be running SMS 2003 Service Pack 1 (SP1) to apply this hotfix.

Restart requirement

You do not have to restart your computer after you apply this hotfix.

Hotfix replacement information

This hotfix does not replace any other hotfixes.

File information

The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time tool in Control Panel.
   Date         Time   Version              Size  File name
   -------------------------------------------------------------------------------
   18-Jan-2005  22:23  2.50.3174.1119  5,239,016  Sms2003-sp1-kb886658-x86-enu.exe
After the hotfix is installed, the following files will have the listed attributes or later versions:
   Date         Time   Version              Size  File name
   ---------------------------------------------------------------------------------
   20-Oct-2004  11:30                  6,725,120  Mp.msi
   20-Oct-2004  11:30                    257,536  Sms2003ac-sp1-kb886658-x86-enu.msp
   20-Oct-2004  11:30  2.50.3174.1119     44,032  Smscore.dll      
   20-Oct-2004  11:30                     15,604  Smseventclasses.mof
Because of new architecture in SMS 2003, you must create a new package and a new program to advertise this hotfix to Advanced Client computers. We recommend that you let the software installation wizard automatically perform these tasks. However, you must create a distribution collection and the advertisement to update the SMS 2003 Advanced Client computers. The "Hotfix installation information" section describes how to create the collection and the advertisement.

If you try to run the self-extracting Sms2003-sp1-kb886658-x86-enu.exe executable on an SMS 2003 Advanced Client computer that is not also your SMS 2003 site server, you will receive the following error message:
This hotfix does not apply to this Systems Management role.
Additionally, the KB886658.log file may contain the following information: 

Update.exe extended error code = 0xf0e5 Update.exe return code was masked to 0x643 for MSI custom action compliance.

This Advanced Client hotfix is language specific. For example, the .msp file in the German hotfix must be applied to clients that are running the German version of the SMS 2003 Advanced Client. If your SMS hierarchy contains multiple languages, you must modify the query statement that is described in the "Hotfix installation information" section to install the hotfix on the correct computers. For example, assume that all your German SMS 2003 Advanced Client computers belong to an SMS site that has a site code of DEU. In this case, modify the query on the German SMS primary site to install the hotfix only on German clients that are assigned to the DEU site. You must modify the query at each SMS site in your hierarchy to make sure that the correct language version is installed.

If you do not have a multi-language SMS hierarchy, you can create the package, the program, the collection, and the advertisement on the central SMS site in your hierarchy. We recommend that you let the update installation wizard automatically perform these tasks.

Hotfix installation information

To install this hotfix, follow these steps: Task 1: Download and extract the hotfix file
  1. Download and run the SMS2003ITDU_ENU compressed tool file. Specify a folder to extract the files, click Unzip, and then click Close.
  2. In the folder where you extracted the files, open the Hotfixes\KB886658\xxx folder. xxx is the language of your SMS site server.
  3. Copy the SMS2003-SP1-KB886658-X86-xxx.exe file to a folder on your SMS primary site server.
Task 2: Create the Advanced Client collection
  1. On the SMS primary site server, click Start, point to All Programs, point to Systems Management Server, and then click SMS Administrator Console.
  2. Double-click Site Database.
  3. Right-click Collections, point to New, and then click Collection.
  4. In the Collection Properties dialog box, type Advanced Clients for 886658 in the Name text box.
  5. Click the Membership Rules tab, and then click the yellow button to open the Query Rule Properties dialog box.
  6. Type a name for the query, and then click Edit Query Statement.
  7. On the General tab, click Show Query Language.
  8. Paste or type the following query in the Query statement area:
    select * from SMS_R_System inner join SMS_G_System_SMS_ADVANCED_CLIENT_STATE on  
SMS_G_System_SMS_ADVANCED_CLIENT_STATE.ResourceID = SMS_R_System.ResourceId where  
SMS_R_System.ClientType = 1 and SMS_G_System_SMS_ADVANCED_CLIENT_STATE.Name =  
"SmsCommon" and SMS_G_System_SMS_ADVANCED_CLIENT_STATE.Version < "2.50.3174.1119"
    Note To use this query to create the database classes, you must have at least one Advanced Client computer in your inventory. This query identifies Advanced Client computers that do not have this hotfix installed. Additionally, the query identifies management points that have the Advanced Client installed.
  9. Click OK three times.
Task 3: Install the hotfix
  1. On the SMS site server computer, double-click the SMS2003-SP1-KB 886658-X86-xxx.exe file to start the installation wizard.
  2. Follow the steps in the installation wizard. After the installation files are copied, click Yes, I want to create a package and program now, and then click Next.
  3. Click Next to accept the default package name and the default program name.
  4. Click Next to accept the default package source location.
  5. Click Next on the Details page, and then click Finish. The KB886658 - Advanced Client Hotfix - ENU package and the KB886658 - Advanced Client Patch Install program are added in the SMS Administrator console.

    Note The wizard will prompt you to perform a site reset. The site reset updates the files on the management points. We recommend that you let the hotfix Setup wizard perform the site reset for you. However, if you choose No at the prompt, you must reset your SMS site later to update the management points. To manually reset an SMS site, follow these steps:
    1. Click Start, point to All Programs, point to Systems Management Server, and then click SMS Setup.
    2. Click Next two times.
    3. Click Modify or reset the current installation, and then click Next four times.
    4. Click Finish to reset the site.
Task 4: Distribute the hotfix to the Advanced Client computers
  1. In the SMS Administrator console, double-click Packages.
  2. Right-click the KB 886658 - Advanced Client Hotfix package, point to All Tasks, and then click Distribute Software.
  3. On the Welcome to the Distribute Package Wizard page, click Next.
  4. Click the check box next to the distribution points that you want to use, and then click Next three times.
  5. On the Advertisement Target page, click Advertise this program to an existing collection, and then click Browse.
  6. On the Browse Collection page, click Advanced Clients for 886658, and then click OK.
  7. Click Next two times.
  8. On the Advertise to Subcollections page, click Advertise the program only to members of the specified collection.
  9. Click Next three times, and then click Finish to complete the Distribute Package Wizard.
To perform a silent installation of this hotfix, follow these steps:
  1. Click Start, click Run, type cmd, and then click OK.
  2. At the command prompt, change to the folder that contains the SMS2003-SP1-KB 886658-X86-xxx.exe file, where xxx is the language of your SMS site server.
  3. At the command prompt, type SMS2003-SP1-KB 886658-X86-xxx.exe /s, and then press ENTER.

How to remove this hotfix

You can remove this hotfix if all the following conditions are true:
  • The computer has Windows Installer version 3.0 or a later version installed.
  • The client computer has SMS Advanced Client update 885266 installed. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

    885266 A registry entry remains on a Systems Management Server 2003 Advanced Client computer after you remove a software update that was built by using the Windows Installer version 3.0 SDK

  • The management point computer has rollback hotfix 885438 installed. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

    885438 An SMS 2003 management point is not rolled back to a previous state after you remove a management point hotfix

To remove the hotfix from the SMS site server, follow these steps:
  1. Click Start, point to Control Panel, and then click Add or Remove Programs.
  2. Click Hotfix for Systems Management Server 2003 (KB886658), and then click Remove.
  3. Perform an SMS site reset to roll back the management point to the earlier version. If you let the hotfix installation wizard perform the SMS site reset during hotfix installation, an SMS site reset automatically occurs after you remove the hotfix. If you manually reset an SMS site after the hotfix installation, you must manually reset the site after you remove the hotfix. To manually reset an SMS site, follow these steps:
    1. Click Start, point to All Programs, point to Systems Management Server, and then click SMS Setup.
    2. Click Next two times.
    3. Click Modify or reset the current installation, and then click Next four times.
    4. Click Finish to reset the site.
Note When you remove the hotfix, the package and the program that was created by the hotfix Setup wizard are not automatically removed.

To remove the hotfix from an SMS Advanced Client computer, follow these steps:
  1. Click Start, click Run, type cmd, and then click OK.
  2. At the command prompt, type the following command, and then press ENTER:
    msiexec /package ProductCode /uninstall PatchGUID /REINSTALL=All /REINSTALLMODE=maus
    Note ProductCode is the GUID of the SMS Advanced Client software that is installed on the client computer. PatchGUID is the GUID for this specific SMS Advanced Client hotfix. The PatchGUID for this hotfix is {EC7FD355-C42B-40A5-B4ED-98413BE88341}.
To verify the product code for the version of the SMS 2003 Advanced Client that is installed, follow these steps:
  1. On the SMS 2003 Advanced Client computer, copy the following text to a new Notepad document:
    On Error Resume Next
Dim installer : Set installer = Nothing
Set installer = Wscript.CreateObject("WindowsInstaller.Installer") : CheckError
Dim productName:productName = "SMS Advanced Client"
Dim productCode, property, value, message
For Each productCode In installer.Products : CheckError
If LCase(installer.ProductInfo(productCode, "ProductName")) = LCase(productName)
Then Exit For Next
If IsEmpty(productCode) Then Wscript.Echo "Product is not registered: " & productName : Wscript.Quit 2
WScript.Echo "ProductCode = " & productCode
  2. In Notepad, click File, click Save As, and then in the Save As dialog box, type GetACProdCode.vbs as the file name. Note the folder where you save the file.
  3. Click Start, click Run, type cmd, and then click OK.
  4. Move to the folder where you saved the GetACProdCode.vbs file.
  5. Type Cscript GetACProdCode.vbs, and then press ENTER.
Note You can also use the /quiet or /passive Windows Installer command-line options for automated deployments. For example, you can use these options when you run SMS software distribution or SMS logon scripts.

WORKAROUND

To work around this problem, wait for the next Hardware Inventory (HINV) cycle to occur. Any state changes are collected and reported by the HINV agent. To force a full hardware inventory cycle, follow these steps on the SMS client computer:
  1. Click Start, point to Settings, and then click Control Panel.
  2. Double-click the Systems Management icon.

    Note If you cannot see the System Management icon, and you are using Microsoft Windows XP, click Switch to Classic View in the left pane of Control Panel.
  3. Click the Components tab, and then click Hardware Inventory Agent.
  4. Click Start Component to force a hardware inventory cycle.

STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section. This problem was first corrected in Systems Management Server 2003 Service Pack 2.

MORE INFORMATION

This hotfix updates the management point and the Advanced Client computers. You must update both system roles. You can update the management point by performing an SMS site reset, or you can remove and then reinstall the management point. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

828366 How to use the site reset functionality in Systems Management Server 2003

If you apply the SMS 2003 Advanced Client part of this hotfix to client computers, but you do not update the management point, the management point will discard the UpdateID and ProductID attributes from the status messages that are received from updated Advanced Client computers. This causes the SMS site server to insert an additional instance of the update in the SMS database without the UpdateID and the ProductID attributes for the same update. The Hardware Update scan tool uses the ProductID and UpdateID attributes to scan for the existence of an update. If you do not install the Advanced Client hotfix, the Advanced Client computers do not generate status messages that represent a change in update's installation status. For more information about the available standard Windows Installer command-line options, visit the following Microsoft Web site:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/standard_installer_command_line_options.asp

For more information, click the following article number to view the article in the Microsoft Knowledge Base:

824684 Description of the standard terminology that is used to describe Microsoft software updates

The third-party products that this article discusses are manufactured by companies that are independent of Microsoft. Microsoft makes no warranty, implied or otherwise, regarding the performance or reliability of these products.
Modification Type:MajorLast Reviewed:3/7/2006
Keywords:kbSMSMP kbSMSInventory kbSMSDistribution kbSMSDeploy kbSMSClients kbSMS2003bug kbQFE kbClient kbPerformance kbInventory kbinterop kbSoftwareDist kbfix KB886658 kbAudITPRO
©2004 Microsoft Corporation. All rights reserved.