From 960ee031675dc0d2d4ae697ea75631d97a40cb27 Mon Sep 17 00:00:00 2001 From: RichardHoch Date: Wed, 27 Nov 2024 13:16:25 +0200 Subject: [PATCH] File system overhead info added --- .../master.adoc | 76 ++++--------------- .../additional-auth-methods-ostack.adoc | 9 +++ .../modules/file-system-overhead.adoc | 21 +++++ .../modules/ostack-app-cred-auth.adoc | 1 + 4 files changed, 47 insertions(+), 60 deletions(-) create mode 100644 documentation/modules/additional-auth-methods-ostack.adoc create mode 100644 documentation/modules/file-system-overhead.adoc diff --git a/documentation/doc-Migration_Toolkit_for_Virtualization/master.adoc b/documentation/doc-Migration_Toolkit_for_Virtualization/master.adoc index cc1e291edaa7..f87f86e723d4 100644 --- a/documentation/doc-Migration_Toolkit_for_Virtualization/master.adoc +++ b/documentation/doc-Migration_Toolkit_for_Virtualization/master.adoc @@ -50,93 +50,49 @@ include::modules/storage-support.adoc[leveloffset=+2] include::modules/source-vm-prerequisites.adoc[leveloffset=+2] - - - - -START HERE - === Provider-specific prerequisites :!mtv: :context: vmware :vmware: -==== VMware prerequisites - -include::modules/vmware-prerequisites.adoc[leveloffset=+2] -include::modules/creating-vddk-image.adoc[leveloffset=+3] -include::modules/increasing-nfc-memory-vmware-host.adoc[leveloffset=+3] -include::modules/network-prerequisites.adoc[leveloffset=+2] +include::modules/vmware-prerequisites.adoc[leveloffset=+3] +include::modules/creating-vddk-image.adoc[leveloffset=+4] +include::modules/increasing-nfc-memory-vmware-host.adoc[leveloffset=+4] +include::modules/network-prerequisites.adoc[leveloffset=+4] :!vmware: :context: rhv :rhv: -==== {rhv-full} prerequisites - -include::modules/rhv-prerequisites.adoc[leveloffset=+2] -include::modules/network-prerequisites.adoc[leveloffset=+2] - -[NOTE] -==== -When migrating from OpenStack or running a cold-migration from RHV to the OCP cluster that MTV is deployed on, the migration allocates persistent volumes without CDI. In these cases, you might need to adjust the file system overhead. - -If the configured file system overhead, which has a default value of 10%, is too low, the disk transfer will fail due to lack of space. In such a case, you would want to increase the file system overhead. - -In some cases, however, you might want to decrease the file system overhead to reduce storage consumption. - -You can change the file system overhead by changing the value of the `controller_filesystem_overhead` in the `spec` portion of the `forklift-controller` CR, as described in xref:configuring-mtv-operator_mtv[Configuring the MTV Operator]. -==== +include::modules/rhv-prerequisites.adoc[leveloffset=+3] +include::modules/file-system-overhead.adoc[leveloffset=+4] +include::modules/network-prerequisites.adoc[leveloffset=+4] :!rhv: :context: ostack :ostack: -==== {osp} prrerequisites - -include::modules/openstack-prerequisites.adoc[leveloffset=+2] - -[NOTE] -==== -When migrating from OpenStack or running a cold-migration from RHV to the OCP cluster that MTV is deployed on, the migration allocates persistent volumes without CDI. In these cases, you might need to adjust the file system overhead. - -If the configured file system overhead, which has a default value of 10%, is too low, the disk transfer will fail due to lack of space. In such a case, you would want to increase the file system overhead. - -In some cases, however, you might want to decrease the file system overhead to reduce storage consumption. - -You can change the file system overhead by changing the value of the `controller_filesystem_overhead` in the `spec` portion of the `forklift-controller` CR, as described in xref:configuring-mtv-operator_mtv[Configuring the MTV Operator]. -==== - -[id="additional-authentication-for-osp_{context}"] -==== Additional authentication methods for migrations with {osp} source providers - -{project-short} versions 2.6 and later support the following authentication methods for migrations with {osp} source providers in addition to the standard username and password credential set: - -* Token authentication -* Application credential authentication - -You can use these methods to migrate virtual machines with {osp} source providers using the CLI the same way you migrate other virtual machines, except for how you prepare the `Secret` manifest. - - -include::modules/ostack-token-auth.adoc[leveloffset=+4] -include::modules/ostack-app-cred-auth.adoc[leveloffset=+4] +include::modules/openstack-prerequisites.adoc[leveloffset=+3] +include::modules/file-system-overhead.adoc[leveloffset=+4] +include::modules/additional-auth-methods-ostack.adoc[leveloffset=+4] +include::modules/ostack-token-auth.adoc[leveloffset=+5] +include::modules/ostack-app-cred-auth.adoc[leveloffset=+5] +// Network prerequisites :!osp: :context: ova :ova: -==== OVA prerequisites - -include::modules/ova-prerequisites.adoc[leveloffset=+2] - +include::modules/ova-prerequisites.adoc[leveloffset=+3] +// Network prerequisites :!ova: :context: cnv :cnv: ==== {virt} prerequisites - +//Anything? :!virt: :context: mtv diff --git a/documentation/modules/additional-auth-methods-ostack.adoc b/documentation/modules/additional-auth-methods-ostack.adoc new file mode 100644 index 000000000000..0730c770dbe5 --- /dev/null +++ b/documentation/modules/additional-auth-methods-ostack.adoc @@ -0,0 +1,9 @@ +[id="additional-authentication-methods-osp_{context}"] += Additional authentication methods for migrations with {osp} source providers + +{project-short} versions 2.6 and later support the following authentication methods for migrations with {osp} source providers in addition to the standard username and password credential set: + +* Token authentication +* Application credential authentication + +You can use these methods to migrate virtual machines with {osp} source providers using the CLI the same way you migrate other virtual machines, except for how you prepare the `Secret` manifest. diff --git a/documentation/modules/file-system-overhead.adoc b/documentation/modules/file-system-overhead.adoc new file mode 100644 index 000000000000..52a2c20d8842 --- /dev/null +++ b/documentation/modules/file-system-overhead.adoc @@ -0,0 +1,21 @@ +// Module included in the following assemblies: +// +// * documentation/doc-Migration_Toolkit_for_Virtualization/master.adoc + +:_content-type: CONCEPT +[id="file-system-overhead_{context}"] += File system overhead +ifdef::rhv[] +When you run a cold migration from {rhv-full} to the {ocp} cluster that {project-full} is deployed on, the migration allocates persistent volumes without Customized Data Importer (CDI). In these cases, you might need to adjust the file system overhead. +endif::[] + + +ifdef::ostack[] +When you migrate from {osp} to the {ocp} cluster that {project-full} is deployed on, the migration allocates persistent volumes without Customized Data Importer (CDI). In these cases, you might need to adjust the file system overhead. +endif::[] + +If the configured file system overhead, which has a default value of 10%, is too low, the disk transfer will fail due to lack of space. In such a case, you would want to increase the file system overhead. + +In some cases, however, you might want to decrease the file system overhead to reduce storage consumption. + +You can change the file system overhead by changing the value of the `controller_filesystem_overhead` in the `spec` portion of the `forklift-controller` CR, as described in xref:configuring-mtv-operator_mtv[Configuring the MTV Operator]. diff --git a/documentation/modules/ostack-app-cred-auth.adoc b/documentation/modules/ostack-app-cred-auth.adoc index 2d517705964e..869d9f68da1f 100644 --- a/documentation/modules/ostack-app-cred-auth.adoc +++ b/documentation/modules/ostack-app-cred-auth.adoc @@ -93,3 +93,4 @@ stringData: EOF ---- . Continue migrating your virtual machine according to the procedure in xref:new-migrating-virtual-machines-cli_ostack[Migrating virtual machines], starting with step 2, "Create a `Provider` manifest for the source provider." +