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 in ServiceNow provides a detailed view of the stages and status during an instance upgrade, helping customers monitor and understand exactly where the upgrade process stands at any given time.

    Show full answer Show less

    Key Features

    • Stage Monitoring: Visual progress bars and status indicators show each major phase of the upgrade: Upgrading Platform, Updating Schema, Loading Plugins, and Completing.
    • Detailed Activity Tracking: Displays the current activity, a progress bar for that activity, and the file currently being updated to give insight into ongoing upgrade operations.
    • Node Status Indicators: Node icons use color coding to represent statuses such as Pending, Running, Successful, Failed, or Down. Users can select nodes to view specific details including running time, version, and online/offline duration.
    • Integration with ATF Test Generator and Cloud Runner: If these store applications are installed, users can schedule automated test generation runs directly from the Upgrade Monitor page, enhancing confidence in upgrade reliability.

    Practical Use for ServiceNow Customers

    Customers can leverage Upgrade Progress to gain real-time visibility into the upgrade lifecycle, identify any bottlenecks or issues by monitoring node statuses, and coordinate testing activities seamlessly if ATF Test Generator and Cloud Runner are used. This enables smoother upgrade experiences and better planning around upgrade windows.

    Important Considerations

    • The progress bar sections do not represent the relative duration of each upgrade phase.
    • The upgrade message indicating use of the ATF Test Generator and Cloud Runner appears only if the SNATFTG plugin is inactive and the instance is neither federated nor self-hosted.
    • Upgrading schema involves scanning plugins to avoid redundant table upgrades.
    • Multiple plugins may be loaded during the Loading Plugins phase since some features rely on several plugins.

    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.