Deployment History

Deployment History provides a way to view the status of recent deployment operations to your devices. One of the biggest benefits of Deployment History is that it allows you to zero in on exceptions that may have occurred during patch deployments and quickly troubleshoot any issues. This is extremely important, as it enables you to quickly identify potential problems before they become major issues in your environment.

Deployment History is accessed from the main menu by selecting Patch Management > Deployment History.

Charts

The charts enable you to quickly assess the status of your deployment history. Click expand chart icon to expand the chart to full screen. Click chart options icon then click Export PNG to save the chart as an image. You can change the period that the charts and table represent using the Date range.

You can click on any of the individual parts of a chart to filter the information in the table. This filters the table to show only the deployments you are most concerned about.

  • Patch deployments over time: Shows how deployments have succeeded and failed over the selected time period.
  • Top 10 failures: Lists the top causes of deployment failures.

Under the charts are a set of tiles that show the number of Failed patches, In progress patches, and Successful patches for the selected time period. Click the tile to filter the information in the table accordingly.

Device Summary

The table contains a list of all patches that have been deployed by the Ivanti Neurons Cloud or by an on-premise solution in the selected Date range. Information within the table is kept for six months before being automatically deleted. For this reason, clicking Clear filters resets the filter to Date range: Last 6 months.

The Column Chooser icon Column set button (located just to the left of the Search field) enables you to specify which of the following columns appear in the table:

  • Id and Advisory name: The id and name of the advisory. You can click the Id or advisory name to view the patch details page in Patch Intelligence.
  • Patch name: The name of the patch deployed to the device. You can click the patch name to view the patch information page in Patch Intelligence.
  • Platform: The type of operating system used on the device. Supported operating systems are Windows, macOS, and Linux.
  • Device name: The name of the device. You can click the name to view the Device Details page.
  • Policy: The agent policy to which the device is currently assigned. You can click the name to view the policy configuration.
  • Status: Shows the last reported state of the deployment, which you can use to identify problems and take prioritized action. Values worth particular note are:
    • Pending Reboot: The patch has been deployed, but a reboot of the device is still needed to complete the operation. The vulnerability remains until the device has rebooted.
    • Retries Exhausted: The system has tried unsuccessfully to download or deploy the patch to the device until the retry limit was reached. Use the Patch result value to investigate the reason for the failure, and when you have addressed this issue, reset the retry count on the device so that the patch can be tried again during the next scheduled deployment. To reset the retry count, click the entry in the Device name column, then click Reset retry counts on the Patches tab of the Device window. For more information about the Device window, see Patches.
  • Patch result: Provides additional context to the deployment status. You can click on a code value to learn more about the code. Common return codes include:
    • File Not Found: The system cannot find the specified file.
    • Install Failure: Fatal error during installation.
    • Install Language Unsupported: The language of the installation package is not supported by your system.
    • Open Failed: The system cannot open the device or specified file.
    • Patch Target Not Found: The upgrade cannot be installed by the Windows Installer service because the program to be upgraded may be missing, or the upgrade may update a different version of the program. Verify that the program to be upgraded exists on your computer and that you have the correct upgrade.
    • Success, Reboot Required: The requested operation is successful. Changes will not be effective until the system is rebooted.
  • Deployment date: The date and time the patch deployment began on the device.
  • Elapsed time: The time it took for the patch to be deployed to the device.
  • KB number: The knowledge base number. You can click the number to view the patch details page in Patch Intelligence.
  • Patch release date: The date the patch was released.
  • Deployment configuration: The patch configuration that was assigned when deployment happened. You can click the name to view the Patch configuration page.

Filter, Sort, Search and Export

Toggles on and off the Smart Filters area directly above the table. Enables you to see the filters that are currently applied to the table.

Information displayed within the table can be easily filtered to narrow the focus to only those deployment entries of interest. One way to do this is by using the Smart Filter. The Smart Filter contains several default filters. You can also define your own custom filters.

Default Filters

The Smart Filter contains several default filters. Default filters cannot be modified or deleted. The default filters include the following:

  • In Progress More Than 1 Day: Only those patches whose deployments were started more than one day ago are displayed.

Custom Filters

You can create your own custom filters. This is a powerful tool that enables you to specify exactly which entries you want displayed. Each custom filter is comprised of one or more rules. You can define as many rules in a filter as needed.

To create a new filter:

  1. Click Filters.
    The Smart Filter definition area is displayed above the table.
  2. Filter the table to a defined set of devices.
    Do this using the column filters and any existing Smart Filters.
  3. Select Smart filters > Add new smart filter from current.
    The new filter is created based on the filtering criteria used in the current table.
  4. Type a descriptive name for the filter.
  5. Click Add filter.

To delete a smart filter select Smart filters, from the drop-down menu select Delete existing smart filter, from the list select the filter you want to delete. On the confirmation dialog select Delete to remove the filter from the saved list.

Select the sort iconup arrow and down arrow to indicate the sort optionin any column header to sort into ascending (Ascending icon) or descending (Descending icon) order. To remove the sorting, right-click the column header and select Clear Sorting from the context menu.

Enter a keyword into the Search field to only show patches that contain the keyword. The keyword is matched to any case-insensitive text found from within all of the patches, for example; CVE numbers, patch names, blue screen, and so on.

Example search use cases:

  • As a security engineer, I want to supply a CVE to understand what patch I need to have my IT Ops team apply to mitigate the vulnerability. The searching functionality can be an asset to both the Security and Ops teams by allowing them to search for CVEs and see which patches are required.
  • As a support technician, I want to know whether a patch is available to fix an issue with PST corruption in Outlook 2016 occurring in conjunction with error 0x80040119. The ability to search benefits the support staff who can search for symptoms or issues around a particular patch.

To remove a search filter, click the clear filters iconfunnel with a cross to indicate clear any applied filters.

Enables you to export the contents of the table to a CSV file. You can choose to export all items in the table or just selected items.

The CSV file is created using ISO standards and is stored in your local Downloads folder. If you use Excel to view the file, the data can be converted to the locale of the device so that it can be viewed in a more human-readable format.

Any sorting or filtering applied to the patches will be retained in the exported output. All columns will be included regardless of what has been selected in the Column Chooser.

Select the first column check box for the patches you want to export. Alternatively, select the check box in the header cell to select all patches.

Click Export to create the CSV file.

Related topics

Patch Management Overview

Endpoint Vulnerability

Patch Intelligence

Patch Settings