Upgrade Progress

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Upgrade Progress

    Upgrade Progress provides a real-time view of the stages and status during a ServiceNow instance upgrade, helping you monitor where the upgrade currently stands. It displays progress bars and detailed information about each stage throughout the upgrade process.

    Show full answer Show less

    This feature is especially useful for tracking upgrades with visibility into platform, schema, plugin loading, and completion stages. Additionally, if you have the ATF Test Generator and Cloud Runner store applications installed, you can schedule automated test generation runs directly from the Upgrade Monitor page to ensure upgrade quality.

    Key Features

    • Progress Visualization: A progress bar shows the overall upgrade progress across key stages such as Upgrading Platform, Updating Schema, Loading Plugins, and Completing the upgrade.
    • Stage Details: Each stage provides contextual information, including current activities, progress bars for individual tasks, and specific files being updated.
    • Node Status Monitoring: Icons represent the status of each node (Pending, Running, Successful, Failed, or Down), with the ability to select nodes and view detailed runtime information.
    • Node Metrics: Displays running time, current build version, and uptime or downtime duration for the selected node, helping identify any node-specific issues during upgrade.
    • Integration with ATF Test Generator and Cloud Runner: Enables scheduling of test runs from the Upgrade Monitor page if these applications are installed and the SNATFTG plugin is active.

    Practical Benefits for ServiceNow Customers

    • Provides transparency and confidence in the upgrade process by showing detailed progress and status updates.
    • Helps quickly identify and troubleshoot node-specific upgrade issues using visual status indicators and detailed metrics.
    • Allows integration with automated testing tools to validate the upgrade, reducing risk and downtime.
    • Ensures you know exactly which stage the upgrade is currently in, facilitating better planning and communication during upgrades.

    When an upgrade is underway, Upgrade Progress displays progress bars and other information to help you monitor the process.

    You can view the status of each of the stages during an upgrade process. It helps you to know exactly which stage you are in at any point of the upgrade process.

    Image showing ATF store app advertisement banner

    If you have the ATF Test Generator and Cloud Runner store application installed, you can schedule test generation runs from the Upgrade Monitor page. The above message shows up during an upgrade process when the following conditions are met.
    • The SN_ATF_TG plugin is not active.
    • The instance is not a fed instance.
    • The instance is not a self-hosted instance.
    Note:
    You can now confidently upgrade your instance by using the ATF Test Generator and Cloud Runner store app. See Exploring ATF Test Generator and Cloud Runner for more information.
    Once the database upgrade starts, the following details show up. Image showing the status of an in-progress upgrade
    Table 1. Upgrade Progress details
    Field Input Value
    Current version Current version of the instance
    Target version Target upgrade version of the instance
    Upgrade Progress A progress bar depicting where the upgrade is in the overall process. The length of a section in the bar does not indicate the relative duration of that process.
    Upgrade Progress: Upgrading Platform The system is applying upgrades to elements that form the foundation of the platform.
    Upgrade Progress: Updating Schema The system is scanning the plugins to create a list of tables that require upgrading. This prevents the system from upgrading the same table multiple times.
    Upgrade Progress: Loading Plugins The system is loading both core and optional plugins. Some features require more than one plugin, so the number of plugins listed may not match the number of optional features installed.
    Upgrade Progress: Completing The system is upgrading components that need to be completed after the previous three stages are done.
    Details Shows the current activity, a progress bar for the current activity, and the file currently being updated.
    Node Upgrades The color of the icons represents the status of each node during this upgrade: Pending, Running, Successful, Failed, or Down.
    Node The selected node indicated by the arrow. To change the selection, position the mouse cursor over the icon for the node to select.
    Running time How long the selected node (indicated by the arrow) has been running. If the selected node is offline, this value stops updating and shows how long a node was online before going offline.
    Version The current build for the selected node (indicated by the arrow).
    Successful upgrade When the selected node is online, shows how long the node has been online. If the selected node is offline, shows how long the node has been offline.