Log Files

Published : June 8, 2005

To understand the management processes, you need to know which sub-processes are part of it and which SMS server and client components participate in it. There are several different log files that provide analysis on the health and functionality of the management point. Table 6 lists the log files and describes their roles.

Table 6   Participating Components Specific to Management Point Setup

Log File Name	Component	Role
MPcontrol.log	Mpcontrol.dll	Records the registration of the management point with WINS. Records the availability of the management point every 10 minutes. IIS issues can occur if the management point is unavailable. Review this log for other IIS communication problems and WINS registration problems.
Mpsetup.log	MPSetup.exe	Records the management point installation wrapper process.  MPSetup.exe is used when you cannot run MP.msi or when management point installation is not completed. Ensure that MP.msi was started.
MPMSI.log	MP.msi	Management point .msi installation log.  Records management point installation errors. You can search this log file for “return value 3” to find errors.
MPfdm.log	Management Point File Dispatch Manager	Moves client files to the corresponding SMS\INBOXES folder.  Review the log when validating problems with file permissions.

For a complete list of all SMS 2003 logs and the processes they monitor, see article 867490 in the Microsoft Knowledge Base at https://go.microsoft.com/fwlink/?LinkId=47289.

The log files listed in Table 7 can be used to identify communication problems between Advanced Clients and the management point or between the management point and the site server.

Table 7   Participating Components Specific to Management Point Operation

Log File Name	Component	Role
MPFDM.log	Management Point File Dispatch Manager	Management point component that moves client files to the corresponding SMS\INBOXES folder.
MPControl.log	Management Point Control Manager	Management point component that registers the management point with WINS. Checks the availability of the management point every 10 minutes. IIS issues can occur if the management point is unavailable. Review this log for other IIS communication issues and WINS registration issues.
MP_Ddr.log	Management Point Discovery Data Manager	Converts XML DDR records received from clients and copies them to the site server. Problems with file corruption or access to the SMS\MP\OUTBOXES\DDR.BOX folder are noted in this log file.
MP_GetAuth.log	MP_GetAuth_ISAPI	Monitors the site management points.  This log file will log IIS access errors specific to management point authorization.
MP_GetPolicy.log	MP_GetPolicy_ISAPI	Retrieves policy information that can help diagnose problems accessing WMI.
MP_Hinv.log	Management Point Hardware Inventory Manager	Converts XML hardware inventory records from clients and copies them to the site server; useful for assessing file corruption or problems accessing the SMS\MP\OUTBOXES\HINV.BOX folder.
MP_Location.log	Management Point Location Manager	Location manager, useful for assessing problems accessing IIS and WMI.
MP_Policy.log	Management Point Policy Manager	Maintains policy communication.  Details problems accessing SQL Server.
MP_Relay.log	Management Point Relay Manager	Copies files that are collected from the client.  File corruption issues are noted in the file.
MP_Retry.log	Management Point Retry Manager	Manages hardware inventory retry process queue; useful for validating corrupt hardware inventory files.
MP_Sinv.log	Management Point Software Inventory Manager	Converts XML hardware inventory records from clients and copies them to the site server; may see file corruption or problems accessing the SMS\MP\OUTBOXES\SINV.BOX folder. Make sure software inventory data is converted from XML to SIC or SID file format.
MP_Status.log	Management Point Status Manager	Converts XML .svf status message files from clients and copies them to the site server; useful for evaluating file corruption or problems accessing the SMS\MP\OUTBOXES\STAT.BOX folder.

On This Page

Debug Logging
Management Point Setup Logging

Debug Logging

When you troubleshoot issues with Advanced Clients or management points, you can turn on debug logging on the computer where the issue occurs. As a result, the actions of Ccmexec.exe are logged. Debug logging works similarly on both Advanced Clients and management points because they use the same Ccmexec framework and process name.

  WARNING
If you use Registry Editor incorrectly, you might cause serious problems that could require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly.

To turn on the DebugLogging key on the SMS 2003 Advanced Client or management point

1. Click Start, point to Programs, point to Administrative Tools, and click Services.

2. Right-click the SMS Agent Host service, and click Stop.

3. Click Start, click Run, type regedit, and click OK.

4. In Registry Editor, add the following key:

   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

5. Restart the SMS Agent Host service.

  Note
Enable the DebugLogging key for debugging purposes only. Turn it off when the issue is resolved.

For more information about debug logging, see article 833417 in the Microsoft Knowledge Base at https://go.microsoft.com/fwlink/?LinkId=46661.

Management Point Setup Logging

MPSetup.exe manages the installation process of the management point. The management point setup script is a Windows Installer Script (.MSI) file. Mpsetup.exe does the following:

• Validates that prerequisites are met.

• Validates management point status for the site.

MPsetup.exe then starts MP.msi, which writes logging information to MPMSI.log.  MPMSI tracks the entire operation of the installer script. Reviewing the MPMSI.log file can be troublesome because MSI logging is verbose, and using SMS Trace highlights log conditions that are not always errors. The MSI operation lists all dialog entries, and potential error conditions in the MPMSI.log file. When you review a log file, look for RETURN VALUE. If the return value is an error condition, such as return value 3, the line above it should contain a corresponding error code.  Table 8 lists the return values and their descriptions.

Table 8   MP.msi Return Values

Return Value	Description
0	Action not executed
1	Success
2	User cancelled
3	Fatal error
4	Suspended, waiting for reboot