Skip to content

Commit

Permalink
File system overhead info added
Browse files Browse the repository at this point in the history
  • Loading branch information
RichardHoch committed Dec 9, 2024
1 parent 83aa611 commit 960ee03
Show file tree
Hide file tree
Showing 4 changed files with 47 additions and 60 deletions.
76 changes: 16 additions & 60 deletions documentation/doc-Migration_Toolkit_for_Virtualization/master.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
9 changes: 9 additions & 0 deletions documentation/modules/additional-auth-methods-ostack.adoc
Original file line number Diff line number Diff line change
@@ -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.
21 changes: 21 additions & 0 deletions documentation/modules/file-system-overhead.adoc
Original file line number Diff line number Diff line change
@@ -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].
1 change: 1 addition & 0 deletions documentation/modules/ostack-app-cred-auth.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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."

0 comments on commit 960ee03

Please sign in to comment.