Cloudera Docs

Upgrade AI Registry

When you upgrade a AI Registry, you create a new version of the registry. You can roll back to the old version, or delete the old registry if it is no longer needed.

The AI Registry upgrade process involves provisioning a new cluster, so the process can take some time, on the order of 40 to 60 minutes. The upgrade operation shall be performed during a maintenance window, when new models are not being added or updated in Cloudera AI. The window shall be available approximately 3 hours long at a minimum.
  1. In AI Registries, choose a registry to upgrade.
  2. Copy the CRN (Creator) shown in the AI Registries.
  3. In the Cloudera Data Platform CLI, enter cdp ml upgrade-model-registry —crn <crn>

    In the AI Registries UI, the Status of the AI registry changes to Backup Initiated. The process starts provisioning a new registry (Status: Creating) and then performs a backup operation to restore the state.

  4. When the new registry shows Ready, then in Actions, click Synchronize. Check the contents of the new registry to verify that all of the models have transferred.
  5. Finally, after verifying the contents of the new registry, you can delete the old registry (check the Created at timestamp) in the Action menu. This action is irreversible.

To verify the data, go to a workbench. Check that all of the models are there. Deleting the old AI registry cannot be reversed.

You should also check the event logs to see if any errors occurred during the upgrade. Can also be used real time to see that the process is running. If there is a need for an escalation ticket, make sure to include the logs.

If you upgrade a AI registry, then synchronize, then rollback, any models that were added through synchronizing will not be present. The process does not transfer the data backwards to the old registry.