:_mod-docs-content-type: ASSEMBLY
[id="ztp-migrate-clusterinstance"]
= Migrating from SiteConfig CRs to ClusterInstance CRs
include::_attributes/common-attributes.adoc[]
:context: ztp-migrate-clusterinstance

toc::[]

You can incrementally migrate {sno} clusters from `SiteConfig` custom resources (CRs) to `ClusterInstance` CRs. During migration, the existing and new pipelines run in parallel, so you can migrate one or more clusters at a time in a controlled and phased manner.

[IMPORTANT]
====
* The `SiteConfig` CR is deprecated from {product-title} version 4.18 and will be removed in a future version.

* The `ClusterInstance` CR is available from {rh-rhacm-first} version 2.12 or later.
====

include::modules/ztp-migrate-clusterinstance-overview.adoc[leveloffset=+1]

include::modules/ztp-creating-argocd-clusterinstance.adoc[leveloffset=+1]

include::modules/ztp-active-ocp-version.adoc[leveloffset=+1]

include::modules/ztp-migrating-sno-clusterinstance.adoc[leveloffset=+1]

[role="_additional-resources"]
.Additional resources

* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html/multicluster_engine_operator_with_red_hat_advanced_cluster_management/siteconfig-intro#enable[Enabling the SiteConfig operator]

//include::modules/ztp-clusterinstance-site-converter.adoc[leveloffset=+1]

include::modules/ztp-site-converter-ref.adoc[leveloffset=+2]

include::modules/ztp-clusterinstance-cleanup.adoc[leveloffset=+1]

//include::modules/ztp-enable-siteconfig-addon.adoc[leveloffset=+1]

include::modules/ztp-clusterinstance-troubleshooting.adoc[leveloffset=+1]
