Upgrade History

The Upgrade History page provides detailed information on the Centralized Agent Upgrade (CAU). For more information, see CAU - Upgrade Procedure.

Overview

The Upgrade History page provides detailed information on the Centralized Agent Upgrade (CAU) upon starting the process. It lists the agents that are currently being upgraded and those that have already been upgraded. The page allows you to see details of the upgrade processes and to open reports created for each process, where you can check the version from which and the version to which has been upgraded.

By default, only the Centralized Agent Upgrade (CAU) executions of the last 12 hours are displayed. You can change this default period using the DEFAULT_TASKLIST_TIMESPAN parameter in the UC_SYSTEM_SETTINGS variable. For more information, see DEFAULT_TASKLIST_TIMESPAN.

Also, you can get older executions regardless of the definition of the DEFAULT_TASKLIST_TIMESPAN parameter by setting the relevant time frame in the filter options. For more information, see Filtering the Contents of the List.

Upgrade History List

The following columns are displayed by default:

• Name

  Name of the CAU run, which can be configured in the Custom Upgrade Text field when you select the target version

• Status

  Status of the run or of the child, which would be an agent or agents individual deployment depending on the selection you made when choosing the agents to be upgraded

• RunID

  RunID of the CAU run or the individual agent deployment

• Parent

  CAU run which is parent of an individual agent deployment

  Note: This column is only populated if child is displayed.

• Users

  User name of the user executing the CAU

• Agent

  Name of the individual agent being upgraded

  Note: This column is only populated if child is displayed.

• Target Version

  New version to be upgraded to

• Start Time

  Start time of the run or the individual agent upgrade

• End Time

  End time of the run or the individual agent upgrade

• Runtime

  Duration of the upgrade run

For more information, see Showing and Hiding Columns.

Customizing the List

Use the buttons on the toolbar to customize the list view. The options available are the following:

• Display the upgrade processes in a flat list view.
• Display the upgrade processes in a hierarchical list (parent/child). The parent is the CAU run, its children the agents affected by the upgrade.
• Open the filter pane on the right hand side, where you can define criteria to restrict the content of the list.

Filtering the Contents of the List

The filter pane allows you to restrict the number of records displayed on the main page using parameters defined in the CAU. You can combine the filter criteria available.

Note: Consider that the filter behaves differently depending on the view you have selected:

• With the hierarchical view, the filter settings apply only to parent tasks.

• With the list view, the filter settings apply to both parent and child tasks.

The following filter options are available:

• Name

  Enter the name of the CAU run to search for a particular upgrade run.

• Agent Name

  Enter the Agent name to search for information on the upgrade of a particular Agent.

• Status

  Activate the checkbox of the status you are interested in. You can select one or more status.

• Time Frame

  Use this option to find upgrades that have been processed within the period of time specified.

  Possible options:

  • No Time Frame (Default)

    Leave it if you do not want to set a time restriction to your filter

  • All Tasks in Time Frame

    Displays all the tasks which execution starts, ends or runs within the time frame you are about to define

  • Task Activation

    Displays all the tasks that were activated within the time frame you are about to define

  • Task Start

    Displays all the tasks that started within the time frame you are about to define

  • Task End

    Displays all the tasks that ended within the time frame you are about to define

  To Filter by Time Frame

  1. Choose one of the options listed above.

  2. Do one of the following:

     • Activate From/To and select the time frame:

       1. Either type the date and time or click the icon to open the calendar view

       2. Use the arrows at the top of the calendar view to select the month.

       3. Click on the date.

       4. Use the spin buttons at the bottom of the calendar view to specify a time.

       5. Do the same to define the end of the time frame.

     • Activate Last and specify the point in time on which the time frame begins. The end is always today if you select this option.

  3. Click the Filter button at the bottom of the pane.

• Target Version

  Search for a target version of an upgrade to filter by runs or agents affected by that upgrade

• User

  Search for upgrade runs or agents initiated by certain users, either with full or partial user names. You can also:

  • Select Exclude to filter by user names that do not contain the search term.
  • Select Current User to show upgrades that have been initiated with the user credentials of the current user.

• RunID

  Search for the Run ID of a certain upgrade run

• Parent

  Search for the ID of the parent. Usually, the parent is the run and the child/children are the agent or agents

Exporting to CSV

For more information, see Exporting Tables to CSV.

Opening the Reports

Right-click a CAU run or an agent and select Open Report.

Note: This option is not available for entries with status Waiting for Host or Skipped Manually.