Merge pull request #37155 from stevsmit/BZ1903142

Author: Bob Furu

modules/olm-mirroring-catalog.adoc

@@ -86,7 +86,12 @@ wrote database to /tmp/153048078 <1>
 wrote mirroring manifests to manifests-{index-image}-1614211642 <2>
 ----
 <1> Directory for the temporary `index.db` database generated by the command.
-<2> Record the manifests directory name that is generated. This directory name is used in a later step.
+<2> Be sure to record the manifests directory name that is generated. This directory name is used in a later step.
++
+[NOTE]
+====
+Red Hat Quay does not support nested repositories. As a result, running the `oc adm catalog mirror` command will fail with a `401` unauthorized error. As a workaround, you can use the `--max-components=2` option when running the `oc adm catalog mirror` command to disable the creation of nested repositories. For more information on this workaround, see the link:https://access.redhat.com/solutions/5440741[Unauthorized error thrown while using catalog mirror command with Quay registry] Knowledgebase Solution article. 
+==== 
 
 ** *Option B: If your mirror registry is on a disconnected host,* take the following actions.
 
@@ -115,7 +120,7 @@ To upload local images to a registry, run:
 
 	oc adm catalog mirror file://local/index/myrepo/my-index:v1 REGISTRY/REPOSITORY <2>
 ----
-<1> Record the manifests directory name that is generated. This directory name is used in a later step.
+<1> Be sure to record the manifests directory name that is generated. This directory name is used in a later step.
 <2> Record the expanded `file://` path that based on your provided index image. This path is used in a later step.
 
 .. Copy the `v2/` directory that is generated in your current directory to removable media.
@@ -142,6 +147,11 @@ $ oc adm catalog mirror \
 ----
 <1> Specify the `file://` path from the previous command output.
 <2> Specify the target registry and namespace to mirror the Operator content to, where `<namespace>` is any existing namespace on the registry. For example, you might create an `olm-mirror` namespace to push all mirrored content to.
++
+[NOTE]
+====
+Red Hat Quay does not support nested repositories. As a result, running the `oc adm catalog mirror` command will fail with a `401` unauthorized error. As a workaround, you can use the `--max-components=2` option when running the `oc adm catalog mirror` command to disable the creation of nested repositories. For more information on this workaround, see the link:https://access.redhat.com/solutions/5440741[Unauthorized error thrown while using catalog mirror command with Quay registry] Knowledgebase Solution article. 
+====
 
 . After mirroring the content to your registry, inspect the manifests directory that is generated in your current directory.
 +