Upgrade History
The Agent Upgrade History page provides detailed information on the Centralized Agent Upgrade (CAU). For more information, see CAU - Upgrade Process.
This page includes the following:
Overview
The Agent 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, can be configured in the Custom Upgrade Text field when you select the target version.
-
Status: Status of the run - or 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: (only filled, if child is displayed) Shows the CAU run which is parent of an individual Agent deployment.
-
Users: User name of the User executing the CAU.
-
Agent Name: (only filled, if child is displayed) Agent name of the individual Agent being upgraded.
-
Target Version: New version to which the Agent is upgraded.
-
Start and End Time: Start and end time of the run or the individual Agent upgrade.
-
Runtime: The duration of the upgrade.
For more information, see Main Page Tables.
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
-
Choose one of the options listed above.
-
Do one of the following:
-
Activate From/To and select the time frame:
-
Either type the date and time or click the icon to open the calendar view
-
Use the arrows at the top of the calendar view to select the month.
-
Click on the date.
-
Use the spin buttons at the bottom of the calendar view to specify a time.
-
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.
-
-
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.
See also: