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.
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 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:
- Navigate to the Errors tab from Home.
- Click the Show Filters button.
- Type Cluster Upgrade Worker in the URL field and press Enter.
- 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.
