Merge pull request #84287 from anarnold97/MIG-1622-MTC-first-attribute

MIG-1622: Add new {MTC-first} attribute

Author: mburke5678

_attributes/common-attributes.adoc

@@ -60,6 +60,7 @@ endif::[]
 :velero-domain: velero.io
 :velero-version: 1.14
 :launch: image:app-launcher.png[title="Application Launcher"]
+:mtc-first: Migration Toolkit for Containers (MTC)
 :mtc-short: MTC
 :mtc-full: Migration Toolkit for Containers
 :mtc-version: 1.8

migration_toolkit_for_containers/about-mtc.adoc

@@ -7,7 +7,7 @@ include::_attributes/attributes-openshift-dedicated.adoc[]
 
 toc::[]
 
-The {mtc-full} ({mtc-short}) enables you to migrate stateful application workloads between {product-title} 4 clusters at the granularity of a namespace.
+The {mtc-first} enables you to migrate stateful application workloads between {product-title} 4 clusters at the granularity of a namespace.
 
 [NOTE]
 ====

migration_toolkit_for_containers/index.adoc

@@ -5,15 +5,15 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-You can migrate stateful application workloads between {product-title} 4 clusters at the granularity of a namespace by using the Migration Toolkit for Containers (MTC). To learn more about MTC see xref:../migration_toolkit_for_containers/about-mtc.adoc#about-mtc[understanding MTC].
+You can migrate stateful application workloads between {product-title} 4 clusters at the granularity of a namespace by using {mtc-first}. To learn more about {mtc-short} see xref:../migration_toolkit_for_containers/about-mtc.adoc#about-mtc[understanding {mtc-short}].
 
 [NOTE]
 ====
 If you are migrating from {product-title} 3, see xref:../migrating_from_ocp_3_to_4/about-migrating-from-3-to-4.adoc#about-migrating-from-3-to-4[about migrating from {product-title} 3 to 4] and xref:../migrating_from_ocp_3_to_4/installing-3-4.adoc#migration-installing-legacy-operator_installing-3-4[installing the legacy {mtc-full} Operator on {product-title} 3].
 ====
 
 [id="mtc-overview-install-mtc"]
-== Installing MTC
+== Installing {mtc-short}
 You must install the Migration Toolkit for Containers Operator that is compatible for your {product-title} version:
 
 * {product-title} 4.6 and later versions: xref:../migration_toolkit_for_containers/installing-mtc.adoc#installing-mtc[Install the Migration Toolkit for Containers Operator by using Operator Lifecycle Manager (OLM)].
@@ -22,24 +22,24 @@ You must install the Migration Toolkit for Containers Operator that is compatibl
 Then you xref:../migration_toolkit_for_containers/installing-mtc.adoc#configuring-replication-repository_installing-mtc[configure object storage to use as a replication repository].
 
 [id="mtc-overview-upgrade-mtc"]
-== Upgrading MTC
-You can xref:../migration_toolkit_for_containers/upgrading-mtc.adoc#upgrading-mtc[upgrade the MTC] by using OLM.
+== Upgrading {mtc-short}
+You can xref:../migration_toolkit_for_containers/upgrading-mtc.adoc#upgrading-mtc[upgrade the {mtc-short}] by using OLM.
 
 [id="mtc-overview-mtc-checklists"]
-== Reviewing MTC checklists
-Before you migrate your application workloads with the Migration Toolkit for Containers (MTC), review the xref:../migration_toolkit_for_containers/premigration-checklists-mtc.adoc#premigration-checklists-mtc[premigration checklists].
+== Reviewing {mtc-short} checklists
+Before you migrate your application workloads with the {mtc-short}, review the xref:../migration_toolkit_for_containers/premigration-checklists-mtc.adoc#premigration-checklists-mtc[premigration checklists].
 
 [id="mtc-overview-migrate-mtc-applications"]
 == Migrating applications
-You can migrate your applications by using the MTC xref:../migration_toolkit_for_containers/migrating-applications-with-mtc.adoc#migrating-applications-mtc-web-console_migrating-applications-with-mtc[web console] or xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migrating-applications-cli_advanced-migration-options-mtc[the command line].
+You can migrate your applications by using the {mtc-short} xref:../migration_toolkit_for_containers/migrating-applications-with-mtc.adoc#migrating-applications-mtc-web-console_migrating-applications-with-mtc[web console] or xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migrating-applications-cli_advanced-migration-options-mtc[the command line].
 
 [id="mtc-overview-advanced-migration-options"]
 == Advanced migration options
 You can automate your migrations and modify the `MigPlan` and `MigrationController` custom resources in order to perform large-scale migrations and to improve performance. You can check the following items:
 
 * xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migration-creating-registry-route-for-dim_advanced-migration-options-mtc[Create a registry route for direct image migration]
 * xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migration-configuring-proxies_advanced-migration-options-mtc[Configuring proxies]
-* xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migration-migrating-applications-api_advanced-migration-options-mtc[Migrating an application by using the MTC API]
+* xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migration-migrating-applications-api_advanced-migration-options-mtc[Migrating an application by using the {mtc-short} API]
 * xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migration-state-migration-cli_advanced-migration-options-mtc[Running a state migration]
 * xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migration-hooks_advanced-migration-options-mtc[Creating migration hooks]
 * xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migration-plan-options_advanced-migration-options-mtc[Editing, excluding, and mapping migrated resources]
@@ -56,13 +56,13 @@ You can perform the following troubleshooting tasks:
 * xref:../migration_toolkit_for_containers/troubleshooting-mtc.adoc#migration-using-must-gather_troubleshooting-mtc[Using the `must-gather` tool]
 * xref:../migration_toolkit_for_containers/troubleshooting-mtc.adoc#migration-debugging-velero-resources_troubleshooting-mtc[Using the Velero CLI to debug Backup and Restore CRs]
 * xref:../migration_toolkit_for_containers/troubleshooting-mtc.adoc#migration-partial-failure-velero_troubleshooting-mtc[Debugging a partial migration failure]
-* xref:../migration_toolkit_for_containers/troubleshooting-mtc.adoc#migration-using-mtc-crs-for-troubleshooting_troubleshooting-mtc[Using MTC custom resources for troubleshooting]
+* xref:../migration_toolkit_for_containers/troubleshooting-mtc.adoc#migration-using-mtc-crs-for-troubleshooting_troubleshooting-mtc[Using {mtc-short} custom resources for troubleshooting]
 * xref:../migration_toolkit_for_containers/troubleshooting-mtc.adoc#common-issues-and-concerns_troubleshooting-mtc[Checking common issues and concerns]
 
 [id="mtc-overview-roll-back-mtc"]
 == Rolling back a migration
-You can xref:../migration_toolkit_for_containers/troubleshooting-mtc.adoc#rolling-back-migration_troubleshooting-mtc[roll back a migration] by using the MTC web console, the CLI or manually.
+You can xref:../migration_toolkit_for_containers/troubleshooting-mtc.adoc#rolling-back-migration_troubleshooting-mtc[roll back a migration] by using the {mtc-short} web console, the CLI or manually.
 
 [id="mtc-overview-uninstall-mtc"]
-== Uninstalling MTC and deleting resources
-You can xref:../migration_toolkit_for_containers/installing-mtc.adoc#migration-uninstalling-mtc-clean-up_installing-mtc[uninstall the MTC and delete its resources] to clean up the cluster.
+== Uninstalling {mtc-short} and deleting resources
+You can xref:../migration_toolkit_for_containers/installing-mtc.adoc#migration-uninstalling-mtc-clean-up_installing-mtc[uninstall the {mtc-short} and delete its resources] to clean up the cluster.

migration_toolkit_for_containers/installing-mtc-restricted.adoc

@@ -7,7 +7,7 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-You can install the {mtc-full} ({mtc-short}) on {product-title} 4 in a restricted network environment by performing the following procedures:
+You can install the {mtc-first} on {product-title} 4 in a restricted network environment by performing the following procedures:
 
 . Create a xref:../disconnected/using-olm.adoc#olm-mirror-catalog_olm-restricted-networks[mirrored Operator catalog].
 +
@@ -47,7 +47,7 @@ This section applies only when you are working with the OpenShift API, not the w
 
 OpenShift environments have the `PodSecurityAdmission` controller enabled by default. This controller requires cluster administrators to enforce Pod Security Standards by means of namespace labels. All workloads in the cluster are expected to run one of the following Pod Security Standard levels: `Privileged`, `Baseline` or `Restricted`. Every cluster has its own default policy set.
 
-To guarantee successful data transfer in all environments, {mtc-full} ({mtc-short}) 1.7.5 introduced changes in Rsync pods, including running Rsync pods as non-root user by default. This ensures that data transfer is possible even for workloads that do not necessarily require higher privileges. This change was made because it is best to run workloads with the lowest level of privileges possible.
+To guarantee successful data transfer in all environments, {mtc-short} 1.7.5 introduced changes in Rsync pods, including running Rsync pods as non-root user by default. This ensures that data transfer is possible even for workloads that do not necessarily require higher privileges. This change was made because it is best to run workloads with the lowest level of privileges possible.
 
 [discrete]
 [id="migration-rsync-override-data-transfer_{context}"]

migration_toolkit_for_containers/installing-mtc.adoc

@@ -7,7 +7,7 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-You can install the {mtc-full} ({mtc-short}) on {product-title} 4.
+You can install the {mtc-first} on {product-title} 4.
 
 [NOTE]
 ====
@@ -41,7 +41,7 @@ This section applies only when you are working with the OpenShift API, not the w
 
 OpenShift environments have the `PodSecurityAdmission` controller enabled by default. This controller requires cluster administrators to enforce Pod Security Standards by means of namespace labels. All workloads in the cluster are expected to run one of the following Pod Security Standard levels: `Privileged`, `Baseline` or `Restricted`. Every cluster has its own default policy set.
 
-To guarantee successful data transfer in all environments, {mtc-full} ({mtc-short}) 1.7.5 introduced changes in Rsync pods, including running Rsync pods as non-root user by default. This ensures that data transfer is possible even for workloads that do not necessarily require higher privileges. This change was made because it is best to run workloads with the lowest level of privileges possible.
+To guarantee successful data transfer in all environments, {mtc-short} 1.7.5 introduced changes in Rsync pods, including running Rsync pods as non-root user by default. This ensures that data transfer is possible even for workloads that do not necessarily require higher privileges. This change was made because it is best to run workloads with the lowest level of privileges possible.
 
 ==== Manually overriding default non-root operation for data trannsfer
 
@@ -62,7 +62,7 @@ include::modules/migration-rsync-mig-migration-root-non-root.adoc[leveloffset=+2
 [id="configuring-replication-repository_{context}"]
 == Configuring a replication repository
 
-You must configure an object storage to use as a replication repository. The {mtc-full} ({mtc-short}) copies data from the source cluster to the replication repository, and then from the replication repository to the target cluster.
+You must configure an object storage to use as a replication repository. The {mtc-first} copies data from the source cluster to the replication repository, and then from the replication repository to the target cluster.
 
 {mtc-short} supports the xref:../migration_toolkit_for_containers/about-mtc.adoc#migration-understanding-data-copy-methods_about-mtc[file system and snapshot data copy methods] for migrating data from the source cluster to the target cluster. Select a method that is suited for your environment and is supported by your storage provider.
 

migration_toolkit_for_containers/migrating-applications-with-mtc.adoc

@@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-You can migrate your applications by using the {mtc-full} ({mtc-short}) web console or the xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migrating-applications-cli_advanced-migration-options-mtc[command line].
+You can migrate your applications by using the {mtc-first} web console or the xref:../migration_toolkit_for_containers/advanced-migration-options-mtc.adoc#migrating-applications-cli_advanced-migration-options-mtc[command line].
 
 Most cluster-scoped resources are not yet handled by {mtc-short}. If your applications require cluster-scoped resources, you might have to create them manually on the target cluster.
 
@@ -20,7 +20,7 @@ You can use state migration to migrate an application's state:
 * State migration copies selected persistent volume claims (PVCs).
 * You can use state migration to migrate a namespace within the same cluster.
 
-During migration, the {mtc-full} ({mtc-short}) preserves the following namespace annotations:
+During migration, the {mtc-short} preserves the following namespace annotations:
 
 * `openshift.io/sa.scc.mcs`
 * `openshift.io/sa.scc.supplemental-groups`

migration_toolkit_for_containers/mtc-direct-migration-requirements.adoc

@@ -8,7 +8,7 @@ include::_attributes/attributes-openshift-dedicated.adoc[]
 
 toc::[]
 
-Direct Migration is available with {mtc-full} ({mtc-short}) 1.4.0 or later.
+Direct Migration is available with {mtc-first} 1.4.0 or later.
 
 There are two parts of the Direct Migration:
 

migration_toolkit_for_containers/premigration-checklists-mtc.adoc

@@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-Before you migrate your application workloads with the {mtc-full} ({mtc-short}), review the following checklists.
+Before you migrate your application workloads with the {mtc-first}, review the following checklists.
 
 [id="cluster-health-checklist_{context}"]
 == Cluster health checklist

migration_toolkit_for_containers/release_notes/mtc-release-notes-1-5.adoc

@@ -7,7 +7,7 @@ include::_attributes/attributes-openshift-dedicated.adoc[]
 
 toc::[]
 
-The release notes for {mtc-full} ({mtc-short}) describe new features and enhancements, deprecated features, and known issues.
+The release notes for {mtc-first} describe new features and enhancements, deprecated features, and known issues.
 
 The {mtc-short} enables you to migrate application workloads between {product-title} clusters at the granularity of a namespace.
 

migration_toolkit_for_containers/release_notes/mtc-release-notes-1-6.adoc

@@ -7,7 +7,7 @@ include::_attributes/attributes-openshift-dedicated.adoc[]
 
 toc::[]
 
-The release notes for {mtc-full} ({mtc-short}) describe new features and enhancements, deprecated features, and known issues.
+The release notes for {mtc-first} describe new features and enhancements, deprecated features, and known issues.
 
 The {mtc-short} enables you to migrate application workloads between {product-title} clusters at the granularity of a namespace.