Add limitation/fix incorrect commands in CRDB operator migration guides (#20227)

* Fix incorrect public operator migration commands

* Add WAL failover limitation

* Copy to 25.4 content

Author: jhlodin

src/current/v25.3/migrate-cockroachdb-kubernetes-helm.md

@@ -27,6 +27,8 @@ This migration can be completed without affecting cluster availability, and pres
 
 {{site.data.alerts.callout_danger}}
 Commands that use RPCs (such as `cockroach node drain` and `cockroach node decommission`) will be unavailable until the public service is updated in step 4. The {{ site.data.products.cockroachdb-operator }} uses a different port than StatefulSets for RPC services, causing these commands to fail for a limited time.
+
+The {{ site.data.products.cockroachdb-operator }} does not support custom store directories for [WAL failover]({% link {{ page.version.version }}/wal-failover.md %}). If the existing Helm deployment uses custom store directories, they must be reconfigured to use the default directories prior to beginning migration.
 {{site.data.alerts.end}}
 
 ## Step 1. Prepare the migration helper

src/current/v25.3/migrate-cockroachdb-kubernetes-operator.md

@@ -78,15 +78,15 @@ The {{ site.data.products.cockroachdb-operator }} uses slightly different certif
 
 {% include_cached copy-clipboard.html %}
 ~~~ shell
-bin/migration-helper migrate-certs --statefulset-name $STS_NAME --namespace $NAMESPACE
+bin/migration-helper migrate-certs --statefulset-name $CRDBCLUSTER --namespace $NAMESPACE
 ~~~
 
 Generate a manifest for each crdbnode and the crdbcluster based on the state of the StatefulSet. The new pods and their associated PVCs must have the same names as the original StatefulSet-managed pods and PVCs. The new {{ site.data.products.cockroachdb-operator }}-managed pods will then use the original PVCs, rather than replicate data into empty nodes.
 
 {% include_cached copy-clipboard.html %}
 ~~~ shell
 mkdir -p manifests
-bin/migration-helper build-manifest helm --statefulset-name $STS_NAME --namespace $NAMESPACE --cloud-provider $CLOUD_PROVIDER --cloud-region $REGION --output-dir ./manifests
+migration-helper build-manifest operator --crdb-cluster $CRDBCLUSTER --namespace $NAMESPACE --cloud-provider $CLOUD_PROVIDER --cloud-region $REGION --output-dir ./manifests
 ~~~
 
 ## Step 3. Uninstall and replace the {{ site.data.products.public-operator }}

src/current/v25.4/migrate-cockroachdb-kubernetes-helm.md

@@ -27,6 +27,8 @@ This migration can be completed without affecting cluster availability, and pres
 
 {{site.data.alerts.callout_danger}}
 Commands that use RPCs (such as `cockroach node drain` and `cockroach node decommission`) will be unavailable until the public service is updated in step 4. The {{ site.data.products.cockroachdb-operator }} uses a different port than StatefulSets for RPC services, causing these commands to fail for a limited time.
+
+The {{ site.data.products.cockroachdb-operator }} does not support custom store directories for [WAL failover]({% link {{ page.version.version }}/wal-failover.md %}). If the existing Helm deployment uses custom store directories, they must be reconfigured to use the default directories prior to beginning migration.
 {{site.data.alerts.end}}
 
 ## Step 1. Prepare the migration helper

src/current/v25.4/migrate-cockroachdb-kubernetes-operator.md

@@ -78,15 +78,15 @@ The {{ site.data.products.cockroachdb-operator }} uses slightly different certif
 
 {% include_cached copy-clipboard.html %}
 ~~~ shell
-bin/migration-helper migrate-certs --statefulset-name $STS_NAME --namespace $NAMESPACE
+bin/migration-helper migrate-certs --statefulset-name $CRDBCLUSTER --namespace $NAMESPACE
 ~~~
 
 Generate a manifest for each crdbnode and the crdbcluster based on the state of the StatefulSet. The new pods and their associated PVCs must have the same names as the original StatefulSet-managed pods and PVCs. The new {{ site.data.products.cockroachdb-operator }}-managed pods will then use the original PVCs, rather than replicate data into empty nodes.
 
 {% include_cached copy-clipboard.html %}
 ~~~ shell
 mkdir -p manifests
-bin/migration-helper build-manifest helm --statefulset-name $STS_NAME --namespace $NAMESPACE --cloud-provider $CLOUD_PROVIDER --cloud-region $REGION --output-dir ./manifests
+migration-helper build-manifest operator --crdb-cluster $CRDBCLUSTER --namespace $NAMESPACE --cloud-provider $CLOUD_PROVIDER --cloud-region $REGION --output-dir ./manifests
 ~~~
 
 ## Step 3. Uninstall and replace the {{ site.data.products.public-operator }}