Troubleshooting preflight migration check issues
Consider the list of preflight check issues and workarounds.
Config Readiness
In Cloudera Data Science Workbench (CDSW), we are using KubeDNS for handling the DNS. In Cloudera AI we are using core DNS. If you add any custom KubeDNS configurations in the CDSW, those will not be copied to Cloudera AI automatically. This preflight check verifies if there is any custom configuration added in CDSW. This preflight check will flag the same if the custom configurations are detected.
Troubleshooting failures:
Note any custom configurations added to the KubeDNS. Check if these are really necessary for Cloudera AI.
Registry Readiness
This preflight check will verify the registry readiness in Cloudera AI. It will check if the created Cloudera AI cluster has proper registry permissions.
Troubleshooting failures:
Check if the secret
cdp-private-installer-embedded-registry-docker-pull-secret in the
control plane namespace is present in Cloudera AI. If the
configuration is present, check if the docker configuration in this secret is correct.
Host Mount Readiness
CDSW supports host mount. But it is not supported in Cloudera AI. It is not possible to migrate the workloads containing the host mounts.
Troubleshooting failures:
The workloads containing the host mounts should be modified in CDSW before the migration. The users may convert the workloads using the engines to runtimes.
Engine Type Readiness
Engine is deprecated in Cloudera AI. If the CDSW contains any workloads using the engine or custom engines, those workloads must be converted to runtime before the migration.
Troubleshooting failures:
The workloads based on engine or custom engine should be converted to runtime-based workloads.
NFS Filesystem Readiness
The CDSW to CML migration tool supports migrating project files from the CDSW internal NFS server to the CML project storage. This readiness check will verify the NFS filesystem size for the migration.
Troubleshooting failures:
Please check the storage configuration of the NFS storage in Cloudera AI. Please ensure enough storage is in the NFS storage to do the migration.
Runtime Addons
Cloudera AI supports many runtime add-ons such as Spark, Hadoop, CLI, etc. This preflight check verifies that all the runtime add-ons are installed in the Cloudera AI properly.
Troubleshooting failures:
In Cloudera AI, go to and check the status of the runtime addons. If any of the runtime addons are in the wrong state, click actions and reload it.
Service Readiness
This preflight check verifies all the services active in CDSW in enabled and started in Cloudera AI.
Troubleshooting failures:
Ensure the necessary services are started in Cloudera AI during the workspace provisioning.
Versions Readiness
The migration of CDSW to Cloudera AI is supported only from CDSW version 1.10.0. This preflight check will verify the source CDSW version.
Troubleshooting failures:
Please update the CDSW to version >= 1.10.0.
