Merge pull request #91668 from jneczypor/OSDOCS-5815

OSDOCS-5815: OSD/ROSA BYO-VPC document DHCP option requirements

Author: EricPonvelle

rosa_hcp/rosa-hcp-sts-creating-a-cluster-quickly.adoc

@@ -92,6 +92,20 @@ include::modules/rosa-hcp-vpc-terraform.adoc[leveloffset=+3]
 
 [discrete]
 include::modules/rosa-hcp-vpc-manual.adoc[leveloffset=+2]
+
+[id="troubleshooting_shared-vpc-hcp_vpc-creation"]
+==== Troubleshooting
+
+If your cluster fails to install, check these common troubleshooting issues:
+
+* Make sure your link:https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html[DHCP option set] includes a domain name, and ensure that the domain name does not include any spaces or capital letters.
+* If your VPC uses a custom DNS resolver (the `domain name servers` field of your DHCP option set is not `AmazonProvideDNS`), make sure it is able to properly resolve the private hosted zones configured in Route53.
+
+For more information about troubleshooting ROSA cluster installations, see xref:../support/troubleshooting/rosa-troubleshooting-installations.adoc#rosa-troubleshooting-installations[Troubleshooting {product-title} installations].
+
+===== Get support
+If you need additional xref:../support/getting-support.adoc#getting-support[support], visit the Red Hat Customer Portal to review knowledge base articles, submit a support case, and review additional product documentation and resources.
+
 [discrete]
 include::modules/rosa-hcp-vpc-subnet-tagging.adoc[leveloffset=+3]
 

rosa_install_access_delete_clusters/rosa-shared-vpc-config.adoc

@@ -57,4 +57,4 @@ include::modules/rosa-sharing-vpc-creation-and-sharing.adoc[leveloffset=+1]
 
 include::modules/rosa-sharing-vpc-dns-and-roles.adoc[leveloffset=+1]
 include::modules/rosa-sharing-vpc-hosted-zones.adoc[leveloffset=+1]
-include::modules/rosa-sharing-vpc-cluster-creation.adoc[leveloffset=+1]
+include::modules/rosa-sharing-vpc-cluster-creation.adoc[leveloffset=+1]

rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-quickly.adoc

@@ -32,6 +32,19 @@ include::modules/rosa-sts-understanding-aws-account-association.adoc[leveloffset
 
 include::modules/osd-aws-vpc-required-resources.adoc[leveloffset=+1]
 
+[id="troubleshooting_vpc-creation"]
+=== Troubleshooting
+
+If your cluster fails to install, check these common troubleshooting issues:
+
+* Make sure your link:https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html[DHCP option set] includes a domain name, and ensure that the domain name does not include any spaces or capital letters.
+* If your VPC uses a custom DNS resolver (the `domain name servers` field of your DHCP option set is not `AmazonProvideDNS`), make sure it is able to properly resolve the private hosted zones configured in Route53.
+
+For more information about troubleshooting ROSA cluster installations, see xref:../support/troubleshooting/rosa-troubleshooting-installations.adoc#rosa-troubleshooting-installations[Troubleshooting {product-title} installations].
+
+==== Get support
+If you need additional xref:../support/getting-support.adoc#getting-support[support], visit the Red Hat Customer Portal to review knowledge base articles, submit a support case, and review additional product documentation and resources.
+
 [role="_additional-resources"]
 .Additional resources
 

rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-with-customizations.adoc

@@ -30,6 +30,19 @@ include::modules/rosa-sts-arn-path-customization-for-iam-roles-and-policies.adoc
 include::modules/rosa-sts-support-considerations.adoc[leveloffset=+1]
 include::modules/osd-aws-vpc-required-resources.adoc[leveloffset=+1]
 
+[id="troubleshooting_shared-vpc_vpc-creation"]
+=== Troubleshooting
+
+If your cluster fails to install, check these common troubleshooting issues:
+
+* Make sure your link:https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html[DHCP option set] includes a domain name, and ensure that the domain name does not include any spaces or capital letters.
+* If your VPC uses a custom DNS resolver (the `domain name servers` field of your DHCP option set is not `AmazonProvideDNS`), make sure it is able to properly resolve the private hosted zones configured in Route53.
+
+For more information about troubleshooting ROSA cluster installations, see xref:../support/troubleshooting/rosa-troubleshooting-installations.adoc#rosa-troubleshooting-installations[Troubleshooting {product-title} installations].
+
+==== Get support
+If you need additional xref:../support/getting-support.adoc#getting-support[support], visit the Red Hat Customer Portal to review knowledge base articles, submit a support case, and review additional product documentation and resources.
+
 [role="_additional-resources"]
 .Additional resources