Troubleshooting Preflight Migration Check Issues
Provides a list of preflight check issues and workarounds.
In CDSW, we are using KubeDNS for handling the DNS. In CML we are using core DNS. If the customers add any custom KubeDNS configurations in the CDSW, those won't be copied to CML 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.
Note any custom configurations added to the KubeDNS. Check if these are really necessary for CML.
This preflight check will verify the registry readiness in CML. It will check if the created CML cluster has proper registry permissions.
Check if the secret ‘cdp-private-installer-embedded-registry-docker-pull-secret ‘ in the control plane namespace is present in CML. 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 CML. It is not possible to migrate the workloads containing the host mounts.
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 CML. If the CDSW contains any workloads using the engine or custom engines, those workloads must be converted to runtime before the migration.
The workloads based on engine or custom engine should be converted to runtime-based workloads.
NFS Filesystem Readiness
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.
Please check the storage configuration of the NFS storage in CML. Please ensure enough storage is in the NFS storage to do the migration.
CML 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 CML properly.
In CML, go to Site Administrator->Runtime and check the status of the runtime addons. If any of the runtime addons are in the wrong state, click actions and do a reload.
This preflight check verifies all the services active in CDSW in enabled and started in CML.
Ensure the necessary services are started in CML during the workspace provisioning.
CDSW to CML migration is supported only from CDSW version 1.10.0. This preflight check will verify the source CDSW version.
Please update the CDSW to version >= 1.10.0.