Security Compliance
Patch Manager Logging and Troubleshooting
The first step in Patch Manager troubleshooting is to determine the issue. Having the issue clearly defined allows you to focus on the correct area and the correct logs. Asking the customer questions rather than deciding that "Patch Manager is broken" is the first troubleshooting step.
First published date
Last published date
Overview
Product section
Resolution
Some common questions to ask would be:
- What part of Patch Manager is not working as expected?
- Has this functionality ever worked?
- When did the problem start?
- Has anything changed or is different in the process to how it is usually performed?
- Does to problem happen for all users accounts?
The above questions seem obvious but they make cases easy, if you can define the problem everything else is easier. There are other such questions, feel free to add them to this doc.
Having a clear definition of the problem in this way also insures that the Support system of one issue per case can be well followed from the start.
At this point determine if the issue is with the process being performed, i.e.
- is the user performing the correct actions to achieve their goal
- is the goal achievable
- is the functionality of Patch Manager giving issue
This requires having some knowledge of the product and experience with the functionality. If the issue is insufficient knowledge of the product then remedy by demonstrating and providing documentation on the process, once this is done there is no need for further troubleshooting as the customer's goal will be achieved.
If it is determined there is a flaw in the operation in the deployment then there is an error that must be investigated further.
Based on the problem description you can isolate the problem to a specific part of Patch Manager or a specific process.
A very simple troubleshooting process which resolves many issues is to repeat the steps that error and review the logs of that process for the time you performed the action. Below are details on where Patch Manager logs are located and some of the configuration options available.
Patch Manager log files will open in notepad by default.The logs generally contain:
- The date/time of the creation of the entry
- The Process ID (PID followed by a number)
- The Thread ID (TID followed by a number)
- Usually (not always), the class name (depending on the developer), followed by the method name, & the method
At this point you have should have an error message either through the GUI or in the logs. If there are no errors or events in your logs confirm you have identified the correct issue and the correct logs. Increase the logging level if you are sure you have identified the core issue, not just a symptom of the issue and that you are checking the correct logs.
To increase the log level see the below or use the Patch Manager Log Adjuster. The Log Adjuster is accessibly through the MMC console by selecting "Patch Manager->Patch Manager System Configuration" and in the middle pane select "Log Adjuster"
At this point there should be a clear definition of the problem, an error message and logs of the problem. The next step would be to research the error message, any error in the logs and the process being following.
Logging
- Patch Manager Server + Console
- Enabling:
- Patch Manager\Patch Manager System Configuration\Patch Manger Servers
- Select server, go to Automation Server Settings, select Logging options and select Enabled
- Restart PaM console - logs should now be created under Server and Console folders:
- EminentWare.DataGridService
- EminentWare.WorkerProcess
- EminentWare.UI.Console
- Enabling:
- Orion installation logs
- c:\Documents and Settings\administrator.PACMAN\Local Settings\Temp\1\SWOrionSetup\ on older (win2k3)
- c:\Users\administrator.PACMAN\AppData\Local\Temp\2\SWOrionSetup\ on newer systems
- PaM Installation (Configuration Wizard, Setup Helper, ...) + Orion logs
- Documents and Settings\All Users\Application Data\Solarwinds\ on older (win2k3)
- ProgramData\Solarwinds on newer systems
- WMI providers + Agent
- Enable WMI providers logging - this also works for agent
- run regedit, go to HKEY_LOCAL_MACHINE\SOFTWARE\EminentWare\Logging, add DWORD (key=value):
- Enable=1
- Options=1
- Logging=15 (maximum logging level)
- run regedit, go to HKEY_LOCAL_MACHINE\SOFTWARE\EminentWare\Logging, add DWORD (key=value):
- Enable agent logging through PaM console
- Go to Patch Manager System Configuration\Policy Editor
- Either create new policy and then assign it to desired scope or edit the default policy
- Edit 6 entries:
- Agent Logging
- Logging Enabled=1
- Logging Level=15
- Logging Options=1
- Worker Process
- Logging Enabled=1
- Logging Level=15
- Logging Options=1
- Agent Logging
- Enable WMI providers logging - this also works for agent
- WSUS logs
- Client logs
- c:\Windows\WindowsUpdate.log
- c:\Windows\WindowsUpdate.log
- Server logs
- %ProgramFiles%\Update Services\LogFiles
-
Change.log
Provides information about the WSUS server database information that has changed.
SoftwareDistribution.log
Provides information about the software updates that are synchronized from the configured update source to the WSUS server database.
-
- %ProgramFiles%\Update Services\LogFiles
- Client logs
- SCCM logs
- 2012 - http://www.acupofit.com/2012/05/sccm-2012-log-file-reference.html (content provided by ZeusABJ, available at www.acupofit.com, obtained on April 3, 2019)
- 2007 - http://technet.microsoft.com/en-us/library/bb892800.aspx (© 2019 Microsoft, Inc., available at docs.microsoft.com, obtained on April 3, 2019)
- Agent logs always on Agent nodes
- C:\ProgramData\Solarwinds\Logs\PM
- Collect Patch Manager Web Console Logs
- The log file to check on the Orion Server is Information Service v3
- C:\ProgramData\SolarWinds\InformationService\v3.0
Log Locations
| TITLE | LOCATION | CLIENT / SERVER |
TURN ON WHERE? HOW? | LOGGING LEVEL | CHANGE LOG LEVEL | COMMENTS |
|---|---|---|---|---|---|---|
|
WindowsUpdate.log |
c:\Windows\ Windows 10 and Windows Server 2016: Event Viewer, under Microsoft-Windows-WindowsUpdateClient\Operational | Client,Server (PAS,SAS) | always turn on | How to interpret log messages (© 2019 Microsoft, Inc., available at support.microsoft.com, obtained on April 3, 2019) | ||
|
wmi provider logging | C:\Windows\system32\WBEM\Logs\ | HKLM\SOFTWARE\Microsoft\WBEM\CIMOM\Logging |
1(ERROR) 2(VERBOSE) | |||
| packageboot logging | C:\windows\SoftwareDistribution\Download\Install |
HKLM\SOFTWARE\EMINENTWARE\Logging Enable=1 Options=3 | Level=3 | |||
| WSUS SoftwareDistribution Logs | %ProgramFiles%\Update Services\LogFiles\ | |||||
| SCCM Software Sync Log | ||||||
| WSUS events |
For the server: C:\Program Files\Update Services\ For the client: C:\Windows\SoftwareDistribution\ | Server (PAS,SAS), Client | always turn on | |||
| Logs from upgrade tool from tmp folder | C:\Users\administrator\AppData\Local\Temp\2\ckz_*\ | always turn on | ||||
| EminentWare.DataGridService.exe.log | C:\Program Files\SolarWinds\Patch Manager\Server | Server (PAS) |
HKLM\SOFTWARE\EMINENTWARE\Logging Enable =1 From PaM Console: PaM Console-> System configuration -> Patch manager Servers -> your machine -> midle botom panel-> Automation Server Settings -> Logging -> Enable/Disable |
Level: 1 - Verbose 2 - Normal 4 - Warning 8 - Error 15 - All |
From PaM Console: PaM Console-> System configuration -> Patch manager Servers -> your machine -> midle botom panel-> Automation Server Settings -> Logging level
| |
| EminentWare.WorkerProcess.exe.log | C:\Program Files\SolarWinds\Patch Manager\Server | Server (PAS) | HKLM\SOFTWARE\EMINENTWARE\Logging
Enable =1 From PaM Console: PaM Console-> System configuration -> Patch manager Servers -> your machine -> midle botom panel-> Automation Server Settings -> Logging -> Enable/Disable |
Level: 1 - Verbose 2 - Normal 4 - Warning 8 - Error 15 - All |
From PaM Console: PaM Console-> System configuration -> Patch manager Servers -> your machine -> midle botom panel-> Automation Server Settings -> Logging level | |
| EminentWare.UI.Console.MMC.dll.log | C:\Program Files\SolarWinds\Patch Manager\Console | Server (PAS,SAS) | HKLM\SOFTWARE\EMINENTWARE\Logging
Enable =1 From PaM Console: PaM Console-> System configuration -> Patch manager Servers -> your machine -> midle botom panel-> Automation Server Settings -> Logging -> Enable/Disable |
Level: 1 - Verbose 2 - Normal 4 - Warning 8 - Error 15 - All |
From PaM Console: PaM Console-> System configuration -> Patch manager Servers -> your machine -> midle botom panel-> Automation Server Settings -> Logging level | |
| msi logs | %temp% |
HKLM\SOFTWARE\Policies\Microsoft\Windows\Installer Logging = voicewarmupx Debug = dword:00000007 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Trace From PaM Console: PaM Console-> System configuration -> Patch manager Servers -> your machine -> right click -> Check and Manage Computer Connectivity -> Enable MSI logging | ||||
| PatchManagerConfigurationWizard.log | C:\ProgramData\Solarwinds\PM\Log | Server (PAS,SAS) | always turn on | |||
| ConfigurationHelper.log | C:\ProgramData\Solarwinds\PM\Log | Server (PAS,SAS) | always turn on | |||
| ProcessStartWrapper.log | C:\ProgramData\Solarwinds\PM\Log | Server (PAS,SAS) | always turn on | |||
| TaskManagement.log | C:\ProgramData\Solarwinds\PM\Log | Server (PAS,SAS) | always turn on | |||
|
Agent Service log EminentWare.Agent.Service.exe.1576606937.13076.0001.log.txt and worker logs | C:\ProgramData\Solarwinds\Logs\PM | Agent Clients | Always on |
Default logging looks to be verbose [VERB] |
Disclaimer: Please note, any content posted herein is provided as a suggestion or recommendation to you for your internal use. This is not part of the SolarWinds software or documentation that you purchased from SolarWinds, and the information set forth herein may come from third parties. Your organization should internally review and assess to what extent, if any, such custom scripts or recommendations will be incorporated into your environment. You elect to use third party content at your own risk, and you will be solely responsible for the incorporation of the same, if any.