Monitor Cluster Upgrade Jobs

This Relativity script checks and reports the status of all Analytics cluster upgrade jobs recorded in the EDDS.eddsdbo.ClusterUpgradeJobs database table. The cluster upgrade jobs are created using the Create Cluster Upgrade Jobs script, and are used to upgrade Analytics clusters for performance improvements introduced in CAAT 3.17.2 and above. The cluster upgrade jobs are managed by the Cluster Upgrade Worker agent.

Note: CAAT 3.17.2 was introduced in 9.2.271.9.

Special considerations

Consider the following when running this script:

  • This script monitors the progress of the upgrade jobs. To create cluster upgrade jobs for clusters in one or all of your workspaces, run the Create Cluster Upgrade Jobs script.
  • The script may run for some time without reporting any progress.

Inputs

This script requires no inputs.

Results

After you run the script, the Monitor Cluster Upgrade Jobs dialog lists a count of the jobs in progress and the status of the jobs. If there aren't any jobs currently in progress, the dialog lists all workspaces in your environment and the count of clusters that were upgraded and not upgraded per workspace.

The monitor cluster upgrade jobs screen showing three workspaces and their cluster upgrade counts.

The following columns are included when existing cluster upgrade jobs are still running:

Column Definition
Count Number of cluster upgrade jobs currently in the queue
Status Status

The following columns are included when there are no cluster upgrade jobs running:

Column Definition
ArtifactID Database ID of the workspace
Workspace Name Name of the workspace
Upgraded Cluster Count Number of clusters upgraded by the Cluster Upgrade Worker agent
Not upgraded Cluster Count Number of clusters not upgraded

Note: In 2025, Relativity is deprecating the (Admin) Errors tab in RelativityOne. This change is part of our effort to transform the error-handling experience by making it easier to address job-specific errors as they occur at their source within your workspaces. Starting in April 2025, we'll hide the Errors tab from all production instances in a phased rollout. In July 2025, we'll permanently remove it from RelativityOne and disable the ability to read errors through the API. In October 2025, we'll prevent errors from being written through the API. For more details, see Errors tab deprecation in the Knowledgebase on the Community.

If you find workspaces with clusters not upgraded, check the Errors tab for reported cluster upgrade failures:

  1. Navigate to the Errors tab from Home.
  2. Click the Show Filters button.
  3. Type Cluster Upgrade Worker in the URL field and press Enter.
  4. Review the Message column entries to identify Failed to upgrade cluster messages. The Failed to upgrade cluster error messages include the Workspace ArtifactID, IndexID and ClusterID values.
    The errors tab document list showing three errored upgrade cluster messages.