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. See Agents for more information regarding 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 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

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.